批量数据库补丁升级-UpgradingtheMinorVersionsofDBInstancesinBatches

功能介绍

批量升级数据库补丁版本。

接口约束

只支持即时升级，请选择在业务低峰期进行升级。
只支持“升级时长最短优先模式”升级模式。

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
dds:instance:batchUpgradeDatabaseVersion
write
-
-
-
-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
dds:instance:batchUpgradeDatabaseVersion	write	-	-	-	-

URI

POST /v3/{project_id}/instances/db-upgrade

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：租户在某一region下的project ID。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：从IAM服务获取的用户Token。请参考认证鉴权。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

表3 请求Body参数
参数	是否必选	参数类型	描述
instance_ids	是	Array of strings	参数解释：指定需要升级数据库补丁版本的实例ID列表。约束限制：一次最多可传入10个实例ID。取值范围：不涉及。默认取值：不涉及。

响应参数

状态码： 202

表4 响应Body参数
参数	参数类型	描述
upgrade_results	Array of objects	参数解释：批量升级结果。详情请参见表5。取值范围：不涉及。

表5 UpgradeResult
参数	参数类型	描述
job_id	String	参数解释：任务ID。仅当补丁版本升级任务提交成功时返回该字段。取值范围：不涉及。
instance_id	String	参数解释：实例ID。取值范围：不涉及。
error_code	String	参数解释：错误码。仅当补丁版本升级任务提交失败时返回该字段。取值范围：不涉及。
error_message	String	参数解释：失败原因。仅当补丁版本升级任务提交失败时返回该字段。取值范围：不涉及。

请求示例

URI样例

POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/db-upgrade

批量升级数据库补丁版本。

{ 
  "instance_ids" : [ "046287aae57843b1a7bc61b7a8812f41in02", "3d1e04f49efa473a8c7eaf07ed7ff870in02" ] 
}

响应示例

状态码： 202

Accepted.

{ 
  "upgrade_results" : [ { 
    "instance_id" : "046287aae57843b1a7bc61b7a8812f41in02", 
    "job_id" : "e4616470-733d-41de-a9b0-a260709293d3" 
  }, { 
    "instance_id" : "3d1e04f49efa473a8c7eaf07ed7ff870in02", 
    "error_code" : "DBS.200011", 
    "error_message" : "The status of DB instance does not allow the operation." 
  } ] 
}