影响 原“ GaussDB (for openGauss)”更名为GaussDB，相关URL变更请参考GaussDB华为云帮助中心地址切换。 由于更名涉及内容较多，时间较长，更名期间，原“GaussDB(for openGauss)”的计费名称会暂时挂靠在TaurusDB名下，但费用和资源不会有任何变化，该产品的功能使用以及您的业务不会受任何影响。 更名以后原页面URL将只给云数据库 GaussDB使用 ，云数据库 TaurusDB产品控制台请访问产品新页面URL。

GaussDB各版本生命周期 表1 GaussDB各版本生命周期 GaussDB版本号 华为云Release时间 华为云EOM时间 华为云EOFS时间 华为云EOS时间 V2.0-1.4 2021年7月 2022年12月 2023年12月 2024年6月 V2.0-2.0 2021年11月 2022年12月 2025年12月 2026年6月 V2.0-2.3 2022年6月 2023年12月 2026年12月 2027年6月 V2.0-2.7 2022年11月 2023年12月 2026年12月 2027年6月 V2.0-2.8 2023年9月 2023年12月 2026年12月 2027年6月 V2.0-3.208 2023年7月 2024年12月 2027年6月 2027年12月 V2.0-3.220 2023年8月 2024年12月 2027年6月 2027年12月 V2.0-3.222 2023年9月 2024年12月 2027年6月 2027年12月 V2.0-3.223 2023年12月 2024年12月 2027年6月 2027年12月 V2.0-3.226 2024年5月 2024年12月 2027年6月 2027年12月 V2.0-8.201 2024年11月 2026年3月 2028年12月 2029年6月 V2.0-8.210 2024年12月 2026年6月 2028年12月 2029年6月 Release：华为云Release时间指华为云版本发布时间，一般指商用发布到官网时间。 EOM：End of Marketing，停止该版本的销售，指停止云服务版本的销售和部署，现网中不再部署该云服务版本。 EOFS：End of Full Support，版本停止全面支持，指对版本新发现的缺陷停止修复，不再提供新的补丁版本，EOFS之后发现的缺陷将继续进行根因分析并在下一个版本修复, 但版本EOS前都要求具备缺陷和1、2级漏洞的修复能力。 EOS：End of Service & support，停止该版本的服务与支持。云服务版本EOS后，华为云可不再提供针对该版本的任何技术服务支持，包含新问题的定位和缺陷修复等，只能通过升级新版本来解决问题。请遵循华为云生命周期政策，及时进行软件版本升级。

URI DELETE https://{Endpoint}/v3/{project_id}/instances/schedule-task/{task_id} 表1 参数说明 参数 是否必选 参数类型 描述 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 task_id 是 String 任务ID。

URI PUT https://{Endpoint}/v3/{project_id}/instances/schedule-task/{task_id}/cancel 表1 参数说明 参数 是否必选 参数类型 描述 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 task_id 是 String 任务ID。

响应示例 查询任务列表成功。 { "tasks": [ { "status": "Completed", "task_id": "dea835aa-5ceb-4209-be57-ecd7992ed6af", "task_name": "HOTFIX_VERSION_UPGRADE", "create_time": "2024-12-16T06:54:39Z", "start_time": "2024-12-16T06:55:32Z", "instance_id": "54bef6617fab4a88ab52967218c34527in14", "instance_name": "gauss-ba81", "task_content": "3.208.0.6" }, { "status": "Completed", "task_id": "8d93aa3a-20c2-4c53-a3cf-933bde3ba002", "task_name": "HOTFIX_VERSION_UPGRADE", "create_time": "2024-12-16T06:54:39Z", "start_time": "2024-12-16T06:55:32Z", "instance_id": "096d0720b5604eca93b8a216a15d4778in14", "instance_name": "gauss-5185", "task_content": "3.208.0.6" }, { "status": "Completed", "task_id": "5111a1e3-0030-4766-8dd8-7ab73a2e89c4", "task_name": "HOTFIX_VERSION_UPGRADE", "create_time": "2024-12-16T08:51:11Z", "start_time": "2024-12-16T08:53:01Z", "instance_id": "b6ac63d384854e76ba7afd0e10aa9c29in14", "instance_name": "gauss-7fa8", "task_content": "3.208.0.7" } ], "total_count": 3 }

URI GET https://{Endpoint}/v3/{project_id}/instances/schedule-tasks 表1 参数说明 名称 是否必选 参数类型 说明 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 instance_id 否 String 实例节点ID。 status 否 String 任务状态。 Running：运行中 Completed：完成 Failed：失败 Pending：待执行 Canceled：已取消 name 否 String 任务名称。 HOTFIX_VERSION_UPGRADE ：热补丁版本升级。 start_time 否 String 开始时间。 格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 end_time 否 String 结束时间。 格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 offset 否 Integer 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。 limit 否 Integer 查询记录数。默认为100，不能为负数，最小值为1，最大值为100。

