You need to enable JavaScript to run this app.
导航
消息队列 Kafka版
  • 文档首页
    • /
  • 消息队列 Kafka版

ScaleKafkaInstance

最近更新时间：2022.10.18 16:24:26

首次发布时间：2022.04.24 15:56:37

我的收藏

调用 ScaleKafkaInstance 更改实例规格。

使用说明

说明

  • 调用此接口前，请确认实例状态为运行中（Running）。
  • 目前仅支持升级实例配置，不支持降级计算规格或缩容存储空间。
  • 不同计算规格对应不同的存储空间范围，升级实例的计算规格时，需要同步升级存储空间。
  • 此接口的 API Version 为 2018-01-01。
  • 此接口的调用频率限制为 20 次/s，超出频率限制会报错 “AccountFlowLimitExceeded”。

请求参数

参数参数类型是否必选示例值说明
InstanceIdString必选kafka-xxxxxxxxxx实例 ID。

NewKafkaSpecification

String

可选

kafka.n5.x2.medinum

实例更配新的计算规格。

  • NewKafkaSpecification 和 NewDiskCapacity 中，至少指定一个。
  • 默认不执行计算规格更配。
NewDiskCapacityInteger可选1800实例更配新的存储容量，单位为 GiB。默认不执行存储规格更配。

NeedRebalance

Bool

可选

false

更配结束后是否执行自动重均衡。

  • true ：实例需要再均衡。
  • false：（默认）不执行再均衡任务。
RebalanceTimeString可选2022-03-15 21:00:00自动再均衡的时间，时间格式为: YYYY-MM-DD HH:mm:ss。默认更配完成后立刻触发重均衡任务。

EipIds

List

可选

[eip-xxxxx,eip-yyyyy]

EIP ID，开启公网访问时必填。

  • 更高的计算规格需要更多的公网 IP，升级实例规格时需要通过此参数传入增加的公网IP ID。
  • 您可以通过 ListKafkaConf 接口查看各个实例需要的公网IP数量。

PartitionOfBuy

Integer

可选

900

Kafka 实例的分区数量，请根据业务需求合理设置分区数。
不同规格提供数量不同的免费分区额度，超过免费额度的部分将另外收取分区费用。每个规格可创建的分区数量范围请参考产品规格，分区的计费方式请参考计费项。

响应参数

参数参数类型示例值说明
OrderIdStringorder-xxxxxxx实例订单 ID。

示例

请求示例

POST https://kafka.volcengineapi.com/?Action=ScaleKafkaInstance&Version=2018-01-01 HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: kafka.volcengineapi.com
X-Date: 20210328T100802Z
Authorization: HMAC-SHA256 Credential=AKLTYmYwNjAzYjFmMjRkNDQwZWI4MzI1MzhjZGYyM2YxYmY/20210328/cn-north-1/kafka/request, SignedHeaders=x-date, Signature=e1d274292f8b36eb096e1d2fec02822bd2e5cb3435699938adb7341861214e49

{
  "InstanceId": "kafka-xxxxxxxxxx",
  "NewKafkaSpecification": "kafka.n5.x2.medinum",
  "NewDiskCapacity": 1800,
  "NeedRebalance": false,
  "RebalanceTime": "2022-03-15 21:00:00",
  "EipIds": [
    "********"
  ]
}

响应示例

{
  "ResponseMetadata": {
    "RequestId": "540CFF28-407A-40B5-B6A5-74B",
    "Action": "ScaleKafkaInstance",
    "Version": "2018-01-01",
    "Service": "kafka",
    "Region": "cn-beijing"
  },
  "Result": {
    "OrderId": "order-xxxxxxx"
  }
}