华为云用户手册

URI GET https://{Endpoint}/v3/{project_id}/scheduled-jobs 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。 表2 Query参数 参数 是否必选 参数类型 描述 job_name 否 String 任务名称，默认为空。对应取值如下： "RESIZE_FLAVOR"：变更实例的CPU和内存规格 job_status 否 String 任务执行状态，默认为空。 取值： 值为"Pending"，表示任务未执行。 值为"Running"，表示任务正在执行。 值为"Completed"，表示任务执行成功。 值为"Failed"，表示任务执行失败。 值为"Canceled"，表示任务取消执行。 instance_id 否 String 实例ID，不传该值默认查所有符合条件的实例。 start_time 否 String 任务创建起始时间，格式为"yyyy-mm-ddThh:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量，例如偏移1个小时显示为+0100，不传默认为当前时间前七天。 end_time 否 String 任务创建结束时间，格式为"yyyy-mm-ddThh:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量，例如偏移1个小时显示为+0100，不传默认为当前时间。 offset 否 Integer 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询，默认为0。 limit 否 Integer 查询记录数。不传该参数时，默认为10，取值范围1-100。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 histories Array of objects 实例参数的修改历史列表。详情请参见表5。 表5 ConfigurationModifyHistoryInfo 参数 参数类型 描述 parameter_name String 参数名称。 old_value String 修改前的值。 new_value String 修改后的值。 update_result String 更新结果。 applied Boolean 是否被应用。 true: 已被应用。 false: 未被应用。 updated_at String 修改时间，格式为"yyyy-MM-ddTHH:mm:ssZ"。其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 applied_at String 应用时间，格式为"yyyy-MM-ddTHH:mm:ssZ"。其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码： default 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。

响应示例 { "histories" : [ { "parameter_name" : "rateLimit.mbps", "old_value" : "500", "new_value" : "350", "update_result" : "SUC CES S", "applied" : true, "updated_at" : "2022-06-07T09:25:45+0000", "applied_at" : "2022-06-07T09:25:45+0000" } ] }

URI GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/configuration-histories 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户在某一region下的project ID。 instance_id 是 String 实例ID。 表2 Query参数 参数 是否必选 参数类型 描述 entity_id 否 String 实例ID或组ID或节点ID。可以调用“查询实例列表和详情”接口获取。如果未申请实例，可以调用“创建实例”接口创建。 当获取的实例类型是集群，如果获取的是shard组或者config组的参数模板，传值为组ID。如果获取的是mongos节点的参数模板，传值为节点ID。 当获取的实例类型是副本集或单节点，传值为实例ID。 当获取的实例类型是只读节点，传值为节点ID。 offset 否 Integer 索引位置，偏移量。 从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询）。 取值必须为数字，不能为负数。 limit 否 Integer 查询个数上限值。 取值范围: 1~100。 不传该参数时，默认查询前100条信息。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 is_existed Boolean 参数组名称是否存在。 true：参数组名称存在 false：参数组名称不存在 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码： 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码： default 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。

响应参数 状态码： 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 失败原因。仅当补丁版本升级任务提交失败时返回该字段。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。

响应示例 状态码： 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." } ] }

请求示例 批量升级数据库补丁版本。 POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/db-upgrade { "instance_ids" : [ "046287aae57843b1a7bc61b7a8812f41in02", "3d1e04f49efa473a8c7eaf07ed7ff870in02" ] }

URI URI格式 POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/nodes/{node_id}/primary URI样例 https://dds.cn-north-1.myhuaweicloud.com/v3/2900b7b8d03e4619b8db8d43bc6234ee/instances/b54ea2b393034728b8582e1c4b5b4c88in02/nodes/639371286e95457394914f734e1ed6feno02/primary 表1 请求参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从 IAM 服务获取的用户Token。请参考认证鉴权。 project_id 是 String 租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。 instance_id 是 String 实例ID，可以调用“查询实例列表和详情”接口获取。如果未申请实例，可以调用“创建实例”接口创建。 node_id 是 String 备节点ID。

