Skip to main content

GET /certificateSettings

Use this method to return the saved certificate values from the most recent certificate creation.

Authentication

Authentication with username and password is required.

Request URL

GET https://{management_server_IP}/certificateSettings

Query parameters

None

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.
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
responseArrayInformation about certificate settings
 CommonNameStringName of the certificate owner. Typically, this is the fully-qualified domain name (FQDN) or IP address of the server that is using the certificate (for example, www.domainname.com or 10.15.23.99).
 CountryStringTwo-letter ISO 3166 code for the country or region of origin associated with the certificate organization (for example, US for the United States)
 notBeforeStringUTC date and time before which the created certificate is not valid

The date and time is specified in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ (for example, 2017-01-25T18:00:00Z).

 notAfterStringUTC date and time after which the created certificate is not valid

The date and time is specified in ISO 8601 format YYYY-MM-DDTHH:MM:SSZ (for example, 2017-01-25T18:00:00Z).

 OrganizationStringOrganization (company) that will own the certificate. Typically, this is the legal incorporate name of a company. It should include any suffixes, such as Ltd., Inc., or Corp (for example, ACME International Ltd.).
 OrganizationUnitStringOrganizational unit that will own the certificate (for example, ABC Division)
 StateLocalityStringFull name of the locality (city) to be associated with the certificate (for example, San Jose)
 StateProvinceStringFull name of the state or province to be associated with the certificate (for example, California or New Brunswick)
 subjectAlternativeNamesObjectInformation about the Subject Alternative Names (SANs) to be included in Certificate Signing Requests
  generalNamesArray of objectsList of Subject Alternative Names to be included in Certificate Signing Requests
   nameStringSubject Alternative Name
   typeStringRFC 5280 GeneralName type of this Subject Alternative Name
  possibleGeneralNameTypesArray of stringsList of supported RFC 5280 GeneralName type strings
resultStringResults of the request. This can be one of the following values.
  • success. The request completed successfully.
  • failure. The request failed, a descriptive error message was returned.
messagesArrayInformation about one or more messages
 idStringThe message identifier of a returned message
 explanationStringAdditional information to clarify the reason for the message
 recoveryArrayRecovery information
   textStringUser actions that can be taken to recover from the event
   URLStringLink to the help system for more information, if available
 textStringMessage text associated with the message identifier
The following example is returned if the request is successful.
{
"response": {
"CommonName": "Generated by Lenovo System Management Software",
"Country": "US",
"notBefore": "2017-06-01T12:30:00Z",
"notAfter": "2018-06-01T12:30:00Z",
"Organization": "Lenovo",
"OrganizationUnit": "DCG",
"StateLocality": "Raleigh",
"StateProvince": "North Carolina",
"subjectAlternativeNames": {
"generalNames": [{
"name": "LXCA-1",
"type": "dNSName"
},
{
"name": "192.0.2.0",
"type": "iPAddress"
}],
"possibleGeneralNameTypes": ["dNSName", "iPAddress", "rfc822Name", "directoryName",
"uniformResourceIdentifier", "registeredID"]
}
},
"result": "success",
"messages": [{
"id": "FQXHMSE0001I",
"explanation": "",
"recovery": {
"text": "Information only; no action is required.",
"URL": ""
},
"text": "The request completed successfully."
}]
}