Elastic Compute Service:Exemplos de chamada do ECS Java SDK V2.0

Pré-requisitos

1. O AccessKey de uma conta Alibaba Cloud fornece acesso total aos seus recursos, o que representa um alto risco de segurança em caso de vazamento. Recomendamos crie um usuário do Resource Access Management (RAM) e conceder a ele apenas as permissões necessárias. Em seguida, use o AccessKey desse usuário RAM para chamar operações de API. Para mais informações, consulte Criar um AccessKey.

2. Conceda ao usuário RAM permissões para gerencie recursos do ECS. O código de exemplo neste tópico mostra uma operação de consulta. Neste exemplo, utiliza-se a política de sistema AliyunECSReadonlyAccess. Você pode conceder permissões personalizadas conforme necessário.

   1. Use políticas personalizadas.

      Para mais informações sobre como crie políticas personalizadas, consulte Criar uma política personalizada e Informações de autorização.

      O ECS fornece exemplos de políticas personalizadas baseados em melhores práticas. Utilize esses exemplos para crie rapidamente políticas que atendam às necessidades do seu negócio. Para mais informações, consulte Políticas personalizadas.

   2. Use políticas de sistema.

      Para obter informações sobre todas as políticas de sistema suportadas pelo ECS e suas descrições de permissão, consulte Políticas de sistema para ECS.

3. Configure o AccessKey usando variáveis de ambiente. Para mais informações, consulte Configurar variáveis de ambiente em sistemas Linux, macOS e 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.aliyun.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.aliyun.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();
        }
    }
}

Exemplos baseados em cenários

• Crie múltiplas instâncias ECS

• Consultar uma lista de instâncias ECS

• Renovar uma instância ECS

• Liberar uma instância ECS

• Consultar recursos disponíveis para alterações de tipo de instância

• Consultar estoque de instâncias spot

• Consultar o preço atual de instâncias spot

• Crie uma instância spot

• Adicionar uma regra de grupo de segurança

• Crie um grupo de segurança e adicionar um recurso a ele

• Crie uma interface de rede elástica (ENI)

• Anexar uma ENI

• Desanexar uma ENI

• Exclua uma ENI

• Alterar o tipo de uma instância ECS

• Modifique o tipo de instância e a largura de banda pública de uma instância

• Obter um ou mais tipos alternativos de instância para um tipo especificado

• Melhores práticas para crie uma instância ECS usando um tipo alternativo de instância