大版本升级（PostgreSQL）

功能介绍

PostgreSQL数据库升级大版本。

• 调用接口前，您需要了解API 认证鉴权。

调试

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

接口约束

• 该接口仅支持PostgreSQL引擎。
• 实例在创建、变更规格、修改端口、冻结、异常等状态下不能执行该操作。
• 升级前必须确保存在有效的升级检查报告。检查报告的低版本与当前版本一致，检查报告的目标版本与请求体中目标版本一致，检查时间为7天内且检查结果为成功。

URI

• URI格式

  POST /v3/{project_id}/instances/{instance_id}/major-version/upgrade

• 参数说明

  表1 参数说明

  名称	参数类型	是否必选	说明
  project_id	String	是	租户在某一Region下的项目ID。 获取方法请参见获取项目ID。
  instance_id	String	是	实例ID。

请求消息

• 请求参数

  名称	参数类型	是否必选	说明
  target_version	String	是	目标版本。 高于实例当前的大版本，如当前为12，目标版本需要是13或14。
  is_change_private_ip	Boolean	是	是否将实例内网IP切换到目标大版本实例。 true：升级后切换当前实例的内网IP到目标大版本实例。 false：升级后当前实例的内网IP不变，目标大版本实例使用新的内网IP。
  statistics_collection_mode	String	否	统计信息收集方式。“is_change_private_ip”为“true”时必选。 before_change_private_ip：将实例内网IP切换到目标大版本实例前收集。 after_change_private_ip：将实例内网IP切换到目标大版本实例后收集。

• 请求参数样例

  https://{Endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/3aa441c4c98a4b36b100a7e3e87d17cein03/major-version/upgrade
  {
     "target_version":  "14.6.1",
     "is_change_private_ip":  true,
     "statistics_collection_mode":  "before_change_private_ip"
  }

响应消息

• 正常响应要素说明

  表2 参数说明

  名称	参数类型	说明
  job_id	String	任务ID。

• 正常响应样例

  {
     "job_id": "3afe25b7-4523-4d3b-8236-7121be922691"
  }

• 异常响应

  请参见异常请求结果。

状态码

• 正常

  200

• 异常

  请参见状态码。

错误码

请参见错误码。