Atlas Ephemeral クラスター を作成する

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この Ephemeral クラスターを取得するための固有の URL。人間がブラウザでこの URL を開く必要があります。クラスター作成後 7 日間有効です。

• clusterId: Ephemeral クラスターの一意の識別子。クラスターの status、claimUrl、およびその他の詳細を検索するには、{clusterId} をこの値に置き換えて、次のエンドポイントとなる接続されたデバイスに GET リクエストを送信します。

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

  詳細については、「一時的なAtlasクラスターを1つ返す」を参照してください。

• connectionString: Ephemeralクラスターへの接続にmongodb+srv://プロトコルを使用する接続文字列。クラスター内のデータの読み取りと書き込み (write)ができる自動生成されたデータベースユーザーのユーザー名とパスワードが含まれます。この接続文字列を使用するすべてのクライアントは、このデータベースユーザーとして認証されます。作成レスポンスは、Atlasが編集されていないパスワードを返す唯一のタイミングです。

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

• status: Ephemeral クラスターのステータス。PROVISIONING、ACTIVE、またはPAUSEDのいずれか。

• termsOfService: このAPIを使用することで、MongoDBのクラウド利用期間およびプライバシーポリシーに同意したものとみなされます。利用規約全文へのリンクが含まれています。

作成エンドポイントとなる接続されたデバイスの詳細を学ぶについては、Ephemeral Atlas クラスターを 1 つ作成するを参照してください。

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

作成レスポンスから、connectionString、claimUrl、およびclusterIdを保存します。これらは、クラスターへの接続、クラスターの要求、およびクラスターの詳細を検索するに必要です。

Ephemeral クラスターに接続します。

作成レスポンスの connectionString 値を使用して、次のような互換性のある環境から Ephemeral クラスターに接続します。

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

• コマンドライン: 接続文字列をMongoDB Shell (mongosh) の引数として指定して接続し、対話形式でコマンドを実行します。

  コマンドライン接続の例

  mongosh "<connectionString>"

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

（任意）Ephemeral クラスターを取得します。

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

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

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

• 後で請求する: クラスターを請求するユーザーが利用できる安全なロケーションに claimUrl を保存します。そのユーザーは、作成から 7 日以内であればいつでもクラスターを請求できます。

• Claim never: アクションを実行しません。Atlasは、作成から7日後にクラスターを削除します。

クレームURLからAtlasにサインインします。

1. Webブラウザで、作成レスポンスから保存したclaimUrlを開き、Atlasのサインインページにアクセスします。クレームURLの形式は次のとおりです。ここで、{claimId}はEphemeralクラスターの一意の識別子です。

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

2. サインインページで、既存のアカウントを使用してAtlasにサインインするか、新しいアカウントを作成します。次のステップでクラスターを要求すると、このアカウントはクラスターへのデータベースアクセス権と管理アクセス権の両方を取得します。

   新しいアカウントを作成する場合は、続行する前にメールを確認してください。

Ephemeralクラスターを構成して要求します。

サインインすると、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 を保持します。IP アクセスは、プロジェクトの Network Access 設定で後から制限できます。

3. [Claim Cluster] をクリックします。これは一度限りのアクションであり、元に戻すことはできません。

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

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

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

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

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