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. Und Sie können den describe-capacity-reservation-topologyBefehl verwenden, um die Topologie Ihrer Kapazitätsreservierungen zu beschreiben.
Wenn Sie den describe-capacity-reservation-topology Befehl describe-instance-topology oder ohne Parameter oder Filter verwenden, umfasst die Antwort alle Ihre Instances oder Kapazitätsreservierungen (je nach verwendetem Befehl), 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 Namen der angegebenen Instance-, IDs Kapazitätsreservierungs- oder Platzierungsgruppen entsprechen. Sie können auch Filter verwenden, um Instances oder Kapazitätsreservierungen zurückzugeben, die einem bestimmten Instance-Typ oder einer bestimmten Instance-Familie entsprechen, oder Instances oder Kapazitätsreservierungen in einer bestimmten 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 enthält standardmäßig bis zu 20 Instances oder Kapazitätsreservierungen pro Seite. Mit dem --max-results Parameter können Sie bis zu 100 Instanzen 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
-
Um die Topologie bestimmter Instanzen zu beschreiben
Verwenden Sie den describe-instance-topologyBefehl mit dem --instance-ids Parameter. 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
-
Um die Topologie bestimmter Instanzen zu beschreiben
Verwenden Sie das Get-EC2InstanceTopologyCmdlet.
Get-EC2InstanceTopology `
-InstanceId i-1111111111example, i-2222222222example
Beispiel 2: DescribeInstanceTopology - Parameter für den Namen der Platzierungsgruppe
- AWS CLI
-
Um die Topologie von Instances in einer bestimmten Platzierungsgruppe zu beschreiben
Verwenden Sie den describe-instance-topologyBefehl mit dem group-names Parameter. Die Ausgabe umfasst nur die Exemplare, die sich in einer der angegebenen Platzierungsgruppen 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
-
Um die Topologie von Instances in einer bestimmten Platzierungsgruppe zu beschreiben
Verwenden Sie das Get-EC2InstanceTopologyCmdlet.
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
-
Um die Topologie von Instanzen mit einem bestimmten Instanztyp zu beschreiben
Verwenden Sie den describe-instance-topologyBefehl mit dem instance-type Filter. Die Ausgabe umfasst nur die Instanzen mit dem angegebenen Instanztyp.
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
-
Um die Topologie von Instanzen mit einem bestimmten Instanztyp zu beschreiben
Verwenden Sie das Get-EC2InstanceTopologyCmdlet.
Get-EC2InstanceTopology `
-Filter @{Name="instance-type"; Values="trn1n.32xlarge"}
Beispiel 3b — Platzhalterfilter für eine Instance-Familie
- AWS CLI
-
Um die Topologie von Instances mit einer bestimmten Instanzfamilie zu beschreiben
Verwenden Sie den describe-instance-topologyBefehl mit dem instance-type Filter. Die Ausgabe umfasst nur die Varianten mit der angegebenen Instanzfamilie.
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
-
Um die Topologie von Instanzen mit einer bestimmten Instanzfamilie zu beschreiben
Verwenden Sie das Get-EC2InstanceTopologyCmdlet.
Get-EC2InstanceTopology `
-Filter @{Name="instance-type"; Values="trn1*"}
Beispiel 3c — Kombinierte Filter für Instanzfamilien und exakte Treffer
- AWS CLI
-
Um die Topologie von Instances mit einer Instanzfamilie oder einem Instanztyp zu beschreiben
Verwenden Sie den describe-instance-topologyBefehl mit dem instance-type Filter. Die Ausgabe umfasst nur die Instanzen, die die angegebenen Kriterien erfüllen.
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
-
Um die Topologie von Instances mit einer Instanzfamilie oder einem Instanztyp zu beschreiben
Verwenden Sie das Get-EC2InstanceTopologyCmdlet.
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
-
Um die Topologie von Instanzen in einer bestimmten Availability Zone zu beschreiben
Verwenden Sie den describe-instance-topologyBefehl mit dem zone-id Filter. Die Ausgabe umfasst nur die 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
-
Um die Topologie von Instanzen in einer bestimmten Availability Zone zu beschreiben
Verwenden Sie das Get-EC2InstanceTopologyCmdlet.
Get-EC2InstanceTopology `
-Filter @{Name="zone-id"; Values="use1-az1"}
Beispiel 4b — Lokaler Zonenfilter
- AWS CLI
-
Um die Topologie von Instanzen in einer bestimmten lokalen Zone zu beschreiben
Verwenden Sie den describe-instance-topologyBefehl mit dem zone-id Filter. Die Ausgabe umfasst nur die Instanzen in der angegebenen lokalen 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
-
Um die Topologie von Instanzen in einer bestimmten lokalen Zone zu beschreiben
Verwenden Sie das Get-EC2InstanceTopologyCmdlet.
Get-EC2InstanceTopology `
-Filter @{Name="zone-id"; Values="use1-atl2-az1"}
Beispiel 4c — Kombinierte Filter für Availability Zone und Local Zone
- AWS CLI
-
Um die Topologie von Instanzen in einer bestimmten Zone zu beschreiben
Verwenden Sie den describe-instance-topologyBefehl mit dem zone-id Filter. Die Ausgabe umfasst nur die Instanzen, 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
-
Um die Topologie von Instanzen in einer bestimmten Zone zu beschreiben
Verwenden Sie das Get-EC2InstanceTopologyCmdlet.
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 einzigen Befehl kombinieren.
- AWS CLI
-
Um die Topologie von Instances mit bestimmten Instance-Typen, Instance-Familien und Zonen zu beschreiben
Verwenden Sie den describe-instance-topologyBefehl mit den zone-id Filtern instance-type und. Die Antwort enthält alle Instanzen mit einem der angegebenen Instanztypen, 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
-
Um die Topologie von Instances mit bestimmten Instance-Typen, Instance-Familien und Zonen zu beschreiben
Verwenden Sie das Get-EC2InstanceTopologyCmdlet.
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
-
Um die Topologie bestimmter Kapazitätsreservierungen zu beschreiben
Verwenden Sie den describe-capacity-reservation-topologyBefehl mit dem capacity-reservation-id Parameter. 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
-
Um die Topologie bestimmter Kapazitätsreservierungen zu beschreiben
Verwenden Sie das Get-EC2CapacityReservationTopologyCmdlet.
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
-
Um die Topologie von Kapazitätsreservierungen mit einem bestimmten Instance-Typ zu beschreiben
Verwenden Sie den describe-capacity-reservation-topologyBefehl mit dem instance-type Filter. Die Antwort enthält alle Instanzen mit dem angegebenen Instanztyp.
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
-
Um die Topologie von Kapazitätsreservierungen mit einem bestimmten Instance-Typ zu beschreiben
Verwenden Sie das Get-EC2CapacityReservationTopologyCmdlet.
Get-EC2CapacityReservationTopology `
-Filter @{Name="instance-type"; Values="p5en.48xlarge"}
