

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Exemples de topologie d'instances Amazon EC2
<a name="ec2-instance-topology-examples"></a>

Vous pouvez utiliser la commande [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) pour décrire la topologie de vos instances EC2. Et vous pouvez utiliser la commande [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) pour décrire la topologie de vos réserves de capacité.

Lorsque vous utilisez la commande `describe-instance-topology` ou `describe-capacity-reservation-topology` sans paramètres ni filtres, la réponse inclut toutes vos instances ou Réservations de capacité (selon la commande utilisée) qui correspondent aux types d’instance pris en charge pour cette commande dans la région spécifiée. Vous pouvez spécifier la région en incluant le paramètre `--region` ou en définissant une région par défaut. Pour plus d’informations sur la définition d’une région par défaut, consultez [Sélectionnez une région pour vos ressources Amazon EC2](using-regions-availability-zones-setup.md).

Vous pouvez inclure des paramètres pour renvoyer des instances ou des réservations de capacité correspondant à des noms d'instance, de réservation de capacité IDs ou de groupe de placement spécifiés. Vous pouvez également inclure des filtres pour renvoyer les instances ou les réserves de capacité qui correspondent à un type d’instance ou à une famille d’instances spécifiés, ou les instances ou les réserves de capacité dans une zone de disponibilité ou une zone locale spécifiée. Vous pouvez inclure un seul paramètre ou filtre, ou une combinaison de paramètres et de filtres.

Par défaut, la sortie est paginée, avec jusqu’à 20 instances ou réserve de capacité par page. Vous pouvez spécifier jusqu’à 100 instances ou réserve de capacité par page en utilisant paramètre `--max-results`.

Pour plus d’informations, consultez [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) et [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).

**Autorisations requises**

Les autorisations suivantes sont requises :
+ `ec2:DescribeInstanceTopology` : pour la description de la topologie de l’instance
+  `ec2:DescribeCapacityReservationTopology` : pour la description de la topologie de réserve de capacité

