响应示例 状态码： 200 Success { "instances" : [ { "id" : "8436a91546294036b75931e879882200in06", "name" : "nosql-efa6", "status" : "normal", "port" : "8635", "mode" : "Cluster", "region" : "aaa", "datastore" : { "type" : "Cassandra", "version" : "3.11", "whole_version" : "3.11.3.11204", "patch_available" : false }, "engine" : "rocksDB", "created" : "2019-01-17T07:05:52", "updated" : "2019-01-17T07:05:47", "db_user_name" : "rwuser", "vpc_id" : "674e9b42-cd8d-4d25-a2e6-5abcc565b961", "subnet_id" : "f1df08c5-71d1-406a-aff0-de435a51007b", "security_group_id" : "7aa51dbf-5b63-40db-9724-dad3c4828b58", "backup_strategy" : { "start_time" : "16:00-17:00", "keep_days" : 7 }, "pay_mode" : 0, "maintenance_window" : "02:00-06:00", "groups" : [ { "id" : "0b0ff12541794e1084f6827e424be2d6gr06", "status" : "creating", "volume" : { "size" : 10, "used" : 0.33 }, "nodes" : [ { "id" : "233eaac9c6f245c0bb9c2d21eea12d1bno06", "name" : "nosql-efa6_priam_node_1", "status" : "normal", "subnet_id" : "f1df08c5-71d1-406a-aff0-de435a51007b", "private_ip" : "192.168.0.174", "spec_code" : "geminidb.redis.xlarge.4", "availability_zone" : "bbb" }, { "id" : "d57d76d6320a4a7b86db82c317550c4ano06", "name" : "nosql-efa6_priam_node_2", "status" : "normal", "subnet_id" : "f1df08c5-71d1-406a-aff0-de435a51007b", "private_ip" : "192.168.0.175", "spec_code" : "geminidb.redis.xlarge.4", "availability_zone" : "bbb" }, { "id" : "f46b0a1cf4d9400e9fd7af17f8742d37no06", "name" : "nosql-efa6_priam_node_3", "status" : "normal", "subnet_id" : "f1df08c5-71d1-406a-aff0-de435a51007b", "private_ip" : "192.168.0.176", "spec_code" : "geminidb.redis.xlarge.4", "availability_zone" : "bbb" } ] } ], "enterprise_project_id" : "0", "availability_zone": "cn-north-4a,cn-north-4b,cn-north-4c", "time_zone" : "", "actions" : [ "CREATE" ], "lb_ip_address" : "192.168.11.145", "lb_port" : "8635" }, { "id" : "1236a91546294036b75931e879882200in02", "name" : "nosql-efa7", "status" : "normal", "port" : "8635", "mode" : "ReplicaSet", "region" : "aaa", "datastore" : { "type" : "ReplicaSet", "version" : "4.0", "patch_available" : false }, "engine" : "rocksDB", "created" : "2019-01-17T07:05:52", "updated" : "2019-01-17T07:05:47", "db_user_name" : "rwuser", "vpc_id" : "674e9b42-cd8d-4d25-a2e6-5abcc565b961", "subnet_id" : "f1df08c5-71d1-406a-aff0-de435a51007b", "security_group_id" : "7aa51dbf-5b63-40db-9724-dad3c4828b58", "backup_strategy" : { "start_time" : "16:00-17:00", "keep_days" : 7 }, "pay_mode" : 0, "maintenance_window" : "02:00-06:00", "groups" : [ { "id" : "0b0ff12541794e1084f6827e424be2d1gr02", "status" : "normal", "volume" : { "size" : 100, "used" : 0.003 }, "nodes" : [ { "id" : "233eaac9c6f245c0bb9c2d21eea12d1bno02", "name" : "nosql-efa7_replica_node_2", "status" : "normal", "role" : "Primary", "subnet_id" : "f1df08c5-71d1-406a-aff0-de435a51007b", "private_ip" : "192.168.0.174", "public_ip" : "10.154.217.134", "spec_code" : "geminidb.mongodb.xlarge.4", "availability_zone" : "bbb" }, { "id" : "d57d76d6320a4a7b86db82c317550c4ano02", "name" : "nosql-efa7_replica_node_1", "status" : "normal", "role" : "Secondary", "subnet_id" : "f1df08c5-71d1-406a-aff0-de435a51007b", "private_ip" : "192.168.0.39", "spec_code" : "geminidb.mongodb.xlarge.4", "availability_zone" : "bbb" }, { "id" : "f46b0a1cf4d9400e9fd7af17f8742d37no02", "name" : "nosql-efa7_replica_node_3", "status" : "normal", "role" : "Secondary", "subnet_id" : "f1df08c5-71d1-406a-aff0-de435a51007b", "private_ip" : "192.168.0.176", "spec_code" : "geminidb.mongodb.xlarge.4", "availability_zone" : "bbb" } ] } ], "enterprise_project_id" : "0", "availability_zone": "cn-north-4a,cn-north-4b,cn-north-4c", "time_zone" : "", "actions" : [ ] } ], "total_count" : 2 }

