Ao encontrar um erro durante uma chamada de OpenAPI, copie a mensagem de erro para a página OpenAPI Troubleshooting e obtenha automaticamente uma solução.
Obter a mensagem de erro
Página de depuração online da API
Chamada via SDK
Chamada via CLI
Chamada via Terraform
Alibaba Cloud Developer Toolkit
Diagnosticar problemas do OpenAPI
Para consultar mensagens de erro entre contas Alibaba Cloud ou entre diferentes usuários do Resource Access Management (RAM) na mesma conta, conclua primeiro a authorization e tente novamente.
Após obter a mensagem de erro, copie todo o conteúdo JSON ou apenas os campos RequestId, Code ou Message na página OpenAPI TroubleshootingOpenAPI Troubleshooting para receber automaticamente uma solução.
Por exemplo, ao chamar a API RunInstances do Elastic Compute Service e receber um erro, a mensagem terá o seguinte formato:
{
"RequestId": "6BE56E05-XXXX-XXXX-XXXX-FD90C4FFD581",
"HostId": "ecs.ap-southeast-3.aliyuncs.com",
"Code": "InvalidImageId.NotFound",
"Message": "The specified ImageId does not exist.",
"Recommend": "https://api.alibabacloud.com/troubleshoot?intl_lang=EN_US&q=InvalidImageId.NotFound&product=Ecs&requestId=6BE56E05-XXXX-XXXX-XXXX-FD90C4FFD581"
}Os parâmetros têm os seguintes significados:
RequestId: identificador exclusivo da solicitação. Copie este valor para a página OpenAPI Troubleshooting e obtenha automaticamente uma solução.
HostId: endpoint do service para a solicitação de API.
Code: código do erro.
Message: informações detalhadas sobre o erro. Use-as para verifique os parâmetros da solicitação. Neste exemplo, o erro ocorre porque um ID de imagem inválido foi passado como ImageId. Corrija o problema usando um ID de imagem válido.
Recommend: link direto para a página de diagnóstico de erros. Copie este campo para acessar diretamente a solução de troubleshooting.
Em cenários reais, como ao usar um SDK, talvez você não receba a resposta de erro completa em JSON. Nesse caso, copie apenas o RequestId, Code ou Message para a página OpenAPI TroubleshootingOpenAPI Troubleshooting e obtenha uma solução. O uso do RequestId fornece o resultado mais preciso.
A solução obtida com um RequestId aparece conforme mostrado abaixo:
Visualize a solução de diagnóstico
Conforme mostrado acima, a página exibe duas abas na parte inferior: Diagnosis Solution e Log Information. A aba Diagnosis Solution apresenta a solução correspondente. Por exemplo, se a mensagem de erro for The specified ImageId does not exist., a solução fornecida será:
The specified image does not exist under this account. Check whether the image ID is correct.Siga as instruções da solução para verificar se o valor do parâmetro ImageId está correto.
Verifique parâmetros da solicitação
Em situações reais, é possível que você não tenha salvo o corpo original da solicitação quando o erro ocorreu. Ainda assim, use o OpenAPI Troubleshooting para recuperar os parâmetros da solicitação, a resposta e outros detalhes.
Tome como exemplo o erro com RequestId: 6BE56E05-XXXX-XXXX-XXXX-FD90C4FFD581. Clique em na aba Log Information. Conforme ilustrado abaixo, visualize as análises visuais da cadeia de chamadas, a mensagem de erro completa e o conteúdo original da solicitação. Use esses logs para identificar e resolver o problema com maior precisão.
