调用 ModifyInstanceSpec 接口修改实例的计算规格、存储规格、增配分区数等产品规格。

使用说明

随着业务规模增长，如果实例规格不再满足需求，您可以适当升高实例的规格配置。此接口用于变更 Kafka 实例的规格，包括计算规格、存储空间和分区数量等配置。
变配接口为异步接口，调用接口后，您可以在控制台实例详情页面中查看实例的计算规格等规格参数是否已变更成功。

注意事项

如需升级实例规格，请注意以下限制和风险。

• 变更限制：
  • 目前仅支持升级实例配置，不支持降级计算规格或缩容存储空间。
  • 不同计算规格对应不同的存储空间范围，升级实例的计算规格时，需要同步升级存储空间。
  • 不同计算规格、存储空间的定价不同，变更实例规格后，配置费用将发生变化。
• 风险说明：
  • 变更规格过程中，请勿对实例进行其他操作，否则可能造成实例状态异常等问题。
  • 升级规格时服务端节点会依次滚动重启，建议在业务低峰期操作。
  • 客户端会和部分节点短暂的断开连接并重连，可能会造成少量报错。已经发送成功的消息，升级之后不会丢失。升级期间发送失败的消息，建议重试发送，可在客户端配置重试机制。

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

请求示例

POST /?Action=ModifyInstanceSpec&Version=2022-05-01 HTTP/1.1
Content-Type: application/json
Host: kafka.volcengineapi.com
X-Date: 20210328T100802Z
Authorization: HMAC-SHA256 Credential=AK********/20210328/cn-beijing/Kafka/request, SignedHeaders=x-date, Signature=********

{
  "InstanceId": "kafka-cnngbnntswg1****",
  "ComputeSpec": "kafka.30xrate.hw",
  "StorageSpace": 500,
  "PartitionNumber": 400
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2023022721230816131228CB14B15FBB72",
        "Action": "ModifyInstanceSpec",
        "Version": "2022-05-01",
        "Service": "Kafka",
        "Region": "cn-beijing"
    },
    "Result": {
        "OrderId": "Order720482488077238****"
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。