检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
【通知】文档数据库服务DDS4.4邀请公测 尊敬的华为云用户: 文档数据库服务DDS4.4版本已于2023年2月2日起正式对所有华为云客户开放免费公测。 本次公测已在所有区域开放。 相比以往版本的DDS,DDS4.4版本主要针对MongoDB4.4版本的新特性做了兼容,新特性有可
认证鉴权 DDS调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。 Token认证:通过Token认证通用请求。 AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。推荐使用AK/SK认证,其安全性比Token认证要高。
如何实现副本集高可用和读写分离 DDS副本集不仅可以通过存储多份数据副本来保证数据的高可靠性,还可以通过自动主备切换机制来保证服务的高可用。通过客户端读取不同的数据副本,可以提高数据的读取性能。请使用高可用方式连接副本集实例,您也可以通过设置来实现读写分离。否则,将无法体验副本集的高可用性和高读取性能。
关联LTS日志流 接口说明 将实例日志与LTS日志流关联,后台将自动上传实例日志到关联的LTS日志流里。 关联成功后,会产生一定费用,具体计费可参考云日志服务(LTS)的定价详情。系统会为当前选择的日志流创建对应日志类型的结构化配置。 约束说明 创建中、已删除、冻结状态的实例不支持该操作。
查询数据库复制集名称 接口说明 查询数据库复制集名称。 约束说明 仅支持副本集实例。 调试 您可以在API Explorer中调试该接口。 URI URI格式 GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/replica-set/name
查询数据库列表 接口说明 查询数据库列表。 约束说明 该接口只支持DDS社区版。 实例在创建、规格变更、修改端口、冻结、重启等过程中以及状态为非“normal”时,不允许执行该操作。 调试 您可以在API Explorer中调试该接口。 URI URI格式 GET https:/
任务中心 用户在控制台上提交的异步任务,可以通过文档数据库服务“任务中心”展示执行进度和结果。 使用须知 对于执行失败的任务,默认保留7天。 支持查看的任务 表1 支持查看的任务列表 任务名称 说明 创建实例 创建社区版集群实例、副本集实例、单节点实例。 扩容存储 扩容社区版集群
查询回收站实例列表 接口说明 查询回收站实例列表。 调试 您可以在API Explorer中调试该接口。 URI URI格式 GET https://{Endpoint}/v3/{project_id}/recycle-instances URI样例 https://dds.cn-north-1
快速入门 本节通过调用API创建DDS集群实例。 通过IAM服务获取到的Token有效期为24小时,需要使用同一个Token鉴权时,可以先将Token缓存,避免频繁调用。 涉及API 当您使用Token认证方式完成认证鉴权时,需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。
查询数据库角色列表 接口说明 查询数据库角色列表。 约束说明 该接口支持DDS社区版。 实例在创建、规格变更、修改端口、重启等过程中以及状态为非“normal”时,不允许执行该操作。 调试 您可以在API Explorer中调试该接口。 URI URI格式 GET https:/
查询实例列表和详情 接口说明 根据指定条件查询实例列表和详情。 调试 您可以在API Explorer中调试该接口。 URI URI格式 GET https://{Endpoint}/v3/{project_id}/instances?id={id}&name={name}&mo
查询数据库用户列表 接口说明 查询数据库用户列表。 约束说明 该接口支持DDS社区版。 实例在创建、规格变更、修改端口、重启等过程中以及状态为非“normal”时,不允许执行该操作。 调试 您可以在API Explorer中调试该接口。 URI URI格式 GET https:/
查询集群均衡设置 接口说明 查询DDS集群的数据均衡设置,包括均衡开关和均衡活动时间窗的设置。其中,均衡活动时间窗的信息仅在DDS 4.0及以上版本返回。 约束说明 冻结实例不支持该操作。 调试 您可以在API Explorer中调试该接口。 URI URI格式 GET http
批量添加或删除资源标签 接口说明 批量添加或删除指定实例的标签。 约束说明 一个文档数据库实例具有20个标签配额,且标签key唯一。 添加标签时,如果请求体中存在重复key,调用该接口将会报错。 添加标签时,如果请求体中的key与指定实例已有的key重复,将会覆盖已有key对应的value的值。
创建和管理集合 写入/更新和删除命令的规范请参见写入/更新命令和删除命令。 创建集合 执行db.createCollection(name, options)创建集合。 db.createCollection(<name>, { capped: <boolean>,
创建实例 接口说明 创建文档数据库实例,包括集群实例和副本集实例。 约束说明 该接口既支持创建包年包月实例,也支持按需实例。 调试 您可以在API Explorer中调试该接口。 URI URI格式 POST https://{Endpoint}/v3/{project_id}/instances
扩容集群实例的节点数量 接口说明 扩容指定集群实例的节点数量。 约束说明 该接口既支持包年包月实例,也支持按需实例。 仅支持扩容社区版集群实例的mongos节点和shard节点。 调试 您可以在API Explorer中调试该接口。 URI URI格式 POST https://
查询实例可迁移到的可用区 接口说明 查询实例可迁移到的可用区。 约束说明 如需使用该接口,请联系相关工作人员申请开通。 支持DDS社区版集群、副本集实例。 跨AZ实例不支持该操作。 IPV6子网创建的实例不支持该操作。 针对副本集实例,如果当前存在只读节点或未激活的备节点,不支持该操作。
文档数据库服务授权项说明 表1 实例管理 权限 对接API接口 授权项(Action) IAM项目(Project) 企业项目(Enterprise Project) 创建实例 POST /v3/{project_id}/instances dds:instance:create
修改数据库复制集名称 接口说明 修改数据库复制集名称。 文档数据库实例在修改数据库复制集名称过程中将不可用,请谨慎操作。 约束说明 仅支持副本集实例。 实例在创建、规格变更、修改端口、重启等过程中以及状态为非“normal”时,不允许执行该操作。 调试 您可以在API Explorer中调试该接口。