特定のプロジェクトに 1 つのクラスターを作成します。クラスターには、同じデータセットを維持するホストのグループが含まれます。このリソースは、マルチクラウドクラスターを作成しません。マルチクラウドクラスターを作成するには、 「1 つの高度なクラスターを作成」 を使用します。このリソースを使用するには、リクエスト元のサービスアカウントまたはAPIキーにプロジェクト オーナーのロールが必要です。
M10+専有クラスターを配置すると、そのプロバイダーとリージョンに既存のVPCまたはVPCピアリング接続が存在しない場合、Atlasは選択したプロバイダーとリージョン用のVPCを作成します。Atlas は VPC に CIDR(Classless Inter-Domain Routing)ブロックを割り当てます。
M2 または M5 の instanceSize を使用すると、代わりに Flex クラスターが作成されることに注意してください。 M2または M5 の instanceSize のサポートは、22、2026 で終了します。このような構成には、 Flex Cluster APIを使用する ことをお勧めします。
プロジェクトを識別する一意の 24 桁の 16 進数文字列。 認証済みユーザーがアクセスできるすべてのプロジェクトを取得するには、 /groups エンドポイントを使用します。
注: グループとプロジェクトは同義語です。そのため、グループ ID はプロジェクト ID と同じです。既存のグループの場合、グループ/プロジェクト ID は同じままです。リソースおよび対応するエンドポイントでは、グループという用語が使用されます。
形式は次のパターンと一致する必要があります: ^([a-f0-9]{24})$。
アプリケーションがレスポンスを envelope JSON オブジェクトにラップするかどうかを示すフラグ。一部の API クライアントは、HTTP レスポンス ヘッダーまたはステータス コードにアクセスできません。これを修正するには、クエリで envelope=true を設定します。結果のリストを返すエンドポイントは、結果オブジェクトをエンベロープとして使用します。アプリケーションは、レスポンス本体にステータス パラメータを追加します。
デフォルト値はfalseです。
レスポンス本体を pretty-print 形式にするかどうかを示すフラグ。
デフォルト値はfalseです。
このプロジェクトで作成するクラスター。
リージョン停止時によりプライマリを復旧するために再構成が必要な場合は、トポロジーの再構成と一緒にこのフィールドを送信して、新たなリージョン停止時に耐性のあるトポロジーをリクエスト。複製された書込み(過半数がコミットされた書込みであっても)が新しい プライマリノードに複製されていない場合、選挙可能なノードの過半数が停止時間に強制再構成を行うと、データが失われるリスクがあります。 MongoDB Atlas のドキュメントに詳しい情報が記載されています。このリスクを伴う操作を続行するには、acceptDataRisksAndForceReplicaSetReconfig を現在の日付に設定します。このパラメータは、UTC の ISO 8601 タイムスタンプ形式で値を表します。
高度な構成の詳細のサブセットを構成する設定のグループ。
クラスターを増やすことができるインスタンス サイズの範囲。
クラスターがバックアップを実行できるかどうかを示すフラグ。true に設定されていると、クラスターはバックアップを実行できます。NVMe クラスターの場合、この値を true に設定する必要があります。バックアップは、専用クラスターにはクラウドバックアップを使用し、テナントクラスターには共有クラスターバックアップを使用します。false に設定されていると、クラスターは MongoDB Cloud バックアップを使用しません。
このクラスターの MongoDB Connector for Business Intelligence を構成するために必要な設定。
クラスターを構成するノードの構成。
値は REPLICASET、SHARDED、または GEOSHARDED です。
シャーディングされたクラスターを作成または更新するための コンフィギュレーションサーバー マネジメント モード 。 ATLAS_MANAGED として構成されている場合、Atlas は最適なパフォーマンスと節約のためにクラスターのコンフィギュレーションサーバータイプを自動的に切り替える場合があります。 FIXED_TO_DEDICATED として構成されている場合、クラスターは常に専用のコンフィギュレーションサーバーを使用します。
値は ATLAS_MANAGED または FIXED_TO_DEDICATED です。デフォルト値は ATLAS_MANAGED です。
このクラスターが自動的に削除されるクラスター作成後の時間数。
このフィールドは、createDate に対する deleteAfterDate を生成するために使用されます。
クラスターの作成時に null またはゼロに設定されている場合、クラスターは自動的に削除されません。
クラスターの作成時に正の値に設定すると、クラスターは指定された時間数後に自動的に削除されます。
既存の(削除されていない)クラスターでこのフィールドを更新し、null に設定している場合、既存の値はこの と deleteAfterDate で保持されます。
既存の(削除されていない)クラスターでこのフィールドを更新し、かつゼロに設定されている場合、以前の構成に関係なく、deleteAfterDate は null(自動削除を無効)にリセットされます。
既存の(削除されていない)クラスターでこのフィールドを更新し、これが正の値に設定されている場合、createDate + deleteAfterCreationHours は より後のである必要があります。そうでない場合、フィールドの更新は無視され、既存の値はこの および のために保持されます。 deleteAfterDate。
インスタンス データ ボリュームのストレージ容量(ギガバイト単位)。 この数を増やすと、容量が追加されます。
この値は、M 0 /M 2 /M 5クラスターでは構成できません。
MongoDB Cloud では、replicationSpecs を設定する場合にこのパラメータが必要です。
最小( 10 GB)より小さいディスク サイズを指定する場合、このパラメータはデフォルトで最小ディスク サイズ値になります。
ストレージ料金の計算は、デフォルト値を選択するかカスタム値を選択するかによって異なります。
ディスク ストレージの最大値は、選択したクラスターの最大 RAM の50倍を超えることはできません。 より多くのストレージ容量が必要な場合は、クラスターを上位階層にアップグレードすることを検討してください。
最小値は 10、最大値は 4096 です。
ディスク ウォーミング モードの選択。
値は FULLY_WARMED または VISIBLE_EARLIER です。デフォルト値は FULLY_WARMED です。
カスタマーキーを管理して、クラスターの保管時の暗号化の追加レイヤーを提供するクラウド サービス プロバイダー。保管時の暗号化のためのカスタマーキー管理を有効にするには、クラスターの replicationSpecs[n].regionConfigs[m].{type}Specs.instanceSize 設定が M10 以上、かつ "backupEnabled" : false または完全に省略されている必要があります。
値は、NONE、AWS、AZURE、または GCP です。
新しいグローバルクラスターを作成するときに、シャーディング管理モードを構成するには、このフィールドを に設定します。
false に設定されている場合、マネジメント モードは Atlas マネージド シャーディングに設定されます。このモードはグローバルクラスターのシャーディングを完全に管理し、シームレスな配置エクスペリエンスを提供するように構築されています。
true に設定されている場合、マネジメント モードは自己管理型シャーディングに設定されます。このモードは、シャードの管理をユーザーに委ね、高度で柔軟な配置エクスペリエンスを提供するように構築されています。
この設定は、クラスターが配置されると変更できません。
クラスターにタグを付けて分類する、長さが 1 から 255 文字のキーと値のペアのコレクション。MongoDB Cloud コンソールはラベルを表示しません。
クラスター ラベルは非推奨であり、将来のリリースで削除される予定です。代わりにリソース タグを使用することを強くお勧めします。
このMongoDB Cloud コンポーネントに適用された、人間が判読可能なラベル。
クラスターの MongoDB メジャー バージョン。
作成時: 利用可能な MongoDB のバージョンから選択するか、MongoDB Cloud プラットフォームで現在推奨されているデフォルトを未指定のままにします。推奨バージョンは、最新の長期サポートバージョンです。デフォルト設定は、全リリース サイクルを通じて最新のリリース バージョンであることを保証するものではありません。特定のプロジェクトで利用可能なバージョンについては、リンクされたドキュメントを参照するか、プロジェクト LTS バージョン エンドポイントの API エンドポイントを使用してください。
更新時: 一度に1メジャー バージョンを つだけ上げてください。 クラスターが、現在の MongoDB バージョンより 1 つ下の MongoDB 機能の互換性バージョンに固定されている場合は、MongoDB バージョンはそれ以前のメジャー バージョンにダウングレードできます。
クラスターが実行する MongoDB のバージョン。
形式は次のパターンと一致する必要があります: ([\d]+\.[\d]+\.[\d]+)。
クラスターを識別する人間が判読できるラベル。
形式は次のパターンと一致する必要があります: ^[a-zA-Z0-9][a-zA-Z0-9-]*$。
シャーディングされたクラスターに配置できるシャードの数は最大 50 個です。リソースは、レプリカセットを示す場合は 1 を返し、シャーディングされたクラスターを示す場合は 2 以上の値を返します。戻り値は、クラスター内のシャードの数と等しくなります。
最小値は 1、最大値は 50 です。デフォルト値は 1 です。
クラスターが一時停止しているかどうかを示すフラグ。
クラスターが継続的なクラウドバックアップを使用するかどうかを示すフラグ。
M10 以上のクラスターがクラウドバックアップを実行できるかどうかを示すフラグ。 true に設定されている場合、クラスターはバックアップを実行できます。これと backupEnabled が false に設定されている場合、クラスターはMongoDB Cloud バックアップを使用しません。
クラスターのレプリカセット スケーリング モードを構成するには、このフィールドを に設定します。
デフォルトでは 、Atlas は WORKLOAD_TYPE の下でスケーリングされます。このモードでは、Atlas は分析ノードを運用ノードと並行して増やすできます。
SEQUENTIAL として構成すると、Atlas はすべてのノードを順次スケーリングします。このモードは、定常状態のワークロードとレイテンシの影響を受けやすいセカンダリ読み取りを実行するアプリケーションを対象としています。
NODE_TYPE に設定すると、Atlas は選択可能なノードを読み取り専用ノードと分析ノードと並行してスケーリングします。このモードは、頻繁にクラスター層をスケーリングすることを必要とする大規模で動的ワークロードを対象としています。これは最速のスケーリング戦略ですが、大量のセカンダリ読み取りを実行するとワークロードのレイテンシに影響可能性があります。
値は SEQUENTIAL、WORKLOAD_TYPE、または NODE_TYPE です。デフォルト値は WORKLOAD_TYPE です。
レプリカセットに属するノードの数。各ノードはデータベースのコピーを保持し、高可用性とデータの冗長性を提供します。代わりに replicationSpecs を使用してください。
値は 3、5、または 7 です。デフォルト値は 3 です。
MongoDB Cloud がクラスター ノードをプロビジョニングする物理的なロケーション。
クラスター リージョンを構成する設定のリスト。
MongoDB Atlasクラスターが使用するルート認証局。MongoDB Cloud は Internet Research Group をサポートしています。
値は ISRGROOTX1 です。デフォルト値は ISRGROOTX1 です。
クラスターで終了保護が有効になっているかどうかを示すフラグ。true に設定されていると、MongoDB Cloud はクラスターを削除しません。false に設定されていると、MongoDB Cloud はクラスターを削除します。
デフォルト値はfalseです。
クラスターがMongoDB のバージョンを管理する方法。値が CONTINUOUS の場合、mongoDBMajorVersion を指定しないでください。
値は LTS または CONTINUOUS です。デフォルト値は LTS です。
curl \
--request POST 'https://cloud.mongodb.com/api/atlas/v1.0/groups/32b6e34b3d91647abb20e7b8/clusters' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{"acceptDataRisksAndForceReplicaSetReconfig":"2026-05-04T09:42:00Z","advancedConfiguration":{"customOpensslCipherConfigTls12":["TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384"],"customOpensslCipherConfigTls13":["TLS_AES_256_GCM_SHA384"],"minimumEnabledTlsProtocol":"TLS1_0","tlsCipherConfigMode":"CUSTOM"},"autoScaling":{"compute":{"enabled":false,"scaleDownEnabled":false},"diskGBEnabled":false},"backupEnabled":true,"biConnector":{"enabled":true,"readPreference":"PRIMARY"},"clusterType":"REPLICASET","configServerManagementMode":"ATLAS_MANAGED","deleteAfterCreationHours":42,"diskSizeGB":42.0,"diskWarmingMode":"FULLY_WARMED","encryptionAtRestProvider":"NONE","globalClusterSelfManagedSharding":true,"labels":[{"key":"string","value":"string"}],"mongoDBMajorVersion":"5.0","mongoDBVersion":"5.0.25","name":"string","numShards":1,"paused":true,"pitEnabled":true,"providerBackupEnabled":true,"providerSettings":{"providerName":"AWS","autoScaling":{"compute":{"maxInstanceSize":"M10","minInstanceSize":"M10"}},"diskIOPS":42,"encryptEBSVolume":true,"instanceSizeName":"M10","regionName":"US_GOV_WEST_1","volumeType":"STANDARD"},"replicaSetScalingStrategy":"WORKLOAD_TYPE","replicationFactor":3,"replicationSpec":{"additionalProperty1":{"analyticsNodes":42,"electableNodes":0,"priority":42,"readOnlyNodes":42},"additionalProperty2":{"analyticsNodes":42,"electableNodes":0,"priority":42,"readOnlyNodes":42}},"replicationSpecs":[{"id":"32b6e34b3d91647abb20e7b8","numShards":1,"regionsConfig":{"additionalProperty1":{"analyticsNodes":42,"electableNodes":0,"priority":42,"readOnlyNodes":42},"additionalProperty2":{"analyticsNodes":42,"electableNodes":0,"priority":42,"readOnlyNodes":42}},"zoneName":"string"}],"rootCertType":"ISRGROOTX1","tags":[{"key":"string","value":"string"}],"terminationProtectionEnabled":false,"versionReleaseSystem":"LTS"}'
{
"acceptDataRisksAndForceReplicaSetReconfig": "2026-05-04T09:42:00Z",
"advancedConfiguration": {
"customOpensslCipherConfigTls12": [
"TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384"
],
"customOpensslCipherConfigTls13": [
"TLS_AES_256_GCM_SHA384"
],
"minimumEnabledTlsProtocol": "TLS1_0",
"tlsCipherConfigMode": "CUSTOM"
},
"autoScaling": {
"compute": {
"enabled": false,
"scaleDownEnabled": false
},
"diskGBEnabled": false
},
"backupEnabled": true,
"biConnector": {
"enabled": true,
"readPreference": "PRIMARY"
},
"clusterType": "REPLICASET",
"configServerManagementMode": "ATLAS_MANAGED",
"deleteAfterCreationHours": 42,
"diskSizeGB": 42.0,
"diskWarmingMode": "FULLY_WARMED",
"encryptionAtRestProvider": "NONE",
"globalClusterSelfManagedSharding": true,
"labels": [
{
"key": "string",
"value": "string"
}
],
"mongoDBMajorVersion": "5.0",
"mongoDBVersion": "5.0.25",
"name": "string",
"numShards": 1,
"paused": true,
"pitEnabled": true,
"providerBackupEnabled": true,
"providerSettings": {
"providerName": "AWS",
"autoScaling": {
"compute": {
"maxInstanceSize": "M10",
"minInstanceSize": "M10"
}
},
"diskIOPS": 42,
"encryptEBSVolume": true,
"instanceSizeName": "M10",
"regionName": "US_GOV_WEST_1",
"volumeType": "STANDARD"
},
"replicaSetScalingStrategy": "WORKLOAD_TYPE",
"replicationFactor": 3,
"replicationSpec": {
"additionalProperty1": {
"analyticsNodes": 42,
"electableNodes": 0,
"priority": 42,
"readOnlyNodes": 42
},
"additionalProperty2": {
"analyticsNodes": 42,
"electableNodes": 0,
"priority": 42,
"readOnlyNodes": 42
}
},
"replicationSpecs": [
{
"id": "32b6e34b3d91647abb20e7b8",
"numShards": 1,
"regionsConfig": {
"additionalProperty1": {
"analyticsNodes": 42,
"electableNodes": 0,
"priority": 42,
"readOnlyNodes": 42
},
"additionalProperty2": {
"analyticsNodes": 42,
"electableNodes": 0,
"priority": 42,
"readOnlyNodes": 42
}
},
"zoneName": "string"
}
],
"rootCertType": "ISRGROOTX1",
"tags": [
{
"key": "string",
"value": "string"
}
],
"terminationProtectionEnabled": false,
"versionReleaseSystem": "LTS"
}
{
"acceptDataRisksAndForceReplicaSetReconfig": "2026-05-04T09:42:00Z",
"advancedConfiguration": {
"customOpensslCipherConfigTls12": [
"TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384"
],
"customOpensslCipherConfigTls13": [
"TLS_AES_256_GCM_SHA384"
],
"minimumEnabledTlsProtocol": "TLS1_0",
"tlsCipherConfigMode": "CUSTOM"
},
"autoScaling": {
"compute": {
"enabled": false,
"scaleDownEnabled": false
},
"diskGBEnabled": false
},
"backupEnabled": true,
"biConnector": {
"enabled": true,
"readPreference": "PRIMARY"
},
"clusterType": "REPLICASET",
"configServerManagementMode": "ATLAS_MANAGED",
"configServerType": "DEDICATED",
"connectionStrings": {
"awsPrivateLink": {
"additionalProperty1": "string",
"additionalProperty2": "string"
},
"awsPrivateLinkSrv": {
"additionalProperty1": "string",
"additionalProperty2": "string"
},
"private": "string",
"privateEndpoint": [
{
"connectionString": "string",
"endpoints": [
{
"endpointId": "string",
"providerName": "AWS",
"region": "string"
}
],
"srvConnectionString": "string",
"srvShardOptimizedConnectionString": "string",
"type": "MONGOD"
}
],
"privateSrv": "string",
"standard": "string",
"standardSrv": "string"
},
"createDate": "2026-05-04T09:42:00Z",
"deleteAfterCreationHours": 42,
"deleteAfterDate": "2026-05-04T09:42:00Z",
"diskSizeGB": 42.0,
"diskWarmingMode": "FULLY_WARMED",
"encryptionAtRestProvider": "NONE",
"featureCompatibilityVersion": "string",
"featureCompatibilityVersionExpirationDate": "2026-05-04T09:42:00Z",
"globalClusterSelfManagedSharding": true,
"groupId": "32b6e34b3d91647abb20e7b8",
"id": "32b6e34b3d91647abb20e7b8",
"labels": [
{
"key": "string",
"value": "string"
}
],
"links": [
{
"href": "https://cloud.mongodb.com/api/atlas",
"rel": "self"
}
],
"mongoDBEmployeeAccessGrant": {
"expirationTime": "2026-05-04T09:42:00Z",
"grantType": "CLUSTER_DATABASE_LOGS",
"links": [
{
"href": "https://cloud.mongodb.com/api/atlas",
"rel": "self"
}
]
},
"mongoDBMajorVersion": "5.0",
"mongoDBVersion": "5.0.25",
"mongoURI": "string",
"mongoURIUpdated": "2026-05-04T09:42:00Z",
"mongoURIWithOptions": "string",
"name": "string",
"numShards": 1,
"paused": true,
"pitEnabled": true,
"providerBackupEnabled": true,
"providerSettings": {
"providerName": "AWS",
"autoScaling": {
"compute": {
"maxInstanceSize": "M10",
"minInstanceSize": "M10"
}
},
"diskIOPS": 42,
"encryptEBSVolume": true,
"instanceSizeName": "M10",
"regionName": "US_GOV_WEST_1",
"volumeType": "STANDARD"
},
"replicaSetScalingStrategy": "WORKLOAD_TYPE",
"replicationFactor": 3,
"replicationSpec": {
"additionalProperty1": {
"analyticsNodes": 42,
"electableNodes": 0,
"priority": 42,
"readOnlyNodes": 42
},
"additionalProperty2": {
"analyticsNodes": 42,
"electableNodes": 0,
"priority": 42,
"readOnlyNodes": 42
}
},
"replicationSpecs": [
{
"id": "32b6e34b3d91647abb20e7b8",
"numShards": 1,
"regionsConfig": {
"additionalProperty1": {
"analyticsNodes": 42,
"electableNodes": 0,
"priority": 42,
"readOnlyNodes": 42
},
"additionalProperty2": {
"analyticsNodes": 42,
"electableNodes": 0,
"priority": 42,
"readOnlyNodes": 42
}
},
"zoneName": "string"
}
],
"rootCertType": "ISRGROOTX1",
"srvAddress": "string",
"stateName": "IDLE",
"tags": [
{
"key": "string",
"value": "string"
}
],
"terminationProtectionEnabled": false,
"versionReleaseSystem": "LTS"
}
{
"error": 400,
"detail": "(This is just an example, the exception may not be related to this endpoint) No provider AWS exists.",
"reason": "Bad Request",
"errorCode": "VALIDATION_ERROR"
}
{
"error": 401,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Unauthorized",
"errorCode": "NOT_ORG_GROUP_CREATOR"
}
{
"error": 402,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Payment Required",
"errorCode": "NO_PAYMENT_INFORMATION_FOUND"
}
{
"error": 403,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Forbidden",
"errorCode": "CANNOT_CHANGE_GROUP_NAME"
}
{
"error": 404,
"detail": "(This is just an example, the exception may not be related to this endpoint) Cannot find resource AWS",
"reason": "Not Found",
"errorCode": "RESOURCE_NOT_FOUND"
}
{
"error": 409,
"detail": "(This is just an example, the exception may not be related to this endpoint) Cannot delete organization link while there is active migration in following project ids: 60c4fd418ebe251047c50554",
"reason": "Conflict",
"errorCode": "CANNOT_DELETE_ORG_ACTIVE_LIVE_MIGRATION_ATLAS_ORG_LINK"
}
{
"error": 500,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Internal Server Error",
"errorCode": "UNEXPECTED_ERROR"
}