# Amazon EC2 トポロジー
<a name="ec2-instance-topology"></a>

Amazon EC2 トポロジーは、コンピューティングキャパシティの相対的な近接性を階層的に示します。この情報を使用して、ハイパフォーマンスコンピューティング (HPC)、機械学習 (ML)、生成 AI のコンピューティングインフラストラクチャを大規模に管理できます。

**使用可能な API**

Amazon EC2 では、EC2 トポロジーを把握するための API が 2 つ用意されています。
+ [DescribeInstanceTopology](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstanceTopology.html)
  + *実行中*のインスタンスがネットワーク階層内で配置されている場所を相互に相対的に示します。
  + 既存のインスタンスでワークロードを実行する場所を最適化するのに役立ちます。
+ [DescribeCapacityReservationTopology](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeCapacityReservationTopology.html)
  + *インスタンスを起動する前に*、リザーブドキャパシティがネットワーク階層内で配置される場所を相互に相対的に示します。
  + インスタンスを起動する前にリザーブドキャパシティの配置を知らせることで、キャパシティプランニングを支援します。

**主な利点**

EC2 トポロジーには、主に以下のような利点があります。
+ キャパシティ管理 – リソース使用率を最適化できます。
+ ジョブスケジューリング – ワークロードの配置について、情報に基づいた意思決定を行えます。
+ ノードランキング — 緊密に結合されたインスタンスでパフォーマンスを最適化するための相対的な近接性を理解できます。

**考慮事項**
+ トポロジービューは次の場合にのみ使用できます。
  + インスタンスが `running` の状態である
  + キャパシティ予約が `pending` または `active` で状態にある
+ 各トポロジービューは AWS アカウントごとに一異なります。
+ AWS マネジメントコンソールではトポロジーの表示はサポートされていません。
+ トポロジー情報はインスタンスの配置を理解するのに役立ちますが、既存のインスタンスに物理的に近い新しいインスタンスを起動するために使用することはできません。インスタンスの配置に影響を与えるには[クラスタープレイスメントグループでキャパシティ予約を作成](cr-cpg.md)できます。

**料金**  
EC2 トポロジーを記述するのに追加のコストはかかりません。

**Topics**
+ [仕組み](how-ec2-instance-topology-works.md)
+ [前提条件](ec2-instance-topology-prerequisites.md)
+ [例](ec2-instance-topology-examples.md)