响应 响应参数 响应示例 HTTP/1.1 200 OK Content-Type: application/json;charset=UTF8 { "total": 1, "list": [ { "region_id": "cn-north-7", "host_name": "CN_NORTH_7_E CS ", "vm_list": "[['', '', 'Euler', '[{"cores":"1","model":"","threads":"1","cpu":"16 * 1 * 1 * ","sockets":"16"}]']]", "host_id": "abfa96bc-29f6-4571-bfba-fcfdf6ad6ebb", "host_ip": "xx.xx.xx.xx", "last_update_time": "1726819320000" } ] }

请求 请求header参数 参数 是否必选 类型 值域 说明 X-APIG-Appcode 是 string 无 由SRE分配的AppCode。 x-auth-token 是 string 无 调用方APIG的 IAM 认证token。 x-hcso-domainid 否 string 无 接入的租户ID。HCSO场景必填，其他场景不要求 x-hcso-appcode 是 string 无 由SRE分配的AppCode。 请求body参数 无 请求示例 GET /rest/dataapi/homs/open-api/v1/host/vms?host_id=abfa96bc-29f6-4571-bfba-fcfdf6ad6ebb&offset_value=0&page_size=1 Content-Type: application/json Accept: application/json X-Auth-Token: xxxxx x-hcso-appcode: xxxx

URI /rest/dataapi/homs/open-api/v1/host/detail 路径参数 无 查询参数 参数 是否必选 类型 值域 描述 begin_time 是 integer 无 开始时间 end_time 是 integer 无 结束时间 offset_value 是 integer 无 偏移大小：大于等于0 page_size 是 integer 默认值：500 页大小：大于等于0 host_id 否 string 无 主机ID

请求 请求header参数 参数 是否必选 类型 值域 说明 X-APIG-Appcode 是 string 无 由SRE分配的AppCode。 x-auth-token 是 string 无 调用方APIG的IAM认证token。 x-hcso-domainid 否 string 无 接入的租户ID。HCSO场景必填，其他场景不要求。 x-hcso-appcode 是 string 无 由SRE分配的AppCode。 请求body参数 无 请求示例 GET /rest/dataapi/homs/open-api/v1/host/detail?begin_time=0&end_time=0&offset_value=0&page_size=1 Content-Type: application/json Accept: application/json X-Auth-Token: xxxxx x-hcso-appcode: xxxx

响应 响应参数 响应示例 HTTP/1.1 200 OK Content-Type: application/json;charset=UTF8 { "total": 1, "list": [ { "REGION_ID": "cn-north-7", "HOST_ID": "dea41fb4-2583-45d7-a4b1-22d8d27c5024", "HOST_NAME": "ecs_4-CXXX034", "MANUFACTURER": "cn-north-7", "KERNEL": "0", "CPU": "[{"cores":"22","model":"Intel(R) Xeon(R) Gold 6161 CPU @ 2.20GHz","threads":"2","cpu":"2 * 22 * 2 * Intel(R) Xeon(R) Gold 6161 CPU @ 2.20GHz","sockets":"2"}]", "MEMORY": "[{"frequency":"2666 MHz","manufacturer":"Micron","type":"DDR4","size":"32 GB"},{"frequency":"2666 MHz","manufacturer":"Micron","type":"DDR4","size":"32 GB"},{"frequency":"2666 MHz","manufacturer":"Micron","type":"DDR4","size":"32 GB"},{"frequency":"2666 MHz","manufacturer":"Micron","type":"DDR4","size":"32 GB"},{"frequency":"2666 MHz","manufacturer":"Micron","type":"DDR4","size":"32 GB"},{"frequency":"2666 MHz","manufacturer":"Micron","type":"DDR4","size":"32 GB"},{"frequency":"2666 MHz","manufacturer":"Micron","type":"DDR4","size":"32 GB"},{"frequency":"2666 MHz","manufacturer":"Micron","type":"DDR4","size":"32 GB"},{"frequency":"2666 MHz","manufacturer":"Micron","type":"DDR4","size":"32 GB"},{"frequency":"2666 MHz","manufacturer":"Micron","type":"DDR4","size":"32 GB"}]", "DISK": "[{"disk":"/dev/sda:599.0GB"},{"disk":"/dev/sdb:1598.0GB"},{"disk":"/dev/sdc:10.7GB"}]", "MAC_IP": "xx.xx.xx.xx", "NETWORK_ADAPTER": "1", "RAID": "1", "SN": "abfa96bc-29f6-4571-bfba-fcfdf6ad6ebb", "CPU_ARCH": "x86_64", "AZ_CODE": "1", "POD_CODE": "1", "CLUSTER_NAME": "ecs", "ROOM_CODE": "1", "RACK_CODE": "1", "DC_CODE": "1" } ] }

