Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.
Docs Menu

Obtener todas las configuraciones de copia de seguridad para un proyecto

Nota

Grupos y proyectos son términos sinónimos. Su {PROJECT-ID} es el mismo que su ID del grupo. Para los grupos existentes, el ID del grupo se mantiene igual. Esta página utiliza el término más familiar grupo cuando se refiere a descripciones. El endpoint permanece tal como se indica en el documento.

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

GET /groups/{PROJECT-ID}/backupConfigs
Nombre
Tipo
Necesidad
DescripciĂłn

PROJECT-ID

string

Requerido

string Ăşnica de 24 dĂ­gitos hexadecimales que identifica el proyecto al que aplica la configuraciĂłn de copia de seguridad.

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

Indicador que señala si el cuerpo de la respuesta debe estar en formato prettyprint.

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 o al cĂłdigo de estado. Para remediarlo, establezca envelope : true en la query.

Para los endpoints que devuelven una lista de resultados, el objeto content es un sobre. Ops Manager agrega el campo status al cuerpo de la respuesta.

false

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

Nombre
Tipo
DescripciĂłn

ID del grupo

string

string Ăšnica de 24 dĂ­gitos hexadecimales que identifica el Proyecto que posee esta configuraciĂłn de copia de seguridad.

clusterId

string

string Ăşnica de 24 dĂ­gitos hexadecimales que identifica el clĂşster cuya configuraciĂłn de copia de seguridad deseas encontrar.

Nombre del estado

string

Estado actual (o deseado) de la configuraciĂłn de la copia de seguridad. Los valores posibles son:

  • INACTIVE

  • PROVISIONING

  • STARTED

  • STOPPED

  • TERMINATING

storageEngineName

string

Motor de almacenamiento utilizado para la copia de seguridad. Los valores posibles son:

  • MEMORY_MAPPED

  • WIRED_TIGER

encryptionEnabled

booleano

Indicador que señala si el cifrado está activado para la configuración de copia de seguridad. Debes incluir el campo syncSource al habilitar el cifrado para una configuración de copia de seguridad. Para las copias de seguridad existentes en un proyecto, habilitar el cifrado requiere una sincronización inicial para recrear las bases de datos principales de las copias de seguridad.

compatibilidad de características entre versiones 4.2 y luego use cursores de copia de seguridad en lugar de bases de datos principales. Para obtener más información, consulte Servicio Daemon de copia de seguridad.

Para obtener más información sobre el cifrado de copias de seguridad para FCV 4.2 o posterior, consulta Instantáneas cifradas de copias de seguridad.

sslEnabled

booleano

Indicador que señala si TLS está habilitado para la base de datos fuente de sincronización.

espacios de nombres excluidos

arreglo de string

Lista de nombres de bases de datos y nombres de colecciones para omitir en la copia de seguridad. Cada string es un espacio de nombres con la forma de <database> o <database>.<collection>. Si este campo está presente, el campo includedNamespaces no puede estar presente.

Debe enviar la nueva lista completa de espacios de nombres excluidos, incluidos los que ya estaban listados.

Si la nueva lista remueve algún espacio de nombres de la lista anterior, también debes configurar el campo syncSource, ya que la remoción de un espacio de nombres excluido requiere una resync completa. Sin el campo syncSource, la solicitud fallará.

Si la nueva lista solo añade a la lista anterior, no necesitas establecer syncSource.

includedNamespaces

arreglo de string

Lista de nombres de bases de datos y nombres de colecciones para incluir en la copia de seguridad. Cada string es un espacio de nombres con la forma de <database> o <database>.<collection>. Cualquier namespace que no esté listado en este arreglo no será respaldado. Si este campo está presente, el campo excludedNamespaces no puede estar presente.

Debes enviar la nueva lista completa de namespaces incluidos, incluso aquellos que ya estaban listados.

Si la nueva lista agrega cualquier espacio de nombres a la lista anterior, también debes configurar el campo syncSource, ya que la adición de un espacio de nombres incluido requiere una resincronización completa. Sin el campo syncSource, la solicitud fallará.

Si la nueva lista solo remueve namespace de la lista anterior, no necesitas configurar syncSource.

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"
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}
1{
2 "totalCount" : 3,
3 "results" : [ {
4 "groupId" : "{PROJECT-ID}",
5 "clusterId" : "{CLUSTER-ID1}",
6 "statusName" : "STARTED",
7 "storageEngineName" : "WIRED_TIGER",
8 "sslEnabled" : false,
9 "excludedNamespaces" : [ ],
10 "includedNamespaces" : [ ],
11 "links" : [ ]
12 }, {
13 "groupId" : "{PROJECT-ID}",
14 "clusterId" : "{CLUSTER-ID2}",
15 "statusName" : "STARTED",
16 "storageEngineName" : "MEMORY_MAPPED",
17 "sslEnabled" : false,
18 "excludedNamespaces" : [ ],
19 "includedNamespaces" : [ ],
20 "links" : [ ]
21 }, {
22 "groupId" : "{PROJECT-ID}",
23 "clusterId" : "{CLUSTER-ID3}",
24 "statusName" : "STOPPED",
25 "storageEngineName" : "WIRED_TIGER",
26 "sslEnabled" : false,
27 "excludedNamespaces" : [ ],
28 "includedNamespaces" : [ ],
29 "links" : [ ]
30 } ],
31 "links" : [ ]
32}