请求示例 URI样例 查询所有实例列表和详情 GET https://gaussdb-nosql.cn-north-4.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances URI样例 根据指定条件查询实例列表和详情 GET https://gaussdb-nosql.cn-north-4.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances?offset=0&limit=10&id=ed7cc6166ec24360a5ed5c5c9c2ed726in06&name=hy&mode=Cluster&datastore_type=cassandra&vpc_id=19e5d45d-70fd-4a91-87e9-b27e71c9891f&subnet_id=bd51fb45-2dcb-4296-8783-8623bfe89bb7

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 instances Array of ListInstancesResult objects 参数解释： 实例信息。 total_count Integer 参数解释： 总记录数。 取值范围： 不涉及。 表5 ListInstancesResult 参数 参数类型 描述 id String 参数解释： 实例ID。 取值范围： 不涉及。 name String 参数解释： 实例名称。 取值范围： 不涉及。 status String 参数解释： 实例状态。 取值范围： normal，表示实例正常。 abnormal，表示实例异常。 creating，表示实例创建中。 frozen，表示实例被冻结。 data_disk_full，表示实例磁盘已满。 createfail，表示实例创建失败。 enlargefail，表示实例扩容节点个数失败。 port String 参数解释： 数据库端口。 取值范围： 不涉及。 mode String 参数解释： 实例类型。 取值范围： 与请求参数相同。 product_type String 参数解释： 产品类型。GeminiDB Redis云原生部署模式集群涉及此字段。 取值范围： Standard 标准型 Capacity 容量型 region String 参数解释： 实例所在区域。 取值范围： 不涉及。 datastore ListInstancesDatastoreResult object 参数解释： 数据库信息。 engine String 参数解释： 存储引擎。 取值范围： “rocksDB”。 created String 参数解释： 实例创建时间。 取值范围： 不涉及。 updated String 参数解释： 实例操作最新变更的时间。 取值范围： 不涉及。 db_user_name String 参数解释： 默认用户名。 取值范围： “rwuser”。 vpc_id String 参数解释： 虚拟私有云ID。 取值范围： 不涉及。 subnet_id String 参数解释： 子网ID。 取值范围： GeminiDB Cassandra 实例使用多个子网的场景，请参见表 ListInstancesNodeResult字段数据结构说明中的“subnet_id”。 security_group_id String 参数解释： 安全组ID。 取值范围： 不涉及。 backup_strategy ListInstancesBackupStrategyResult object 参数解释： 备份策略。 pay_mode String 参数解释： 计费方式。 取值范围： 取值为“0”，表示按需计费。 取值为“1”，表示包年/包月计费。 maintenance_window String 参数解释： 系统可维护时间窗。 取值范围： 不涉及。 groups Array of ListInstancesGroupResult objects 参数解释： 组信息。 enterprise_project_id String 参数解释： 企业项目ID。 取值范围： “0”，表示为default企业项目。 time_zone String 参数解释： 时区。 取值范围： 不涉及。 actions Array of strings 参数解释： 实例正在执行的动作。示例： CREATE REBOOT RESTORE dedicated_resource_id String 参数解释： 专属资源ID，只有数据库实例属于专属资源池才会返回该参数。 取值范围： 不涉及。 lb_ip_address String 参数解释： 负载均衡IP。 约束限制： 只有存在负载均衡IP，才会返回该参数。 取值范围： 不涉及。 lb_port String 参数解释： 负载均衡端口。 约束限制： 只有存在负载均衡ip，才会返回该参数。 取值范围： 不涉及。 availability_zone String 参数解释： 实例可用区。 取值范围： 不涉及。 表6 ListInstancesDatastoreResult 参数 参数类型 描述 type String 参数解释： 数据库接口。 取值范围： 不涉及。 version String 参数解释： 数据库版本号。 取值范围： 不涉及。 patch_available Boolean 参数解释： 当前实例是否有可升级的补丁。 取值范围： true，可以通过升级补丁接口进行数据库升级。 false，不可以通过升级补丁接口进行数据库升级。 whole_version String 参数解释： 数据库的完整版本号。 约束限制： 目前只有GeminiDB Cassandra支持 取值范围： 不涉及。 表7 ListInstancesBackupStrategyResult 参数 参数类型 描述 start_time String 参数解释： 备份时间段。自动备份将在该时间段内触发。当前时间指UTC时间。 取值范围： 不涉及。 keep_days Integer 参数解释： 已生成备份文件可以保存的天数。 取值范围： 0~35。 表8 ListInstancesGroupResult 参数 参数类型 描述 id String 参数解释： 组ID。 取值范围： 不涉及。 status String 参数解释： 组状态。 取值范围： normal，表示组正常。 abnormal，表示组异常。 creating，表示组创建中。 createfail，表示组创建失败。 deleted，表示组被删除。 resizefailed，表示组规格变更失败。 enlargefail，表示组扩容失败。 volume Volume object 参数解释： volume信息 nodes Array of ListInstancesNodeResult objects 参数解释： 节点信息。 表9 Volume 参数 参数类型 描述 size String 参数解释： 磁盘大小。单位：GB。 取值范围： 不涉及。 used String 参数解释： 磁盘使用量。单位：GB。 取值范围： 不涉及。 表10 ListInstancesNodeResult 参数 参数类型 描述 id String 参数解释： 节点ID。 取值范围： 不涉及。 name String 参数解释： 节点名称。 取值范围： 不涉及。 status String 参数解释： 节点状态。 取值范围： normal，表示节点正常。 abnormal，表示节点异常。 creating，表示节点创建中。 createfail，表示节点创建失败。 deleted，表示节点被删除。 resizefailed，表示节点规格变更失败。 enlargefail，表示节点扩容失败。 role String 参数解释： 节点角色。 约束限制： 该参数仅对GeminiDB Mongo接口的副本集实例有效。 取值范围： 不涉及。 subnet_id String 参数解释： 节点所在的子网的ID。 取值范围： 不涉及。 private_ip String 参数解释： 节点内网IP。 约束限制： 在弹性云服务器创建成功后参数值存在，否则，值为""。 取值范围： 不涉及。 public_ip String 参数解释： 绑定的公网IP。 约束限制： 该参数仅针对绑定了公网IP的节点有效。 取值范围： 不涉及。 spec_code String 参数解释： 资源规格编码。关于实例的规格信息，请参见查询数据库规格中响应参数“flavors.spec_code”的值。 取值范围： 不涉及。 availability_zone String 参数解释： 可用区。 取值范围： 不涉及。 support_reduce Boolean 参数解释： 是否支持节点缩容。 取值范围： true，表示该节点支持节点缩容。 false，表示该节点不支持节点缩容。

