Exemplos de topologia de instância do Amazon EC2 - Amazon Elastic Compute Cloud
Ex. 1: DescribeInstanceTopology para IDs das instânciasEx. 2: DescribeInstanceTopology para o parâmetro do nome do grupo de posicionamentoEx. 3: DescribeInstanceTopology para o filtro de tipo de instânciaEx. 4: DescribeInstanceTopology para o filtro de ID da zonaEx. 5: DescribeInstanceTopology para filtros de tipo de instância e de ID da zonaEx. 6: DescribeCapacityReservationTopology para IDs das reservas de capacidadeEx. 7: DescribeCapacityReservationTopology para o filtro de tipo de instância

Exemplos de topologia de instância do Amazon EC2

É possível usar o comando describe-instance-topology para descrever a topologia das instâncias do EC2. Além disso, você pode usar o comando describe-capacity-reservation-topology para descrever a topologia das reservas de capacidade.

Se você usar os comandos describe-instance-topology ou describe-capacity-reservation-topology sem fornecer parâmetros ou filtros, a resposta retornará todas as instâncias ou reservas de capacidade que se encaixem nos tipos de instância compatíveis com esse comando na região especificada, de acordo com o comando escolhido. É 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.

Você pode fornecer parâmetros para que a resposta inclua somente as instâncias ou as reservas de capacidade que correspondam a determinados IDs de instância, IDs de reserva de capacidade ou nomes de grupos de posicionamento. Você também pode incluir filtros para retornar instâncias ou reservas de capacidade que correspondam a um tipo ou a uma família de instâncias especificados, ou instâncias ou reservas de capacidade 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.

Por padrão, as saídas são apresentadas em páginas, com um máximo de 20 instâncias ou reservas de capacidade por página. É possível especificar até 100 instâncias ou reservas de capacidade por página usando o parâmetro --max-results.

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

Permissões obrigatórias

As seguintes permissões são necessárias:

  • ec2:DescribeInstanceTopology: para descrever a topologia da instância

  • ec2:DescribeCapacityReservationTopology: para descrever a topologia da reserva de capacidade

Exemplo 1: DescribeInstanceTopology para IDs das 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: DescribeInstanceTopology para o 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: DescribeInstanceTopology para o 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: DescribeInstanceTopology para o filtro de ID da 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: DescribeInstanceTopology para filtros de tipo de instância e de ID da 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"}

Exemplo 6: DescribeCapacityReservationTopology para IDs das reservas de capacidade

AWS CLI
Para descrever a topologia de reservas de capacidade específicas

Use o comando describe-capacity-reservation-topology com o parâmetro capacity-reservation-id. A saída inclui apenas as reservas de capacidade que correspondem aos IDs de reservas de capacidade especificados.

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

O seguinte é um exemplo de saída.

{
    "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
Para descrever a topologia de reservas de capacidade específicas

Use o cmdlet Get-EC2CapacityReservationTopology.

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

Exemplo 7: DescribeCapacityReservationTopology para o 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.

AWS CLI
Para descrever a topologia de reservas de capacidade que contam com um tipo de instância específico

Use o comando describe-capacity-reservation-topology com o filtro de instance-type. A resposta retorna todas as instâncias correspondentes ao tipo de instância especificado.

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

O seguinte é um exemplo de saída.

{
    "CapacityReservations": [
        {
            "CapacityReservationId": "cr-2222222222example",
            "CapacityBlockId": "null",
            "State": "active",
            "InstanceType": "p5en.48xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example"
            ],
            "AvailabilityZone": "us-east-1a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
Para descrever a topologia de reservas de capacidade que contam com um tipo de instância específico

Use o cmdlet Get-EC2CapacityReservationTopology.

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