REST API - update-task

vcenter trusted infrastructure trust authority clusters kms providers trusted peer certificates: update-task

Update trusted server certificate(s).

The client will use these certificates to validate the server connection. The existing list of trusted certificates will be overwritten.

The client will not trust the server connection until a server certificate has been set.

. This operation was added in vSphere API 7.0.0.

Request:

HTTP request

PATCH https://{server}/api/vcenter/trusted-infrastructure/trust-authority-clusters/{cluster}/kms/providers/{provider}/peer-certs/trusted

?vmw-task=true
{
    "certificates"[
        "string",
        "string"
    ]
}

Path Parameters

Name Type Description
Required
cluster string Identifier of the cluster.
provider string Identifier of the provider.

Body Parameters:

Name Type Description
bold = required
- update_spec The update spec.
-.certificates string[] Public certificates of key server to trust. This attribute was added in vSphere API 7.0.0.

Optional. If unset, the trusted server certificates will not be updated.

Response:

HTTP Status Code: 202

Response Body Structure:

"obj-103"

Headers:

None

Type:

Name Type Description
bold = required
- string

Errors:

HTTP Status Code Type Description
400 invalid_argument If one or more certificates are invalid or the cluster/provider Id is empty.
404 not_found If the cluster or provider is not found.
401 unauthenticated If the caller is not authenticated.
500 error If any other error occurs.