Restaurar la configuración de la Política de cumplimiento de copia de seguridad

OBTENER /api/atlas/v1.0/groups/{groupId}/backupCompliancePolicy

Devuelve la configuración de la Política de Cumplimiento de Copias de seguridad con el proyecto especificado. Para utilizar este recurso, la Cuenta de Servicio solicitante o la Clave API deben tener el rol de Propietario del Proyecto.

Parámetros de path

  • ID del grupo string Requerido

    string única de 24dígitos hexadecimales que identifica tu proyecto. Usa el endpoint /groups para recuperar todos los proyectos a los que el usuario autenticado tiene acceso.

    NOTA: Grupos y proyectos son términos sinónimos. El id de tu grupo es el mismo que el id de tu proyecto. Para los grupos ya existentes, el id de su grupo/proyecto sigue siendo el mismo. El recurso y los endpoints correspondientes utilizan el término grupos.

    El formato debe coincidir con el siguiente patrón: ^([a-f0-9]{24})$.

Parámetros de query

  • envelope booleano

    Bandera que indica si la aplicación envuelve la respuesta en un objeto JSON envelope. Algunos clientes de la API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para remediar esto, establece envelope=true en la query. Los endpoints que devuelven una lista de resultados utilizan el objeto de resultados como un sobre. La aplicación agrega el parámetro de estado al cuerpo de la respuesta.

    El valor por defecto es false.

  • bonito booleano

    Bandera que indica si el cuerpo de la respuesta debe estar en el formato prettyprint.

    El valor por defecto es false.

    Impresión bonita