URI GET https://{Endpoint}/v3/{project_id}/instances 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释： 租户在某一region下的project ID。获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 表2 Query参数 参数 是否必选 参数类型 描述 id 否 String 参数解释： 实例ID。 约束限制： 如果id以“*”起始，表示按照“*”后面的值模糊匹配，否则，按照实际填写的id精确匹配查询。 取值范围： 不涉及。 默认取值： 不涉及。 name 否 String 参数解释： 实例名称。 约束限制： 如果name以“*”起始，表示按照“*”后面的值模糊匹配，否则，按照实际填写的name精确匹配查询。 说明： 如果实例名称中包含中文，暂时不支持通过中文模糊搜索。 取值范围： 不涉及。 默认取值： 不涉及。 datastore_type 否 String 参数解释： 数据库类型。 约束限制： 不涉及。 取值范围： 取值为“cassandra”，表示查询GeminiDB Cassandra数据库实例。 取值为“mongodb”，表示GeminiDB Mongo查询数据库实例。 取值为“influxdb”，表示查询GeminiDB Influx数据库实例。 取值为“redis”，表示查询GeminiDB Redis数据库实例。 默认取值： 如果不传该参数，表示查询所有数据库实例。 mode 否 String 参数解释： 实例类型。 约束限制： 不涉及。 取值范围： 取值为“Cluster”，表示GeminiDB Cassandra、GeminiDB Influx、GeminiDB Redis 经典部署模式Proxy集群实例类型。 取值为“CloudNativeCluster”，表示GeminiDB Cassandra、GeminiDB Influx、GeminiDB Redis云原生部署模式集群实例类型。 取值为“RedisCluster”，表示GeminiDB Redis 经典部署模式Cluster集群实例类型。 取值为“Replication”，表示GeminiDB Redis经典部署模式主备实例类型。 取值为“InfluxdbSingle”，表示GeminiDB Influx经典部署模式单节点实例类型。 取值为“ReplicaSet”，表示GeminiDB Mongo副本集实例类型。 如果不传datastore_type参数，自动忽略该参数设置。 默认取值： 不涉及。 vpc_id 否 String 参数解释： 虚拟私有云ID，获取方法如下： 方法1：登录虚拟私有云服务的控制台界面，在虚拟私有云的详情页面查找VPC ID。 方法2：通过虚拟私有云服务的API接口查询，具体操作可参考查询VPC列表。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 subnet_id 否 String 参数解释： 子网的网络ID，获取方法如下： 方法1：登录虚拟私有云服务的控制台界面，单击VPC下的子网，进入子网详情页面，查找网络ID。 方法2：通过虚拟私有云服务的API接口查询，具体操作可参考查询子网列表。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 offset 否 Integer 参数解释： 索引位置偏移量，表示从指定project ID下最新的实例创建时间开始，按时间的先后顺序偏移offset条数据后查询对应的实例信息。 约束限制： 不涉及。 取值范围： 取值大于或等于0。 默认取值： 不传该参数时，查询偏移量默认为0，表示从最新的实例创建时间对应的实例开始查询。 limit 否 Integer 参数解释： 查询实例个数上限值。 约束限制： 不涉及。 取值范围： 1~100。 默认取值： 不传该参数时，默认查询前100条实例信息。

