Elastic Compute Service:Exemples d'appels du SDK Java V2.0 pour ECS

Prérequis

1. La clé AccessKey d'un compte Alibaba Cloud offre un accès complet à vos ressources, ce qui présente un risque élevé pour la sécurité en cas de fuite. Nous vous recommandons de créer un utilisateur Resource Access Management (RAM) et de lui accorder uniquement les autorisations requises. Utilisez ensuite la clé AccessKey de l'utilisateur RAM pour appeler les opérations API. Pour plus d'informations, consultez Créer une clé AccessKey.

2. Accordez à l'utilisateur RAM les autorisations nécessaires pour gérer les ressources ECS. L'exemple de code fourni dans cette rubrique illustre une opération de requête. Dans cet exemple, la stratégie système AliyunECSReadonlyAccess est utilisée. Vous pouvez accorder des autorisations personnalisées selon vos besoins.

   1. Utilisez des stratégies personnalisées.

      Pour savoir comment créer des stratégies personnalisées, consultez les rubriques Créer une stratégie personnalisée et Informations sur l'autorisation.

      ECS propose des exemples de stratégies personnalisés basés sur les meilleures pratiques. Vous pouvez utiliser ces exemples pour créer rapidement des stratégies personnalisées adaptées à vos besoins métier. Pour plus d'informations, consultez la rubrique Stratégies personnalisées.

   2. Utilisez des stratégies système.

      Pour obtenir la liste complète des stratégies système prises en charge par ECS et leurs descriptions d'autorisations, consultez la rubrique Stratégies système pour ECS.

3. Configurez la clé AccessKey à l'aide de variables d'environnement. Pour plus d'informations, consultez la rubrique Configurer les variables d'environnement sur les systèmes Linux, macOS et Windows.

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>ecs20140526</artifactId>
  <version>5.3.0</version>
</dependency>

import com.aliyun.ecs20140526.Client;
import com.aliyun.teaopenapi.models.Config;

public class Sample {
    private static Client createClient() throws Exception {
        Config config = new Config()
                // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is set.
                .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is set.
                .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"))
                // For the endpoint, see https://api.alibabacloud.com/product/Ecs
                .setEndpoint("ecs.cn-hangzhou.aliyuncs.com");
        return new Client(config);
    }
}

// Create a request object.
DescribeInstancesRequest request = new DescribeInstancesRequest().setRegionId("cn-hangzhou");

// Set runtime parameters.
RuntimeOptions runtime = new RuntimeOptions();
// Call the DescribeInstances API operation.
DescribeInstancesResponse response = client.describeInstancesWithOptions(request, runtime);
System.out.println(response.body.toMap());

import com.aliyun.ecs20140526.Client;
import com.aliyun.ecs20140526.models.DescribeInstancesRequest;
import com.aliyun.ecs20140526.models.DescribeInstancesResponse;
import com.aliyun.tea.TeaException;
import com.aliyun.tea.TeaUnretryableException;
import com.aliyun.teaopenapi.models.Config;
import com.aliyun.teautil.models.RuntimeOptions;

public class Sample {
    private static Client createClient() throws Exception {
        Config config = new Config()
                // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is set.
                .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is set.
                .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"))
                // For the endpoint, see https://api.alibabacloud.com/product/Ecs
                .setEndpoint("ecs.cn-hangzhou.aliyuncs.com");
        return new Client(config);
    }

    public static void main(String[] args) {
        try {
            Client client = Sample.createClient();
            // Create a request object.
            DescribeInstancesRequest request = new DescribeInstancesRequest()
                    .setRegionId("cn-hangzhou");
            // Set runtime parameters.
            RuntimeOptions runtime = new RuntimeOptions();
            // Call the DescribeInstances API operation.
            DescribeInstancesResponse response = client.describeInstancesWithOptions(request, runtime);
            System.out.println(response.body.toMap());
        } catch (TeaUnretryableException ue) {
            // This is for printing and demonstration purposes only. Handle exceptions with care. Do not ignore exceptions in your projects.
            ue.printStackTrace();
            // Print the error message.
            System.out.println(ue.getMessage());
            // Print the request record to query the request information when the error occurred.
            System.out.println(ue.getLastRequest());
        } catch (TeaException e) {
            // This is for printing and demonstration purposes only. Handle exceptions with care. Do not ignore exceptions in your projects.
            e.printStackTrace();
            // Print the error code.
            System.out.println(e.getCode());
            // Print the error message, which includes the RequestId.
            System.out.println(e.getMessage());
            // Print the specific error content returned by the server.
            System.out.println(e.getData());
        } catch (Exception e) {
            // This is for printing and demonstration purposes only. Handle exceptions with care. Do not ignore exceptions in your projects.
            e.printStackTrace();
        }
    }
}

Exemples par scénario

• Créer plusieurs instances ECS

• Interroger une liste d'instances ECS

• Renouveler une instance ECS

• Libérer une instance ECS

• Interroger les ressources disponibles pour les modifications de type d'instance

• Interroger l'inventaire des instances spot

• Interroger le prix actuel des instances spot

• Créer une instance spot

• Ajouter une règle de groupe de sécurité

• Créer un groupe de sécurité et y ajouter une ressource

• Créer une interface réseau élastique (ENI)

• Attacher une ENI

• Détacher une ENI

• Supprimer une ENI

• Modifier le type d'une instance ECS

• Modifier le type d'instance et la bande passante publique d'une instance

• Obtenir un ou plusieurs types d'instance alternatifs pour un type d'instance spécifié

• Meilleures pratiques pour créer une instance ECS à l'aide d'un type d'instance alternatif