View a markdown version of this page

SOAP エラーレスポンス - Amazon Simple Storage Service

SOAP エラーレスポンス

注記

SOAP API for Amazon S3 は新規顧客には利用できず、2025 年 8 月 31 日にサポート終了 (EOL) となります。REST API か AWS SDK を使用することをお勧めします。

SOAP の場合、エラー結果は SOAP フォルトとして HTTP レスポンスコード 500 と共にクライアントに返されます。SOAP フォルトを受け取っていない場合、リクエストは成功しています。Amazon S3 SOAP フォルトコードは、標準の SOAP 1.1 フォルトコード (「Server」または「Client」) に Amazon S3 固有のエラーコードが連結した構成になっています。たとえば、「Server.InternalError」や「Client.NoSuchBucket」などです。SOAP フォルト文字列要素には、人が読むことができる英語の汎用エラーメッセージが含まれます。また、SOAP フォルト詳細要素には、エラーに関連するさまざまな情報が含まれます。

たとえば、「Fred」というオブジェクトを削除しようとして、このオブジェクトが存在しなかった場合、SOAP レスポンスの本文には「NoSuchKey」という SOAP エラーが含まれます。

以下の例は、SOAP エラーレスポンスのサンプルです。

<soapenv:Body>
  <soapenv:Fault>
    <Faultcode>soapenv:Client.NoSuchKey</Faultcode>
    <Faultstring>The specified key does not exist.</Faultstring>
    <Detail>
      <Key>Fred</Key>
    </Detail>
  </soapenv:Fault>
  </soapenv:Body>

次の表に、SOAP エラーレスポンスの要素を示します。

名前 説明
Detail

エラーに関係するキーのコンテナ

型: コンテナ

祖先: Body.Fault
Fault

エラー情報のコンテナ。

型: コンテナ

祖先: Body
Faultcode

フォルトコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。詳細については、「エラーコードのリスト」を参照してください。

タイプ: 文字列

祖先: Body.Fault
Faultstring

フォルト文字列には、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、フォルト文字列が無視される傾向にあります。

タイプ: 文字列

祖先: Body.Fault
Key

エラーに関連するキーを識別します。

タイプ: 文字列

祖先: Body.Fault