调用 ModifyDBInstanceAdditionalBandwidthPerShard 接口修改目标 Redis 实例的单分片额外带宽。

请求类型

同步请求。

注意事项

• 仅创建时间在 2023 年 05 月 25 日之后的实例才支持修改带宽功能。创建时间早于 2023 年 05 月 25 日的实例如需修改分片带宽，需先创建一个新实例，在新实例上使用该功能。您可以通过 DTS 等工具将旧实例数据迁移至新实例，具体操作步骤，请参见数据迁移。
• 增加带宽不会对业务造成影响。减少带宽前请关注业务当前带宽，以免触发带宽限流。
• 若您在修改带宽后又执行了如下任一操作，实例带宽配置将遵循如下规则：
  • 变更实例的分片集群配置
    未启用分片集群变更为启用分片集群后，实例的单分片带宽 = 启用分片集群时所选节点规格对应的默认带宽。
  • 按备份集恢复到新实例或按时间点恢复到新实例
    按备份集或时间点恢复到新实例时，原实例的带宽配置不会应用到新实例中，新实例使用所选节点规格对应的默认带宽。
  • 恢复已删除实例
    通过备份集将已删除实例数据恢复到一个新实例时，已删除实例的带宽配置不会应用到新实例中，新实例使用所选节点规格对应的默认带宽。
  • 购买相同配置实例
    根据已有实例配置创建一个新实例时，原实例的带宽配置不会应用到新实例中，新实例使用所选节点规格对应的默认带宽。
• 若您在修改带宽后还需要变更节点规格，您可以在变更节点规格时通过勾选额外带宽来保留额外带宽，保留额外带宽时将遵循如下规则：
  • 实例的单分片总带宽 = 变更后节点规格的默认带宽 + 额外带宽。
  • 额外带宽 = min[ 单分片当前的额外带宽, 变更后节点规格所允许的最大额外带宽 ]。
• 带宽会受到 CPU 转发能力的限制，带宽的最高上限与 CPU 的最高上限，以先达到瓶颈者为准，因此可能出现 CPU 利用率达 100%，但带宽利用率未达 100% 的情况。请合理规划使用带宽，更多详情，请参见合理使用带宽建议。

计费说明

额外带宽实行梯度计费，即带宽单价会随额外带宽的增加而增大。更多关于额外带宽的价格详情，请参见额外带宽计费规则。

调试

请求参数

返回参数

示例

请求示例

POST https://redis.cn-beijing.volcengineapi.com/?Action=ModifyDBInstanceAdditionalBandwidthPerShard&Version=2020-12-07 HTTP/1.1
Host: redis.cn-beijing.volcengineapi.com
Content-Type: application/json; charset=utf-8
X-Date: 20201103T104027Z
Authorization: HMAC-SHA256 Credential=AK****/20201103/cn-beijing/Redis/request,SignedHeaders=content-type;host;x-date,Signature=****
{
    "InstanceId": "redis-cn0212gzmh2xs****",
    "AdditionalWriteBandwidth": 2,
    "AdditionalReadBandwidth": 2
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202407162055504B5C0337ED26FA2B05DD-ea****",
        "Action": "ModifyDBInstanceAdditionalBandwidthPerShard",
        "Version": "2020-12-07",
        "Service": "Redis",
        "Region": "cn-beijing"
    },
    "Result": {
        "OrderNO": "Order217500000099909****"
    }
}

错误码

更多详情，请参见错误码。