Além do console baseado na web, o ApsaraDB RDS permite o gerenciamento programático de recursos por meio do OpenAPI Explorer, Alibaba Cloud SDK, Terraform e Resource Orchestration Service (ROS). Escolha o método mais adequado ao seu fluxo de trabalho.
Visão geral do OpenAPI Explorer
O OpenAPI Explorer permite pesquisar, depurar e chamar operações de API dos serviços da Alibaba Cloud. Ele oferece pesquisa inteligente, documentação, depuração online, download de SDK, código de exemplo, diagnóstico de erros e estatísticas de chamadas. {{XREF_0}}
Descrição da versão
As APIs da Alibaba Cloud utilizam números de versão para rastrear lançamentos. A versão atual da API do ApsaraDB RDS é 2014-08-15. Este é um identificador de versão, não uma data.
Versão | Descrição |
Recomendada |
Depuração online
Antes de chamar operações de API, verifique as versões necessárias, os endpoints e os métodos de integração.
A página de depuração possui três áreas: uma árvore de navegação à esquerda (APIs categorizadas por função), um painel central para configuração de parâmetros e clique em Send Request, e um painel à direita com abas para Documentation, Call Result, SDK Sample e CLI Sample.
Página de depuração online
Acesse o OpenAPI Explorer.
Endpoints
Utilize o endpoint correspondente à região da sua instância. Por exemplo, a região China (Zhangjiakou) usa o endpoint público rds.cn-zhangjiakou.aliyuncs.com e o endpoint de VPC rds-vpc.cn-zhangjiakou.aliyuncs.com.
Endpoints públicos são acessíveis globalmente.
-
Endpoints de VPC oferecem os seguintes benefícios:
Alta segurança: acessíveis apenas dentro de uma VPC.
Resposta rápida: os dados trafegam dentro da VPC, evitando latência da rede pública e limites de largura de banda.
Baixo custo: o tráfego permanece na rede interna.
Para obter a lista completa de endpoints regionais, consulte {{XREF_1}}.
Identidades de usuário suportadas
Por padrão, o OpenAPI Explorer utiliza sua conta Alibaba Cloud para depuração. Como as contas raiz possuem permissões totais de API, recomendamos o uso de um usuário RAM para chamadas de API e operações rotineiras de O&M. Conceda ao usuário RAM as permissões necessárias do ApsaraDB RDS antes de utilizá-lo. {{XREF_2}}.
|
Identidade |
Suportada |
|
{{XREF_3}} |
Sim |
|
{{XREF_4}} (recomendado) |
Sim |
|
{{XREF_5}} (recomendado) |
Sim |
Referências
{{XREF_6}}
{{XREF_7}}
Métodos de integração
O ApsaraDB RDS suporta os seguintes métodos de integração. Escolha aquele que melhor atende aos seus requisitos.
|
Método de chamada |
Suportado |
|
{{XREF_8}} |
Sim |
|
{{XREF_9}} |
Sim |
|
{{XREF_10}} |
Sim |
|
{{XREF_11}} |
Sim |
|
Encapsulamento personalizado |
Sim |
Os SDKs são o método mais recomendado para chamar operações de API, pois facilitam a integração.
-
SDKs da Alibaba Cloud
A Alibaba Cloud fornece SDKs para Java, C#, Go, Python, TypeScript, Node.js, PHP e C++. Os SDKs gerenciam assinatura de requisições, timeouts e retentativas, retornando objetos de resposta estruturados. {{XREF_12}}.
Linguagens suportadas e instalação: ApsaraDB RDS SDK.
-
Alibaba Cloud CLI
O Alibaba Cloud CLI permite executar comandos
aliyunpara gerenciar recursos cloud. {{XREF_13}}Chame operações da API do ApsaraDB RDS com a CLI. {{XREF_14}}.
-
ROS
O ROS automatiza a implantação de recursos cloud por meio de modelos. Defina os recursos necessários (como instâncias ECS e RDS) e seus relacionamentos, e o ROS os provisionará automaticamente. {{XREF_17}}
Recursos ROS suportados: {{XREF_18}}.
-
Chamadas de API com encapsulamento personalizado
Chamadas HTTP nativas exigem construção e assinatura manual das requisições. Consulte {{XREF_19}} e {{XREF_20}}.
Observações de uso
Se uma chamada de API retornar um erro, verifique seus parâmetros de entrada em relação ao código de erro. {{XREF_21}}.
Registre o ID da requisição presente na resposta ou a mensagem de erro do SDK e utilize o Alibaba Cloud OpenAPI Diagnostics para diagnósticos de autoatendimento.