Use regions and availability zones
Describe regions
To list the Regions available to your account, call the Ec2Client’s describeRegions
method. It returns a DescribeRegionsResponseregions
method to get a list of Region
Imports
import software.amazon.awssdk.services.ec2.Ec2Client; import software.amazon.awssdk.services.ec2.model.DescribeRegionsResponse; import software.amazon.awssdk.services.ec2.model.Region; import software.amazon.awssdk.services.ec2.model.AvailabilityZone; import software.amazon.awssdk.services.ec2.model.Ec2Exception; import software.amazon.awssdk.services.ec2.model.DescribeAvailabilityZonesResponse;
Code
try { DescribeRegionsResponse regionsResponse = ec2.describeRegions(); for(Region region : regionsResponse.regions()) { System.out.printf( "Found Region %s " + "with endpoint %s", region.regionName(), region.endpoint()); System.out.println();
See the complete example
Describe availability zones
To list each Availability Zone available to your account, call the Ec2Client’s
describeAvailabilityZones
method. It returns a
DescribeAvailabilityZonesResponseavailabilityZones
method to get a list of AvailabilityZone
Imports
import software.amazon.awssdk.services.ec2.Ec2Client; import software.amazon.awssdk.services.ec2.model.DescribeRegionsResponse; import software.amazon.awssdk.services.ec2.model.Region; import software.amazon.awssdk.services.ec2.model.AvailabilityZone; import software.amazon.awssdk.services.ec2.model.Ec2Exception; import software.amazon.awssdk.services.ec2.model.DescribeAvailabilityZonesResponse;
Code
Create the Ec2Client.
Ec2Client ec2 = Ec2Client.create();
Then call describeAvailabilityZones() and retrieve results.
DescribeAvailabilityZonesResponse zonesResponse = ec2.describeAvailabilityZones(); for(AvailabilityZone zone : zonesResponse.availabilityZones()) { System.out.printf( "Found Availability Zone %s " + "with status %s " + "in region %s", zone.zoneName(), zone.state(), zone.regionName()); System.out.println();
See the complete example
Describe accounts
To describe your account, call the Ec2Client’s describeAccountAttributes
method. This method returns a DescribeAccountAttributesResponseaccountAttributes
method to get a list of AccountAttribute
You can
get your account’s attribute values by invoking the AccountAttributeattributeValues
method. This method returns a list of AccountAttributeValue
Imports
import software.amazon.awssdk.services.ec2.Ec2Client; import software.amazon.awssdk.services.ec2.model.DescribeRegionsResponse; import software.amazon.awssdk.services.ec2.model.Region; import software.amazon.awssdk.services.ec2.model.AvailabilityZone; import software.amazon.awssdk.services.ec2.model.Ec2Exception; import software.amazon.awssdk.services.ec2.model.DescribeAvailabilityZonesResponse;
Code
try { DescribeRegionsResponse regionsResponse = ec2.describeRegions(); for(Region region : regionsResponse.regions()) { System.out.printf( "Found Region %s " + "with endpoint %s", region.regionName(), region.endpoint()); System.out.println();
See the complete example
More information
-
Regions and Availability Zones in the Amazon EC2 User Guide for Linux Instances
-
DescribeRegions in the Amazon EC2 API Reference
-
DescribeAvailabilityZones in the Amazon EC2 API Reference