华为云用户手册

请求消息 请求参数 无。 URI样例 GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/cee5265e1e5845649e354841234567dfin01/auditlog?start_time=2019-11-06T09:00:00+0800&end_time=2019-11-07T10:40:15+0800&offset=0&limit=10

URI URI格式 GET /v3/{project_id}/instances/{instance_id}/auditlog?start_time={start_time}&end_time={end_time}&offset={offset}&limit={limit} 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 参数解释： 要查询的实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 start_time 是 参数解释： 查询开始时间。 约束限制： 不涉及。 取值范围： 格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 默认取值： 不涉及。 end_time 是 参数解释： 查询结束时间。 约束限制： 不涉及。 取值范围： 格式为“yyyy-mm-ddThh:mm:ssZ”，且大于查询开始时间，时间跨度不超过30天。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 默认取值： 不涉及。 offset 是 参数解释： 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询，值为0表示从第一条数据开始查询）。 约束限制： 必须为数字，不能为负数。 取值范围： 大于等于0的整数。 默认取值： 0 limit 是 参数解释： 查询记录数。 约束限制： 不涉及。 取值范围： [1, 50] 默认取值： 不涉及。

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 slow_log_list Array of objects 参数解释： 具体信息。 详情请参见表3。 total_record Integer 参数解释： 总记录数。 取值范围： 不涉及。 表3 slow_log_list字段数据结构说明 名称 参数类型 说明 count String 参数解释： 执行次数。 取值范围： 不涉及。 time String 参数解释： 执行时间。 取值范围： 不涉及。 lock_time String 参数解释： 等待锁时间。 取值范围： 不涉及。 rows_sent String 参数解释： 结果行数量。 取值范围： 不涉及。 rows_examined String 参数解释： 扫描的行数量。 取值范围： 不涉及。 database String 参数解释： 所属数据库。 取值范围： 不涉及。 users String 参数解释： 账号。 取值范围： 不涉及。 query_sample String 参数解释： 执行语法。慢日志默认脱敏显示，如需明文显示，请联系客服人员添加白名单。 取值范围： 不涉及。 type String 参数解释： 语句类型。 取值范围： 不涉及。 start_time String 参数解释： 发生时间，UTC时间。 取值范围： 不涉及。 client_ip String 参数解释： IP地址。 取值范围： 不涉及。 正常响应样例 { "total_record": 1, "slow_log_list": [ { "count": "1", "time": "1.04899 s", "lock_time": "0.00003 s", "rows_sent": "0", "rows_examined": "0", "database": "mysql", "users": "root", "query_sample": "INSERT INTO time_zone_name (Name, Time_zone_id) VALUES (N, @time_zone_id);", "type": "INSERT", "start_time": "2018-08-06T10:41:14", "client_ip": "192.*.*.1" } ] } 异常响应 请参见异常请求结果。

URI URI格式 GET /v3.1/{project_id}/instances/{instance_id}/slowlog?start_date={start_date}&end_date={end_date} 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 参数解释： 要查询的实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 start_date 是 参数解释： 开始时间。 约束限制： 不涉及。 取值范围： 格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 默认取值： 不涉及。 end_date 是 参数解释： 结束时间。 约束限制： 只能查询当前时间前一个月内的慢日志。 取值范围： 格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 默认取值： 不涉及。 offset 否 参数解释： 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。 约束限制： 支持最多查询数据库最近的2000条慢日志信息。 取值范围： 必须为数字，不能为负数。参数值须满足offset + limit取值小于等于2000。示例：offset取值为1900，limit取值100。 默认取值： 默认为0。偏移0条数据，表示从第一条数据开始查询。 limit 否 参数解释： 每页多少条记录（查询结果）。 约束限制： 不涉及。 取值范围： 1~100 默认取值： 不填时默认为10。 type 否 参数解释： SQL语句类型。 约束限制： 不涉及。 取值范围： 取空值，表示查询所有语句类型，也可指定如下日志类型： INSERT UPDATE SELECT DELETE CREATE 默认取值： 不涉及。

