/ /

Copia de seguridad y restauración

Cronograma de instantáneas

Docs Home

Gestión

Gerente de Operaciones

API

Recursos

Copia de seguridad y restauración

Cronograma de instantáneas

Actualiza el cronograma de snapshot

Nota

Grupos y proyectos son términos sinónimos. Tu {PROJECT-ID} es el mismo que el ID de tu proyecto. Para los grupos existentes, el ID de grupo/proyecto permanece igual. Esta página utiliza el término más familiar «grupo» al referirse a las descripciones. El punto final se mantiene como se indica en el documento.

Resource

PATCH /groups/{PROJECT-ID}/backupConfigs/{CLUSTER-ID}/snapshotSchedule

Request Parameters

Parámetros de la ruta de solicitud

Parameter	Tipo	Necesidad	Descripción
`PROJECT-ID`	string	Requerido	Identificador único del proyecto que contiene el clúster con la programación de instantáneas que desea actualizar.
`CLUSTER-ID`	string	Requerido	Identificador único del clúster cuyo cronograma de snapshot deseas actualizar.

Parámetros de Solicitud Query

Los siguientes parámetros de query son opcionales:

Nombre

Tipo

Necesidad

Descripción

predeterminado

bonito

booleano

Opcional

Indicador que señala si el cuerpo de la respuesta debe estar en un pretty-print formato.

false

envelope

booleano

Opcional

Bandera que indica si se debe o no envolver la respuesta en un sobre.

Algunos Los clientes de laAPI no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, configure envelope=true en la consulta.

Para los endpoints que devuelven un resultado, el cuerpo de la respuesta incluye:

Nombre	Descripción
`status`	Código de respuesta HTTP
`content`	Cuerpo de respuesta esperado

false

Parámetros del cuerpo de la solicitud

Nombre	Tipo	Necesidad	Descripción
`clusterCheckpointIntervalMin`	Número	Opcional	Número de minutos entre los puntos de control sucesivos del clúster. Esto solo se aplica a clústeres fragmentados. Este número determina el nivel de detalle de las restauraciones a un punto específico del tiempo para los clústeres. Puede establecer un valor de `15`, `30` o `60`.
`clusterId`	string	Opcional	Identificador único del clúster al que se aplica esta configuración de copia de seguridad.
`dailySnapshotRetentionDays`	Número	Opcional	Número de días para conservar las instantáneas diarias. Los valores aceptados son: `0`, `3`, `4`, `5`, `6`, `7`, `15`, `30`, `60`, `90`, `120`, `180`, `360`. Configurar `dailySnapshotRetentionDays` en `0` desactiva esta regla.
`fullIncrementalDayOfWeek`	string	Opcional	Día de la semana en que Ops Manager toma una instantánea completa. Esto garantiza una copia de seguridad completa y reciente. Ops Manager establece el valor predeterminado en SUNDAY.
`groupId`	string	Opcional	Identificador único del proyecto propietario de la configuración de respaldo.
`links`	objeto arreglo	Opcional	Uno o más enlaces a subrecursos o recursos relacionados. Todas las `links` matrices en las respuestas incluyen al menos un enlace `self` llamado. Las relaciones entre las URLse explican en la Especificación de Enlaces Web.
`monthlySnapshotRetentionMonths`	Número	Opcional	Número de meses para conservar snapshots mensuales. Puedes establecer un valor entre `1` y `36`, inclusive. Configurar `monthlySnapshotRetentionMonths` en `0` desactiva esta regla.
`pointInTimeWindowHours`	Número	Opcional	Número de horas en el pasado para las que se puede crear una snapshot puntual.
`referenceHourOfDay`	Número	Opcional	Hora del día para programar las instantáneas usando un reloj de 24 horas. Puedes establecer un valor entre `0` y `23`, inclusive.
`referenceMinuteOfHour`	Número	Opcional	Minuto de la hora para programar instantáneas. Puede establecer un valor entre `0` y `59`, ambos inclusive.
`referenceTimeZoneOffset`	string	Opcional	El desfase horario ISO-8601 en el que se encuentra el host de Ops Manager. Para evitar problemas con el horario de verano, utiliza UTC. El valor por defecto es `+0000`, que es equivalente a UTC. `Z` también es un valor admitido y equivalente a UTC. Ops Manager convierte cualquier desplazamiento diferente de `+0000` a `+0000` antes de almacenarlo, y ajusta en consecuencia el valor `referenceHourOfDay`. Por ejemplo, pasas una solicitud con un `referenceHourOfDay` de `5` y un `referenceTimeZoneOffset` de "+0200". \|onprem\| stores a ``referenceHourOfDay de `3` y un `referenceTimeZoneOffset` de `"+0000"`.
`snapshotIntervalHours`	Número	Opcional	Número de horas entre instantáneas. Puede establecer un valor de `6`, `8`, `12` o `24`.
`snapshotRetentionDays`	Número	Opcional	Número de días para mantener las snapshot recientes. Puedes establecer un valor entre `2` y `5`, inclusive.
`weeklySnapshotRetentionWeeks`	Número	Opcional	Número de semanas para conservar las instantáneas semanales. Puede establecer un valor entre `1` y `52`, ambos inclusive. Configurar `weeklySnapshotRetentionWeeks` en `0` desactiva esta regla.

Respuesta

