Skip to main content

GET /api/v1/maintenance/certificateSettings

Use this method to return information about the XClarity Orchestrator server certificate settings.

Note
You can retrieve setting using this GET request only after you first modify the settings using PUT /api/v1/maintenance/certificateSettings.

Authentication

Authentication with username and password is required.

Resource URI

GET https://{orchestrator_server_IP}/api/v1/maintenance/certificateSettings

Query parameters

None

Request body

None

Response codes

CodeDescriptionComments
200OKThe request completed successfully.
500Internal Server ErrorAn internal error occurred. A descriptive error message is returned in the response body.

Response body

When the request is successful, the following attributes are returned. If the request fails, standard message attributes are returned (see Status messages).

AttributesTypeDescription
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)

To retrieve the country or region codes, use GET /api/v1/service/countryCodes.

notAfterStringTimestamp before which the created certificate is not valid

This timestamp is specified using ISO-8601 format (for example, 2019-05-02T19:28:14.000Z). For information about ISO-8601 format, see the W3C Date and Time Formats webpage.

notBeforeStringTimestamp after which the created certificate is not valid

This timestamp is specified using ISO-8601 format (for example, 2019-05-02T19:28:14.000Z). For information about ISO-8601 format, see the W3C Date and Time Formats webpage.

organizationStringOrganization (company) that owns the certificate. Typically, this is the legal incorporate name of a company. It should include any suffixes, such as Ltd., Inc., or Corp.
organizationUnitStringOrganizational unit that owns the certificate
stateLocalityStringFull name of the locality (city) to be associated with the certificate
stateProvinceStringFull name of the state or province to be associated with the certificate
_linksObjectServer certificate URI (see Links)
The following example is returned if the request is successful.
{
"commonName": "Generated by Lenovo Management Ecosystem on IP 10.243.17.108",
"country": "US",
"notAfter": "2030-10-06T14:54:04.000Z",
"notBefore": "2020-10-08T14:54:04.000Z",
"organization": "Lenovo",
"organizationUnit": "DCG",
"stateLocality": "Raleigh",
"stateProvince": "NC",
"_links": {
"rel": "self",
"uri": "/api/v1/maintenance/certificateSettings"
}
}