Tous les produits
Search
Centre de documentation

:SDK Alibaba Cloud

Dernière mise à jour :Aug 11, 2026

Cette rubrique explique comment utiliser les SDK des services Alibaba Cloud pour appeler des opérations d'API.

SDK Alibaba Cloud

Alibaba Cloud met à disposition des SDK dans plusieurs langages de programmation, notamment Java, C#, Go, Python, TypeScript + Node.js, PHP et C++. Les SDK intégrés à vos applications permettent d'appeler directement les opérations d'API. Ils encapsulent la logique de signature, ainsi que les mécanismes de délai d'expiration et de nouvelle tentative, et renvoient des objets de réponse structurés conformes aux spécifications, ce qui simplifie le travail des développeurs.

Pour plus d'informations sur les SDK Alibaba Cloud, consultez la rubrique SDK Alibaba Cloud.

Méthode d'intégration

  1. Accédez au portail OpenAPI Explorer. Placez le pointeur sur image.png dans la barre de navigation supérieure et recherchez le service requis.

  2. Dans la section SDK Examples, cliquez sur le langage de programmation utilisé.

  3. Consultez la méthode d'installation du SDK et l'exemple de code pour l'intégrer.

Comparaison entre les versions 2.0 et 1.0

Le SDK Alibaba Cloud V2.0 prend en charge davantage de langages et des scénarios d'opérations d'API plus complexes que le SDK Alibaba Cloud V1.0. La version 2.0 prend en charge les appels asynchrones et synchrones et résout certains problèmes hérités de la version 1.0. Elle offre des fonctionnalités plus flexibles et plus puissantes. Nous vous recommandons d'utiliser le SDK Alibaba Cloud V2.0. Pour plus d'informations, consultez la rubrique SDK Alibaba Cloud V1.0 et V2.0.

Remarque

Pour les nouveaux projets, nous vous recommandons d'utiliser la version 2.0. Pour les projets utilisant déjà la version 1.0, il est conseillé de mettre à niveau vers la version 2.0.

Exemple d'intégration

Cet exemple illustre l'intégration et l'utilisation du SDK Elastic Compute Service (ECS) pour Java afin d'appeler l'opération DescribeInstance.

V2.0

Le SDK Alibaba Cloud V2.0 inclut les informations principales utilisées pour les opérations d'API, telles que le traitement des paramètres, l'assemblage des requêtes et le traitement des réponses. Les développeurs peuvent appeler des opérations d'API en installant simplement le package de dépendance du SDK, sans avoir besoin de s'appuyer sur la bibliothèque centrale.

Dépendance

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

Exemple de code

// This file is auto-generated, don't edit it. Thanks.
package com.aliyun.sample;

import com.aliyun.tea.*;

public class Sample {

    /**
     * Use your AccessKey ID and AccessKey secret to initialize the client.
     * @param accessKeyId
     * @param accessKeySecret
     * @return Client
     * @throws Exception
     */
    public static com.aliyun.ecs20140526.Client createClient(String accessKeyId, String accessKeySecret) throws Exception {
        com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config()
                // Required. Specify your AccessKey ID.
                .setAccessKeyId(accessKeyId)
                // Required. Specify your AccessKey secret.
                .setAccessKeySecret(accessKeySecret);
        // Specify the endpoint.
        config.endpoint = "ecs-cn-hangzhou.aliyuncs.com";
        return new com.aliyun.ecs20140526.Client(config);
    }

    public static void main(String[] args_) throws Exception {
        java.util.List<String> args = java.util.Arrays.asList(args_);
        // Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variables are configured. 
        // If the project code is leaked, the AccessKey pair may be disclosed, which compromises the security of resources in your account. The following sample code obtains the AccessKey pair from environment variables. This example is for reference only. We recommend that you use Security Token Service (STS) to initialize SDK clients, which is more secure. For more information about authentication solutions, see the "Manage access credentials" topic for Alibaba Cloud SDK for Java.
        com.aliyun.ecs20140526.Client client = Sample.createClient(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"), System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
        com.aliyun.ecs20140526.models.RunInstancesRequest runInstancesRequest = new com.aliyun.ecs20140526.models.RunInstancesRequest();
        com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
        try {
            // If you copy and run the sample code, write your own code to display the response of the API operation.
            client.runInstancesWithOptions(runInstancesRequest, runtime);
        } catch (TeaException error) {
            // Display the error based on your business requirements.
            com.aliyun.teautil.Common.assertAsString(error.message);
        } catch (Exception _error) {
            TeaException error = new TeaException(_error.getMessage(), _error);
            // Display the error based on your business requirements.
            com.aliyun.teautil.Common.assertAsString(error.message);
        }        
    }
}

V1.0

Dépendances

La bibliothèque centrale du SDK doit être installée. Elle inclut les requêtes HTTP, les informations d'authentification, les algorithmes de signature et la gestion des exceptions.

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>aliyun-java-sdk-core</artifactId>
  <version>4.6.1</version>
</dependency>
<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>aliyun-java-sdk-ecs</artifactId>
  <version>5.11.5</version>
</dependency>

Exemple de code

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.profile.DefaultProfile;
import java.util.*;
import com.aliyuncs.ecs.model.v20140526.*;

public class DescribeInstances {

    public static void main(String[] args) {
        // Create and initialize a DefaultAcsClient instance. 
        DefaultProfile profile = DefaultProfile.getProfile("cn-hangzhou", System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"), System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
        IAcsClient client = new DefaultAcsClient(profile);

        // Create an API request and configure the required parameters. 
        DescribeInstancesRequest request = new DescribeInstancesRequest();
        request.setRegionId("cn-hangzhou");
        request.setInstanceNetworkType("vpc");
        request.setInstanceChargeType("PostPaid");
        request.setInternetChargeType("PayByTraffic");
        request.setPageSize(10);

        try {
        // Initiate the request and handle the response or exception. 
            DescribeInstancesResponse response = client.getAcsResponse(request);
        for (DescribeInstancesResponse.Instance instance:response.getInstances()) 
            {
                 System.out.println(instance.getImageId());
                 System.out.println(instance.getInstanceId());
                 System.out.println(instance.getPublicIpAddress());
             }
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            System.out.println("ErrCode:" + e.getErrCode());
            System.out.println("ErrMsg:" + e.getErrMsg());
            System.out.println("RequestId:" + e.getRequestId());
        }

    }
}