Respuestas

  • 200 aplicación/json

    Vale

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Correo electrónico autorizado cadena(correo electrónico) Requerido

      Correo electrónico del usuario que autorizó la actualización de la configuración de la Política de Cumplimiento de Copias de Seguridad.

    • NombreDeUsuarioAutorizado string

      Nombre del usuario que autorizó a actualizar la configuración de la Política de cumplimiento de respaldo.

    • authorizedUserLastName string

      Apellido del usuario que autorizó a actualizar la configuración de la Política de cumplimiento de respaldo.

    • copyProtectionEnabled booleano

      Flag que indica si se debe impedir que los usuarios del clúster eliminen copias de seguridad copiadas a otras regiones, incluso si esas regiones adicionales de snapshot se eliminan. Si no se especifica, este valor por defecto se establece en falso.

      El valor por defecto es false.

    • eliminable booleano

      Marca que indica si se permite deshabilitar la Política de Cumplimiento de Copias de Seguridad. Su valor predeterminado es "false" y se debe enviar un ticket de soporte para solicitar que se configure como "true".

      El valor por defecto es false.

      Configurar una copia de seguridad de cumplimiento ...
    • encryptionAtRestEnabled booleano

      Marca que indica si se requiere el cifrado en reposo mediante la gestión de claves del cliente para todos los clústeres con una política de cumplimiento de copias de seguridad. Si no se especifica, este valor por defecto se establece en falso.

      El valor por defecto es false.

      Cifrado en reposo mediante Custo...
    • onDemandPolicyItem Objeto

      Especificaciones para la política bajo demanda.

      Ocultar atributos de onDemandPolicyItem Mostrar atributos de onDemandPolicyItem Objeto
      • frequencyInterval integer(int32) Requerido

        Número que indica el intervalo de frecuencia de un conjunto de instantáneas. MongoDB Cloud ignora esta configuración para elementos de política no horarios en la configuración de la Política de Cumplimiento de Copias de Seguridad.

        Los valores son 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, o 40.

      • frequencyType string Requerido

        Etiqueta legible por humanos que identifica el tipo de frecuencia asociado con la política de copia de seguridad.

        El valor es ondemand.

      • ID string

        Cadena única de 24dígitos hexadecimales que identifica este elemento de la política de copias de seguridad.

        El formato debe coincidir con el siguiente patrón: ^([a-f0-9]{24})$.

      • retentionUnit string Requerido

        Unidad de tiempo en la que MongoDB Cloud mide la retención de snapshot.

        Los valores son days, weeks, months o years.

      • valorDeRetención integer(int32) Requerido

        Duración en días, semanas, meses o años que MongoDB Cloud conserva la instantánea. Para elementos de política menos frecuentes, MongoDB Cloud requiere que se especifique un valor mayor o igual al especificado para elementos de política más frecuentes.

        Por ejemplo: Si el elemento de la política por hora especifica una retención de dos días, debes especificar dos días o más para la retención del elemento de la política semanal.

    • pitEnabled booleano

      Bandera que indica si el clúster utiliza copias de seguridad continuas en la nube con una política de cumplimiento de copia de seguridad. Si no se especifica, este valor es "false" por defecto.

      El valor por defecto es false.

      Copias de seguridad continuas en la nube
    • ID del proyecto string

      string única de 24 dígitos hexadecimales que identifica el Proyecto para la Política de cumplimiento de copia de seguridad.

      El formato debe coincidir con el siguiente patrón: ^([a-f0-9]{24})$.

    • restaurarVentanaDías integer(int32)

      Número de días anteriores que se pueden restaurar con Copias de Seguridad Continuas en la Nube con una Política de Cumplimiento de Copias de Seguridad. Debe especificar un número entero positivo distinto de cero, y el período de retención máximo no puede superar el tiempo de retención por hora. Este parámetro solo se aplica a Copias de Seguridad Continuas en la Nube con una Política de Cumplimiento de Copias de Seguridad.

    • scheduledPolicyItems arreglo[objeto]

      Lista que contiene las especificaciones de una política programada.

      Ocultar los atributos de scheduledPolicyItems Mostrar los atributos de scheduledPolicyItems Objeto

      Especificaciones de la política programada.

      • frequencyInterval integer(int32) Requerido

        Número que indica el intervalo de frecuencia para un conjunto de snapshots. Un valor de 1 especifica la primera instancia del correspondiente frequencyType.

        • En un elemento de política anual, 1 indica que la snapshot anual se produce el primer día de enero y 12 indica el primer día de diciembre.

        • En un elemento de política mensual, 1 indica que la instantánea mensual ocurre el primer día del mes y 40 indica el último día del mes.

        • En un elemento de política semanal, 1 indica que el snapshot semanal se lleva a cabo el lunes y 7 indica el domingo.

        • En un elemento de política horaria, puedes establecer el intervalo de frecuencia en 1, 2, 4, 6, 8 o 12. Para los elementos de la política por hora para clústeres NVMe, MongoDB Cloud solo acepta 12 como valor del intervalo de frecuencia.

        MongoDB Cloud ignora esta configuración para los elementos de política que no son por hora en la configuración de la Política de cumplimiento de respaldo.

        Los valores son 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, o 40.

      • frequencyType string Requerido

        Etiqueta legible por humanos que identifica el tipo de frecuencia asociado con la política de copia de seguridad.

        Los valores son daily, hourly, weekly, monthly o yearly.

      • ID string

        Cadena única de 24dígitos hexadecimales que identifica este elemento de la política de copias de seguridad.

        El formato debe coincidir con el siguiente patrón: ^([a-f0-9]{24})$.

      • retentionUnit string Requerido

        Unidad de tiempo en la que MongoDB nube mide la retención de instantáneas.

        Los valores son days, weeks, months o years.

      • valorDeRetención integer(int32) Requerido

        Duración en días, semanas, meses o años que MongoDB Cloud conserva la instantánea. Para elementos de política menos frecuentes, MongoDB Cloud requiere que especifique un valor mayor o igual al especificado para elementos de política más frecuentes.

        Por ejemplo: Si el elemento de la política por hora especifica una retención de dos días, debes especificar dos días o más para la retención del elemento de la política semanal.

    • Estado string

      Etiqueta que indica el estado de la configuración de la política de cumplimiento de copia de seguridad. MongoDB nube ignora esta configuración cuando habilitas o actualizas la configuración de la Política de Cumplimiento de Copias de Seguridad.

      Los valores son ACTIVE, ENABLING, UPDATING o DISABLING.

    • Fecha de actualización string(date-time)

      Formato de marca de tiempo ISO 8601 en UTC que indica cuándo el usuario actualizó la configuración de la Política de Protección de Datos. MongoDB Cloud ignora esta configuración cuando se habilita o actualiza la configuración de la Política de Cumplimiento de Copias de Seguridad.

    • updatedUser cadena(correo electrónico)

      Dirección de correo electrónico que identifica al usuario que actualizó la configuración de la Política de Cumplimiento de Copias de Seguridad. MongoDB Cloud ignora esta configuración al habilitar o actualizar la Política de Cumplimiento de Copias de Seguridad.

  • 401 aplicación/json

    No autorizado.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalle de solicitud incorrecta.

      Ocultar el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • campos arreglo[objeto]

        Describe todas las infracciones en una solicitud de cliente.

        Ocultar campos atributos Mostrar los atributos de los campos Objeto
        • Descripción string Requerido

          Una descripción de por qué el elemento de la solicitud es incorrecto.

        • Campo string Requerido

          Una ruta que conduce a un campo en el cuerpo de la solicitud.

    • detalle string

      Describe las condiciones o razones específicas que causan cada tipo de error.

    • Error integer(int32) Requerido

      Código de estado HTTP devuelto con este error.

      Documentación externa
    • errorCode string Requerido

      Código de error de aplicación devuelto con este error.

    • Parámetros arreglo[objeto]

      Parámetros utilizados para proporcionar más información sobre el error.

    • motivo string

      El mensaje de error de la aplicación se devuelve con este error.

  • 403 aplicación/json

    Forbidden.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalle de solicitud incorrecta.

      Ocultar el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • campos arreglo[objeto]

        Describe todas las infracciones en una solicitud de cliente.

        Ocultar campos atributos Mostrar los atributos de los campos Objeto
        • Descripción string Requerido

          Una descripción de por qué el elemento de la solicitud es incorrecto.

        • Campo string Requerido

          Una ruta que conduce a un campo en el cuerpo de la solicitud.

    • detalle string

      Describe las condiciones o razones específicas que causan cada tipo de error.

    • Error integer(int32) Requerido

      Código de estado HTTP devuelto con este error.

      Documentación externa
    • errorCode string Requerido

      Código de error de aplicación devuelto con este error.

    • Parámetros arreglo[objeto]

      Parámetros utilizados para proporcionar más información sobre el error.

    • motivo string

      El mensaje de error de la aplicación se devuelve con este error.

  • 404 aplicación/json

    No se encontró.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalle de solicitud incorrecta.

      Ocultar el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • campos arreglo[objeto]

        Describe todas las infracciones en una solicitud de cliente.

        Ocultar campos atributos Mostrar los atributos de los campos Objeto
        • Descripción string Requerido

          Una descripción de por qué el elemento de la solicitud es incorrecto.

        • Campo string Requerido

          Una ruta que conduce a un campo en el cuerpo de la solicitud.

    • detalle string

      Describe las condiciones o razones específicas que causan cada tipo de error.

    • Error integer(int32) Requerido

      Código de estado HTTP devuelto con este error.

      Documentación externa
    • errorCode string Requerido

      Código de error de aplicación devuelto con este error.

    • Parámetros arreglo[objeto]

      Parámetros utilizados para proporcionar más información sobre el error.

    • motivo string

      El mensaje de error de la aplicación se devuelve con este error.

  • 500 aplicación/json

    Error interno del servidor.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalle de solicitud incorrecta.

      Ocultar el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • campos arreglo[objeto]

        Describe todas las infracciones en una solicitud de cliente.

        Ocultar campos atributos Mostrar los atributos de los campos Objeto
        • Descripción string Requerido

          Una descripción de por qué el elemento de la solicitud es incorrecto.

        • Campo string Requerido

          Una ruta que conduce a un campo en el cuerpo de la solicitud.

    • detalle string

      Describe las condiciones o razones específicas que causan cada tipo de error.

    • Error integer(int32) Requerido

      Código de estado HTTP devuelto con este error.

      Documentación externa
    • errorCode string Requerido

      Código de error de aplicación devuelto con este error.

    • Parámetros arreglo[objeto]

      Parámetros utilizados para proporcionar más información sobre el error.

    • motivo string

      El mensaje de error de la aplicación se devuelve con este error.

