Ejemplos de la topología de instancias de Amazon EC2 - Amazon Elastic Compute Cloud
Ej. 1: DescribeInstanceTopology: ID de instanciaEj. 2: DescribeInstanceTopology: parámetro del nombre de grupo de ubicaciónEj. 3: DescribeInstanceTopology: filtro de tipo de instanciaEj. 4: DescribeInstanceTopology: filtro de ID de zonaEj. 5: DescribeInstanceTopology: filtros de tipo de instancia e ID de zonaEj. 6: DescribeCapacityReservationTopology: ID de reserva de capacidadEj. 7: DescribeCapacityReservationTopology: filtro de tipo de instancia

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. Además, puede usar el comando describe-capacity-reservation-topology para describir la topología de las reservas de capacidad.

Si utiliza el comando describe-instance-topology o describe-capacity-reservation-topology sin parámetros ni filtros, en la respuesta se incluirán todas las instancias o reservas de capacidad (según el comando utilizado) 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 o reservas de capacidad que coincidan con los ID de instancia o reserva de capacidad o los nombres de los grupos de ubicación especificados. También puede incluir filtros para devolver instancias o reservas de capacidad que coincidan con un tipo o familia de instancias específico, o instancias o reservas de capacidad 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 o reservas de capacidad por página de forma predeterminada. Puede especificar hasta 100 instancias o reservas de capacidad por página mediante el parámetro --max-results.

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

Permisos necesarios

Los siguientes permisos son necesarios:

  • ec2:DescribeInstanceTopology: para describir la topología de la instancia

  • ec2:DescribeCapacityReservationTopology: para describir la topología de reserva de capacidad

Ejemplo 1: DescribeInstanceTopology: 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"
            ],
            "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
Para describir la topología de instancias específicas

Utilice el cmdlet Get-EC2InstanceTopology.

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

Ejemplo 2: DescribeInstanceTopology: parámetro del 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"
            ],
            "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
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: DescribeInstanceTopology: 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"
            ],
            "CapacityBlockId": "null",
            "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"
            ],
            "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
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"
            ],
            "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
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: DescribeInstanceTopology: 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"
            ],
            "CapacityBlockId": "null",
            "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"
            ],
            "CapacityBlockId": "null",
            "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"
            ],
            "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
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: DescribeInstanceTopology: 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"
            ],
            "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
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"}

Ejemplo 6: DescribeCapacityReservationTopology: ID de reserva de capacidad

AWS CLI
Descripción de la topología de las reservas de capacidad específicas

Utilice el comando describe-capacity-reservation-topology con el parámetro capacity-reservation-id. La salida incluye solo las reservas de capacidad que coinciden con los ID de reserva de capacidad especificados.

aws ec2 describe-capacity-reservation-topology \
    --region us-east-1 \
    --capacity-reservation-id cr-1111111111example cr-2222222222example

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

{
    "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
Descripción de la topología de las reservas de capacidad específicas

Utilice el cmdlet Get-EC2CapacityReservationTopology.

Get-EC2CapacityReservationTopology `
    -CapacityReservationId cr-1111111111example cr-2222222222example

Ejemplo 7: DescribeCapacityReservationTopology: 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.

AWS CLI
Descripción de la topología de las reservas de capacidad con un tipo de instancia específico

Utilice el comando describe-capacity-reservation-topology con el filtro instance-type. La respuesta contiene cualquier instancia con el tipo de instancia especificado.

aws ec2 describe-capacity-reservation-topology \
    --region us-east-1 \
    --filters Name=instance-type,Values=p5en.48xlarge

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

{
    "CapacityReservations": [
        {
            "CapacityReservationId": "cr-2222222222example",
            "CapacityBlockId": "null",
            "State": "active",
            "InstanceType": "p5en.48xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example"
            ],
            "AvailabilityZone": "us-east-1a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
Descripción de la topología de las reservas de capacidad con un tipo de instancia específico

Utilice el cmdlet Get-EC2CapacityReservationTopology.

Get-EC2CapacityReservationTopology `
    -Filter @{Name="instance-type"; Values="p5en.48xlarge"}