创建Atlas临时集群

创建临时集群。

向以下端点发送 POST请求：

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

该请求需要以下 Accept 标头：

'接受：应用程序/vnd.atlas.preview+json'

以下示例请求将创建一个名为 Cluster0 的临时集群：

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 天内有效。

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

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

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

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

• expiresAt： Atlas在无人认领时暂停集群的日期和时间。在您认领暂停的临时集群之前，您无法访问该集群。时间戳使用 UTC 格式的 ISO 8601。

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

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

要学习；了解有关创建端点的更多信息，请参阅创建一个临时Atlas集群。

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

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

连接到临时集群。

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

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

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

  命令行连接示例

  mongosh "<connectionString>"

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

（可选）声明临时集群。

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

要认领集群，必须在浏览器中登录Atlas 。选择以下选项之一：

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

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

• Claim never: Take no action. Atlas deletes the cluster 7 days after creation.

从声明URL登录Atlas 。

1. 在网络浏览器中，打开在创建响应中保存的 claimUrl，以访问Atlas登录页面。声明URL采用以下格式，其中 {claimId} 是临时集群的唯一标识符：

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

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

   如果您创建新帐户，请先验证您的电子邮件，然后再继续。

配置并声明临时集群。

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

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

   重要

   该下拉列表仅列出您的Atlas账户具有 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访问权限以提高安全性。要学习；了解更多信息，请参阅管理集群。