# 返回结果

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

{% hint style="info" %}
Zenlayer Cloud API的许多接口为异步操作， 请求成功并不代表着操作完成并且成功。
{% endhint %}

## 成功的返回结果

以裸机云的接口创建实例 (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一致。

## 失败的返回结果

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

```json
{
    "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：\*\*描述错误发生的具体原因，随着业务发展或体验优化，此文本可能会发生变化，用户不应依赖这个返回值。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.console.zenlayer.com/api-reference/cn/api-introduction/instruction/response.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.