Exemples de topologie d' EC2 instance Amazon - Amazon Elastic Compute Cloud
Exemple 1 — Instance IDsExemple 2 — Paramètre de nom du groupe de placementExemple 3 — Filtre de type d'instanceExemple 4 — Filtre d'identification de zoneExemple 5 — Filtres de type d'instance et d'ID de zone

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Exemples de topologie d' EC2 instance Amazon

Vous pouvez utiliser le describe-instance-topologycommande pour décrire la topologie d'instance de vos EC2 instances.

Lorsque vous utilisez la commande describe-instance-topology sans paramètres ni filtres, la réponse inclut toutes vos instances qui correspondent aux types d’instances pris en charge pour cette commande dans la région spécifiée. Vous pouvez spécifier la région en incluant le paramètre --region ou en définissant une région par défaut. Pour plus d’informations sur la définition d’une région par défaut, consultez Sélectionnez une région pour vos EC2 ressources Amazon.

Vous pouvez inclure des paramètres pour renvoyer des instances qui correspondent aux noms d'instance IDs ou de groupe de placement spécifiés. Vous pouvez également inclure des filtres pour renvoyer des instances correspondant à un type d’instance ou à une famille d’instances spécifiques, ou des instances situées dans une zone de disponibilité ou une zone locale spécifiée. Vous pouvez inclure un seul paramètre ou filtre, ou une combinaison de paramètres et de filtres.

La sortie est paginée, avec un maximum de 20 instances par page par défaut. Vous pouvez spécifier jusqu’à 100 instances par page à l’aide du paramètre --max-results.

Pour de plus amples informations, consultez .describe-instance-topology.

Autorisations requises

L'autorisation suivante est requise pour décrire la topologie d'instance :

  • ec2:DescribeInstanceTopology

Exemple 1 — Instance IDs

AWS CLI
Pour décrire la topologie d'instances spécifiques

Utilisation de la describe-instance-topologycommande avec le --instance-ids paramètre. La sortie inclut uniquement les instances qui correspondent à l'instance spécifiée IDs.

aws ec2 describe-instance-topology \
    --region us-west-2 \
    --instance-ids i-1111111111example i-2222222222example

Voici un exemple de sortie.

