更新时间:2023-08-16 GMT+08:00

查询topic的磁盘存储情况

功能介绍

查询topic在Broker上磁盘占用情况。

URI

GET /v2/{project_id}/instances/{instance_id}/topics/diskusage

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方式请参见获取项目ID

instance_id

String

实例ID。

表2 Query参数

参数

是否必选

参数类型

描述

minSize

String

占用磁盘大小,默认值1G (1K,1M,1G)。

top

String

占用磁盘大小,查询top N。

percentage

String

占用磁盘大小,查询大于占比的分区。

请求参数

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

broker_list

Array of DiskusageEntity objects

Broker列表。

表4 DiskusageEntity

参数

参数类型

描述

broker_name

String

Broker名称。

data_disk_size

String

磁盘容量。

data_disk_use

String

已使用的磁盘容量。

data_disk_free

String

剩余可用的磁盘容量。

data_disk_use_percentage

String

消息标签。

status

String

消息标签。

topic_list

Array of DiskusageTopicEntity objects

topic磁盘容量使用列表。

表5 DiskusageTopicEntity

参数

参数类型

描述

size

String

磁盘使用量。

topic_name

String

topic名称。

topic_partition

String

分区。

percentage

Double

磁盘使用量的占比。

请求示例

查询Topic的磁盘存储情况

GET https://{endpoint}/v2/{project_id}/instances/{instance_id}/topics/diskusage

响应示例

状态码: 200

查询成功。

{
  "broker_list" : [ {
    "broker_name" : "broker-0",
    "data_disk_size" : "66G",
    "data_disk_use" : "53M",
    "data_disk_free" : "63G",
    "data_disk_use_percentage" : "1",
    "status" : "Success get info",
    "topic_list" : [ {
      "size" : "12K",
      "topic_name" : "topic-test",
      "topic_partition" : "2",
      "percentage" : 1.7339533025568183E-5
    }, {
      "size" : "12K",
      "topic_name" : "__consumer_offsets",
      "topic_partition" : "4",
      "percentage" : 1.7339533025568183E-5
    }, {
      "size" : "12K",
      "topic_name" : "__consumer_offsets",
      "topic_partition" : "3",
      "percentage" : 1.7339533025568183E-5
    }, {
      "size" : "8.0K",
      "topic_name" : "__trace",
      "topic_partition" : "6",
      "percentage" : 1.1559688683712121E-5
    }, {
      "size" : "8.0K",
      "topic_name" : "__trace",
      "topic_partition" : "4",
      "percentage" : 1.1559688683712121E-5
    }, {
      "size" : "8.0K",
      "topic_name" : "__trace",
      "topic_partition" : "2",
      "percentage" : 1.1559688683712121E-5
    }, {
      "size" : "8.0K",
      "topic_name" : "__trace",
      "topic_partition" : "0",
      "percentage" : 1.1559688683712121E-5
    }, {
      "size" : "8.0K",
      "topic_name" : "topic-test",
      "topic_partition" : "0",
      "percentage" : 1.1559688683712121E-5
    }, {
      "size" : "8.0K",
      "topic_name" : "topic-1568537362",
      "topic_partition" : "2",
      "percentage" : 1.1559688683712121E-5
    }, {
      "size" : "8.0K",
      "topic_name" : "__consumer_offsets",
      "topic_partition" : "7",
      "percentage" : 1.1559688683712121E-5
    } ]
  } ]
}

状态码

状态码

描述

200

查询成功。

错误码

请参见错误码