Esempi di topologia delle EC2 istanze Amazon - Amazon Elastic Compute Cloud
Ex 1: DescribeInstanceTopology - Istanza IDsEs 2: DescribeInstanceTopology - Parametro relativo al nome del gruppo di posizionamentoEs 3: DescribeInstanceTopology - Filtro per tipo di istanzaEx 4: DescribeInstanceTopology - Filtro Zone IDEs 5: DescribeInstanceTopology - Filtri per tipo di istanza e ID di zonaEx 6: DescribeCapacityReservationTopology - Prenotazione della capacità IDsEs 7: DescribeCapacityReservationTopology - Filtro per tipo di istanza

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 delle EC2 istanze Amazon

Puoi usare il describe-instance-topologycomando per descrivere la topologia delle tue istanze. EC2 Inoltre, puoi usare il comando describe-capacity-reservation-topology per descrivere la topologia delle prenotazioni della capacità.

Quando usi il comando describe-instance-topology o describe-capacity-reservation-topology senza parametri o filtri, la risposta includerà tutte le istanze o le prenotazioni della capacità (a seconda del comando utilizzato) 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 Seleziona una regione per le tue EC2 risorse Amazon.

È possibile includere parametri per restituire istanze o prenotazioni di capacità che corrispondono ai nomi delle istanze o delle prenotazioni di capacità specificate o dei gruppi IDs di collocamento. Puoi inoltre includere filtri per restituire istanze o prenotazioni della capacità che corrispondono a un tipo o a una famiglia di istanze specifici oppure istanze o prenotazioni della capacità 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 o prenotazioni della capacità per pagina per impostazione predefinita. Puoi specificare fino a 100 istanze o prenotazioni della capacità per pagina utilizzando il parametro --max-results.

Per ulteriori informazioni, consultare describe-instance-topology e describe-reservation-topology-topology.

Autorizzazioni richieste

Sono richieste le seguenti autorizzazioni:

  • ec2:DescribeInstanceTopology: per descrivere la topologia dell’istanza.

  • ec2:DescribeCapacityReservationTopology: per descrivere la topologia della prenotazione della capacità.

Esempio 1: DescribeInstanceTopology - Istanza IDs

AWS CLI
Per descrivere la topologia di istanze specifiche

Usa il comando describe-instance-topology con il parametro --instance-ids. L'output include solo le istanze che corrispondono all'istanza IDs specificata.

aws ec2 describe-instance-topology \
    --region us-west-2 \
    --instance-ids i-1111111111example i-2222222222example

Di seguito è riportato un output di esempio.

