

# Exemplos de topologia de instância do Amazon EC2
<a name="ec2-instance-topology-examples"></a>

É possível usar o comando [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) para descrever a topologia das instâncias do EC2. Além disso, você pode usar o comando [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) 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](using-regions-availability-zones-setup.md).

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 [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) e [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-reservation-topology-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-reservation-topology-topology.html).

**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

**Contents**
+ [Exemplo 1: DescribeInstanceTopology para IDs das instâncias](#instance-topology-ex1)
+ [Exemplo 2: DescribeInstanceTopology para o parâmetro do nome do grupo de posicionamento](#instance-topology-ex2)
+ [Exemplo 3: DescribeInstanceTopology para o filtro de tipo de instância](#instance-topology-ex3)
  + [Exemplo 3a: filtro de correspondência exata para um tipo de instância especificado](#instance-topology-ex3a)
  + [Exemplo 3b: filtro com curinga para uma família de instâncias](#instance-topology-ex3b)
  + [Exemplo 3c: filtros combinados de família de instâncias e correspondência exata](#instance-topology-ex3c)
+ [Exemplo 4: DescribeInstanceTopology para o filtro de ID da zona](#instance-topology-ex4)
  + [Exemplo 4a: filtro de zona de disponibilidade](#instance-topology-ex4a)
  + [Exemplo 4b: filtro de zona local](#instance-topology-ex4b)
  + [Exemplo 4c: filtros combinados de zona de disponibilidade e zona local](#instance-topology-ex4c)
+ [Exemplo 5: DescribeInstanceTopology para filtros de tipo de instância e de ID da zona](#instance-topology-ex5)
+ [Exemplo 6: DescribeCapacityReservationTopology para IDs das reservas de capacidade](#instance-topology-ex6)
+ [Exemplo 7: DescribeCapacityReservationTopology para o filtro de tipo de instância](#instance-topology-ex7)

## Exemplo 1: DescribeInstanceTopology para IDs das instâncias
<a name="instance-topology-ex1"></a>

------
#### [ AWS CLI ]

**Para descrever a topologia de instâncias específicas**  
Use o comando [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).

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

------

## Exemplo 2: DescribeInstanceTopology para o parâmetro do nome do grupo de posicionamento
<a name="instance-topology-ex2"></a>

------
#### [ AWS CLI ]

**Para descrever a topologia das instâncias em um grupo de posicionamento específico**  
Use o comando [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).

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

------

## Exemplo 3: DescribeInstanceTopology para o filtro de tipo de instância
<a name="instance-topology-ex3"></a>

É 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
<a name="instance-topology-ex3a"></a>

------
#### [ AWS CLI ]

**Para descrever a topologia de instâncias com um tipo de instância específico**  
Use o comando [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).

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

------

### Exemplo 3b: filtro com curinga para uma família de instâncias
<a name="instance-topology-ex3b"></a>

------
#### [ AWS CLI ]

**Para descrever a topologia de instâncias com uma família de instâncias específica**  
Use o comando [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).

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

------

### Exemplo 3c: filtros combinados de família de instâncias e correspondência exata
<a name="instance-topology-ex3c"></a>

------
#### [ 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 [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).

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

------

## Exemplo 4: DescribeInstanceTopology para o filtro de ID da zona
<a name="instance-topology-ex4"></a>

É 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
<a name="instance-topology-ex4a"></a>

------
#### [ AWS CLI ]

**Para descrever a topologia das instâncias em uma zona de disponibilidade específica**  
Use o comando [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).

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

------

### Exemplo 4b: filtro de zona local
<a name="instance-topology-ex4b"></a>

------
#### [ AWS CLI ]

**Para descrever a topologia das instâncias em uma zona local específica**  
Use o comando [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).

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

------

### Exemplo 4c: filtros combinados de zona de disponibilidade e zona local
<a name="instance-topology-ex4c"></a>

------
#### [ AWS CLI ]

**Para descrever a topologia das instâncias em uma zona específica**  
Use o comando [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).

```
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
<a name="instance-topology-ex5"></a>

É 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 [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).

```
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
<a name="instance-topology-ex6"></a>

------
#### [ AWS CLI ]

**Para descrever a topologia de reservas de capacidade específicas**  
Use o comando [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-capacity-reservation-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-capacity-reservation-topology.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2CapacityReservationTopology.html).

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

------

## Exemplo 7: DescribeCapacityReservationTopology para o filtro de tipo de instância
<a name="instance-topology-ex7"></a>

É 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 [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-capacity-reservation-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-capacity-reservation-topology.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2CapacityReservationTopology.html).

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

------