/cert-manager/cert-inventory/alert-threshold

put

https://helios.cohesity.com/v2/cert-manager/cert-inventory/alert-threshold

Updates alert-threshold overrides using partial-update semantics. Top-level keys absent from the request body are preserved unchanged. When byCertId or byCategory is present, the entire map is replaced (not merged per key); to change one entry without dropping others, GET the current config, merge client-side, then PUT. To clear a section, send it as an empty object ("byCertId":{}, "byCategory":{}, or "global":{}). The three override scopes form a hierarchical precedence chain applied at alert time -- byCertId (most specific), then byCategory, then global, then built-in defaults (15/10/5). Constraints: criticalPercent < warningPercent < infoPercent, each in range [1, 50].

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Alert threshold override configuration. Omit top-level keys you do not want to change. When byCertId or byCategory is included, supply the full map you want stored.

Hierarchical alert-threshold override configuration for certificate expiry alerts. The three scopes coexist and form a precedence chain applied when evaluating each certificate: byCertId (highest priority, matches a specific certificate ID), then byCategory (matches all certificates in a category like ClusterCertificate), then global (cluster-wide default), then built-in defaults (15/10/5). All three scopes share the same ThresholdEntry shape because the data (info/warning/critical percents) is identical at every scope -- only the set of certificates each scope applies to differs. In GET responses, global is always present; byCertId and byCategory are only present when overrides exist. In PUT requests, only include the scopes you want to update.

byCategory

object | null

Per-category overrides keyed by certificate category string (e.g. ClusterCertificate, CodeSigningCertificate). Applied when no byCertId match exists. Omitted in GET when no per-category overrides exist. Send empty object {} in PUT to clear all per-category overrides.

byCertId

object | null

Per-certificate overrides keyed by certificate inventory ID. Highest priority -- if a certificate ID matches an entry here, these thresholds are used regardless of byCategory or global. Omitted in GET when no per-cert overrides exist. Send empty object {} in PUT to clear all per-cert overrides.

global

object | null

Cluster-wide default thresholds, applied when no byCertId or byCategory match exists. Always present in GET responses (built-in defaults 15/10/5 if no override is stored). In PUT, omit to preserve current value, or send an empty object {} to clear the override and revert to built-in defaults.

Headers

accessClusterId

int64

This field uniquely represents a Cohesity Cluster and is used for making on-prem calls from Helios.

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Success

defaultError