文档数据库 MongoDB 版支持修改副本集实例和分片集群实例中 Mongos 节点的连接地址域名前缀，您可以将新实例的连接地址修改为原实例的连接地址，免去修改客户端连接地址代码的操作。本文介绍如何修改连接地址域名前缀。

前提条件

实例状态需为运行中。关于实例状态的更多详情，请参见实例状态。

使用限制

当前仅支持修改副本集实例和分片集群实例中 Mongos 节点的私网或公网连接地址域名，不支持修改分片集群实例中 Shard 分片或 ConfigServer 节点的连接地址域名。各实例或组件类型支持的连接地址更多信息，请参见不同实例支持的连接地址。

注意事项

• 修改连接地址域名会导致部分服务的访问在短时间内受到影响，请谨慎操作。
• 修改连接地址域名后，原有的连接会断开，请及时修改客户端的连接信息。连接实例的具体操作步骤，请参见通过 Mongo Shell 工具连接实例。
• 如需修改公网地址的连接地址域名前缀，需要先为副本集实例或分片集群实例 Mongos 节点申请公网连接地址。具体操作步骤，请参见申请公网地址。

操作步骤

1. 登录 MongoDB 控制台。
2. 在顶部菜单栏的左上角，选择实例所属的项目和地域。
3. 根据实例类型，在左侧导航栏中选择副本集实例列表或分片集实例列表。
4. 在目标实例类型列表页，单击目标实例名称。

5. 在实例详情页，单击连接管理页签。

6. 在连接管理页签，根据实例或节点类型，以及连接地址类型执行对应操作。

   说明

   • 当前仅支持修改连接地址前缀，即 .mongodb.ivolces.com 或 .mongodb.volces.com 之前的部分。
   • 新域名需同时满足如下要求：
     • 连接地址前缀至少包含 8 个字符、连接地址总长度（前缀 + 后缀）不得超过 63 个字符。
     • 连接地址前缀需以小写字母开头，以小写字母或数字结尾。
     • 连接地址前缀可包含小写字母、数字和连字符(-)。
   • 修改后的连接地址需要保证全局唯一，不可以与火山引擎中任何地域下的任何连接地址重名。

   实例或节点类型	连接地址类型	具体操作步骤
   副本集实例	私网地址	在连接管理页签下的私网访问区域，单击私网地址最右侧的图标。 在修改连接地址弹窗中，先从节点下拉列表中选择需要修改连接地址域名的节点，然后在新连接地址文本框中输入新的连接地址域名前缀。 说明 您可以修改副本集实例的主、从、隐藏和只读节点的私网连接地址域名前缀。 仅当实例添加了只读节点后，节点下拉列表中才会展示只读节点选项。添加只读节点的具体操作步骤，请参见添加只读节点。
   	公网地址	在连接管理页签下的公网访问区域，单击公网地址最右侧的图标。 在修改连接地址弹窗中，先从节点下拉列表中选择需要修改连接地址域名的节点，然后在新连接地址文本框中输入新的连接地址域名前缀。 说明 您可以修改副本集实例的主、从节点的公网连接地址域名前缀。 您需要为副本集实例申请公网连接地址后，才可以查看并修改公网连接地址域名。具体操作步骤，请参见申请公网地址。
   分片集群实例 Mongos 节点	私网地址	在连接管理页签下的连接Mongos 区域，单击私网地址最右侧的图标。 在修改连接地址弹窗中，先从节点下拉列表中选择需要修改连接地址域名的节点，然后在新连接地址文本框中输入新的连接地址域名前缀。 说明 仅支持修改分片集群中 Mongos 节点的连接地址域名，不支持修改 Shard 分片或 ConfigServer 节点的连接地址域名。
   	公网地址	在连接管理页签下的连接Mongos 区域，单击公网地址最右侧的图标。 在修改连接地址弹窗中，先从节点下拉列表中选择需要修改连接地址域名的节点，然后在新连接地址文本框中输入新的连接地址域名前缀。 说明 您需要为 Mongos 节点申请公网连接地址后，才可以查看并修改公网连接地址域名。具体操作步骤，请参见申请公网地址。 仅支持修改分片集群中 Mongos 节点的连接地址域名，不支持修改 Shard 分片或 ConfigServer 节点的连接地址域名。

7. 在修改连接地址弹窗的右下角，单击确定。

   注意

   • 修改连接地址域名会将导致部分服务的访问在短时间内受到影响，请谨慎操作。
   • 修改连接地址域名后，原有的连接会断开，请及时修改客户端的连接信息。连接实例的具体操作步骤，请参见通过 Mongo Shell 工具连接实例。