License Operator HTTP API

This feature requires Nomad Enterprise(opens in new tab).

Get Nomad Enterprise License Info

This endpoint gets information about the current license.

Method	Path	Produces
`GET`	`/v1/operator/license`	`application/json`

The table below shows this endpoint's support for blocking queries and required ACLs.

Blocking Queries	ACL Required
`NO`	`operator:read`

Sample Request

$ curl \    https://localhost:4646/v1/operator/license

Sample Response

{  "KnownLeader": false,  "LastContact": 0,  "LastIndex": 0,  "License": {    "CustomerID": "temporary license customer",    "ExpirationTime": "2020-06-01T14:50:16.581304556-04:00",    "Features": [      "Automated Upgrades",      "Enhanced Read Scalability",      "Redundancy Zones",      "Namespaces",      "Resource Quotas",      "Preemption",      "Audit Logging",      "Setinel Policies"    ],    "Flags": {      "modules": ["governance-policy"]    },    "InstallationID": "*",    "IssueTime": "2020-06-01T08:50:16.581304556-04:00",    "LicenseID": "temporary-license",    "Modules": ["governance-policy"],    "Product": "nomad",    "StartTime": "2020-06-01T08:50:16.581304556-04:00",    "TerminationTime": "2020-06-01T14:50:16.581304556-04:00"  },  "RequestTime": 0}

Updating the Nomad Enterprise License

This endpoint updates the Nomad license.

Method	Path	Produces
`PUT`	`/v1/operator/license`	`application/json`

The table below shows this endpoint's support for blocking queries and required ACLs.

Blocking Queries	ACL Required
`NO`	`operator:write`

Sample Payload

The payload is the raw license blob.

Sample Request

$ curl \    --request PUT \    --data @nomad.license \    https://localhost:4646/v1/operator/license

Sample Response

{  "Index": 15}