全部产品
阿里云办公

返回结果

更新时间:2018-11-07 10:18:33

调用 API 服务后返回数据采用统一格式,具体包括:

  • 状态码
  • 响应头
  • 响应数据

成功结果

返回的 HTTP 状态码为 2xx,代表调用成功;

响应数据格式为 JSON 格式,在每个 API 中有具体的描述响应数据的内容。

以下是创建集群返回 成功的示例:

  1. HTTP/1.1 201 Created
  2. Date: Tue, 06 Nov 2018 06:12:41 GMT
  3. Content-Type: application/json; charset=utf-8
  4. Content-Length: 35
  5. Connection: close
  6. Access-Control-Allow-Origin: *
  7. Access-Control-Allow-Methods: POST, GET, OPTIONS
  8. Access-Control-Allow-Headers: X-Requested-With, X-Sequence, _aop_secret, _aop_signature
  9. Access-Control-Max-Age: 172800
  10. x-acs-request-id: D874CC9A-C2D4-4DAE-A351-1699550F11A9
  11. Server: AliyunBatchCompute
  12. {"Id":"cls-6ki3sg6sqlno7nt8fu0007"}

错误结果

返回的 HTTP 状态码为 4xx 或 5xx ,代表调用失败,具体状态码参考 公共错误码 以及各个 API 的错误码。

返回的 Body 中包含 “Code” 和 “Message” 字段,您可以根据此信息来排查错误。

响应头中的 x-acs-request-id 包含请求的 request id。当您无法排查错误时,可以提交工单联系我们,并在工单中注明 request id。

以下是一个请求错误的示例:

  1. HTTP/1.1 400 Bad Request
  2. Date: Tue, 06 Nov 2018 08:30:40 GMT
  3. Content-Type: application/json; charset=utf-8
  4. Content-Length: 90
  5. Connection: close
  6. Access-Control-Allow-Origin: *
  7. Access-Control-Allow-Methods: POST, GET, OPTIONS
  8. Access-Control-Allow-Headers: X-Requested-With, X-Sequence, _aop_secret, _aop_signature
  9. Access-Control-Max-Age: 172800
  10. x-acs-request-id: F067DAB7-57C4-4D08-BE49-CDB63BF5C6D2
  11. Server: AliyunBatchCompute
  12. {"Code":"InvalidParameter.ImageId","Message":"Specified parameter ImageId is not valid. "}