API が呼び出されると、データは統一された形式で返されます。返される HTTP ステータスコード 2xx は、呼び出しが成功したことを示します。返される HTTP ステータスコード 4xx または 5xx は、呼び出しが失敗したことを示します。成功した呼び出しの場合、返されるデータの主な形式は XML と JSON です。リクエストが送信されると、外部システムはパラメータを入力して、返されるデータの形式を指定できます。デフォルトの形式は XML です。このドキュメントでは、返される結果の例は、見やすくするためにフォーマットされています。実際に返される結果には、改行、インデント、またはその他のレイアウトはありません。
成功した結果
XML の例
<? xml version="1.0" encoding="UTF-8" ? >
<! -結果のルートノード-->
<API name+ Response>
<! -リクエストタグを返す-->
<RequestId>25818875-5F78-4A13-BEF6-D7393642CA58</RequestId>
<! -返された結果-->
</API name+Response>JSON の例
{
"RequestId": "4C467B38-3910-447D-87BC-AC049166F216", /* 返された結果 */
}失敗した結果
API 呼び出しでエラーが報告された場合、結果データは返されません。呼び出し元は、各 API に対応するエラーコードと エラーコード一覧 に基づいてエラーの原因を特定できます。呼び出しでエラーが発生した場合、HTTP リクエストに対して HTTP ステータスコード 4xx または 5xx が返されます。返されたメッセージ本文には、特定のエラーコードとエラーメッセージが含まれています。メッセージ本文には、グローバルに一意のリクエスト ID(RequestId)とリクエストされたホスト ID(HostId)も含まれています。エラーの原因を特定できない場合は、呼び出し元は Alibaba Cloud カスタマーサービスに HostId と RequestId を提供することができ、弊社はできるだけ早く問題の解決を支援します。
XML の例
<? xml version="1.0" encoding="UTF-8"? >
<Error>
<RequestId>8906582E-6722-409A-A6C4-0E7863B733A5</RequestId>
<HostId>mts.cn-hangzhou.aliyuncs.com</HostId>
<Code>UnsupportedOperation</Code>
<Message>The specified action is not supported. </Message>
</Error>JSON の例
{
"RequestId": "8906582E-6722-409A-A6C4-0E7863B733A5",
"HostId": "mts.cn-hangzhou.aliyuncs.com",
"Code": "UnsupportedOperation",
"Message": "The specified action is not supported."
}