Quando uma solicitação ao OSS falha, o serviço retorna uma resposta de erro que inclui um código de status HTTP, um código de erro específico do serviço (EC) e um corpo XML que descreve o problema.
Processo de solução de problemas
Etapa 1: Localize as informações principais
Uma resposta de erro típica contém os campos necessários para diagnosticar o problema. Comece pelo campo Message e verifique os campos a seguir. Exemplo:
HTTP/1.1 400 Bad Request
Server: AliyunOSS
Date: Thu, 11 Aug 2019 01:44:54 GMT
Content-Type: application/xml
Content-Length: 322
Connection: keep-alive
x-oss-request-id: 57ABD896CCB80C366955****
x-oss-server-time: 0
<?xml version="1.0" encoding="UTF-8"?>
<Error>
<Code>MissingArgument</Code>
<Message>Missing Some Required Arguments.</Message>
<RequestId>57ABD896CCB80C366955****</RequestId>
<HostId>oss-example.oss-cn-hangzhou.aliyuncs.com</HostId>
<EC>0016-00000502</EC>
<RecommendDoc>https://api.aliyun.com/troubleshoot?q=0016-00000502</RecommendDoc>
</Error>-
RecommendDoc(recomendado): link direto para o guia oficial de solução de problemas do erro específico. -
EC: código de erro detalhado que corresponde a uma causa específica do erro. -
Código de status HTTP(como 400 Bad Request): indica se o erro é do lado do cliente ou do servidor. -
RequestId(obrigatório para suporte): ID exclusivo da solicitação. Você deve fornecer esse ID ao entrar em contato com o suporte técnico.
Etapa 2: Obtenha a solução
Use um dos métodos a seguir para encontrar uma solução:
-
Acesse o link
RecommendDoc-
Acesse o link
RecommendDocfornecido na resposta de erro.
-
-
Consulte a lista de códigos de erro EC
-
Se a resposta não contiver um link
RecommendDoc, consulte oECna lista de códigos de erro.
-
Se o problema persistir, entre em contato com o suporte técnico e forneça as informações necessárias.
Para agilizar a solução de problemas, sempre forneça o ID completo da solicitação ao entrar em contato com o suporte. Para mais informações, consulte Obter um ID de solicitação.
Estrutura da resposta de erro
Cabeçalhos da resposta de erro
|
Cabeçalho da resposta |
Descrição |
|
|
Código de erro detalhado, exclusivo para cada condição de erro. Mais preciso que o elemento Importante
O campo EC serve apenas para fins de diagnóstico. Seu valor pode mudar sem aviso prévio e não há garantia de compatibilidade retroativa. Não crie lógica de aplicação que dependa de valores específicos de EC. |
|
|
ID exclusivo da solicitação. Forneça esse ID ao entrar em contato com o suporte técnico. |
Exemplo de cabeçalhos de resposta
HTTP/1.1 403 Forbidden
Server: AliyunOSS
Date: Wed, 09 Nov 2022 08:45:46 GMT
Content-Type: application/xml
Content-Length: 471
Connection: keep-alive
x-oss-request-id: 636B68BA80DA8539399F****
x-oss-server-time: 0
x-oss-ec: 0003-00000001Para mais informações, consulte Cabeçalhos de resposta comuns.
Corpo da resposta de erro
|
Elemento |
Descrição |
|
|
Código de erro genérico definido pelo OSS. |
|
|
Descrição detalhada do erro. |
|
|
ID exclusivo da solicitação. Forneça esse ID ao entrar em contato com o suporte técnico. |
|
|
Cluster do OSS que processou a solicitação, correspondente ao host da sua solicitação. |
|
|
Código de erro detalhado, equivalente ao |
|
|
Link para o guia interativo de solução de problemas no OpenAPI Explorer. Recomendado como primeira etapa de solução de problemas. |
Exemplo de corpo de resposta
<?xml version="1.0" ?>
<Error xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
<Code>MalformedXML</Code>
<Message>The XML you provided was not well-formed or did not validate against our published schema.</Message>
<RequestId>57ABD896CCB80C366955****</RequestId>
<HostId>oss-cn-hangzhou.aliyuncs.com</HostId>
<EC>0031-00000001</EC>
<RecommendDoc>https://api.aliyun.com/troubleshoot?q=0031-00000001</RecommendDoc>
</Error>