Skip to main content

GET /profiles/status

Use this method to return information about the server-profile status for specific server.

Authentication

Authentication with username and password is required.

Request URL

GET https://{management_server_IP}/profiles/status

Query parameters

ParametersRequired / OptionalDescription
uuids={uuid_list}RequiredList of server UUIDs, separated by a comma

The following example retrieves the profile status for two servers.

GET https://192.0.2.0/profiles/status
?uids=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA,BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB

Request body

None

Response codes

CodeDescriptionComments
200OKThe request completed successfully.
400Bad RequestA query parameter or request attribute is missing or not valid, or the operation is not supported. A descriptive error message is returned in the response body.
401UnauthorizedThe user cannot be authenticated. Authentication has not been provided or has failed. A descriptive error message is returned in the response body.
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.

404Not foundA specified resource cannot be found. A descriptive error message is returned in the response body.
500Internal Server ErrorAn internal error occurred. A descriptive error message is returned in the response body.

Response body

AttributesTypeDescription
identifierStringAlways set to uuid
itemsArray of objectsConfiguration status for each server
 activationStatusStringActivation status. This can be one of the following values.
  • UNKNOWN. Activation status is in an unknown state.
  • RUNNING. Profile activation is in progress.
  • PENDING. Profile activation is pending.
  • COMPLETED. Profile activation is complete.
  • TERMINATED. Profile activation process was terminated before it completed.
  • CONFIGERROR. Cannot retrieve the configuration definitions from the server.
  • LDAPERROR. Cannot connect to the XClarity Administrator LDAP server.
 complianceStatusStringCompliance status. This can be one of the following values.
  • VALID. Server settings are compliant with the assigned server profile

  • INVALID. Server settings are not compliant with the assigned server profile.

  • NONE. Compliance is not calculated because the pattern is still being activated, pending or inactive.

 configStatusStringConfiguration status. This can be one of the following values.
  • NO_PROFILE. A profile has not been assigned to this server.
  • PROFILE_USE_NOT_SUPPORTED. Configuration patterns is not supported for the server.
  • DEPLOY_STARTED. Configuration-Pattern deployment is started.
  • BUILDING_PROFILE. The server profile is being built.
  • SAVING_PROFILE. The server profile is being saved.
  • PENDING_PROFILE. The server profile is pending activation.
  • ACTIVATING_PROFILE. The server profile is being activated.
  • ERROR_CREATING_PROFILE. The server profile cannot be created.
  • ERROR_ACTIVATING_PROFILE. The server profile cannot be activated.
  • RESTARTING. The server is restarting.
  • PROFILE_ACTIVATED. The server profile is activated.
 serverNameStringServer name
 serverProfileIdStringID of the server profile that is associated with this server
 serverProfileNameStringName of the server profile that is associated with this server
 serverTemplateIdStringID of the server pattern that was used to create the server profile that is associated with this server
 serverTemplateNameStringName of the server pattern that was used to create the server profile that is associated with this server
 uuidStringServer UUID
 virtualAddressStatusStringVirtual address status. This can be one of the following values.
  • NOT_APPLIED. Virtual addresses are not applied.
  • APPLIED. Virtual addresses are applied.
labelStringAlways set to Server Status
The following example is returned if the request is successful.
{
"identifier": "uuid",
"items": [{
"activationStatus": "COMPLETED",
"complianceStatus": "VALID ",
"configStatus": "PROFILE_ACTIVATED",
"serverName": "ch02n12-imm",
"serverProfileId": "69",
"serverProfileName": "Flex Virtual Fabric Pattern-profile1",
"serverTemplateId": "68",
"serverTemplateName": "Flex Virtual Fabric Pattern",
"uuid": "BA298CD7BC5311E69A000090FAF46898",
"virtualAddressStatus": "APPLIED"
}]
"label": "Server Status",
}