Cambie la Expiración de un snapshot

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

Resource

PATCH /groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/snapshots/{SNAPSHOT-ID}

Request Parameters

Parámetros de ruta de solicitud

Nombre	Tipo	Descripción
PROJECT-ID	string	Identificador único del Proyecto que es propietario de la snapshot.
CLUSTER-ID	string	Identificador único del clúster que representa la instantánea.
SNAPSHOT-ID	string	Identificador único de la 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 muestra si el cuerpo de la respuesta está en formato pretty-print.	`false`
envelope	booleano	Opcional	Bandera que indica si se debe o no envolver la respuesta en un sobre. Algunos clientes API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, ajusta 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

Nombre	Tipo	Descripción
doNotDelete	booleano	Indicador de que el snapshot no puede ser eliminado. IMPORTANTE: no puede configurar `doNotDelete` en `true` y establecer una marca de tiempo para `expires` en la misma solicitud. Si lo haces, Ops Manager devuelve un error: `Cannot modify snapshot because of invalid fields.`
expira	Marca de tiempo	La fecha en el formato de fecha y hora ISO 8601 en UTC después de la cual este snapshot puede borrarse. Si `doNotDelete` se establece en `true`, se elimina cualquier valor existente en `expires`. Si `expires` se establece en una marca de tiempo igual o anterior a la fecha y hora actual, Ops Manager elimina el snapshot en su próxima oportunidad. No hay garantía de que el snapshot se borre de inmediato. Si la marca de tiempo `expires` actual ya ha pasado, no se puede editar.

Respuesta

