Habilita o deshabilita la recopilación de telemetría para tu instalación de Ops Manager.
Importante
Empezando en Ops Manager 9.0.2 y 8.0.28, este endpoint activa o desactiva la telemetría de uso del producto. Desactivarlo requiere una exención activa de telemetría en la clave de licencia instalada. Ops Manager comprueba la clave de licencia en cada solicitud. Para saber cómo solicitar una exención, consulta Exención de Telemetría.
Roles necesarios
Este punto terminal requiere una clave API que tenga el rol Global Owner.
Endpoint
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/private/v1.0/telemetry
PATCH /collection/statusSolicitud
Parámetros de ruta
Este endpoint no utiliza parámetros de ruta de solicitud HTTP.
Parámetros de query
Este punto final no utiliza parámetros de query de solicitudes HTTP.
Parámetros del cuerpo
Nombre | Tipo | Necesidad | Descripción |
|---|---|---|---|
habilitado | booleano | Requerido | Configura en |
Respuesta
Documento de respuesta
Este endpoint devuelve un objeto JSON vacío.
Solicitud de ejemplo
curl --user "{publicApiKey}:{privateApiKey}" --digest \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --include \ --request PATCH "https://<OpsManagerHost>:<Port>/api/private/v1.0/telemetry/collection/status" \ --data '{"enabled": false}'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 400 Bad RequestContent-Type: application/json;charset=ISO-8859-1Date: {dateInUnixFormat}X-MongoDB-Service-Version: gitHash={gitHash};versionString={ApplicationVersion}Content-Length: {requestLengthInBytes}HTTP/1.1 200 OKVary: Accept-EncodingContent-Type: application/jsonStrict-Transport-Security: max-age=300Date: {dateInUnixFormat}Connection: keep-aliveContent-Length: {requestLengthInBytes}X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}Respuesta del cuerpo
{}403 Respuesta sin exención
Esta sección se aplica al Jefe de Operaciones 9.0.2, 8.0.28, y posteriores.
Si desactivas la telemetría de uso de producto sin una exención activa de telemetría en la clave de licencia instalada, el endpoint devuelve un error de 403 y no realiza ningún cambio. El cuerpo del error dice:
{ "details": "Product usage collection requires a license telemetry exemption", "error": "Forbidden" }El endpoint Retrieve Telemetry Data sigue informando "enabled": true. Con una excepción activa, la solicitud tiene éxito y devuelve un objeto JSON vacío ({}).