全部产品
Search

搜索本产品

    云数据库 Tair（兼容 Redis®）：AddShardingNode - 为集群实例添加数据分片节点

    文档中心

    云数据库 Tair（兼容 Redis®）：AddShardingNode - 为集群实例添加数据分片节点

    更新时间：Aug 28, 2026

    为集群实例添加数据分片节点，本接口仅支持集群架构云原生版实例。

    调试

    您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    kvstore:AddShardingNode

    create

    *DBInstance

    acs:kvstore:{#regionId}:{#accountId}:instance/{#instanceId}

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    InstanceId

    string

    是

    实例 ID。

    r-bp1zxszhcgatnx****
    ShardCount

    integer

    否

    需要添加分片数量，默认值为 1。

    说明

    实例总分片数最少为 2 个，单次操作的分片数上限为 64，实例总分片数上限为 256，请确保分片数不超过此限制。

    2
    AutoPay

    boolean

    否

    是否自动付款，取值：

    • true：自动付款，请确保账号有足够的余额。

    • false：手动付款，您需要通过控制台手动续费，详情请参见手动续费。

    说明

    默认值为 true。

    false
    CouponNo

    string

    否

    优惠券编号。

    youhuiquan_promotion_option_id_for_blank
    BusinessInfo

    string

    否

    附加参数，业务信息。

    000000000
    SourceBiz

    string

    否

    调用来源，本参数仅用于内部维护使用，无需传入。

    SDK
    ForceTrans

    boolean

    否

    是否开启强制传输，取值：

    • false（默认）：在变配前，系统会检查实例当前的内核小版本，若内核版本过低则会报错，您需要升级内核小版本后重试。

    • true：跳过检查项，直接执行变配操作。

    false
    VSwitchId

    string

    否

    支持指定同 VPC 下的不同交换机 ID，新的数据分片将创建在指定的交换机下。 若不填，则默认创建在原来的交换机中。

    vsw-bp1e7clcw529l773d****

    返回参数

    名称

    类型

    描述

    示例值

    object

    RequestId

    string

    请求 ID。

    B79C1A90-495B-4E99-A2AA-A4DB13B8****
    OrderId

    integer

    订单 ID。

    20741011111111
    NodeIds

    array

    数据分片节点 ID 列表。

    string

    数据分片节点 ID。

    r-8vb0i6z4npbxrf****-db-4

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "B79C1A90-495B-4E99-A2AA-A4DB13B8****",
  "OrderId": 20741011111111,
  "NodeIds": [
    "r-8vb0i6z4npbxrf****-db-4"
  ]
}

    错误码

    访问错误中心查看更多错误码。

    变更历史

    更多信息，参考变更详情。