This API call retrieves the cluster SSL certificate storage status.
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.
The certificate storage status is only available in runtime during the certificate update or upload. Once the certificate is uploaded and the node restarted, this API call will return BAD_REQUEST because no storage status is availabile.
/api/v1.0/onpremise/sslCertificate/store
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| entityType | string | entity type, possible values = "COLLECTOR"
| path | required |
| entityId | integer | Node ID, which can be extracted from the URL in 'Node details' view. | path | required |
| Code | Type | Description |
|---|---|---|
| 200 | Certificate | Successful or in progress |
| 400 | Certificate | Incorrect entity type |
| 404 | Certificate | Status not found |
| 500 | - | Internal error |
| 522 | Certificate | Certificate chain is invalid |
| 523 | Certificate | Private key does not match public key certificate |
| 525 | Certificate | Public key certificate is invalid |
| 526 | Certificate | Private key is invalid |
| 527 | Certificate | Error while storing SSL certificate |
| 528 | Certificate | Certificate has been stored but has not been refreshed |
| 529 | Certificate | Internal error |
CertificateStoreStatus object| Element | Type | Description |
|---|---|---|
| certificateStoreStatus | string | -
|
| detailedError | string | - |
{"certificateStoreStatus": "BAD_REQUEST","detailedError": "string"}
In this example, you check the SSL certificate storage status on 32 node of the myManaged.cluster.com cluster. In return you receive information on SSL certificate storage status indicating that the SSL certificate has been successfully stored.
curl -X GET "https://myManaged.cluster.com/api/v1.0/onpremise/sslCertificate/store/SERVER/32" -H "accept: application/json" -H "Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890"
https://myManaged.cluster.com/api/v1.0/onpremise/sslCertificate/store/SERVER/32
{"certificateStoreStatus": "Successful","detailedError": null}
200