Todos os produtos
Search
Central de documentação

ENS:Visão geral da integração

Última atualização: Jun 27, 2026

O ENS oferece suporte a diversos métodos de integração, incluindo SDKs, CLI, Terraform e ROS. Use esses métodos para automatizar o gerenciamento de recursos do ENS e aumentar a eficiência do desenvolvimento.

Visão geral do OpenAPI Explorer

O OpenAPI Explorer é um portal completo para operações de API da Alibaba Cloud. Ele oferece pesquisa inteligente, documentação, depuração online, downloads de SDK, códigos de exemplo, diagnóstico de erros e estatísticas de chamadas. É possível chamar operações de API, visualizar solicitações e respostas, além de gerar códigos de exemplo de SDK diretamente no portal.

Para mais informações, consulte Visão geral.

Descrição da versão

Versão da API

Descrição

2017-11-10

Recomendamos o uso desta versão.

Depuração online

O ENS permite a depuração de APIs no OpenAPI Explorer. Antes de chamar operações de API, revise as seguintes informações específicas do ENS: versões, endpoints, estilos de API e métodos de chamada.

Na página do ENS no OpenAPI Explorer, o painel de navegação à esquerda lista categorias de serviços como instâncias, discos, snapshots, imagens, grupos de segurança e redes. No painel central, configure os parâmetros da API, selecione um endereço de serviço, como China (Hangzhou), e insira os parâmetros da solicitação. O painel direito exibe a documentação da API — incluindo informações sobre limites de taxa da API, parâmetros de solicitação e parâmetros de resposta — nas abas Documentation, Debugging Result, SDK Sample e CLI Sample.

Depuração

Acesse o portal de depuração da API do ENS.

Endpoints

Use o endpoint da região de Singapura ens.ap-southeast-1.aliyuncs.com.

Para mais informações, consulte Endpoints.

Identidades

Por padrão, o OpenAPI Explorer usa sua conta Alibaba Cloud para depuração online. Como uma conta Alibaba Cloud possui permissões totais de API, seu uso direto pode apresentar riscos de segurança. Recomendamos o uso de um usuário do Resource Access Management (RAM). Antes de chamar operações de API como usuário RAM, conceda as permissões necessárias com base nos requisitos do seu negócio. O usuário RAM deve ter permissões para gerenciar recursos do ENS. Para mais informações, consulte Políticas de sistema para ENS.

Identidade

Suporte

Conta Alibaba Cloud

Sim

Usuário RAM (recomendado)

Sim

Função RAM (recomendado)

Sim

Recomendamos conceder apenas as permissões mínimas necessárias a um usuário RAM ou função RAM e usar essa identidade para chamar operações de API.

Referências

Métodos de integração

Métodos de chamada

Método de chamada

Suporte

SDKs da Alibaba Cloud (recomendado)

Sim

CLI da Alibaba Cloud

Sim

Terraform

Sim

ROS

Sim

Encapsulamento personalizado de API

Sim

SDKs da Alibaba Cloud

  • Os SDKs da Alibaba Cloud estão disponíveis em Java, C#, Go, Python, TypeScript, Node.js, PHP e C++. Esses SDKs encapsulam a lógica de assinatura, o tratamento de tempo limite e os mecanismos de nova tentativa, retornando objetos de resposta estruturados. Para mais informações, consulte SDKs da Alibaba Cloud.

  • Use os SDKs da Alibaba Cloud para chamar APIs do ENS. Para idiomas suportados e instruções de instalação, consulte a Central de SDK do ENS.

CLI da Alibaba Cloud

  • Use a CLI da Alibaba Cloud para chamar operações de API do ENS. Para mais informações, consulte Comandos de exemplo.

  • Execute comandos aliyun para interagir com os serviços da Alibaba Cloud e gerenciar recursos de serviços em nuvem. Para mais informações, consulte O que é a CLI da Alibaba Cloud?

Terraform

ROS

Encapsulamento personalizado de API

Para fazer chamadas HTTP nativas, construa e assine as solicitações manualmente. Para mais informações, consulte Lista de operações por função e Sintaxe de solicitação e método de assinatura V3.

Notas de uso

Se uma chamada de API falhar, verifique o código de erro retornado em relação aos parâmetros da sua solicitação. Para mais informações, consulte a Central de Códigos de Erro.

Use também o RequestID retornado ou a mensagem de erro do SDK na plataforma de diagnóstico da OpenAPI da Alibaba Cloud para diagnósticos de autoatendimento.