`Name`	Tipo	Descripción
`clusterId`	string	Identificador único del clúster que representa el snapshot.
`clusterName`	string	Etiqueta que identifica el clúster.
`complete`	booleano	Indicador que indica que se ha creado la snapshot. Esto es `false` si la tarea de creación de instantáneas aún está en curso.
`created`	Documento	Componentes de una marca de tiempo.
`created` `.date`	Marca de tiempo	El tiempo iso8601cuando se tomó el snapshot.
`created` `.increment`	entero	Orden de operación en el que este snapshot tuvo lugar en este punto exacto en el tiempo. Para aprender cómo funcionan las marcas de tiempo en MongoDB, consulta Marcas de tiempo.
`doNotDelete`	booleano	Indicador que indica que la instantánea no puede borrarse.
`expires`	Marca de tiempo	Marca de tiempo en el formato de fecha y hora ISO 8601 en UTC a las UTC después de lo cual este snapshot puede borrarse. Si `doNotDelete` está configurado en `true`, se elimina cualquier valor en `expires`. Si el valor `expires` es anterior a la fecha y hora actuales, no se puede editar.
`groupId`	string	Identificador único del Proyecto que es propietario de la snapshot.
`id`	string	Identificador único de la snapshot.
`isPossibly` `Inconsistent`	booleano	Bandera que indica la coherencia de esta snapshot. `isPossiblyInconsistent` aparece únicamente para las instantáneas de clúster particionado. Para tomar una snapshot de un clúster particionado en un estado coherente, la copia de seguridad apaga temporalmente el balanceador antes de crear la snapshot. En algunos casos, no se puede apagar el balanceador de manera oportuna. A continuación, se crea la snapshot con el balanceador aún en funcionamiento. Si esto sucede, el snapshot podría encontrarse en un estado inconsistente (por ejemplo, es posible que las migraciones de fragmentos estén en curso).
`lastOplog` `AppliedTimestamp`	Documento	Se aplicaron los componentes del timestamp de la última entrada de oplog.
`lastOplog` `AppliedTimestamp` `.date`	Marca de tiempo	Marca de tiempo en formato 8601 de fecha y hora ISO en UTC cuando se aplicó el último oplog.
`lastOplog` `AppliedTimestamp` `.increment`	entero	Orden de la operación en la que se aplicó el último oplog en este exacto punto en el tiempo. Para aprender cómo funcionan las marcas de tiempo en MongoDB, consulta Marcas de tiempo.
`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 URLse explican en la Especificación de enlaces web.
`namespaceFilterList`	Objeto	espacios de nombres que están incluidos o excluidos en este snapshot.
`namespaceFilterList` `.filterList`	arreglo de string	Lista separada por comas de cualquier combinación de bases de datos o namespaces que estén exclusivamente incluidos o explícitamente excluidos del snapshot. El valor por defecto es un arreglo vacío (`[]`).
`namespaceFilterList` `.filterType`	string	Etiqueta que determina cómo se filtran los espacios de nombres para este snapshot. Si este valor se establece en `denylist`, los espacios de nombres en `namespaceFilterList.filterList` se excluyen de la instantánea. Si este valor se establece en `accessList`, solo los namespaces en `namespaceFilterList.filterList` se incluyen en la snapshot. El valor por defecto es `denylist`.
`missingShards`	Arreglo de objetos	Lista de particiones que le faltan a la snapshot. `missingShards` aparece solo para instantáneas de clústeres fragmentados. En estado estacionario, este arreglo está vacío. Si la copia de seguridad no puede conectarse a una partición cuando se crea una snapshot, la partición se omite de la snapshot. Cada documento en el arreglo es un documento de clúster que contiene un enlace de `self`.
`missingShards` `.id`	string	Identificador único de la particiónfaltante.
`missingShards` `.groupId`	string	Identificador único del Proyecto que posee la particiónfaltante.
`missingShards` `.typeName`	string	Tipo de servidor que representa la partición que falta: `CONFIG_SERVER_REPLICA_SET` `REPLICA_SET` `CONFIG_SHARD_REPLICA_SET`
`missingShards` `.clusterName`	string	Nombre del clúster para la particiónfaltante.
`missingShards` `.shardName`	string	Nombre de la particiónque falta.
`missingShards` `.replicaSetName`	string	Nombre del set de réplicas en la particiónque falta.
`missingShards` `.lastHeartbeat`	Marca de tiempo	Marca de tiempo en formato de fecha y hora ISO 8601 en UTC (hora UTC) cuando se recibió el último latido de la partición que falta .
`parts`	Arreglo de objetos	Partes individuales que conforman la snapshotcompleta. Para un set de réplicas, este arreglo contiene un único documento. Para un cluster particionado, este arreglo contiene un documento por cada partición más un documento para el servidor de configuración.
`parts` `.clusterId`	string	Identificador único del set de réplicas.
`parts` `.completedTime`	string	Fecha y hora en que se completó la snapshot.
`parts` `.compressionSetting`	string	Método de compresión para la snapshot.
`parts` `.dataSizeBytes`	Número	Tamaño total de los datos en el snapshot en bytes.
`parts` `.encryptionEnabled`	booleano	Indicador del estado de cifrado de los datos del snapshot.
`parts` `.fcv`	string	Número que indica la compatibilidad de características entre versiones de MongoDB que ejecutó el nodo primario del set de réplicas cuando MongoDB Cloud creó la snapshot.
`parts` `.fileSizeBytes`	Número	Tamaño total de los archivos de datos en bytes.
`parts` `.machineId`	string	Nombre del host y puerto que indican el nodo en el que MongoDB nube creó la snapshot.
`parts` `.masterKeyUUID`	string	KMIP ID de clave maestra utilizado para cifrar los datos del snapshot. `parts.masterKeyUUID` solo aparece si esta instantánea tiene `parts.encryptionEnabled : true`.
`parts` `.mongodVersion`	string	Versión de `mongod` que estaba utilizando el set de réplicas primario cuando se creó la snapshot.
`parts` `.replicaSetName`	string	Nombre del set de réplicas.
`parts` `.replicaState`	string	El rol del nodo en el momento en que comenzó el proceso de snapshot.
`parts` `.storageSizeBytes`	Número	Tamaño total del espacio asignado para el almacenamiento de documentos.
`parts` `.typeName`	string	Tipo de servidor que representa la pieza: `REPLICA_SET` `CONFIG_SERVER_REPLICA_SET` `CONFIG_SHARD_REPLICA_SET`

`links` Arreglo

El arreglo links incluye uno o más enlaces a subrecursos y/o recursos relacionados. Las relaciones entre URLs se explican en la Especificación de Enlace Web

Relación	Descripción
sí mismo	El punto final URL para este recurso.

Solicitud de ejemplo

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --include \ --request PATCH "https://{opsManagerHost}:{port}/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/snapshots/{SNAPSHOT-ID}?pretty=true" \ --data ' {   "doNotDelete": true }'

Respuesta de ejemplo

Encabezado de respuesta

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

HTTP/1.1 200 OKVary: Accept-EncodingContent-Type: application/jsonStrict-Transport-Security: max-age=300Date: {dateInUnixFormat}Connection: keep-aliveContent-Length: {requestLengthInBytes}X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

Respuesta del cuerpo

{  "id" : "{SNAPSHOT-ID}",  "CLUSTER-ID" : "{CLUSTER-ID}",  "complete" : true,  "created" : {    "date" : "2014-07-09T15:24:37Z",    "increment" : 1  },  "doNotDelete" : true,  "GROUP-ID" : "{PROJECT-ID}",  "lastOplogAppliedTimestamp" : {    "date" : "2017-08-21T09:14:51Z",    "increment" : 1  },  "links" : [ {    "href" : "https://{opsManagerHost}:{port}/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/snapshots/{SNAPSHOT-ID}",   "rel" : "self"  } ],  "namespaceFilterList" : {    "filterList" : [ ],    "filterType" : "denylist"  },  "parts" : [ {    "CLUSTER-ID" : "{CLUSTER-ID}",    "dataSizeBytes" : 17344,    "fileSizeBytes" : 67108864,    "mongodVersion" : "2.6.3",    "replicaSetName" : "rs0",    "storageSizeBytes" : 10502144,    "typeName" : "REPLICA_SET"  } ],}

Volver

Obtener uno (clúster)

Remover uno