PARCHE /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/onlineArchives/{archiveId}

Actualiza, pausa o reanuda un archivo en línea. Este archivo almacena datos de un clúster dentro de un proyecto. Para usar este recurso, la cuenta de servicio o la clave API solicitantes deben tener el rol de administrador de acceso a datos del proyecto.

Archivo en línea

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})$.

  • archiveId string Requerido

    Cadena de dígitos hexadecimales 24única que identifica el archivo en línea que se actualizará.

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

  • nombre del clúster string Requerido

    Etiqueta legible por humanos que identifica el clúster que contiene la colección especificada desde la cual la aplicación creó el archivo en línea.

    El formato debe coincidir con el siguiente patrón: ^[a-zA-Z0-9][a-zA-Z0-9-]*$.

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
application/vnd.atlas.2023-01-01+json

Cuerpo Requerido

Actualiza, pausa o reanuda un archivo en línea.

  • criterios Objeto

    Uno de:
  • dataExpirationRule Objeto

    Regla para especificar cuándo se deben eliminar los datos del archivo.

    Ocultar el atributo dataExpirationRule Mostrar el atributo dataExpirationRule Objeto
    • expirarDespuésDeDías integer(int32)

      Número de días utilizados en el criterio de fecha para nominar documentos para su eliminación.

      El valor mínimo es 7, el valor máximo es 9215.

  • Región de proceso de datos

    Uno de:
  • en pausa booleano

    Indicador que indica si este archivo en línea está en pausa. La solicitud de reanudación falla si la colección tiene otro archivo en línea activo. Para pausar un archivo en línea activo o reanudar uno pausado, debe incluir este parámetro. Para pausar un archivo activo, establézcalo en "true". Para reanudar un archivo pausado, establézcalo en "false".

  • horario Objeto

    Uno de:

Respuestas

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

    Vale

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • _id string

      Cadena de dígitos hexadecimales 24única que identifica el archivo en línea.

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

    • nombre del clúster string

      Etiqueta legible por humanos que identifica el clúster que contiene la colección para la que desea crear un archivo en línea.

      El formato debe coincidir con el siguiente patrón: ^[a-zA-Z0-9][a-zA-Z0-9-]*$.

    • nombreColl string

      Etiqueta legible por humanos que identifica la colección para la que creó el archivo en línea.

    • tipo de colección string

      Clasificación de la colección de bases de datos MongoDB que desea devolver.

      Si establece este parámetro en TIMESERIES, establezca "criteria.type" : "date" y "criteria.dateFormat" : "ISODATE".

      Los valores son TIMESERIES o STANDARD. El valor predeterminado es STANDARD.

    • criterios Objeto

      Uno de:
    • dataExpirationRule Objeto

      Regla para especificar cuándo se deben eliminar los datos del archivo.

      Ocultar el atributo dataExpirationRule Mostrar el atributo dataExpirationRule Objeto
      • expirarDespuésDeDías integer(int32)

        Número de días utilizados en el criterio de fecha para nominar documentos para su eliminación.

        El valor mínimo es 7, el valor máximo es 9215.

    • Región de proceso de datos Objeto

      Uno de:
    • dataSetName string

      Etiqueta legible por humanos que identifica el conjunto de datos que Atlas genera para este archivo en línea.

    • dbName string

      Etiqueta legible por humanos de la base de datos que contiene la colección que contiene el archivo en línea.

    • ID de grupo string

      Cadena hexadecimal única 24que identifica el proyecto que contiene el clúster especificado. El clúster especificado contiene la colección para la que se creará el archivo en línea.

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

    • campos de partición matriz[objeto]

      Lista que contiene los parámetros del documento para dividir lógicamente los datos dentro de una colección. Las particiones proporcionan un nivel de filtrado general de los datos subyacentes de la colección. Para dividir los datos, especifique los parámetros que consulta con frecuencia. Si especificó criteria.type: DATE en el punto de conexión "Crear un Archivo Online", puede especificar hasta tres parámetros para la consulta. Uno de estos parámetros debe ser el valor DATE, que es obligatorio en este caso. Si especificó criteria.type: CUSTOM en el punto de conexión "Crear un Archivo Online", puede especificar hasta dos parámetros para la consulta. Las consultas que no utilizan los parámetros criteria.type: DATE o criteria.type: CUSTOM hacen que MongoDB escanee una colección completa de todos los documentos archivados. Esto requiere más tiempo y aumenta los costos.

      Metadatos para particionar este archivo en línea.

      Al menos 1 elemento.

      Ocultar atributos de partitionFields Mostrar atributos de partitionFields Objeto
      • nombre del campo string Requerido

        Etiqueta legible que identifica el parámetro que MongoDB Cloud utiliza para particionar los datos. Para especificar un parámetro anidado, utilice la notación de punto.

        La longitud máxima es 700.

      • tipo de campo string

        Tipo de dato del parámetro que utiliza MongoDB nube para particionar los datos. Los parámetros de partición de tipo UUID deben ser de subtipo binario 4. MongoDB nube omite los parámetros de partición de tipo UUID con subtipo 3.

        Los valores son date, int, long, objectId, string o uuid.

        UUID
      • orden integer(int32) Requerido

        Secuencia en la que MongoDB Cloud segmenta los datos de la colección para crear particiones. El recurso expresa esta secuencia comenzando por cero. El valor del parámetro criteria.dateField es, por defecto, el primer elemento de la secuencia de particiones.

        El valor predeterminado es 0.

    • en pausa booleano

      Indicador que indica si este archivo en línea está en pausa. La solicitud de reanudación falla si la colección tiene otro archivo en línea activo. Para pausar un archivo en línea activo o reanudar uno pausado, debe incluir este parámetro. Para pausar un archivo activo, establézcalo en "true". Para reanudar un archivo pausado, establézcalo en "false".

    • horario Objeto

      Uno de:
    • Estado string

      Fase del proceso para crear este archivo en línea cuando usted realizó esta solicitud.

      Estado Indicación
      PENDING MongoDB Cloud ha puesto documentos en cola para archivar. El archivado no ha comenzado.
      ARCHIVING MongoDB Cloud comenzó a archivar documentos que cumplen con los criterios de archivo.
      IDLE MongoDB Cloud espera para iniciar el próximo trabajo de archivado.
      PAUSING Alguien decidió detener el archivado. MongoDB Cloud finaliza el trabajo de archivado en ejecución y cambia el estado a PAUSED al completarse.
      PAUSED MongoDB Nube ha dejado de archivar. Se pueden consultar documentos archivados. La operación de archivado especificada en el clúster activo no puede archivar documentos adicionales. Puedes reanudar el archivado de los ficheros pausados en cualquier momento.
      ORPHANED Alguien ha eliminado la colección asociada a un archivo activo o en pausa. MongoDB Cloud no elimina los datos archivados. Debe eliminar manualmente los archivos en línea asociados a la colección eliminada.
      DELETED Alguien eliminó el archivo. Cuando alguien elimina un archivo en línea, MongoDB Cloud elimina todos los documentos archivados asociados del almacenamiento de objetos en la nube.

      Los valores son PENDING, ACTIVE, PAUSING, PAUSED, DELETED o ORPHANED.

  • 400 aplicación/json

    Solicitud incorrecta.

    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.

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

  • 409 aplicación/json

    Conflicto.

    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.

