文档中心

返回结果

最近更新时间：2022.11.18 17:51:16

首次发布时间：2022.11.18 17:51:16

本文介绍数据库工作台 DBW 的 API 返回结果信息。

说明

HTTP 状态码为 200，表示接口请求成功。
所有非 200 的 HTTP 状态码，表示接口请求失败。具体的失败信息，以 JSON 的形式返回。

返回结果示例

请求调用成功返回结果

{
    "ResponseMetadata" : {
        "RequestId": "d78bbf4e-63a5-4937-ac3c-3767e7eddfbe",
        "Action": "DataConnectInstance",
        "Version": "2018-01-01",
        "Service": "dbw",
        "Region": "cn-beijing"
    },
 
    "Result": {/* 具体业务的返回信息 */
          "SessionId" : "MTU3MTc4MTIwMjQ1OTc3NDk3Ni8xNTcxNzgxMjA0MzMwNDM4NjU2",
          "DatabaseName": "information_schema"
    }
}

请求调用返回的参数信息如下所示：

ResponseMetadata 及其内部的 RequestId、Action、Version、Service、Region 是固定的字段，无论请求成功与否，只要发起了 API 请求，必定会返回。
RequestId 是一个 API 请求的唯一标识，如果 API 出现异常，您可以提交工单联系技术支持，并提供该 ID 来帮助定位问题。
Result 是固定字段，此字段的内容根据不同的产品返回结果可能存在差异，请以实际返回为准。请求调用失败时不会返回该字段。
除了固定的字段外，其余均为具体 API 定义的字段，不同的 API 所返回的字段请参见各 API 文档中的具体定义。

请求调用失败返回结果

{
    "ResponseMetadata": {
        "RequestId": "202210141739510101742551810409CE5E",
        "Action": "DataExecCommands",
        "Version": "2018-01-01",
        "Service": "dbw",
        "Region": "cn-beijing",
        "Error": {
            "Code": "ParamError",
            "Message": "The request processing has failed due to some unknown error, exception or failure."
        }
    },
    "Result": null
}

请求调用失败时必定会出现 Error 字段，Error 字段中包含了 Code 和 Message 字段，其中：
- Code 表示具体出错的错误码，您可以先根据该错误码在公共错误码和当前接口对应的错误码列表里面查找对应原因和解决方案。
- Message 会给出错误发生的具体原因，随着业务发展或体验优化，此文本可能会变更。
请求调用失败时，不会返回 Result 字段。

返回结果示例