Get aggregate optimization stats for all Entitlements

Prev Next
Get
/entitlements/optimization/stats

Returns aggregate counts of Entitlements grouped by optimization score, used to power dashboard widgets. Requires the Optimizer licensed feature.

Security
HTTP
Type bearer
Responses
200

Aggregate optimizer stats.

Expand All
object

Aggregate counts of Entitlements grouped by optimization score.

total
integer

Total number of Entitlements considered by the optimizer.

Example42
optimizedPercent
integer

Percentage of Entitlements currently considered optimized.

Minimum0
Maximum100
Example71
optimized
integer

Number of Entitlements whose access aligns with observed usage.

Example30
overprovisioned
integer

Number of Entitlements granting more access than is being used.

Example5
unused
integer

Number of Entitlements with no observed usage.

Example4
unlinked
integer

Number of Entitlements that could not be correlated with observed traffic.

Example2
insufficientData
integer

Number of Entitlements with insufficient usage data to evaluate.

Example1
notInUse
integer

Number of Entitlements that are disabled.

Example0
graphData
Array of object

Daily optimized-percent samples for graph visualization, one entry per day for the last 30 days. daysAgo is the X axis (0 = today, 30 = 30 days ago); percent is the Y axis (the optimized percentage on that day).

object
daysAgo
integer

Number of days before today this sample represents.

Minimum0
Maximum30
Example0
percent
integer

Percentage of Entitlements considered optimized on that day.

Minimum0
Maximum100
Example71
401

Token error. Login again.

object

Generic HTTP error.

id
string

Machine readable error code.

message
string

Human readable error details.

402

Insufficient license.

object

Generic HTTP error.

id
string

Machine readable error code.

message
string

Human readable error details.

403

Insufficient permissions to access this resource.

object

Generic HTTP error.

id
string

Machine readable error code.

message
string

Human readable error details.

404

The requested resource can not be found.

object

Generic HTTP error.

id
string

Machine readable error code.

message
string

Human readable error details.

406

Invalid 'Accept' header.

object

Generic HTTP error.

id
string

Machine readable error code.

message
string

Human readable error details.

412

Precondition failed. ZTP is not registered or Optimizer is not enabled.

object

Generic HTTP error.

id
string

Machine readable error code.

message
string

Human readable error details.

500

Unexpected server side error.

object

Generic HTTP error.

id
string

Machine readable error code.

message
string

Human readable error details.