1 つのファイルシステムストア構成の更新

項目一覧

Resource

リクエストパスパラメーター
リクエストクエリパラメータ
リクエストボディパラメータ
応答
リクエストの例
応答例
応答ヘッダー
レスポンス本体

1 つのファイルシステムストアの構成を更新します。

ベース URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/admin/backup

Resource

PUT /snapshot/fileSystemConfigs/{FILE-SYSTEM-CONFIG-ID}

リクエストパスパラメーター

Path Parameter	タイプ	必要性	説明
ファイル-SYSTEM-Config-ID	string	必須	このファイルシステムストア構成にラベルを付ける一意の識別子。

リクエストクエリパラメータ

次のクエリパラメータは任意です。

名前

タイプ

必要性

説明

default

pretty

ブール値

任意

レスポンス本体を pretty-print に含めるかどうかを示すフラグ形式。

false

envelope

ブール値

任意

応答をエンベロープでラップするかどうかを示すフラグ。

一部の APIクライアントは、 HTTPレスポンスヘッダーまたはステータスコードにアクセスできません。これを修正するには、クエリでenvelope=trueを設定します。

1 つの結果を返すエンドポイントの場合、レスポンス本体には次のものが含まれます。

名前	説明
`status`	HTTPレスポンスコード
`content`	期待される応答本体

false

リクエストボディパラメータ

Body Parameter	タイプ	必要性	説明
割り当てEnabled	ブール値	任意	このファイルシステムストアにバックアップジョブを割り当てることができるかどうかを示すフラグ。
labels	文字列の配列	任意	がどの MongoDB Ops Managerファイルシステムストアに割り当てることができるバックアップジョブを管理するためのタグ。これらのタグを設定すると、このファイルシステムストアが処理できるバックアップジョブが制限されます。省略した場合、このファイルシステムストアは、ジョブをフィルタリングするためにラベルを使用しないプロジェクトのバックアップジョブのみを処理できます。
loadFactory	数値	任意	このスナップショットストアが別のスナップショットストアと比較して実行するバックアップ作業量を表すゼロ以外の正の整数。複数のスナップショットストアを使用している場合にのみ、このオプションを設定します。 Load Factorの詳細については、「 1 つの既存のブロックストアの編集」を参照してください。
mmapv1CompressionSetting	string	任意	スナップショットに MMAPv1 storage engine を使用する場合の圧縮設定。 MongoDB Ops Manager は`NONE`または`GZIP`を受け入れます。 MongoDB Ops Manager では、この値はデフォルトで`NONE`に設定されています。 MongoDBがFCV 4.2 以降を実行している場合、 MongoDB Ops Managerはこの設定を無視します。重要: MongoDBはMongoDB 4.2で MMAPv 1ストレージエンジンのサポートを削除しました。配置の構成を編集してストレージエンジンをWiredTigerストレージエンジンに変更すると、 MongoDB Ops ManagerはMongoDBプロセスを再起動します。
StorePath	string	必須	ファイルシステムベースのバックアップがファイルシステムストアホストに保存されるロケーション。
wtCompressionSetting	string	任意	スナップショットに WiredTiger ストレージエンジンを使用する場合の圧縮設定。 MongoDB Ops Manager は`NONE`または`GZIP`を受け入れます。 MongoDB Ops Manager では、この値はデフォルトで`GZIP`に設定されています。 MongoDBがFCV 4.2 以降を実行している場合、 MongoDB Ops Managerはこの設定を無視します。

応答