响应参数 表2 要素说明 名称 参数类型 说明 tasks Array of objects 任务列表。 详情请参见表3 tasks字段数据结构说明。 total_count Integer 任务数量。 表3 tasks字段数据结构说明 名称 参数类型 说明 task_id String 任务ID。 task_name String 任务名称。 status String 任务状态。 create_time String 创建时间，格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 start_time String 设置开始执行时间，格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 instance_id String 实例ID。 instance_name String 实例名称。 task_content Object 任务信息。

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 instance_ids 是 Array of strings 批量实例ID。 start_time 是 String 任务开始时间。 upgrade_type 是 String 实例升级类型。区分大小写。 取值范围： hotfix：热补丁升级。 upgrade_action 是 String 实例升级操作，热补丁升级目前只包括升级自动提交。 upgradeAutoCommit：升级自动提交。 target_version 是 String 批量实例升级目标版本。

请求示例 批量实例热补丁升级并采用升级自动提交方式升级传参。 POST https://gaussdb-opengauss.cn-north-4.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/db-upgrade/schedule-task { "instance_ids" : [ "cc0ae5c47bf94834bf9e44138f7f995ain14", "aa0ae5c47bf94834bf9e44138f7f995ain14" ], "start_time": "2023-06-06T01:47:20+0800", "upgrade_type" : "hotfix", "upgrade_action" : "upgradeAutoCommit" , "target_version" : "3.208.0.6,3.208.0.7" }

URI POST https://{Endpoint}/v3/{project_id}/instances/db-upgrade/schedule-task 表1 参数说明 参数 是否必选 参数类型 描述 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。

响应示例 { "instance_tasks": [ { "task_id": "07c5880a-cbf0-44ad-91c1-5803a10f11a1", "task_name": "HOTFIX_VERSION_UPGRADE", "instance_id": "cc0ae5c47bf94834bf9e44138f7f995ain14" }, { "task_id": "07c5880a-cbf0-44ad-91c1-5803a10f11a1", "task_name": "HOTFIX_VERSION_UPGRADE", "instance_id": "aa0ae5c47bf94834bf9e44138f7f995ain14" } ] }

响应示例 查询实例引擎版本分布成功。 { "engine_instance_details": [ { "engine_version": "3.220.0", "instances": [ { "status": "normal", "type": "centralization_standard", "solution": "single", "instance_id": "0fd6cb8f0ffe4bba9e98af6f4b403ae8in14", "instance_name": "gauss-472e", "hotfix_versions": "" }, { "status": "normal", "type": "centralization_standard", "solution": "single", "instance_id": "1b5022523d1749abbf2c7a1307cf4378in14", "instance_name": "gauss-2ea0", "hotfix_versions": "3.220.0.11" }, { "status": "normal", "type": "centralization_standard", "solution": "triset", "instance_id": "da46dcee6c414a2eae89203804103981in14", "instance_name": "gauss-515d", "hotfix_versions": "3.220.0.11" } ] }, { "engine_version": "8.102.0", "instances": [ { "status": "normal", "type": "distributed", "solution": "hcs2", "instance_id": "a731423300c14a8c866b2f96243ee9cbin14", "instance_name": "gauss-c704", "hotfix_versions": "" } ] } ], "total_count": 2 }

URI GET https://{Endpoint}/v3/{project_id}/datastore/instances 表1 参数说明 名称 是否必选 参数类型 说明 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母、数字组成，且长度为32个字符。 默认取值： 不涉及。 limit 否 Integer 查询记录数。默认为100，不能为负数，最小值为1，最大值为100。例如该参数设定为10，则查询结果最多只显示10条记录。 offset 否 Integer 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。例如：该参数指定为1，limit指定为10，则只展示第2-11条数据。

响应参数 表2 要素说明 名称 参数类型 说明 engine_instance_details Array of 表3 InstanceEngineDetail说明 objects 实例引擎详情。 total_count integer 总记录数。 表3 InstanceEngineDetail说明 名称 参数类型 说明 engine_version String 引擎版本号。 instances Array of 表4 InstanceDetail说明 objects 实例详情。 表4 InstanceDetail说明 名称 参数类型 说明 instance_id String 实例ID。 instance_name String 实例名称。 status String 实例状态。 type String 实例类型。 solution String 实例部署形态。 hotfix_versions String 已升级热补丁版本。

响应示例 { "records": [ { "id": "f34bf1d7-03f9-4f33-aac5-033457ca86f6", "action": "dr_stream_failover_result", "status": "success", "message": "", "entity_id": "210c7c5c-618d-4ec9-917a-c2681426df85", "entity_type": "dr", "job_id": "b4670be1-3372-4f44-b049-9c145abbb5d9", "instance_id": "083e6e04bc534727954f9d07ac90ab03in14", "created_at": "2024-11-19T11:29:25Z", "updated_at": "2024-11-19T11:29:25Z", "extended_info": { "allExtras": {}, "extraKeys": [], "extra": {} } }, { "id": "0074ead8-a50c-429f-b602-9d70f4a6dc36", "action": "dr_stream_failover", "status": "success", "message": "", "entity_id": "210c7c5c-618d-4ec9-917a-c2681426df85", "entity_type": "dr", "job_id": "b4670be1-3372-4f44-b049-9c145abbb5d9", "instance_id": "083e6e04bc534727954f9d07ac90ab03in14", "created_at": "2024-11-19T11:28:49Z", "updated_at": "2024-11-19T11:28:49Z", "extended_info": { "allExtras": {}, "extraKeys": [], "extra": {} } } ] }