请求示例 URI样例 POST https://gaussdb-nosql.cn-north-7.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/db-upgrade 请求示例 批量升级数据库补丁版本： { "instance_ids" : [ "046287aae57843b1a7bc61b7a8812f41in13", "3d1e04f49efa473a8c7eaf07ed7ff870in13" ] }

响应示例 状态码： 202 Accepted { "upgrade_results" : [ { "instance_id" : "046287aae57843b1a7bc61b7a8812f41in13", "job_id" : "e4616470-733d-41de-a9b0-a260709293d3" }, { "instance_id" : "3d1e04f49efa473a8c7eaf07ed7ff870in13", "error_code" : "DBS.200011", "error_message" : "The status of DB instance does not allow the operation." } ] }

响应参数 状态码： 202 表4 响应Body参数 参数 参数类型 描述 upgrade_results Array of UpgradeResult objects 批量升级结果。 表5 UpgradeResult 参数 参数类型 描述 job_id String 任务ID。仅当补丁版本升级任务提交成功时返回该字段。 instance_id String 实例ID。 error_code String 错误码。仅当补丁版本升级任务提交失败时返回该字段。 error_message String 失败原因。仅当补丁版本升级任务提交失败时返回该字段。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。

操作步骤 登录 分布式数据库 中间件控制台。 在“实例管理”页面，选择指定的目标实例，单击实例名称。 在实例基本信息页面，单击“实例信息”模块的“版本变更”。 图1 版本升级 在弹窗中选择目标版本，系统会根据您选择的版本号执行相应的版本升级或者版本降级操作。 图2 选择目标版本 单击“立即变更”，在弹窗中单击“是”立即进行版本变更操作。 图3 确认变更 版本变更时，实例状态为“升级中”或者“降级中”。版本变更完成后，实例状态变为“运行中”，版本将显示变更后的版本号。 图4 版本降级中

