API共通のエラー情報

■認証エラーの場合

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形式が正しくない
500:
サーバー内部エラー
5xx:
AZダウンした際のエラー

利用者から送ったクエリがAZダウンのタイミングにより異なり、様々な挙動となります。

その為、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="http://docs.cloudcommunity.global.fujitsu.com/dns/api/v1.0/">
  <Error>
    <Type>Sender</Type>
    <Code>InvalidInput</Code>
    <Message>The specified Action is not valid</Message>
    </Error>
    <RequestId>2844de70-360d-488d-bd63-0cd88fd94be1</RequestId>
</ErrorResponse>