REST API - list-task

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

Return the remote server certificates.

Contacts the configured key servers and attempts to retrieve their certificates. These certificates might not yet be trusted.

If the returned certificates are to be considered trustworthy, then it must be added to the list of trusted server certificates by adding to the certificates returned by get and invoking update with the updated array of certificates.

. This operation was added in vSphere API 7.0.0.

Request:

HTTP request

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

?server_names={value-1}
&server_names={value-2}
&trusted={true}
&vmw-task=true

Path Parameters

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

Query Parameters:

Name Type Description
bold = required
server_names string[] Names that key server must have to match the filter (see vcenter.trusted_infrastructure.trust_authority_clusters.kms.providers.current_peer_certificates.summary.server_name). This attribute was added in vSphere API 7.0.0.

Optional. If unset or empty, key servers with any name match the filter.

trusted boolean Trust status that server certificates must have to match the filter (see vcenter.trusted_infrastructure.trust_authority_clusters.kms.providers.current_peer_certificates.summary.trusted). This attribute was added in vSphere API 7.0.0.

Optional. If unset, trusted and untrusted server certificates match the filter.

Response:

HTTP Status Code: 202

Response Body Structure:

"obj-103"

Headers:

None

Type:

Name Type Description
bold = required
- string Summary of server certificates.

Errors:

HTTP Status Code Type Description
400 invalid_argument If the cluster or 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 For any other error.