实例状态 实例状态是DDM实例的运行情况。用户可以使用管理控制台查看DDM实例状态。 表1 实例状态 分类 状态 说明 正常 运行中 DDM实例正常和可用。 异常 创建失败 DDM实例创建失败。 异常 DDM实例不可用。 部分节点异常 DDM实例部分节点不可用。 备份失败 备份实例失败。 冻结 账户余额小于或等于0元，系统对该用户下的实例进行冻结。您需前往费用中心充值成功，欠款核销后，冻结的实例才会解冻。 动作执行中 创建中 正在创建DDM实例。 备份中 正在备份实例。 恢复中 正在恢复备份到实例中。 升级中 正在进行实例内核版本升级。 回滚中 正在进行实例内核版本回滚。 切换SSL中 正在进行实例SSL切换。 端口修改中 正在修改DDM实例的服务端口。 删除中 正在删除DDM实例。 重启中 正在重启DDM实例。 节点扩容中 正在扩容该实例下的节点个数。 节点缩容中 正在缩容该实例下的节点个数。 规格变更中 正在变更实例的CPU和内存规格。 转包周期中 按需付费实例正在转为包周期实例。 正在创建组 正在为节点创建分组。 正在删除组 正在删除节点分组。 创建逻辑库中 正在创建逻辑库 删除逻辑库中 正在删除逻辑库 父主题： 实例管理

注意事项 实例版本说明 部分版本的 堡垒机 升级至最新实例版本时，需要执行两次升级。因此升级实例版本前，请先确认 云堡垒机 当前设备系统的版本，并确认升级流程，如表1所示。 表1 升级云堡垒机实例版本至最新版本流程说明 升级前云堡垒机实例版本 升级至最新实例版本操作流程 3.3.37.0及以下版本 需进行两次升级。 第一次升级：从当前版本升级至3.3.37.5版本，升级期间不能回退。 第二次升级：从3.3.37.5版本升级至最新版本。 3.3.38.0~3.3.50.0版本（含3.3.38.0和3.3.50.0） 需进行两次升级。 第一次升级：从原版本升级至3.3.50.3版本，该步骤升级期间不可回退。 第二次升级：从3.3.50.3版本升级至最新版本。 3.3.52.0及以上版本（最新版本除外） 直接从当前已安装版本升级至最新版本即可。 升级前 为防止因升级失败而影响使用，建议升级前备份数据，备份说明请参见备份CBH数据。 定时升级，时间需一天的间隔，建议您在无业务使用时升级，设置定时升级任务后，不能关机，重启，变更，扩容操作，升级任务开始前可以取消，重新设置升级时间。 升级中 版本升级过程约需要30min，版本升级期间云堡垒机系统不可用，但不影响主机资源运行。但在升级期间，建议用户不要登录云堡垒机系统进行操作，以免重要数据丢失。 版本升级完成或者跨版本升级过程中，您可以在堡垒机实例详情页面选择“版本回退”，版本回退开始后堡垒机“运行状态”会变为“版本回滚中”。 升级后 版本升级完成后会自动“重启”云堡垒机，重启完成后，即可使用云堡垒机。 版本升级后用户可正常继续使用原有配置和存储数据，升级不影响系统原有配置和存储数据。 跨版本升级成功后有七天回退保留期，超过七天不可回退（请升级完成后及时验证堡垒机内的数据）。 升级后的扩容操作不可回退，在升级完成后，如您需要进行扩容操作请等待5分钟后再进行，且务必在验证数据无误后再进行扩容或变更操作。 跨版本升级成功后，实例ID，服务器ID，实例版本号和创建时间会发生变化。 堡垒机跨版本升级会自动开放80、8080、443、2222共四个端口，升级完成后若不需要使用请第一时间关闭。 主备实例跨版本升级会自动开放22、31036、31679、31873共四个端口，升级完成后保持31679开放即可，其余端口若不需要使用请第一时间关闭。 跨版本升级前请您注意是否有在该实例中导入过Web证书，若升级前已导入，请在升级完成后重新导入一次。 版本回退 版本回退后版本会变为升级前的版本状态，升级后修改或新增的数据会丢失，并且因为数据回滚会导致当前堡垒机业务中断，请您谨慎操作。

