

# Amazon EC2 インスタンストポロジーの例
<a name="ec2-instance-topology-examples"></a>

[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) コマンドを使用して、EC2 インスタンスのトポロジーを記述できます。また、[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) コマンドを使用して、キャパシティ予約のトポロジーを記述できます。

パラメータやフィルターなしで `describe-instance-topology` コマンドまたは `describe-capacity-reservation-topology` コマンドを使用すると、指定したリージョン内のこのコマンドで利用可能なインスタンスタイプに一致する、すべてのインスタンスまたはキャパシティ予約 (使用するコマンドによる) が応答に含まれます。リージョンを設定するには`--region` パラメータを含めるかデフォルトのリージョンを設定できます。デフォルトのリージョンの設定についての詳細は「[Amazon EC2 リソースのリージョンを選択する](using-regions-availability-zones-setup.md)」を参照してください。

指定したインスタンス ID もしくはキャパシティ予約 ID、またはプレイスメントグループ名と一致するインスタンスまたはキャパシティ予約を返すパラメータを含めることができます。また、指定したインスタンスタイプやインスタンスファミリーに一致するインスタンスまたはキャパシティ予約、あるいは、指定したアベイラビリティーゾーンやローカルゾーン内のインスタンスまたはキャパシティ予約を返すフィルターを含めることもできます。1 つのパラメータまたはフィルター、もしくはパラメータとフィルターの組み合わせを含めることができます。

出力はページ分割されます。デフォルトでは、1 ページあたり最大 20のインスタンスまたはキャパシティ予約となっています。`--max-results` パラメータを使用すると、1 ページあたり最大 100 のインスタンスまたはキャパシティ予約を指定できます。

詳細については、「[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)」および「[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)」を参照してください。

**必要なアクセス許可**

以下のアクセス権限が必要です。
+ `ec2:DescribeInstanceTopology` – インスタンストポロジーの記述用
+  `ec2:DescribeCapacityReservationTopology` – キャパシティ予約トポロジーの記述用

