調用 API 服務后返回數據采用統一格式,具體包括:
狀態碼
響應頭
響應數據
成功結果
返回的 HTTP 狀態碼為 2xx,代表調用成功;
響應數據格式為 JSON 格式,在每個 API 中有具體的描述響應數據的內容。
以下是創建集群返回成功的示例:
HTTP/1.1 201 Created
Date: Tue, 06 Nov 2018 06:12:41 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 35
Connection: close
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: POST, GET, OPTIONS
Access-Control-Allow-Headers: X-Requested-With, X-Sequence, _aop_secret, _aop_signature
Access-Control-Max-Age: 172800
x-acs-request-id: D874CC9A-C2D4-4DAE-A351-1699550F11A9
Server: AliyunBatchCompute
{"Id":"cls-6ki3sg6sqlno7nt8fu0007"}
錯誤結果
返回的 HTTP 狀態碼為 4xx 或 5xx ,代表調用失敗,具體狀態碼參考公共錯誤碼以及各個 API 的錯誤碼。
返回的 Body 中包含 “Code” 和 “Message” 字段,您可以根據此信息來排查錯誤。
響應頭中的 x-acs-request-id 包含請求的 request id。
以下是一個請求錯誤的示例:
HTTP/1.1 400 Bad Request
Date: Tue, 06 Nov 2018 08:30:40 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 90
Connection: close
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: POST, GET, OPTIONS
Access-Control-Allow-Headers: X-Requested-With, X-Sequence, _aop_secret, _aop_signature
Access-Control-Max-Age: 172800
x-acs-request-id: F067DAB7-57C4-4D08-BE49-CDB63BF5C6D2
Server: AliyunBatchCompute
{"Code":"InvalidParameter.ImageId","Message":"Specified parameter ImageId is not valid. "}
文檔內容是否對您有幫助?