Skip to main content

GET – License Properties

Use the GET method to retrieve the XCC_Advanced/XCC_Enterprised info.

Request URL​

GET https://<BMC_IPADDR>/redfish/v1/LicenseService/Licenses/XCC_Advanced|XCC_Enterprised

Request body​

None

Response body​

Field

Type

Description

Id

String

“XCC_Advanced” or “XCC_Enterprised”

Name

String

“Lenovo XClarity Controller Advanced Upgrade ” or “Lenovo XClarity Controller Enterprise Upgrade ”

Description

String

“This resource is used to represent a license for a Redfish implementation.”

LicenseType

String

“Production”

LicenseOrigin

String

“Installed” or “BuiltIn”

ExpirationDate

String

The expiration date of the license.

If no constraints, show “null”

Removable

Boolean

The value is true, if "LincenseOrigin" equals to "Installed";

The value is false if "LincenseOrigin" equals to "BuiltIn".

Manufacturer

String

“Lenovo”

LicenseString

String

null

EntitlementId

String

Machine type plus Serial No.

AuthorizationScope

String

“Service”

RemainingUseCount

Integer

always 0

DownloadURI

String

"/LicenseDownload/license_XCC_Advanced" or “/LicenseDownload/license_ XCC_Enterprised”

Status

Object

Expanded

 

State

String

Mapping with Key status

0 : “Enabled”;

others: “Disabled”

 

Health

String

“OK”

Links

Object

Expanded

 

AuthorizedDevices

Link

empty

Status code​

HTTP Status CodeError Message ID
400BadRequest
500InternalError

Example​

The following example JSON response is returned:

XCC_Advanced license:

{
    "Links": {
        "AuthorizedDevices": []
    },
    "Oem": {
        "Lenovo": {
            "DescTypeCode": 52,
            "IdTypes": [
                "MTSN"
            ],
            "@odata.type": "#LenovoLicense.v1_0_0.LenovoLicense"
        }
    },
    "AuthorizationScope": "Service",
    "Manufacturer": "Lenovo",
    "Name": "Lenovo XClarity Controller Advanced Upgrade",
    "@odata.type": "#License.v1_0_0.License",
    "Status": {
        "State": "Enabled",
        "Health": "OK"
    },
    "LicenseOrigin": "Installed",
    "RemainingUseCount": 0,
    "LicenseType": "Production",
    "@odata.context": "/redfish/v1/$metadata#License.License",
    "@odata.etag": "\"61949b8df02528abb0a\"",
    "Description": "This resource is used to represent a license for a Redfish implementation.",
    "Removable": true,
    "EntitlementId": "7Z721234567890",
    "@odata.id": "/redfish/v1/LicenseService/Licenses/XCC_Advanced",
    "LicenseString": null,
    "Id": "XCC_Advanced",
    "DownloadURI": "/LicenseDownload/license_XCC_Advanced"
}

XCC_Enterprised license:

{
    "Links": {
        "AuthorizedDevices": []
    },
    "Oem": {
        "Lenovo": {
            "DescTypeCode": 53,
            "IdTypes": [
                "MTSN"
            ],
            "@odata.type": "#LenovoLicense.v1_0_0.LenovoLicense"
        }
    },
    "Removable": true,
    "EntitlementId": "7Z721234567890",
    "Id": "XCC_Enterprised",
    "Name": "Lenovo XClarity Controller Enterprise Upgrade",
    "@odata.type": "#License.v1_0_0.License",
    "@odata.id": "/redfish/v1/LicenseService/Licenses/XCC_Enterprised",
    "DownloadURI": "/LicenseDownload/license_XCC_Enterprised",
    "@odata.context": "/redfish/v1/$metadata#License.License",
    "Manufacturer": "Lenovo",
    "@odata.etag": "\"63f3a04a2c28296c963\"",
    "LicenseOrigin": "Installed",
    "RemainingUseCount": 0,
    "LicenseType": "Production",
    "Status": {
        "State": "Enabled",
        "Health": "OK"
    },
    "Description": "This resource is used to represent a license for a Redfish implementation.",
    "AuthorizationScope": "Service",
    "LicenseString": null
}