**Contents**
+ [Exemple 1 : DescribeInstanceTopology - Instance IDs](#instance-topology-ex1)
+ [Exemple 2 : DescribeInstanceTopology - Paramètre de nom du groupe de placement](#instance-topology-ex2)
+ [Exemple 3 : DescribeInstanceTopology - Filtre de type d'instance](#instance-topology-ex3)
  + [Exemple 3a — Filtre de correspondance exacte pour un type d'instance spécifié](#instance-topology-ex3a)
  + [Exemple 3b — Filtre générique pour une famille d'instances](#instance-topology-ex3b)
  + [Exemple 3c — Famille d'instances combinée et filtres de correspondance exacte](#instance-topology-ex3c)
+ [Exemple 4 : DescribeInstanceTopology - Filtre d'identification de zone](#instance-topology-ex4)
  + [Exemple 4a — Filtre de zone de disponibilité](#instance-topology-ex4a)
  + [Exemple 4b — Filtre de zone locale](#instance-topology-ex4b)
  + [Exemple 4c — Filtres combinés de zone de disponibilité et de zone locale](#instance-topology-ex4c)
+ [Exemple 5 : DescribeInstanceTopology - Filtres de type d'instance et d'ID de zone](#instance-topology-ex5)
+ [Exemple 6 : DescribeCapacityReservationTopology - Réservation de capacité IDs](#instance-topology-ex6)
+ [Exemple 7 : DescribeCapacityReservationTopology - Filtre de type d'instance](#instance-topology-ex7)

## Exemple 1 : DescribeInstanceTopology - Instance IDs
<a name="instance-topology-ex1"></a>

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

**Pour décrire la topologie d’instances spécifiées**  
Utilisez la commande [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) avec le paramètre `--instance-ids`. La sortie inclut uniquement les instances qui correspondent à l'instance spécifiée IDs.

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

Voici un exemple de sortie.

```
{
    "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 ]

**Pour décrire la topologie d’instances spécifiées**  
Utilisez l’applet de commande [Get-EC2InstanceTopology](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).

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

------

## Exemple 2 : DescribeInstanceTopology - Paramètre de nom du groupe de placement
<a name="instance-topology-ex2"></a>

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

**Pour décrire la topologie des instances dans un groupe de placement spécifique**  
Utilisez la commande [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) avec le paramètre `group-names`. La sortie n’inclut que les instances qui se trouvent dans l’un des groupes de placement spécifiés.

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

Voici un exemple de sortie.

```
{
    "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 ]

**Pour décrire la topologie des instances dans un groupe de placement spécifique**  
Utilisez l’applet de commande [Get-EC2InstanceTopology](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).

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

------

## Exemple 3 : DescribeInstanceTopology - Filtre de type d'instance
<a name="instance-topology-ex3"></a>

Vous pouvez filtrer en fonction d’un type d’instance spécifié (correspondance exacte) ou en fonction d’une famille d’instances (à l’aide d’un caractère générique). Vous pouvez également combiner un filtre de type d’instance et un filtre de famille d’instances spécifiés.

### Exemple 3a — Filtre de correspondance exacte pour un type d'instance spécifié
<a name="instance-topology-ex3a"></a>

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

**Pour décrire la topologie des instances avec un type d’instance spécifique**  
Utilisez la commande [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) avec le filtre `instance-type`. La sortie n’inclut que les instances correspondant au type d’instance spécifié.

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

Voici un exemple de sortie.

```
{
    "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 ]

**Pour décrire la topologie des instances avec un type d’instance spécifique**  
Utilisez l’applet de commande [Get-EC2InstanceTopology](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).

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

------

### Exemple 3b — Filtre générique pour une famille d'instances
<a name="instance-topology-ex3b"></a>

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

**Pour décrire la topologie des instances appartenant à une famille d’instances spécifique**  
Utilisez la commande [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) avec le filtre `instance-type`. La sortie n’inclut que les instances correspondant à la famille d’instances spécifiée.

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

Voici un exemple de sortie.

```
{
    "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 ]

**Pour décrire la topologie des instances appartenant à une famille d’instances spécifique**  
Utilisez l’applet de commande [Get-EC2InstanceTopology](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).

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

------

### Exemple 3c — Famille d'instances combinée et filtres de correspondance exacte
<a name="instance-topology-ex3c"></a>

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

**Pour décrire la topologie des instances avec une famille d’instances ou un type d’instance**  
Utilisez la commande [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) avec le filtre `instance-type`. La sortie n’inclut que les instances répondant aux critères spécifiés.

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

Voici un exemple de sortie.

```
{
    "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 ]

**Pour décrire la topologie des instances avec une famille d’instances ou un type d’instance**  
Utilisez l’applet de commande [Get-EC2InstanceTopology](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).

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

------

## Exemple 4 : DescribeInstanceTopology - Filtre d'identification de zone
<a name="instance-topology-ex4"></a>

Vous pouvez utiliser le filtre `zone-id` pour filtrer par zone de disponibilité ou zone locale. Vous pouvez également combiner le filtre de zone de disponibilité et le filtre de zone locale.

### Exemple 4a — Filtre de zone de disponibilité
<a name="instance-topology-ex4a"></a>

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

**Pour décrire la topologie des instances dans une zone de disponibilité spécifique**  
Utilisez la commande [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) avec le filtre `zone-id`. La sortie n’inclut que les instances de la zone de disponibilité spécifiée.

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

Voici un exemple de sortie.

```
{
    "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 ]

**Pour décrire la topologie des instances dans une zone de disponibilité spécifique**  
Utilisez l’applet de commande [Get-EC2InstanceTopology](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).

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

------

### Exemple 4b — Filtre de zone locale
<a name="instance-topology-ex4b"></a>

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

**Pour décrire la topologie des instances dans une zone locale spécifique**  
Utilisez la commande [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) avec le filtre `zone-id`. La sortie n’inclut que les instances de la zone locale spécifiée.

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

Voici un exemple de sortie.

```
{
    "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 ]

**Pour décrire la topologie des instances dans une zone locale spécifique**  
Utilisez l’applet de commande [Get-EC2InstanceTopology](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).

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

------

### Exemple 4c — Filtres combinés de zone de disponibilité et de zone locale
<a name="instance-topology-ex4c"></a>

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

**Pour décrire la topologie des instances dans une zone spécifique**  
Utilisez la commande [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) avec le filtre `zone-id`. La sortie n’inclut que les instances qui se trouvent dans l’une des zones spécifiées.

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

Voici un exemple de sortie.

```
{
    "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 ]

**Pour décrire la topologie des instances dans une zone spécifique**  
Utilisez l’applet de commande [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"}
```

------

## Exemple 5 : DescribeInstanceTopology - Filtres de type d'instance et d'ID de zone
<a name="instance-topology-ex5"></a>

Vous pouvez combiner les filtres au sein d’une même commande.

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

**Pour décrire la topologie des instances avec des types d’instances, des familles d’instances et des zones spécifiques**  
Utilisez la commande [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) avec les filtres `instance-type` et `zone-id`. La réponse contient toutes les instances correspondant à l’un des types d’instance spécifiés et situées dans l’une des zones spécifiées.

```
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"
```

Voici un exemple de sortie.

```
{
    "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 ]

**Pour décrire la topologie des instances avec des types d’instances, des familles d’instances et des zones spécifiques**  
Utilisez l’applet de commande [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"}
```

------

## Exemple 6 : DescribeCapacityReservationTopology - Réservation de capacité IDs
<a name="instance-topology-ex6"></a>

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

**Pour décrire la topologie de réserves de capacité spécifiques**  
Utilisez la commande [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) avec le paramètre `capacity-reservation-id`. La sortie inclut uniquement les réservations de capacité correspondant à la réservation de capacité spécifiée IDs.

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

Voici un exemple de sortie.

```
{
    "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 ]

**Pour décrire la topologie de réserves de capacité spécifiques**  
Utilisez l’applet de commande [Get-EC2CapacityReservationTopology](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2CapacityReservationTopology.html).

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

------

## Exemple 7 : DescribeCapacityReservationTopology - Filtre de type d'instance
<a name="instance-topology-ex7"></a>

Vous pouvez filtrer en fonction d’un type d’instance spécifié (correspondance exacte) ou en fonction d’une famille d’instances (à l’aide d’un caractère générique). Vous pouvez également combiner un filtre de type d’instance et un filtre de famille d’instances spécifiés.

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

**Pour décrire la topologie des réserves de capacité avec un type d’instance spécifique**  
Utilisez la commande [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) avec le filtre `instance-type`. La réponse contient toutes les instances correspondant au type d’instance spécifié.

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

Voici un exemple de sortie.

```
{
    "CapacityReservations": [
        {
            "CapacityReservationId": "cr-2222222222example",
            "CapacityBlockId": "null",
            "State": "active",
            "InstanceType": "p5en.48xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example"
            ],
            "AvailabilityZone": "us-east-1a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
```

------
#### [ PowerShell ]

**Pour décrire la topologie des réserves de capacité avec un type d’instance spécifique**  
Utilisez l’applet de commande [Get-EC2CapacityReservationTopology](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2CapacityReservationTopology.html).

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

------