Obtenir des informations sur vos NAT gateways

Vous pouvez obtenir des informations à propos d’une ou plusieurs de vos NAT gateways, comme son IP externe (EIP) ou le Virtual Private Cloud (VPC) et subnet dans lesquels elle se trouve.

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 VPC (pour Cockpit v1) ou le dashboard NAT Services (pour Cockpit v2-beta).

Pour obtenir des informations à propos d’une ou plusieurs NAT gateways, utilisez la commande describe-nat-gateways suivant cette syntaxe :

Exemple de requête
$ aws ec2 describe-nat-gateways \
    --profile YOUR_PROFILE \
    --nat-gateway-ids [NOT_SPECIFIED] \
    --filters "Name=state,Values=available" \
    --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) nat-gateway-ids : Un ou plusieurs ID de NAT gateways.

  • (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 :

    • nat-gateway-id : L’ID de la NAT gateway.

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

    • subnet-id : L’ID du subnet dans lequel est la NAT gateway.

    • vpc-id : L’ID du VPC dans lequel est la NAT gateway.

    • 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

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

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

  • NatGateways : Informations à propos d’une ou plusieurs NAT gateways. Cet élément contient les informations suivantes :

  • CreateTime : La date et l’heure de création de la NAT gateway.

    • NatGatewayAddresses : Informations à propos de l’EIP associée à la NAT gateway. Cet élément contient les informations suivantes :

      • AllocationId : L’ID d’allocation de l’EIP.

      • PublicIp : L’EIP associée à la NAT gateway.

  • NatGatewayId : L’ID de la NAT gateway.

  • State : L’état de la NAT gateway. Pour en savoir plus, voir À propos des NAT gateways.

  • SubnetId : L’ID du subnet dans lequel est la NAT gateway.

  • VpcId : L’ID du VPC dans lequel est la NAT gateway.

  • Tags : Les tags associés à votre ressource.

    • Key : La clé du tag.

    • Value : La valeur du tag.

Exemple de résultat
{
  "NatGateways": [
    {
        "CreateTime": "2016-11-08T10:58:42.654Z",
        "NatGatewayAddresses": [
            {
                "AllocationId": "eipalloc-87654321",
                "PublicIp": "111.1.1.1"
            }
        ],
        "NatGatewayId": "nat-5678efgh",
        "State": "available",
        "SubnetId": "subnet-4321dcba",
        "VpcId": "vpc-1234abcd",
        "Tags": []
    }
  ]
}

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.