Devolver todos los ficheros en línea para un clúster

OBTENER /api/atlas/v1.0/groups/{groupId}/clusters/{clusterName}/onlineArchives

Retorna detalles de todos los ficheros en linea. Este fichero almacena datos de un clúster dentro de un Proyecto. Para usar este recurso, la Cuenta de servicio o la clave API que realiza la solicitud debe tener el rol de solo lectura del proyecto.

Archivo en línea

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

  • Nombre del clúster string Requerido

    Etiqueta leíble por humanos que identifica el clúster que contiene la colección para la que deseas devolver los ficheros en linea.

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

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.

  • includeCount booleano

    Bandera que indica si la respuesta devuelve el número total de elementos (totalCount) en la respuesta.

    El valor por defecto es true.

  • elementosPorPágina entero

    Número de elementos que la respuesta retorna por página.

    El valor mínimo es 1, el valor máximo es 500. El valor predeterminado es 100.

  • Num. de pág. entero

    Número de la página que muestra el conjunto actual del total de objetos que devuelve la respuesta.

    El valor mínimo es 1. El valor por defecto es 1.

  • 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
    • Resultados arreglo[objeto] Requerido

      Lista de documentos devueltos que MongoDB nube proporciona al completar esta solicitud.

      Ocultar atributos de resultados Mostrar atributos de resultados Objeto
      • _id string

        String única de 24dígitos hexadecimales que identifica el fichero en linea.

        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-]*$.

      • collName string

        Etiqueta legible por humanos que identifica la colección para la cual creaste el fichero en línea.

      • TipoDeColección string

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

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

        Los valores son TIMESERIES o STANDARD. El valor por defecto es STANDARD.

      • criterios Objeto

        Uno de:
      • dataExpirationRule Objeto

        Regla para especificar cuándo se deben borrar los datos del fichero.

        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.

      • dataProcessRegion Objeto

        Uno de:
      • dataSetName string

        Etiqueta legible por humanos que identifica el conjunto de datos que Atlas genera para este fichero en linea.

      • dbName string

        Etiqueta legible por humanos de la base de datos que contiene la colección que contiene el fichero en linea.

      • ID del 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 arreglo[objeto]

        Lista que contiene parámetros de documentos para usarlos en una división lógica de datos dentro de una colección. Las particiones proporcionan un nivel áspero de filtrado de los datos de la colección subyacente. Para dividir tus datos, especifica los parámetros que consultas con frecuencia. Si has especificado criteria.type: DATE en el endpoint Crear un fichero en línea, entonces puedes especificar hasta tres parámetros por los que query. Uno de estos parámetros debe ser el valor DATE, que es obligatorio en este caso. Si especificaste criteria.type: CUSTOM en el endpoint Crear un fichero en línea, entonces puedes especificar hasta dos parámetros por los que hacer la query. Las queries que no utilicen los parámetros criteria.type: DATE o criteria.type: CUSTOM hacen que MongoDB escanee toda la colección de todos los documentos archivados. Esto toma más tiempo y aumenta tus costos.

        At least 1 element.

        Ocultar atributos de partitionFields Mostrar atributos de partitionFields Objeto

        Metadatos para particionar este fichero en línea.

        • Nombre de campo string Requerido

          Etiqueta legible por humanos que identifica el parámetro que MongoDB Cloud utiliza para particionar datos. Para especificar un parámetro anidado, use la notación de puntos.

          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 Nube divide los datos de la colección para crear particiones. El recurso expresa esta secuencia comenzando con cero. El valor del parámetro criteria.dateField se establece por defecto como el primer elemento en la secuencia de partición.

          El valor por defecto 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".

      • cronograma Objeto

        Uno de:
      • Estado string

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

        Estado Indicación
        PENDING MongoDB Cloud ha puesto en cola documentos para el fichero. El fichero no ha comenzado.
        ARCHIVING MongoDB Cloud comenzó a archivar documentos que cumplen con los criterios de archivo.
        IDLE MongoDB Cloud espera para iniciar la siguiente tarea de archivo.
        PAUSING Alguien optó por dejar de hacer un fichero. MongoDB Cloud finaliza la tarea de archivado en curso y luego cambia el estado a PAUSED cuando esa tarea se completa.
        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 borrado la colección asociada con un fichero activo o en pausa. MongoDB nube no borra los datos archivados. Debe borrar manualmente los ficheros en línea asociados con la colección borrada.
        DELETED Alguien ha borrado el fichero. Cuando alguien elimina un fichero 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.

    • recuento total integer(int32)

      Número total de documentos disponibles. MongoDB Cloud omite este valor si includeCount está configurado en false. El número total es una estimación y puede no ser exacto.

      El valor mínimo es 0.

  • 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}/clusters/{clusterName}/onlineArchives
curl \
 --request GET 'https://cloud.mongodb.com/api/atlas/v1.0/groups/32b6e34b3d91647abb20e7b8/clusters/{clusterName}/onlineArchives' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Ejemplos de respuestas (200)
{
  "links": [
    {
      "href": "https://cloud.mongodb.com/api/atlas",
      "rel": "self"
    }
  ],
  "results": [
    {
      "_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"
    }
  ],
  "totalCount": 42
}
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"
}