URI URI格式 GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/kill-op-rule URI样例 https://dds.cn-north-1.myhuaweicloud.com/v3/2900b7b8d03e4619b8db8d43bc6234ee/instances/70ddf44609734098a8d333f25a368976in02/kill-op-rule?namespaces=test.ym&plan_summary=COLLSCAN 表1 请求参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从IAM服务获取的用户Token。请参考认证鉴权。 project_id 是 String 租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。 instance_id 是 String 实例ID，可以调用“查询实例列表和详情”接口获取。如果未申请实例，可以调用“创建实例”接口创建。 表2 Query参数 参数 是否必选 参数类型 描述 operation_types 否 String Sql语句操作类型。 insert，表示插入语句。 update，表示更新语句。 query，表示查询语句。 command，表示命令语句。 remove，表示删除语句。 getmore，表示获取更多数据语句。 namespaces 否 String 表命名空间。取值格式：库名或者库名.表名。 可为空，表示不做限制。 单独库名，表示对某个库下的所有集合生效。 库名.表名，表示对具体库下的具体的集合生效。 status 否 String killOp规则状态。 ENABLED，规则生效中。 DISABLED，规则禁用中。 plan_summary 否 String 执行计划。默认值空，表示不做限制。 COLLSCAN SORT_KEY_GENERATOR SKIP LIMIT GEO_NEAR_2DSPHERE GEO_NEAR_2D AGGREGATE OR offset 否 Integer 索引位置，偏移量。 从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询）。取值必须为数字，不能为负数。 limit 否 Integer 查询个数上限值。 取值范围: 1~100。 不传该参数时，默认查询前100条信息。

响应消息 参数说明 表3 响应Body参数 参数 参数类型 说明 rules Array of 表4 列表。 total_count Integer 总数。 表4 KillOpRule参数 参数 参数类型 说明 id String killOp规则ID。 operation_types String Sql语句操作类型。最多支持同时选择6种语句类型。同时选择多种类型时，匹配任意一种类型时规则生效。 insert，表示插入语句。 update，表示更新语句。 query，表示查询语句。 command，表示命令语句。 remove，表示删除语句。 getmore，表示获取更多数据语句。 status String killOp规则状态。 ENABLED，规则生效中。 DISABLED，规则禁用中。 namespaces String 表命名空间。取值格式：库名或者库名.表名。同时配置多组信息时，匹配任意一组信息时规则生效。 目前仅支持配置一组信息 可为空，表示不做限制。 单独库名，表示对某个库下的所有集合生效。 库名.表名，表示对具体库下的具体的集合生效。 client_ips String 客户端连接IP。 只支持IPV4。 可为空，表示不做限制。 最多支持配置5个IP，同时配置多个IP时，匹配任意一个IP时规则生效。 plan_summary String 执行计划。默认值空，表示不做限制。 COLLSCAN SORT_KEY_GENERATOR SKIP LIMIT GEO_NEAR_2DSPHERE GEO_NEAR_2D AGGREGATE OR max_concurrency Integer 最大并发数。 取值：不能为负数，可为空，默认为0，表示不做限制，最小值为1，最大值为100000。 secs_running Integer 单条操作最大运行时长。 取值：不能为负数，可为空，默认为0，表示不做限制。单位：s。最小值为2，最大值为86400。 node_type String 节点类型。 mongos_shard，表示同时在mongos和shard节点生效。 mongos，表示只在集群mongos节点生效。 shard，表示只在集群shard节点生效。 replica，表示只在副本集节点生效。 响应示例 killOp规则列表： { "rules" : [ { "operation_types" : [ "query", "insert" ], "namespaces" : [ "db.collections" ], "client_ips" : [ "172.168.201.144" ], "status" : "ENABLED", "id" : "f6f2cea4-ce40-4d4c-9d2f-61253d215811", "plan_summary" : "COLLSCAN", "max_concurrency" : 0, "secs_running" : 5, "node_type" : "replica" } ], "total_count" : 1 }

URI URI格式 DELETE https://{Endpoint}/v3/{project_id}/instances/{instance_id}/kill-op-rule URI样例 https://dds.cn-north-1.myhuaweicloud.com/v3/2900b7b8d03e4619b8db8d43bc6234ee/instances/6390733773d64a748f3a7bc88df22384in02/kill-op-rule 表1 请求参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从IAM服务获取的用户Token。请参考认证鉴权。 project_id 是 String 租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。 instance_id 是 String 实例ID，可以调用“查询实例列表和详情”接口获取。如果未申请实例，可以调用“创建实例”接口创建。

