返回结果

对于成功的请求，HTTP 状态码返回的为200。对于请求调用失败的，HTTP 状态码返回的不是200，为4xx或5xx。4xx一般代表参数的不合法或者操作不允许，5xx则为服务系统遇到了一些问题。

Zenlayer Cloud API的许多接口为异步操作，请求成功并不代表着操作完成并且成功。

成功的返回结果

以裸机云的接口创建实例 (CreateInstances) 为例，若调用成功，其可能的返回如下：

{
    "requestId": "T67723B59-F4D1-42EA-BDC1-5E67167FD8CC",
    "response": {
       "requestId": "T67723B59-F4D1-42EA-BDC1-5E67167FD8CC",
       "instanceIdSet" : ["1234567654321"],
       "orderNumber": "1234567654321"
    }
}

**requestId：**一次 API 请求的唯一标识，如果 API 出现异常，可以联系我们，并提供该 ID 来解决问题。
**response：**成功返回的数据部分，其内容结构见每个接口的返回结果。
response其内部的 RequestId 也是固定的字段，其值和外部的requestId一致。

失败的返回结果

若调用失败，其返回值如如下示例：

{
    "requestId": "T67723B59-F4D1-42EA-BDC1-5E67167FD8CC",
    "code": "INVALID_ZONE_NOT_FOUND",
    "message": "The specified zoneId `SEL--A` is not found"
}

**requestId：**一次 API 请求的唯一标识，如果 API 出现异常，可以联系我们，并提供该 ID 来解决问题。
**code：**错误码，具体错误码见每个接口的错误码部分。
**message：**描述错误发生的具体原因，随着业务发展或体验优化，此文本可能会发生变化，用户不应依赖这个返回值。

最后更新于1年前