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 |
|
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 |
|
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 |
|
Sim |
|
|
Sim |
|
|
Sim |
|
|
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
aliyunpara 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
O Terraform é uma ferramenta open source para visualização prévia, configuração e gerenciamento de infraestrutura e recursos em nuvem. Assim como o Resource Orchestration Service (ROS), o Terraform interpreta modelos e chama operações de API conforme necessário. Para mais informações, consulte O que é o Terraform?
Para obter informações sobre como usar o Terraform para orquestrar recursos do ENS, consulte Integração de recursos usando Terraform.
-
Recursos suportados
Use o Terraform para gerenciar recursos do ENS, incluindo recursos regulares e de dados. Para mais informações sobre o Terraform, consulte O que é o Terraform?
Tipo de recurso
Nome do recurso
Descrição
Recursos
Fornece discos.ENS
Fornece anexos de instância de disco.ENS
Fornece endereços IP elásticos (EIPs).ENS
Fornece recursos de imagem.ENS
Fornece instâncias.ENS
Fornece anexos de grupo de segurança de instância.ENS
Fornece pares de chaves.ENS
Fornece balanceadores de carga.ENS
Fornece redes.ENS
Fornece grupos de segurança.ENS
Fornece snapshots.ENS
Fornece vSwitches.ENS
Fontes de dados
Fornece pares de chaves do usuário atual da Alibaba Cloud.ENS
ROS
O Resource Orchestration Service (ROS) simplifica o gerenciamento de recursos em nuvem. Crie modelos que descrevam os recursos necessários, como instâncias do Elastic Compute Service (ECS) e do ApsaraDB RDS, juntamente com suas dependências. O ROS cria e configura automaticamente todos os recursos para implantação e O&M automatizados. Para mais informações, consulte O que é o ROS?.
-
Use o ROS para chamar operações de API do ENS. Os recursos orquestráveis pelo ROS incluem recursos regulares e de dados.
-
Recursos regulares:
ALIYUN::ENS::Disk: crie um disco de dados por pagamento conforme o uso ou assinatura.
ALIYUN::ENS::DiskInstanceAttachment: anexa um disco de dados a uma instância ENS.
ALIYUN::ENS::Instance: crie uma instância ENS.
ALIYUN::ENS::InstanceSecurityGroupAttachment: adiciona uma instância ENS a um grupo de segurança.
ALIYUN::ENS::KeyPair: importa a chave pública de um par de chaves criptografado com Rivest-Shamir-Adleman (RSA).
ALIYUN::ENS::Network: crie uma virtual private cloud (VPC).
ALIYUN::ENS::NetworkAcl: crie uma lista de controle de acesso (ACL) de rede.
ALIYUN::ENS::NetworkAclAssociation: associa uma ACL a redes.
ALIYUN::ENS::SecurityGroup: crie um grupo de segurança.
ALIYUN::ENS::Snapshot: crie um snapshot.
ALIYUN::ENS::vSwitch: crie um vSwitch.
-
Recursos de dados:
DATASOURCE::ENS::Instances: consulta os detalhes das instâncias ENS.
-
Para obter informações sobre como usar o ROS para orquestrar recursos do ENS, consulte Integração de recursos usando 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.