Ejemplos de la topología de instancias de Amazon EC2 - Amazon Elastic Compute Cloud
Ejemplo 1: ID de instanciaEjemplo 2: parámetro de nombre de grupo de ubicaciónEjemplo 3: filtro de tipo de instanciaEjemplo 4: filtro de ID de zonaEjemplo 5: filtros de tipo de instancia e ID de zona

Ejemplos de la topología de instancias de Amazon EC2

Puede usar el comando describe-instance-topology para describir la topología de las instancias de EC2.

Si utiliza el comando describe-instance-topology sin parámetros ni filtros, en la respuesta se incluyen todas las instancias que coincidan con los tipos de instancias compatibles con este comando en la región especificada. Para especificar la región, incluya el parámetro --region o establezca una región predeterminada. Para obtener más información sobre cómo establecer una región predeterminada, consulte Selección de una región para los recursos de Amazon EC2.

Puede incluir parámetros para devolver instancias que coincidan con los ID de instancia o los nombres de los grupos de ubicación especificados. También puede incluir filtros para devolver instancias que coincidan con un tipo o familia de instancias específico, o instancias en una zona de disponibilidad o zona local específica. Puede incluir un único parámetro o filtro, o una combinación de parámetros y filtros.

La salida está paginada, con hasta 20 instancias por página de forma predeterminada. Puede especificar hasta 100 instancias por página mediante el parámetro --max-results.

Para obtener más información, consulte describe-instance-topology.

Permisos de necesarios

Se requiere el siguiente permiso para describir la topología de las instancias:

  • ec2:DescribeInstanceTopology

Ejemplo 1: ID de instancia

AWS CLI
Para describir la topología de instancias específicas

Utilice el comando describe-instance-topology con el parámetro --instance-ids. En el resultado se incluyen solo las instancias que coincidan con los ID de instancia especificados.

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

A continuación, se muestra un ejemplo del resultado.

{
    "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
Para describir la topología de instancias específicas

Utilice el cmdlet Get-EC2InstanceTopology.

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

Ejemplo 2: parámetro de nombre de grupo de ubicación

AWS CLI
Para describir la topología de las instancias en un grupo de ubicación específico

Utilice el comando describe-instance-topology con el parámetro group-names. En el resultado solo se incluyen las instancias que estén en cualquiera de los grupos de ubicación especificados.

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

A continuación, se muestra un ejemplo del resultado.

{
    "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
Para describir la topología de las instancias en un grupo de ubicación específico

Utilice el cmdlet Get-EC2InstanceTopology.

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

Ejemplo 3: filtro de tipo de instancia

Puede filtrar por un tipo de instancia específico (coincidencia exacta) o por una familia de instancias (con un comodín). También puede combinar un filtro de tipo de instancia y un filtro de familia de instancias específicos.

Ejemplo 3a: filtro de coincidencia exacta para un tipo de instancia específico

AWS CLI
Para describir la topología de las instancias con un tipo de instancia específico

Utilice el comando describe-instance-topology con el filtro instance-type. El resultado incluye solo las instancias con el tipo de instancia especificado.

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

A continuación, se muestra un ejemplo del resultado.

{
    "Instances": [
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3333333333example"
            ],
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
Para describir la topología de las instancias con un tipo de instancia específico

Utilice el cmdlet Get-EC2InstanceTopology.

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

Ejemplo 3b: filtro comodín para una familia de instancias

AWS CLI
Para describir la topología de las instancias con una familia de instancias específica

Utilice el comando describe-instance-topology con el filtro instance-type. El resultado incluye solo las instancias de la familia de instancias especificada.

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

A continuación, se muestra un ejemplo del resultado.

{
    "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
Para describir la topología de las instancias con una familia de instancias específica

Utilice el cmdlet Get-EC2InstanceTopology.

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

Ejemplo 3c: filtros combinados de familia de instancias y coincidencia exacta

AWS CLI
Para describir la topología de instancias con una familia de instancias o un tipo de instancia

Utilice el comando describe-instance-topology con el filtro instance-type. El resultado incluye solo las instancias que cumplen los criterios especificados.

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

A continuación, se muestra un ejemplo del resultado.

{
    "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
Para describir la topología de instancias con una familia de instancias o un tipo de instancia

Utilice el cmdlet Get-EC2InstanceTopology.

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

Ejemplo 4: filtro de ID de zona

Puede usar el filtro zone-id para filtrar por zona de disponibilidad o zona local. También puede combinar un filtro de zona de disponibilidad y un filtro de zona local.

Ejemplo 4a: filtro de zona de disponibilidad

AWS CLI
Para describir la topología de instancias en una zona de disponibilidad específica

Utilice el comando describe-instance-topology con el filtro zone-id. En el resultado se incluyen solo las instancias de la zona de disponibilidad especificada.

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

A continuación, se muestra un ejemplo del resultado.

{
    "Instances": [
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3214313214example"
            ],
            "ZoneId": "use1-az1",
            "AvailabilityZone": "us-east-1a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
Para describir la topología de instancias en una zona de disponibilidad específica

Utilice el cmdlet Get-EC2InstanceTopology.

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

Ejemplo 4b: filtro de zona local

AWS CLI
Para describir la topología de instancias en una zona local específica

Utilice el comando describe-instance-topology con el filtro zone-id. En el resultado se incluyen solo las instancias de la zona local especificada.

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

A continuación, se muestra un ejemplo del resultado.

{
    "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
Para describir la topología de instancias en una zona local específica

Utilice el cmdlet Get-EC2InstanceTopology.

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

Ejemplo 4c: filtros combinados de zona de disponibilidad y zona local

AWS CLI
Para describir la topología de las instancias en una zona específica

Utilice el comando describe-instance-topology con el filtro zone-id. En el resultado se incluyen solo las instancias que estén en cualquiera de las zonas especificadas.

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

A continuación, se muestra un ejemplo del resultado.

{
    "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
Para describir la topología de las instancias en una zona específica

Utilice el cmdlet Get-EC2InstanceTopology.

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

Ejemplo 5: filtros de tipo de instancia e ID de zona

Puede combinar los filtros en un único comando.

AWS CLI
Para describir la topología de las instancias con tipos de instancias, familias de instancias y zonas específicos

Utilice el comando describe-instance-topology con los filtros instance-type y zone-id. La respuesta contiene todas las instancias con cualquiera de los tipos de instancias especificados y que se encuentran en cualquiera de las zonas especificadas.

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"

A continuación, se muestra un ejemplo del resultado.

{
    "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
Para describir la topología de las instancias con tipos de instancias, familias de instancias y zonas específicos

Utilice el cmdlet Get-EC2InstanceTopology.

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