Atlas エフェメラル クラスターの作成

エフェメラル クラスターを作成します。

次のエンドポイントに POSTリクエストを送信します。

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

リクエストには次の Accept ヘッダーが必要です。

Accept: application/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}

  詳細については、「 1 つのエフェメラル Atlas クラスターを返す 」を参照してください。

• connectionString: mongodb+srv://プロトコルを使用してエフェメラル クラスターに接続する接続文字列。クラスター内のデータの読み取りと書込みができる自動生成されたデータベースユーザーのユーザー名とパスワードが含まれます。この接続文字列を使用するクライアントは、このデータベースユーザーとして認証されます。作成応答は、Atlas が編集されていないパスワードを返す回数です。

• expiresAt: クラスターが要求されていない場合に Atlas がクラスターを一時停止する日時。一時停止されたエフェメラル クラスターは、クレームするまでアクセスできません。タイムスタンプは UTC の ISO8601 形式を使用します。

• status: エフェメラル クラスターのステータス。 PROVISIONING、ACTIVE、または PAUSED のいずれか 1 つ。

• termsOfService: このAPIを使用すると、MongoDB のクラウド サービス利用規約およびプライバシー ポリシーに同意したことになります。完全なタームへのリンクが含まれています。

作成エンドポイントの詳細については、「 エフェメラル Atlas クラスターを 1 つ作成する 」を参照してください。

接続文字列とクレーム値を保存します。

作成応答から、connectionString、claimUrl、clusterId を保存します。クラスターの詳細を取得、クレーム、取得するには、これらが必要です。

エフェメラル クラスターに接続します。

作成応答の connectionString 値を使用して、次のような互換性のある環境からエフェメラル クラスターに接続します。

• アプリケーション コード: クラスターに接続するクライアントオブジェクトを初期化するときに、プログラミング言語のMongoDBドライバーへの接続文字列を指定します。これは、アプリケーションから接続する場合の一般的な選択です。詳細については、「 クライアント ライブラリを使用したクラスターへの接続 」を参照してください。

• コマンドライン: MongoDB Shell（mongosh ）への引数として接続文字列を指定し、コマンドを対話的に接続して実行します。

  コマンドライン接続の例

  mongosh "<connectionString>"

利用可能な接続方法の詳細については、「 考慮事項 」を参照してください。

（任意） エフェメラル クラスターを要求します。

エフェメラル クラスターのクレームは任意です。クラスターをクレームしない場合、Atlas2 は作成から 日後にクラスターを一時停止し、作成から7 日後に削除します。クラスターを要求すると、Atlas はそれを有効期限のない標準の 無料クラスターに変換します。要求されたクラスターはそのクラスターのすべてのデータを保持し、保存した接続文字列は同じ認証情報で引き続き動作します。クレームの影響の詳細については、「 エフェメラル クラスターのクレーム 」を参照してください。

クラスターを要求するには、人間がブラウザで Atlas にサインインする必要があります。次のいずれかのオプションを選択します。

• 今すぐクレーム:claimUrl は、クラスターをクレームするユーザーのみと共有します。 「 エフェメラルクラスターの要求 」の手順に従ってクラスターを要求できます。

• 後で請求する: claimUrlを安全な場所に保存し、クラスターを請求するユーザーが引き続き使用できるようにします。その後は、作成から7 日以内にいつでもクラスターを要求できます。

• クレームは絶対にありません:アクションは実行されません 。 Atlas は作成から7 日後にクラスターを削除します。

クレーム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 はそれを選択した組織に移動し、そのクラスターのプロジェクトを作成します。

   重要

   []Organization Owner ドロップダウンには、Atlas アカウントが ロールを持つ組織のみがリストされます。クラスターをクレームすると、選択した組織内のすべての組織オーナーがクラスターとそのデータを管理できるようになります。

2. IPアクセスを構成します。アクセスを制限するには、0.0.0.0/0 を削除し、現在のIPアドレスのみを許可します（推奨）。任意のIPアドレスからの接続を許可するには、0.0.0.0/0 を維持します。プロジェクトの Network Access 設定では、後でIPアクセスを制限できます。

3. [Claim Cluster をクリックします。これは元に戻すことができない 1 回限りのアクションです。

確認ページを確認します。

クラスターを要求すると、Atlas に組織名とプロジェクト名、クラスターの詳細、選択したIPアクセス構成を含む確認ページが表示されます。

Atlas UIでクレームされたクラスターを表示するには、 Go To Project Overview をクリックします。

（任意）要求されたクラスターを再構成します。

Atlas UI、 Atlas CLI 、または Atlas Administration APIを使用して、クレームしたクラスターとそのプロジェクトを再構成できます。クラスター レベルでは、クラスターをより高い階層に増やすストレージ を増やすことができます。プロジェクトレベルでは、データベースユーザーを管理し、 IPアクセスを制限してセキュリティを強化できます。詳細については、 「クラスターの管理」 を参照してください。