Utiliza este punto de acceso para descargar un .tar.gz fichero que contenga todas las entradas de registro que Ops Manager recolectó para la tarea especificada. No se puede descargar de una tarea cuyo estado es IN_PROGRESS o EXPIRED. Si una tarea falla parcialmente, el fichero solo incluye las entradas de registro que Ops Manager recogió con éxito.
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
GET /admin/omLogCollectionJobs/{JOB-ID}:downloadRoles necesarios
Requiere que la clave de API que llama a este endpoint tenga el rol de Global Read Only.
Request Parameters
Parámetros de ruta de solicitud
Nombre | Tipo | Necesidad | Descripción |
|---|---|---|---|
| string | Requerido | string única de 24dígitos hexadecimales que identifica la tarea de colección de registros del servidor Ops Manager. Para encontrar un ID de trabajo, llama a Obtener todos los trabajos de colección de registros del servidor de Ops Manager. |
Parámetros de Solicitud Query
Los siguientes parámetros de query son opcionales:
Nombre | Tipo | Necesidad | Descripción | predeterminado |
|---|---|---|---|---|
bonito | booleano | Opcional | Indicador que muestra si el cuerpo de la respuesta está en formato pretty-print. |
|
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 ni al código de estado. Para solucionar esto, ajusta envelope=true en la query. Para los endpoints que devuelven un resultado, el cuerpo de la respuesta incluye:
|
|
Parámetros del cuerpo de la solicitud
Este endpoint no utiliza parámetros de cuerpo de solicitud HTTP.
Respuesta
Este endpoint devuelve un flujo binary con Content-Type: application/gzip y el formato de nombre de archivo om-logs_{timestamp}.tar.gz. El fichero utiliza la siguiente distribución:
om-server-1.example.com/ application/ mms0.log mms0.20260412.log http_access/ mms0-access.log migration/ mms-migration.logom-server-2.example.com/ application/ mms0.log http_access/ mms0-access.log mms0-access.20260412.logdaemon-host-1.example.com/ daemon/ daemon-hosted.log daemon-hosted.20260816.log.gzdaemon-host-2.example.com/ daemon/ daemon-hosted.log daemon-hosted.20260815.log.gzImportante
Cuando llame a este endpoint con curl, debe pasar --output y un nombre de archivo. De lo contrario, curl escribe el archivo binary en tu terminal.
Solicitud de ejemplo
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/gzip" \ --output om-logs.tar.gz \ --request GET \ "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/omLogCollectionJobs/{JOB-ID}:download"Respuesta de ejemplo
Encabezado de respuesta
HTTP/1.1 401 UnauthorizedContent-Type: application/json;charset=ISO-8859-1Date: {dateInUnixFormat}WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=falseContent-Length: {requestLengthInBytes}Connection: keep-aliveHTTP/1.1 200 OKVary: Accept-EncodingContent-Type: application/gzipContent-Disposition: attachment; filename="om-logs_{timestamp}.tar.gz"Strict-Transport-Security: max-age=300Date: {dateInUnixFormat}Connection: keep-aliveContent-Length: {requestLengthInBytes}X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}Respuesta del cuerpo
Este extremo no devuelve un cuerpo de respuesta JSON.