Object Storage Service (OSS) へのリクエストが失敗すると、サービスは標準の HTTP ステータスコード、サービス固有のエラーコード (EC)、および詳細な XML 本文を含むエラーレスポンスを返します。この Topic では、OSS のエラーレスポンスの構造について説明し、一般的な問題のトラブルシューティング戦略の概要を説明します。
自己トラブルシューティングプロセス
ステップ 1: 主要な情報を見つける
一般的なエラーレスポンスには、問題を診断するために必要な情報が含まれています。まず、Message フィールドを読んでエラーの説明を確認します。次に、以下の主要なフィールドを確認して問題をトラブルシューティングします。次のコードは、エラーレスポンスの例です。
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(推奨): 特定のエラーに関する公式のトラブルシューティングガイドへの直接リンクです。EC: エラーの特定の原因に対応する詳細なエラーコードです。HTTP ステータスコード(400 Bad Request など): リクエストの一般的なステータスです。このコードを使用して、エラーの一般的な性質 (クライアント側またはサーバー側) を判断できます。RequestId(サポートに必須): リクエストの一意の ID です。テクニカルサポートに連絡する際に、この ID を提供する必要があります。
ステップ 2: ソリューションを取得する
次のいずれかの方法を使用してソリューションを見つけます。
RecommendDocリンクにアクセスするエラーレスポンスで提供される
RecommendDocリンクに移動します。
EC エラーコードリストを確認する
レスポンスに
RecommendDocリンクが含まれていない場合は、エラーコードリストでECを検索します。
問題が解決しない場合は、必要な情報を添えてテクニカルサポートにお問い合わせください。
トラブルシューティングを迅速に行うために、サポートに連絡する際は必ず完全なリクエスト ID を提供してください。詳細については、「リクエスト ID の取得」をご参照ください。
エラーレスポンスの構造
エラーレスポンスヘッダー
レスポンスヘッダー | 説明 |
| OSS 固有の詳細なエラーコードです。各エラー条件は一意の EC にマッピングされます。汎用の 重要 EC フィールドは診断目的でのみ使用されます。その値は予告なく変更される可能性があり、下位互換性は保証されません。特定の EC 値に依存するアプリケーションロジックを構築しないでください。 |
| リクエストの一意の ID です。テクニカルサポートに連絡する際にこの ID を提供してください。 |
レスポンスヘッダーの例
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詳細については、「共通のレスポンスヘッダー」をご参照ください。
エラーレスポンス本文
要素 | 説明 |
| OSS によって定義された汎用エラーコードです。 |
| エラーの詳細な説明です。 |
| リクエストの一意の ID です。問題をトラブルシューティングして解決するためにテクニカルサポートに連絡する際に、このリクエスト ID を提供してください。 |
| リクエストを処理した OSS クラスターを識別します。これはリクエストで指定されたホストに対応します。 |
| 詳細なエラーコードで、レスポンスヘッダーの |
| 特定のエラーについて、OpenAPI Explorer のインタラクティブなトラブルシューティングガイドへのリンクです。このリンクをたどることが、トラブルシューティングの推奨される最初のステップです。 |
レスポンス本文の例
<?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>