查询用户/客户端流控配置
功能介绍
该接口用于向Kafka实例查询流控的配置,若成功则返回流控配置的列表。
URI
GET /v2/kafka/{project_id}/instances/{instance_id}/kafka-user-client-quota
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID,获取方式请参见获取项目ID。 |
instance_id |
是 |
String |
实例ID。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
offset |
否 |
Integer |
偏移量,表示查询该偏移量后面的记录。 |
limit |
否 |
Integer |
查询返回记录的数量限制。 |
请求参数
无
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
quotas |
Array of Quota objects |
客户端流控配置列表。 |
count |
Integer |
用户/客户端流控配置数目。 |
参数 |
参数类型 |
描述 |
---|---|---|
user |
String |
用户名。 不对全部用户/客户端限流时,用户名和客户端ID不能同时为空。 |
client |
String |
客户端ID。 不对全部用户/客户端限流时,用户名和客户端ID不能同时为空。 |
user-default |
Boolean |
是否使用用户默认设置。
|
client-default |
Boolean |
是否使用客户端默认设置。
|
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 |
查询客户端流控配置成功。 |
错误码
请参见错误码。