Cuando una solicitud a OSS falla, el servicio devuelve una respuesta de error que incluye un código de estado HTTP, un código de error específico del servicio (EC) y un cuerpo XML que describe el problema.
Proceso de autodiagnóstico
Paso 1: Localizar la información clave
Una respuesta de error típica contiene los campos necesarios para diagnosticar el problema. Comience por el campo Message y revise después los siguientes campos. Ejemplo:
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.alibabacloud.com/troubleshoot?q=0016-00000502</RecommendDoc>
</Error>RecommendDoc(recomendado): Enlace directo a la guía oficial de solución de problemas para el error específico.EC: Código de error detallado que corresponde a una causa específica del error.HTTP status code(como 400 Bad Request): Indica si el error se originó en el cliente o en el servidor.RequestId(obligatorio para soporte técnico): Identificador único de la solicitud. Proporcione este ID al contactar al soporte técnico.
Paso 2: Obtener la solución
Utilice uno de los siguientes métodos para encontrar una solución:
-
Acceder al enlace de
RecommendDocVaya al enlace
RecommendDocproporcionado en la respuesta de error.
-
Consultar la lista de códigos de error EC
Si la respuesta no contiene un enlace
RecommendDoc, busque el códigoECen la lista de códigos de error.
Si el problema persiste, contacte al soporte técnico con la información obligatoria.
Para agilizar la resolución, proporcione siempre el ID completo de la solicitud al contactar al soporte técnico. Para obtener más información, consulte Obtain a request ID.
Estructura de la respuesta de error
Encabezados de la respuesta de error
|
Encabezado de respuesta |
Descripción |
|
|
Código de error detallado y único para cada condición de error. Es más preciso que el elemento genérico Importante
El campo EC tiene fines exclusivamente de diagnóstico. Su valor puede cambiar sin previo aviso y no se garantiza la compatibilidad con versiones anteriores. No diseñe lógica de aplicación que dependa de valores específicos de EC. |
|
|
Identificador único de la solicitud. Proporcione este ID al contactar al soporte técnico. |
Ejemplo de encabezados de respuesta
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 obtener más información, consulte Common response headers.
Cuerpo de la respuesta de error
|
Elemento |
Descripción |
|
|
Código de error de propósito general definido por OSS. |
|
|
Descripción detallada del error. |
|
|
Identificador único de la solicitud. Proporcione este ID al contactar al soporte técnico. |
|
|
Clúster de OSS que procesó la solicitud; coincide con el host de su solicitud. |
|
|
Código de error detallado, equivalente al valor de |
|
|
Enlace a la guía interactiva de solución de problemas en OpenAPI Explorer. Se recomienda como primer paso de diagnóstico. |
Ejemplo de cuerpo de respuesta
<?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.alibabacloud.com/troubleshoot?q=0031-00000001</RecommendDoc>
</Error>