# 查看站点容量信息 - ListEdgeSiteMetrics #### 功能介绍 查看站点容量信息。 - 该接口支持企业项目细粒度权限的校验，具体细粒度请参见 ies:edgeSite:getMetricData #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IES/doc?api=ListEdgeSiteMetrics)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cloudpond/ies_05_0800.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | ies:edgeSite:getMetricData | Read | edgeSite \* | g:EnterpriseProjectId | - | - | #### URI GET /v1/{domain_id}/edge-sites/{site_id}/metric-data 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | domain_id | 是 | String | path中租户的账号ID | | site_id | 是 | String | 边缘小站ID | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | dim | 否 | String | 指定维度查询 - site_id: 按站点维度，查询站点下计算、存储资源容量信息 - flavor: 按规格维度，查询站点下各flavor的计算资源使用情况 - storage: 按存储维度，查询站点下各存储资源类型的使用情况 - flavor_capacity: 按规格容量维度，查询站点下各规格可发放数量预测 - storage_pool：按存储池维度，查询站点下各存储池的使用情况 | #### 请求参数 表3请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | 用户Token | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | metric_data | Array of [MetricDataDetail] objects | 监控数据 | 表5MetricDataDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | 监控指标名称，当前包含指标： - cpu_used：该维度vCPU已使用核数，单位：个，支持维度：site_id，flavor - cpu_available_total：用户可使用该维度vCPU总核数，单位：个，支持维度：site_id，flavor - cpu_total：该维度vCPU总核数（包含HA等预留核数），单位：个，支持维度：site_id，flavor - memory_used：该维度内存已使用量，单位：Gb，支持维度：site_id，flavor - memory_available_total：用户可使用该维度内存总量，单位：Gb，支持维度：site_id，flavor - memory_total：该维度内存总量（包含HA等预留内存量），单位：Gb，支持维度：site_id，flavor - capacity_used：该维度块存储资源已使用量，单位：GiB，支持维度：site_id，storage - capacity_available_total：用户可使用该维度块存储资源总容量（用户订购开通的存储容量），单位：GiB，支持维度：site_id，storage - capacity_total：当前已订购的资源场景下该维度块存储资源最大容量（订购资源包含的存储容量可能大于用户已开通容量），单位：GiB，支持维度：site_id，storage - available：该维度对应规格剩余可发放数量，单位：台，支持维度：flavor_capacity | | value | Long | 监控值 | | read_at | String | 记录更新时间 | | dimension | [dimension] object | 维度信息 | 表6dimension | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | 维度名称 | | value | String | 维度值 | #### 请求示例 查询边缘小站容量信息 ``` GET https://{ies_endpoint}/v1/{domain_id}/edge-sites/{site_id}/metric-data?dim=site_id ``` #### 响应示例 **状态码：200** successful operation ``` { "metric_data" : [ { "name" : "cpu_used", "value" : 136, "read_at" : "2022-04-28T08:15:00.428Z", "dimension" : { "name" : "site_id", "value" : "7db2702e-4d18-478f-856b-11cbcf5f1dbc" } }, { "name" : "cpu_total", "value" : 184, "read_at" : "2022-04-28T08:15:00.428Z", "dimension" : { "name" : "site_id", "value" : "7db2702e-4d18-478f-856b-11cbcf5f1dbc" } }, { "name" : "memory_used", "value" : 272, "read_at" : "2022-04-28T08:15:00.428Z", "dimension" : { "name" : "site_id", "value" : "7db2702e-4d18-478f-856b-11cbcf5f1dbc" } }, { "name" : "memory_total", "value" : 648, "read_at" : "2022-04-28T08:15:00.428Z", "dimension" : { "name" : "site_id", "value" : "7db2702e-4d18-478f-856b-11cbcf5f1dbc" } }, { "name" : "capacity_used", "value" : 5707, "read_at" : "2022-04-28T08:15:00.501Z", "dimension" : { "name" : "site_id", "value" : "7db2702e-4d18-478f-856b-11cbcf5f1dbc" } }, { "name" : "capacity_total", "value" : 113090, "read_at" : "2022-04-28T08:15:00.501Z", "dimension" : { "name" : "site_id", "value" : "7db2702e-4d18-478f-856b-11cbcf5f1dbc" } } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | successful operation | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-cloudpond/ErrorCode.html)。