Ops Manager establece la expiración por defecto de cada tarea a 7 días a partir de la fecha de creación de la tarea. Utiliza este endpoint para extender la caducidad de una tarea existente. La nueva fecha de vencimiento no debe ser posterior a 28 días de la fecha de creación original. No puedes extender una tarea que ya ha expirado.
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
PATCH /admin/omLogCollectionJobs/{JOB-ID}
Roles necesarios
Requiere que la clave API que llame a este endpoint tenga el rol Global Owner.
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 debe estar en formato prettyprint. |
| ||||||
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
Nombre | Tipo | Necesidad | Descripción |
|---|---|---|---|
| string | Requerido | Nueva marca de tiempo de expiración, en formato ISO 8601 UTC. La marca de tiempo no debe superar los 28 días posteriores a la fecha de creación de la tarea ni ser anterior a la hora de la solicitud. |
Respuesta
Este endpoint no devuelve un cuerpo de respuesta.
Solicitud de ejemplo
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --include \ --request PATCH \ "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/omLogCollectionJobs/{JOB-ID}?pretty=true" \ --data '{ "expirationDate": "2026-04-27T10:00:00Z" }'
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/json 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 endpoint no devuelve un cuerpo de respuesta.