Devolver la configuración de la política de cumplimiento de copias de seguridad

Obtener /api/atlas/v2/grupos/{ID de grupo}/backupCompliancePolicy

Devuelve la configuración de la política de cumplimiento de copias de seguridad del proyecto especificado. Para usar este recurso, la cuenta de servicio o la clave API solicitantes deben tener el rol de propietario del proyecto. Versiones obsoletas: v2-{2023-01-01}

Parámetros de ruta

  • ID de grupo string Requerido

    Cadena 24hexadecimal única que identifica su proyecto. Utilice el punto de conexión /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 de tu proyecto. Para los grupos existentes, el ID de tu grupo/proyecto permanece igual. El recurso y los puntos finales correspondientes usan el término "grupos".

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

Parámetros de consulta

  • envolvente booleano

    Indicador que indica si la aplicación encapsula 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 solucionar esto, configure envelope=true en la consulta. Los endpoints que devuelven una lista de resultados utilizan el objeto de resultados como encapsulado. La aplicación añade el parámetro de estado al cuerpo de la respuesta.

    El valor predeterminado es false.

  • bonita booleano

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

    El valor predeterminado es false.

    Impresión bonita

Respuestas

  • 200 application/vnd.atlas.2023-10-01+json

    Vale

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

      Dirección de correo electrónico del usuario que autorizó actualizar la configuración de la Política de cumplimiento de copias de seguridad.

    • NombreDeUsuarioAutorizado string Requerido

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

    • Apellido del usuario autorizado string Requerido

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

    • Protección contra copia habilitada booleano

      Marca que indica si se debe impedir que los usuarios del clúster eliminen copias de seguridad copiadas a otras regiones, incluso si se eliminan esas regiones de instantáneas adicionales. Si no se especifica, el valor predeterminado es "false".

      El valor predeterminado es false.

    • borrable 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 predeterminado es false.

      Configurar una copia de seguridad de cumplimiento ...
    • cifrado en reposo habilitado booleano

      Indicador que indica si se requiere el cifrado en reposo mediante la administración de claves del cliente para todos los clústeres con una política de cumplimiento de copias de seguridad. Si no se especifica, el valor predeterminado es falso.

      El valor predeterminado es false.

      Cifrado en reposo usando Custo...
    • onDemandPolicyItem Objeto

      Especificaciones para la política bajo demanda.

      Ocultar atributos 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.

      • tipo de frecuencia string Requerido

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

        El valor es ondemand.

      • ID. string

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

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

      • unidad de retención string Requerido

        Unidad de tiempo en la que MongoDB Cloud 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 se especifique un valor mayor o igual al especificado para elementos de política más frecuentes.

        Por ejemplo: si el elemento de política por hora especifica una retención de dos días, debe especificar dos días o más para la retención del elemento de 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 predeterminado 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})$.

    • restaurarWindowDays 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.

    • Elementos de política programados matriz[objeto]

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

      Especificaciones para la política programada.

      Ocultar atributos de ScheduledPolicyItems Mostrar atributos de ScheduledPolicyItems Objeto
      • 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 instantánea anual ocurre 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 la instantánea semanal ocurre el lunes y 7 indica el domingo.

        • En un elemento de política horaria, puede establecer el intervalo de frecuencia en 1, 2, 4, 6, 8 o 12. Para elementos de política horaria de clústeres NVMe, MongoDB Cloud solo acepta 12 como valor de 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.

      • tipo de frecuencia string Requerido

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

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

      • ID. string

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

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

      • unidad de retención 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 política por hora especifica una retención de dos días, debe especificar dos días o más para la retención del elemento de política semanal.

    • Estado string

      Etiqueta que indica el estado de 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.

      Los valores son ACTIVE, ENABLING, UPDATING o DISABLING.

    • fecha de actualización cadena(fecha-hora)

      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 al habilitar o actualizar 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 incorrecto.

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

        Describe todas las violaciones en una solicitud de cliente.

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

          Una descripción de por qué el elemento de 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 matriz[objeto]

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

    • razón string

      Se devolvió un mensaje de error de aplicación con este error.

  • 403 aplicación/json

    Forbidden.

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

      Detalle de solicitud incorrecto.

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

        Describe todas las violaciones en una solicitud de cliente.

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

          Una descripción de por qué el elemento de 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 matriz[objeto]

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

    • razón string

      Se devolvió un mensaje de error de aplicación 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 incorrecto.

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

        Describe todas las violaciones en una solicitud de cliente.

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

          Una descripción de por qué el elemento de 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 matriz[objeto]

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

    • razón string

      Se devolvió un mensaje de error de aplicación 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 incorrecto.

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

        Describe todas las violaciones en una solicitud de cliente.

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

          Una descripción de por qué el elemento de 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 matriz[objeto]

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

    • razón string

      Se devolvió un mensaje de error de aplicación con este error.

GET /api/atlas/v2/groups/{groupId}/backupCompliancePolicy
atlas api cloudBackups getCompliancePolicy --help
import (
	"os"
	"context"
	"log"
	sdk "go.mongodb.org/atlas-sdk/v20240805001/admin"
)

func main() {
	ctx := context.Background()
	clientID := os.Getenv("MONGODB_ATLAS_CLIENT_ID")
	clientSecret := os.Getenv("MONGODB_ATLAS_CLIENT_SECRET")

	// See https://dochub.mongodb.org/core/atlas-go-sdk-oauth
	client, err := sdk.NewClient(sdk.UseOAuthAuth(clientID, clientSecret))

	if err != nil {
		log.Fatalf("Error: %v", err)
	}

	params = &sdk.GetGroupBackupCompliancePolicyApiParams{}
	sdkResp, httpResp, err := client.CloudBackupsApi.
		GetGroupBackupCompliancePolicyWithParams(ctx, params).
		Execute()
}
curl --include --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "Accept: application/vnd.atlas.2024-08-05+json" \
  -X GET "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/backupCompliancePolicy?pretty=true"
curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \
  --digest --include \
  --header "Accept: application/vnd.atlas.2024-08-05+json" \
  -X GET "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/backupCompliancePolicy?pretty=true"
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"
}