URI URI格式 PUT https://{Endpoint}/v3/{project_id}/instances/{instance_id}/kill-op-rule URI样例 https://dds.cn-north-1.myhuaweicloud.com/v3/2900b7b8d03e4619b8db8d43bc6234ee/instances/6390733773d64a748f3a7bc88df22384in02/kill-op-rule 表1 请求参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从IAM服务获取的用户Token。请参考认证鉴权。 project_id 是 String 租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。 instance_id 是 String 实例ID，可以调用“查询实例列表和详情”接口获取。如果未申请实例，可以调用“创建实例”接口创建。

请求消息 参数说明 表2 请求Body参数 参数 是否必选 参数类型 描述 ids 是 Array of strings killOp规则ID列表。 action 是 String 启用/禁用 killOp规则。 enable，启用killOp规则。 disable，禁用killOp规则。 请求示例 { "ids" : [ "7d2f36b4-6edb-4093-8c78-810b30232943" ], "action" : "enable" }

请求消息 参数说明 表2 Query参数 参数 是否必选 参数类型 描述 operation_types 是 Array of strings Sql语句操作类型。最多支持同时选择6种语句类型。同时选择多种类型时，匹配任意一种类型时规则生效。 insert，表示插入语句。 update，表示更新语句。 query，表示查询语句。 command，表示命令语句。 remove，表示删除语句。 getmore，表示获取更多数据语句。 namespaces 否 Array of strings 表命名空间。取值格式：库名或者库名.表名。同时配置多组信息时，匹配任意一组信息时规则生效。 目前仅支持配置一组信息 可为空，表示不做限制。 单独库名，表示对某个库下的所有集合生效。 库名.表名，表示对具体库下的具体的集合生效。 client_ips 否 Array of strings 客户端连接IP。 只支持IPV4。 可为空，表示不做限制。 最多支持配置5个IP，同时配置多个IP时，匹配任意一个IP时规则生效。 plan_summary 否 String 执行计划。默认值空，表示不做限制。 COLLSCAN SORT_KEY_GENERATOR SKIP LIMIT GEO_NEAR_2DSPHERE GEO_NEAR_2D AGGREGATE OR max_concurrency 否 Integer 最大并发数。 取值：不能为负数，可为空，默认为0，表示不做限制，最小值为1，最大值为100000。 max_concurrency和secs_running不可同时为0。 secs_running 否 Integer 单条操作最大运行时长。 可为空，默认为0，表示不做限制。单位：s。最小值为2，最大值为86400。 secs_running和max_concurrency不可同时为0。 node_type 是 String 节点类型。 mongos_shard，表示同时在mongos和shard节点生效。 mongos，表示只在集群mongos节点生效。 shard，表示只在集群shard节点生效。 replica，表示只在副本集节点生效。 请求示例 { "operation_types" : [ "query", "insert" ], "namespaces" : [ "db.collections" ], "client_ips" : [ "172.168.201.144" ], "plan_summary" : "COLLSCAN", "max_concurrency" : 0, "secs_running" : 5, "node_type" : "replica" }

URI URI格式 POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/kill-op-rule URI样例 https://dds.cn-north-1.myhuaweicloud.com/v3/2900b7b8d03e4619b8db8d43bc6234ee/instances/6390733773d64a748f3a7bc88df22384in02/kill-op-rule 表1 请求参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从IAM服务获取的用户Token。请参考认证鉴权。 project_id 是 String 租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。 instance_id 是 String 实例ID，可以调用“查询实例列表和详情”接口获取。如果未申请实例，可以调用“创建实例”接口创建。

URI URI格式 GET https://{Endpoint}/v3/{project_id}/instances/logs/lts-configs URI样例 https://dds.ap-southeast-1.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/logs/lts-configs?offset=0&limit=10 表1 请求参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从IAM服务获取的用户Token。请参考认证鉴权。 project_id 是 String 租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。 limit 否 Integer 查询记录数。取值范围：0~50。不传该参数时，默认查询前50条实例的云服务日志配置信息。

