Tous les produits
Search

Ce produit

    Object Storage Service:Error responses

    Centre de documentation

    Object Storage Service:Error responses

    Dernière mise à jour :Aug 18, 2026

    Lorsqu'une requête OSS échoue, le service renvoie une réponse d'erreur comprenant un code d'état HTTP, un code d'erreur spécifique au service (EC) et un corps XML décrivant le problème.

    Processus de dépannage autonome

    Étape 1 : Localiser les informations clés

    Une réponse d'erreur type contient les champs nécessaires au diagnostic du problème. Commencez par examiner le champ Message, puis vérifiez les champs suivants. Exemple :

    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 (recommandé) : Lien direct vers le guide officiel de dépannage pour l'erreur spécifique.

    • EC : Code d'erreur granulaire correspondant à une cause spécifique de l'erreur.

    • HTTP status code (tel que 400 Bad Request) : Indique si l'erreur provient du client ou du serveur.

    • RequestId (Requis pour le support) : Identifiant unique de la requête. Vous devez fournir cet identifiant lorsque vous contactez le support technique.

    Étape 2 : Obtenir la solution

    Utilisez l'une des méthodes suivantes pour trouver une solution :

    1. Accédez au lien RecommendDoc

      • Accédez au lien RecommendDoc fourni dans la réponse d'erreur.

    2. Consultez la liste des codes d'erreur EC

      • Si la réponse ne contient pas de lien RecommendDoc, recherchez le code EC dans la liste des codes d'erreur.

    Si le problème persiste, contactez le support technique en fournissant les informations requises.

    Pour accélérer le dépannage, indiquez toujours l'ID de requête complet lorsque vous contactez le support. Pour plus d'informations, consultez Obtenir un ID de requête.

    Structure de la réponse d'erreur

    En-têtes de la réponse d'erreur

    En-tête de réponse

    Description

    x-oss-ec

    Code d'erreur granulaire propre à chaque condition d'erreur. Plus précis que l'élément générique Code, il vous aide à identifier plus rapidement les causes profondes.

    Important

    Le champ EC est destiné uniquement au diagnostic. Sa valeur peut changer sans préavis et la compatibilité descendante n'est pas garantie. Ne construisez pas de logique applicative dépendant de valeurs EC spécifiques.

    x-oss-request-id

    Identifiant unique de la requête. Fournissez cet identifiant lorsque vous contactez le support technique.

    Exemple d'en-têtes de réponse

    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-00000001

    Pour plus d'informations, consultez En-têtes de réponse courants.

    Corps de la réponse d'erreur

    Élément

    Description

    Code

    Code d'erreur générique défini par OSS.

    Message

    Description détaillée de l'erreur.

    RequestId

    Identifiant unique de la requête. Fournissez cet identifiant lorsque vous contactez le support technique.

    HostId

    Cluster OSS qui a traité la requête, correspondant à l'hôte de votre requête.

    EC

    Code d'erreur granulaire, identique à x-oss-ec dans l'en-tête de réponse.

    RecommendDoc

    Lien vers le guide de dépannage interactif dans OpenAPI Explorer. Recommandé comme première étape de dépannage.

    Exemple de corps de réponse

    <?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>

    Références