URI URI格式 GET /v3/{project_id}/datastores/{database_name} 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 database_name 是 参数解释： 数据库引擎。 约束限制： 不涉及。 取值范围： 支持的引擎如下，不区分大小写： MySQL PostgreSQL SQLServer 默认取值： 不涉及。

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 dataStores Array of objects 参数解释： 数据库版本信息列表。 详情请参见表3。 表3 dataStores字段数据结构说明 名称 参数类型 说明 id String 参数解释： 数据库版本ID，该字段不会有重复。 取值范围： 不涉及。 name String 参数解释： 数据库版本号。 取值范围： 对于MySQL引擎可以返回小版本号，例如MySQL 5.6.51版本，将返回5.6.51。 对于PostgreSQL和SQL Server引擎，只返回两位数的大版本号，例如PostgreSQL 9.6.X版本，仅返回9.6。 正常响应样例 { "dataStores": [{ "id": "87620726-6802-46c0-9028-a8785e1f1921", "name": "8.0.21" }, { "id": "87620726-6802-46c0-9028-a8785e1f1922", "name": "5.7.33" }, { "id": "e8a8b8cc-63f8-4fb5-8d4a-24c502317a62", "name": "5.6.51" }] } 异常响应 请参见异常请求结果。

请求示例 复制一个新的参数模板，名称为copy_by_v31。 POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/configurations/66251c9024774eeb9edd8663a4cbb0a1pr04/copy { "name" : "copy_by_v31", "description" : "copy" }

响应消息 正常响应要素说明 表3 要素说明 名称 参数类型 说明 id String 参数解释： 参数模板ID。 取值范围： 不涉及。 name String 参数解释： 参数模板名称。 取值范围： 不涉及。 description String 参数解释： 描述。 取值范围： 不涉及。 datastore_version_name String 参数解释： 数据库版本名称。 取值范围： 不涉及。 datastore_name String 参数解释： 数据库名称。 取值范围： 不涉及。 create_time String 参数解释： 创建时间。 取值范围： 格式为“yyyy-MM-ddTHH:mm:ssZ”。其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 update_time String 参数解释： 更新时间。 取值范围： 格式为“yyyy-MM-ddTHH:mm:ssZ”。其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 正常响应样例 { "id" : "a73a272e50ba427397e90992fbb96f3cpr04", "name" : "copy_by_v31", "description" : "copy", "datastore_version_name" : "2017_EEmysql5.7", "datastore_name" : "sqlservermysql", "create_time" : "2022-10-31T08:24:06+0000", "update_time" : "2022-10-31T08:24:06+0000" } 异常响应 请参见异常请求结果。

URI URI格式 POST /v3/{project_id}/configurations/{config_id}/copy 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 config_id 是 参数解释： 参数模板ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

响应消息 正常响应要素说明 表3 要素说明 名称 参数类型 说明 total_count Integer 总记录数。 instance_dr_infos Array of objects 容灾信息列表。 详情请参见表4。 表4 instance_dr_infos字段说明 名称 参数类型 说明 id String 容灾关系ID。 status String 容灾搭建状态。 failed_message String 失败消息。 replica_state String 同步状态。取值范围是0或-1，0表示正常，-1表示异常。 wal_write_receive_delay_in_mb String 发送延迟大小（MB），即主实例当前wal日志写入位点与灾备实例当前接收wal日志位点的差值。 wal_write_replay_delay_in_mb String 端到端延迟大小（MB），即主实例当前wal日志写入位点与灾备实例当前回放wal日志位点的差值。 wal_receive_replay_delay_in_ms String 回放延迟时间（ms），即数据在灾备上回放的延迟时间。 master_instance_id String 主实例ID。 master_region String 主实例所在Region。 slave_instance_id String 灾备实例ID。 slave_region String 灾备实例所在Region。 build_process String 搭建流程。 master，表示配置主实例容灾能力流程。 slave，表示配置灾备实例容灾能力流程。 time Long 灾备搭建时间。 正常响应样例 { "total_count": 1, "instance_dr_infos": [ { "id": "57160f82-e6bb-44bc-80db-0d950d4f3b40", "status": "failed", "failed_message": "the network is disconnected", "replica_state": "0", "wal_write_receive_delay_in_mb": "10.0", "wal_write_replay_delay_in_mb": "10.0", "wal_receive_replay_delay_in_ms": "0", "master_instance_id": "fab4e3df67c24aa0a5b41bc2bcb41918in03", "master_region": "region-A", "slave_instance_id": "df50adb922ef42a495943b304f8aa551in03", "slave_region": " region-B", "time": 1702551254685 } ] } 异常响应 请参见异常请求结果。

