更新时间:2022-10-20 GMT+08:00

修改分区数量

功能介绍

本接口用于变更指定通道中的分区数量。

URI

PUT /v2/{project_id}/streams/{stream_name}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。

stream_name

String

需要变更分区数量的通道名称。

最大长度:64

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表3 请求Body参数

参数

是否必选

参数类型

描述

stream_name

String

需要变更分区数量的通道名称。

最大长度:64

target_partition_count

Integer

变更的目标分区数量。

取值为大于0的整数。

设置的值大于当前分区数量表示扩容,小于当前分区数量表示缩容。

注意:

每个通道在一小时内扩容和缩容总次数最多5次,且一小时内扩容或缩容操作有一次成功则最近一小时内不允许再次进行扩容或缩容操作。

最小值:0

响应参数

请求示例

变更通道分区数量

PUT https://{Endpoint}/v2/{project_id}/streams/{stream_name}

{
  "stream_name" : "newstream",
  "target_partition_count" : 5
}

响应示例

状态码

状态码

描述

200

正常返回

错误码

请参见错误码