Obtenir des informations sur vos Internet gateways
Vous pouvez obtenir des informations à propos d’une ou plusieurs de vos Internet gateways, comme son état d’attachement ou le Virtual Private Cloud (VPC) auquel elle est attachée.
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 obtenir des informations à propos d’une ou plusieurs Internet gateways, utilisez la commande describe-internet-gateways suivant cette syntaxe :
$ aws ec2 describe-internet-gateway \
--profile YOUR_PROFILE \
[--internet-gateway-ids NOT_SPECIFIED] \
--filters "Name=attachment.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)
internet-gateway-ids
: Un ou plusieurs ID d’Internet 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 :
-
attachment.state
: L’état d’attachement actuel entre l’Internet gateway et un VPC (available
uniquement, si l’Internet gateway est attachée à un VPC). -
attachment.vpc-id
: L’ID du VPC auquel l’Internet gateway est attachée. -
internet-gateway-id
: L’ID de l’Internet 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 estYYYY
, 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-internet-gateways renvoie les éléments suivants :
-
InternetGateways
: Informations à propos d’une ou plusieurs Internet gateways. Cet élément contient les informations suivantes :-
Tags
: Un ou plusieurs tags associés à la ressource. Cet élément contient les informations suivantes :-
Value
: La valeur du tag. -
Key
: La clé du tag.
-
-
InternetGatewayId
: L’ID de l’Internet gateway. -
Attachments
: Informations à propos de l’attachement à un VPC. Cet élément contient les informations suivantes :-
State
: L’état d’attachement (available
uniquement, si l’Internet gateway est attachée à un VPC). -
VpcId
: L’ID du VPC auquel l’Internet gateway est attachée.
-
-
{
"InternetGateways": [
{
"Tags":[
{
"Value": "VPC1",
"Key": "Name"
}
],
"InternetGatewayId": "igw-12345678",
"Attachments": [
{
"State": "available",
"VpcId": "vpc-12345678"
}
]
}
]
}
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.