1. 云控制台API返回结果说明

云控制台API以JSON报文形式返回结果。返回结果使用UTF-8编码格式。

云控制台API返回结果包含公共信息部分和业务信息部分。公共信息部分为云控制台API强制返回的内容,包含了请求是否成功以及该请求的ID。业务信息部分由每个接口根据业务需求定义。

根据请求是否成功处理,业务信息会被区分为正常业务信息和异常业务信息两类。正常业务信息主要包含请求的业务结果数据;异常业务信息主要包含异常错误信息。

以下分别对接口返回公共信息和业务信息进行说明。

请注意:为了便于查看和美观,本文档返回示例中均有换行和缩进等处理,实际返回结果无换行和缩进处理。

1.1. 公共信息

公共信息是指云控制台API调用返回结果的公共部分,任何接口调用的返回都包含公共信息部分。公共信息字段包括:

字段名 字段类型 说明
result Boolean 调用结果为成功还是失败
requestId String 请求ID

1.2. 正常业务信息

接口调用成功后会返回接口调用结果、返回信息和请求ID,我们称这样的返回为正常返回。正常返回的HTTP状态码为 2xx。

1.3. 异常业务信息

接口调用出错后,会返回错误码、错误信息和请求ID,我们称这样的返回为异常返回。HTTP 状态码为 4xx 、 5xx 或者 6xx。 您可以根据接口错误码以及公共错误码排查错误。

1.4. 返回结果示例

以下为创建云主机的正常返回结果内容:

{
  "requestId": "5baa5046-7758-49fd-b617-2c4ace1be375",
  "success": true,
  "code": 200,
  "message": null,
  "model": null
}

以下为创建云主机的异常返回结果内容:

{
    "requestId": "4416235a-e9c0-453f-823a-ad491ebd74ab",
    "success": false,
    "code": 403,
    "message": "permission denied"
}

results matching ""

    No results matching ""