{
    "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
Pour décrire la topologie d'instances spécifiques

Utilisez l'Get-EC2InstanceTopologyapplet de commande.

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

Exemple 2 — Paramètre de nom du groupe de placement

AWS CLI
Pour décrire la topologie des instances d'un groupe de placement spécifique

Utilisation de la describe-instance-topologycommande avec le group-names paramètre. La sortie inclut uniquement les instances qui se trouvent dans l'un des groupes de placement spécifiés.

aws ec2 describe-instance-topology \
    --region us-west-2 \
    --group-names ML-group HPC-group

Voici un exemple de sortie.

{
    "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
Pour décrire la topologie des instances d'un groupe de placement spécifique

Utilisez l'Get-EC2InstanceTopologyapplet de commande.

Get-EC2InstanceTopology `
    -GroupName ML-group, HPC-group

Exemple 3 — Filtre de type d'instance

Vous pouvez filtrer en fonction d’un type d’instance spécifié (correspondance exacte) ou en fonction d’une famille d’instances (à l’aide d’un caractère générique). Vous pouvez également combiner un filtre de type d’instance et un filtre de famille d’instances spécifiés.

Exemple 3a — Filtre de correspondance exacte pour un type d'instance spécifié

AWS CLI
Pour décrire la topologie des instances avec un type d'instance spécifique

Utilisation de la describe-instance-topologycommande avec le instance-type filtre. La sortie inclut uniquement les instances avec le type d'instance spécifié.

aws ec2 describe-instance-topology \
    --region us-west-2 \
    --filters Name=instance-type,Values=trn1n.32xlarge

Voici un exemple de sortie.

{
    "Instances": [
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3333333333example"
            ],
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
Pour décrire la topologie des instances avec un type d'instance spécifique

Utilisez l'Get-EC2InstanceTopologyapplet de commande.

Get-EC2InstanceTopology `
    -Filter @{Name="instance-type"; Values="trn1n.32xlarge"}

Exemple 3b — Filtre générique pour une famille d'instances

AWS CLI
Pour décrire la topologie des instances avec une famille d'instances spécifique

Utilisation de la describe-instance-topologycommande avec le instance-type filtre. La sortie inclut uniquement les instances de la famille d'instances spécifiée.

aws ec2 describe-instance-topology \
    --region us-west-2 \
    --filters Name=instance-type,Values=trn1*

Voici un exemple de sortie.

{
    "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
Pour décrire la topologie des instances avec une famille d'instances spécifique

Utilisez l'Get-EC2InstanceTopologyapplet de commande.

Get-EC2InstanceTopology `
    -Filter @{Name="instance-type"; Values="trn1*"}

Exemple 3c — Famille d'instances combinée et filtres de correspondance exacte

AWS CLI
Pour décrire la topologie des instances avec une famille d'instances ou un type d'instance

Utilisation de la describe-instance-topologycommande avec le instance-type filtre. La sortie inclut uniquement les instances qui répondent aux critères spécifiés.

aws ec2 describe-instance-topology \
    --region us-west-2 \
    --filters "Name=instance-type,Values=p4d*,trn1n.32xlarge"

Voici un exemple de sortie.

{
    "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
Pour décrire la topologie des instances avec une famille d'instances ou un type d'instance

Utilisez l'Get-EC2InstanceTopologyapplet de commande.

Get-EC2InstanceTopology `
    -Filter @{Name="instance-type"; Values="p4d*", "trn1n.32xlarge"}

Exemple 4 — Filtre d'identification de zone

Vous pouvez utiliser le filtre zone-id pour filtrer par zone de disponibilité ou zone locale. Vous pouvez également combiner le filtre de zone de disponibilité et le filtre de zone locale.

Exemple 4a — Filtre de zone de disponibilité

AWS CLI
Pour décrire la topologie des instances dans une zone de disponibilité spécifique

Utilisation de la describe-instance-topologycommande avec le zone-id filtre. La sortie inclut uniquement les instances de la zone de disponibilité spécifiée.

aws ec2 describe-instance-topology \
    --region us-east-1 \
    --filters Name=zone-id,Values=use1-az1

Voici un exemple de sortie.

{
    "Instances": [
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3214313214example"
            ],
            "ZoneId": "use1-az1",
            "AvailabilityZone": "us-east-1a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
Pour décrire la topologie des instances dans une zone de disponibilité spécifique

Utilisez l'Get-EC2InstanceTopologyapplet de commande.

Get-EC2InstanceTopology `
    -Filter @{Name="zone-id"; Values="use1-az1"}

Exemple 4b — Filtre de zone locale

AWS CLI
Pour décrire la topologie des instances dans une zone locale spécifique

Utilisation de la describe-instance-topologycommande avec le zone-id filtre. La sortie inclut uniquement les instances de la zone locale spécifiée.

aws ec2 describe-instance-topology \
    --region us-east-1 \
    --filters Name=zone-id,Values=use1-atl2-az1

Voici un exemple de sortie.

{
    "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
Pour décrire la topologie des instances dans une zone locale spécifique

Utilisez l'Get-EC2InstanceTopologyapplet de commande.

Get-EC2InstanceTopology `
    -Filter @{Name="zone-id"; Values="use1-atl2-az1"}

Exemple 4c — Filtres combinés de zone de disponibilité et de zone locale

AWS CLI
Pour décrire la topologie des instances dans une zone spécifique

Utilisation de la describe-instance-topologycommande avec le zone-id filtre. La sortie inclut uniquement les instances qui se trouvent dans l'une des zones spécifiées.

aws ec2 describe-instance-topology \
    --region us-east-1 \
    --filters Name=zone-id,Values=use1-az1,use1-atl2-az1

Voici un exemple de sortie.

{
    "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
Pour décrire la topologie des instances dans une zone spécifique

Utilisez l'Get-EC2InstanceTopologyapplet de commande.

Get-EC2InstanceTopology `
    -Filter @{Name="zone-id"; Values="use1-az1", "use1-atl2-az1"}

Exemple 5 — Filtres de type d'instance et d'ID de zone

Vous pouvez combiner des filtres en une seule commande.

AWS CLI
Pour décrire la topologie des instances avec des types d'instances, des familles d'instances et des zones spécifiques

Utilisation de la describe-instance-topologycommande avec les zone-id filtres instance-type et. La réponse contient toutes les instances avec l'un des types d'instance spécifiés et se trouvant dans l'une des zones spécifiées.

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"

Voici un exemple de sortie.

{
    "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
Pour décrire la topologie des instances avec des types d'instances, des familles d'instances et des zones spécifiques

Utilisez l'Get-EC2InstanceTopologyapplet de commande.

Get-EC2InstanceTopology `
    -Filter @{Name="instance-type"; Values="p4d*", "trn1n.32xlarge"} `
            @{Name="zone-id"; Values="use1-az1", "use1-atl2-az1"}