Obtenir des informations sur vos virtual private gateways

Vous pouvez obtenir des informations sur une ou plusieurs de vos virtual private gateways.

Par défaut, cette action décrit toutes vos virtual private gateways.

Si vous dépassez le nombre autorisé de requêtes identiques pour une durée configurée, le message d’erreur RequestLimitExceeded est renvoyé.

Cette procédure utilise uniquement AWS CLI. Des informations sur ces ressources sont également disponibles dans Cockpit. Pour en savoir plus, voir Interface utilisateur des connexions VPN (pour Cockpit v1) ou le dashboard Virtual Gateways (pour Cockpit v2-beta).

Pour obtenir des informations sur une ou plusieurs virtual private gateways, utilisez la commande describe-vpn-gateways suivant cette syntaxe :

Exemple de requête
$ aws ec2 describe-vpn-gateways \
    --profile YOUR_PROFILE \
    [--filters NOT_SPECIFIED] \
    --endpoint https://fcu.eu-west-2.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

  • (optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Utiliser et configurer AWS CLI.

  • (optionnel) vpn-gateway-ids : L’ID d’une ou plusieurs virtual private gateways sur lesquelles vous voulez obtenir des informations.

  • (optionnel) filters : Un ou plusieurs filtres, au format "Name=X,Values=Y".

    Vous pouvez spécifier plusieurs valeurs pour un même filtre en utilisant le format "Name=X,Values=Y, Z".

    Les filtres suivants sont disponibles :

    • attachment.state : L’état d’attachement de la virtual private gateway au VPC, le cas échéant (attaching | attached | detaching | detached). Pour en savoir plus, voir À propos des virtual private gateways > Cycle de vie.

    • attachment.vpc-id : L’ID du VPC attaché, le cas échéant.

    • state : L’état de la virtual private gateway (pending | available | deleting | deleted). Pour en savoir plus, voir À propos des virtual private gateways > Cycle de vie.

    • tag-key : La clé d’un tag associé à la ressource.

    • tag-value : La valeur d’un tag associé à la ressource.

    • tag:XXXX : La valeur d’un tag associé à la ressource, où XXXX est la clé du tag.

      Pour filtrer un tag dont la clé est XXXX et la valeur est YYYY, vous pouvez donc utiliser un des deux formats suivants :

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

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

    • type : Le type de connexion VPN que la virtual private gateway supporte (toujours ipsec.1).

    • vpn-gateway-id : L’ID de la virtual private gateway.

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.

La commande describe-vpn-gateways renvoie les éléments suivants :

  • State : L’état de la virtual private gateway (pending | available | deleting | deleted). Pour en savoir plus, voir À propos des virtual private gateways > Cycle de vie.

  • Tags : Un ou plusieurs tags associés à la virtual private gateway. Cet élément contient les informations suivantes :

    • Key : La clé du tag.

    • Value : La valeur du tag.

  • Type : Le type de connexion VPN que la virtual private gateway supporte (toujours ipsec.1).

  • VpnGatewayId : L’ID de la virtual private gateway.

  • VpcAttachments : Informations à propos du VPC auquel la virtual private gateway est attachée, le cas échéant. Cet élément contient les informations suivantes :

Exemple de résultat
 {
    "VpnGateways": [
        {
            "State": "available",
            "Tags": [],
            "Type": "ipsec.1",
            "VpnGatewayId": "vgw-00ac2c82",
            "VpcAttachments": [
                {
                    "State": "attached",
                    "VpcId": "vpc-eb1e7306"
                }
            ]
        }
    ]
}

Pages connexes

Méthode API correspondante

AWS™ et Amazon Web Services™ sont des marques de commerce d'Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.