# Topología de Amazon EC2
La topología de Amazon EC2 proporciona una visión jerárquica de la proximidad relativa de la capacidad de computación. Puede utilizar esta información para administrar la infraestructura de computación de alto rendimiento (HPC), machine learning (ML) e IA generativa a escala.
**API de disponibles**
Amazon EC2 ofrece dos API para comprender la topología de EC2:
+ [DescribeInstanceTopology](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstanceTopology.html)
+ Indica la ubicación en la jerarquía de la red de las instancias en *ejecución* en relación con las demás.
+ Ayuda a optimizar la ubicación en la que se ejecutan las cargas de trabajo en las instancias existentes.
+ [DescribeCapacityReservationTopology](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeCapacityReservationTopology.html)
+ Indica dónde se ubicarán las capacidades reservadas en relación con las demás en la jerarquía de la red *antes de iniciar las instancias*.
+ Ayuda a planificar la capacidad al informarle de la ubicación de la capacidad reservada antes de iniciar las instancias.
**Ventajas principales**
La topología de EC2 proporciona las siguientes ventajas clave:
+ Administración de la capacidad: optimice la utilización de los recursos.
+ Programación de trabajos: tome decisiones informadas sobre la ubicación de las cargas de trabajo.
+ Clasificación de nodos: comprenda la proximidad relativa para optimizar el rendimiento en instancias con acoplamiento ajustado.
**Consideraciones**
+ Las vistas de topología solo están disponibles para los siguientes casos:
+ Instancias con el estado `running`
+ Reservas de capacidad con el estado `pending` o `active`
+ Cada vista de topología es única para cada Cuenta de AWS.
+ La Consola de administración de AWS no admite la visualización de la topología.
+ Si bien la información sobre la topología lo ayuda a comprender la ubicación de las instancias, no puede utilizarla para iniciar una nueva instancia físicamente cerca de una instancia existente. Para influir en la ubicación de las instancias, puede [crear reservas de capacidad en los grupos con ubicación en clúster](cr-cpg.md).
**Precios**
Describir la topología de EC2 no conlleva ningún costo adicional.
**Topics**
+ [Funcionamiento](how-ec2-instance-topology-works.md)
+ [Requisitos previos](ec2-instance-topology-prerequisites.md)
+ [Ejemplos](ec2-instance-topology-examples.md)
# Funcionamiento de la topología de Amazon EC2
La red AWS está organizada en una jerarquía de capas. Las instancias de EC2 se conectan a la red en la tercera capa o por debajo de ella, según el tipo de instancia. La topología de una instancia se describe mediante un conjunto de nodos, con un nodo en cada capa de la red. El conjunto de nodos en la respuesta de la API [DescribeInstanceTopology](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstanceTopology.html) o [DescribeCapacityReservationTopology](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeCapacityReservationTopology.html) ofrece una vista descendente de la jerarquía de la red, con el nodo inferior conectado a una instancia.
**nota**
Algunos tipos de instancias comprenden 4 nodos de red en un conjunto de nodos que representan 4 capas de la red, mientras que otros comprenden 3 nodos de red que representan 3 capas de la red. Para ver los tipos de instancias compatibles, consulte [Tipos de instancias](ec2-instance-topology-prerequisites.md#inst-net-topology-prereqs-instance-types).
Según el tipo de reserva de capacidad, es posible que solo vea 1, 2 o 3 nodos de red.
En el siguiente diagrama, se proporciona una representación visual que se puede utilizar para comprender la topología de EC2. Los nodos de red se identifican como **NN1** – **NN7**. Los valores **i**, **ii** y **iii** identifican las capas de red. Los números **1**, **2**, **3** y **4** identifican las instancias de EC2. Las instancias se conectan a un nodo de la capa inferior, identificado con **iii** en el siguiente diagrama. Se puede conectar más de una instancia al mismo nodo.
![\[Representación gráfica de la topología de instancias.\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/images/instance-topology.png)
En este ejemplo:
+ La instancia 1 se conecta al nodo de red 4 (NN4) en la capa iii. NN4 se conecta al nodo de red 2 (NN2) en la capa ii y NN2 se conecta al nodo de red 1 (NN1) en la capa i, que es la primera de la jerarquía de la red en este ejemplo. El conjunto de nodos de red comprende NN1, NN2 y NN4, expresados jerárquicamente desde las capas superiores a la inferior.
+ La instancia 2 también se conecta al nodo de red 4 (NN4). La instancia 1 y la instancia 2 comparten el mismo conjunto de nodos de red: NN1, NN2 y NN4.
+ La instancia 3 también se conecta al nodo de red 5 (NN5). NN5 se conecta a NN2 y NN2 se conecta a NN1. El conjunto de nodos de red para la instancia 3 es NN1, NN2 y NN5.
+ La instancia 4 se conecta al nodo de red 6 (NN6). Su conjunto de nodos de red es NN1, NN3 y NN6.
Al considerar la proximidad de las instancias 1, 2 y 3, las instancias 1 y 2 están más cerca unas de otras porque se conectan al mismo nodo de red (NN4), mientras que la instancia 3 está más alejada porque se conecta a un nodo de red diferente (NN5).
Al considerar la proximidad de todas las instancias de este diagrama, las instancias 1, 2 y 3 están más cerca unas de otras que de la instancia 4 porque comparten NN2 en su conjunto de nodos de red.
Como regla general, si el nodo de red conectado a dos instancias cualquiera es el mismo, estas instancias están físicamente cerca una de la otra, como ocurre con las instancias 1 y 2. Además, cuanto menor sea el número de saltos entre los nodos de red, más cerca estarán las instancias entre sí. Por ejemplo, las instancias 1 y 3 tienen menos saltos a un nodo de red común (NN2) que al nodo de red (NN1) que tienen en común con la instancia 4 y, por lo tanto, están más cerca unas de otras que de la instancia 4.
En este ejemplo, no hay instancias que se ejecuten en el nodo de red 7 (NN7) y, por lo tanto, la salida de la API no incluirá NN7.
## Cómo interpretar la salida de DescribeInstanceTopology
Puede describir la topología de las instancias mediante la API [DescribeInstanceTopology](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstanceTopology.html). La salida proporciona una vista jerárquica de la topología de red subyacente de una instancia.
El siguiente ejemplo de salida corresponde a la información de topología de red de las cuatro instancias del diagrama anterior. A los efectos de este ejemplo, se incluyen comentarios en la salida de ejemplo.
Es importante tener en cuenta la siguiente información de la salida:
+ `NetworkNodes` describe el conjunto de nodos de red de una única instancia.
+ En cada conjunto de nodos de red, los nodos de red se enumeran en orden jerárquico de arriba a abajo.
+ El nodo de red que está conectado a la instancia es el último nodo de red de la lista (la capa inferior).
+ Para determinar qué instancias están cerca unas de otras, primero busque los nodos de red comunes en la capa inferior. Si no hay nodos de red comunes en la capa inferior, busque nodos de red comunes en las capas superiores.
En la siguiente salida de ejemplo, `i-1111111111example` y `i-2222222222example` están ubicados más cerca uno del otro en comparación con las demás instancias de este ejemplo porque tienen el nodo de red `nn-4444444444example` en común en la capa inferior.
**nota**
La respuesta contiene 3 nodos de red o más. Para obtener información sobre la cantidad de nodos de red en la respuesta para cada tipo de instancia compatible, consulte [Tipos de instancias](ec2-instance-topology-prerequisites.md#inst-net-topology-prereqs-instance-types).
```
{
"Instances": [
{
"InstanceId": "i-1111111111example", //Corresponds to instance 1
"InstanceType": "p4d.24xlarge",
"GroupName": "ML-group",
"NetworkNodes": [
"nn-1111111111example", //Corresponds to NN1 in layer i
"nn-2222222222example", //Corresponds to NN2 in layer ii
"nn-4444444444example" //Corresponds to NN4 in layer iii - bottom layer, connected to the instance
],
"CapacityBlockId": "null",
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
},
{
"InstanceId": "i-2222222222example", //Corresponds to instance 2
"InstanceType": "p4d.24xlarge",
"NetworkNodes": [
"nn-1111111111example", //Corresponds to NN1 - layer i
"nn-2222222222example", //Corresponds to NN2 - layer ii
"nn-4444444444example" //Corresponds to NN4 - layer iii - connected to instance
],
"CapacityBlockId": "null",
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
},
{
"InstanceId": "i-3333333333example", //Corresponds to instance 3
"InstanceType": "trn1.32xlarge",
"NetworkNodes": [
"nn-1111111111example", //Corresponds to NN1 - layer i
"nn-2222222222example", //Corresponds to NN2 - layer ii
"nn-5555555555example" //Corresponds to NN5 - layer iii - connected to instance
],
"CapacityBlockId": "null",
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
},
{
"InstanceId": "i-444444444example", //Corresponds to instance 4
"InstanceType": "trn1.2xlarge",
"NetworkNodes": [
"nn-1111111111example", //Corresponds to NN1 - layer i
"nn-3333333333example", //Corresponds to NN3 - layer ii
"nn-6666666666example" //Corresponds to NN6 - layer iii - connected to instance
],
"CapacityBlockId": "null",
"ZoneId": "usw2-az2",
"AvailabilityZone": "us-west-2a"
}
],
"NextToken": "SomeEncryptedToken"
}
```
## Cómo interpretar la salida de DescribeCapacityReservationTopology
Puede describir la topología de la reserva de capacidad mediante la API [DescribeCapacityReservationTopology](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeCapacityReservationTopology.html). La salida proporciona una vista jerárquica de la topología de red subyacente de la capacidad reservada.
El siguiente ejemplo de salida corresponde a la información de topología de red del diagrama anterior. A los efectos de este ejemplo, se incluyen comentarios en la salida de ejemplo.
Es importante tener en cuenta la siguiente información de la salida:
+ `NetworkNodes` describe el conjunto de nodos de red de una única reserva de capacidad.
+ En cada conjunto de nodos de red, los nodos de red se enumeran en orden jerárquico de arriba a abajo.
+ El nodo de red que está conectado a la reserva de capacidad es el último nodo de red de la lista (la capa inferior).
+ Para determinar si las reservas de capacidad estarán cerca unas de otras, primero tiene que buscar los nodos de red comunes en la capa inferior de la salida. Si no hay nodos de red comunes en la capa inferior, busque nodos de red comunes en las capas superiores.
En el siguiente ejemplo de salida, `cr-1111111111example` se encuentra en `nn-2222222222example` y `cr-2222222222example` se encuentra en `nn-3333333333example`. Como las reservas de capacidad se encuentran en distintos nodos de red en `layer ii`, la comunicación entre las instancias de una reserva de capacidad y las instancias de la otra reserva de capacidad será ineficiente.
**nota**
La respuesta contiene 1, 2 o 3 nodos de red en función del tipo de reserva de capacidad.
```
{
"CapacityReservations": [
{
"CapacityReservationId": "cr-1111111111example",
"CapacityBlockId": "null",
"State": "active",
"InstanceType": "p4d.24xlarge",
"NetworkNodes": [
"nn-1111111111example", //Corresponds to NN1 - layer i
"nn-2222222222example" //Corresponds to NN2 - layer ii
// Visibility of additional nodes requires an instance launch and
// the DescribeInstanceTopology API
],
"AvailabilityZone": "us-west-2a"
},
{
"CapacityReservationId": "cr-2222222222example",
"CapacityBlockId": "null",
"State": "active",
"InstanceType": "trn1.2xlarge",
"NetworkNodes": [
"nn-1111111111example", //Corresponds to NN1 - layer i
"nn-3333333333example" //Corresponds to NN3 - layer ii
// Visibility of additional nodes requires an instance launch and
// the DescribeInstanceTopology API
],
"AvailabilityZone": "us-west-2a"
}
],
"NextToken": "SomeEncryptedToken"
}
```
## Diferencias entre DescribeInstanceTopology y DescribeCapacityReservationTopology
En la siguiente tabla se comparan las principales diferencias entre las API DescribeInstanceTopology y DescribeCapacityReservationTopology:
| Punto de comparación | DescribeInstanceTopology | DescribeCapacityReservationTopology |
| --- | --- | --- |
| Fase de uso | Tras la inicialización (modo de ejecución) | Antes de la inicialización (modo de planificación y administración) |
| Finalidad principal | Optimización de las cargas de trabajo en las instancias en ejecución | Planificación de la capacidad y administración de la reserva de capacidad (fusión, división, asignación) antes de la inicialización de la instancia |
| Número de nodos de red | Muestra todos los nodos de una instancia en ejecución. Si la instancia está en una reserva de capacidad, los primeros nodos coincidirán con la topología de reserva de capacidad correspondiente, seguidos de los nodos adicionales que se conectarán a la instancia. | Muestra un conjunto parcial de nodos, que varían según el estado (`pending` o `active`) y el tipo de la reserva de capacidad.\$1 |
| Estado | Las instancias deben tener el estado `running` | Las reservas de capacidad deben tener el estado `pending` o `active` |
| Casos de uso | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/how-ec2-instance-topology-works.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/how-ec2-instance-topology-works.html) |
\$1 En el caso de los bloques de capacidad para Ultraservers, el conjunto de nodos de red es el mismo que al describir la topología de una reserva de capacidad `active` o su instancia en ejecución.
# Requisitos previos para la topología de Amazon EC2
Para describir la topología de Amazon EC2, asegúrese de que las instancias y reservas de capacidad cumplan los siguientes requisitos previos.
**Topics**
+ [Regiones de AWS](#inst-net-topology-prereqs-regions)
+ [Tipos de instancias](#inst-net-topology-prereqs-instance-types)
+ [Estado](#inst-net-topology-prereqs-instance-state)
+ [Permisos de IAM](#ec2-instance-topology-iam-permissions)
## Regiones de AWS
Regiones de AWS admitidas:
+ EE. UU. Este (Norte de Virginia), EE. UU. Este (Ohio), EE. UU. Oeste (Norte de California), EE. UU. Oeste (Oregón)
+ África (Ciudad del Cabo)
+ Asia-Pacífico (Yakarta), Asia-Pacífico (Hong Kong), Asia-Pacífico (Hyderabad), Asia-Pacífico (Melbourne), Asia-Pacífico (Mumbai), Asia-Pacífico (Osaka), Asia-Pacífico (Seúl), Asia-Pacífico (Singapur), Asia-Pacífico (Sídney), Asia-Pacífico (Tokio)
+ Canadá (centro)
+ Europa (Fráncfort), Europa (Irlanda), Europa (Londres), Europa (París), Europa (España), Europa (Estocolmo), Europa (Zúrich)
+ Israel (Tel Aviv)
+ Medio Oriente (Baréin), Medio Oriente (EAU)
+ América del Sur (São Paulo)
+ AWS GovCloud (Oeste de EE. UU.)
La API DescribeCapacityReservationTopology no se admite en Israel (Tel Aviv) y AWS GovCloud (Oeste de EE. UU.).
## Tipos de instancias
Tipos de instancias admitidas:
+ Devuelve **3\$1 nodos de red** en la respuesta
+ `g6e.xlarge` \$1 `g6e.2xlarge` \$1 `g6e.4xlarge` \$1 `g6e.8xlarge` \$1 `g6e.12xlarge` \$1 `g6e.16xlarge` \$1 `g6e.24xlarge` \$1 `g6e.48xlarge` \$1 `g7e.2xlarge` \$1 `g7e.4xlarge` \$1 `g7e.8xlarge` \$1 `g7e.12xlarge` \$1 `g7e.24xlarge` \$1 `g7e.48xlarge`
+ `hpc6a.48xlarge` \$1 `hpc6id.32xlarge` \$1 `hpc7g.4xlarge` \$1 `hpc7g.8xlarge` \$1 `hpc7g.16xlarge` \$1 `hpc7a.12xlarge` \$1 `hpc7a.24xlarge` \$1 `hpc7a.48xlarge` \$1 `hpc7a.96xlarge` \$1 `hpc8a.96xlarge`
+ `p3dn.24xlarge` \$1 `p4d.24xlarge` \$1 `p4de.24xlarge` \$1 `p5.48xlarge` \$1 `p5e.48xlarge` \$1 `p5en.48xlarge` \$1 `p6e-gb200.36xlarge`
+ `trn1.2xlarge` \$1 `trn1.32xlarge` \$1 `trn1n.32xlarge` \$1 `trn2.48xlarge` \$1 `trn2u.48xlarge`
+ Devuelve **4\$1 nodos de red** en la respuesta
+ `p6-b200.48xlarge` \$1 `p6-b300.48xlarge`
\$1 La cantidad de nodos de red devueltos solo se aplica cuando se utiliza la API DescribeInstanceTopology. En el caso de la API DescribeCapacityReservationTopology, la cantidad de nodos de red devueltos variará según el tipo y el estado de la reserva de capacidad.
Los tipos de instancia disponibles varían según la región. Para obtener más información, consulte [Tipos de instancias de Amazon EC2 por región](https://docs.aws.amazon.com/ec2/latest/instancetypes/ec2-instance-regions.html).
## Estado
+ Para `DescribeInstanceTopology`: las instancias deben tener el estado `running`.
+ Para `DescribeCapacityReservationTopology`: las reservas de capacidad deben tener el estado `pending` o `active`.
No puede obtener información sobre la topología de las instancias o las reservas de capacidad en ningún otro estado.
## Permisos de IAM
La identidad de IAM (usuario, grupo de usuarios o rol) requiere los siguientes permisos:
+ `ec2:DescribeInstanceTopology`
+ `ec2:DescribeCapacityReservationTopology`
# Ejemplos de la topología de instancias de Amazon EC2
Puede usar el comando [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) para describir la topología de las instancias de EC2. Además, puede usar el comando [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) 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](using-regions-availability-zones-setup.md).
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 [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) y [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-reservation-topology-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-reservation-topology-topology.html).
**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
**Contents**
+ [Ejemplo 1: DescribeInstanceTopology: ID de instancia](#instance-topology-ex1)
+ [Ejemplo 2: DescribeInstanceTopology: parámetro del nombre de grupo de ubicación](#instance-topology-ex2)
+ [Ejemplo 3: DescribeInstanceTopology: filtro de tipo de instancia](#instance-topology-ex3)
+ [Ejemplo 3a: filtro de coincidencia exacta para un tipo de instancia específico](#instance-topology-ex3a)
+ [Ejemplo 3b: filtro comodín para una familia de instancias](#instance-topology-ex3b)
+ [Ejemplo 3c: filtros combinados de familia de instancias y coincidencia exacta](#instance-topology-ex3c)
+ [Ejemplo 4: DescribeInstanceTopology: filtro de ID de zona](#instance-topology-ex4)
+ [Ejemplo 4a: filtro de zona de disponibilidad](#instance-topology-ex4a)
+ [Ejemplo 4b: filtro de zona local](#instance-topology-ex4b)
+ [Ejemplo 4c: filtros combinados de zona de disponibilidad y zona local](#instance-topology-ex4c)
+ [Ejemplo 5: DescribeInstanceTopology: filtros de tipo de instancia e ID de zona](#instance-topology-ex5)
+ [Ejemplo 6: DescribeCapacityReservationTopology: ID de reserva de capacidad](#instance-topology-ex6)
+ [Ejemplo 7: DescribeCapacityReservationTopology: filtro de tipo de instancia](#instance-topology-ex7)
## Ejemplo 1: DescribeInstanceTopology: ID de instancia
------
#### [ AWS CLI ]
**Para describir la topología de instancias específicas**
Utilice el comando [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).
```
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 [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).
```
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 [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).
```
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 [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).
```
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 [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).
```
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 [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).
```
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 [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).
```
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 [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).
```
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 [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-topology.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceTopology.html).
```
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 [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-capacity-reservation-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-capacity-reservation-topology.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2CapacityReservationTopology.html).
```
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 [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-capacity-reservation-topology.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-capacity-reservation-topology.html) 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](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2CapacityReservationTopology.html).
```
Get-EC2CapacityReservationTopology `
-Filter @{Name="instance-type"; Values="p5en.48xlarge"}
```
------