/ /

Snapshots

Docs Home

/ /

Copia de seguridad y restauración

Copia de seguridad y restauración

Snapshots

Obtener todas los snapshots para un clúster

Cloud Manager dejará de admitir la Automatización, la Copia de seguridad y la Supervisión para MongoDB 3.6 y 4.0 después del 30de agosto de 2024. Por favor actualiza tu implementación de MongoDB o migra a Atlas.

URL base: https://cloud.mongodb.com/api/public/v1.0

Resource

GET /groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/snapshots

Request Parameters

Parámetros de la 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.

Parámetros de Solicitud Query

Los siguientes parámetros de query son opcionales:

Nombre	Tipo	Necesidad	Descripción	predeterminado
Num. de pág.	Número	Opcional	Entero basado en uno que devuelve una subsección de resultados.	`1`
elementosPorPágina	Número	Opcional	Número de elementos a devolver por página, hasta un máximo de 500.	`100`
bonito	booleano	Opcional	Bandera que indica si el cuerpo de la respuesta debe estar en formato prettyprint 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 una lista de resultados, el objeto `content` es un sobre. Cloud Manager añade el campo `status` al cuerpo de la respuesta.	`false`
backupJobsEnabledOnly	booleano	Opcional	Indicador que indica si se deben excluir de la respuesta los daemons no habilitados para realizar copias de seguridad de bases de datos. Establezca este valor en `false` para incluir las configuraciones de daemon con el indicador `backupJobsEnabled` establecido en `false`.	`true`

Parámetros del cuerpo de la solicitud

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

Respuesta

Documento de respuesta

El documento JSON de respuesta incluye una matriz de result objetos, una matriz de link objetos y un recuento del número total de result objetos recuperados.

Nombre	Tipo	Descripción
`results`	arreglo	La matriz incluye un objeto para cada elemento detallado en el Sección `results` Documento incrustado.
`links`	arreglo	El arreglo incluye uno o más enlaces a subrecursos y/o recursos relacionados. Las relaciones entre URLse explican en la Especificación de enlace web.
`totalCount`	Número	Recuento entero del número total de elementos en el conjunto de resultados. Puede ser superior al número de objetos en el arreglo results si el conjunto de resultados completo está paginado.

`results` embeddedDocument

Cada resultado es un almacén de sincronización.

`Name`	Tipo	Descripción
`clusterId`	string	Identificador único del clúster que representa el snapshot.
`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`	fecha y hora	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	Bandera que indica que la instantánea no se puede eliminar.
`expires`	fecha y hora	Marca de tiempo en formato 8601 de fecha y hora ISO en UTC a las UTC después de las cuales se puede eliminar esta instantánea. 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 consistencia de esta instantánea. `isPossiblyInconsistent` aparece solo para instantáneas de clúster fragmentado. Para tomar una instantánea de un clúster fragmentado en un estado consistente, la copia de seguridad desactiva temporalmente el balanceador antes de crearla. En algunos casos, no puede desactivar el balanceador a tiempo. La instantánea se crea entonces con el balanceador aún en ejecución. 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`	fecha y hora	Marca de tiempo en formato de fecha y hora ISO 8601 en UTC a las 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 y/o recursos relacionados. Todos los `links` arreglos en las respuestas incluyen al menos un enlace llamado `self`. Las relaciones entre URLs se 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 esta instantánea. 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 estable, esta matriz está vacía. Si la copia de seguridad no puede conectarse a un fragmento al crear una instantánea, este se omite. Cada documento de la matriz es un documento de clúster que contiene un `self` enlace.
`missingShards` `.id`	string	Identificador único de la particiónfaltante.
`missingShards` `.groupId`	string	Identificador único del proyecto que posee el fragmento faltante.
`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`	fecha y hora	Marca de tiempo en ISO 8601 formato de fecha y hora en UTC a las UTC cuando se recibió el último latido de la particióndesaparecida.
`parts`	Arreglo de objetos	Partes individuales que componen la instantánea completa. Para un conjunto de réplicas, esta matriz contiene un solo 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` `.compressionSetting`	string	Método de compresión para la snapshot.
`parts` `.dataSizeBytes`	Número	Tamaño total de los datos en la instantánea en bytes.
`parts` `.encryptionEnabled`	booleano	Indicador del estado de cifrado de los datos de la instantánea.
`parts` `.fileSizeBytes`	Número	Tamaño total de los archivos de datos en bytes.
`parts` `.masterKeyUUID`	string	ID de clavemaestra KMIP utilizada para cifrar los datos de la instantánea. `parts.masterKeyUUID` aparece solo si esta instantánea `parts.encryptionEnabled : true` tiene.
`parts` `.mongodVersion`	string	Versión de que `mongod` el conjunto de réplicas principal estaba ejecutando cuando se creó la instantánea.
`parts` `.replicaSetName`	string	Nombre del conjunto de réplicas.
`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`

Solicitud de ejemplo

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --include \
     --request GET "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/snapshots?pretty=true"

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

{
  "links" : [ {
    "href" : "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/snapshots?pretty=true&pageNum=1&itemsPerPage=100",
    "rel" : "self"
  } ],
  "results" : [ {
    "clusterId" : "{CLUSTER-ID}",
    "complete" : true,
    "created" : {
      "date" : "2016-08-21T23:47:38Z",
      "increment" : 1
    },
    "doNotDelete" : false,
    "expires" : "2017-08-20T23:47:38Z",
    "groupId" : "{PROJECT-ID}",
    "id" : "{SNAPSHOT-ID}",
    "links" : [ {
      "href" : "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/clusters/{CLUSTER-ID}/snapshots/{SNAPSHOT-ID}",
      "rel" : "self"
    } ],
    "namespaceFilterList" : {
      "filterList" : [ ],
      "filterType" : "denyList"
    },
    "parts" : [ {
      "clusterId" : "{CLUSTER-ID}",
      "compressionSetting" : "GZIP",
      "dataSizeBytes" : 503779557,
      "encryptionEnabled" : false,
      "fileSizeBytes" : 2855605344,
      "mongodVersion" : "4.0.9",
      "replicaSetName" : "proton",
      "storageSizeBytes" : 547516416,
      "typeName" : "REPLICA_SET"
    } ]
  }, {
  } ],
  "totalCount" : 28
}

Volver

Snapshots

Obtener uno (clúster)

Resource

Request Parameters

Parámetros de la ruta de solicitud

Parámetros de Solicitud Query

Parámetros del cuerpo de la solicitud

Respuesta

Documento de respuesta

results embeddedDocument

Solicitud de ejemplo

Respuesta de ejemplo

Encabezado de respuesta

Respuesta del cuerpo

`results` embeddedDocument