Beispiele für die EC2 Amazon-Instance-Topologie - Amazon Elastic Compute Cloud
Beispiel 1 — Instanz IDsBeispiel 2 — Parameter für den Namen der PlatzierungsgruppeBeispiel 3 — Filter für den InstanztypBeispiel 4 — Zonen-ID-FilterBeispiel 5 — Instanztyp- und Zonen-ID-Filter

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 verwenden describe-instance-topologyBefehl zur Beschreibung der Instanztopologie für Ihre EC2 Instances.

Wenn Sie den Befehl describe-instance-topology ohne Parameter oder Filter verwenden, umfasst die Antwort alle Ihre Instances, 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 zurückzugeben, die den angegebenen Instance IDs - oder Placement-Gruppennamen entsprechen. Sie können auch Filter einschließen, um Instances zurückzugeben, die einem angegebenen Instance-Typ oder einer angegebenen Instance-Familie entsprechen, oder Instances in einer angegebenen Availability Zone oder lokalen 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 pro Seite. Mit dem Parameter --max-results können bis zu 100 Instances pro Seite angegeben werden.

Weitere Informationen finden Sie unter .describe-instance-topology.

Erforderliche Berechtigungen

Die folgende Berechtigung ist erforderlich, um die Instance-Topologie zu beschreiben:

  • ec2:DescribeInstanceTopology

Beispiel 1 — Instanz IDs

AWS CLI
Um die Topologie bestimmter Instanzen zu beschreiben

Verwenden der 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"
            ],
            "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"
}
PowerShell
Um die Topologie bestimmter Instanzen zu beschreiben

Verwenden Sie das Get-EC2InstanceTopologyCmdlet.

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

Beispiel 2 — Parameter für den Namen der Platzierungsgruppe

AWS CLI
Um die Topologie von Instanzen in einer bestimmten Platzierungsgruppe zu beschreiben

Verwenden der describe-instance-topologyBefehl mit dem group-names Parameter. Die Ausgabe umfasst nur die Instanzen, 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"
            ],
            "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"
}
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 — 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 der 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"
            ],
            "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 der 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"
            ],
            "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"
}
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 der 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"
            ],
            "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"
}
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 — 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 — Verfügbarkeitszonenfilter

AWS CLI
Um die Topologie von Instanzen in einer bestimmten Availability Zone zu beschreiben

Verwenden der 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"
            ],
            "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 der 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"
            ],
            "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 der 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"
            ],
            "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"
}
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 — 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 der 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"
            ],
            "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"
}
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"}