Zones d'utilisation Régions AWS et de disponibilité

Décrire des régions

Pour répertorier les régions disponibles sur votre compte, appelez la méthode Ec2ClientdescribeRegions. Elle renvoie un DescribeRegionsResponse. Appelez la méthode regions de l'objet renvoyé pour obtenir une liste d'objets Region qui représentent chaque région.

Importations

import software.amazon.awssdk.services.ec2.Ec2Client;
import software.amazon.awssdk.services.ec2.model.DescribeRegionsResponse;
import software.amazon.awssdk.services.ec2.model.DescribeAvailabilityZonesResponse;
import software.amazon.awssdk.services.ec2.model.Ec2Exception;

Code

        try {
            DescribeRegionsResponse regionsResponse = ec2.describeRegions();
            regionsResponse.regions().forEach(region -> {
                System.out.printf(
                    "Found Region %s with endpoint %s%n",
                    region.regionName(),
                    region.endpoint());
                System.out.println();
            });

Consultez l'exemple complet sur GitHub.

Décrire les zones de disponibilité

Pour répertorier chaque zone de disponibilité disponible pour votre compte, appelez la méthode Ec2ClientdescribeAvailabilityZones. Elle renvoie un DescribeAvailabilityZonesResponse. Appelez sa availabilityZones méthode pour obtenir une liste d'AvailabilityZoneobjets représentant chaque zone de disponibilité.

Importations

import software.amazon.awssdk.services.ec2.Ec2Client;
import software.amazon.awssdk.services.ec2.model.DescribeRegionsResponse;
import software.amazon.awssdk.services.ec2.model.DescribeAvailabilityZonesResponse;
import software.amazon.awssdk.services.ec2.model.Ec2Exception;

Code

Créez le client Ec2.

        software.amazon.awssdk.regions.Region region = software.amazon.awssdk.regions.Region.US_EAST_1;
        Ec2Client ec2 = Ec2Client.builder()
            .region(region)
            .build();

Appelez ensuite describeAvailabilityZones () et récupérez les résultats.

            DescribeAvailabilityZonesResponse zonesResponse = ec2.describeAvailabilityZones();
            zonesResponse.availabilityZones().forEach(zone -> {
                System.out.printf(
                    "Found Availability Zone %s with status %s in region %s%n",
                    zone.zoneName(),
                    zone.state(),
                    zone.regionName()
                );
                System.out.println();
            });

Consultez l'exemple complet sur GitHub.

Décrire les comptes

Pour répertorier les informations relatives à EC2 concernant votre compte, appelez la méthode Ec2Client. describeAccountAttributes Cette méthode renvoie un DescribeAccountAttributesResponseobjet. Invoquez cette accountAttributes méthode d'objets pour obtenir une liste d'AccountAttributeobjets. Vous pouvez parcourir la liste pour récupérer un AccountAttribute objet.

Vous pouvez obtenir les valeurs d'attribut de votre compte en invoquant la attributeValues méthode de AccountAttribute l'objet. Cette méthode renvoie une liste d'AccountAttributeValueobjets. Vous pouvez parcourir cette deuxième liste pour afficher la valeur des attributs (voir l'exemple de code ci-dessous).

Importations

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.ec2.Ec2Client;
import software.amazon.awssdk.services.ec2.model.DescribeAccountAttributesResponse;
import software.amazon.awssdk.services.ec2.model.Ec2Exception;

Code

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.ec2.Ec2Client;
import software.amazon.awssdk.services.ec2.model.DescribeAccountAttributesResponse;
import software.amazon.awssdk.services.ec2.model.Ec2Exception;

/**
 * Before running this Java V2 code example, set up your development
 * environment, including your credentials.
 *
 * For more information, see the following documentation topic:
 *
 * https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
 */
public class DescribeAccount {
    public static void main(String[] args) {
        Region region = Region.US_EAST_1;
        Ec2Client ec2 = Ec2Client.builder()
                .region(region)
                .build();

        describeEC2Account(ec2);
        System.out.print("Done");
        ec2.close();
    }

    public static void describeEC2Account(Ec2Client ec2) {
        try {
            DescribeAccountAttributesResponse accountResults = ec2.describeAccountAttributes();
            accountResults.accountAttributes().forEach(attribute -> {
                System.out.print("\n The name of the attribute is " + attribute.attributeName());
                attribute.attributeValues().forEach(
                        myValue -> System.out.print("\n The value of the attribute is " + myValue.attributeValue()));
            });

        } catch (Ec2Exception e) {
            System.err.println(e.awsErrorDetails().errorMessage());
            System.exit(1);
        }
    }
}

Consultez l'exemple complet sur GitHub.

En savoir plus

• Régions et zones de disponibilité dans le guide de Amazon EC2 l'utilisateur pour les instances Linux

• DescribeRegionsdans la référence de Amazon EC2 l'API

• DescribeAvailabilityZonesdans la référence de Amazon EC2 l'API