Utilice este endpoint para descargar un .tar.gz fichero que contiene cada entrada de registro que Ops Manager recopiló para la tarea especificada. No puede descargar de una tarea cuya situación sea IN_PROGRESS o EXPIRED. Si un trabajo falla parcialmente, el archivo sólo incluye los archivos de registro que Ops Manager recogió correctamente.
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
GET /admin/omLogCollectionJobs/{JOB-ID}:download
Roles necesarios
Requiere que el La API Key que llama a este endpoint tiene la
Global Read Only rol.
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 señala si el cuerpo de la respuesta debe estar en un pretty-print formato. |
| ||||||
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.log om-server-2.example.com/ application/ mms0.log http_access/ mms0-access.log mms0-access.20260412.log
Importante
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
401 Unauthorized Content-Type: application/json;charset=ISO-8859-1 Date: {dateInUnixFormat} WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false Content-Length: {requestLengthInBytes} Connection: keep-alive
200 OK Vary: Accept-Encoding Content-Type: application/gzip Content-Disposition: attachment; filename="om-logs_{timestamp}.tar.gz" Strict-Transport-Security: max-age=300 Date: {dateInUnixFormat} Connection: keep-alive Content-Length: {requestLengthInBytes} X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
Respuesta del cuerpo
Este extremo no devuelve un cuerpo de respuesta JSON.