Get cluster SSL certificate details

This API call retrieves cluster SSL certificate details.

Authentication

To execute this request, you need the Service Provider API (ServiceProviderAPI) permission assigned to your API token. Generate your API token via Cluster Management Console (CMC). To learn how to obtain and use it, see Cluster API - Authentication.

Endpoint

/api/v1.0/onpremise/sslCertificate

Parameter

Parameter	Type	Description	In	Required
entityType	string	entity type, possible values = "SERVER, COLLECTOR" The element can hold these values `COLLECTOR` `SERVER`	path	required
entityId	integer	Node ID, which can be extracted from the URL in 'Node details' view.	path	required

Response

Response codes

Code	Type	Description
200	SSLDetails	Success
500		Internal server error.

Response body objects

The `SSLDetails` object

Element	Type	Description
customKeyStore	boolean	-
restartRequired	boolean	-
customKeyStoreWritable	boolean	-
inProgress	boolean	-
expirationDate	string	-
issuer	string	-
subject	string	-
default	boolean	-

Response body JSON model

json
{
  "customKeyStore": true,
  "restartRequired": true,
  "customKeyStoreWritable": true,
  "inProgress": true,
  "expirationDate": "string",
  "issuer": "string",
  "subject": "string",
  "default": true
}

Example

In this example, you check the SSL certificate details on 32 node of the myManaged.cluster.com cluster. In return you receive information on current SSL certificate.

Curl

bash
curl -X GET "https://myManaged.cluster.com/api/v1.0/onpremise/sslCertificate/SERVER/32" -H  "accept: application/json" -H  "Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890"

Request URL

plaintext
https://myManaged.cluster.com/api/v1.0/onpremise/sslCertificate/SERVER/32

Response body

json
{
  "issuer": "EV SSL Intermediate CA RSA",
  "subject": "n32.myManaged.cluster.com",
  "expirationDate": 1615956886000,
  "customKeyStore": false,
  "customKeyStoreWritable": true,
  "inProgress": false,
  "restartRequired": false,
  "default": false
}

Response code

200