请求示例 POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/disaster-recovery-infos { "status": "normal", "order": "ASC", "sort_field": "time", "offset": 0, "limit": 10 }

请求消息 表2 参数说明 名称 是否必选 参数类型 说明 id 否 String 容灾关系ID。 status 否 String 容灾搭建状态。 master_instance_id 否 String 主实例ID。 master_region 否 String 主实例Region。 slave_instance_id 否 String 灾备实例ID。 slave_region 否 String 灾备实例Region。 create_at_start 否 Long 创建起始时间。 create_at_end 否 Long 创建结束时间。 order 否 String 排序方式。 DESC，降序。 ASC，升序。 默认降序。 sort_field 否 String 排序字段。 status 容灾搭建状态。 time 容灾搭建时间。 master_region 主实例region。 slave_region 灾备实例region 默认容灾搭建时间。 offset 否 Integer 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。 limit 否 Integer 查询记录数。默认为10，不能为负数，最小值为1，最大值为100。

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

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 node_id String 参数解释： 实例的节点ID。 取值范围： 不涉及。 used String 参数解释： 磁盘空间使用量（单位GB）。 取值范围： 不涉及。 正常响应样例 { "node_id" : "0314958daf6904c478d17c642ac209abbin01", "used" : "14.21" } 异常响应 请参见异常请求结果。

请求消息 表2 参数说明 名称 是否必选 参数类型 说明 all_users 是 Boolean 参数解释： 是否设置全部数据库用户。 约束限制： 不涉及。 取值范围： true：设置全部数据库用户读写权限，忽略user_name参数。 false：单独设置user_name用户读写权限。 默认取值： 不涉及。 user_name 否 String 参数解释： 数据库用户名称。 约束限制： 不涉及。 取值范围： 数据库用户名称在1到63个字符之间，由字母、数字、或下划线组成，不能包含其他特殊字符，不能以“pg”和数字开头，不能和系统用户名称相同。系统用户包括“rdsAdmin”,“ rdsMetric”, “rdsBackup”, “rdsRepl”,“ rdsProxy”, “rdsDdm”。 默认取值： 不涉及。 readonly 是 Boolean 参数解释： 是否为只读权限。 约束限制： 不涉及。 取值范围： true：只读。 false：可读可写。 默认取值： 不涉及。

请求示例 设置全部数据库用户只读。 POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/f569f1358436479dbcba8603c32cc4aein03/user-privilege { "all_users": true, "readonly": true } 设置全部数据库用户可读可写。 { "all_users": true, "readonly": false } 设置单个数据库用户只读。 { "all_users": false, "user_name": "test1234", "readonly": true } 设置单个数据库用户可读可写 { "all_users": false, "user_name": "test1234", "readonly": false }

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

请求示例 修改MySQ L实例 的参数值。 PUT https://{endpoint}/v3.1/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/configurations { "values" : { "div_precision_increment": "6", "connect_timeout": "20", "binlog_checksum" : "CRC32", "innodb_purge_threads" : "4" } } 修改PostgreSQL实例的参数值。 { "values" : { "autovacuum" : "on", "bytea_output" : "escape", "client_encoding" : "UTF8", "cpu_tuple_cost" : "0.01" } } 修改SQL Server实例的参数值。 { "values":{ "max server memory (MB)":"26317", "max degree of parallelism":"4" } }

接口约束 支持的数据库引擎：MySQL、PostgreSQL、Microsoft SQL Server。 修改的参数必须在指定数据库版本的默认参数范围内，具体可配置范围请参见《云数据库RDS用户指南》中“修改RDS for MySQL实例参数”的内容。 敏感参数，例如：“lower_case_table_names”，修改存在风险，详情请参见《云数据库RDS用户指南》中“RDS for MySQL参数调优建议”的内容。

URI URI格式 PUT https://{Endpoint}/v3.1/{project_id}/instances/{instance_id}/configurations 参数说明 表1 参数说明 名称 是否必选 说明 project_id 是 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

响应消息 正常响应要素说明 表3 要素说明 参数 参数类型 描述 job_id String 参数解释： 任务ID。 取值范围： 不涉及。 restart_required Boolean 参数解释： 实例是否需要重启。 取值范围： true：需要重启。 false：不需要重启。 正常响应样例 { "job_id" : "e7a7535b-eb9b-45ac-a83a-020dc5016d94", "restart_required" : false } 异常响应 请参见异常请求结果。

