Prerequisites for Amazon EC2 topology - Amazon Elastic Compute Cloud
Amazon Web Services RegionsInstance typesStateIAM permissions
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Prerequisites for Amazon EC2 topology

To describe your Amazon EC2 topology, ensure that your instances and Capacity Reservations meet the following prerequisites.

Amazon Web Services Regions

Supported Amazon Web Services Regions:

  • US East (N. Virginia), US East (Ohio), US West (N. California), US West (Oregon)

  • Africa (Cape Town)

  • Asia Pacific (Jakarta), Asia Pacific (Hong Kong), Asia Pacific (Hyderabad), Asia Pacific (Melbourne), Asia Pacific (Mumbai), Asia Pacific (Osaka), Asia Pacific (Seoul), Asia Pacific (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo)

  • Canada (Central)

  • Europe (Frankfurt), Europe (Ireland), Europe (London), Europe (Paris), Europe (Spain), Europe (Stockholm), Europe (Zurich)

  • Israel (Tel Aviv)

  • Middle East (Bahrain), Middle East (UAE)

  • South America (São Paulo)

  • Amazon GovCloud (US-West)

The DescribeCapacityReservationTopology API is not supported in Israel (Tel Aviv) and Amazon GovCloud (US-West).

Instance types

Supported instance types:

  • Returns 3* network nodes in the response

    • g6e.xlarge | g6e.2xlarge | g6e.4xlarge | g6e.8xlarge | g6e.12xlarge | g6e.16xlarge | g6e.24xlarge | g6e.48xlarge

    • hpc6a.48xlarge | hpc6id.32xlarge | hpc7a.12xlarge | hpc7a.24xlarge | hpc7a.48xlarge | hpc7a.96xlarge | hpc7g.4xlarge | hpc7g.8xlarge | hpc7g.16xlarge

    • p3dn.24xlarge | p4d.24xlarge | p4de.24xlarge | p5.48xlarge | p5e.48xlarge | p5en.48xlarge | p6e-gb200.36xlarge

    • trn1.2xlarge | trn1.32xlarge | trn1n.32xlarge | trn2.48xlarge | trn2u.48xlarge

  • Returns 4* network nodes in the response

    • p6-b200.48xlarge | p6-b300.48xlarge

* The number of network nodes returned is only applicable when using the DescribeInstanceTopology API. For the DescribeCapacityReservationTopology API, the number of network nodes returned will vary depending on the type and state of the Capacity Reservation.

The available instance types vary by Region. For more information, see Amazon EC2 instance types by Region.

State

  • For DescribeInstanceTopology – Instances must be in the running state.

  • For DescribeCapacityReservationTopology – Capacity Reservations must be in the pending or active state.

You can’t get topology information for instances or Capacity Reservations in any other state.

IAM permissions

Your IAM identity (user, user group, or role) requires the following permissions:

  • ec2:DescribeInstanceTopology

  • ec2:DescribeCapacityReservationTopology