Inline1

Inline1
Inline1

Body of the 409 answer that asks for confirmation. Nothing was changed; the same import with confirmDowngrade=true installs the file. The resulting fields describe the pool as it would be afterwards.

JSON Example
{
    "errorCode": "string",
    "message": "string",
    "serialNumber": "string",
    "installed": {
        "cores": 0,
        "validFrom": "string",
        "validTo": "string"
    },
    "incoming": {
        "cores": 0,
        "validFrom": "string",
        "validTo": "string"
    },
    "reasons": [
        "string"
    ],
    "resultingState": "string",
    "resultingRestricted": false,
    "resultingOverCapacity": false,
    "resultingEntitledCores": 0,
    "consumedCores": 0
}
string
errorCode
Required  

Always LICENSE_UPDATE_REQUIRED_CONFIRMATION

string
message
Required  

Human-readable explanation that confirmation is required

string
serialNumber
Required  

Serial number of the installed license the file would replace

object
installed
Required  

The entitlement a license file carries

object
incoming
Required  

The entitlement a license file carries

array of string
reasons
Required  

Why confirmation is required; one or both of LOWER_CORES and EARLIER_EXPIRY

Enumeration: LOWER_CORES, EARLIER_EXPIRY
string
resultingState
Required  

Overall console licensing lifecycle state

  • NO_LICENSE: No license is ACTIVE and none has ever been valid
  • NOT_YET_VALID: No longer produced: validFrom is informational, so a license counts from the day it is installed. Kept so clients and the telemetry report still recognise the value
  • ACTIVE: At least one license is ACTIVE and the farthest-expiring one has more than 30 days left
  • EXPIRING: At least one license is ACTIVE but the farthest-expiring one has 30 days or fewer left
  • GRACE: No license is ACTIVE although one has been valid before, and the grace period of 7 days after its last valid day has not ended
  • RESTRICTED: No license is ACTIVE although one has been valid before, and the grace period has ended; restricted is true
Enumeration: NO_LICENSE, NOT_YET_VALID, ACTIVE, EXPIRING, GRACE, RESTRICTED
boolean
resultingRestricted
Required  

True when the console would be restricted after the replacement

boolean
resultingOverCapacity
Required  

True when consumed cores would exceed the pool after the replacement

integer As int64 As int64
resultingEntitledCores
Required  

Cores in the pool after the replacement

integer As int64 As int64
consumedCores
Required  

Cores the registered hosts consume now

Used By