**Contents**
+ [例 1: DescribeInstanceTopology - インスタンス ID](#instance-topology-ex1)
+ [例 2: DescribeInstanceTopology - プレイスメントグループ名パラメータ](#instance-topology-ex2)
+ [例 3: DescribeInstanceTopology - インスタンスタイプフィルター](#instance-topology-ex3)
  + [例 3a — 指定したインスタンスタイプの完全一致フィルター](#instance-topology-ex3a)
  + [例 3b — インスタンスファミリーのワイルドカードフィルター](#instance-topology-ex3b)
  + [例 3c — インスタンスファミリーと完全一致フィルターの組み合わせ](#instance-topology-ex3c)
+ [例 4: DescribeInstanceTopology - ゾーン ID フィルター](#instance-topology-ex4)
  + [例 4a — アベイラビリティーゾーンフィルター](#instance-topology-ex4a)
  + [例 4b — ローカルゾーンフィルター](#instance-topology-ex4b)
  + [例 4c — アベイラビリティーゾーンフィルターとローカルゾーンフィルターの組み合わせ](#instance-topology-ex4c)
+ [例 5: DescribeInstanceTopology - インスタンスタイプとゾーン ID フィルター](#instance-topology-ex5)
+ [例 6: DescribeCapacityReservationTopology - キャパシティ予約 ID](#instance-topology-ex6)
+ [例 7: DescribeCapacityReservationTopology - インスタンスタイプフィルター](#instance-topology-ex7)

## 例 1: DescribeInstanceTopology - インスタンス ID
<a name="instance-topology-ex1"></a>

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

**特定のインスタンスのトポロジーを記述するには**  
`--instance-ids` パラメータを指定して、[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) コマンドを使用します。出力には、指定したインスタンス ID と一致するインスタンスのみが含まれます。

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

以下は出力の例です。

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

**特定のインスタンスのトポロジーを記述するには**  
[Get-EC2InstanceTopology](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html) コマンドレットを使用します。

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

------

## 例 2: DescribeInstanceTopology - プレイスメントグループ名パラメータ
<a name="instance-topology-ex2"></a>

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

**特定のプレイスメントグループ内にあるインスタンスのトポロジーを記述するには**  
`group-names` パラメータを指定して、[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) コマンドを使用します。出力には、いずれかの指定したプレイスメントグループにあるインスタンスのみが含まれます。

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

以下は出力の例です。

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

**特定のプレイスメントグループ内にあるインスタンスのトポロジーを記述するには**  
[Get-EC2InstanceTopology](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html) コマンドレットを使用します。

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

------

## 例 3: DescribeInstanceTopology - インスタンスタイプフィルター
<a name="instance-topology-ex3"></a>

指定したインスタンスタイプ (完全一致)、またはインスタンスファミリーでフィルタリング (ワイルドカードを使用) できます。指定したインスタンスタイプフィルターとインスタンスファミリーのフィルターを組み合わせることもできます。

### 例 3a — 指定したインスタンスタイプの完全一致フィルター
<a name="instance-topology-ex3a"></a>

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

**特定のインスタンスタイプを使用するインスタンスのトポロジーを記述するには**  
`instance-type` フィルターとともに [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) CLI コマンドを使用します。出力には、指定したインスタンスタイプを使用するインスタンスのみが含まれます。

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

以下は出力の例です。

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

**特定のインスタンスタイプを使用するインスタンスのトポロジーを記述するには**  
[Get-EC2InstanceTopology](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html) コマンドレットを使用します。

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

------

### 例 3b — インスタンスファミリーのワイルドカードフィルター
<a name="instance-topology-ex3b"></a>

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

**特定のインスタンスファミリーを使用するインスタンスのトポロジーを記述するには**  
`instance-type` フィルターとともに [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) CLI コマンドを使用します。出力には、指定したインスタンスファミリーを使用するインスタンスのみが含まれます。

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

以下は出力の例です。

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

**特定のインスタンスファミリーを使用するインスタンスのトポロジーを記述するには**  
[Get-EC2InstanceTopology](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html) コマンドレットを使用します。

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

------

### 例 3c — インスタンスファミリーと完全一致フィルターの組み合わせ
<a name="instance-topology-ex3c"></a>

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

**インスタンスファミリーまたはインスタンスタイプを使用するインスタンスのトポロジを記述するには**  
`instance-type` フィルターとともに [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) CLI コマンドを使用します。出力には、指定した条件を満たすインスタンスのみが含まれます。

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

以下は出力の例です。

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

**インスタンスファミリーまたはインスタンスタイプを使用するインスタンスのトポロジを記述するには**  
[Get-EC2InstanceTopology](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html) コマンドレットを使用します。

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

------

## 例 4: DescribeInstanceTopology - ゾーン ID フィルター
<a name="instance-topology-ex4"></a>

`zone-id` フィルターを使用して、アベイラビリティーゾーンまたはローカルゾーンでフィルタリングできます。アベイラビリティーゾーンフィルターとローカルゾーンフィルターを組み合わせることもできます。

### 例 4a — アベイラビリティーゾーンフィルター
<a name="instance-topology-ex4a"></a>

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

**特定のアベイラビリティーゾーンでインスタンスのトポロジーを記述するには**  
`zone-id` フィルターとともに [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) CLI コマンドを使用します。出力には、指定したアベイラビリティーゾーンのインスタンスのみが含まれます。

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

以下は出力の例です。

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

**特定のアベイラビリティーゾーンでインスタンスのトポロジーを記述するには**  
[Get-EC2InstanceTopology](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html) コマンドレットを使用します。

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

------

### 例 4b — ローカルゾーンフィルター
<a name="instance-topology-ex4b"></a>

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

**特定のローカルゾーンでインスタンスのトポロジーを記述するには**  
`zone-id` フィルターとともに [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) CLI コマンドを使用します。出力には、指定したローカルゾーンのインスタンスのみが含まれます。

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

以下は出力の例です。

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

**特定のローカルゾーンでインスタンスのトポロジーを記述するには**  
[Get-EC2InstanceTopology](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html) コマンドレットを使用します。

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

------

### 例 4c — アベイラビリティーゾーンフィルターとローカルゾーンフィルターの組み合わせ
<a name="instance-topology-ex4c"></a>

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

**特定のゾーンにあるインスタンスのトポロジーを記述するには**  
`zone-id` フィルターとともに [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) CLI コマンドを使用します。出力には、指定したゾーンのいずれかにあるインスタンスのみが含まれます。

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

以下は出力の例です。

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

**特定のゾーンにあるインスタンスのトポロジーを記述するには**  
[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"}
```

------

## 例 5: DescribeInstanceTopology - インスタンスタイプとゾーン ID フィルター
<a name="instance-topology-ex5"></a>

1 つのコマンドで複数のフィルターを組み合わせることができます。

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

**特定のインスタンスタイプ、インスタンスファミリー、ゾーンを使用するインスタンスのトポロジーを記述するには**  
`instance-type` および `zone-id` フィルターとともに [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) CLI コマンドを使用します。レスポンスには、指定したインスタンスタイプのいずれかを使用し、指定したゾーンのいずれかにあるインスタンスが含まれます。

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

以下は出力の例です。

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

**特定のインスタンスタイプ、インスタンスファミリー、ゾーンを使用するインスタンスのトポロジーを記述するには**  
[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"}
```

------

## 例 6: DescribeCapacityReservationTopology - キャパシティ予約 ID
<a name="instance-topology-ex6"></a>

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

**特定のキャパシティ予約のトポロジーを記述するには**  
`capacity-reservation-id` パラメータを指定して、[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) コマンドを使用します。出力には、指定したキャパシティ予約 ID に一致するキャパシティ予約のみが含まれます。

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

以下は出力の例です。

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

**特定のキャパシティ予約のトポロジーを記述するには**  
[Get-EC2CapacityReservationTopology](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2CapacityReservationTopology.html) コマンドレットを使用します。

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

------

## 例 7: DescribeCapacityReservationTopology - インスタンスタイプフィルター
<a name="instance-topology-ex7"></a>

指定したインスタンスタイプ (完全一致)、またはインスタンスファミリーでフィルタリング (ワイルドカードを使用) できます。指定したインスタンスタイプフィルターとインスタンスファミリーのフィルターを組み合わせることもできます。

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

**特定のインスタンスタイプのキャパシティ予約のトポロジーを記述するには**  
`instance-type` フィルターとともに [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) CLI コマンドを使用します。レスポンスには、指定したインスタンスタイプのインスタンスがすべて含まれます。

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

以下は出力の例です。

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

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

**特定のインスタンスタイプのキャパシティ予約のトポロジーを記述するには**  
[Get-EC2CapacityReservationTopology](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2CapacityReservationTopology.html) コマンドレットを使用します。

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

------