更新时间:2025-09-03 GMT+08:00

查询用户/客户端流控配置

功能介绍

该接口用于向Kafka实例查询流控的配置,若成功则返回流控配置的列表。

URI

GET /v2/kafka/{project_id}/instances/{instance_id}/kafka-user-client-quota

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

instance_id

String

实例ID。

表2 Query参数

参数

是否必选

参数类型

描述

offset

Integer

偏移量,表示查询该偏移量后面的记录。

limit

Integer

查询返回记录的数量限制。

请求参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

quotas

Array of Quota objects

客户端流控配置列表。

count

Integer

用户/客户端流控配置数目。

表4 Quota

参数

参数类型

描述

user

String

用户名。

不对全部用户/客户端限流时,用户名和客户端ID不能同时为空。

client

String

客户端ID。

不对全部用户/客户端限流时,用户名和客户端ID不能同时为空。

user-default

Boolean

是否使用用户默认设置。

  • 是:表示对全部用户限流。此时不能同时设置用户名。

  • 否:表示对特定用户限流。此时需要设置用户名。

client-default

Boolean

是否使用客户端默认设置。

  • 是:表示对全部客户端限流。此时不能设置客户端ID。

  • 否:表示对特定客户端限流。此时需要设置客户端ID。

producer-byte-rate

Long

生产上限速率(单位为B/s)。

consumer-byte-rate

Long

消费上限速率(单位为B/s)。

说明:
“生产上限速率”和“消费上限速率”不可同时为空。

请求示例

响应示例

状态码:200

查询客户端流控配置成功。

{
  "quotas" : [ {
    "user" : "",
    "client" : "",
    "user-default" : false,
    "client-default" : true,
    "producer-byte-rate" : 2097152,
    "consumer-byte-rate" : 2097152
  } ],
  "count" : 1
}

状态码

状态码

描述

200

查询客户端流控配置成功。

错误码

请参见错误码