Create One File System Store Configuration
On this page
Configures one new file system store.
Base URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/admin/backup
Resource
POST /snapshot/fileSystemConfigs
Request Path Parameters
This endpoint doesn't use HTTP request path parameters.
Request Query Parameters
The following query parameters are optional:
Name | Type | Necessity | Description | Default | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
pretty | boolean | Optional | Flag indicating whether the response body should be in a
prettyprint format. | false | ||||||
envelope | boolean | Optional | Flag that indicates whether or not to wrap the response in an envelope. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. For endpoints that return one result, the response body includes:
| false |
Request Body Parameters
Body Parameter | Type | Necessity | Description |
|---|---|---|---|
assignmentEnabled | boolean | Optional | Flag that indicates whether this file system store can be
assigned backup jobs. |
id | string | Required | Unique identifier of this file system store. |
labels | array of strings | Optional | Tags to manage which backup jobs Ops Manager can assign to which file system stores. Setting these tags limits which backup jobs this file system store can process. If omitted, this file system store can only process backup jobs for projects that do not use labels to filter their jobs. |
loadFactor | number | Optional | Positive, non-zero integer that expresses how much backup work this snapshot store should perform compared to another snapshot store. Set this option only if you're using more than one snapshot store. To learn more about Load Factor, see Edit One Existing Blockstore. |
mmapv1CompressionSetting | string | Conditional | Compression setting if you use the MMAPv1 storage engine for your snaphots. Ops Manager accepts If the MongoDB runs FCV 4.2 or later, MongoDB Atlas ignores this setting. IMPORTANT: MongoDB removed support for the MMAPv1 storage engine in MongoDB 4.2. If you edit your deployment's configuration to change your storage engine to WiredTiger Storage Engine, Ops Manager restarts the MongoDB processes. |
storePath | string | Required | Location where file system-based backups are stored on the
file system store host. |
wtCompressionSetting | string | Conditional | Compression setting if you use the WiredTiger storage engine for your snaphots. Ops Manager accepts If the MongoDB runs FCV 4.2 or later, MongoDB Atlas ignores this setting. |
Response
Name | Type | Description |
|---|---|---|
assignmentEnabled | boolean | Flag that indicates whether this file system store can be
assigned backup jobs. |
id | string | Unique identifier of this file system store. |
labels | array of strings | Tags that manage which backup jobs Ops Manager
can assign to which file system stores. |
links | array of objects | One or more links to sub-resources and/or related resources. All
|
loadFactor | number | Positive, non-zero integer that expresses how much backup work this snapshot store should perform compared to another snapshot store. Set this option only if you're using more than one snapshot store. To learn more about Load Factor, see Edit One Existing Blockstore. |
mmapv1CompressionSetting | string | Compression setting if you use the MMAPv1 storage engine for your snaphots. Ops Manager may return If the MongoDB runs FCV 4.2 or later, Ops Manager ignores this setting. IMPORTANT: MongoDB removed support for the MMAPv1 storage engine in MongoDB 4.2. If you edit your deployment's configuration to change your storage engine to WiredTiger Storage Engine, Ops Manager restarts the MongoDB processes. |
storePath | string | System root-relative directory path where file system-based
backups are stored on the file system store host. |
wtCompressionSetting | string | Compression setting if you use the WiredTiger storage engine for your snaphots. Ops Manager may return If the MongoDB runs FCV 4.2 or later, Ops Manager ignores this setting. |
Example Request
1 curl --user '{PUBLIC-KEY}:{PRIVATE-KEY}' --digest \ 2 --header 'Accept: application/json' \ 3 --header 'Content-Type: application/json' \ 4 --include \ 5 --request POST 'https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/admin/backup/snapshot/fileSystemConfigs?pretty=true' \ 6 --data '{ 7 "assignmentEnabled" : true, 8 "id" : "{FILE-SYSTEM-STORE-CONFIG-ID}", 9 "labels" : [ "l1", "l2" ], 10 "loadFactor" : 50, 11 "mmapv1CompressionSetting" : "NONE", 12 "storePath" : "/data/backup", 13 "wtCompressionSetting" : "GZIP" 14 }'
Example Response
Response Header
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
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}
Response Body
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", 7 "rel" : "self" 8 }], 9 "loadFactor" : 50, 10 "mmapv1CompressionSetting" : "NONE", 11 "storePath" : "/data/backup", 12 "wtCompressionSetting" : "GZIP" 13 }