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.

Request sample
$ osc-cli api ReadVirtualGateways --profile "default" \
    --Filters '{
        "VirtualGatewayIds": ["vgw-12345678"],
      }'
Request sample
$ 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.

  • 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 (between 1`and `1000, 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.

  • VirtualGateways: Information about one or more virtual gateways.

Result sample
{
  "VirtualGateways": [
    {
      "VirtualGatewayId": "vgw-12345678",
      "ConnectionType": "ipsec.1",
      "NetToVirtualGatewayLinks": [],
      "State": "available",
      "Tags": []
    }
  ],
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  }
}
Result sample
{
  "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

To get information about your virtual private gateways, use the describe-virtual-gateways command following this syntax:

Request sample
$ 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.

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).

Result sample
{
    "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.

Export to PDF