Amazon EC2 執行個體拓撲範例 - Amazon Elastic Compute Cloud
範例 1：DescribeInstanceTopology - 執行個體 ID範例 2：DescribeInstanceTopology - 置放群組名稱參數範例 3：DescribeInstanceTopology - 執行個體類型篩選條件範例 4：DescribeInstanceTopology - 區域 ID 篩選條件範例 5：DescribeInstanceTopology - 執行個體類型和區域 ID 篩選條件範例 6：DescribeCapacityReservationTopology - 容量保留 ID範例 7：DescribeCapacityReservationTopology - 執行個體類型篩選條件

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Amazon EC2 執行個體拓撲範例

可以使用 describe-instance-topology 命令來描述 EC2 執行個體的拓撲。也可以使用 describe-capacity-reservation-topology 命令來描述容量保留的拓撲。

使用沒有參數或篩選條件的 describe-instance-topology 或 describe-capacity-reservation-topology 命令時，回應會包含指定區域中符合此命令所支援執行個體類型的所有執行個體或容量保留 (取決於使用的命令)。您可以藉由包含 --region 參數或設定預設區域來指定區域。如需設定預設區域的詳細資訊，請參閱：為您的 Amazon EC2 資源選取區域。

您可以加入參數以傳回符合指定執行個體或容量保留 ID 或放置群組名稱的執行個體或容量保留。您也可以加入篩選條件，以傳回符合指定執行個體類型或執行個體系列的執行個體或容量保留，或是指定可用區域或本地區域中的執行個體或容量保留。您可以包含單一參數或篩選條件，或是參數和篩選條件的組合。

輸出會分頁，預設每頁最多 20 個執行個體或容量保留。您可以使用 --max-results 參數指定每頁最多 100 個執行個體或容量保留。

如需詳細資訊，請參閱describe-instance-topology及describe-reservation-topology-topology。

所需的許可

需要以下許可：

  • ec2:DescribeInstanceTopology – 用於描述執行個體拓撲

  • ec2:DescribeCapacityReservationTopology – 用於描述容量保留拓撲

範例 1：DescribeInstanceTopology - 執行個體 ID

AWS CLI
若要說明特定執行個體的拓撲

使用具有 --instance-ids 參數的 describe-instance-topology 命令。輸出僅包含符合指定執行個體 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 cmdlet。

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

範例 2：DescribeInstanceTopology - 置放群組名稱參數

AWS CLI
若要描述特定置放群組中執行個體的拓撲

使用具有 group-names 參數的 describe-instance-topology 命令。輸出僅包含位於任一指定置放群組中的執行個體。

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 cmdlet。

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

範例 3：DescribeInstanceTopology - 執行個體類型篩選條件

您可以依指定的執行個體類型進行篩選 (完全相符)，或依執行個體系列進行篩選 (使用萬用字元)。您也可以結合指定的執行個體類型篩選器和執行個體族群篩選。

範例 3a – 指定執行個體類型的完全相符篩選條件

AWS CLI
若要說明具有特定執行個體類型的執行個體拓撲

使用具有 instance-type 篩選條件的 describe-instance-topology 命令。輸出僅包含具有指定執行個體類型的執行個體。

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 cmdlet。

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

範例 3b – 執行個體系列的萬用字元篩選條件

AWS CLI
若要說明具有特定執行個體系列的執行個體拓撲

使用具有 instance-type 篩選條件的 describe-instance-topology 命令。輸出僅包含具有指定執行個體系列的執行個體。

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 cmdlet。

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

範例 3c – 合併執行個體系列和完全相符篩選條件

AWS CLI
若要說明具有執行個體系列或執行個體類型的執行個體拓撲

使用具有 instance-type 篩選條件的 describe-instance-topology 命令。輸出僅包含符合指定條件的執行個體。

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 cmdlet。

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

範例 4：DescribeInstanceTopology - 區域 ID 篩選條件

您可以使用 zone-id 篩選條件來依可用區域或本地區域進行篩選。您也可以結合可用區域篩選條件和本地區域篩選條件。

範例 4a – 可用區域篩選條件

AWS CLI
若要說明特定可用區域中的執行個體拓撲

使用具有 zone-id 篩選條件的 describe-instance-topology 命令。輸出僅包含指定可用區域中的執行個體。

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 cmdlet。

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

範例 4b – Local Zone 篩選條件

AWS CLI
若要說明特定本地區域中的執行個體拓撲

使用具有 zone-id 篩選條件的 describe-instance-topology 命令。輸出僅包含指定本地區域中的執行個體。

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 cmdlet。

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

範例 4c – 合併可用區域和本機區域篩選條件

AWS CLI
若要說明特定區域中的執行個體拓撲

使用具有 zone-id 篩選條件的 describe-instance-topology 命令。輸出僅包含位於任一指定區域中的執行個體。

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 cmdlet。

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

範例 5：DescribeInstanceTopology - 執行個體類型和區域 ID 篩選條件

可將篩選條件合併到單一命令中。

AWS CLI
若要說明具有特定執行個體類型、執行個體系列和區域的執行個體拓撲

使用具有 instance-type 和 zone-id 篩選條件的 describe-instance-topology 命令。回應包含具有任一指定執行個體類型且位於任一指定區域的任何執行個體。

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 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 參數的 describe-capacity-reservation-topology 命令。輸出僅包含符合指定容量保留 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 cmdlet。

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

範例 7：DescribeCapacityReservationTopology - 執行個體類型篩選條件

您可以依指定的執行個體類型進行篩選 (完全相符)，或依執行個體系列進行篩選 (使用萬用字元)。您也可以結合指定的執行個體類型篩選器和執行個體族群篩選。

AWS CLI
若要描述具有特定執行個體類型的容量保留拓撲

使用具有 instance-type 篩選條件的 describe-capacity-reservation-topology 命令。回應包含具有指定執行個體類型的任何執行個體。

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 cmdlet。

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