PATCH /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/onlineArchives/{archiveId}
atlas api onlineArchive updateOnlineArchive --help
import (
	"os"
	"context"
	"log"
	sdk "go.mongodb.org/atlas-sdk/v20230201001/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.UpdateGroupClusterOnlineArchiveApiParams{}
	sdkResp, httpResp, err := client.OnlineArchiveApi.
		UpdateGroupClusterOnlineArchiveWithParams(ctx, params).
		Execute()
}
curl --include --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "Accept: application/vnd.atlas.2023-02-01+json" \
  --header "Content-Type: application/json" \
  -X PATCH "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/onlineArchives/{archiveId}" \
  -d '{ <Payload> }'
curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \
  --digest --include \
  --header "Accept: application/vnd.atlas.2023-02-01+json" \
  --header "Content-Type: application/json" \
  -X PATCH "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/onlineArchives/{archiveId}" \
  -d '{ <Payload> }'
Solicitar ejemplos
{
  "criteria": {
    "type": "CUSTOM",
    "query": "string"
  },
  "dataExpirationRule": {
    "expireAfterDays": 42
  },
  "dataProcessRegion": {
    "cloudProvider": "AWS"
  },
  "paused": true,
  "schedule": {
    "type": "DEFAULT"
  }
}
Ejemplos de respuestas (200)
{
  "_id": "32b6e34b3d91647abb20e7b8",
  "clusterName": "string",
  "collName": "string",
  "collectionType": "STANDARD",
  "criteria": {
    "type": "CUSTOM",
    "query": "string"
  },
  "dataExpirationRule": {
    "expireAfterDays": 42
  },
  "dataProcessRegion": {
    "cloudProvider": "AWS",
    "region": "US_EAST_1"
  },
  "dataSetName": "string",
  "dbName": "string",
  "groupId": "32b6e34b3d91647abb20e7b8",
  "partitionFields": [
    {
      "fieldName": "string",
      "fieldType": "date",
      "order": 0
    }
  ],
  "paused": true,
  "schedule": {
    "type": "DEFAULT"
  },
  "state": "PENDING"
}
Ejemplos de respuestas (400)
{
  "error": 400,
  "detail": "(This is just an example, the exception may not be related to this endpoint) No provider AWS exists.",
  "reason": "Bad Request",
  "errorCode": "VALIDATION_ERROR"
}
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 (409)
{
  "error": 409,
  "detail": "(This is just an example, the exception may not be related to this endpoint) Cannot delete organization link while there is active migration in following project ids: 60c4fd418ebe251047c50554",
  "reason": "Conflict",
  "errorCode": "CANNOT_DELETE_ORG_ACTIVE_LIVE_MIGRATION_ATLAS_ORG_LINK"
}
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"
}