更新时间:2022-10-20 GMT+08:00
修改分区数量
功能介绍
本接口用于变更指定通道中的分区数量。
URI
PUT /v2/{project_id}/streams/{stream_name}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID。 |
stream_name |
是 |
String |
需要变更分区数量的通道名称。 最大长度:64 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
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 |
正常返回 |
错误码
请参见错误码。
父主题: 通道管理