本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Amazon 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) 命令來描述 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 或放置群組名稱的執行個體或容量保留。您也可以加入篩選條件，以傳回符合指定執行個體類型或執行個體系列的執行個體或容量保留，或是指定可用區域或本地區域中的執行個體或容量保留。您可以包含單一參數或篩選條件，或是參數和篩選條件的組合。
輸出會分頁，預設每頁最多 20 個執行個體或容量保留。您可以使用 `--max-results` 參數指定每頁最多 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 – Local Zone 篩選條件](#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
------
#### [ 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) cmdlet。
```
Get-EC2InstanceTopology `
-InstanceId i-1111111111example, i-2222222222example
```
------
## 範例 2：DescribeInstanceTopology - 置放群組名稱參數
------
#### [ 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) cmdlet。
```
Get-EC2InstanceTopology `
-GroupName ML-group, HPC-group
```
------
## 範例 3：DescribeInstanceTopology - 執行個體類型篩選條件
您可以依指定的執行個體類型進行篩選 (完全相符)，或依執行個體系列進行篩選 (使用萬用字元)。您也可以結合指定的執行個體類型篩選器和執行個體族群篩選。
### 範例 3a – 指定執行個體類型的完全相符篩選條件
------
#### [ 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) 命令。輸出僅包含具有指定執行個體類型的執行個體。
```
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) cmdlet。
```
Get-EC2InstanceTopology `
-Filter @{Name="instance-type"; Values="trn1n.32xlarge"}
```
------
### 範例 3b – 執行個體系列的萬用字元篩選條件
------
#### [ 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) 命令。輸出僅包含具有指定執行個體系列的執行個體。
```
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) cmdlet。
```
Get-EC2InstanceTopology `
-Filter @{Name="instance-type"; Values="trn1*"}
```
------
### 範例 3c – 合併執行個體系列和完全相符篩選條件
------
#### [ 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) 命令。輸出僅包含符合指定條件的執行個體。
```
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) cmdlet。
```
Get-EC2InstanceTopology `
-Filter @{Name="instance-type"; Values="p4d*", "trn1n.32xlarge"}
```
------
## 範例 4：DescribeInstanceTopology - 區域 ID 篩選條件
您可以使用 `zone-id` 篩選條件來依可用區域或本地區域進行篩選。您也可以結合可用區域篩選條件和本地區域篩選條件。
### 範例 4a – 可用區域篩選條件
------
#### [ 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) 命令。輸出僅包含指定可用區域中的執行個體。
```
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) cmdlet。
```
Get-EC2InstanceTopology `
-Filter @{Name="zone-id"; Values="use1-az1"}
```
------
### 範例 4b – Local Zone 篩選條件
------
#### [ 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) 命令。輸出僅包含指定本地區域中的執行個體。
```
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) cmdlet。
```
Get-EC2InstanceTopology `
-Filter @{Name="zone-id"; Values="use1-atl2-az1"}
```
------
### 範例 4c – 合併可用區域和本機區域篩選條件
------
#### [ 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) 命令。輸出僅包含位於任一指定區域中的執行個體。
```
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) cmdlet。
```
Get-EC2InstanceTopology `
-Filter @{Name="zone-id"; Values="use1-az1", "use1-atl2-az1"}
```
------
## 範例 5：DescribeInstanceTopology - 執行個體類型和區域 ID 篩選條件
可將篩選條件合併到單一命令中。
------
#### [ 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) 命令。回應包含具有任一指定執行個體類型且位於任一指定區域的任何執行個體。
```
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) cmdlet。
```
Get-EC2InstanceTopology `
-Filter @{Name="instance-type"; Values="p4d*", "trn1n.32xlarge"} `
@{Name="zone-id"; Values="use1-az1", "use1-atl2-az1"}
```
------
## 範例 6：DescribeCapacityReservationTopology - 容量保留 ID
------
#### [ 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) cmdlet。
```
Get-EC2CapacityReservationTopology `
-CapacityReservationId cr-1111111111example cr-2222222222example
```
------
## 範例 7：DescribeCapacityReservationTopology - 執行個體類型篩選條件
您可以依指定的執行個體類型進行篩選 (完全相符)，或依執行個體系列進行篩選 (使用萬用字元)。您也可以結合指定的執行個體類型篩選器和執行個體族群篩選。
------
#### [ 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) 命令。回應包含具有指定執行個體類型的任何執行個體。
```
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) cmdlet。
```
Get-EC2CapacityReservationTopology `
-Filter @{Name="instance-type"; Values="p5en.48xlarge"}
```
------