- API >
- Public API Resources >
- Backup and Restore >
- Backup Configurations >
- Update One Backup Configuration
Update One Backup Configuration¶
On this page
Base URL: {opsManagerHost}:{port}
¶
Syntax¶
Request Parameters¶
Request Path Parameters¶
Parameter | Required/Optional | Description |
---|---|---|
GROUP-ID |
Required. | The unique identifier for the group that holds the cluster with the backup configuration you want to change. |
CLUSTER-ID |
Required. | The unique indentifier of the cluster whose backup configuration you want to change. |
Request Query Parameters¶
This endpoint may use any of the HTTP request query parameters available to all Ops Manager API resources. These are all optional.
Name | Type | Description | Default |
---|---|---|---|
pageNum |
integer | Page number (1-based). | 1 |
itemsPerPage |
integer | Maximum number of items to return, up to a maximum of 100. | 100 |
pretty |
boolean | Display response in human-readable format. | false |
Request Body Parameters¶
Name | Type | Description |
---|---|---|
groupId |
string | ID of the group that owns this backup configuration. |
clusterId |
string | ID of the cluster that this backup configuration is for. |
statusName |
string | The current (or desired) status of the backup configuration. Possible values are:
|
storageEngineName |
string | The storage engine used for the backup. Possible values are:
|
authMechanismName |
string | The name of the authentication mechanism to use when connecting to the sync source database. Only present when using authentication. Possible values are:
|
username |
string | The username to use to connect to the sync source database. Only present when backing up mongod instances that require clients to authenticate. You can send this field to Ops Manager only when updating the backup configuration for a replica set or sharded cluster that is not managed by Ops Manager Automation. |
password |
string | The password to use to connect to the sync source
database. Only present when backup the mongod
instances that require clients to authenticate.
You can send this field to Ops Manager only when updating the backup configuration for a replica set or sharded cluster that is not managed by Ops Manager Automation. |
encryptionEnabled |
boolean | Specifies whether encryption is enabled for the backup configuration.
You must include the syncSource field when enabling encryption
for a backup configuration. For existing backups in a group, enabling
encryption requires an initial backup sync to recreate the backups’
head databases. |
sslEnabled |
boolean | Is SSL enabled for the sync source database? |
syncSource |
string | The mongod instance to get backup data
from. Possible values are either a specific hostname or one of:
PRIMARY and SECONDARY . This field is only used when
updating a backup configuration. It is not returned by a
GET request. |
provisioned |
boolean | Reports if Ops Manager has provisioned the resources needed to store a backup. This field is only present when the amount of data to be backed up exceeds a certain threshold. |
excludedNamespaces |
string array | A list of database names and collection names to omit from the
backup. Each string is a namespace in the form of You must send the new full list of excluded namespaces, including any that were already listed. If the new list removes any namespaces from the previous list, you must
also set the If the new list only adds to the previous list, you do not need to set
|
includedNamespaces |
string array | A list of database names and collection names to include in the
backup. Each string is a namespace in the form of You must send the new full list of included namespaces, including any that were already listed. If the new list adds any namespaces to the previous list, you must
also set the If the new list only removes namespaces from the previous list, you do
not need to set |
Response Elements¶
Name | Type | Description |
---|---|---|
groupId |
string | ID of the group that owns this backup configuration. |
clusterId |
string | ID of the cluster that this backup configuration is for. |
statusName |
string | The current (or desired) status of the backup configuration. Possible values are:
|
storageEngineName |
string | The storage engine used for the backup. Possible values are:
|
authMechanismName |
string | The name of the authentication mechanism to use when connecting to the sync source database. Only present when using authentication. Possible values are:
|
encryptionEnabled |
boolean | Specifies whether encryption is enabled for the backup configuration.
You must include the syncSource field when enabling encryption
for a backup configuration. For existing backups in a group, enabling
encryption requires an initial backup sync to recreate the backups’
head databases. |
sslEnabled |
boolean | Is SSL enabled for the sync source database? |
syncSource |
string | The mongod instance to get backup data
from. Possible values are either a specific hostname or one of:
PRIMARY and SECONDARY . This field is only used when
updating a backup configuration. It is not returned by a
GET request. |
provisioned |
boolean | Reports if Ops Manager has provisioned the resources needed to store a backup. This field is only present when the amount of data to be backed up exceeds a certain threshold. |
excludedNamespaces |
string array | A list of database names and collection names to omit from the
backup. Each string is a namespace in the form of You must send the new full list of excluded namespaces, including any that were already listed. If the new list removes any namespaces from the previous list, you must
also set the If the new list only adds to the previous list, you do not need to set
|
includedNamespaces |
string array | A list of database names and collection names to include in the
backup. Each string is a namespace in the form of You must send the new full list of included namespaces, including any that were already listed. If the new list adds any namespaces to the previous list, you must
also set the If the new list only removes namespaces from the previous list, you do
not need to set |