更新时间:2022-04-12 GMT+08:00
分享

扩容集群实例的节点数量

功能介绍

扩容指定集群实例的节点数量。

接口约束

  • 该接口仅支持社区版按需计费的实例。
  • 仅支持扩容集群实例的mongos节点和shard节点。
  • 新增节点的规格系列需要和实例已有节点的规格系列一致。

    规格系列包括:通用型(s6)、增强型(c3)、增强Ⅱ型(c6)。

    示例:
    • dds.mongodb.s6.large.4.mongos和dds.mongodb.s6.medium.4.mongos是同一规格系列。
    • dds.mongodb.s6.large.4.mongos和dds.mongodb.c3.large.4.mongos不是同一规格系列。

调试

您可以在API Explorer中调试该接口。

URI

  • URI格式

    POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/enlarge

  • URI样例

    https://dds.cn-north-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/9136fd2a9fcd405ea4674276ce36dae8in02/enlarge

  • 参数说明
    表1 参数说明

    名称

    是否必选

    描述

    project_id

    租户在某一region下的project ID。

    instance_id

    实例ID,可以调用“查询实例列表”接口获取。如果未申请实例,可以调用“创建实例”接口创建。

请求消息

  • 参数说明
    表2 参数说明

    名称

    是否必选

    参数类型

    描述

    type

    String

    待扩容的对象类型。

    • 扩容mongos节点时,取值为“mongos”。
    • 扩容shard组时,取值为“shard”。

    spec_code

    String

    资源规格编码,获取方式请参见查询数据库规格中响应参数“flavors.spec_code”。

    num

    String

    待扩容的mongos节点或shard组数量。一个集群实例下,最多支持32个mongos节点和32个shard组。

    volume

    Object

    磁盘信息。详情请参见表3

    • 扩容mongos节点时,不传该参数。
    • 扩容shard组时,该参数必选,指定新增的所有shard组的磁盘信息。
      说明:

      如果一次性添加多个shard组,该shard组只能选择相同的规格和磁盘容量。

    表3 volume字段数据结构说明

    名称

    是否必选

    参数类型

    描述

    size

    String

    指定新增的所有shard组的磁盘容量。取值范围:10GB~2000GB。

  • 请求体样例
    扩容mongos节点数量:
    { 
    	"type": "mongos",
    	"spec_code":"dds.mongodb.c3.medium.4.mongos",
    	"num": 1
    }
    扩容shard组数量:
    {
    	"type": "shard",
    	"spec_code":"dds.mongodb.c3.medium.4.shard",
    	"num": 1,
            "volume": { 
                 "size": 330 
        }
    }

响应消息

  • 要素说明
    表4 要素说明

    名称

    参数类型

    描述

    job_id

    String

    任务ID。

  • 响应样例
    { 
        "job_id": "4008c8914b624785a02ab7966d4d" 
    }

状态码

详情请参见状态码

错误码

详情请参见错误码

分享:

    相关文档

    相关产品

关闭导读