Getting Information About Your Virtual Private Gateways

You can get information about one or more of your virtual private gateways.

By default, this action describes all your virtual private gateways.

Getting Information About Your Virtual Private Gateways Using Cockpit v1

See VPN Connections User Interface.

Getting Information About Your Virtual Gateways Using Cockpit v2-beta

See the Virtual Gateways dashboard.

Getting Information About Your Virtual Gateways Using OSC CLI

See the ReadVirtualGateways command sample in the documentation of the OUTSCALE API.

Getting Information About Your Virtual Private Gateways Using AWS CLI

To get information about one or more virtual private gateways, use the describe-vpn-gateways command following this syntax:

Request sample
$ aws ec2 describe-vpn-gateways \
    --profile YOUR_PROFILE \
    [--filters NOT_SPECIFIED] \
    --endpoint https://fcu.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.

  • (optional) vpn-gateway-ids: The ID of one or more virtual private gateways you want to get information about.

  • (optional) filters: One or more filters, in the "Name=X,Values=Y" format.

    You can specify several values for a same filter using the "Name=X,Values=Y, Z" format.

    The following filters are available:

    • attachment.state: The state of the attachment between the virtual private gateway and the VPC, if any (attaching | attached | detaching | detached). For more information, see About Virtual Private Gateways > Lifecycle.

    • attachment.vpc-id: The ID of the attached VPC, if any.

    • state: The state of the virtual private gateway (pending | available | deleting | deleted). For more information, see About Virtual Private Gateways > Lifecycle.

    • tag-key: The key of a tag associated with the resource.

    • tag-value: The value of a tag associated with the resource.

    • tag:XXXX: The value of a tag associated with the resource, where XXXX is the key of the tag.

      To filter a tag whose key is XXXX and value is YYYY, you can therefore use either of the following two formats:

      • --filters Name=tag-key,Values=XXXX Name=tag-value,Values=YYYY

      • --filters Name=tag:XXXX,Values=YYYY

    • type: The type of VPN connection that the virtual private gateway supports (always ipsec.1).

    • vpn-gateway-id: The ID of the virtual private gateway.

  • endpoint: The endpoint corresponding to the Region you want to send the request to.

The describe-vpn-gateways command returns the following elements:

  • State: The state of the virtual private gateway (pending | available | deleting | deleted). For more information, see About Virtual Private Gateways > Lifecycle.

  • Tags: One or more tags associated with the virtual private gateway. This element contains the following information:

    • Key: The key of the tag.

    • Value: The value of the tag.

  • Type: The type of VPN connection that the virtual private gateway supports (always ipsec.1).

  • VpnGatewayId: The ID of the virtual private gateway.

  • VpcAttachments: Information about the VPC the virtual private gateway is attached to, if any. This element contains the following information:

    • State: The state of the attachment (attaching | attached | detaching | detached). For more information, see About Virtual Private Gateways > Lifecycle.

    • VpcId: The ID of the VPC to which the virtual private gateway is attached.

Result sample
 {
    "VpnGateways": [
        {
            "State": "available",
            "Tags": [],
            "Type": "ipsec.1",
            "VpnGatewayId": "vgw-00ac2c82",
            "VpcAttachments": [
                {
                    "State": "attached",
                    "VpcId": "vpc-eb1e7306"
                }
            ]
        }
    ]
}

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.