更新时间:2022-05-09 GMT+08:00
分享

查询主维度信息列表

功能介绍

查询主维度对象列表,主维度ID当前支持dcs_instance_id,dcs_memcached_instance_id。

调试

您可以在API Explorer中调试该接口,并获取该接口关联的CLI示例: hcloud DCS ListMonitoredObjects

URI

GET /v2/{project_id}/dims/monitored-objects

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户ID。

表2 Query参数

参数

是否必选

参数类型

描述

dim_name

String

主维度ID,当前支持dcs_instance_id,dcs_memcached_instance_id。

offset

Integer

偏移量,表示从此偏移量开始查询,offset大于等于0

缺省值:0

limit

Integer

每页显示的条目数量

缺省值:10

请求参数

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

router

Array of strings

当前查询维度路由。如果是主维度,则数组中是自身ID。

children

Array of DimChild objects

当前查询维度子维度对象列表。当前只有维度为dcs_instance_id时才有值。

  • Proxy集群有两个子维度,分别为dcs_cluster_redis_node和dcs_cluster_proxy_node。

  • Cluster集群有一个子维度 dcs_cluster_proxy_node。

instances

Array of InstancesMonitoredObject objects

当前查询维度监控对象列表。

total

Integer - key

主维度监控对象的总数。

表4 DimChild

参数

参数类型

描述

dim_name

String

维度名称,当前支持维度有dcs_instance_id、dcs_cluster_redis_node、 dcs_cluster_proxy_node和dcs_memcached_instance_id。

dim_route

String

维度的路由,结构为主维度名称,当前维度名称,比如: dim_name字段为dcs_cluster_redis_node时,这个字段的值为dcs_instance_id,dcs_cluster_redis_node。

表5 InstancesMonitoredObject

参数

参数类型

描述

dcs_instance_id

String

测量对象ID,即实例的ID。

name

String

测量对象名称,即实例名称。

status

String

测量对象状态,即实例状态。

状态码: 500

表6 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息

最大长度:1024

error_code

String

错误码

最大长度:9

error_ext_msg

String

扩展错误信息(暂未使用,赋值为null)

最大长度:1024

请求示例

GET https://{dcs_endpoint}}/v2/{project_id}}/dims/monitored-objects?dim_name={dim_name}

响应示例

状态码: 200

查询主维度监控列表成功。

{
  "router" : [ "dcs_instance_id" ],
  "total" : 3,
  "children" : [ {
    "dim_name" : "dcs_cluster_redis_node",
    "dim_route" : "dcs_instance_id,dcs_cluster_redis_node"
  }, {
    "dim_name" : "dcs_cluster_proxy_node",
    "dim_route" : "dcs_instance_id,dcs_cluster_proxy_node"
  } ],
  "instances" : [ {
    "name" : "dcs-redis-single-node",
    "status" : "RUNNING",
    "dcs_instance_id" : "fe909c47-8990-44a0-9154-d0a1e95e78fe"
  }, {
    "name" : "dcs-redis-master-standby",
    "status" : "RUNNING",
    "dcs_instance_id" : "877e5ae3-482e-4c38-88a0-030a0fa6f399"
  }, {
    "name" : "dcs-proxy-cluster",
    "status" : "RUNNING",
    "dcs_instance_id" : "448ee851-1366-47f2-913a-e21032e690c4"
  } ]
}

状态码

状态码

描述

200

查询主维度监控列表成功。

500

内部服务错误。

错误码

请参见错误码

分享:

    相关文档

    相关产品

close