Nombre	Tipo	Descripción
`clusterCheckpointIntervalMin`	Número	Número de minutos entre los puntos de control sucesivos del clúster. Esto solo se aplica a clústeres fragmentados. Este número determina el nivel de detalle de las restauraciones a un punto específico del tiempo para los clústeres. Ops Manager puede devolver valores de `15`, `30` o `60`.
`clusterId`	string	Identificador único del clúster al que se aplica esta configuración de copia de seguridad.
`dailySnapshotRetentionDays`	Número	Número de días que se conservarán las instantáneas diarias. Ops Manager puede devolver valores entre `1` y `365`, ambos inclusive. Configurar `dailySnapshotRetentionDays` en `0` desactiva esta regla.
`fullIncrementalDayOfWeek`	string	Día de la semana en que Ops Manager realiza un snapshot completo. Esto asegura una copia de seguridad reciente y completa. Ops Manager establece el valor por defecto en SUNDAY.
`groupId`	string	Identificador único del proyecto propietario de la configuración de respaldo.
`links`	objeto arreglo	Uno o más enlaces a subrecursos o recursos relacionados. Todas las `links` matrices en las respuestas incluyen al menos un enlace `self` llamado. Las relaciones entre las URLse explican en la Especificación de Enlaces Web.
`monthlySnapshotRetentionMonths`	Número	Número de meses para conservar snapshots mensuales. Ops Manager puede devolver valores entre `1` y `36`, inclusives. Configurar `monthlySnapshotRetentionMonths` en `0` desactiva esta regla.
`pointInTimeWindowHours`	Número	Número de horas en el pasado para las que se puede crear una snapshot puntual.
`referenceHourOfDay`	Número	Hora del día para programar instantáneas con un formato de 24 horas. Ops Manager puede devolver valores entre `0` y `23`, ambos inclusive.
`referenceMinuteOfHour`	Número	Minuto de la hora para programar snapshots. Ops Manager puede devolver valores entre `0` y `59`, ambos inclusive.
`referenceTimeZoneOffset`	string	El desfase horario ISO-8601 en el que se encuentra el host de Ops Manager. Para evitar problemas con el horario de verano, utiliza UTC. El valor por defecto es `+0000`, que es equivalente a UTC. `Z` también es un valor admitido y equivalente a UTC. Ops Manager convierte cualquier desplazamiento diferente de `+0000` a `+0000` antes de almacenarlo, y ajusta en consecuencia el valor `referenceHourOfDay`. Por ejemplo, pasas una solicitud con un `referenceHourOfDay` de `5` y un `referenceTimeZoneOffset` de "+0200". \|onprem\| stores a ``referenceHourOfDay de `3` y un `referenceTimeZoneOffset` de `"+0000"`.
`snapshotIntervalHours`	Número	Número de horas entre instantáneas. El administrador de operaciones puede devolver valores de `6`, `8`, `12` o `24`.
`snapshotRetentionDays`	Número	Número de días para conservar las snapshots recientes. Ops Manager puede devolver valores entre `2` y `5`, inclusive.
`weeklySnapshotRetentionWeeks`	Número	Número de semanas para conservar snapshots semanales. Ops Manager puede devolver valores entre `1` y `52`, inclusive. Configurar `weeklySnapshotRetentionWeeks` en `0` desactiva esta regla.

Solicitud de ejemplo

1 curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
2      --header "Accept: application/json" \
3      --header "Content-Type: application/json" \
4      --include \
5      --request PATCH "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/backupConfigs/{CLUSTER-ID}/snapshotSchedule" \
6      --data '
7        {
8          "fullIncrementalDayOfWeek":"TUESDAY"
9          "snapshotIntervalHours": 8,
10          "dailySnapshotRetentionDays": 15,
11          "monthlySnapshotRetentionMonths": 6
12        }'

Respuesta de ejemplo

Encabezado de respuesta

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}

Respuesta del cuerpo

1 {
2   "clusterId" : "{CLUSTER-ID}",
3   "dailySnapshotRetentionDays" : 15,
4   "fullIncrementalDayOfWeek":"TUESDAY",
5   "groupId" : "{PROJECT-ID}",
6   "links" : [],
7   "monthlySnapshotRetentionMonths" : 6,
8   "pointInTimeWindowHours": 24,
9   "snapshotIntervalHours" : 8,
10   "snapshotRetentionDays" : 2,
11   "weeklySnapshotRetentionWeeks" : 4
12 }

Volver

Obtener cronograma

Snapshots

1	curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
2	--header "Accept: application/json" \
3	--header "Content-Type: application/json" \
4	--include \
5	--request PATCH "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/backupConfigs/{CLUSTER-ID}/snapshotSchedule" \
6	--data '
7	{
8	"fullIncrementalDayOfWeek":"TUESDAY"
9	"snapshotIntervalHours": 8,
10	"dailySnapshotRetentionDays": 15,
11	"monthlySnapshotRetentionMonths": 6
12	}'

1	{
2	"clusterId" : "{CLUSTER-ID}",
3	"dailySnapshotRetentionDays" : 15,
4	"fullIncrementalDayOfWeek":"TUESDAY",
5	"groupId" : "{PROJECT-ID}",
6	"links" : [],
7	"monthlySnapshotRetentionMonths" : 6,
8	"pointInTimeWindowHours": 24,
9	"snapshotIntervalHours" : 8,
10	"snapshotRetentionDays" : 2,
11	"weeklySnapshotRetentionWeeks" : 4
12	}