/ /

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

Obtenga el cronograma de snapshot

Nota

Grupos y proyectos son términos sinónimos. Tu {PROJECT-ID} es lo mismo que tu ID del grupo. Para los grupos existentes, su identificador de grupo/proyecto sigue siendo el mismo. Esta página utiliza el término más familiar "grupo" al referirse a descripciones. El endpoint permanece como se indica en el documento.

URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

Resource

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

Request Parameters

Parámetros de ruta de solicitud

Parameter	Tipo	Necesidad	Descripción
`PROJECT-ID`	string	Requerido	Identificador único del proyecto que contiene el clúster con el cronograma de snapshots que deseas obtener.
`CLUSTER-ID`	string	Requerido	Identificador único del clúster del que desea obtener el cronograma de snapshot.

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 está 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 API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar este problema, configure envelope=true en la query. Para los endpoints que devuelven un resultado, el cuerpo de la respuesta incluye: `status`: Código de respuesta HTTP `content`: Cuerpo de respuesta esperado	`false`

Parámetros del cuerpo de la solicitud

Este endpoint no utiliza parámetros de cuerpo de solicitud HTTP.

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 para conservar los snapshots diarios. Ops Manager puede devolver valores entre `1` y `365`, inclusive. Configurar `dailySnapshotRetentionDays` en `0` desactiva esta regla.
`fullIncrementalDayOfWeek`	string	Día de la semana en que Ops Manager toma una snapshot completa. Esto garantiza una copia de seguridad reciente y completa. Ops Manager establece el valor por defecto en SUNDAY.
`groupId`	string	Identificador único del proyecto que posee la configuración de copia de seguridad.
`links`	objeto arreglo	Uno o más enlaces a subrecursos o recursos relacionados. Todos los arreglos `links` en las respuestas incluyen al menos un enlace llamado `self`. Las relaciones entre las URLse explican en la Especificación de enlace 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 usando un reloj de 24 horas. Ops Manager puede devolver valores entre `0` y `23`, 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

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --include \
     --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/backupConfigs/{CLUSTER-ID}/snapshotSchedule"

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" : 7,
4   "groupId" : "{PROJECT-ID}",
5   "links" : [],
6   "monthlySnapshotRetentionMonths" : 13,
7   "pointInTimeWindowHours": 24,
8   "snapshotIntervalHours" : 6,
9   "snapshotRetentionDays" : 2,
10   "weeklySnapshotRetentionWeeks" : 4
11 }

Volver

Cronograma de instantáneas

Update

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