更新时间:2024-05-10 GMT+08:00
分享

查看站点容量信息

功能介绍

查看站点容量信息。

调试

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

URI

GET /v1/{domain_id}/edge-sites/{site_id}/metric-data

表1 路径参数

参数

是否必选

参数类型

描述

domain_id

String

path中租户的账号ID

最大长度:36

site_id

String

边缘小站ID

表2 Query参数

参数

是否必选

参数类型

描述

dim

String

指定维度查询

  • site_id: 按站点维度,查询站点下计算、存储资源容量信息
  • flavor: 按规格维度,查询站点下各flavor的计算资源使用情况
  • storage: 按存储维度,查询站点下各存储资源类型的使用情况
  • flavor_capacity: 按规格容量维度,查询站点下各规格可发放数量预测
  • storage_pool:按存储池维度,查询站点下各存储池的使用情况

缺省值:site_id

请求参数

表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"
    }
  } ]
}

状态码

状态码

描述

200

successful operation

错误码

请参见错误码

相关文档