响应消息 参数说明 表3 响应Body参数 参数 参数类型 说明 instance_lts_configs Array of 表4 objects 每个实例的LTS日志配置信息和实例简要信息。 total_count Integer 全部可查询的云服务日志配置结果个数，等于所有DDS实例的个数。 表4 instance_lts_configs 参数 参数类型 说明 instance 表5 object 实例的简要信息。 lts_configs Array of 表 lts_configs objects LTS日志配置明细。从未设置LTS日志流，不返回该字段。 表5 instance 参数 参数类型 说明 id String 实例ID。 name String 实例名字。 mode String 实例类型，对应单节点，副本集，集群三种。 枚举值： Single Replica Sharding datastore 表6 object 实例的数据库引擎和版本。 status String 实例状态。 enterprise_project_id String 实例归属的企业项目ID，如果是default企业项目，值为0，如果是其他企业项目，请参考企业项目相关内容。 actions Array of strings 实例所有正在执行的动作。 表6 datastore 参数 参数类型 说明 type String 数据库引擎，值为mongodb。 枚举值： mongodb version String 数据库大版本。 表7 lts_configs 参数 参数类型 说明 log_type String LTS日志类型，不能为空，具有以下日志类型。 audit_log 枚举值： audit_log lts_group_id String 云日志服务LTS 日志组ID。 lts_stream_id String 云日志 服务LTS日志流ID。 enabled Boolean 是否上传。 响应示例 { "total_count" : 1, "instance_lts_configs" : [ { "instance" : { "id" : "520c58ba00a3497e97ce0b9604874dd6in02", "name" : "dds-1f84", "mode" : "Single", "datastore" : { "type" : "mongodb", "version" : 4.0 }, "status" : "normal", "enterprise_project_id" : "0", "actions" : [ "OPS_AUDIT_ LOG " ] }, "lts_configs" : [ { "log_type" : "audit_log", "lts_group_id" : "ec6dc499-1a63-4229-a0c2-a2afa8bcfc95", "lts_stream_id" : "cae69d2e-378b-41dd-b3c9-3ca1cd5335bc", "enabled" : true } ] } ] }

URI URI格式 GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/client-network URI样例 https://dds.cn-north-1.myhuaweicloud.com/v3/0d248ca90800d3902f79c014f11df3b8/instances/593416e7c9da4a4c97c6ad5b086b8ddfin02/client-network 表1 请求参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从IAM服务获取的用户Token。请参考认证鉴权。 project_id 是 String 租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。 instance_id 是 String 实例ID，可以调用“查询实例列表和详情”接口获取。如果未申请实例，可以调用“创建实例”接口创建。

响应消息 参数说明 表2 响应Body参数 参数 参数类型 说明 instance_id String 实例ID。 client_network_ranges Array of strings 客户端所在网段。 跨网段访问配置只有在客户端与副本集实例部署在不同网段的情况下才需要配置，例如访问副本集的客户端所在网段为192.168.0.0/16，副本集所在的网段为172.16.0.0/24，则需要添加跨网段配置192.168.0.0/16才能正常访问。 只有副本集有该功能。 响应示例 { "instance_id": "f400017ff2184ee1bad45f3f247f4936in02", "client_network_ranges": [ "173.12.10.0/9", "132.22.1.1/10" ] }

响应消息 参数说明 表2 参数说明 名称 参数类型 说明 slow_log_list Array of objects 具体信息。 详情请参见表3。 total_record Integer 总记录数。 表3 slow_log_list字段数据结构说明 名称 参数类型 说明 node_name String 节点名称。 query_sample String 执行语法。 type String 语句类型。 time String 执行时间。 lock_time String 等待锁时间。 rows_sent String 结果行数量。 rows_examined String 扫描的行数量。 database String 所属数据库。 start_time String 发生时间，UTC时间。

URI URI格式 GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/slowlog?start_date={start_date}&end_date={end_date} URI样例 查询数据库慢日志： https://dds.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/6ade8143870047b8999aba8f1891b48ein02/slowlog?start_date=2018-08-06T10:41:14+0800&end_date=2018-08-07T10:41:14+0800 根据指定条件查询数据库慢日志： https://dds.cn-north-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/6ade8143870047b8999aba8f1891b48ein02/slowlog?type=INSERT&offset=1&limit=20&node_id=a7c84462483642798cf159237343135fno06&start_date=2018-08-06T10:41:14+0800&end_date=2018-08-07T10:41:14+0800