{
    "Instances": [
        {
            "InstanceId": "i-1111111111example",
            "InstanceType": "p4d.24xlarge",
            "GroupName": "ML-group",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3333333333example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        },
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "GroupName": "HPC-group",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3214313214example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
Per descrivere la topologia di istanze specifiche

Utilizza il cmdlet Get-EC2InstanceTopology.

Get-EC2InstanceTopology `
    -InstanceId i-1111111111example, i-2222222222example

Esempio 2: DescribeInstanceTopology - Parametro del nome del gruppo di posizionamento

AWS CLI
Per descrivere la topologia delle istanze in un gruppo di posizionamento specifico

Usa il comando describe-instance-topology con il parametro group-names. L’output include solo le istanze presenti in uno dei due gruppi di posizionamento specificati.

aws ec2 describe-instance-topology \
    --region us-west-2 \
    --group-names ML-group HPC-group

Di seguito è riportato un output di esempio.

{
    "Instances": [
        {
            "InstanceId": "i-1111111111example",
            "InstanceType": "p4d.24xlarge",
            "GroupName": "ML-group",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3333333333example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        },
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "GroupName": "HPC-group",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3214313214example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
Per descrivere la topologia delle istanze in un gruppo di posizionamento specifico

Utilizza il cmdlet Get-EC2InstanceTopology.

Get-EC2InstanceTopology `
    -GroupName ML-group, HPC-group

Esempio 3: DescribeInstanceTopology - 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 3a — Filtro a corrispondenza esatta per un tipo di istanza specificato

AWS CLI
Per descrivere la topologia di istanze con un tipo di istanza specifico

Usa il comando describe-instance-topology con il filtro instance-type. L’output include solo le istanze con il tipo di istanza specificato.

aws ec2 describe-instance-topology \
    --region us-west-2 \
    --filters Name=instance-type,Values=trn1n.32xlarge

Di seguito è riportato un output di esempio.

{
    "Instances": [
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3333333333example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
Per descrivere la topologia di istanze con un tipo di istanza specifico

Utilizza il cmdlet Get-EC2InstanceTopology.

Get-EC2InstanceTopology `
    -Filter @{Name="instance-type"; Values="trn1n.32xlarge"}

Esempio 3b — Filtro wild card per una famiglia di istanze

AWS CLI
Per descrivere la topologia di istanze con una famiglia di istanze specifica

Usa il comando describe-instance-topology con il filtro instance-type. L’output include solo le istanze con la famiglia di istanze specificata.

aws ec2 describe-instance-topology \
    --region us-west-2 \
    --filters Name=instance-type,Values=trn1*

Di seguito è riportato un output di esempio.

{
    "Instances": [
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3333333333example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        },
        {
            "InstanceId": "i-3333333333example",
            "InstanceType": "trn1.32xlarge",
            "NetworkNodes": [
                "nn-1212121212example",
                "nn-1211122211example",
                "nn-1311133311example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "usw2-az4",
            "AvailabilityZone": "us-west-2d"            
        },
        {
            "InstanceId": "i-444444444example",
            "InstanceType": "trn1.2xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-5434334334example",
                "nn-1235301234example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"          
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
Per descrivere la topologia di istanze con una famiglia di istanze specifica

Utilizza il cmdlet Get-EC2InstanceTopology.

Get-EC2InstanceTopology `
    -Filter @{Name="instance-type"; Values="trn1*"}

Esempio 3c — Famiglia di istanze combinata e filtri Exact Match

AWS CLI
Per descrivere la topologia di istanze con una famiglia di istanze o un tipo di istanza

Usa il comando describe-instance-topology con il filtro instance-type. L’output include solo le istanze che soddisfano i criteri specificati.

aws ec2 describe-instance-topology \
    --region us-west-2 \
    --filters "Name=instance-type,Values=p4d*,trn1n.32xlarge"

Di seguito è riportato un output di esempio.

{
    "Instances": [
        {
            "InstanceId": "i-1111111111example",
            "InstanceType": "p4d.24xlarge",
            "GroupName": "ML-group",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3333333333example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        },
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-4343434343example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
Per descrivere la topologia di istanze con una famiglia di istanze o un tipo di istanza

Utilizza il cmdlet Get-EC2InstanceTopology.

Get-EC2InstanceTopology `
    -Filter @{Name="instance-type"; Values="p4d*", "trn1n.32xlarge"}

Esempio 4: DescribeInstanceTopology - Filtro Zone ID

È 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 4a — Filtro della zona di disponibilità

AWS CLI
Per descrivere la topologia di istanze in una zona di disponibilità specifica

Usa il comando describe-instance-topology con il filtro zone-id. L’output include solo le istanze nella zona di disponibilità specificata.

aws ec2 describe-instance-topology \
    --region us-east-1 \
    --filters Name=zone-id,Values=use1-az1

Di seguito è riportato un output di esempio.

{
    "Instances": [
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3214313214example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "use1-az1",
            "AvailabilityZone": "us-east-1a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
Per descrivere la topologia di istanze in una zona di disponibilità specifica

Utilizza il cmdlet Get-EC2InstanceTopology.

Get-EC2InstanceTopology `
    -Filter @{Name="zone-id"; Values="use1-az1"}

Esempio 4b: filtro Zona locale

AWS CLI
Per descrivere la topologia di istanze in una zona locale specifica

Usa il comando describe-instance-topology con il filtro zone-id. L’output include solo le istanze nella zona locale specificata.

aws ec2 describe-instance-topology \
    --region us-east-1 \
    --filters Name=zone-id,Values=use1-atl2-az1

Di seguito è riportato un output di esempio.

{
    "Instances": [
        {
            "InstanceId": "i-1111111111example",
            "InstanceType": "p4d.24xlarge",
            "GroupName": "ML-group",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3333333333example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "use1-atl2-az1",
            "AvailabilityZone": "us-east-1-atl-2a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
Per descrivere la topologia di istanze in una zona locale specifica

Utilizza il cmdlet Get-EC2InstanceTopology.

Get-EC2InstanceTopology `
    -Filter @{Name="zone-id"; Values="use1-atl2-az1"}

Esempio 4c — Filtri combinati per zone di disponibilità e zone locali

AWS CLI
Per descrivere la topologia di istanze in una zona specifica

Usa il comando describe-instance-topology con il filtro zone-id. L’output include solo le istanze in una delle due zone specificate.

aws ec2 describe-instance-topology \
    --region us-east-1 \
    --filters Name=zone-id,Values=use1-az1,use1-atl2-az1

Di seguito è riportato un output di esempio.

{
    "Instances": [
        {
            "InstanceId": "i-1111111111example",
            "InstanceType": "p4d.24xlarge",
            "GroupName": "ML-group",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3333333333example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "use1-atl2-az1",
            "AvailabilityZone": "us-east-1-atl-2a"
        },
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3214313214example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "use1-az1",
            "AvailabilityZone": "us-east-1a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
Per descrivere la topologia di istanze in una zona specifica

Utilizza il cmdlet Get-EC2InstanceTopology.

Get-EC2InstanceTopology `
    -Filter @{Name="zone-id"; Values="use1-az1", "use1-atl2-az1"}

Esempio 5: DescribeInstanceTopology - Filtri per tipo di istanza e ID di zona

Puoi combinare i filtri in un singolo comando.

AWS CLI
Per descrivere la topologia di istanze con tipi di istanza, famiglie di istanze e zone specifici

Usa il comando describe-instance-topology con i filtri instance-type e zone-id. La risposta contiene tutte le istanze con uno dei due tipi di istanza specificati e in una delle due zone specificate.

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"

Di seguito è riportato un output di esempio.

{
    "Instances": [
        {
            "InstanceId": "i-1111111111example",
            "InstanceType": "p4d.24xlarge",
            "GroupName": "ML-group",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3333333333example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "use1-atl2-az1",
            "AvailabilityZone": "us-east-1-atl-2a"
        },
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3214313214example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "use1-az1",
            "AvailabilityZone": "us-east-1a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
Per descrivere la topologia di istanze con tipi di istanza, famiglie di istanze e zone specifici

Utilizza il cmdlet Get-EC2InstanceTopology.

Get-EC2InstanceTopology `
    -Filter @{Name="instance-type"; Values="p4d*", "trn1n.32xlarge"} `
            @{Name="zone-id"; Values="use1-az1", "use1-atl2-az1"}

Esempio 6: DescribeCapacityReservationTopology - Prenotazione della capacità IDs

AWS CLI
Per descrivere la topologia di prenotazioni della capacità specifiche

Usa il comando describe-capacity-reservation-topology con il parametro capacity-reservation-id. L'output include solo le prenotazioni di capacità che corrispondono alla prenotazione di capacità specificata IDs.

aws ec2 describe-capacity-reservation-topology \
    --region us-east-1 \
    --capacity-reservation-id cr-1111111111example cr-2222222222example

Di seguito è riportato un output di esempio.

{
    "CapacityReservations": [
        {
            "CapacityReservationId": "cr-1111111111example",
            "CapacityBlockId": "null",
            "State": "active",
            "InstanceType": "p5.48xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example"
            ],
            "AvailabilityZone": "us-east-1a"
        },
        {
            "CapacityReservationId": "cr-2222222222example",
            "CapacityBlockId": "null",
            "State": "active",
            "InstanceType": "p5en.48xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example"
            ],
            "AvailabilityZone": "us-east-1a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
Per descrivere la topologia di prenotazioni della capacità specifiche

Utilizza il cmdlet Get-EC2CapacityReservationTopology.

Get-EC2CapacityReservationTopology `
    -CapacityReservationId cr-1111111111example cr-2222222222example

Esempio 7: DescribeCapacityReservationTopology - 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.

AWS CLI
Per descrivere la topologia di prenotazioni della capacità con un tipo di istanza specifico

Usa il comando describe-capacity-reservation-topology con il filtro instance-type. La risposta contiene tutte le istanze con il tipo di istanza specificato.

aws ec2 describe-capacity-reservation-topology \
    --region us-east-1 \
    --filters Name=instance-type,Values=p5en.48xlarge

Di seguito è riportato un output di esempio.

{
    "CapacityReservations": [
        {
            "CapacityReservationId": "cr-2222222222example",
            "CapacityBlockId": "null",
            "State": "active",
            "InstanceType": "p5en.48xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example"
            ],
            "AvailabilityZone": "us-east-1a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
Per descrivere la topologia di prenotazioni della capacità con un tipo di istanza specifico

Utilizza il cmdlet Get-EC2CapacityReservationTopology.

Get-EC2CapacityReservationTopology `
    -Filter @{Name="instance-type"; Values="p5en.48xlarge"}