Apply Server Certificate
Applies SSL/TLS certificate and private key for the HCX Manager's HTTPD web server. This certificate is used for HTTPS connections to the HCX Manager.
Important Notes:
- Validates certificate and private key format
- If private key is not provided, uses the private key from the last CSR generation
- Applies certificate with graceful Apache restart (no service interruption)
Certificate Format:
- Must be X.509 certificates in PEM format
- Can include certificate chain (intermediate + leaf certificates)
- Private key must match the certificate's public key
Show optional properties
{
"sslCert": "string"
}{
"sslCert": "string",
"sslCertKey": "string"
}SSL certificate in PEM format (can include certificate chain)
Private key in PEM format (optional - uses CSR-generated key if omitted)
Certificate applied successfully (async operation accepted)
{
"success": true,
"completed": true,
"time": 1753094523000,
"version": "1.0",
"protocol": "string",
"fingerprint": "string",
"data": {
"items": [
{}
]
},
"errors": [
{
"text": "string"
}
],
"warnings": [
{
"text": "string"
}
]
}Indicates if the operation was successful
Indicates if the operation completed
Unix timestamp in milliseconds
API version
Protocol version
Response fingerprint
Response data containing items array
Array of error objects
Array of warning objects
Bad request - Invalid certificate format or validation failure
{
"isSuccess": false,
"message": "Request schema validation failed",
"httpStatusCode": 400
}Indicates if the operation was successful
Human-readable error message
HTTP status code
Internal server error
{
"isSuccess": false,
"message": "Error in applying server certificate, please verify the certificates again.",
"httpStatusCode": 500
}Indicates if the operation was successful
Human-readable error message
HTTP status code
curl -X PUT -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{"sslCert":"string"}' https://{api_host}/api/admin/certificates/serverCertificate/httpd