オートメーション構成パラメーター
項目一覧
- Cloud Managerへのプログラムによるアクセスのための OAuth 2.0認証はプレビュー機能として利用できます。
- 機能および関連するドキュメントは、プレビュー期間中にいつでも変更される可能性があります。 OAuth2.0 認証を使用するには、 Cloud Manager Public APIへのリクエストで使用する サービス アカウント を作成します。
注意
グループとプロジェクトは同義語です。 あなたの {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 buildInfoコマンドは 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 データベースユーザーのユーザー認証情報のスキーマ バージョン。 これは、同じクラスターに属するプロセス配列の他のすべての要素と一致する必要があります。
詳細については、MongoDB 3.0リリースノートの 「 SCRAM-SHA- 1へのアップグレード」 を参照してください。 |
process[n].backupRestoreUrl | string | 任意 | 復元用の配信URL 。 Cloud Manager は復元を作成するときにこれを設定します。 進行中の復元操作をキャンセルするには、このオプションを |
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) に希望する時間制限(ミリ秒単位)。 defaultRWConcern.defaultWriteConcern.wを1より大きい値に設定する場合は、この値を設定します。 |
operations[n].disabled | ブール値 | 任意 | このプロセスをシャットダウンするかどうかを示すフラグ。 プロセスをシャットダウンするにはtrueに設定します。 |
process[n].featureCompatibilityVersion | string | 必須 | このプロセスが機能と互換性がある MongoDB のバージョン。 この値を変更すると、選択したfeatureCompatibilityVersionよりも前のバージョンまたはそれ以降の MongoDB バージョンと互換性のないデータを保持する特定の機能を有効または無効にできます。
|
process[n].hostname | string | 必須 | このプロセスを提供するホストの名前。 デフォルトはlocalhostです。 |
process[n].lastCompact | string | 任意 | ISO8601 のタイムスタンプ Cloud Manager がクラスターのディスクの空き領域を最後に再利用した UTC 形式の日付と時刻形式。特定の操作中に MongoDB によりデータが移動または削除される場合がありますが、現在未使用の領域は解放されません。 Cloud Manager は、レプリカセットまたはシャードのノード全体でディスク領域をローリング方式で再利用します。 このスペースを再利用するには、次の手順に従います。
クラスターのディスクの領域を再利用する際に などのあいまいさを排除するには、 ISO8601 でタイムゾーンを指定します 時間スタンプ。たとえば、process.lastCompact を2 : 43 : 52 PM(米国中央標準時間)に28 1 月2021に設定するには、 |
process[n].lastRestart | string | 任意 | ISO8601 のタイムスタンプ Cloud Manager がこのプロセスを最後に再起動したとき、 UTC の日付と時刻形式。このパラメータを現在のタイムスタンプに設定すると、この設定をアップロードした後に Cloud Manager はこのプロセスを強制的に再起動します。 このパラメーターを同じクラスター内の複数の プロセスに設定すると、Cloud Manager はレプリカセットまたはシャードのノード全体で選択したプロセスを順次再起動します。 |
process[n].lastResync | string | 任意 | ISO8601 のタイムスタンプ Cloud Manager がノード上で実行した最後の 最初の同期 プロセスの UTC 形式の日付と時刻形式。 triggerノードで最初の同期プロセスをすぐに するには、 ISO8601 としてこの値を現在の時刻に設定します 時間スタンプ。 警告:このパラメータの使用には注意が必要です。 最初の同期中に、オートメーションはノードの このパラメーターを設定すると、次の効果が生じます。
詳しくは、「最初の同期 」を参照してください。 |
process[n].lastKmip MasterKeyRotation | string | 任意 | ISO8601 のタイムスタンプ Cloud Manager がマスター KMIP キーを最後にローテーションした UTC の日付と時刻形式。このパラメータを現在のタイムスタンプに設定すると、この設定をアップロードした後に Cloud Manager はキーをローテーションします。 |
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 はこのパラメーターをオートメーション構成からのみ削除しますが、サーバーからは削除しません。 |
レプリカセット
レプリカセット 配列は、各レプリカセットの構成を定義します。 このフィールドは、レプリカセットを使用した配置に必須です。
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 、バージョン。およびメンバー。 詳しくは、「 replSetGetConfig 」を参照してください。 |
レプリカセット[n]._id | string | 必須 | レプリカセットの名前です。 |
replicaSets[n].protocolVersion | string | 任意 | レプリカセットのプロトコル バージョン。 |
レプリカセット[n].members | 配列 | 任意 | レプリカセットの各ノードを定義するオブジェクト。 groups.hostフィールドにはホストが指定されている必要があります。 |
レプリカセット[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 | オブジェクト | 任意 | レプリカセットが レプリカセット . force.currentVersion で指定された 構成バージョン を使用するように強制するよう、MongoDB Agentに指示します。 このオブジェクトを使用すると、MongoDB Agent はレプリカセットに新しい構成を強制的に受け入れて、ノードの少数が利用可能な状態から回復できます。 |
レプリカセット[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 | 条件付き | コンフィギュレーションサーバーがレプリカセットとして実行される場合は、この配列パラメーターを追加できます。 レプリカセットとして実行されない、ミラー化されたレガシー コンフィギュレーションサーバー を実行する場合は、 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 | 条件付き | sharding. tags.min と 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 }
名前 | タイプ | 必要性 | 説明 |
---|---|---|---|
バランサー | オブジェクト | 任意 | クラスターに応じて名前付けされたパラメーター。各パラメーターには、クラスターに必要なバランサー設定を持つオブジェクトが含まれています。 オブジェクトは、MongoDB マニュアルの このチュートリアル のバランシング ウィンドウをスケジュールする手順で説明されているように、 停止 したパラメーターと アクティブなウィンドウ パラメーターを使用します。 |
認証
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 .newAutoPwd | 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認可を有効にします。 このオブジェクトは任意です。 詳細については、「 Cloud Manager プロジェクトでの 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 | 条件付き | クエリを実行するためのstring 形式の 1LDAP つ以上の サーバーを含むカンマ区切りの |
ldap.timeoutMS | long | 任意 | MongoDB がタイムアウトする前にLDAPサーバーがリクエストを応答するまで待機する時間(ミリ秒単位)。 この設定は実行中のシステムで構成するには、 |
ldap.bindメソッド | string | 任意 | string自身の認証に単純認証を使用するか、 SASL プロトコルを使用するかを示す、人間が判読可能な 。 |
ldap.bindSaslMechanisms | string | 任意 | MongoDB がバインディング中にLDAPサーバーに対して認証を試行するためのSASLメカニズムのコンマ区切りリストを含む string。 デフォルトでは、MongoDB は |
ldap.bindQueryUser | string | 条件付き | MongoDB が LDAP サーバーに接続するときにバインドする LDAP エンティティ ドメイン名。実行中のシステムでこの設定を構成するには |
ldap.bindQueryPassword | string | 条件付き | MongoDB がLDAPサーバーに接続するときにバインドするパスワード。 この設定は実行中のシステムで構成するには、 |
ldap.userCacheInvalidationPerid | integer | 任意 | MongoDB がユーザー キャッシュのフラッシュ間で待機する間隔。 外部ユーザー キャッシュがフラッシュされると、 LDAP認可ユーザーが実行する次の操作には ロールが必要です。 値を大きくすると、 LDAPサーバーの負荷が軽減され、MongoDB ロールとLDAPグループ メンバーシップの同期に必要な時間が長くなる可能性があります。 デフォルトでは、MongoDB はキャッシュのフラッシュ間で 30 秒待機します。 |
ldap.authzQueryTemplate | string | 条件付き | RFC4516 設定に対する LDAP グループを取得するために実行する LDAP クエリの形式 URL |
ldap.userToDNMapping | 配列 | 任意 | ドメイン名と一致するように MongoDB ユーザー名を認証するために MongoDB が適用する順序付けされた変換を含むJSON形式の配列。 代替の認証方法を使用する場合、または認証のために MongoDB に渡されたユーザー名がLDAPドメイン名と一致しない場合は、この設定を指定できます。 実行中のシステムでこの設定を構成するには |
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 ]
名前 | タイプ | 必要性 | 説明 |
---|---|---|---|
役割 | オブジェクトの配列 | 任意 | MongoDB がクラスターのユーザー定義ロールに割り当てたロールと特権。 各オブジェクトは、異なるユーザー定義のロールを記述します。 この配列内のオブジェクトには、 _id フィールドを除いて、 システム ロール コレクション 内のドキュメントと同じフィールドが含まれています。 |
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 ドライバーがサポートするインデックス オプション。 |