Elastic Compute Service:ECS Java SDK V2.0 call examples

Requisitos previos

1. El AccessKey de una cuenta de Alibaba Cloud otorga acceso total a sus recursos, lo que representa un alto riesgo de seguridad si se filtra. Se recomienda crear un usuario de Resource Access Management (RAM) y concederle únicamente los permisos obligatorios. Posteriormente, utilice el AccessKey del usuario de RAM para invocar las operaciones de la API. Para obtener más información, consulte Create an AccessKey.

2. Ha otorgado al usuario de RAM permisos para gestionar recursos de ECS. El código de ejemplo en este tema muestra una operación de consulta. En este ejemplo se utiliza la directiva de sistema AliyunECSReadonlyAccess. Puede otorgar permisos personalizados según sea necesario.

   1. Utilice directivas personalizadas.

      Para obtener más información sobre cómo crear directivas personalizadas, consulte Create a custom policy y Authorization information.

      ECS proporciona ejemplos de directivas personalizadas basados en mejores prácticas. Puede utilizar estos ejemplos para crear rápidamente directivas personalizadas que satisfagan las necesidades de su negocio. Para obtener más información, consulte Custom policies.

   2. Utilice directivas de sistema.

      Para obtener información sobre todas las directivas de sistema compatibles con ECS y sus descripciones de permisos, consulte System policies for ECS.

3. Configure el AccessKey mediante variables de entorno. Para obtener más información, consulte Configure environment variables on Linux, macOS, and Windows systems.

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

Ejemplos por escenario

• Create multiple ECS instances

• Query a list of ECS instances

• Renew an ECS instance

• Release an ECS instance

• Query available resources for instance type changes

• Query spot instance inventory

• Query the current price of spot instances

• Create a spot instance

• Add a security group rule

• Create a security group and add a resource to it

• Create an elastic network interface (ENI)

• Attach an ENI

• Detach an ENI

• Delete an ENI

• Change an ECS instance type

• Modify the instance type and public bandwidth of an instance

• Obtain one or more alternative instance types for a specified instance type

• Best practices for creating an ECS instance using an alternative instance type