文档首页/ 云数据库 RDS/ API参考/ API v3/ 查询指定实例的风险版本信息 - ShowRiskInfo
更新时间：2026-09-20 GMT+08:00
查看PDF
分享

查询指定实例的风险版本信息 - ShowRiskInfo

功能介绍

查询指定实例的风险版本信息。

调试

您可以在API Explorer中调试该接口。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

rds:instance:get

read

-

-

rds:instance:list

-

URI

  • URI格式

    GET /v3/{project_id}/instances/{instance_id}/show-risk-info

  • 参数说明
    表1 参数说明

    参数

    是否必选

    参数类型

    描述

    project_id

    是

    String

    参数解释：

    租户在某一region下的project ID。

    获取方法请参见获取项目ID。

    约束限制：

    不涉及。

    取值范围：

    不涉及。

    默认取值：

    不涉及。

    instance_id

    是

    String

    参数解释：

    实例ID。

    可调用查询数据库实例列表接口，通过表4中的“id”获取。

    约束限制：

    不涉及。

    取值范围：

    不涉及。

    默认取值：

    不涉及。

请求消息

无。

请求示例

查询指定实例的风险版本信息。

GET https://{Endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/d697f4a676d64e68a323711e559b021din03/show-risk-info

响应消息

  • 正常响应要素说明
    表2 参数说明

    参数

    参数类型

    描述

    risks

    Array of objects

    参数解释：

    风险版本信息。详情请参见表3。
    表3 risks字段说明

    参数

    参数类型

    描述

    instance_id

    String

    参数解释：

    实例ID。

    取值范围：

    不涉及。

    engine_name

    String

    参数解释：

    当前引擎名称。

    取值范围：

    • mysql
    • postgresql

    engine_version

    String

    参数解释：

    当前引擎小版本。

    取值范围：

    不涉及。

    level

    Integer

    参数解释：

    风险等级。

    取值范围：

    1

    suggest

    String

    参数解释：

    建议升级原因。

    取值范围：

    无风险为空。

    influence

    String

    参数解释：

    升级影响。

    取值范围：

    无风险为空。

    guidance

    String

    参数解释：

    指导链接。

    取值范围：

    无风险为空。

    service_impact_duration

    String

    参数解释：

    业务影响时长。

    取值范围：

    无风险为空。

    upgrade_duration

    String

    参数解释：

    升级时长。

    取值范围：

    无风险为空。
  • 正常响应样例 
    {
  "risks": [
    {
      "instance_id": "d697f4a676d64e68a323711e559b021din03",
      "engine_name": "postgresql",
      "engine_version": "1.0.21",
      "level": 1,
      "suggest": "版本会偶现XX的问题，建议客户业务低峰期升级小版本到最新版本。如对上述风险或者版本信息有疑问，您可登录华为云官网提交工单进行咨询。",
      "influence": "升级会重启实例，服务可能会出现1次30秒内的闪断，请您尽量在业务低峰期执行该操作，并确保您的应用有自动重连机制。",
      "guidance": "https://support.huaweicloud.com/usermanual-rds/rds_pg_05_0003.html",
      "service_impact_duration": "升级数据库内核小版本会重启RDS for PostgreSQL实例，服务会出现一定时间的业务中断，中断时长和业务量相关，请您尽量在业务低峰期执行该操作，或确保您的应用有自动重连机制",
      "upgrade_duration": "10~15分钟"
    }
  ]
}

状态码

错误码

请参见错误码。

父主题： API v3

相关文档