指定されたプロジェクトに 1 つ以上のアクセス リスト エントリを追加します。MongoDB Cloud は、プロジェクトの IP アクセス リストのエントリからのみクラスタへのクライアント接続を許可します。各エントリは 1 つの IP アドレス、または CIDR で記述された IP アドレスの 1 件のブロックとして書き込みます。このリソースはホワイトリスト リソースを置き換えます。MongoDB クラウドは 2021 年 7 月にホワイトリストを削除しました。この新しいリソースを使用するには、アプリケーションを更新してください。/groups/{GROUP-ID}/accessList エンドポイントはデータベース IP アクセス リストを管理します。このエンドポイントは、MongoDB Cloud 組織のアクセス リストを管理する orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist エンドポイントとは異なります。このエンドポイントは同時 POST リクエストをサポートしていません。複数の POST リクエストを同期させて送信する必要があります。
プロジェクトを識別する一意の 24 桁の 16 進数文字列。 認証済みユーザーがアクセスできるすべてのプロジェクトを取得するには、 /groups エンドポイントを使用します。
注: グループとプロジェクトは同義語です。そのため、グループ ID はプロジェクト ID と同じです。既存のグループの場合、グループ/プロジェクト ID は同じままです。リソースおよび対応するエンドポイントでは、グループという用語が使用されます。
形式は次のパターンと一致する必要があります: ^([a-f0-9]{24})$。
アプリケーションがレスポンスを envelope JSON オブジェクトにラップするかどうかを示すフラグ。一部の API クライアントは、HTTP レスポンス ヘッダーまたはステータス コードにアクセスできません。これを修正するには、クエリで envelope=true を設定します。結果のリストを返すエンドポイントは、結果オブジェクトをエンベロープとして使用します。アプリケーションは、レスポンス本体にステータス パラメータを追加します。
デフォルト値はfalseです。
MongoDB クラウドがレスポンスのアイテム総数を計算するかどうかを示すフラグ。falseに設定すると、MongoDB クラウドは追加のカウント操作をスキップする場合があります。追加の計算なしでカウントが利用可能な場合、レスポンスにtotalCountが含まれることがあります。
デフォルト値はtrueです。
レスポンスが返す 1 ページあたりのアイテムの数。
最小値は 1、最大値は 500 です。デフォルト値は 100 です。
レスポンスが返す合計オブジェクト数の現在のセットを表示するページの番号。
の最小値は 1 です。デフォルト値は 1 です。
レスポンス本体を pretty-print 形式にするかどうかを示すフラグ。
デフォルト値はfalseです。
指定されたプロジェクトに追加する 1 つ以上のアクセス リスト エントリ。
プロジェクトのIP アクセス リストに追加するAmazon Web Services （AWS ）のセキュリティ グループの一意のstring。IP アクセス リストエントリは、1 つの awsSecurityGroup、1 つの cidrBlock、または 1 つの ipAddress になります。AWSセキュリティグループをIP アクセス リストに追加する前に、プロジェクトの仮想プライベート接続（ VPC ）ピアリングを設定する必要があります。AWSセキュリティ グループを一時的なアクセスリスト エントリとして設定することはできません。cidrBlock または ipAddress を設定する場合は、このパラメータを設定しないでください。
形式は次のパターンと一致する必要があります: ^([0-9]*/)?sg-([0-9]*)。
プロジェクトのIP アクセス リストに追加する、クラスレス ドメイン間ルーティング (CIDR) 表記のIPアドレスの範囲。IP アクセス リストエントリは、1 つの awsSecurityGroup、1 つの cidrBlock、または 1 つの ipAddress になります。awsSecurityGroup または ipAddress を設定する場合は、このパラメータを設定しないでください。
形式は次のパターンと一致する必要があります: ^([0-9]{1,3}\.){3}[0-9]{1,3}(%2[fF][0-9]{1,3})?|([0-9a-f]{1,4}\:){7}[0-9a-f]{1,4}(%2[fF][0-9]{1,3})?|([0-9a-f]{1,4}\:){1,6}\:(%2[fF][0-9]{1,3})?$。
この IP アクセス リスト エントリの目的または範囲を説明するコメント。
最大長は 80 です。
MongoDB Cloud が一時アクセスリスト エントリを削除する日時。このパラメーターは、その値を ISO 8601 タイムスタンプ形式で UTC で表し、タイム ゾーンの指定を含めることができます。日付は現在の日付より後で、このリクエストの送信から 1 週間以内である必要があります。この IP アクセス リスト エントリの作成時に有効期限を指定した場合、リソースはこのパラメータを返します。
プロジェクトのIP アクセス リストに追加するIPアドレス。IP アクセス リストエントリは、1 つの awsSecurityGroup、1 つの cidrBlock、または 1 つの ipAddress になります。awsSecurityGroup または cidrBlock を設定する場合は、このパラメータを設定しないでください。
形式は次のパターンと一致する必要があります: ^((25[0-5]|(2[0-4]|1\d|[1-9]|)\d)(\.(?!$)|$)){4}|([0-9a-f]{1,4}:){7}[0-9a-f]{1,4}$。
curl \
--request POST 'https://cloud.mongodb.com/api/atlas/v1.0/groups/32b6e34b3d91647abb20e7b8/accessList' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '[
{
"awsSecurityGroup": "string",
"cidrBlock": "string",
"comment": "string",
"deleteAfterDate": "2026-05-04T09:42:00Z",
"ipAddress": "string"
}
]'[
{
"awsSecurityGroup": "string",
"cidrBlock": "string",
"comment": "string",
"deleteAfterDate": "2026-05-04T09:42:00Z",
"ipAddress": "string"
}
]{
"links": [
{
"href": "https://cloud.mongodb.com/api/atlas",
"rel": "self"
}
],
"results": [
{
"awsSecurityGroup": "string",
"cidrBlock": "string",
"comment": "string",
"deleteAfterDate": "2026-05-04T09:42:00Z",
"groupId": "32b6e34b3d91647abb20e7b8",
"ipAddress": "string",
"links": [
{
"href": "https://cloud.mongodb.com/api/atlas",
"rel": "self"
}
]
}
],
"totalCount": 42
}{
"detail": "(This is just an example, the exception may not be related to this endpoint) No provider AWS exists.",
"error": 400,
"errorCode": "VALIDATION_ERROR",
"reason": "Bad Request"
}{
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"error": 401,
"errorCode": "NOT_ORG_GROUP_CREATOR",
"reason": "Unauthorized"
}{
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"error": 403,
"errorCode": "CANNOT_CHANGE_GROUP_NAME",
"reason": "Forbidden"
}{
"detail": "Invalid Configuration. Contains selections that are unavailable due to your organization's resource policies.",
"error": 403,
"errorCode": "ATLAS_RESOURCE_POLICIES_VIOLATION_NOT_AUTHORIZED",
"parameters": [],
"policiesCausingDecision": [
{
"id": "32b6e34b3d91647abb20e7b8",
"name": "forbid-aws-clusters"
}
],
"reason": "Forbidden"
}{
"detail": "(This is just an example, the exception may not be related to this endpoint) Cannot find resource AWS",
"error": 404,
"errorCode": "RESOURCE_NOT_FOUND",
"reason": "Not Found"
}{
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"error": 500,
"errorCode": "UNEXPECTED_ERROR",
"reason": "Internal Server Error"
}