URI GET /v5/{project_id}/batch-async-jobs/{async_job_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一Region下的Project ID。 获取方法请参见获取项目ID。 async_job_id 是 String 批量异步创建的任务ID，由创建批量异步任务接口返回。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量，表示查询该偏移量后面的记录。 limit 否 Integer 查询返回记录的数量限制。

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 发送的实体的MIME类型。推荐用户默认使用application/json，如果API是对象、镜像上传等接口，媒体类型可按照流类型的不同进行确定。 缺省值：application/json X-Auth-Token 是 String 从 IAM 服务获取的用户Token。 用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 X-Language 否 String 请求语言类型。 缺省值：en-us 枚举值： en-us zh-cn

响应示例 状态码： 200 OK { "jobs" : [ { "id" : "c7debc9c-8e09-4a5d-8dd6-cc44f78jb20r", "status" : "CONFIGURATION", "create_time" : "2022-11-07T16:15:18Z", "base_info" : { "name" : "DRS-1234", "job_type" : "sync", "engine_type" : "oracle-to-gaussdbv5", "job_direction" : "up", "task_type" : "FULL_INCR_TRANS", "net_type" : "eip", "charging_mode" : "on_demand", "enterprise_project_id" : "0", "description" : "", "expired_days" : 14, "tags" : [ { "key" : "test", "value" : "test" } ] }, "source_endpoint" : [ { "db_type" : "oracle", "endpoint_type" : "offline", "endpoint_role" : "so", "endpoint" : { "id" : "f59e6118-da89-4fdb-9b98-65f56709928a", "endpoint_name" : "oracle", "ip" : "10.154.217.239", "db_port" : "1521", "db_user" : "ORACLE_USER", "db_name" : "serviceName.orcl" }, "ssl" : { "ssl_link" : false } } ], "target_endpoint" : [ { "db_type" : "gaussdbv5", "endpoint_type" : "cloud", "endpoint_role" : "ta", "endpoint" : { "id" : "10deb576-8885-473b-a213-4d76e668dc0d", "endpoint_name" : "cloud_gaussdbv5", "instance_id" : "c2c7579bc09c490b9d8009db715aeb0ain14", "db_user" : "root" }, "cloud" : { "region" : "cn-north-4", "project_id" : "9dc8c0f3f74c4dbb23c29cf0318ee561", "az_code" : "cn-north-4a,cn-north-4g,cn-north-4c" }, "vpc" : { "vpc_id" : "2cb5d364-ae63-4fbb-85b7-7d59f4a88f8f", "subnet_id" : "2cb54324-ae63-4fbb-85b7-7d59f4a88f8f", "security_group_id" : "039a3s89-665a-43e2-9b4f-bda7d9ee148d" } } ], "alarm_notify" : { "alarm_to_user" : true, "topic_urn" : "urn:smn:cn-north-4:f2c2468c3ee7410c862a461ca073d2f2:test", "delay_time" : 60 }, "speed_limit" : [ { "begin" : "16:00", "end" : "15:59", "speed" : "10" } ], "policy_config" : { "ddl_trans" : false }, "node_info" : { "spec" : { "node_type" : "medium" } } }, { "id" : "dc6016cf-f3b6-4c2d-b4d7-5084b0fjb20r", "status" : "INCRE_TRANSFER_STARTED", "create_time" : "2022-11-05T15:32:22Z", "base_info" : { "name" : "DRS-2345", "job_type" : "sync", "engine_type" : "oracle-to-gaussdbv5", "job_direction" : "up", "task_type" : "FULL_INCR_TRANS", "net_type" : "vpn", "charging_mode" : "on_demand", "enterprise_project_id" : "0", "description" : "", "expired_days" : 14, "tags" : [ { "key" : "test", "value" : "test" } ] }, "source_endpoint" : [ { "db_type" : "oracle", "endpoint_type" : "offline", "endpoint_role" : "so", "endpoint" : { "id" : "6a2aea81-c01d-4313-b93e-6a17f9351c51", "endpoint_name" : "oracle", "ip" : "10.154.227.134", "db_port" : "1521", "db_user" : "ORACLE_USER", "db_name" : "serviceName.orcl" }, "ssl" : { "ssl_link" : false } } ], "target_endpoint" : [ { "db_type" : "gaussdbv5", "endpoint_type" : "cloud", "endpoint_role" : "ta", "endpoint" : { "id" : "f59e6118-da89-4fdb-9b98-65f56709928a", "endpoint_name" : "cloud_gaussdbv5", "instance_id" : "c2c7579bc09c490b9d8009db715aeb0ain14", "db_user" : "root" }, "cloud" : { "region" : "cn-north-4", "project_id" : "9dc8c0f3f74c4dbb23c29cf0318ee561", "az_code" : "cn-north-4a,cn-north-4g,cn-north-4c" }, "vpc" : { "vpc_id" : "2cb5d364-ae63-4fbb-85b7-7d59f4a88f8f", "subnet_id" : "2cb54324-ae63-4fbb-85b7-7d59f4a88f8f", "security_group_id" : "039a3s89-665a-43e2-9b4f-bda7d9ee148d" }, "ssl" : { "ssl_link" : false } } ], "policy_config" : { "ddl_trans" : false }, "node_info" : { "spec" : { "node_type" : "high" } } } ], "total_count" : 2 } 状态码： 400 Bad Request { "error_code" : "DRS.10000001", "error_msg" : "Failed." }

请求示例 创建MySQL单机实例。 POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances { "name": "rds-instance-rep2", "datastore": { "type": "MySQL", "version": "5.7" }, "flavor_ref": "rds.mysql.s1.large", "volume": { "type": "ULTRAHIGH", "size": 100 }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "region": "cn-north-4", "availability_zone": "cn-north-4a", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "data_vip": "192.168.0.1", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "port": 8635, "backup_strategy": { "start_time": "08:15-09:15", "keep_days": 12 }, "charge_info": { "charge_mode": "postPaid" }, "password": "****", "configuration_id": "452408-ef4b-44c5-94be-305145fg", "enterprise_project_id": "fdsa-3rds", "time_zone": "UTC+04:00", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ], "dry_run": false, "count": 12 } 创建PostgreSQL单机实例。 { "name": "rds-instance-rep2", "datastore": { "type": "PostgreSQL", "version": "10" }, "flavor_ref": "rds.pg.s1.large", "volume": { "type": "ULTRAHIGH", "size": 100 }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "region": "cn-north-4", "availability_zone": "cn-north-4a", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "data_vip": "192.168.0.147", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "port": 8635, "backup_strategy": { "start_time": "08:15-09:15", "keep_days": 12 }, "charge_info": { "charge_mode": "postPaid" }, "password": "Test@12345678", "configuration_id": "452408-ef4b-44c5-94be-305145fg", "enterprise_project_id": "fdsa-3rds", "time_zone": "UTC+04:00", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ] } 创建MySQL 8.0单机实例指定初始化参数。 { "name": "rds-instance-rep2", "datastore": { "type": "MySQL", "version": "8.0" }, "flavor_ref": "rds.mysql.s1.large", "volume": { "type": "ULTRAHIGH", "size": 100 }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "region": "cn-north-4", "availability_zone": "cn-north-4a", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "data_vip": "192.168.0.1", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "port": 8635, "backup_strategy": { "start_time": "08:15-09:15", "keep_days": 12 }, "charge_info": { "charge_mode": "postPaid" }, "password": "****", "configuration_id": "452408-ef4b-44c5-94be-305145fg", "enterprise_project_id": "fdsa-3rds", "time_zone": "UTC+04:00", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ], "unchangeable_param": { "lower_case_table_names": "1" }, "dry_run": false, "count": 12 } 创建SQL Server单机实例支持指定字符集。 { "name": "rds-instance-rep2", "datastore": { "type": "SQLServer", "version": "2014_SE" }, "flavor_ref": "rds.mssql.se.m3.large.8", "volume": { "type": "ULTRAHIGH", "size": 100 }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "region": "cn-north-4", "availability_zone": "cn-north-4a", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "data_vip": "192.168.0.1", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "port": 8635, "backup_strategy": { "start_time": "08:15-09:15", "keep_days": 12 }, "charge_info": { "charge_mode": "postPaid" }, "collation": "Cyrillic_General_CI_AS", "password": "****", "configuration_id": "452408-ef4b-44c5-94be-305145fg", "enterprise_project_id": "fdsa-3rds", "time_zone": "UTC+04:00", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ], } DeC用户创建MySQL单机实例。 { "name": "rds-instance-rep2", "datastore": { "type": "MySQL", "version": "5.7" }, "flavor_ref": "rds.mysql.s1.large", "volume": { "type": "ULTRAHIGH", "size": 100 }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "region": "cn-north-4", "availability_zone": "cn-north-4a", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "data_vip": "192.168.0.1", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "port": 8635, "backup_strategy": { "start_time": "08:15-09:15", "keep_days": 12 }, "charge_info": { "charge_mode": "postPaid" }, "password": "****", "configuration_id": "452408-ef4b-44c5-94be-305145fg", "enterprise_project_id": "fdsa-3rds", "time_zone": "UTC+04:00", "dsspool_id":"3278327382738217382173872183721837213", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ], "dry_run": false, "count": 12 } 创建主备实例。 { "name": "rds-instance-rep2", "datastore": { "type": "MySQL", "version": "5.7" }, "ha": { "mode": "ha", "replication_mode": "semisync" }, "flavor_ref": "rds.mysql.s1.large.ha", "volume": { "type": "ULTRAHIGH", "size": 100 }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "region": "cn-north-4", "availability_zone": "cn-north-4a,cn-north-4b", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "data_vip": "192.168.0.1", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "port": 8635, "backup_strategy": { "start_time": "08:15-09:15", "keep_days": 12 }, "charge_info": { "charge_mode": "postPaid" }, "password": "****", "configuration_id": "452408-ef4b-44c5-94be-305145fg", "enterprise_project_id": "fdsa-3rds", "time_zone": "UTC+04:00", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ], "dry_run": false, "count": 12 } DeC用户创建MySQL主备实例。 { "name": "rds-instance-rep2", "datastore": { "type": "MySQL", "version": "5.7" }, "ha": { "mode": "ha", "replication_mode": "semisync" }, "flavor_ref": "rds.mysql.s1.large.ha", "volume": { "type": "ULTRAHIGH", "size": 100 }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "region": "cn-north-4", "availability_zone": "cn-north-4a,cn-north-4b", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "data_vip": "192.168.0.1", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "port": 8635, "backup_strategy": { "start_time": "08:15-09:15", "keep_days": 12 }, "charge_info": { "charge_mode": "postPaid" }, "password": "****", "configuration_id": "452408-ef4b-44c5-94be-305145fg", "enterprise_project_id": "fdsa-3rds", "time_zone": "UTC+04:00", "dsspool_id":"327832738273821772133432，21489938273821772133432", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ], "dry_run": false, "count": 12 } 创建只读实例。 { "name": "rds-instance-rep2", "replica_of_id": "afdsad-fds-fdsagin01", "flavor_ref": "rds.mysql.s1.large.rr", "volume": { "type": "ULTRAHIGH", "size": 100 }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "region": "cn-north-4", "availability_zone": "cn-north-4a", "enterprise_project_id": "fdsa-3rds", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ] } DeC用户创建只读实例。 { "name": "rds-instance-rep2", "replica_of_id": "afdsad-fds-fdsagin01", "flavor_ref": "rds.mysql.s1.large.rr", "volume": { "type": "ULTRAHIGH" }, "disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4", "region": "cn-north-4", "availability_zone": "cn-north-4a", "enterprise_project_id": "fdsa-3rds" "dsspool_id":"3278327382738217382173872183721837213", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ] 创建MySQL Serverless型单机实例。 { "name": "rds-instance-serverless1", "datastore": { "type": "MySQL", "version": "5.7" }, "flavor_ref": "rds.mysql.serverless", "volume": { "type": "CLOUDSSD", "size": 40 }, "region": "cn-north-4", "availability_zone": "cn-north-4a", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "port": 3306, "backup_strategy": { "start_time": "08:15-09:15", "keep_days": 12 }, "password": "****", "time_zone": "UTC+04:00", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ], "dry_run": false, "count": 1, "serverless_info": { "min_cap": "0.5", "max_cap": "1" } } 创建MySQL Serverless型主备实例。 { "name": "rds-instance-serverless2", "datastore": { "type": "MySQL", "version": "5.7" }, "ha": { "mode": "ha", "replication_mode": "semisync" }, "flavor_ref": "rds.mysql.serverless.ha", "volume": { "type": "CLOUDSSD", "size": 40 }, "region": "cn-north-4", "availability_zone": "cn-north-4a,cn-north-4b", "vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce", "subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f", "security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5", "port":3306, "backup_strategy": { "start_time": "08:15-09:15", "keep_days": 12 }, "password": "****", "time_zone": "UTC+08:00", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ], "dry_run": false, "count": 1, "serverless_info": { "min_cap": "0.5", "max_cap": "1" } }

URI URI格式 GET /v3/{project_id}/instances/{instance_id}/db-auto-upgrade 参数说明 表1 参数说明 名称 是否必选 参数类型 说明 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 非空。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 String 参数解释： 实例ID。 约束限制： 非空。 取值范围： 不涉及。 默认取值： 不涉及。