本文介绍云数据库 PostgreSQL 版 Open API 的返回结果信息。
说明
{ "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(北京)" } ] } }
请求被正常处理后,返回中会包含 ResponseMetadata
和 Result
两部分。ResponseMetadata
及其内部的 RequestId
、Action
、Version
、Service
、Region
是固定的字段,无论请求成功与否,只要发起了 API 请求,必定会返回。请求调用失败时不会返回该字段。ResponseMetadata
各字段的说明如下:
字段 | 说明 |
---|---|
RequestID | RequestID 为每次 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
字段中包含了 Code
和 Message
字段。Error
中各字段的说明如下:
字段 | 说明 |
---|---|
Code | 表示具体出错的错误码,您可以先根据该错误码在公共错误码和当前接口对应的错误码列表里面查找对应原因和解决方案。 |
Message | 错误发生的具体原因。 |