You need to enable JavaScript to run this app.
导航

返回结果

最近更新时间2023.11.15 22:39:28

首次发布时间2021.12.01 15:37:07

本文介绍云数据库 PostgreSQL 版 Open API 的返回结果信息。

说明

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

返回结果示例

请求调用成功返回结果

{
	"ResponseMetadata" : {
            "RequestId": "52ece640-60ba-4cf9-bf34-302fb45eef4f",
            "Action": "DescribeRegions",
            "Version": "2022-01-01",
            "Service": "rds_postgresql",
            "Region": "cn-beijing"
  	  },
	"Result": { /* 具体业务的返回信息 */
            "Regions":[
               { 
                "RegionId": "cn-beijing", 
                "RegionName": "华北 2(北京)"
               }
            ] 
      }
 }

请求被正常处理后,返回中会包含 ResponseMetadataResult 两部分。
ResponseMetadata 及其内部的 RequestIdActionVersionServiceRegion 是固定的字段,无论请求成功与否,只要发起了 API 请求,必定会返回。请求调用失败时不会返回该字段。ResponseMetadata 各字段的说明如下:

字段说明
RequestIDRequestID 为每次 API 请求的唯一标识。如果 API 出现异常,您可以提交工单联系技术支持,并提供该 ID 来帮助定位问题。
Action请求的接口名,属于请求的公共参数。
Version请求的版本号,属于请求的公共参数。
Service请求的服务,属于请求的公共参数。
Region请求所在的地域,属于请求的公共参数。

Result 是固定字段,具体返回内容视请求的接口而定,不同的接口会有不同的 Result 返回。

请求调用失败返回结果

{
     "ResponseMetadata" : {
          "RequestId": "d78bbf4e-63a5-4937-ac3c-3767e7eddfbe",
          "Action": "DescribeRegions",
          "Version": "2022-01-01",
          "Service": "rds_postgresql",
          "Region": "cn-beijing",
          "Error": {
              "Code": "Failed",
              "Message": "The request processing has failed due to some unknown error, exception or failure."
          }
     }
 }

相较于成功结果,错误结果将不再有 Result 部分,而 ResponseMetadata 中将额外出现 Error 字段,Error 字段中包含了 CodeMessage 字段。Error 中各字段的说明如下:

字段说明
Code表示具体出错的错误码,您可以先根据该错误码在公共错误码和当前接口对应的错误码列表里面查找对应原因和解决方案。
Message错误发生的具体原因。