異常時のレスポンス形式
■認証エラーの場合
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>