# Topologia do Amazon EC2
<a name="ec2-instance-topology"></a>

A topologia do Amazon EC2 fornece uma visão hierárquica da proximidade relativa da capacidade de computação. Essas informações podem ser usadas para gerenciar, de forma escalável, a infraestrutura de computação voltada para computação de alta performance (HPC), machine learning (ML) e IA generativa.

**APIs disponíveis**

O Amazon EC2 fornece duas APIs para auxiliar na compreensão da topologia do EC2:
+ [DescribeInstanceTopology](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstanceTopology.html)
  + Mostra a localização das instâncias *em execução* na hierarquia da rede, apresentando como elas se relacionam entre si.
  + Auxilia na otimização da execução das workloads nas instâncias existentes.
+ [DescribeCapacityReservationTopology](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeCapacityReservationTopology.html)
  + Mostra a localização relativa da capacidade reservada em relação às demais capacidades na hierarquia da rede *antes de iniciar novas instâncias*.
  + Auxilia no planejamento da capacidade, permitindo que você saiba a localização da capacidade reservada antes de iniciar instâncias.

**Benefícios principais**

A topologia do EC2 fornece os seguintes benefícios principais:
+ Gerenciamento de capacidade: otimize o uso de recursos.
+ Agendamento de trabalhos: tome decisões informadas sobre a alocação de workloads.
+ Classificação de nós: compreenda a proximidade relativa para garantir a otimização da performance em instâncias fortemente acopladas.

**Considerações**
+ Os tipos de visualização de topologia estão disponíveis somente para:
  + Instâncias no estado `running`
  + Reservas de capacidade no estado `pending` ou `active`
+ Cada visualização de topologia é exclusiva para cada conta da Conta da AWS.
+ Não é possível visualizar a topologia com o Console de gerenciamento da AWS.
+ Embora as informações de topologia ajudem na compreensão do posicionamento das instâncias, você não pode usá-las para iniciar uma nova instância fisicamente próxima a uma instância existente. Para influenciar o posicionamento da instância, você pode [criar reservas de capacidade em grupos de posicionamento de cluster](cr-cpg.md).

**Preços**  
Você pode descrever a topologia do EC2 sem incorrer em custos adicionais.

**Topics**
+ [Como funciona](how-ec2-instance-topology-works.md)
+ [Pré-requisitos](ec2-instance-topology-prerequisites.md)
+ [Exemplos](ec2-instance-topology-examples.md)