名前	タイプ	説明
割り当てEnabled	ブール値	このファイルシステムストアにバックアップジョブを割り当てることができるかどうかを示すフラグ。
id	string	このファイルシステムストアの一意の識別子。
labels	文字列の配列	MongoDB Ops Manager がどのファイルシステムストアに割り当てることができるバックアップジョブを管理するタグ。
Links	オブジェクトの配列	サブリソースや関連リソースへの 1 つ以上のリンク。応答内のすべての`links`配列には、 `self`と呼ばれるリンクが少なくとも 1 つ含まれています。 URL の関係は、 Web リンク仕様で説明されています。
loadFactory	数値	このスナップショットストアが別のスナップショットストアと比較して実行するバックアップ作業量を表すゼロ以外の正の整数。複数のスナップショットストアを使用している場合にのみ、このオプションを設定します。 Load Factorの詳細については、「 1 つの既存のブロックストアの編集」を参照してください。
mmapv1CompressionSetting	string	スナップショットに MMAPv1 storage engine を使用する場合の圧縮設定。 MongoDB Ops Manager は`NONE`または`GZIP`を返す場合があります。 MongoDBがFCV 4.2 以降を実行している場合、 MongoDB Ops Managerはこの設定を無視します。重要: MongoDBはMongoDB 4.2で MMAPv 1ストレージエンジンのサポートを削除しました。配置の構成を編集してストレージエンジンをWiredTigerストレージエンジンに変更すると、 MongoDB Ops ManagerはMongoDBプロセスを再起動します。
StorePath	string	ファイルシステムストアホストに保存されるファイルシステムベースのバックアップが保存される、システムルート相対ディレクトリパス。
wtCompressionSetting	string	スナップショットに WiredTiger ストレージエンジンを使用する場合の圧縮設定。 MongoDB Ops Manager は`NONE`または`GZIP`を返す場合があります。 MongoDBがFCV 4.2 以降を実行している場合、 MongoDB Ops Managerはこの設定を無視します。

リクエストの例

1 curl --user '{PUBLIC-KEY}:{PRIVATE-KEY}' --digest \
2      --header 'Accept: application/json' \
3      --header 'Content-Type: application/json' \
4      --include \
5      --request PUT 'https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/admin/backup/snapshot/fileSystemConfigs/{FILE-SYSTEM-CONFIG-ID}?pretty=true' \
6      --data '{
7        "assignmentEnabled" : true,
8        "labels" : [ "l1", "l2" ],
9        "loadFactor" : 50,
10        "mmapv1CompressionSetting" : "NONE",
11        "storePath" : "/data/backup",
12        "wtCompressionSetting" : "GZIP"
13      }'

応答例

応答ヘッダー

HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {dateInUnixFormat}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false
Content-Length: {requestLengthInBytes}
Connection: keep-alive

HTTP/1.1 200 OK
Vary: Accept-Encoding
Content-Type: application/json
Strict-Transport-Security: max-age=300
Date: {dateInUnixFormat}
Connection: keep-alive
Content-Length: {requestLengthInBytes}
X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

レスポンス本体

1 {
2   "assignmentEnabled" : true,
3   "id" : "{FILE-SYSTEM-STORE-CONFIG-ID}",
4   "labels" : [ "l1", "l2" ],
5   "links" : [ {
6     "href" : "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/admin/backup/snapshot/fileSystemConfigs/{FILE-SYSTEM-CONFIG-ID}",
7     "rel" : "self"
8   }],
9   "loadFactor" : 50,
10   "mmapv1CompressionSetting" : "NONE",
11   "storePath" : "/data/backup",
12   "wtCompressionSetting" : "GZIP"
13 }

戻る

1 つのファイルシステムストア構成を作成

1 つのファイルシステムストア構成を削除

1	curl --user '{PUBLIC-KEY}:{PRIVATE-KEY}' --digest \
2	--header 'Accept: application/json' \
3	--header 'Content-Type: application/json' \
4	--include \
5	--request PUT 'https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/admin/backup/snapshot/fileSystemConfigs/{FILE-SYSTEM-CONFIG-ID}?pretty=true' \
6	--data '{
7	"assignmentEnabled" : true,
8	"labels" : [ "l1", "l2" ],
9	"loadFactor" : 50,
10	"mmapv1CompressionSetting" : "NONE",
11	"storePath" : "/data/backup",
12	"wtCompressionSetting" : "GZIP"
13	}'

1	{
2	"assignmentEnabled" : true,
3	"id" : "{FILE-SYSTEM-STORE-CONFIG-ID}",
4	"labels" : [ "l1", "l2" ],
5	"links" : [ {
6	"href" : "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/admin/backup/snapshot/fileSystemConfigs/{FILE-SYSTEM-CONFIG-ID}",
7	"rel" : "self"
8	}],
9	"loadFactor" : 50,
10	"mmapv1CompressionSetting" : "NONE",
11	"storePath" : "/data/backup",
12	"wtCompressionSetting" : "GZIP"
13	}