Alibaba Cloud SDK:Intégration du SDK Alibaba Cloud V1.0 pour Java

SDK du service cloud

Le SDK d'un service cloud inclut l'objet de requête nécessaire à l'appel des opérations d'API et l'objet de réponse. Dans cet exemple, le SDK Elastic Compute Service (ECS) V1.0 pour Java est configuré en tant que dépendance Maven. Le code suivant illustre cette dépendance Maven.

<dependencies>
  <!--  ecs V1.0 SDK  -->
  <dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-ecs</artifactId>
    <version>5.11.7</version>
  </dependency>
</dependencies>

Le SDK V1.0 pour Java d'un service Alibaba Cloud suit le format de nommage aliyun-java-sdk-${Code du service}. Vous pouvez également consulter les informations relatives au SDK V1.0 pour Java d'un service Alibaba Cloud spécifique dans le SDK Center.

Bibliothèque principale d'un SDK

La bibliothèque principale d'un SDK comprend l'objet client, la logique de signature et la logique de gestion des erreurs, éléments indispensables pour appeler des opérations d'API. Nous vous recommandons de configurer la bibliothèque principale du SDK en tant que dépendance Maven. Le code suivant illustre cette dépendance Maven.

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>4.7.3</version>
</dependency>

Pour plus d'informations sur la version de la bibliothèque principale, consultez le dépôt Maven Repository: com.aliyun » aliyun-java-sdk-core.

1. Initialiser un client de requête

Toutes les opérations d'API s'effectuent via l'objet Client fourni par la bibliothèque principale. Avant d'appeler une opération d'API, initialisez un client de requête. Dans cet exemple, le client de requête est initialisé à l'aide d'une paire AccessKey. Pour plus d'informations, consultez la rubrique Gérer les identifiants d'accès.

com.aliyuncs.profile.DefaultProfile profile = com.aliyuncs.profile.DefaultProfile.getProfile(
        "<REGION_ID>",
        // Obtain the AccessKey ID of the Resource Access Management (RAM) user from an environment variable.
        System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),
        // Obtain the AccessKey secret of the RAM user from an environment variable.
        System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
com.aliyuncs.IAcsClient client = new com.aliyuncs.DefaultAcsClient(profile);

2. Créer un objet de requête

Utilisez l'objet de requête fourni par le SDK pour encapsuler les paramètres de la requête.

com.aliyuncs.ecs.model.v20140526.DescribeInstancesRequest request = new com.aliyuncs.ecs.model.v20140526.DescribeInstancesRequest();
request.setRegionId("cn-hangzhou");
request.setInstanceIds(new com.google.gson.Gson().toJson(Arrays.asList("i-bp1fq61ktxxxxxxxxxxxx","i-bp1fq62ktxxxxxxxxxxxx")));

3. Envoyer une requête API

Utilisez le client de requête créé à l'étape 1 pour appeler l'opération getAcsResponse. Les paramètres de requête de cette opération correspondent à l'objet de requête créé à l'étape 2. Si l'appel aboutit, un objet de réponse est renvoyé.

com.aliyuncs.ecs.model.v20140526.DescribeInstancesResponse response = client.getAcsResponse(request);
System.out.println(new com.google.gson.Gson().toJson(response));

4. Gérer les erreurs

Si une erreur se produit lors de l'appel d'une opération d'API, interceptez les exceptions ServerException et ClientException pour obtenir le message d'erreur. La plupart du temps, les erreurs ClientException sont causées par des paramètres invalides lors de l'initialisation du client, tels que des paramètres AccessKey incorrects. Les erreurs ServerException peuvent avoir plusieurs causes. Contactez le service clientèle pour le dépannage en fournissant l'ID de la requête.