请求消息 表2 参数说明 名称 是否必选 参数类型 说明 resize_flavor 是 Object 请参见表3。 表3 resize_flavor字段数据结构说明 名称 是否必选 参数类型 说明 spec_code 是 String 资源规格编码。例如：rds.mysql.m1.xlarge。其中，rds代表RDS产品，mysql代表数据库引擎，m1.xlarge代表性能规格，为高内存类型。带"rr"的表示只读实例规格，反之表示单实例和HA实例规格。 is_auto_pay 否 Boolean 变更包周期实例的规格时可指定，表示是否自动从客户的账户中支付。 true，为自动支付。 false，为手动支付，默认该方式。 is_delay 否 Boolean 是否进行定时规格变更，该参数目前仅支持MySQL。 true，为定时变更，将在运维时间窗内进行变更操作。 false，为即时变更，默认该方式。

请求示例 变更MySQL数据库实例的规格为rds.mysql.m1.xlarge。 POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/action { "resize_flavor": { "spec_code": "rds.mysql.m1.xlarge", "is_auto_pay": true, "is_delay": true } } 变更PostgreSQL数据库实例的规格为rds.pg.c2.medium.ha。 { "resize_flavor": { "spec_code": "rds.pg.c2.medium.ha", "is_auto_pay": true } } 变更SQL Server数据库实例的规格为rds.mssql.2014.se.s3.large.2。 { "resize_flavor": { "spec_code": "rds.mssql.2014.se.s3.large.2", "is_auto_pay": true } }

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 versions Object 参数解释： API版本详细信息列表。 详情请参见表3。 version Object 参数解释： API版本详细信息列表。 详情请参见表3。 表3 versions字段数据结构说明 名称 参数类型 说明 id String 参数解释： API版本号。 取值范围： 不涉及。 links Array 参数解释： 对应该API版本的链接信息，该字段为空。 详情请参见表4。 status String 参数解释： 版本状态。 取值范围： 不涉及。 updated String 参数解释： 版本更新时间。 取值范围： 格式为“yyyy-mm-dd Thh:mm:ssZ”。 其中，T指某个时间的开始；Z指UTC时间。 表4 links字段数据结构说明 名称 参数类型 说明 href String 参数解释： 对应该API的URL。 取值范围： 该字段为""。 rel String 参数解释： URL类型。 取值范围： 取值为“self”，表示href为本地链接。 正常响应样例 { "version": { "id": "v1", "links": [], "status": "DEPRECATED", "updated": "2017-02-07T17:34:02Z" }, "versions": { "id": "v1", "links": [], "status": "DEPRECATED", "updated": "2017-02-07T17:34:02Z" } } 异常响应 请参见异常请求结果。

响应消息 正常响应要素说明 表2 要素说明 名称 是否必选 参数类型 说明 binlog_retention_hours 是 Integer 二进制日志保留时间。 binlog_clear_type 否 String 二进制日志保留策略，取值：time、fast time：表示按时长保留二进制文件。 fast：表示快速清理，不保留二进制文件。 正常响应样例 { "binlog_retention_hours": 3, "binlog_clear_type": "time" } 异常响应 请参见异常请求结果。

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 quotas Object 参数解释： 配额列表对象。 详情请参见表3。 表3 quotas字段数据结构说明 名称 参数类型 说明 resources Array of objects 参数解释： 资源列表对象。 详情请参见表4。 表4 resources字段数据结构说明 名称 参数类型 说明 quota Integer 参数解释： 项目资源配额。 取值范围： 不涉及。 used Integer 参数解释： 已使用的资源数量。 取值范围： 不涉及。 type String 参数解释： 项目资源类型。 取值范围： instance：实例类型资源。 正常响应样例 { "quotas" : { "resources" : [ { "quota" : 100, "used" : 1, "type" : "instance" } ] } } 异常响应 请参见异常请求结果。

