Exemplos de topologia de instância do Amazon EC2 - Amazon Elastic Compute Cloud
Exemplo 1: IDs de instânciasExemplo 2: parâmetro do nome do grupo de posicionamentoExemplo 3: filtro de tipo de instânciaExemplo 4: filtro de ID de zonaExemplo 5: filtros de tipo de instância e ID de zona

Exemplos de topologia de instância do Amazon EC2

É possível usar o comando describe-instance-topology para descrever a topologia de instâncias para suas instâncias do EC2.

Quando você usa o comando describe-instance-topology sem parâmetros ou filtros, a resposta inclui todas as instâncias que correspondem aos tipos de instância compatíveis com esse comando na região especificada. É possível especificar a região incluindo o parâmetro --region ou definindo uma região padrão. Para obter mais informações sobre a definição de uma região padrão, consulte Selecionar uma região para os recursos do Amazon EC2.

É possível incluir parâmetros para retornar instâncias que correspondam aos IDs de instância ou aos nomes de grupos de posicionamento especificados. Você também pode incluir filtros para retornar instâncias que correspondam a um determinado tipo ou família de instâncias, ou a instâncias em uma zona de disponibilidade ou zona local específica. É possível incluir um único parâmetro ou filtro, ou uma combinação de parâmetros e filtros.

A saída é paginada, com até 20 instâncias por página por padrão. É possível especificar até 100 instâncias por página usando o parâmetro --max-results.

Para obter mais informações, consulte describe-instance-topology.

Permissões obrigatórias

A permissão a seguir é necessária para descrever a topologia de instâncias:

  • ec2:DescribeInstanceTopology

Exemplo 1: IDs de instâncias

AWS CLI
Para descrever a topologia de instâncias específicas

Use o comando describe-instance-topology com o parâmetro --instance-ids. A saída inclui somente as instâncias que correspondem aos IDs de instância especificados.

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

O seguinte é um exemplo de saída.

{
    "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
Para descrever a topologia de instâncias específicas

Use o cmdlet Get-EC2InstanceTopology.

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

Exemplo 2: parâmetro do nome do grupo de posicionamento

AWS CLI
Para descrever a topologia das instâncias em um grupo de posicionamento específico

Use o comando describe-instance-topology com o parâmetro group-names. A saída inclui somente as instâncias que estão em qualquer um dos grupos de posicionamento especificados.

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

O seguinte é um exemplo de saída.

{
    "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
Para descrever a topologia das instâncias em um grupo de posicionamento específico

Use o cmdlet Get-EC2InstanceTopology.

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

Exemplo 3: filtro de tipo de instância

É possível filtrar por um tipo de instância especificado (correspondência exata) ou filtrar por uma família de instâncias (usando um caractere curinga). Você também pode combinar um filtro um tipo de instância e um filtro de família de instâncias.

Exemplo 3a: filtro de correspondência exata para um tipo de instância especificado

AWS CLI
Para descrever a topologia de instâncias com um tipo de instância específico

Use o comando describe-instance-topology com o filtro de instance-type. A saída inclui somente as instâncias com o tipo de instância especificado.

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

O seguinte é um exemplo de saída.

{
    "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
Para descrever a topologia de instâncias com um tipo de instância específico

Use o cmdlet Get-EC2InstanceTopology.

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

Exemplo 3b: filtro com curinga para uma família de instâncias

AWS CLI
Para descrever a topologia de instâncias com uma família de instâncias específica

Use o comando describe-instance-topology com o filtro de instance-type. A saída inclui somente as instâncias com a família de instâncias especificada.

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

O seguinte é um exemplo de saída.

{
    "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
Para descrever a topologia de instâncias com uma família de instâncias específica

Use o cmdlet Get-EC2InstanceTopology.

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

Exemplo 3c: filtros combinados de família de instâncias e correspondência exata

AWS CLI
Para descrever a topologia de instâncias com uma família de instâncias ou um tipo de instância

Use o comando describe-instance-topology com o filtro de instance-type. A saída inclui somente as instâncias que atendem aos critérios especificados.

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

O seguinte é um exemplo de saída.

{
    "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
Para descrever a topologia de instâncias com uma família de instâncias ou um tipo de instância

Use o cmdlet Get-EC2InstanceTopology.

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

Exemplo 4: filtro de ID de zona

É possível usar o filtro zone-id para filtrar por uma zona de disponibilidade ou zona local. Você também pode combinar um filtro de zona de disponibilidade e um filtro de zona local.

Exemplo 4a: filtro de zona de disponibilidade

AWS CLI
Para descrever a topologia das instâncias em uma zona de disponibilidade específica

Use o comando describe-instance-topology com o filtro de zone-id. A saída inclui somente as instâncias na zona de disponibilidade especificada.

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

O seguinte é um exemplo de saída.

{
    "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
Para descrever a topologia das instâncias em uma zona de disponibilidade específica

Use o cmdlet Get-EC2InstanceTopology.

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

Exemplo 4b: filtro de zona local

AWS CLI
Para descrever a topologia das instâncias em uma zona local específica

Use o comando describe-instance-topology com o filtro de zone-id. A saída inclui somente as instâncias na zona local especificada.

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

O seguinte é um exemplo de saída.

{
    "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
Para descrever a topologia das instâncias em uma zona local específica

Use o cmdlet Get-EC2InstanceTopology.

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

Exemplo 4c: filtros combinados de zona de disponibilidade e zona local

AWS CLI
Para descrever a topologia das instâncias em uma zona específica

Use o comando describe-instance-topology com o filtro de zone-id. A saída inclui somente as instâncias que estão em qualquer uma das zonas especificadas.

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

O seguinte é um exemplo de saída.

{
    "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
Para descrever a topologia das instâncias em uma zona específica

Use o cmdlet Get-EC2InstanceTopology.

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

Exemplo 5: filtros de tipo de instância e ID de zona

É possível combinar os filtros em um único comando.

AWS CLI
Para descrever a topologia de instâncias com tipos de instância, famílias de instâncias e zonas específicos

Use o comando describe-instance-topology com os filtros de instance-type e zone-id. A resposta contém quaisquer instâncias com qualquer um dos tipos de instância especificados e que estão em qualquer uma das zonas especificadas.

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"

O seguinte é um exemplo de saída.

{
    "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
Para descrever a topologia de instâncias com tipos de instância, famílias de instâncias e zonas específicos

Use o cmdlet Get-EC2InstanceTopology.

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