请求消息 参数说明 表2 请求Body参数 参数 是否必选 参数类型 描述 file_names 是 Array of strings 文件名列表。 请求示例 { "file_names" : [ "054bc9f81e80d2201fccc00b92ad6ec0_audit_log_65ca506de9904366bdf69ca8174250abin02_dda6bd25f6b043518f9574befabc9536no02_1660354924651", "054bc9f81e80d2201fccc00b92ad6ec0_audit_log_65ca506de9904366bdf69ca8174250abin02_dda6bd25f6b043518f9574befabc9536no02_1660354987726" ] }

URI URI格式 DELETE https://{Endpoint}/v3/{project_id}/instances/{instance_id}/auditlog URI样例 https://dds.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/3d39c18788b54a919bab633874c159dfin02/auditlog 表1 请求参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从IAM服务获取的用户Token。请参考认证鉴权。 project_id 是 String 租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。 instance_id 是 String 实例ID，可以调用“查询实例列表和详情”接口获取。如果未申请实例，可以调用“创建实例”接口创建。

URI URI格式 GET /v3/{project_id}/instances/{instance_id}/slowlog-desensitization/status URI样例 https://dds.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/e73893ef73754465a8bd2e0857bbf13ein02/slowlog-desensitization/status 表1 请求参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从IAM服务获取的用户Token。请参考认证鉴权。 project_id 是 String 租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。 instance_id 是 String 实例ID，可以调用“查询实例列表和详情”接口获取。如果未申请实例，可以调用“创建实例”接口创建。

响应消息 参数说明 表2 响应Body参数 参数 参数类型 说明 certs Array of 表3 objects 证书列表。 表3 CertInfo 参数 参数类型 说明 category String 证书种类。枚举值： international。 national。 download_link String 证书下载链接。 响应示例 { "certs" : [ { "category" : "international", "download_link" : "https://obs.xxx.myhuaweicloud.com/xxx/dds/ca-dds.crt" } ] }

URI URI格式 GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/ssl-cert/download-link URI样例 https://dds.cn-north-1.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/e73893ef73754465a8bd2e0857bbf13ein02/ssl-cert/download-link 表1 请求参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从IAM服务获取的用户Token。请参考认证鉴权。 project_id 是 String 租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。 instance_id 是 String 实例ID，可以调用“查询实例列表和详情”接口获取。如果未申请实例，可以调用“创建实例”接口创建。

响应消息 参数说明 表2 响应Body参数 参数 参数类型 说明 volumes Array of 表3 objects 磁盘信息列表。 表3 DiskVolumes 参数 参数类型 说明 entity_id String 实例ID或组ID或节点ID。 entity_name String 实例名称或组名称或节点名称。 group_type String group_type。取值范围： mongos，表示集群mongos节点类型。 shard，表示集群shard节点类型。 config，表示集群config节点类型。 replica，表示副本集类型。 single，表示单节点类型。 readonly，表示只读节点类型。 used String 使用量，保留两位小数，单位(GB)。 size String 总大小，单位(GB)。 响应示例 { "volumes" : [ { "entity_id" : "f04553d9ad2942e7a44facc518dc5699gr02", "entity_name" : "single01", "group_type" : "single", "used" : "3.18", "size" : "60" } ] }

URI URI格式 GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/disk-usage URI样例 https://dds.cn-north-1.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/520c58ba00a3497e97ce0b9604874dd6in02/disk-usage 表1 请求参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从IAM服务获取的用户Token。请参考认证鉴权。 project_id 是 String 租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。 instance_id 是 String 实例ID，可以调用“查询实例列表和详情”接口获取。如果未申请实例，可以调用“创建实例”接口创建。

响应消息 参数说明 表2 响应Body参数 参数 参数类型 说明 strategies Array of 表3 objects 升级策略列表 表3 DurationStrategies 参数 参数类型 说明 strategy String 升级策略。 minimized_interrupt_time，表示最短中断时。 minimized_upgrade_time，最短升级时长。 estimated_upgrade_duration Integer 升级时长，单位为分钟 响应示例 { "strategies" : [ { "strategy" : "minimized_interrupt_time", "estimated_upgrade_duration" : 10 }, { "strategy" : "minimized_upgrade_time", "estimated_upgrade_duration" : 5 } ] }