创建 Atlas 临时集群

创建 Ephemeral 集群。

向以下终结点发送 POST 请求：

https://cloud.mongodb.com/api/atlas/v2/unauth/ephemeralClusters:create

该请求需要以下 Accept 标头：

Accept: application/vnd.atlas.preview+json

以下示例请求创建了一个名为 Cluster0 的 Ephemeral 集群：

curl -sS -X POST 'https://cloud.mongodb.com/api/atlas/v2/unauth/ephemeralClusters:create' \  -H 'Accept: application/vnd.atlas.preview+json' \  -H 'Content-Type: application/json' \  -d '{"clusterName": "Cluster0"}'

创建终结点会返回以下格式的响应：

{  "claimUrl": "https://account.mongodb.com/account/register?claimId={claimId}",  "clusterId": "{clusterId}",  "connectionString": "mongodb+srv://{username}:{password}@{host}/",  "expiresAt": "{timestamp}",  "status": "PROVISIONING",  "termsOfService": "By using this API and any resources provisioned through it, you agree to be bound by MongoDB's Cloud Terms of Service at https://www.mongodb.com/legal/terms-and-conditions/cloud; and Privacy Policy at https://www.mongodb.com/legal/privacy/privacy-policy."}

响应包含以下字段：

• claimUrl: 用于领取此临时集群的唯一 URL。必须由人工在浏览器中打开此 URL。在集群创建后 7 天内有效。

• clusterIdEphemeral 集群的唯一标识符。要检索集群的 status、claimUrl 和其他详细信息，请向以下终结点发送 GET 请求，并将 {clusterId} 替换为此值：

  https://cloud.mongodb.com/api/atlas/v2/unauth/ephemeralClusters/{clusterId}

  要了解更多信息，请参阅 返回一个临时 Atlas 集群。

• connectionString：使用 mongodb+srv:// 协议连接到 Ephemeral 集群的连接字符串。包含自动生成的数据库用户的用户名和密码，该用户可以在集群中读取和写入数据。任何使用此连接字符串的客户端都将以该数据库用户的身份进行身份验证。创建响应是 Atlas 返回未编辑密码的唯一时间。

• expiresAt：如果集群未被声明，Atlas 暂停集群的日期和时间。在认领之前，无法访问已暂停的 Ephemeral 集群。时间戳使用 UTC 格式的 ISO 8601 格式。

• status: 临时集群的状态。PROVISIONING、ACTIVE 或 PAUSED 之一。

• termsOfService: 请注意，使用此 API 即表示您同意 MongoDB 的 云服务术语和隐私政策。包含指向完整术语的链接。

要了解有关创建终结点的更多信息，请参阅创建临时 Atlas 集群。

保存连接字符串和声明值。

从创建响应中，保存 connectionString、claimUrl 和 clusterId。您需要它们来连接、声明和检索集群的详细信息。

连接到 Ephemeral 集群。

使用创建响应中的 connectionString 值，从兼容环境（例如：）连接到 Ephemeral 集群。

• 应用程序代码：在初始化连接到集群的客户端对象时，将连接字符串提供给您所用编程语言的 MongoDB 驱动程序。这是从应用程序连接时的典型选择。要了解更多信息，请参阅通过客户端库连接到集群。

• 命令行：将连接字符串作为参数提供给 MongoDB Shell (mongosh) 以进行连接并以交互方式运行命令：

  示例命令行连接

  mongosh "<connectionString>"

要了解有关可用连接方法的更多信息，请参阅注意事项。

（可选）领取临时集群。

认领临时集群是可选的。如果您不认领该集群，Atlas 会在创建 2 天后将其暂停，并在创建 7 天后将其删除。当您认领该集群时，Atlas 会将其转换为没有过期日期的标准免费集群。认领后的集群将保留其所有数据，并且您保存的连接字符串将继续使用相同的凭证。要了解有关认领影响的更多信息，请参阅 认领临时集群。

要声明该集群，必须有人在浏览器中登录 Atlas。选择以下其中一个选项：

• 立即认领：仅与将认领集群的人员共享 claimUrl。他们可以按照认领临时集群中的步骤来认领集群。

• 稍后认领：将 claimUrl 保存在一个安全的位置，供将认领集群的人员使用。该人员随后可以在创建后的 7 天内随时认领该集群。

• 从不声明：不采取任何操作。Atlas 会在创建 7 天后删除集群。

通过声明 URL 登录 Atlas。

1. 在 Web 浏览器中，打开您从创建响应中保存的 claimUrl，以访问 Atlas 登录页面。声明 URL 具有以下格式，其中 {claimId} 是 Ephemeral 集群的唯一标识符：

   https://account.mongodb.com/account/register?claimId={claimId}

2. 在登录页面，使用现有帐户登录 Atlas，或创建一个新帐户。当您在下一步中认领集群时，此帐户将获得对集群的数据库访问权限和管理访问权限。

   如果您创建新帐户，请在继续之前验证您的电子邮件。

配置并认领临时集群。

登录后，Atlas 会显示认领页面。在此页面上，执行以下操作：

1. 从下拉菜单中，选择一个现有组织，或选择 Create new org for this cluster 以创建一个组织。当您认领集群时，Atlas 会将其移入所选组织，并在其中为其创建一个项目。

   重要

   下拉列表仅列出您的 Atlas 帐户拥有 Organization Owner 角色的组织。当您声明集群时，所选组织中的每个 Organization Owner 都可以管理该集群及其数据。

2. 配置 IP 访问。要限制访问，请删除 0.0.0.0/0 并仅允许您当前的 IP 地址（推荐）。要允许来自任何 IP 地址的连接，请保留 0.0.0.0/0。您可以稍后在项目的 Network Access 设置中限制 IP 访问。

3. 单击 Claim Cluster。这是一项无法撤消的一次性操作。

查看确认页面。

认领集群后，Atlas 会显示一个确认页面，其中包含组织和项目名称、集群详细信息以及您选择的 IP 访问配置。

单击 Go To Project Overview 以在 Atlas 用户界面中查看已声明的集群。

（可选）重新配置已声明的集群。

您可以使用 Atlas 用户界面、Atlas CLI 或 Atlas Administration API 重新配置已声明的集群及其项目。在集群级别，您可以将集群扩展到更高的层级以增加存储。在项目级别，您可以管理数据库用户并限制 IP 访问以提高安全。要了解更多信息，请参阅管理集群。