Getting Information About Your Virtual Gateways for DirectLink
You can get information about your virtual gateways that you can use as a target for one or more DirectLink interfaces. The virtual gateway must be in the available state and attached to the Net you want to access.
Getting Information About Your Virtual Gateways for DirectLink Using Cockpit v2
See the DirectLink Interfaces dashboard. |
Getting Information About Your Virtual Gateways for DirectLink Using OSC CLI
The ReadVirtualGateways command lists one or more virtual gateways.
$ osc-cli api ReadVirtualGateways --profile "default" \
--Filters '{
"VirtualGatewayIds": ["vgw-12345678"]
}'
$ osc-cli api ReadVirtualGateways --profile "default" \
--Filters '{
"States": ["available"],
"LinkStates": ["attached", "detached"]
}'
This command contains the following attributes that you need to specify:
-
DryRun
: (optional) If true, checks whether you have the required permissions to perform the action. -
Filters
: (optional) One or more filters.-
ConnectionTypes
: (optional) The types of the virtual gateways (alwaysipsec.1
). -
LinkNetIds
: (optional) The IDs of the Nets the virtual gateways are attached to. -
LinkStates
: (optional) The current states of the attachments between the virtual gateways and the Nets (attaching
|attached
|detaching
|detached
). -
States
: (optional) The states of the virtual gateways (pending
|available
|deleting
|deleted
). -
TagKeys
: (optional) The keys of the tags associated with the virtual gateways. -
TagValues
: (optional) The values of the tags associated with the virtual gateways. -
Tags
: (optional) The key/value combination of the tags associated with the virtual gateways, in the following format: "Filters":{"Tags":["TAGKEY=TAGVALUE"]}. -
VirtualGatewayIds
: (optional) The IDs of the virtual gateways.
-
-
NextPageToken
: (optional) The token to request the next page of results. Each token refers to a specific page. -
ResultsPerPage
: (optional) The maximum number of logs returned in a single response (between1
and1000
, both included). By default,100
.
The ReadVirtualGateways command returns the following elements:
-
NextPageToken
: The token to request the next page of results. Each token refers to a specific page. -
ResponseContext
: Information about the context of the response.-
RequestId
: The ID of the request.
-
-
VirtualGateways
: Information about one or more virtual gateways.-
ConnectionType
: The type of VPN connection supported by the virtual gateway (alwaysipsec.1
). -
NetToVirtualGatewayLinks
: The Net to which the virtual gateway is attached.-
NetId
: The ID of the Net to which the virtual gateway is attached. -
State
: The state of the attachment (attaching
|attached
|detaching
|detached
).
-
-
State
: The state of the virtual gateway (pending
|available
|deleting
|deleted
). -
Tags
: One or more tags associated with the virtual gateway.-
Key
: The key of the tag, with a minimum of 1 character. -
Value
: The value of the tag, between 0 and 255 characters.
-
-
VirtualGatewayId
: The ID of the virtual gateway.
-
{
"VirtualGateways": [
{
"VirtualGatewayId": "vgw-12345678",
"ConnectionType": "ipsec.1",
"NetToVirtualGatewayLinks": [],
"State": "available",
"Tags": []
}
],
"ResponseContext": {
"RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
}
}
{
"VirtualGateways": [
{
"VirtualGatewayId": "vgw-12345678",
"ConnectionType": "ipsec.1",
"NetToVirtualGatewayLinks": [
{
"State": "attached",
"NetId": "vpc-12345678"
}
],
"State": "available",
"Tags": []
}
],
"ResponseContext": {
"RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
}
}
Getting Information About Your Virtual Private Gateways for DirectLink Using AWS CLI
Before you begin: Install and configure AWS CLI. For more information, see Installing and Configuring AWS CLI. |
To get information about your virtual private gateways, use the describe-virtual-gateways command following this syntax:
$ aws directconnect describe-virtual-gateways \
--profile YOUR_PROFILE \
--endpoint https://directlink.eu-west-2.outscale.com
This command contains the following attributes that you need to specify:
-
(optional)
profile
: The named profile you want to use, created when configuring AWS CLI. For more information, see Installing and Configuring AWS CLI. -
endpoint
: The endpoint corresponding to the Region you want to send the request to. For more information, see Installing and Configuring AWS CLI.
The describe-virtual-gateways command returns the following elements:
-
virtualGateways
: Information about one or more virtual private gateways. This element contains the following information for each virtual private gateway:-
virtualGatewayId
: The ID of the virtual private gateway. -
virtualGatewayState
: The state of the virtual private gateway (pending
|available
|deleting
|deleted
).
-
{
"virtualGateways": [
{
"virtualGatewayId": "vgw-87654321",
"virtualGatewayState": "available"
}
]
}
Related Pages
Corresponding API Methods
AWS™ and Amazon Web Services™ are trademarks of Amazon Technologies, Inc or its affiliates in the United States and/or other countries.