Ampliar una tarea de recolección de registros

Nota

Grupos y proyectos son términos sinónimos. Su {PROJECT-ID} es el mismo que su ID del grupo. Para los grupos existentes, el ID del grupo se mantiene igual. Esta página utiliza el término más familiar grupo cuando se refiere a descripciones. El endpoint permanece tal como se indica en el documento.

Cuando se crea una tarea de colección de registros, el Ops Manager inicia una tarea en segundo plano para descargar los registros de la implementación específica de Ops Manager. Cada tarea se crea con una fecha de vencimiento específica. Utiliza este endpoint para ampliar la fecha de caducidad de una tarea existente de recopilación de registros.

No puedes ampliar la duración de las tareas de recopilación de registros que ya hayan expirado.

URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

Resource

PATCH /groups/{GROUP-ID}/logCollectionJobs/{JOB-ID}

Parámetros de ruta de solicitud

Nombre	Tipo	Necesidad	Descripción
ID del grupo	string	Requerido	Cadena única de 24 dígitos hexadecimales que identifica la tarea de solicitud de colección de registros.
JOB-ID	string	Requerido	string única de 24 dígitos hexadecimales que identifica la tarea de colección de registros a reintentar. Utilice el endpoint Obtener todos los trabajos de recolección de registros de un Proyecto para obtener los ID asociados a su Proyecto.

Parámetros de Solicitud Query

Los siguientes parámetros de query son opcionales:

Nombre	Tipo	Necesidad	Descripción	predeterminado
bonito	booleano	Opcional	Indicador que especifica si el cuerpo de la respuesta está en formato legible.	`false`
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: `status`: Código de respuesta HTTP `content`: Cuerpo de respuesta esperado	`false`

Parámetros del cuerpo de la solicitud

Nombre	Tipo	Necesidad	Descripción
expirationDate	string	Requerido	Marca de tiempo, en segundos transcurridos desde la época UNIX en la que expira esta tarea. Puede ser de hasta 6 25 meses desde la creación de la tarea. No se puede especificar una fecha anterior a la de la solicitud.

Respuesta

Este endpoint no devuelve un cuerpo de respuesta.

Solicitud de ejemplo

1 curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
2      --header "Accept: application/json" \
3      --header "Content-Type: application/json" \
4      --include \
5      --request PATCH "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/logCollectionJobs/{JOB-ID}?pretty=true" \
6      --data '
7       {
8         "expirationDate": "2019-04-06T12:02:54Z"
9       }'

Respuesta de ejemplo

Encabezado de respuesta

HTTP/1.1 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

HTTP/1.1 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.

Volver

Crear

Volver a intentar

1	curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
2	--header "Accept: application/json" \
3	--header "Content-Type: application/json" \
4	--include \
5	--request PATCH "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/logCollectionJobs/{JOB-ID}?pretty=true" \
6	--data '
7	{
8	"expirationDate": "2019-04-06T12:02:54Z"
9	}'