Todos los productos
Search
Centro de documentos

:SDK de Alibaba Cloud

Última actualización: Sep 04, 2026

Este tema describe cómo usar los SDK de los servicios de Alibaba Cloud para invocar operaciones de API.

SDK de Alibaba Cloud

Alibaba Cloud ofrece SDK en varios lenguajes de programación, como Java, C#, Go, Python, TypeScript + Node.js, PHP y C++. Puede invocar las operaciones de API directamente mediante los SDK integrados en sus aplicaciones. Los SDK encapsulan información que incluye la lógica de firma, el mecanismo de tiempo de espera y el mecanismo de reintentos. Además, devuelven objetos de respuesta estructurados según las especificaciones, lo cual facilita el trabajo de los desarrolladores.

Para obtener más información sobre los SDK de Alibaba Cloud, consulte Alibaba Cloud SDKs.

Método de integración

  1. Visite OpenAPI Explorer. Pase el puntero sobre image.png en la barra de navegación superior y localice el servicio obligatorio.

  2. En la sección SDK Examples, haga clic en el lenguaje de programación que usa.

  3. Consulte el método de instalación del SDK y el código de ejemplo para integrar el SDK.

Comparación entre V2.0 y V1.0

El SDK de Alibaba Cloud V2.0 admite más lenguajes y escenarios más complejos en operaciones de API que el SDK de Alibaba Cloud V1.0. La versión V2.0 admite llamadas asíncronas y síncronas, y ha resuelto algunos problemas heredados de la V1.0. Asimismo, ofrece funciones más flexibles y potentes. Se recomienda usar el SDK de Alibaba Cloud V2.0. Para obtener más información, consulte Alibaba Cloud SDK V1.0 and V2.0.

Nota

Para proyectos nuevos, se recomienda usar la V2.0. En proyectos donde ya se usa la V1.0, se sugiere actualizar a la V2.0.

Ejemplo de integración

En este ejemplo, se integra el SDK de Elastic Compute Service (ECS) para Java y se usa para invocar la operación DescribeInstance.

V2.0

El SDK de Alibaba Cloud V2.0 incluye la información principal necesaria para las operaciones de API, como el procesamiento de parámetros, el ensamblaje de solicitudes y el manejo de respuestas. Los desarrolladores pueden invocar operaciones de API con solo instalar el paquete de dependencias del SDK, sin necesidad de depender de la biblioteca central.

Dependencia

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

Código de ejemplo

// 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

Dependencias

Es necesario instalar la biblioteca central del SDK, la cual incluye solicitudes HTTP, información de autenticación, algoritmos de firma y manejo de excepciones.

<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>

Código de ejemplo

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());
        }

    }
}