Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Contoh topologi instans Amazon EC2
Anda dapat menggunakan perintah describe-instance-topologyCLI untuk mendeskripsikan topologi instance untuk instans EC2 Anda.
Saat Anda menggunakan perintah describe-instance-topology
tanpa parameter atau filter, respons akan menyertakan semua instans yang cocok dengan tipe instans yang didukung untuk perintah ini di Wilayah yang ditentukan. Anda dapat menentukan Wilayah dengan menyertakan parameter --region
, atau dengan menetapkan Wilayah default. Untuk informasi selengkapnya tentang mengatur Wilayah default, lihat Menentukan Wilayah untuk sumber daya.
Anda dapat menyertakan parameter untuk mengembalikan instans yang cocok dengan ID instans tertentu atau nama grup penempatan. Anda juga dapat menyertakan filter untuk menampilkan instans yang cocok dengan tipe instans atau keluarga instans tertentu, atau instans di Zona Ketersediaan atau Local Zones tertentu. Anda dapat menyertakan satu parameter atau filter, atau kombinasi parameter dan filter.
Outputnya diberi paginasi, dengan hingga 20 instans per halaman secara default. Anda dapat menentukan hingga 100 instans per halaman menggunakan --max-results
parameter.
Untuk informasi selengkapnya, lihat describe-instance-topology di Referensi Perintah AWS CLI .
Izin yang diperlukan
Izin berikut diperlukan untuk menjelaskan topologi instance:
-
ec2:DescribeInstanceTopology
Contoh
Contoh 1 - Tidak ada parameter atau filter
Untuk menggambarkan topologi instans dari semua instans Anda
Gunakan perintah CLI describe-instance-topology tanpa menentukan parameter atau filter apa pun.
aws ec2 describe-instance-topology --region
us-west-2
Respons hanya menampilkan instans yang cocok dengan tipe instans yang didukung untuk API ini. Instans dapat berada di Zona Ketersediaan, Local Zones (ZoneId
), dan grup penempatan (GroupName
) yang berbeda. Jika instans tidak ada dalam grup penempatan, GroupName
kolom tersebut tidak muncul di output. Dalam contoh output berikut, hanya satu instans yang berada dalam grup penempatan.
Contoh output
{
"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"
}
Contoh 2 - filter tipe instans
Anda dapat memfilter berdasarkan tipe instans tertentu (sama persis) atau memfilter menurut keluarga instans (menggunakan wildcard). Anda juga dapat menggabungkan filter tipe instans tertentu dan filter keluarga instans.
Contoh 2a - Filter pencocokan tepat untuk tipe instans tertentu
Untuk mendeskripsikan topologi instans dari semua instans Anda yang cocok dengan tipe instans tertentu
Gunakan perintah CLI describe-instance-topology dengan filter instance-type
. Dalam contoh ini, output disaring untuk instans trn1n.32xlarge
. Respons hanya akan mengembalikan instans yang cocok dengan tipe instans yang ditentukan.
aws ec2 describe-instance-topology \ --region
us-west-2
\ --filters Name=instance-type,Values=trn1n.32xlarge
Contoh output
{
"Instances": [
{
"InstanceId": "i-2222222222example",
"InstanceType": "trn1n.32xlarge",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3333333333example"
],
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
}
],
"NextToken": "SomeEncryptedToken"
}
Contoh 2b - Filter wild card untuk keluarga instans
Untuk menggambarkan topologi instans dari semua instans Anda yang cocok dengan keluarga instans
Gunakan perintah CLI describe-instance-topology dengan filter instance-type
. Dalam contoh ini, output disaring untuk instans trn1*
. Respons hanya akan mengembalikan instans yang cocok dengan keluarga instans yang ditentukan.
aws ec2 describe-instance-topology \ --region
us-west-2
\ --filters Name=instance-type,Values=trn1*
Contoh output
{
"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"
}
Contoh 2c – Gabungan filter keluarga instans dan pencocokan tepat
Untuk mendeskripsikan topologi instans dari semua instans Anda yang cocok dengan keluarga instans atau tipe instans tertentu
Gunakan perintah CLI describe-instance-topology dengan filter instance-type
. Dalam contoh ini, output disaring untuk instans pd4d*
atau trn1n.32xlarge
. Respons akan mengembalikan instans yang cocok dengan salah satu filter yang ditentukan.
aws ec2 describe-instance-topology \ --region
us-west-2
\ --filters "Name=instance-type,Values=p4d*
,trn1n.32xlarge
"
Contoh output
{
"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"
}
Contoh 3 - filter zona-id
Anda dapat menggunakan filter zone-id
untuk memfilter berdasarkan Zona Ketersediaan atau Local Zones. Anda juga dapat menggabungkan filter Zona Ketersediaan dan filter Local Zones.
Contoh 3a - Filter Zona Ketersediaan
Untuk menjelaskan topologi instans dari semua instans yang cocok dengan Zona Ketersediaan yang ditentukan
Gunakan perintah CLI describe-instance-topology dengan filter zone-id
. Dalam contoh ini, output disaring menggunakan ID Availability Zoneuse1-az1
. Respons hanya akan menampilkan instans yang cocok dengan Zona Ketersediaan yang ditentukan.
aws ec2 describe-instance-topology \ --region
us-east-1
\ --filters Name=zone-id,Values=use1-az1
Contoh output
{
"Instances": [
{
"InstanceId": "i-2222222222example",
"InstanceType": "trn1n.32xlarge",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example",
"nn-3214313214example"
],
"ZoneId": "use1-az1",
"AvailabilityZone": "us-east-1a"
}
],
"NextToken": "SomeEncryptedToken"
}
Contoh 3b - Filter Local Zones
Untuk menjelaskan topologi instans dari semua instans Anda yang cocok dengan Local Zones yang ditentukan
Gunakan perintah CLI describe-instance-topology dengan filter zone-id
. Dalam contoh ini, output disaring menggunakan ID Zona Lokaluse1-atl2-az1
. Respons hanya akan mengembalikan instans yang cocok dengan Local Zones yang ditentukan.
aws ec2 describe-instance-topology \ --region
us-east-1
\ --filters Name=zone-id,Values=use1-atl2-az1
Contoh output
{
"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"
}
Contoh 3c – Gabungan filter Zona Ketersediaan dan Local Zones
Untuk mendeskripsikan topologi instans dari semua instans yang cocok dengan Zona Ketersediaan atau Local Zones tertentu
Gunakan perintah CLI describe-instance-topology dengan filter zone-id
. Dalam contoh ini, output disaring menggunakan ID Availability Zone use1-az1
dan Local Zone IDuse1-atl2-az1
. Respons akan mengembalikan instans yang cocok dengan salah satu filter yang ditentukan.
aws ec2 describe-instance-topology \ --region
us-east-1
\ --filters Name=zone-id,Values=use1-az1
,use1-atl2-az1
Contoh output
{
"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"
}
Contoh 4 – Gabungan filter tipe instans dan id zona
Anda dapat menggabungkan semua filter dalam satu perintah.
Untuk menjelaskan topologi instans dari semua instans yang cocok dengan tipe instans tertentu, keluarga instans, Zona Ketersediaan, atau Local Zones
Gunakan perintah CLI describe-instance-topology dengan filter instance-type
dan zone-id
. Dalam contoh ini, output difilter untuk keluarga p4d*
instance, tipe trn1n.32xlarge
instance, ID Zona use1-az1
Ketersediaan, dan ID Zona use1-atl2-az1
Lokal. Respons akan mengembalikan instans yang cocok p4d*
atau instans trn1n.32xlarge
di zona us-east-1a
atau us-east-1-atl-2a
.
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
"
Contoh output
{
"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"
}
Contoh 5 - Parameter nama grup penempatan
Untuk menggambarkan topologi instans dari semua instans Anda dalam grup penempatan tertentu
Gunakan perintah CLI describe-instance-topology dengan parameter group-names
. Dalam contoh berikut, instans dapat berada di grup penempatan ML-group
atau HPC-group
. Respons akan mengembalikan instans yang ada di salah satu grup penempatan.
aws ec2 describe-instance-topology \ --region
us-west-2
\ --group-namesML-group
HPC-group
Contoh output
{
"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"
}
Contoh 6 - ID Instans
Untuk menggambarkan topologi instans dari instans tertentu
Gunakan perintah CLI describe-instance-topology dengan parameter --instance-ids
. Respons akan mengembalikan instans yang cocok dengan ID instans yang ditentukan.
aws ec2 describe-instance-topology \ --region
us-west-2
\ --instance-idsi-1111111111example
i-2222222222example
Contoh output
{
"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"
}