注意
グループとプロジェクトは同義期間です。あなたの {PROJECT-ID} はグループ ID と同じです。既存のグループの場合、グループ/プロジェクトID は同じままです。このページでは、説明を参照するときに、より一般的な期間のグループ を使用します。エンドポイントとなる接続されたデバイスは、ドキュメントに記載されているままです。
このページでは、オートメーション構成を構成するパラメーターについて説明します。
その他の例については、mms-api-例 を参照してください。
構成バージョン
これには、自動化構成のバージョンが表示されます。
"version" : "<integer>"
名前 | タイプ | 必要性 | 説明 |
|---|---|---|---|
バージョン | integer | 必須 | このオートメーション構成ファイルを変更します。 |
ダウンロード ベース
Cloud Manager は自動バージョンをダウンロードし、 options . DownloadBase で設定されたディレクトリで起動スクリプトを実行します。
"options" : { "downloadBase" : "<string>", }
名前 | タイプ | 必要性 | 説明 |
|---|---|---|---|
options | オブジェクト | 必須 | 新しいバージョンの自動ダウンロードのパス。 |
options.DownloadBase | string | 必須 | 自動バージョンダウンロードとスタートアップスクリプトに関する Linux および UNIX プラットフォーム上のディレクトリ。 |
MongoDB バージョンの仕様
mongoDbVersions[n]配列は、 processes配列にある MongoDB インスタンスの仕様オブジェクトを定義します。 processes配列内の各 MongoDB インスタンスには、この配列内の仕様オブジェクトが必要です。
1 "mongoDbVersions[n]" : [ 2 { 3 "name" : "<string>", 4 "builds" : [ 5 { 6 "platform" : "<string>", 7 "url" : "<string>", 8 "gitVersion" : "<string>", 9 "modules" : [ "<string>", ... ], 10 "architecture" : "<string>", 11 "bits" : "<integer>", 12 "win2008plus" : "<Boolean>", 13 "winVCRedistUrl" : "<string>", 14 "winVCRedistOptions" : [ "<string>", ... ], 15 "winVCRedistDll" : "<string>", 16 "winVCRedistVersion" : "<string>" 17 }, 18 ... 19 ], 20 }, 21 ... 22 ]
名前 | タイプ | 必要性 | 説明 |
|---|---|---|---|
mongoDbVersions[n] | オブジェクトの配列 | 必須 | プロセス配列にある MongoDB インスタンスの仕様オブジェクト。 プロセス内の各 MongoDB インスタンスには、 mongoDbVersions[n]の仕様オブジェクトが必要です。 |
mongoDbVersions[n].name | string | 必須 | 仕様オブジェクトの名前。 この構成では、インスタンスのProcesss.versionパラメーターを介して MongoDB インスタンスに添付されます。 |
mongoDbVersions[n].Builds[k] | オブジェクトの配列 | 必須 | この MongoDB インスタンスで利用可能なビルド。 |
mongoDbVersions[n].Builds[k].プラットフォーム | string | 必須 | この MongoDB インスタンスのプラットフォーム。 |
mongoDbVersions[n].Builds[k].url | string | 必須 | このインスタンスの MongoDB をダウンロードするURL 。 |
mongoDbVersions[n].Builds[k].gitVersion | string | 必須 | MongoDBプロセスを構築するために使用されるコードの状態を識別するコミット識別子。 MongoDB コマンドは GitVersion |
mongoDbVersions[n].Builds[k].modules | 配列 | 必須 | このバージョンのモジュールの一覧。 buildInfoコマンドが返すモジュールパラメーターに対応します。 |
mongoDbVersions[n].Builds[k].アーキテクチャ | string | 必須 | プロセッサのアーキテクチャ。 Cloud Manager はamd64またはppc64leを受け入れます。 |
mongoDbVersions[n].Builds[k].bits | integer | 非推奨 | プロセッサのバス幅。 このパラメーターを削除したり変更したりしないでください。 |
mongoDbVersions[n].Builds[k].win2008++ | ブール値 | 任意 | Windows 7 以降または Windows Server 2008 R2 以降を必要とする Windows ビルドである場合は、 をtrueに設定します。 |
mongoDbVersions[n].Builds[k].winVRedistUrl | string | 任意 | Microsoft Visual C++ 再ディストリビューションの必要なバージョンをダウンロードできるURL 。 |
mongoDbVersions[n].Builds[k].winVRedistOptions | 文字列の配列 | 任意 | Visualstring 再頒布可能 インストーラーを実行するときに指定するコマンドライン オプションを一覧表示するMicrosoftC++ 値。各コマンドライン オプションは、 配列内の個別の string です。 |
mongoDbVersions[n].Builds[k].winVRedistDll | string | 任意 | エージェントがチェックして新しいバージョンの Microsoft Visual C++再頒布可能ファイルが必要かどうかを判断するための Microsoft Visual C++ ランタイム DDL ファイルの名前。 |
mongoDbVersions[n].Builds[k].winVRedistVersion | string | 任意 | MicrosoftVisualC++ MicrosoftC++ランタイム DDL の最小 |
オートメーション
AgentVersionは MongoDB Agent のバージョンを指定します。
注意
この構成プロパティを使用して MongoDB Agent のバージョンを更新できますが、エージェントのバージョン更新エンドポイントを使用して、バージョンが最新であることを確認する必要があります。
"agentVersion" : { "name" : "<string>", "directoryUrl" : "<string>" }
名前 | タイプ | 必要性 | 説明 |
|---|---|---|---|
agentVersion | オブジェクト | 任意 | 実行する MongoDB Agent のバージョン。 実行中のバージョンがこの設定と一致しない場合、MongoDB Agent は指定されたバージョンをダウンロードし、自分自身をシャットダウンして、新しいバージョンを起動します。 |
AgentVersion.name | string | 任意 | MongoDB Agent の希望バージョン。 |
AgentVersion.directoryUrl | string | 任意 | MongoDB Agent をダウンロードするURL 。 |
MongoDB プロセス
プロセス配列によって、MongoDB インスタンスの構成が決まります。 この配列を使用すると、次のことができます。
インスタンスを復元します。
1 つ以上の MongoDB インスタンスで最初の同期プロセスを開始します。
1 "processes": [{ 2 "<args>": {}, 3 "alias": "<string>", 4 "authSchemaVersion": "<integer>", 5 "backupRestoreUrl": "<string>", 6 "cluster": "<string>", 7 "defaultRWConcern": { 8 "defaultReadConcern": { 9 "level": "<string>" 10 }, 11 "defaultWriteConcern": { 12 "j": "<boolean>", 13 "w": "<string>", 14 "wtimeout": "<integer>" 15 } 16 } 17 "disabled": "<Boolean>", 18 "featureCompatibilityVersion": "<string>", 19 "hostname": "<string>", 20 "lastCompact" : "<dateInIso8601Format>", 21 "lastRestart" : "<dateInIso8601Format>", 22 "lastResync" : "<dateInIso8601Format>", 23 "lastKmipMasterKeyRotation" : "<dateInIso8601Format>", 24 "logRotate": { 25 "sizeThresholdMB": "<number>", 26 "timeThresholdHrs": "<integer>", 27 "numUncompressed": "<integer>", 28 "percentOfDiskspace": "<number>", 29 "numTotal": "<integer>" 30 }, 31 "manualMode": "<Boolean>", 32 "name": "<string>", 33 "numCores": "<integer>", 34 "processType": "<string>", 35 "version": "<string>" 36 }]
名前 | タイプ | 必要性 | 説明 |
|---|---|---|---|
プロセス | 配列 | 必須 | |
process[n].args2_6 | オブジェクト | 必須 | MongoDB バージョン 2.6 以降の MongoDB 構成オブジェクト 。
|
operations[n]. CLI は、 | string | 任意 | プロセスが実行されるホストのホスト名エイリアス(多くの場合はDNS CNAME)。 エイリアスが指定されている場合、MongoDB Agent はホストに接続するときに、process.hostname で指定されたホスト名よりもこのエイリアスを優先します。 このエイリアスはreplicaSets.hostおよびsharding.configServerで指定することもできます。 |
process[n].authSchemaVersion | integer | 必須 | MongoDB データベースユーザーのユーザー認証情報のスキーマ バージョン。 これは、同じクラスターに属するプロセス配列の他のすべての要素と一致する必要があります。
|
process[n].backupRestoreUrl | string | 任意 | Delivery URL for the restore. Cloud Manager sets this when creating a restore. To cancel an in-progress restore operation, set this option to |
operations[n].cluster | string | 条件付き | |
defaultRWConcern.defaultReadConcern.level | string | 任意 | レプリカセットおよびレプリカセット シャードから読み取られたデータの整合性と分離プロパティ。 MongoDB Atlas は、次の値を受け入れます。
|
デフォルト RWConcern.defaultWriteConcern.j | ブール値 | 任意 | 書込み (write) 確認応答をディスク上のジャーナルに書込む 必要があるかどうかを示すフラグ。 |
デフォルト RWConcern.defaultWriteConcern.w | string | 任意 | レプリカセットおよびレプリカセット シャードで書込み (write) 操作を確認する必要がある mongod インスタンスの希望数。 MongoDB Atlas は、次の値を受け入れます。
|
デフォルト RWConcern.defaultWriteConcern.wtimeout | 数値 | 任意 | 書込み保証 (write concern)に希望する時間制限(ミリ秒単位)。デフォルト RWConcern.defaultWriteConcern.w を1 より大きい値に設定する場合に、この値を設定します。 |
operations[n].disabled | ブール値 | 任意 | このプロセスをシャットダウンするかどうかを示すフラグ。 プロセスをシャットダウンするにはtrueに設定します。 |
process[n].featureCompatibilityVersion | string | 必須 | このプロセスが機能と互換性がある MongoDB のバージョン。 この値を変更すると、選択したfeatureCompatibilityVersionよりも前のバージョンまたはそれ以降の MongoDB バージョンと互換性のないデータを保持する特定の機能を有効または無効にできます。
To learn more, see |
process[n].hostname | string | 必須 | このプロセスを提供するホストの名前。 デフォルトはlocalhostです。 |
process[n].lastCompact | string | 任意 | Timestamp in ISO 8601 date and time format in UTC when Cloud Manager last reclaimed free space on a cluster's disks. During certain operations, MongoDB might move or delete data but it doesn't free the currently unused space. Cloud Manager reclaims the disk space in a rolling fashion across members of the replica set or shards. このスペースを再利用するには、次の手順に従います。
クラスターのディスクの領域を再利用するときに などのあいまいさを排除するには、ISO8601 タイムスタンプを持つタイムゾーンを指定します。例、process.lastCompact 282021243を::52 PM(米国中央標準時間)に 1 月 に設定するには、 を使用します |
process[n].lastRestart | string | 任意 | Cloud Manager がこのプロセスを最後に再起動したときの ISO 8601の日付と時刻形式(UTC)のタイムスタンプ。このパラメータを現在のタイムスタンプに設定すると、この設定をアップロードした後にCloud Manager はこのプロセスを強制的に再起動します。このパラメーターを同じクラスター内の複数の プロセスに設定すると、 Cloud Manager はレプリカセットまたはシャードのノード全体で選択したプロセスを順次再起動します。 |
process[n].lastResync | string | 任意 | Cloud Manager がノードで実行した最後の最初の同期プロセスの ISO 8601 の日付と時刻形式(UTC)のタイムスタンプ。 ノードで最初の同期プロセスをすぐにトリガーするには、この値を ISO8601 タイムスタンプとして現在の時刻に設定します。 WARNING: Use this parameter with caution. During initial sync, Automation removes the entire contents of the node's このパラメーターを設定すると、次の効果が生じます。
「最初の同期」を参照してください。 |
process[n].lastKmip MasterKeyRotation | string | 任意 | Timestamp in ISO 8601 date and time format in UTC when Cloud Manager last rotated the master KMIP key. If you set this parameter to the current timestamp, Cloud Manager rotate the key after you upload this configuration. |
process[n].logRotate | オブジェクト | 任意 | プロセスの MongoDB ログをローテーションするための MongoDB 構成オブジェクト 。 |
process[n].logRotate num Total | integer | 任意 | Cloud Manager が保持するログファイルの合計数。 この値を設定しない場合、ログファイルの合計数はデフォルトで0になります。 Cloud Manager は、他のprocess.logRotate設定に基づくローテーションに基づいます。 |
process[n].logRotate numUncompressed | integer | 任意 | 現在のログファイルを含む、非圧縮のままにするログファイルの最大数。 デフォルトは5です。 |
process[n].logRotate percentOfDiskspace | 数値 | 任意 | Cloud Manager がログファイルを保存するために使用できる合計ディスク領域の最大パーセンテージ(小数で表示)。 この制限を超えた場合、Cloud Manager はこの制限を満たすまで圧縮されたログファイルを削除します。 Cloud Manager は最も古いログファイルを最初に削除します。 デフォルトは0.02です。 |
process[n].logRotate sizeThresholdMB | 数値 | 必須 | Cloud Manager がログファイルをローテーションする前の個々のログファイルの最大サイズ(MB 単位)。 Cloud Manager は、このsizeThresholdMBまたはprocess.logRotate.timeThresholdHrs のいずれかに指定された値を満たす場合、ログファイルをすぐにローテーションします。 制限があります。 |
process[n].logRotate timeThresholdHrs | integer | 必須 | 次のローテーションまでの個々のログファイルの最大期間(時間単位)。 は最後のローテーション以降の時間です。 Cloud Manager は、ファイルがこのtimeThresholdHrsまたはprocesss.logRotate.sizeThresholdMBのいずれかを満たすと、ログファイルをローテーションします。 制限があります。 |
process[n].manualMode | ブール値 | 任意 | MongoDB Agent がこのプロセスを自動化するかどうかを示すフラグ。
|
operations[n].name | string | 必須 | インスタンスを識別するための一意の名前。 |
process[n].numCores | integer | 任意 | Cloud Manager がこのプロセスにバインドするコアの数。 MongoDB Agent は、プロセスを可能な限り均等に分散します。 |
operations[n].processType | string | 必須 | |
process[n].version | string | 必須 | このインスタンスで使用されるmongoDbVersions仕様の名前。 |
クラスター全体
clusterWithConfigurationsでは、ローリング再起動を必要とせずにレプリカセットまたはシャーディングされたクラスター全体に設定するパラメーターを指定します。
1 "clusterWideConfigurations" : { 2 "<replicaSetID/clusterName>": { 3 "changeStreamOptions": { 4 "preAndPostImages": { 5 "expireAfterSeconds": <integer> 6 } 7 } 8 } 9 }
名前 | タイプ | 必要性 | 説明 |
|---|---|---|---|
replicaSetID/clusterName | オブジェクト | 任意 | レプリカセットまたはシャーディングされたクラスターに適用する 変更ストリーム オプション 。 MongoDB Agent は、この構成が有効なJSON形式であるかどうかのみをチェックしますが、値が正確かどうかはチェックしません。 |
changeStreamOptions.preAndPostImages.expirationAfterSeconds | 数値 | 必須 | 変更ストリームの事前イメージと事後イメージの保持ポリシー(秒単位)。 値を省略すると、クラスターは対応する変更ストリーム イベントを oplog から削除するまで、変更前と変更後のイメージを保持します。 この値を削除すると、MongoDB Agent はこのパラメーターをオートメーション構成からのみ削除しますが、サーバーからは削除しません。 To learn more, see |
レプリカセット
レプリカセット 配列は、各レプリカセットの構成を定義します。 このフィールドは、レプリカセットを使用した配置に必須です。
1 "replicaSets": 2 [ 3 { 4 "_id": "<string>", 5 "protocolVersion": "<string>", 6 "members": 7 [ 8 { 9 "_id": "<integer>", 10 "host": "<string>", 11 "arbiterOnly": "<boolean>", 12 "buildIndexes": "<boolean>", 13 "hidden": "<boolean>", 14 "priority": "<number>", 15 "tags": "<object>", 16 "secondaryDelaySecs": "<integer>", 17 "votes": "<number>" 18 },{ 19 "_id": "<integer>", 20 "host": "<string>", 21 "arbiterOnly": "<boolean>", 22 "buildIndexes": "<boolean>", 23 "hidden": "<boolean>", 24 "priority": "<number>", 25 "tags": "<object>", 26 "secondaryDelaySecs": "<integer>", 27 "votes": "<number>" 28 },{ 29 "_id": "<integer>", 30 "host": "<string>", 31 "arbiterOnly": "<boolean>", 32 "buildIndexes": "<boolean>", 33 "hidden": "<boolean>", 34 "priority": "<number>", 35 "tags": "<object>", 36 "secondaryDelaySecs": "<integer>", 37 "votes": "<number>" 38 } 39 ], 40 "force": 41 { 42 "currentVersion": "<integer>" 43 } 44 } 45 ]
名前 | タイプ | 必要性 | 説明 |
|---|---|---|---|
レプリカセット | 配列 | 任意 | 各レプリカセットの構成。 MongoDB Agent はこの配列の値を使用して、有効なレプリカセット構成ドキュメントを作成します。 エージェントは、レプリカセットが正しく構成されていることを定期的にチェックします。 問題が発生した場合、エージェントは 構成ドキュメント に従ってレプリカセットを再構成します。 配列には、レプリカセット構成ドキュメントの次の最上位フィールドを含めることができます。 _id 、バージョン。およびメンバー。 To learn more, see |
レプリカセット[n]._id | string | 必須 | レプリカセットの名前です。 |
replicaSets[n].protocolVersion | string | 任意 | レプリカセットのプロトコル バージョン。 |
レプリカセット[n].members | 配列 | 任意 | レプリカセットの各ノードを定義するオブジェクト。 groups.hostフィールドにはホストが指定されている必要があります。 To learn more, see |
レプリカセット[n].members[m]._id | integer | 必須 | レプリカセットのノードを示す任意の正の整数。 |
replicaSets[n].members[m].host | string | 任意 | このレプリカセット ノードを提供するホスト名とポート番号(該当する場合)。 |
replicaSets[n].members[m].arbiterOnly | ブール値 | 任意 | このレプリカセットがアービタとして機能するかどうかを示すフラグ。 |
レプリカセット[n].members[m].BuildIndexes | ブール値 | 任意 |
|
replicaSets[n].members[m].trigger | ブール値 | 任意 | レプリカセットがこのノードに読み取り操作を受け入れることを許可しているかどうかを示すフラグ。 |
replicaSets[n].members[m].priority | 数値 | 任意 | Cloud Manager がこのレプリカセット ノードをプライマリとして選択する相対的な資格。 数値が大きいほど、資格が増加します。 この値は、データを保持するノードの場合、0 から 1000 までの範囲で指定できます。 アービタの値は 0 または 1 です。 |
レプリカセット[n].members[m]. tags | オブジェクト | 任意 | このレプリカセットに適用されるユーザー定義のラベルとその値のリスト。 |
replicaSets[n].members[m].secondaryDelaySecs | integer | 任意 | このレプリカセットがプライマリより遅れる時間(秒単位)。 |
レプリカセット[n].members[m]. Atlas | 数値 | 任意 | このレプリカセット ノードがレプリカセット選挙のために投じる投票の量。 データを保持するすべてのノードは 0 または 1 の投票を含むことができます。 アービタの投票権は常に 1 票です。 |
レプリカセット[n]. force | オブジェクト | 任意 | |
レプリカセット[n]. force.currentVersion | integer | 任意 | MongoDB Agent がレプリカセットに使用を強制する 構成バージョン 。レプリカセットに新しい構成を強制的に受け入れさせるには、 -1 に設定します。 警告:レプリカセットの再構成を強制すると、コミットされた過半数の書込み (write) がロールバックされる可能性があります。 慎重に進む必要があります。 この操作の潜在的な影響について質問がある場合は、 MongoDB サポートにお問い合わせください。 |
シャーディングされたクラスター
シャーディング配列は、各シャーディングされたクラスターの構成を定義します。 このパラメーターは、シャーディングされたクラスターを使用した配置に必要です。
1 "sharding" : [ 2 { 3 "managedSharding" : <boolean>, 4 "name" : "<string>", 5 "configServerReplica" : "<string>", 6 "collections" : [ 7 { 8 "_id" : "<string>", 9 "key" : [ 10 [ "shard key" ], 11 [ "shard key" ], 12 ... 13 ], 14 "unique" : <boolean> 15 }, 16 ... 17 ], 18 "shards" : [ 19 { 20 "_id" : "<string>", 21 "rs" : "<string>", 22 "tags" : [ "<string>", ... ] 23 }, 24 ... 25 ], 26 "tags" : [ 27 { 28 "ns" : "<string>", 29 "min" : [ 30 { 31 "parameter" : "<string>", 32 "parameterType" : "<string>", 33 "value" : "<string>" 34 } 35 ], 36 "max" : [ 37 { 38 "parameter" : "<string>", 39 "parameterType" : "<string>", 40 "value" : "<string>" 41 } 42 ], 43 "tag" : "<string>" 44 }, 45 ... 46 ] 47 }, 48 ... 49 ]
名前 | タイプ | 必要性 | 説明 | |||||
|---|---|---|---|---|---|---|---|---|
シャーディング | オブジェクトの配列 | 任意 | 各シャーディングされたクラスターの構成を定義するオブジェクト。 配列内の各オブジェクトには、1 つのクラスターの仕様が含まれています。 MongoDB Agent は、各クラスターの状態を 仕様に対して定期的にチェックします。 仕様とクラスターが一致しない場合、エージェントはクラスターの構成を変更し、バランサーがチャンクを移行する可能性があります。 | |||||
sharding.managedSharding | ブール値 | 条件付き | Cloud Manager Automation が配置内のすべてのシャーディングされたコレクションとタグを管理するかどうかを示すフラグ | |||||
sharding.name | string | 条件付き | クラスターの名前。これは、 のprocess.cluster | |||||
sharding.configServerReplica | string | 条件付き | Name of the config server replica set. コンフィギュレーションサーバーがレプリカセットとして実行される場合は、この配列パラメーターを追加できます。 レプリカセットとして実行されない、ミラー化されたレガシー コンフィギュレーションサーバー を実行する場合は、 sharding.configServerを使用します。 | |||||
sharding.configServer | 文字列の配列 | 条件付き | コンフィギュレーションサーバー ホストの名前。 ホスト名は、各ホストのprocess.nameパラメータで使用される名前と一致します。 重要: MongoDB 3.4では、ミラーリングされたコンフィギュレーションサーバーのサポートが排除されます。 シャーディングされたシャーディングされたクラスターでMongoDB 3.4以降が実行されている場合は、シャーディング.configServerReplicaを使用します。 | |||||
sharding.collections | オブジェクトの配列 | 条件付き | シャーディングされたコレクションとそのシャードキーを定義するオブジェクト。 | |||||
sharding.collections._id | string | 条件付き | シャーディングされたコレクションの名前空間。 名前空間は、データベース名とコレクションの名前の組み合わせです。 例えば、 Testdb . Testcoll など。 | |||||
sharding.collections.key | 配列の配列 | 条件付き | コレクションのシャードキー。 これには以下が含まれます。
| |||||
sharding.collections. 一意 | ブール値 | 条件付き | ||||||
sharding.shards | オブジェクトの配列 | 条件付き | クラスターのシャード。 | |||||
sharding.shards._id | string | 条件付き | シャードの名前。 | |||||
sharding.shards.rs | string | 条件付き | シャードのレプリカセットの名前。 これはreplicaSets._idで指定されます 許可されます。 | |||||
sharding.shards. tags | 文字列の配列 | 条件付き | このシャードに割り当てられたゾーン。 ゾーンシャーディングを使用する場合は、この配列パラメーターを追加できます。 | |||||
sharding. tags | オブジェクトの配列 | 条件付き | ゾーン シャーディングの ゾーン の定義。 この配列内の各オブジェクトはゾーンを定義し、そのゾーンのシャードキー範囲を構成します。 | |||||
sharding. tags.ns | string | 条件付き | ゾーン シャーディング を使用するコレクションの名前空間。 名前空間は、データベース名とコレクションの名前を組み合わせたものです。 たとえば | |||||
sharding. tags.min | 配列 | 条件付き | シャードキー範囲の最小値。 次の形式のドキュメントに、フィールド名、フィールドタイプ、および値を指定します。
複合 シャードキーを使用するには、この表の後の例に示すように、個別のドキュメントで各フィールドを指定します。 シャードキーの詳細については、MongoDB マニュアルの「シャードキー 」を参照してください。 | |||||
sharding. tags.max | 配列 | 条件付き | シャードキー範囲の最大値。 次の形式のドキュメントに、フィールド名、フィールドタイプ、および値を指定します。
複合 シャードキーを使用するには、この表の後の例に示すように、個別のドキュメントで各フィールドを指定します。 シャードキーの詳細については、MongoDB マニュアルの「シャードキー 」を参照してください。 | |||||
sharding. tags. tags | string | 条件付き | Name of the zone associated with the shard key range specified by sharding.tags.min and sharding.tags.max. |
例
複合シャードキーを持つ sharding. tags
次の例では、最小値が{ a : 1, b : ab }で、最大値が{ a : 100, b : fg }である複合シャードキー範囲を定義しています。 この例ではTestdb . Test1 コレクションの 範囲を定義し、それをzone1に割り当てています。
1 "tags" : [ 2 { 3 "ns" : "testdb.test1", 4 "min" : [ 5 { 6 "parameter" : "a", 7 "parameterType" : "integer", 8 "value" : "1" 9 }, 10 { 11 "parameter" : "b", 12 "parameterType" : "string", 13 "value" : "ab" 14 } 15 ], 16 "max" : [ 17 { 18 "parameter" : "a", 19 "parameterType" : "integer", 20 "value" : "100" 21 }, 22 { 23 "parameter" : "b", 24 "parameterType" : "string", 25 "value" : "fg" 26 } 27 ], 28 "tag" : "zone1" 29 } 30 ]
クラスター バランサー
バランサーオブジェクトは任意であり、各クラスターのバランサー設定を定義します。
1 "balancer": { 2 "<clusterName1>": {}, 3 "<clusterName2>": {}, 4 ... 5 }
名前 | タイプ | 必要性 | 説明 |
|---|---|---|---|
バランサー | オブジェクト | 任意 | Parameters named according to clusters, each parameter containing an object with the desired balancer settings for the cluster. The object uses the stopped and activeWindow parameters, as described in the procedure to schedule the balancing window in this tutorial in the MongoDB manual. |
認証
Cloud Manager にはauthオブジェクトは必要ありません。 このオブジェクトは、認証関連の設定を定義します。
1 { 2 "auth": { 3 "authoritativeSet": "<boolean>", 4 "autoUser": "<string>", 5 "autoPwd": "<string>", 6 "disabled": "<boolean>", 7 "deploymentAuthMechanisms": ["<string>", "<string>"], 8 "autoAuthMechanisms": ["<string>"], 9 "key": "<string>", 10 "keyfile": "<string>", 11 "newAutoPwd": "<string>", 12 "newKey": "<string>", 13 "usersDeleted": [{ 14 "user": "<string>", 15 "dbs": ["<string>", "<string>"] 16 }], 17 "usersWanted": [{ 18 "authenticationRestrictions": [{ 19 "clientSource": ["(IP | CIDR range)", "(IP | CIDR range)"], 20 "serverAddress": ["(IP | CIDR range)", "(IP | CIDR range)"] 21 }], 22 "db": "<string>", 23 "initPwd": "<string>", 24 "otherDBRoles": { 25 "<string>": ["<string>", "<string>"] 26 }, 27 "roles": [{ 28 "db": "<string>", 29 "role": "<string>" 30 }], 31 "pwd": "<string>", 32 "user": "<string>" 33 }] 34 } 35 }
名前 | タイプ | 必要性 | 説明 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
認証 | オブジェクト | 任意 | 認証関連の設定を定義します。 このパラメーターを省略すると、このセクションの残りの部分がスキップされます。 | ||||||||||||
auth. authoritativeSet | ブール値 | 条件付き | Cloud Manager がプロジェクト内のすべての管理対象配置で、管理対象の MongoDB ユーザーとロールの一貫したセットを強制するかどうかを設定します。
auth . authoritativeSet のデフォルトはfalseです。 "auth" : true の場合は必須です。 | ||||||||||||
auth.autoUser | string | 条件付き | オートメーションが インスタンスに接続するときに使用するユーザー名。 "auth" : true の場合は必須です。 | ||||||||||||
auth.autoPwd | string | 条件付き | オートメーションが インスタンスに接続するときに使用するパスワード。 "auth" : true の場合は必須です。 | ||||||||||||
auth.disabled | ブール値 | 任意 | 認証が無効になっているかどうかを示すフラグ。 指定されていない場合、無効化された はデフォルトでfalseになります。 | ||||||||||||
auth.deploymentAuthMechanisms | 文字列の配列 | 条件付き | 配置内のプロセスに対してサポートされている認証メカニズムを一覧表示します。 "auth" : true の場合は必須です。 次の値を指定します。
| ||||||||||||
auth.autoAuthMechanisms | 文字列の配列 | 条件付き | オートメーションで使用される認証メカニズムを設定します。 指定されていない場合、無効化された はデフォルトでfalseになります。 "auth" : true の場合は必須です。 このパラメーターに複数の要素が含まれるのは、SCRAM-SHA-1 と SCRAM-SHA-256 の両方に構成されている場合のみです。 次の値を指定します。
| ||||||||||||
auth.key | string | 条件付き | Cloud Manager が MongoDB プロセスへの認証に使用するキー ファイルの内容。 "auth" : trueおよび"auth.disabled" : falseの場合は必須です。 auth.key の値を変更する場合は、 auth.keyfileの値を変更する必要があります。 | ||||||||||||
auth.keyfile | string | 条件付き | Cloud Manager が MongoDB プロセスへの認証に使用するキー ファイルのパスと名前。 "auth" : trueおよび"auth.disabled" : falseの場合は必須です。 auth.keyfile値を変更する場合は、 auth.keyの値も変更する必要があります。 | ||||||||||||
auth | string | 任意 | オートメーションが インスタンスに接続するときに使用する新しいパスワード。 接続を失うことなくパスワードをローテーションするには、次の手順に従います。
このオプションは、 auth.autoAuthMechanismsのオートメーションの認証メカニズムの 1 つとして SCRAM-SHA-1 または SCRAM-SHA-256 を含めている場合にのみ設定できます。 | ||||||||||||
auth.newKey | string | 任意 | Cloud Manager が MongoDB プロセスへの認証に使用する新しいキー ファイルの内容。 このオプションを設定すると、Cloud Manager は、アプリケーションが配置内の MongoDB プロセスへの認証に使用するキーをローテーションします。 すべての MongoDB エージェントが新しいキーを使用すると、Cloud Manager は auth.key の値をauth.newKeyで指定した新しいキーに置き換え、オートメーション構成からauth.newKeyを削除します。 | ||||||||||||
auth.usersDeleted | オブジェクトの配列 | 任意 | 指定されたデータベースまたはすべてのデータベースから削除する認証済みユーザーを定義するオブジェクト。 この配列にはauth.usersDeleted.userとauth.usersDeleted.dbsが含まれている必要があります。 | ||||||||||||
auth.usersDeleted[n].user | string | 任意 | Cloud Manager が削除するユーザーのユーザー名。 | ||||||||||||
auth.usersDeleted[n].dbs | 文字列の配列 | 任意 | Cloud Manager が認証されたユーザーを削除するデータベースの名前を一覧表示します。 | ||||||||||||
auth.usersWanted | オブジェクトの配列 | 任意 | 指定されたデータベースに追加する認証済みユーザーを定義するオブジェクトが含まれます。 各オブジェクトにはauth.usersWanted[n].dbが必要です。 auth.usersWanted[n].user, およびauth.usersWanted[n].roles パラメーター、 auth.usersWanted[n].initPwd 、 またはauth.usersWanted[n].userSource | ||||||||||||
auth.usersWanted[n].db | string | 条件付き | ユーザーを追加するデータベース。 | ||||||||||||
auth.usersWanted[n].user | string | 条件付き | Cloud Manager が追加するユーザーの名前。 | ||||||||||||
auth.usersWanted[n].roles | 配列 | 条件付き | ユーザーの データベースからユーザーに割り当てられるロールのリスト。このロールはauth.usersWalted[n].dbで指定されます。 | ||||||||||||
auth.usersWanted[n].pwd | string | 条件付き | 現在ユーザーに割り当てられているパスワードの 32 文字の 16 進数SCRAM-SHA-1ハッシュ。 Cloud Manager は、パスワードを設定または変更するためにこのパラメーターを使用することはありません。 次の場合に必須:
| ||||||||||||
auth.usersWanted[n].initPwd | string | 条件付き | ユーザーに割り当てるクリアテキストのパスワード。 次の場合に必須:
| ||||||||||||
auth.usersWanted[n].userSource | string | 非推奨 | サポートされなくなりました。 | ||||||||||||
auth.usersWanted[n].OTHERDBRoles | オブジェクト | 任意 | ユーザーのデータベース"auth.usersWanted[n].db" : "admin"を割り当てると、このオブジェクトを使用して他のデータベースのユーザー ロールも割り当てることができます。 オブジェクトには、キーと値のペアが含まれています。キーはデータベースの名前で、値はそのデータベースから割り当てられるロールをリストするstring値の配列です。 | ||||||||||||
auth.usersWanted[n].authenticationRestrictions | ドキュメントの配列 | 任意 | ホストがユーザーに強制する認証制限。 警告:ユーザーが互換性のない認証制限を持つ複数のロールを継承すると、そのユーザーは使用できなくなります。 たとえば、ユーザーが、 | ||||||||||||
auth.usersWanted[n].authenticationRestrictions[k].clientSource | 文字列の配列 | 条件付き | ユーザーの認証時に存在する場合、ホストは指定されたリストにクライアントの IP アドレスCIDR範囲が含まれていることを確認します。 クライアントの IP アドレスが存在しない場合、ホストはユーザーを認証しません。 | ||||||||||||
auth.usersWanted[n].authenticationRestrictions[k].serverAddress | 文字列の配列 | 条件付き | クライアントが接続できる IP アドレスのカンマ区切り配列。 存在する場合、ホストは Cloud Manager が指定された配列内の IP アドレスからのクライアントの接続を受け入れたことを確認します。 認識されない IP アドレスから接続が受け入れられた場合、ホストはユーザーを認証しません。 |
LDAP
ldap オブジェクトにより、LDAP 認証が有効になります。このオブジェクトは任意です。詳細については、「LDAP 認証を有効にする」を参照してください。
"ldap": { "servers": "<host>:<port>, <host>:<port>", "timeoutMS": "<time>", "bindMethod": "<sasl/simple>", "bindSaslMechanisms": "<sasl-mechanism>, <sasl-mechanism>", "bindQueryUser": <ldap-dn>", "bindQueryPassword": "<password>", "userCacheInvalidationPeriod": "<interval>", "authzQueryTemplate": "<rfc-4516-url>", "userToDNMapping": [ { "match": "<ECMAScript-regex>", "<substition/ldapQuery>": "<DN-string/RFC4516-encoded-LDAP-query>" } ] }
名前 | タイプ | 必要性 | 説明 |
|---|---|---|---|
ldap | オブジェクト | 任意 | LDAP 認証を有効にして構成するための設定を含むオブジェクト。 |
ldap.servers | string | 条件付き | Comma-separated string that contains one or more LDAP servers in |
ldap.timeoutMS | long | 任意 | Amount of time in milliseconds that MongoDB waits for an LDAP server to respond to a request before timing out. You can use |
ldap.bindメソッド | string | 任意 | Human-readable string that indicates whether to use simple authentication or an SASL protocol to authenticate itself. You can specify |
ldap.bindSaslMechanisms | string | 任意 | String that contains a comma-separated list of SASL mechanisms for MongoDB to attempt authentication against the LDAP server while binding. By default, MongoDB uses |
ldap.bindQueryUser | string | 条件付き | LDAP entity domain name that MongoDB binds as when it connects to an LDAP server. You can use |
ldap.bindQueryPassword | string | 条件付き | Password that MongoDB binds with when it connects to an LDAP server. You can use |
ldap.userCacheInvalidationPerid | integer | 任意 | MongoDB がユーザーキャッシュのフラッシュ間で待機する間隔。外部ユーザーキャッシュがフラッシュされると、LDAP 認可ユーザーが実行する次の操作には ロールが必要です。値を大きくすると、LDAP サーバーの負荷が軽減され、 MongoDBロールと LDAP グループ メンバーシップの同期に必要な時間が長くなる可能性があります。デフォルトでは 、 MongoDB はキャッシュのフラッシュ間で 30 秒待機します。 |
ldap.authzQueryTemplate | string | 条件付き | RFC 4516 formatted URL of the LDAP query to execute to obtain LDAP groups relative to the |
ldap.userToDNMapping | 配列 | 任意 | JSON-formatted array that contains the ordered transformations that MongoDB applies to authenticate MongoDB user names to match their domain names. You can specify this setting if you use an alternate authentication method, or if the user name passed to MongoDB for authentication doesn't match the LDAP domain name. You can use |
TLS
tlsオブジェクトは接続を暗号化するためのTLSを有効にします。 このオブジェクトは任意です。
"tls" : { "CAFilePath" : "<string>" }
名前 | タイプ | 必要性 | 説明 |
|---|---|---|---|
tls | オブジェクト | 任意 | 接続を暗号化するためにTLSを有効にします。 TLSを使用するには、 TLSをサポートするパッケージを選択してください。 MongoDB Enterpriseをサポートするすべてのプラットフォームは、 TLSもサポートしています。 |
tls.CAFilePath | string | 条件付き | TLSによる認証に使用される証明書への絶対ファイル パス。 tls.clientCertificateModeを設定する場合は必須です。 |
tls.clientCertificateMode | string | 条件付き | Cloud Manager への接続にTLS証明書が必要かどうかの宣言。 Cloud Manager は任意と必須を受け入れます。 tls.CAFilePathを設定する場合は必須です。 |
MongoDB のロール
roles配列は任意であり、ユーザー定義のロールを記述します。
1 "roles" : [ 2 { 3 "role" : "<string>", 4 "db" : "<string>", 5 "privileges" : [ 6 { 7 "resource" : { ... }, 8 "actions" : [ "<string>", ... ] 9 }, 10 ... 11 ], 12 "roles" : [ 13 { 14 "role" : "<string>", 15 "db" : "<string>" 16 } 17 ] 18 "authenticationRestrictions" : [ 19 { 20 "clientSource": [("<IP>" | "<CIDR range>"), ...], 21 "serverAddress": [("<IP>" | "<CIDR range>"), ...] 22 }, ... 23 ] 24 }, 25 ... 26 ]
名前 | タイプ | 必要性 | 説明 |
|---|---|---|---|
役割 | オブジェクトの配列 | 任意 | Roles and privileges that MongoDB has assigned to a cluster's user-defined roles. Each object describes a different user-defined role. Objects in this array contain the same fields as documents in the system roles collection, except for the _id field. |
role[n].role | string | 条件付き | ユーザー定義ロールの名前。 |
role[n].db | string | 条件付き | ユーザー定義ロールが属するデータベース。 |
role[n].rivileges | ドキュメントの配列 | 条件付き | このロールが実行できる特権。 |
role[n].services[k].resource | string | 条件付き | 特権アクションが適用されるリソースを指定します。 |
role[n].rivileges[k].actions | string | 条件付き | リソースに対して許可されるアクション。 詳しくは、特権アクションを参照してください。 |
roles[n].roles | ドキュメントの配列 | 条件付き | このロールが特権を継承するロール。 |
role[n].authenticationRestrictions | ドキュメントの配列 | 任意 | MongoDB サーバーがこのロールに強制する認証制限。 警告:ユーザーが互換性のない認証制限を持つ複数のロールを継承すると、そのユーザーは使用できなくなります。 たとえば、ユーザーが、 |
role[n].authenticationRestrictions[k].clientSource | 文字列の配列 | 条件付き | 存在する場合、MongoDB サーバーはユーザーを認証する際に、クライアントの IP アドレスが指定されたリストにあること、 または リスト内のCIDR範囲に属していることを確認します。 クライアントの IP アドレスが存在しない場合、MongoDB サーバーはユーザーを認証しません。 |
role[n].authenticationRestrictions[k].serverAddress | 文字列の配列 | 条件付き | クライアントが接続できる IP アドレスのカンマ区切り配列。 存在する場合、MongoDB サーバーは、指定された配列内の IP アドレスからのクライアントの接続を受け入れたことを確認します。 MongoDB サーバーが認識されていない IP アドレスからの接続を受け入れた場合、MongoDB サーバーはユーザーを認証しません。 |
Kerberos
Kerberosオブジェクトは任意であり、認証に使用されるKerberosサービス名を定義します。
"kerberos": { "serviceName": "<string>" }
名前 | タイプ | 必要性 | 説明 |
|---|---|---|---|
kerberos | オブジェクト | 任意 | エージェントが Kerberos 経由で認証するために使用する Kerberos サービス名を定義するキーと値のペア。 |
kerberos.serviceName | string | 必須 | 次の要素を設定するラベル。
|
Indexes
indexConfigs配列は任意であり、特定のレプリカセットに対して構築するインデックスを定義します。
1 "indexConfigs": [{ 2 "key": [ 3 ["<string>", "<value>"] 4 ], 5 "rsName": "<string>", 6 "dbName": "<string>", 7 "collectionName": "<string>", 8 "collation": { 9 "locale": "<string>", 10 "caseLevel": <boolean>, 11 "caseFirst": "<string>", 12 "strength": <number>, 13 "numericOrdering": <boolean>, 14 "alternate": "<string>", 15 "maxVariable": "<string>", 16 "normalization": <boolean>, 17 "backwards": <boolean> 18 }, 19 "options": { 20 "<key>": "<value>" 21 } 22 }]
名前 | タイプ | 必要性 | 説明 | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
indexConfigs | オブジェクトの配列 | 任意 | 特定のレプリカセットに対して構築される特定のインデックス。 | |||||||||
indexConfigs.key | 配列の配列 | 必須 | インデックス内のキー。 この "配列の配列" には、インデックスのキーが 1 つのみという 条件を満たす場合 、単一の配列が含まれます。 | |||||||||
indexConfigs.rsName | string | 必須 | MongoDB がインデックスを構築するレプリカセット。 | |||||||||
indexConfigs.dbName | string | 必須 | MongoDB がインデックスを作成するデータベース。 | |||||||||
indexConfigs.collectionName | string | 必須 | MongoDB がインデックスするコレクション。 | |||||||||
indexConfigs.collation | オブジェクト | 任意 | インデックスが照合を使用する場合に、string をソートして一致させるときに使用する言語固有のルール。 indexConfigs.collationオブジェクトを含める場合は、 indexConfigs.collation.localeパラメータを含める必要があります。 その他のパラメーターはすべてオプションです。 indexConfigs.collationオブジェクトを含めない場合、インデックスには照合を含めることはできません。 | |||||||||
indexConfigs.collation.locale | string | 必須 | ICU が定義するロケール。 MongoDB Serverマニュアルでは、 照合ロケールとデフォルト パラメーター セクションにサポートされているロケールが一覧化されています。 単純なバイナリ比較を指定するには、この値をsimpleに設定します。 | |||||||||
indexConfigs.collation.caseLevel | ブール値 | 任意 | インデックスが大文字と小文字比較を使用する方法を示すフラグ。 このパラメーターをtrueに設定すると、インデックスは大文字と小文字の比較を使用します。 このパラメータは、 indexConfigs.collation.stringthを1または2に設定した場合にのみ適用されます。 「照合」を参照してください。 | |||||||||
indexConfigs.collation. caseFirst | string | 任意 | 三次レベルの比較中に、大文字と小文字の相違をソート順序で並べ替えます。 MongoDB Serverマニュアルでは、 照合 セクションに可能な値がリストされています。 | |||||||||
indexConfigs.collation.stringth | 数値 | 任意 | 実行する比較のレベル。 ICU の比較レベル に対応します。 MongoDB Serverマニュアルでは、 照合 セクションに可能な値がリストされています。 | |||||||||
indexConfigs.collation.numericOrdering | ブール値 | 任意 | 数字の string を比較する方法を示すフラグ。
デフォルトはfalseです。 「照合」を参照してください。 | |||||||||
indexConfigs.collation.alternate | string | 任意 | 照合で、空白と句読点を比較中の基本文字として空白と句読点の基本文字として考慮する方法を決定する設定。 MongoDB Serverマニュアルでは、 照合 セクションに可能な値がリストされています。 | |||||||||
indexConfigs.collation.maxVvariable | string | 任意 | インデックスが無視できる文字。 このパラメーターは、 indexConfigs.collation.alternateがシフト に設定されている場合にのみ適用されます。 MongoDB Serverマニュアルでは、 照合 セクションに可能な値がリストされています。 | |||||||||
indexConfigs.collation. Normalization | ブール値 | 任意 | ||||||||||
indexConfigs.collation.backwards | ブール値 | 任意 | インデックスが発音区別符号付き文字列を処理する方法を示すフラグ。 「照合」を参照してください。 | |||||||||
indexConfigs.options | ドキュメント | 必須 | MongoDB Go ドライバーがサポートするインデックス オプション。 |