响应 响应参数 响应示例 HTTP/1.1 200 OK Content-Type: application/json;charset=UTF8 { "total": 1, "list": [ { "SERVICE": "ECS", "REGION_ID": "cn-north-7", "NAMESPACE": "ecs", "SOURCE_SERVICE": " CES ", "SOURCE_TYPE": "TenantMon", "SOURCE_TAG": "CN_NORTH_7_ECS", "TENANT_NAME": "xxx", "METRIC_NAME": "cpu_usage", "METRIC_VALUE": "10", "METRIC_UNIT": "%", "INSTANCE_ID": "abfa96bc-29f6-4571-bfba-fcfdf6ad6ebb", "TIMESTAMP": "1726819320000" } ] }

请求 请求header参数 参数 是否必选 类型 值域 说明 X-APIG-Appcode 是 string 无 由SRE分配的AppCode。 x-auth-token 是 string 无 调用方APIG的IAM认证token。 x-hcso-domainid 否 string 无 接入的租户ID。HCSO场景必填，其他场景不要求。 x-hcso-appcode 是 string 无 由SRE分配的AppCode。 请求body参数 无 请求示例 GET /rest/dataapi/homs/open-api/v1/ecs/performance?begin_time=0&end_time=0&offset_value=0&page_size=1 Content-Type: application/json Accept: application/json X-Auth-Token: xxxxx x-hcso-appcode: xxxx

URI /rest/dataapi/homs/open-api/v1/ecs/performance 路径参数 无 查询参数 参数 是否必选 类型 值域 描述 begin_time 是 integer 无 开始时间 end_time 是 integer 无 结束时间 offset_value 是 integer 无 偏移大小：大于等于0 page_size 是 integer 默认值：500 页大小：大于等于0 vm_id 否 string 无 虚拟机ID

请求 请求header参数 参数 是否必选 类型 值域 说明 X-APIG-Appcode 是 string 无 由SRE分配的AppCode。 x-auth-token 是 string 无 调用方APIG的IAM认证token。 x-hcso-domainid 否 string 无 接入的租户ID。HCSO场景必填，其他场景不要求 x-hcso-appcode 是 string 无 由SRE分配的AppCode。 请求body参数 无 请求示例 GET /rest/dataapi/homs/open-api/v1/network-device/metric-data?begin_time=0&end_time=0&offset_value=0&page_size=1 Content-Type: application/json Accept: application/json X-Auth-Token: xxx x-hcso-appcode: xxx

响应 响应参数 参数 是否必选 类型 值域 说明 device_ip 是 string 无 网络设备管理IP。 res_type 是 string 无 资源类型。 metric 是 string 无 设备指标。 region_id 是 string 无 区域编码。 value 是 string 无 指标值。 timestamp 是 string 无 时间戳。 响应示例 HTTP/1.1 200 OK Content-Type: application/json;charset=UTF8 { "total": 1698669, "list": [ { "device_ip": "xx.xx.xx.xx", "res_type": "2", "metric": "14", "region_id": "cn-north-7", "value": "0", "timestamp": "1726819320000" } ] }

