Skip to main content

GET /profiles

Use this method to return information about server profiles from the Lenovo XClarity Administrator.

Authentication

Authentication with username and password is required.

Request URL

GET https://{management_server_IP}/profiles

Query parameters

None

Response codes

CodeDescriptionComments
200OKThe request completed successfully.
403ForbiddenThe orchestrator server was prevented from fulfilling the request. A descriptive error message is returned in the response body. Ensure that you have privileges to perform the request.

For XClarity Administrator advanced functions, ensure that you have active licenses for each managed server that supports the advanced functions.

500Internal Server ErrorAn internal error occurred. A descriptive error message is returned in the response body.

Response body

AttributesTypeDescription
identifierStringAlways set to "id"
labelStringAlways set to "id"
itemsArray of objectsInformation about each server profile
 addressPresentBooleanIdentifies whether address pools are used. This can be one of the following values.
  • true. Address pools are used.
  • false. Address pools are not used.
 bayIdStringID of the bay in the chassis in which the server is installed, if applicable

For a rack server, this value is empty.

 chassisNameStringChassis in which the server is installed, if applicable

For a rack server, this value is empty.

 complianceStatusStringCompliance status. This can be one of the following values.
  • valid : Server settings are compliant with the profile

  • invalid : Server settings are Non-compliant with the profile

  • none : Compliance has not been calculated because pattern is still activated, pending or inactive

 externalIdStringID of the server or bay to which the profile is deployed
 idStringUnique ID of the profile
 managementPatternPresentBooleanIdentifies whether a management-interface pattern is used. This can be one of the following values.
  • true. A management-interface pattern is used.
  • false. A management-interface pattern is not used.
 profileNameStringName of the server profile
 profileStatusStringCurrent status of the profile. This can be one of the following values.
  • ASSIGNED. The profile is assigned to the server.
  • UNASSIGNED. The profile in not assigned to any server.
  • PENDING_ACTIVATION. The profile is created and targeted to a server but has not been activated yet.
  • ACTIVATING. The profile is currently being activated on the targeted server
  • ERROR_ACTIVATING. There was an error while activating the profile on the targeted server.
 rackIDStringID of the rack that contains the server to which the profile is deployed
 serverNameStringName of the server to which the profile is deployed
 subBayIdStringID of the sub-bay in the chassis in which the server is installed, if the server is a Flex System x222 Compute Node

For all other servers, this value is empty.

 templateIDStringID of the server pattern that was used to create the profile
 templateNameStringName of the server pattern that was used to create the profile
 typeStringInternal use only
 unitIntegerID of the unit that contains the server to which the profile is deployed
 uuidStringUUID of the server to which the profile is deployed
The following example is returned if the request is successful.
{
"identifier": "id",
"label": "id",
"items": [{
"addressPresent": false,
"bayId": "12",
"chassisName": "SN#Y030BG21E01C",
"complianceStatus": "VALID",
"managementPatternPresent": false,
"externalId": "97C28DF7541B4657AB59A26C2640A0A3_bay12",
"id": "50",
"profileName": "flex noop-profile4",
"profileStatus": "ASSIGNED",
"rackId": "",
"serverName": "AT-C4022-empt0",
"subBayId": null,
"templateId": "46",
"templateName": "flex noop",
"type": "root",
"unit": 0,
"uuid": "64AADF17B64D11E499180090FA8BC90A"
},
...,
{
"addressPresent": false,
"bayId": "13",
"chassisName": "SN#Y030BG21E01C",
"complianceStatus": "NONE",
"externalId": "97C28DF7541B4657AB59A26C2640A0A3_bay13",
"id": "49",
"managementPatternPresent": false,
"profileName": "flex noop-profile5",
"profileStatus": "ASSIGNED",
"rackId": "",
"serverName": "IB-C4054R-F5054",
"subBayId": null,
"templateId": "46",
"templateName": "flex noop",
"type": "root",
"unit": 0,
"uuid": "65E7D38AA6D811E298BD0090FA1C0DCE"
}]
}