响应消息 正常响应要素说明 表3 要素说明 参数 参数类型 描述 数组元素 Array of objects 参数解释： 参数列表。 详情请参见表4。 表4 参数说明 名称 参数类型 说明 status String 参数解释： 修改结果。 取值范围： success：已生效。 failed：未生效。 setting：设置中。 time String 参数解释： 修改时间。 取值范围： 不涉及。 fail_reason String 参数解释： 修改失败原因。 取值范围： 不涉及。 before_confs Array of objects 参数解释： 修改之前的值。 详情请参见表5。 after_confs Array of objects 参数解释： 修改之后的值。 详情请参见表6。 表5 before_confs字段说明 参数 参数类型 描述 type String 参数解释： 连接类型。 取值范围： 枚举值：host、hostssl、hostnossl。 database String 参数解释： 数据库名。 取值范围： 除template0，template1的数据库名，多个以逗号隔开。 user String 参数解释： 除内置用户（rdsAdmin, rdsMetric, rdsBackup, rdsRepl, rdsProxy）以外的用户名。 取值范围： 值为all：表示当前实例的所有数据库用户。 值为具体的用户名，多个以逗号隔开。 address String 参数解释： 客户端IP地址。0.0.0.0/0表示允许用户从任意IP地址访问数据库。 取值范围： 不涉及。 mask String 参数解释： 掩码。 取值范围： 默认为空字符串。 method String 参数解释： 认证方式。 取值范围： 枚举值：reject、md5、scram-sha-256。 priority Integer 参数解释： 优先级，表示配置的先后。 取值范围： 不涉及。 表6 after_confs字段说明 参数 参数类型 描述 type String 参数解释： 连接类型。 取值范围： 枚举值：host、hostssl、hostnossl。 database String 参数解释： 数据库名。 取值范围： 除template0，template1的数据库名，多个以逗号隔开。 user String 参数解释： 除内置用户（rdsAdmin, rdsMetric, rdsBackup, rdsRepl, rdsProxy）以外的用户名。 取值范围： 值为all：表示当前实例的所有数据库用户。 值为具体的用户名，多个以逗号隔开。 address String 参数解释： 客户端IP地址。0.0.0.0/0表示允许用户从任意IP地址访问数据库。 取值范围： 不涉及。 mask String 参数解释： 掩码。 取值范围： 默认为空字符串。 method String 参数解释： 认证方式。 取值范围： 枚举值：reject、md5、scram-sha-256。 priority Integer 参数解释： 优先级，表示配置的先后。 取值范围： 不涉及。 正常响应样例 [ { "status" : "success", "time" : "2023-08-01 09:00:00", "fail_reason" : "", "before_confs" : [ { "type" : "host", "database" : "all", "user" : "all", "address" : "0.0.0.0/0", "mask" : "", "method" : "md5", "priority" : 0 } ], "after_confs" : [ { "type" : "hostssl", "database" : "all", "user" : "all", "address" : "0.0.0.0/0", "mask" : "", "method" : "md5", "priority" : 0 } ] } ]

请求消息 请求参数 无。 URI样例 GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/e28979107ed04d3b8b2f1b819b8d2be3in03/hba-info/history?start_time=2023-08-01 00:00:00&end_time=2023-08-03 00:00:00

URI URI格式 GET /v3/{project_id}/instances/{instance_id}/msdtc/hosts?offset={offset}&limit={limit} 参数说明 表1 参数说明 参数 是否必选 参数类型 说明 project_id 是 String 参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 instance_id 是 String 参数解释： 实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 offset 否 Integer 参数解释： 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。 约束限制： 不涉及。 取值范围： 必须为数字，不能为负数。 默认取值： 默认为0，偏移0条数据，表示从第一条数据开始查询。 limit 否 Integer 参数解释： 查询记录数。 约束限制： 不涉及。 取值范围： 1~100 默认取值： 10

响应消息 正常响应要素说明 表2 要素说明 名称 参数类型 说明 total_count Integer 参数解释： host总数。 取值范围： 不涉及。 hosts Array of objects 参数解释： host列表。 详情请参见表3。 表3 hosts元素结构说明 名称 参数类型 说明 id String 参数解释： host ID。 取值范围： 不涉及。 host String 参数解释： host地址。 取值范围： 不涉及。 host_name String 参数解释： host名称。 取值范围： 不涉及。 正常响应样例 { "total_count" : 1, "hosts" : [ { "id" : "527dd9ca-cc2c-4bac-8707-f9b4f55343f4", "host" : "192.168.0.90", "host_name" : "MSSQL-00E5FB7A" } ] } 异常响应 请参见异常请求结果。