O Database Autonomy Service (DAS) oferece um console visual e diversos métodos de integração, incluindo OpenAPI Explorer, Alibaba Cloud SDK, Terraform e Resource Orchestration Service (ROS). Escolha o método mais adequado às suas necessidades.
Terraform,
OpenAPI Explorer
O OpenAPI Explorer é uma plataforma que integra busca de APIs, documentação, depuração online, exemplos de código SDK, diagnóstico de erros e estatísticas de chamadas. Chame APIs de vários serviços da Alibaba Cloud, visualize solicitações e respostas e utilize exemplos de SDK gerados automaticamente para começar rapidamente. Para mais informações, consulte O que é o OpenAPI.
Versões
A OpenAPI da Alibaba Cloud utiliza números de versão para gerenciar as APIs de diferentes versões principais dos produtos. Por exemplo, o Database Autonomy Service (DAS) suporta atualmente a versão da API 2020-01-16. A string 2020-01-16 representa o número da versão da API, não uma data. Esta versão fornece os dados mais recentes da API pública e não significa que a API permaneceu estática desde 2020-01-16.
|
Número da versão |
Descrição |
|
Recomendada. |
Depuração online
O Database Autonomy Service (DAS) permite depurar APIs no OpenAPI Explorer. Antes de chamar uma API, revise as informações sobre versão, endpoint e método de integração.
No OpenAPI Explorer, o painel de navegação à esquerda lista as APIs por categoria (por exemplo, AddHDMInstance em Instance Access). No painel central, selecione uma região (como China (Shanghai)) e configure os parâmetros da solicitação. Clique em Initiate Call para depurar a API online. O painel à direita exibe a documentação da API, exemplos de SDK e os resultados da chamada.
Portal de depuração
Para depurar APIs, acesse a página de depuração online.
Endpoints
O endpoint de serviço do Database Autonomy Service (DAS) está disponível atualmente apenas na região China (Shanghai). O endpoint público é das.cn-shanghai.aliyuncs.com.
O endpoint público tem acessibilidade global.
-
Uma Virtual Private Cloud (VPC) é uma rede virtual isolada. O uso de um endpoint de VPC oferece os seguintes benefícios:
Alta segurança: os endpoints de VPC são acessíveis apenas de dentro da VPC, o que aumenta a segurança e a privacidade.
Tempos de resposta mais rápidos: ao usar a rede interna, os endpoints de VPC respondem mais rapidamente que os endpoints públicos, evitando latência e limites de largura de banda da rede pública.
Custo reduzido: a comunicação por endpoints de VPC ocorre pela rede interna, o que pode diminuir os custos de transferência de dados.
Identidades de usuário suportadas
Por padrão, o OpenAPI Explorer utiliza as permissões da conta da Alibaba Cloud conectada, que tem acesso total à API e apresenta riscos de segurança. Recomendamos criar um usuário RAM para acesso à API e operações diárias de O&M. Conceda ao usuário RAM as permissões necessárias para gerenciar recursos do DAS. Para mais informações, consulte Como usar o DAS como usuário RAM?
|
Identidade de usuário |
Suporte |
|
Sim |
|
|
Usuário RAM (Recomendado) |
Sim |
|
Função RAM (Recomendado) |
Sim |
Mais informações
Métodos de integração
O Database Autonomy Service (DAS) suporta dois métodos de integração: Alibaba Cloud SDK e encapsulamento personalizado.
|
Método de integração |
Suporte |
|
Sim |
|
|
Não |
|
|
Não |
|
|
Não |
|
|
Encapsulamento personalizado |
Sim |
Usar um SDK é a forma mais simples e com melhor suporte para integração de APIs. Recomendamos fortemente essa abordagem.
-
Alibaba Cloud SDK
A Alibaba Cloud fornece SDKs para diversas linguagens de programação, como Java, C#, Go, Python, Node.js/TypeScript, PHP e C++. Integre um SDK para chamar APIs diretamente pelos métodos expostos. Os SDKs lidam automaticamente com assinatura de solicitações, tempos limite e novas tentativas, além de retornarem objetos de resposta estruturados, o que simplifica o desenvolvimento. Para mais informações, consulte Alibaba Cloud SDK.
Use um Alibaba Cloud SDK para chamar as APIs do Database Autonomy Service (DAS). Para obter informações sobre as linguagens suportadas e como instalar dependências, consulte SDK do Database Autonomy Service (DAS).
-
Alibaba Cloud CLI
O Alibaba Cloud CLI permite usar o comando
aliyunem um terminal para interagir com os serviços da Alibaba Cloud e gerenciar seus recursos de nuvem. Para mais informações, consulte O que é o Alibaba Cloud CLI?.Não é possível usar o Alibaba Cloud CLI para chamar as APIs do Database Autonomy Service (DAS).
-
Resource Orchestration Service (ROS)
O Resource Orchestration Service (ROS) é um serviço da Alibaba Cloud que simplifica o gerenciamento de recursos de nuvem. Desenvolvedores e administradores podem escrever modelos para definir os recursos necessários da Alibaba Cloud, como instâncias ECS e ApsaraDB for RDS, bem como as dependências entre eles. O mecanismo ROS cria e configura automaticamente todos os recursos com base no modelo, automatizando a implantação e O&M. Para mais informações, consulte O que é o Resource Orchestration Service?.
Não é possível usar o Resource Orchestration Service (ROS) para chamar as APIs do Database Autonomy Service (DAS).
-
Encapsulamento personalizado
Este método exige implementar manualmente o algoritmo de assinatura, construir solicitações personalizadas e fazer chamadas HTTP nativas. Para mais detalhes sobre o mecanismo de assinatura, consulte Visão geral da API e Corpo da solicitação V3 e mecanismo de assinatura.
Observações de uso
Se uma chamada de API do Database Autonomy Service (DAS) retornar um erro, verifique seus parâmetros de solicitação comparando-os com o código de erro retornado. Para mais informações, consulte Códigos de erro comuns.
Use também o ID da solicitação retornado ou os detalhes do erro do SDK com o Diagnóstico da OpenAPI da Alibaba Cloud para solução autônoma de problemas.