Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Beispiele für die EC2 Amazon-Instance-Topologie
Sie können den describe-instance-topologyBefehl verwenden, um die Topologie für Ihre EC2 Instances zu beschreiben. Sie können auch den Befehl describe-capacity-reservation-topology verwenden, um die Topologie Ihrer Kapazitätsreservierungen zu beschreiben.
Wenn Sie den Befehl describe-instance-topology oder describe-capacity-reservation-topology ohne Parameter oder Filter verwenden, umfasst die Antwort alle Ihre Instances oder Kapazitätsreservierungen (je nachdem, welchen Befehl Sie verwendet haben), die den unterstützten Instance-Typen für diesen Befehl in der angegebenen Region entsprechen. Sie können die Region angeben, indem Sie den --region-Parameter einschließen oder eine Standardregion festlegen. Weitere Informationen zum Festlegen einer Standardregion finden Sie unter Wählen Sie eine Region für Ihre EC2 Amazon-Ressourcen.
Sie können Parameter angeben, um Instances oder Kapazitätsreservierungen zurückzugeben, die den angegebenen Instance- oder Kapazitätsreservierungs IDs - oder Platzierungsgruppennamen entsprechen. Sie können auch Filter einschließen, um Instances oder Kapazitätsreservierungen zurückzugeben, die einem angegebenen Instance-Typ oder einer angegebenen Instance-Familie entsprechen, oder Instances in einer angegebenen Availability Zone oder Local Zone. Sie können einen einzelnen Parameter oder Filter oder eine Kombination aus Parametern und Filtern einschließen.
Die Ausgabe ist paginiert und umfasst standardmäßig bis zu 20 Instances oder Kapazitätsreservierungen pro Seite. Mit dem Parameter --max-results können Sie bis zu 100 Instances oder Kapazitätsreservierungen pro Seite angeben.
Weitere Informationen erhalten Sie unter describe-instance-topology und describe-reservation-topology-topology.
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind erforderlich:
Beispiel 1: DescribeInstanceTopology — Instanz IDs
- AWS CLI
-
So beschreiben Sie die Topologie angegebener Instances
Verwenden Sie den Befehl describe-instance-topology mit dem Parameter --instance-ids. Die Ausgabe umfasst nur die Instanzen, die der angegebenen Instanz entsprechen IDs.
aws ec2 describe-instance-topology \
--region us-west-2 \
--instance-ids i-1111111111example i-2222222222example
Es folgt eine Beispielausgabe.
{
"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
-
So beschreiben Sie die Topologie angegebener Instances
Verwenden Sie das cmdlet Get-EC2InstanceTopology.
Get-EC2InstanceTopology `
-InstanceId i-1111111111example, i-2222222222example
Beispiel 2: DescribeInstanceTopology - Parameter für den Namen der Platzierungsgruppe
- AWS CLI
-
So beschreiben Sie die Topologie von Instances in einer bestimmten Placement-Gruppe
Verwenden Sie den Befehl describe-instance-topology mit dem Parameter group-names. Die Ausgabe enthält nur die Instances, die sich in einer der angegebenen Placement-Gruppen befinden.
aws ec2 describe-instance-topology \
--region us-west-2 \
--group-names ML-group HPC-group
Es folgt eine Beispielausgabe.
{
"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
-
So beschreiben Sie die Topologie von Instances in einer bestimmten Placement-Gruppe
Verwenden Sie das cmdlet Get-EC2InstanceTopology.
Get-EC2InstanceTopology `
-GroupName ML-group, HPC-group
Beispiel 3: DescribeInstanceTopology - Filter für den Instanztyp
Sie können nach einem angegebenen Instance-Typ (exakte Übereinstimmung) oder nach einer Instance-Familie (mit einem Platzhalter) filtern. Sie können auch einen Filter für einen angegebenen Instance-Typ und einen Filter für eine Instance-Familie miteinander kombinieren.
Beispiel 3a — Filter mit exakter Übereinstimmung für einen bestimmten Instance-Typ
- AWS CLI
-
So beschreiben Sie die Topologie von Instances mit einem bestimmten Instance-Typ
Verwenden Sie den Befehl describe-instance-topology mit dem Filter instance-type. Die Ausgabe enthält nur die Instances, die dem angegebenen Instance-Typ entsprechen.
aws ec2 describe-instance-topology \
--region us-west-2 \
--filters Name=instance-type,Values=trn1n.32xlarge
Es folgt eine Beispielausgabe.
{
"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
-
So beschreiben Sie die Topologie von Instances mit einem bestimmten Instance-Typ
Verwenden Sie das cmdlet Get-EC2InstanceTopology.
Get-EC2InstanceTopology `
-Filter @{Name="instance-type"; Values="trn1n.32xlarge"}
Beispiel 3b — Platzhalterfilter für eine Instance-Familie
- AWS CLI
-
So beschreiben Sie die Topologie von Instances mit einer bestimmten Instance-Familie
Verwenden Sie den Befehl describe-instance-topology mit dem Filter instance-type. Die Ausgabe enthält nur die Instances, die der angegebenen Instance-Familie entsprechen.
aws ec2 describe-instance-topology \
--region us-west-2 \
--filters Name=instance-type,Values=trn1*
Es folgt eine Beispielausgabe.
{
"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
-
So beschreiben Sie die Topologie von Instances mit einer bestimmten Instance-Familie
Verwenden Sie das cmdlet Get-EC2InstanceTopology.
Get-EC2InstanceTopology `
-Filter @{Name="instance-type"; Values="trn1*"}
Beispiel 3c — Kombinierter Instance-Familien- und Exact-Match-Filter
- AWS CLI
-
So beschreiben Sie die Topologie von Instances mit einer Instance-Familie oder einem Instance-Typ
Verwenden Sie den Befehl describe-instance-topology mit dem Filter instance-type. Die Ausgabe enthält nur die Instances, die den angegebenen Kriterien entsprechen.
aws ec2 describe-instance-topology \
--region us-west-2 \
--filters "Name=instance-type,Values=p4d*,trn1n.32xlarge"
Es folgt eine Beispielausgabe.
{
"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
-
So beschreiben Sie die Topologie von Instances mit einer Instance-Familie oder einem Instance-Typ
Verwenden Sie das cmdlet Get-EC2InstanceTopology.
Get-EC2InstanceTopology `
-Filter @{Name="instance-type"; Values="p4d*", "trn1n.32xlarge"}
Beispiel 4: DescribeInstanceTopology - Zonen-ID-Filter
Mit dem Filter zone-id können Sie nach einer Availability Zone oder nach einer lokalen Zone filtern. Sie können auch einen Availability-Zone-Filter und einen Filter für die lokale Zone miteinander kombinieren.
Beispiel 4a — Filter für die Verfügbarkeitszone
- AWS CLI
-
So beschreiben Sie die Topologie von Instances in einer bestimmten Availability Zone
Verwenden Sie den Befehl describe-instance-topology mit dem Filter zone-id. Die Ausgabe enthält nur Instances in der angegebenen Availability Zone.
aws ec2 describe-instance-topology \
--region us-east-1 \
--filters Name=zone-id,Values=use1-az1
Es folgt eine Beispielausgabe.
{
"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
-
So beschreiben Sie die Topologie von Instances in einer bestimmten Availability Zone
Verwenden Sie das cmdlet Get-EC2InstanceTopology.
Get-EC2InstanceTopology `
-Filter @{Name="zone-id"; Values="use1-az1"}
Beispiel 4b — Lokaler Zonenfilter
- AWS CLI
-
So beschreiben Sie die Topologie von Instances in einer bestimmten Local Zone
Verwenden Sie den Befehl describe-instance-topology mit dem Filter zone-id. Die Ausgabe enthält nur Instances in der angegebenen Local Zone.
aws ec2 describe-instance-topology \
--region us-east-1 \
--filters Name=zone-id,Values=use1-atl2-az1
Es folgt eine Beispielausgabe.
{
"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
-
So beschreiben Sie die Topologie von Instances in einer bestimmten Local Zone
Verwenden Sie das cmdlet Get-EC2InstanceTopology.
Get-EC2InstanceTopology `
-Filter @{Name="zone-id"; Values="use1-atl2-az1"}
Beispiel 4c — Kombinierte Filter für Availability Zone und Local Zone
- AWS CLI
-
So beschreiben Sie die Topologie von Instances in einer bestimmten Zone
Verwenden Sie den Befehl describe-instance-topology mit dem Filter zone-id. Die Ausgabe enthält nur die Instances, die sich in einer der angegebenen Zonen befinden.
aws ec2 describe-instance-topology \
--region us-east-1 \
--filters Name=zone-id,Values=use1-az1,use1-atl2-az1
Es folgt eine Beispielausgabe.
{
"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
-
So beschreiben Sie die Topologie von Instances in einer bestimmten Zone
Verwenden Sie das cmdlet Get-EC2InstanceTopology.
Get-EC2InstanceTopology `
-Filter @{Name="zone-id"; Values="use1-az1", "use1-atl2-az1"}
Beispiel 5: DescribeInstanceTopology - Instanztyp- und Zonen-ID-Filter
Sie können Filter in einem einzelnen Befehl miteinander kombinieren.
- AWS CLI
-
So beschreiben Sie die Topologie von Instances mit bestimmten Instance-Typen, Instance-Familien und Zonen
Verwenden Sie den Befehl describe-instance-topology mit den Filtern instance-type und zone-id. Die Antwort enthält alle Instances mit einem der angegebenen Instance-Typen, die sich in einer der angegebenen Zonen befinden.
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"
Es folgt eine Beispielausgabe.
{
"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
-
So beschreiben Sie die Topologie von Instances mit bestimmten Instance-Typen, Instance-Familien und Zonen
Verwenden Sie das cmdlet Get-EC2InstanceTopology.
Get-EC2InstanceTopology `
-Filter @{Name="instance-type"; Values="p4d*", "trn1n.32xlarge"} `
@{Name="zone-id"; Values="use1-az1", "use1-atl2-az1"}
Beispiel 6: DescribeCapacityReservationTopology - Kapazitätsreservierung IDs
- AWS CLI
-
So beschreiben Sie die Topologie bestimmter Kapazitätsreservierungen
Verwenden Sie den Befehl describe-capacity-reservation-topology mit dem Parameter capacity-reservation-id. Die Ausgabe umfasst nur die Kapazitätsreservierungen, die der angegebenen Kapazitätsreservierung entsprechen IDs.
aws ec2 describe-capacity-reservation-topology \
--region us-east-1 \
--capacity-reservation-id cr-1111111111example cr-2222222222example
Es folgt eine Beispielausgabe.
{
"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
-
So beschreiben Sie die Topologie bestimmter Kapazitätsreservierungen
Verwenden Sie das cmdlet Get-EC2CapacityReservationTopology.
Get-EC2CapacityReservationTopology `
-CapacityReservationId cr-1111111111example cr-2222222222example
Beispiel 7: DescribeCapacityReservationTopology — Filter für den Instanztyp
Sie können nach einem angegebenen Instance-Typ (exakte Übereinstimmung) oder nach einer Instance-Familie (mit einem Platzhalter) filtern. Sie können auch einen Filter für einen angegebenen Instance-Typ und einen Filter für eine Instance-Familie miteinander kombinieren.
- AWS CLI
-
So beschreiben Sie die Topologie von Kapazitätsreservierungen mit einem bestimmten Instance-Typ
Verwenden Sie den Befehl describe-capacity-reservation-topology mit dem Filter instance-type. Die Antwort enthält alle Instances mit dem angegebenen Instance-Typ.
aws ec2 describe-capacity-reservation-topology \
--region us-east-1 \
--filters Name=instance-type,Values=p5en.48xlarge
Es folgt eine Beispielausgabe.
{
"CapacityReservations": [
{
"CapacityReservationId": "cr-2222222222example",
"CapacityBlockId": "null",
"State": "active",
"InstanceType": "p5en.48xlarge",
"NetworkNodes": [
"nn-1111111111example",
"nn-2222222222example"
],
"AvailabilityZone": "us-east-1a"
}
],
"NextToken": "SomeEncryptedToken"
}
- PowerShell
-
So beschreiben Sie die Topologie von Kapazitätsreservierungen mit einem bestimmten Instance-Typ
Verwenden Sie das cmdlet Get-EC2CapacityReservationTopology.
Get-EC2CapacityReservationTopology `
-Filter @{Name="instance-type"; Values="p5en.48xlarge"}
