異常時のレスポンス形式

■認証エラーの場合

HTTPステータス

ステータス

リクエストのステータスを返却する。
401:
認証エラー
Data Type Cardinality
Int 1..1

Response Elements

なし

Example of Response


HTTP/1.1 401 Unauthorized
Date: Fri, 06 Jun 2014 11:00:38 GMT       
     

■アクセス拒否の場合

HTTPステータス

ステータス

リクエストのステータスを返却する。
403:
アクセス拒否
Data Type Cardinality
Int 1..1

Response Elements

AccessDeniedException

エラーレスポンスのエンベロープ。

Data Type Cardinality Parent Element Child Element(s)
- 1..1 None Message

Message

エラーメッセージ。

Data Type Cardinality Parent Element Child Element(s)
xsd:string 1..1 AccessDeniedException None

Example of Response


HTTP/1.1 403 Forbidden
Date: Fri, 06 Jun 2014 11:00:38 GMT
Content-Length: …
Content-Type: application/xml
x-fj-request-id: d96bd874-9bf2-11e1-8ee7-c98a0037a2b6
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AccessDeniedException>
  <Message>Access Denied</Message>
</AccessDeniedException>
     

■認証エラー/アクセス拒否以外のエラー時

HTTPステータス

ステータス

リクエストのステータスを返却する。

以下の値を返却する。
400:
  • リクエストのXML形式が正しくない
  • リクエストしたアクションまたは操作が無効
  • 併用できないパラメーターが使用されている
  • 無効な値または範囲外の値を入力パラメーターに指定
  • クエリ文字列の形式が正しくない
  • クエリ文字列に構文エラーが含まれています
  • アクションの指定が無いか、もしくはパラメーター不足
  • 指定したアクションに必要なパラメーターが不足
  • サービスの利用制限を超えたため拒否された
  • パラメーターのValidationエラー
  • クエリ文字列に構文エラーが含まれています
413:
リクエストヘッダの長さが最大値(32768バイト)を超過しています。
414:
リクエストURLの長さが最大値(8192バイト)を超過しています。
500:
サーバ内部エラー
5xx:
アベイラビリティゾーンダウンした際のエラー

ユーザーから送ったクエリがアベイラビリティゾーンダウンのタイミングにより異なり、様々な挙動となります。

その為、HTTP ステータスコードは(5xx)を返却することで、ユーザーにリトライを促します。

Data Type Cardinality
Int 1..1

Response Elements

ErrorResponse

エラーレスポンスのエンベロープ。

Data Type Cardinality Parent Element Child Element(s)
- 1..1 None Error

RequestId

Error

エラー情報のエンベロープ。

Data Type Cardinality Parent Element Child Element(s)
- 1..1 ErrorResponse Type

Code

Message

Type

SenderまたはReceiver。

エラー原因が送信側か受信側にあるかを示します。

Data Type Cardinality Parent Element Child Element(s)
xsd:string 1..1 Error None

Code

エラーコード。

Data Type Cardinality Parent Element Child Element(s)
xsd:string 1..1 Error None

Message

エラーメッセージ(英語)。

Data Type Cardinality Parent Element Child Element(s)
xsd:string 1..1 Error None

RequestId

リクエストを一意に識別するID。

問題が発生した場合の問い合わせの際にトラブルシューティングを行うために必要となります。

Data Type Cardinality Parent Element Child Element(s)
xsd:string 1..1 ErrorResponse None

Example of Response


HTTP/1.1 400 Bad Request
Date: Fri, 06 Jun 2014 11:00:38 GMT
Content-Length: …
Content-Type: application/xml
x-fj-request-id: 2844de70-360d-488d-bd63-0cd88fd94be1
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ErrorResponse xmlns="https://dns.tps5.fujitsu.com/doc/2014-11-01/">
  <Error>
    <Type>Sender</Type>
    <Code>InvalidInput</Code>
    <Message>The specified Action is not valid</Message>
    </Error>
    <RequestId>2844de70-360d-488d-bd63-0cd88fd94be1</RequestId>
</ErrorResponse>