Amazon EC2 实例拓扑的示例
您可以使用 describe-instance-topology
当您使用不带参数或筛选条件的 describe-instance-topology
命令时,响应将包括与指定区域中该命令支持的实例类型相匹配的所有实例。您可以通过包含 --region
参数或通过设置默认区域来指定区域。有关设置默认区域的更多信息,请参阅 为您的 Amazon EC2 资源选择区域。
您可以包含参数以返回与指定实例 ID 或置放群组名称相匹配的实例。您还可以包含筛选条件以返回与指定实例类型或实例系列匹配的实例,或者返回指定可用区或本地区域中的实例。您可以包含单个参数或筛选条件,也可以包含参数和筛选条件的组合。
输出是分页的,默认情况下每页最多 20 个实例。您可以使用 --max-results
参数为每页指定最多 100 个实例。
有关更多信息,请参阅 describe-instance-topology
所需的权限
描述实例拓扑需要以下权限:
-
ec2:DescribeInstanceTopology
示例
示例 1 – 无参数或筛选条件
描述所有实例的实例拓扑
使用 describe-instance-topology
aws ec2 describe-instance-topology --region
us-west-2
响应仅返回与此 API 支持的实例类型相匹配的实例。这些实例可以位于不同的可用区、本地区域(ZoneId
)和置放群组(GroupName
)中。如果实例未在任何置放群组中,则 GroupName
字段不会显示在输出结果中。在以下示例输出中,置放群组中只有一个实例。
示例输出
{
"Instances": [
{
"InstanceId": "i-1111111111example",
"InstanceType": "p4d.24xlarge",
"GroupName": "my-ml-cpg",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3333333333example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
},
{
"InstanceId": "i-2222222222example",
"InstanceType": "p4d.24xlarge",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3333333333example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
},
{
"InstanceId": "i-3333333333example",
"InstanceType": "trn1.32xlarge",
"NetworkNodes": [
"nn-1212121212example",
"nn-1211122211example",
"nn-1311133311example"
],
"ZoneId": "usw2-az4",
"AvailabilityZone": "us-west-2d"
},
{
"InstanceId": "i-444444444example",
"InstanceType": "trn1.2xlarge",
"NetworkNodes": [
"nn-1111111111example",
"nn-5434334334example",
"nn-1235301234example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
}
],
"NextToken": "SomeEncryptedToken"
}
示例 2 – 实例类型筛选条件
您可以按指定的实例类型(精确匹配)进行筛选,也可以按实例系列进行筛选(使用通配符)。您也可以将指定的实例类型筛选条件和实例系列筛选条件组合使用。
示例 2a – 指定实例类型的精确匹配筛选条件
描述与指定实例类型匹配的所有实例的实例拓扑
将 describe-instance-topologyinstance-type
筛选条件一起使用。在此示例中,对 trn1n.32xlarge
实例的输出进行了筛选。响应将仅返回与指定实例类型匹配的实例。
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"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
}
],
"NextToken": "SomeEncryptedToken"
}
示例 2b – 实例系列的通配符筛选条件
描述与实例系列匹配的所有实例的实例拓扑
将 describe-instance-topologyinstance-type
筛选条件一起使用。在此示例中,对 trn1*
实例的输出进行了筛选。响应将仅返回与指定实例系列匹配的实例。
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"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
},
{
"InstanceId": "i-3333333333example",
"InstanceType": "trn1.32xlarge",
"NetworkNodes": [
"nn-1212121212example",
"nn-1211122211example",
"nn-1311133311example"
],
"ZoneId": "usw2-az4",
"AvailabilityZone": "us-west-2d"
},
{
"InstanceId": "i-444444444example",
"InstanceType": "trn1.2xlarge",
"NetworkNodes": [
"nn-1111111111example",
"nn-5434334334example",
"nn-1235301234example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
}
],
"NextToken": "SomeEncryptedToken"
}
示例 2c – 组合的实例系列和精确匹配筛选条件
描述与实例系列或指定实例类型匹配的所有实例的实例拓扑
将 describe-instance-topologyinstance-type
筛选条件一起使用。在此示例中,对 pd4d*
或 trn1n.32xlarge
实例的输出进行了筛选。响应将返回与任何指定筛选条件匹配的实例。
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"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
},
{
"InstanceId": "i-2222222222example",
"InstanceType": "trn1n.32xlarge",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-4343434343example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
}
],
"NextToken": "SomeEncryptedToken"
}
示例 3 – 区域 ID 筛选条件
您可以使用 zone-id
筛选条件按可用区或本地区域进行筛选。您也可以将可用区筛选条件和本地区域筛选条件组合使用。
示例 3a – 可用区筛选条件
描述与指定可用区匹配的所有实例的实例拓扑
将 describe-instance-topologyzone-id
筛选条件一起使用。在此示例中,使用可用区 ID use1-az1
对输出进行了筛选。响应将仅返回与指定可用区匹配的实例。
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"
],
"ZoneId": "use1-az1",
"AvailabilityZone": "us-east-1a"
}
],
"NextToken": "SomeEncryptedToken"
}
示例 3b – 本地区域筛选条件
描述与指定本地区域匹配的所有实例的实例拓扑
将 describe-instance-topologyzone-id
筛选条件一起使用。在此示例中,使用本地区 ID use1-atl2-az1
对输出进行了筛选。响应将仅返回与指定本地区域匹配的实例。
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"
],
"ZoneId": "use1-atl2-az1",
"AvailabilityZone": "us-east-1-atl-2a"
}
],
"NextToken": "SomeEncryptedToken"
}
示例 3c – 组合的可用区和本地区域筛选条件
描述与指定可用区或本地区域匹配的所有实例的实例拓扑
将 describe-instance-topologyzone-id
筛选条件一起使用。在此示例中,使用可用区 ID use1-az1
和本地区 ID use1-atl2-az1
对输出进行了筛选。响应将返回与任何指定筛选条件匹配的实例。
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"
],
"ZoneId": "use1-atl2-az1",
"AvailabilityZone": "us-east-1-atl-2a"
},
{
"InstanceId": "i-2222222222example",
"InstanceType": "trn1n.32xlarge",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3214313214example"
],
"ZoneId": "use1-az1",
"AvailabilityZone": "us-east-1a"
}
],
"NextToken": "SomeEncryptedToken"
}
示例 4 – 组合的实例类型和区域 ID 筛选条件
您可以将所有筛选条件组合在单个命令中。
描述与指定实例类型、实例系列、可用区或本地区域匹配的所有实例的实例拓扑
将 describe-instance-topologyinstance-type
和 zone-id
筛选条件一起使用。在此示例中,对 p4d*
实例系列、trn1n.32xlarge
实例类型、use1-az1
可用区 ID 和 use1-atl2-az1
本地区 ID 的输出进行了筛选。响应会返回与 us-east-1a
或 us-east-1-atl-2a
区域中的 p4d*
或 trn1n.32xlarge
实例匹配的实例。
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"
],
"ZoneId": "use1-atl2-az1",
"AvailabilityZone": "us-east-1-atl-2a"
},
{
"InstanceId": "i-2222222222example",
"InstanceType": "trn1n.32xlarge",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3214313214example"
],
"ZoneId": "use1-az1",
"AvailabilityZone": "us-east-1a"
}
],
"NextToken": "SomeEncryptedToken"
}
示例 5 – 置放群组名称参数
描述指定置放群组中所有实例的实例拓扑
将 describe-instance-topologygroup-names
参数一起使用。在以下示例中,实例可以位于 ML-group
或 HPC-group
置放群组中。输出内容会包含位于任一置放组中的实例。
aws ec2 describe-instance-topology \ --region
us-west-2
\ --group-namesML-group
HPC-group
示例输出
{
"Instances": [
{
"InstanceId": "i-1111111111example",
"InstanceType": "p4d.24xlarge",
"GroupName": "ML-group",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3333333333example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
},
{
"InstanceId": "i-2222222222example",
"InstanceType": "trn1n.32xlarge",
"GroupName": "HPC-group",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3214313214example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
}
],
"NextToken": "SomeEncryptedToken"
}
示例 6 – 实例 ID
描述指定实例的实例拓扑
将 describe-instance-topology--instance-ids
参数一起使用。响应会包含与指定实例 ID 匹配的实例。
aws ec2 describe-instance-topology \ --region
us-west-2
\ --instance-idsi-1111111111example
i-2222222222example
示例输出
{
"Instances": [
{
"InstanceId": "i-1111111111example",
"InstanceType": "p4d.24xlarge",
"GroupName": "ML-group",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3333333333example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
},
{
"InstanceId": "i-2222222222example",
"InstanceType": "trn1n.32xlarge",
"GroupName": "HPC-group",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3214313214example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
}
],
"NextToken": "SomeEncryptedToken"
}