PUT /endpoint/signingCertificate/{uuid}/{resource}
Use this method to upload a Certificate Authority (CA) root certificate to the Lenovo XClarity Administrator trust store for a specific UUID.
Note
This method is not support on ThinkServer and System x M4 servers.
Authentication
Authentication with username and password is required.
Request URL
PUT https://{management_server_IP}/endpoint/signingCertificate/{uuid}/{resource}
where:
{uuid} specifies the UUID of the target device.
- {resource} can be one of the following values.
- updatedCIMCertificate. This resource type applies only to rack or tower server UUIDs.
- updatedLDAPCertificate. This resource type applies only to rack or tower server UUIDs.
- updatedSigningCertificate. This resource type applies only to chassis, storage device, and switch UUIDs.
Query parameters
None
Request body
Attributes | Required / Optional | Type | Description |
---|---|---|---|
newCertificatePem | Required | String | PEM representation of the certificate to be uploaded into the XClarity Administrator trust store |
The following example uploads a Certificate Authority (CA) root certificate.
{
"NewCertificatePem": "-----BEGIN CERTIFICATE-----\n
MIID8jCCAtqgAwIBAgIBATANBgkqhkiG9w0BAQUFADCBmzFHMEUGA1UEAxM+Q0Eg\n
Zm9yIEE0QUZCQkM0LTc3MDItMzIwNC05QTQ1LUM2RjMxNUQ2NjIzNiwgMTUtMDMt\n
MTAgMTA6NDk6MDExJTAjBgNVBAoTHEdlbmVyY XRlZCBieSBMZW5vdm8gRmlybXdh\n
ncmUxCzAJBgNVBAYTAlVTMQswCQYDVQQIEwJUWDEPMA0GA1UEBxMGQXVzdGluMB4X\n
DTcwMDEw MTAwMDAwMFoXDTQ4MTIzMTIzNTk1OVowgZsxRzBFBgNVBAMTPkNBIGZv\n
ciBBNEFGQkJDNC03NzAyLTMyMDQtOUE0NS1DNkYzMTVEN jYyMzYsIDE1LTAzLTEw\n
IDEwOjQ5OjAxMSUwIwYDVQQKExxHZW5lcmF0ZWQgYnkgTGVub3ZvIEZpcm13YXJln\n
MQswCQYDVQQGEwJVUzELM AkGA1UECBMCVFgxDzANBgNVBAcTBkF1c3RpbjCCASIw\n
DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAL1v1bO6QEoT4YWcD9fpjvWSZ uju\n
9HVspD45QBJo5rd8Pmpt+iaGyyPASTOa25TBQ8gSXADYkv7uRpKJ6b1fJhXsEe0C\n
4YXS3eTr4Ada90fFqutzdbjygsxtyE4A5LijCu32wlSrXC KuQWCKTw35ItqkEc3n\n
DSqOwc9weRbsKzvDG20oR+2NViwi9Wo7/fyYSQm+o5dIFbZenV4Jt5l3+wPiIYFnq\n
8TqFJeCRdZYvAFRnNs9FN2d7On 7AYtVZcL2CvFfnRhWfSpSWKABbwb5qcDRZ/D7\n
xis9c5MpqgX+Ca/3TUGVAO5VQatHXr2bR/odneSaViNyITxCgVfcN0H2x0ECAwEA\n
AaM/M D0wDAYDVR0TBAUwAwEB/zAOBgNVHQ8BAf8EBAMCAbYwHQYDVR0lBBYwFAYI\n
KwYBBQUHAwIGCCsGAQUFBwMBMA0GCSqGSIb3DQEBB QUAA4IBAQBt56ech5RFnTTi\n
Hv7vG898TllKAFt7WDS5WA2I64x7SrWzWQcS1AuGrTvfRpDXKpdNjsZffmI+j9Oln\n
MbNBtQVWxxqfH/TVT+M+W PNVtBtkh1c3tLe9N55QxtBJtxgTJzwCI23JxS2DC34o\n
eAkbPYNq6B+wWaXectPj1dbQJvzOyVIPLMoyYmv7dR5bt05wQo83GoL1eYkofUls\n
rFXO z91rYF3QSIsovFp/KTTxR4/o2+aVHKl4K8J7bdDLQF5JrxB8tgxnln0Pt6U/\n
zIWy4uL5/WDZvlMzfTz7g/wPm4mz3amoOp2iUaUBG7azxciWtUg28dhGqwC/ejc/\n
ryhtZu+0\n
-----END CERTIFICATE-----\n"
}
Response codes
Code | Description | Comments |
---|---|---|
200 | OK | The request completed successfully. |
400 | Bad Request | A 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. |
404 | Not found | A specified resource cannot be found. A descriptive error message is returned in the response body. |
500 | Internal Server Error | An internal error occurred. A descriptive error message is returned in the response body. |
Response body
If the request is not successful, the response body includes the following attributes.
Attributes | Type | Description | ||
---|---|---|---|---|
result | String | Results of the request. This can be one of the following values.
| ||
messages | Array of objects | Information about one or more messages | ||
id | String | Message identifier of a returned message | ||
text | String | Message text associated with the message identifier | ||
explanation | String | Additional information to clarify the reason for the message | ||
recovery | Array of objects | Recovery information | ||
text | String | User actions that can be taken to recover from the event | ||
URL | String | Link to the help system for more information, if available |
The following example is returned if the request failed.
{
"result": "failure",
"messages": [{
"explanation": "The operation to resolve the untrusted connection could not complete
because a resource associated with that device was not found.",
"id": "FQXHMSE0119J",
"recovery": {
"text": "Ensure that the device is under management and attempt the operation
again. If the problem persists, collect service data and contact Support.",
"URL": ""
},
"text": "The request to resolve the untrusted connection was not successful."
}]
}
Give documentation feedback