查看站点容量信息 - ListEdgeSiteMetrics

功能介绍

查看站点容量信息。

该接口支持企业项目细粒度权限的校验，具体细粒度请参见 ies:edgeSite:getMetricData

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
ies:edgeSite:getMetricData
Read
edgeSite *
g:EnterpriseProjectId
-
-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
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

表2 Query参数
参数	是否必选	参数类型	描述
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	监控数据

表5 MetricDataDetail
参数	参数类型	描述
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	维度信息

表6 dimension
参数	参数类型	描述
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"
    }
  } ]
}