Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Exemples de topologie d'instance Amazon EC2
Vous pouvez utiliser la commande describe-instance-topologyCLI pour décrire la topologie d'instance de vos instances EC2.
Lorsque vous utilisez la commande describe-instance-topology
sans paramètres ni filtres, la réponse inclut toutes vos instances qui correspondent aux types d’instances pris en charge pour cette commande dans la région spécifiée. Vous pouvez spécifier la région en incluant le paramètre --region
ou en définissant une région par défaut. Pour plus d’informations sur la définition d’une région par défaut, consultez Spécifier la région pour une ressource.
Vous pouvez inclure des paramètres pour renvoyer des instances qui correspondent aux ID d’instance ou aux noms de groupes de placement spécifiés. Vous pouvez également inclure des filtres pour renvoyer des instances correspondant à un type d’instance ou à une famille d’instances spécifiques, ou des instances situées dans une zone de disponibilité ou une zone locale spécifiée. Vous pouvez inclure un seul paramètre ou filtre, ou une combinaison de paramètres et de filtres.
La sortie est paginée, avec un maximum de 20 instances par page par défaut. Vous pouvez spécifier jusqu’à 100 instances par page à l’aide du paramètre --max-results
.
Pour plus d’informations, consultez la section describe-instance-topology dans la référence des commandes AWS CLI .
Autorisations nécessaires
L'autorisation suivante est requise pour décrire la topologie de l'instance :
-
ec2:DescribeInstanceTopology
Exemples
Exemple 1 : pas de paramètre ni de filtre
Pour décrire la topologie de toutes vos instances
Utilisez la commande describe-instance-topology de la CLI sans spécifier de paramètres ni de filtres.
aws ec2 describe-instance-topology --region
us-west-2
La réponse renvoie uniquement les instances qui correspondent aux types d’instances pris en charge pour cette API. Les instances peuvent se trouver dans différentes zones de disponibilité, zones locales (ZoneId
) et groupes de placement (GroupName
). Si une instance ne figure pas dans un groupe de placement, le champ GroupName
n’apparaît pas dans la sortie. Dans l’exemple de sortie suivant, une seule instance se trouve dans un groupe de placement.
Exemple de sortie
{
"Instances": [
{
"InstanceId": "i-1111111111example",
"InstanceType": "p4d.24xlarge",
"GroupName": "my-ml-cpg",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3333333333example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
},
{
"InstanceId": "i-2222222222example",
"InstanceType": "p4d.24xlarge",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3333333333example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
},
{
"InstanceId": "i-3333333333example",
"InstanceType": "trn1.32xlarge",
"NetworkNodes": [
"nn-1212121212example",
"nn-1211122211example",
"nn-1311133311example"
],
"ZoneId": "usw2-az4",
"AvailabilityZone": "us-west-2d"
},
{
"InstanceId": "i-444444444example",
"InstanceType": "trn1.2xlarge",
"NetworkNodes": [
"nn-1111111111example",
"nn-5434334334example",
"nn-1235301234example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
}
],
"NextToken": "SomeEncryptedToken"
}
Exemple 2 : filtre de type d’instance
Vous pouvez filtrer en fonction d’un type d’instance spécifié (correspondance exacte) ou en fonction d’une famille d’instances (à l’aide d’un caractère générique). Vous pouvez également combiner un filtre de type d’instance et un filtre de famille d’instances spécifiés.
Exemple 2a : filtre de correspondance exacte pour un type d’instance spécifié
Pour décrire la topologie d’instance de toutes vos instances correspondant à un type d’instance spécifié
Utilisez la commande describe-instance-topology de la CLI avec le filtre instance-type
. Dans cet exemple, la sortie est filtrée pour les instances trn1n.32xlarge
. La réponse renverra uniquement les instances correspondant au type d’instance spécifié.
aws ec2 describe-instance-topology \ --region
us-west-2
\ --filters Name=instance-type,Values=trn1n.32xlarge
Exemple de sortie
{
"Instances": [
{
"InstanceId": "i-2222222222example",
"InstanceType": "trn1n.32xlarge",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3333333333example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
}
],
"NextToken": "SomeEncryptedToken"
}
Exemple 2b : filtre générique pour une famille d’instances
Pour décrire la topologie d’instance de toutes vos instances correspondant à une famille d’instances
Utilisez la commande describe-instance-topology de la CLI avec le filtre instance-type
. Dans cet exemple, la sortie est filtrée pour les instances trn1*
. La réponse renverra uniquement les instances correspondant à la famille d’instances spécifiée.
aws ec2 describe-instance-topology \ --region
us-west-2
\ --filters Name=instance-type,Values=trn1*
Exemple de sortie
{
"Instances": [
{
"InstanceId": "i-2222222222example",
"InstanceType": "trn1n.32xlarge",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3333333333example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
},
{
"InstanceId": "i-3333333333example",
"InstanceType": "trn1.32xlarge",
"NetworkNodes": [
"nn-1212121212example",
"nn-1211122211example",
"nn-1311133311example"
],
"ZoneId": "usw2-az4",
"AvailabilityZone": "us-west-2d"
},
{
"InstanceId": "i-444444444example",
"InstanceType": "trn1.2xlarge",
"NetworkNodes": [
"nn-1111111111example",
"nn-5434334334example",
"nn-1235301234example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
}
],
"NextToken": "SomeEncryptedToken"
}
Exemple 2c : famille d’instances combinée et filtres de correspondance exacte
Pour décrire la topologie d’instance de toutes vos instances correspondant à une famille d’instances ou à un type d’instance spécifié
Utilisez la commande describe-instance-topology de la CLI avec le filtre instance-type
. Dans cet exemple, la sortie est filtrée pour les instances pd4d*
ou trn1n.32xlarge
. La réponse renverra les instances correspondant à n’importe lequel des filtres spécifiés.
aws ec2 describe-instance-topology \ --region
us-west-2
\ --filters "Name=instance-type,Values=p4d*
,trn1n.32xlarge
"
Exemple de sortie
{
"Instances": [
{
"InstanceId": "i-1111111111example",
"InstanceType": "p4d.24xlarge",
"GroupName": "ML-group",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3333333333example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
},
{
"InstanceId": "i-2222222222example",
"InstanceType": "trn1n.32xlarge",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-4343434343example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
}
],
"NextToken": "SomeEncryptedToken"
}
Exemple 3 : filtre zone-id
Vous pouvez utiliser le filtre zone-id
pour filtrer par zone de disponibilité ou zone locale. Vous pouvez également combiner le filtre de zone de disponibilité et le filtre de zone locale.
Exemple 3a : filtre de zone de disponibilité
Pour décrire la topologie d’instance de toutes vos instances correspondant à une zone de disponibilité spécifiée
Utilisez la commande describe-instance-topology de la CLI avec le filtre zone-id
. Dans cet exemple, la sortie est filtrée à l'aide de l'ID de zone de disponibilitéuse1-az1
. La réponse renverra uniquement les instances correspondant à la zone de disponibilité spécifiée.
aws ec2 describe-instance-topology \ --region
us-east-1
\ --filters Name=zone-id,Values=use1-az1
Exemple de sortie
{
"Instances": [
{
"InstanceId": "i-2222222222example",
"InstanceType": "trn1n.32xlarge",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3214313214example"
],
"ZoneId": "use1-az1",
"AvailabilityZone": "us-east-1a"
}
],
"NextToken": "SomeEncryptedToken"
}
Exemple 3b : filtre de zone locale
Pour décrire la topologie d’instance de toutes vos instances correspondant à une zone locale spécifiée
Utilisez la commande describe-instance-topology de la CLI avec le filtre zone-id
. Dans cet exemple, la sortie est filtrée à l'aide de l'ID de zone localuse1-atl2-az1
. La réponse renverra uniquement les instances correspondant à la zone locale spécifiée.
aws ec2 describe-instance-topology \ --region
us-east-1
\ --filters Name=zone-id,Values=use1-atl2-az1
Exemple de sortie
{
"Instances": [
{
"InstanceId": "i-1111111111example",
"InstanceType": "p4d.24xlarge",
"GroupName": "ML-group",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3333333333example"
],
"ZoneId": "use1-atl2-az1",
"AvailabilityZone": "us-east-1-atl-2a"
}
],
"NextToken": "SomeEncryptedToken"
}
Exemple 3c : combinaison des filtres de zone de disponibilité et de zone locale
Pour décrire la topologie d’instance de toutes vos instances correspondant à une zone de disponibilité ou une zone locale spécifiée
Utilisez la commande describe-instance-topology de la CLI avec le filtre zone-id
. Dans cet exemple, la sortie est filtrée à l'aide de l'ID de zone de disponibilité use1-az1
et de l'ID de zone localeuse1-atl2-az1
. La réponse renverra les instances correspondant à n’importe lequel des filtres spécifiés.
aws ec2 describe-instance-topology \ --region
us-east-1
\ --filters Name=zone-id,Values=use1-az1
,use1-atl2-az1
Exemple de sortie
{
"Instances": [
{
"InstanceId": "i-1111111111example",
"InstanceType": "p4d.24xlarge",
"GroupName": "ML-group",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3333333333example"
],
"ZoneId": "use1-atl2-az1",
"AvailabilityZone": "us-east-1-atl-2a"
},
{
"InstanceId": "i-2222222222example",
"InstanceType": "trn1n.32xlarge",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3214313214example"
],
"ZoneId": "use1-az1",
"AvailabilityZone": "us-east-1a"
}
],
"NextToken": "SomeEncryptedToken"
}
Exemple 4 : combinaison des filtres de type d’instance et zone-id
Vous pouvez combiner tous les filtres au sein d’une même commande.
Pour décrire la topologie d’instance de toutes vos instances correspondant à un type d’instance, une famille d’instances, une zone de disponibilité ou une zone locale spécifiés
Utilisez la commande describe-instance-topology de la CLI avec les filtres instance-type
et zone-id
. Dans cet exemple, la sortie est filtrée en fonction de la famille d'p4d*
instances, du type d'trn1n.32xlarge
instance, de l'ID de zone de use1-az1
disponibilité et de l'ID de zone use1-atl2-az1
locale. La réponse renverra les instances qui correspondent aux instances p4d*
ou trn1n.32xlarge
situées dans les zones us-east-1a
ou us-east-1-atl-2a
.
aws ec2 describe-instance-topology \ --region
us-east-1
\ --filters "Name=instance-type,Values=p4d*
,trn1n.32xlarge
" "Name=zone-id,Values=use1-az1
,use1-atl2-az1
"
Exemple de sortie
{
"Instances": [
{
"InstanceId": "i-1111111111example",
"InstanceType": "p4d.24xlarge",
"GroupName": "ML-group",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3333333333example"
],
"ZoneId": "use1-atl2-az1",
"AvailabilityZone": "us-east-1-atl-2a"
},
{
"InstanceId": "i-2222222222example",
"InstanceType": "trn1n.32xlarge",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3214313214example"
],
"ZoneId": "use1-az1",
"AvailabilityZone": "us-east-1a"
}
],
"NextToken": "SomeEncryptedToken"
}
Exemple 5 : paramètre de nom du groupe de placement
Pour décrire la topologie de toutes vos instances dans un groupe de placement spécifié
Utilisez la commande describe-instance-topology de la CLI avec le paramètre group-names
. Dans l’exemple suivant, les instances peuvent se trouver dans le groupe de placement ML-group
ou HPC-group
. La réponse renverra les instances qui se trouvent dans l’un des groupes de placement.
aws ec2 describe-instance-topology \ --region
us-west-2
\ --group-namesML-group
HPC-group
Exemple de sortie
{
"Instances": [
{
"InstanceId": "i-1111111111example",
"InstanceType": "p4d.24xlarge",
"GroupName": "ML-group",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3333333333example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
},
{
"InstanceId": "i-2222222222example",
"InstanceType": "trn1n.32xlarge",
"GroupName": "HPC-group",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3214313214example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
}
],
"NextToken": "SomeEncryptedToken"
}
Exemple 6 : ID d’instance
Pour décrire la topologie d’instances spécifiées
Utilisez la commande describe-instance-topology de la CLI avec le paramètre --instance-ids
. La réponse renverra les instances qui correspondent aux ID d’instance spécifiés.
aws ec2 describe-instance-topology \ --region
us-west-2
\ --instance-idsi-1111111111example
i-2222222222example
Exemple de sortie
{
"Instances": [
{
"InstanceId": "i-1111111111example",
"InstanceType": "p4d.24xlarge",
"GroupName": "ML-group",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3333333333example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
},
{
"InstanceId": "i-2222222222example",
"InstanceType": "trn1n.32xlarge",
"GroupName": "HPC-group",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3214313214example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
}
],
"NextToken": "SomeEncryptedToken"
}