GET /api/atlas/v1.0/groups/{groupId}/backupCompliancePolicy
curl \
 --request GET 'https://cloud.mongodb.com/api/atlas/v1.0/groups/32b6e34b3d91647abb20e7b8/backupCompliancePolicy' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Ejemplos de respuestas (200)
{
  "authorizedEmail": "hello@example.com",
  "authorizedUserFirstName": "string",
  "authorizedUserLastName": "string",
  "copyProtectionEnabled": false,
  "deletable": false,
  "encryptionAtRestEnabled": false,
  "onDemandPolicyItem": {
    "frequencyInterval": 0,
    "frequencyType": "ondemand",
    "id": "32b6e34b3d91647abb20e7b8",
    "retentionUnit": "days",
    "retentionValue": 42
  },
  "pitEnabled": false,
  "projectId": "32b6e34b3d91647abb20e7b8",
  "restoreWindowDays": 42,
  "scheduledPolicyItems": [
    {
      "frequencyInterval": 1,
      "frequencyType": "daily",
      "id": "32b6e34b3d91647abb20e7b8",
      "retentionUnit": "days",
      "retentionValue": 42
    }
  ],
  "state": "ACTIVE",
  "updatedDate": "2026-05-04T09:42:00Z",
  "updatedUser": "hello@example.com"
}
Ejemplos de respuestas (401)
{
  "error": 401,
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "reason": "Unauthorized",
  "errorCode": "NOT_ORG_GROUP_CREATOR"
}
Ejemplos de respuestas (403)
{
  "error": 403,
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "reason": "Forbidden",
  "errorCode": "CANNOT_CHANGE_GROUP_NAME"
}
Ejemplos de respuestas (404)
{
  "error": 404,
  "detail": "(This is just an example, the exception may not be related to this endpoint) Cannot find resource AWS",
  "reason": "Not Found",
  "errorCode": "RESOURCE_NOT_FOUND"
}
Ejemplos de respuestas (500)
{
  "error": 500,
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "reason": "Internal Server Error",
  "errorCode": "UNEXPECTED_ERROR"
}