文档首页/ 数据接入服务 DIS/ API参考/ API说明/ 通道管理/ 查询当前通道分区扩缩容日志
更新时间:2025-11-03 GMT+08:00
分享

查询当前通道分区扩缩容日志

功能介绍

本接口用于查询当前通道分区扩缩容日志。

调用方法

请参见如何调用API

URI

GET /v2/{project_id}/streams/{stream_name}/update_partition_counts

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID。获取方法,请参见获取项目ID

约束限制

不涉及

取值范围

只能由英文字母和数字组成,且长度为[1-64]个字符。

默认取值

不涉及。

stream_name

String

参数解释

查询的扩缩容日志的通道名称。

约束限制

不涉及

取值范围

不涉及。

默认取值

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释

用户Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。请参见认证鉴权-Token认证

约束限制

不涉及

取值范围

长度为[1-32768]个字符。

默认取值

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

create_timestamp

Long

参数解释

扩缩容操作执行时间戳,13位时间戳。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

src_partition_count

Integer

参数解释

扩缩容操作前分区数量。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

target_partition_count

Integer

参数解释

扩缩容操作目标分区数量。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

result_code

Integer

参数解释

扩缩容操作结果响应码。

约束限制

不涉及

取值范围

  • 1:成功。

  • 0:失败。

默认取值

不涉及

auto_scale

Boolean

参数解释

本次扩缩容操作是否为自动扩缩容。

约束限制

不涉及

取值范围

  • true:自动扩缩容。

  • false:手动扩缩容。

默认取值

不涉及

响应参数

状态码:200

正常返回

请求示例

查询通道分区扩缩容日志。

GET https://{Endpoint}/v2/{project_id}/streams/{stream_name}/update_partition_counts

{
  "auto_scale" : false,
  "create_timestamp" : 1756386086180,
  "result_code" : 1,
  "src_partition_count" : 2,
  "target_partition_count" : 1
}

响应示例

状态码

状态码

描述

200

正常返回

错误码

请参见错误码

相关文档