调用 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. "}