O ActionTrail oferece um console visual e suporta diversas formas de chamar suas APIs, incluindo depuração online com o OpenAPI Explorer, Alibaba Cloud SDK, Terraform e Resource Orchestration Service (ROS). Escolha o método de integração mais adequado para aumentar sua eficiência no desenvolvimento.
Terraform,
OpenAPI Explorer
O OpenAPI Explorer é uma ferramenta abrangente da Alibaba Cloud que ajuda os desenvolvedores a aprender e usar APIs rapidamente. Ele integra busca inteligente de APIs, documentação, depuração online, obtenção de SDKs, exemplos de código, diagnóstico de erros em chamadas de API e estatísticas de chamadas. Use o OpenAPI Explorer para chamar as APIs dos serviços da Alibaba Cloud e visualizar as requisições e respostas. O OpenAPI Explorer também gera automaticamente códigos de exemplo do SDK para ajudar você a começar a usar os produtos da Alibaba Cloud. Para mais informações, consulte What is OpenAPI?.
Versão
A Alibaba Cloud utiliza versões para gerenciar as APIs das principais releases de produtos. Atualmente, o ActionTrail suporta a versão da API 2020-07-06. A string 2020-07-06 é um identificador de versão, não uma data. Esse identificador representa o conjunto mais recente de operações da API e não indica que a API está obsoleta.
|
Versão |
Descrição |
|
Recomendada |
Depuração online
O ActionTrail oferece recursos de depuração de API no OpenAPI Explorer. Antes de fazer uma chamada de API, entenda as versões disponíveis, endpoints e métodos de integração do ActionTrail.
Na página do ActionTrail no OpenAPI Explorer, o painel de navegação à esquerda lista as APIs disponíveis por categoria, como DescribeRegions para regiões e CreateTrail/DeleteTrail para trails. No painel central de depuração, selecione um endpoint, como China (Shanghai), configure parâmetros de requisição como AcceptLanguage e clique em Initiate Call para depurar a API online. O painel à direita exibe a descrição da API e a documentação dos parâmetros.
Portal de depuração
Acesse o portal de depuração de API em: ActionTrail API Debugging List
Endpoints
Para minimizar a latência, selecione um endpoint na mesma região dos seus recursos. Por exemplo, na região China (Zhangjiakou), o endpoint público do ActionTrail é actiontrail.cn-zhangjiakou.aliyuncs.com, e o endpoint de VPC é actiontrail-vpc.cn-zhangjiakou.aliyuncs.com.
Os endpoints públicos são acessíveis globalmente.
-
Os endpoints de VPC são acessíveis apenas de dentro de uma VPC em uma região específica da Alibaba Cloud. Benefícios:
Alta segurança: os endpoints de VPC só são acessíveis de dentro de uma VPC.
Resposta mais rápida: como o tráfego por um endpoint de VPC usa a rede interna, os tempos de resposta costumam ser menores, evitando problemas como latência de rede pública e limites de largura de banda.
Custos reduzidos: os endpoints de VPC utilizam comunicação pela rede interna.
Para mais informações, consulte Endpoints.
Identidades
Uma conta da Alibaba Cloud tem acesso total à API, o que representa um risco de segurança. Para maior proteção, recomendamos usar um usuário RAM para chamadas de API e operações diárias de O&M. Antes de chamar uma API, conceda ao usuário RAM as permissões necessárias conforme seus requisitos de negócio. O usuário RAM deve ter permissões para gerenciar recursos do ActionTrail. Para mais informações, consulte Use RAM for access control.
|
Identidade |
Suporte |
|
Sim |
|
|
RAM user (recomendado) |
Sim |
|
RAM role (recomendado) |
Sim |
Mais informações
Métodos de integração
O Alibaba Cloud SDK é o método recomendado para chamar APIs, pois é o mais simples e conta com o melhor suporte.
Métodos de integração
|
Método |
Suporte |
|
Alibaba Cloud SDK (recomendado) |
Sim |
|
Sim |
|
|
Sim |
|
|
Sim |
-
Alibaba Cloud SDK
A Alibaba Cloud fornece SDKs para várias linguagens de programação, incluindo Java, C#, Go, Python, Node.js/TypeScript, PHP e C++. Integre um SDK ao seu aplicativo para chamar APIs diretamente. Os SDKs encapsulam a lógica de assinatura, o mecanismo de timeout e o mecanismo de nova tentativa, retornando objetos de resposta estruturados. Para mais informações sobre os SDKs da Alibaba Cloud, consulte Alibaba Cloud SDK.
Use um Alibaba Cloud SDK para chamar operações da API do ActionTrail no OpenAPI Explorer. Para obter informações sobre as linguagens suportadas e como instale dependências, consulte ActionTrail SDK.
-
Alibaba Cloud CLI
O Alibaba Cloud Command Line Interface (CLI) é uma ferramenta de linha de comando de uso geral construída sobre APIs. Utilize o Alibaba Cloud CLI para interagir com os serviços da Alibaba Cloud e gerencie seus recursos em um shell. Para mais informações sobre o Alibaba Cloud CLI, consulte What is Alibaba Cloud CLI?.
Utilize o Alibaba Cloud CLI para chamar operações da API do ActionTrail .
-
Resource Orchestration Service (ROS)
O Resource Orchestration Service (ROS) é um service da Alibaba Cloud que simplifica o gerenciamento de recursos em cloud. Desenvolvedores e administradores podem escrever modelos para defina os recursos necessários da Alibaba Cloud, como instâncias do Elastic Compute Service (ECS) e instâncias do ApsaraDB RDS, além das dependências entre esses recursos. O mecanismo de orquestração do ROS crie e configure automaticamente todos os recursos com base nos modelos, implementando implantação automatizada e O&M. Para mais informações, consulte What is Resource Orchestration Service?.
Use o ROS para chamar operações da API do ActionTrail. Para mais informações, consulte ROS integration example.
-
Requisições HTTP diretas
Se você fizer requisições HTTP diretas, será necessário implementar o algoritmo de assinatura e construir a requisição HTTP manualmente. Para mais informações sobre o mecanismo de assinatura, consulte API overview e V3 request body and signature mechanism.
Observações
Se uma chamada de API falhar, use o código de erro retornado para verificar os parâmetros da requisição e seus valores.
Também é possível diagnosticar erros usando o RequestID da resposta ou as informações de erro do SDK na página OpenAPI Troubleshoot.
FAQ
O ActionTrail ajuda você a monitorar e registrar as atividades da sua conta da Alibaba Cloud. Ele suporta análise comportamental, análise de segurança, rastreamento de alterações de recursos e auditoria de conformidade. Para mais informações, consulte What is ActionTrail?.
Além do SDK para Java, o ActionTrail também suporta SDKs para outras linguagens de programação, como C#, Go, Python, Node.js/TypeScript, PHP e C++. Para mais informações, consulte SDK reference.