URI /rest/dataapi/homs/open-api/v1/network-device/metric-data 路径参数 无 查询参数 参数 是否必选 类型 值域 描述 begin_time 是 integer 无 开始时间 end_time 是 integer 无 结束时间 offset_value 是 integer 无 偏移大小：大于等于0 page_size 是 integer 默认值：500 页大小：大于等于0 management_ip 否 string 无 网络设备管理IP地址 metric 否 string 取值范围：59, 60, 14, 18, 101, 102, 61, 52 设备指标

预注销管理 为了防止租户账号被误删或需要恢复，系统默认开启预注销管理功能。 预注销租户 单击主菜单的“组织”。默认进入“租户管理”页面。 单击“更多 ＞ 预注销”。 确认弹框提示信息，单击“确定”。 租户状态将变为“预注销”，默认进入“预注销管理”页面。 预注销管理 单击主菜单的“组织”。默认进入“租户管理”页面。 单击“预注销管理”页签。 根据表 预注销管理操作执行以下操作。 表3 预注销管理操作 任务 说明 步骤 开启或关闭设置冷冻期 根据需要设置是否开启冷冻期。 单击开启设置冷冻期。 单击关闭设置冷冻期。 设置冷冻期时长 该设置对全局生效，但对已进入冷冻期的预注销租户不生效。 单击打开“设置冷冻期”。 设置销户冷冻期时间。 单击“确定”。 还原租户 根据需要对预注销的租户进行还原操作。 说明： 只有状态为“已冻结”的租户支持还原操作。 在租户所在行，单击“操作 ＞ 还原”。 也可选中需要还原的租户，单击左上方“还原”进行批量操作。 删除租户 对不需要使用的租户进行彻底删除操作。 说明： 租户冷冻期已解除的租户才可执行删除操作。 彻底删除后，租户下的所有资源数据及配置都无法恢复，请谨慎操作。 在租户所在行，单击“彻底删除”。 在弹框中输入“租户名+DELETE”后，单击“确定”。

查看与修改 单击主菜单的“组织”。默认进入“租户管理”页面。 可执行表中表2的操作。 表2 相关操作 任务 说明 步骤 查看租户列表 当需要查看租户名称、状态及描述时，可以直接在列表中查看。 查看租户内的各项基础信息。 导出租户 将租户的基本信息导出并保存到本地，仅用于信息备份和统计。 单击“导出 ＞ 导出租户”，默认导出所有租户。 导出项目 将租户下所有的项目信息进行导出。 单击“导出 ＞ 导出项目”，默认导出所有项目。 单击“操作 ＞ 修改”。 修改租户描述。 当进行白名单配置时，也可修改租户名称。 单击“确认”。

创建用户并授权IAM ESM ReadOnlyAccess策略 登录 统一身份认证 服务（IAM）控制台。 在IAM控制台创建用户组，并授予ESM服务的权限“ESM ReadOnlyAccess”。 在IAM控制台创建用户，并将其加入2中创建的用户组。 将新创建的用户ID反馈至华为云服务技术支持人员，由技术支持人员进行大屏配置。 用户登录并验证权限。 新创建的用户登录控制台，验证ESM服务的权限：在主菜单中选择 “可视化”，若能正常查看大屏，表示“ESM ReadOnlyAccess”已生效。

请求消息体（可选） 该部分可选。请求消息体通常以结构化格式（如JSON或XML）发出，与请求消息头中Content-Type对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于创建查询任务接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，字段需要根据实际值填写。 POST https://esm-api.cn-south-1.myhuaweicloud.com/meter/v1/{domain_id}/query-jobs Content-Type: application/json { "hcso_id": "********", "region_id": "********", "min_sdr_time": "2022-01-01 00:00:00", "max_sdr_time": "2022-02-01 00:00:00" } 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。