- 最新动态
- 功能总览
-
服务公告
- 漏洞公告
-
产品公告
- 【通知】2024年11月5日起文档数据库服务DDS5.0版本集群开放公测
- 【通知】2024年10月11日起文档数据库服务DDS副本集5.0版本开始转商计费
- 【通知】华为云文档数据库服务DDS3.4版本计划于2024年10月11日停售
- 【通知】2024年07月24日起文档数据库服务DDS5.0版本开放公测
- 【通知】2023年02月15日起文档数据库服务上线x86架构增强Ⅱ型副本集和集群shard的1:8系列规格
- 【通知】文档数据库服务DDS4.4邀请公测
- 【停售公告】华为云文档数据库服务DDS单节点规格计划于2023年07月15日停售内部通知
- 【通知】2023年10月8日起文档数据库服务DDS4.4版本开始转商计费
- 版本说明
- 产品发布说明
- 产品介绍
- 计费说明
- 快速入门
- 开发指南
-
用户指南
- 购买实例
- 连接实例
- 数据迁移
- 性能调优
- 权限管理
- 实例生命周期管理
- 变更实例
- 数据备份
- 数据恢复
- 参数模板管理
- 连接管理
- 数据库使用
- 数据安全性
- 监控与告警
- 审计
- 日志管理
- 任务中心
- 智能DBA助手
- SQL自动查杀
- 跨可用区容灾
- 标签管理
- 配额管理
- DDS使用规范建议
- 最佳实践
- 安全白皮书
- 性能白皮书
-
API参考
- 使用前必读
- API概览
- 如何调用API
- 快速入门
-
API v3(推荐)
- 查询API版本
- 查询数据库版本信息
- 查询数据库规格
- 查询数据库磁盘类型
-
实例管理
- 创建实例
- 重启实例
- 删除实例
- 查询实例列表和详情
- 扩容实例存储容量
- 扩容集群实例的节点数量
- 变更实例规格
- 切换副本集实例的主备节点
- 切换SSL开关
- 修改实例名称
- 修改实例备注
- 修改数据库端口
- 变更实例安全组
- 绑定弹性公网IP
- 解绑弹性公网IP
- 修改实例内网地址
- 创建集群的Shard/Config IP
- 副本集跨网段访问配置
- 查询实例可迁移到的可用区
- 实例可用区迁移
- 设置实例回收站策略
- 扩容副本集实例的节点数量
- 实例新增只读节点
- 数据库补丁升级
- 开启/关闭秒级监控
- 查询秒级监控配置
- 设置可维护时间段
- 查询实例回收站策略
- 查询回收站实例列表
- 检查弱密码
- 查询数据库补丁升级预估时长
- 查询实例磁盘信息
- 获取SSL证书下载地址
- 查询数据库复制集名称
- 修改数据库复制集名称
- 删除实例的节点
- 删除实例的只读节点
- 查询副本集跨网段访问配置
- 查询LTS日志配置信息
- 关联LTS日志流
- 解除关联LTS日志流
- 设置磁盘自动扩容策略
- 查询磁盘自动扩容策略
- 批量数据库补丁升级
- 连接管理
- 备份与恢复
- 参数配置
- 获取日志信息
- 标签管理
- 管理数据库和用户
- 配额管理
- 数据库运维
- 任务管理
- API v3(即将下线)
- 应用示例
- 权限策略和授权项
- 附录
- SDK参考
- 场景代码示例
- 常见问题
-
故障排除
- 概述
- DDS实例节点故障处理机制
- 连接失败,提示:network error while attempting to run command ‘isMaster’
- 连接失败,提示:No route to host以及connection attempt failed
- 连接失败,提示:Authentication failed
- 连接失败,提示:couldn't connect to server
- 连接失败,提示:cannot list multiple servers in URL without ‘replicaSet’ option
- Java驱动连接实例失败,提示:Timeout while receiving message
- 连接失败,提示:exception: login failed 以及 U_STRINGPREP_PROHIBITED_ERROR
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
变更实例规格
接口说明
变更实例的规格,包括同系列和跨系列变更规格。
调整实例规格时,文档数据库服务会有5~10分钟的业务中断重启,请谨慎操作。
约束说明
- 该接口既支持包年包月实例,也支持按需实例。
- 变更为同系列其他规格时,需要改变的规格不能与原规格一样。
- 实例状态仅为“normal”时,可以变更实例规格。
- 不支持集群实例只读节点的规格变更。
调试
您可以在API Explorer中调试该接口。
URI
名称 |
类型 |
IN |
是否必选 |
描述 |
---|---|---|---|---|
X-Auth-Token |
string |
header |
是 |
从IAM服务获取的用户Token。请参考认证鉴权。 |
project_id |
string |
path |
是 |
租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。 |
instance_id |
string |
path |
是 |
请求消息
- 参数说明
表3 参数说明 名称
参数类型
是否必选
描述
resize
Object
是
目标规格信息。详情请参见表4。
is_auto_pay
Boolean
否
变更包年包月实例规格时可指定,表示是否自动从账户中支付,此字段不影响自动续订的支付方式。
- 对于降低规格场景,该字段无效。
- 对于扩大规格场景:
- true,表示自动从账户中支付。
- false,表示手动从账户中支付,默认为该方式。
表4 resize字段数据结构说明 名称
参数类型
是否必选
描述
target_type
String
否
对象类型。
- 对于集群实例,该参数为必选。变更mongos节点规格时,取值为“mongos”;变更单个shard组规格、或者批量变更多个shard组规格时,取值为“shard”,变更config组规格时,取值为"config"。
- 对于副本集实例,不传该参数。变更readonly节点规格时,取值为“readonly”。
- 对于单节点实例,不传该参数。
- 枚举值:
- mongos
- shard
- config
- readonly
target_id
String
否
待变更规格的节点ID或实例ID,可以调用“查询实例列表”接口获取。如果未申请实例,可以调用“创建实例”接口创建。
- 对于集群实例,变更mongos节点规格时,取值为mongos节点ID;变更单个shard组规格时,取值为shard组ID;批量变更多个shard组规格时,不传该参数;变更config组规格时,取值为config组的ID。
- 对于副本集实例,取值为相应的实例ID。变更readonly节点规格时,取值为readonly节点ID。
- 对于单节点实例,取值为相应的实例ID。
target_ids
Array of strings
否
待变更规格的节点组ID列表,可以调用“查询实例列表和详情”接口获取。如果未申请实例,可以调用“创建实例”接口创建。
- 对于集群实例,变更mongos节点规格时,不传该参数;变更单个shard组规格时,不传该参数;变更config组规格时,不传该参数;批量变更多个shard组规格时,取值为相应的多个shard组ID,最多支持16个shard组批量变更。
- 对于副本集实例,不传该参数。
- 对于单节点实例,不传该参数。
target_spec_code
String
是
变更至新规格的资源规格编码。获取方法请参见查询数据库规格中响应参数“flavors.spec_code”的值。
请求示例
- 变更集群实例下mongos节点的规格
{ "resize": { "target_type": "mongos", "target_id": "a742c13a284949adad177672e8a0f01cno02", "target_spec_code": "dds.mongodb.c6.large.4.mongos" } }
- 变更集群实例下shard组的规格
{ "resize": { "target_type": "shard", "target_id": "aeeb40a704904977ad78993d138ec942gr02", "target_spec_code": "dds.momgodb.c6.large.4.shard" } }
- 变更集群实例下config组的规格
{ "resize": { "target_type": "config", "target_id": "10a1c330537b42c1a9b3f7a5ebcda35egr02", "target_spec_code": "dds.momgodb.c6.xlarge.2.config" } }
- 变更副本集或单节点实例的规格
{ "resize": { "target_id": "aeeb40a704904977ad78993d138ec942in02", "target_spec_code": "dds.mongodb.c6.medium.4.repset" } }
- 批量变更集群实例下多个shard组的规格:
POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/054e292c9880d4992f02c0196d3eain02/resize { "resize" : { "target_type" : "shard", "target_ids" : [ "aeeb40a704904977ad78993d138ec942gr02", "5cbbb49b8f88424590a8a7b744b2dcf0gr02", "0407115681454784b1446c15590e42f0gr02" ], "target_spec_code" : "dds.mongodb.c6.large.4.shard" } }
响应消息
- 参数说明
表5 参数说明 名称
参数类型
是否必选
描述
job_id
String
是
任务ID。
order_id
String
否
订单ID,仅变更包年包月实例的规格时返回该参数。
- 响应示例
{ "job_id": "3711e2ad-5787-49bc-a47f-3f0b066af9f5" }
SDK
单击文档数据库服务 DDS SDK,下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
状态码
详情请参见状态码。
错误码
详情请参见错误码。