Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Esempi di topologia di istanze Amazon EC2
Puoi usare il comando describe-instance-topologyCLI per descrivere la topologia dell'istanza per le tue istanze EC2.
Quando utilizzi il comando describe-instance-topology
senza parametri o filtri, la risposta includerà tutte le istanze che corrispondono ai tipi di istanza supportati per questo comando nella Regione specificata. È possibile specificare la Regione includendo il parametro --region
o impostando una Regione predefinita. Per ulteriori informazioni sull'impostazione di una Regione predefinita, consulta Specificazione della regione di una risorsa.
È possibile includere parametri per restituire istanze che corrispondono agli ID di istanza o ai nomi dei gruppi di posizionamento specificati. È inoltre possibile includere filtri per restituire istanze che corrispondono a un tipo o una famiglia di istanze specifici o istanze in una zona di disponibilità o una zona locale specificata. È possibile includere un singolo parametro o filtro o una combinazione di parametri e filtri.
L'output è impaginato, con un massimo di 20 istanze per pagina per impostazione predefinita. È possibile specificare fino a 100 istanze per pagina utilizzando il parametro --max-results
.
Per ulteriori informazioni, consulta la sezione describe-instance-topology nella Documentazione di riferimento della AWS CLI .
Autorizzazioni richieste
È richiesta la seguente autorizzazione per descrivere la topologia dell'istanza:
-
ec2:DescribeInstanceTopology
Esempi
Esempio 1: Nessun parametro o filtro
Descrizione della topologia dell'istanza di tutte le istanze
Utilizza il comando describe-instance-topology della CLI senza specificare parametri o filtri.
aws ec2 describe-instance-topology --region
us-west-2
La risposta restituirà solo le istanze che corrispondono ai tipi di istanze supportati per questa API. Le istanze possono trovarsi in diverse zone di disponibilità, zone locali (ZoneId
) e gruppi di posizionamento (GroupName
). Se un'istanza non si trova in un gruppo di posizionamento, il campo GroupName
non sarà visualizzato nell'output. Nel seguente output di esempio, in un gruppo di posizionamento si trova solo una istanza.
Output di esempio
{
"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"
}
Esempio 2: Filtro per tipo di istanza
È possibile filtrare in base a un tipo di istanza specificato (corrispondenza esatta) o a una famiglia di istanze (utilizzando un carattere jolly). È inoltre possibile combinare un filtro per tipo di istanza specificato e un filtro per una famiglia di istanze.
Esempio 2a: Filtro di corrispondenza esatta per un tipo di istanza specificato
Descrizione della topologia delle istanze di tutte le istanze che corrispondono a un tipo di istanza specificato
Usa il comando describe-instance-topology della CLI con il filtro instance-type
. In questo esempio, l'output viene filtrato per le istanze trn1n.32xlarge
. La risposta restituirà solo le istanze che corrispondono al tipo di istanza specificato.
aws ec2 describe-instance-topology \ --region
us-west-2
\ --filters Name=instance-type,Values=trn1n.32xlarge
Output di esempio
{
"Instances": [
{
"InstanceId": "i-2222222222example",
"InstanceType": "trn1n.32xlarge",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3333333333example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
}
],
"NextToken": "SomeEncryptedToken"
}
Esempio 2b: Filtro con carattere jolly per una famiglia di istanze
Descrizione della topologia delle istanze di tutte le istanze che corrispondono a una famiglia di istanze
Usa il comando describe-instance-topology della CLI con il filtro instance-type
. In questo esempio, l'output viene filtrato per le istanze trn1*
. La risposta restituirà solo le istanze che corrispondono alla famiglia di istanze specificata.
aws ec2 describe-instance-topology \ --region
us-west-2
\ --filters Name=instance-type,Values=trn1*
Output di esempio
{
"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"
}
Esempio 2c: Filtri combinati per famiglia di istanze e corrispondenza esatta
Descrizione della topologia delle istanze di tutte le istanze che corrispondono a una famiglia di istanze o a un tipo di istanza specificati
Usa il comando describe-instance-topology della CLI con il filtro instance-type
. In questo esempio, l'output viene filtrato per le istanze pd4d*
o trn1n.32xlarge
. La risposta restituirà le istanze che corrispondono ai filtri specificati.
aws ec2 describe-instance-topology \ --region
us-west-2
\ --filters "Name=instance-type,Values=p4d*
,trn1n.32xlarge
"
Output di esempio
{
"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"
}
Esempio 3: Filtro per ID zona
È possibile utilizzare il filtro zone-id
per filtrare in base a una zona di disponibilità o una zona locale. È inoltre possibile combinare un filtro per la zona di disponibilità e un filtro per la zona locale.
Esempio 3a: Filtro per zona di disponibilità
Descrizione della topologia delle istanze di tutte le istanze che corrispondono a una zona di disponibilità specificata
Usa il comando describe-instance-topology della CLI con il filtro zone-id
. In questo esempio, l'output viene filtrato utilizzando l'ID della zona di disponibilità. use1-az1
La risposta restituirà solo le istanze che corrispondono alla zona di disponibilità specificata.
aws ec2 describe-instance-topology \ --region
us-east-1
\ --filters Name=zone-id,Values=use1-az1
Output di esempio
{
"Instances": [
{
"InstanceId": "i-2222222222example",
"InstanceType": "trn1n.32xlarge",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3214313214example"
],
"ZoneId": "use1-az1",
"AvailabilityZone": "us-east-1a"
}
],
"NextToken": "SomeEncryptedToken"
}
Esempio 3b: Filtro per zona locale
Per descrivere la topologia delle istanze di tutte le istanze che corrispondono a una zona locale specificata
Usa il comando describe-instance-topology della CLI con il filtro zone-id
. In questo esempio, l'output viene filtrato utilizzando l'ID della zona locale. use1-atl2-az1
La risposta restituirà solo le istanze che corrispondono alla zona locale specificata.
aws ec2 describe-instance-topology \ --region
us-east-1
\ --filters Name=zone-id,Values=use1-atl2-az1
Output di esempio
{
"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"
}
Esempio 3c: Filtri combinati per zona di disponibilità e zona locale
Descrizione della topologia delle istanze di tutte le istanze che corrispondono a una zona di disponibilità o zona locale specificata
Usa il comando describe-instance-topology della CLI con il filtro zone-id
. In questo esempio, l'output viene filtrato utilizzando l'ID della zona di disponibilità use1-az1
e l'ID della zona locale. use1-atl2-az1
La risposta restituirà le istanze che corrispondono ai filtri specificati.
aws ec2 describe-instance-topology \ --region
us-east-1
\ --filters Name=zone-id,Values=use1-az1
,use1-atl2-az1
Output di esempio
{
"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"
}
Esempio 4: Filtri combinati per tipo di istanza e ID zona
È possibile combinare tutti i filtri in un unico comando.
Descrizione della topologia delle istanze di tutte le istanze che corrispondono a un tipo di istanza, una famiglia di istanze, una zona di disponibilità o una zona locale specificati
Usa il comando describe-instance-topology della CLI con i filtri instance-type
e zone-id
. In questo esempio, l'output viene filtrato in base alla famiglia di p4d*
istanze, al tipo di trn1n.32xlarge
istanza, all'ID della zona di use1-az1
disponibilità e all'ID della zona use1-atl2-az1
locale. La risposta restituirà le istanze che corrispondono a p4d*
oppure le istanze trn1n.32xlarge
nella us-east-1a
oppure le zone 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
"
Output di esempio
{
"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"
}
Esempio 5: Parametro relativo al nome del gruppo di posizionamento
Descrizione della topologia di tutte le istanze in un gruppo di posizionamento specificato
Utilizza il comando describe-instance-topology della CLI con il parametro group-names
. Nell'esempio seguente, le istanze possono appartenere al gruppo di posizionamento ML-group
o HPC-group
. La risposta restituirà le istanze che si trovano in uno dei gruppi di posizionamento.
aws ec2 describe-instance-topology \ --region
us-west-2
\ --group-namesML-group
HPC-group
Output di esempio
{
"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"
}
Esempio 6: ID istanza
Descrizione della topologia dell'istanza specificata
Utilizza il comando describe-instance-topology della CLI con il parametro --instance-ids
. La risposta restituirà le istanze che corrispondono agli ID istanza specificati.
aws ec2 describe-instance-topology \ --region
us-west-2
\ --instance-idsi-1111111111example
i-2222222222example
Output di esempio
{
"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"
}