Configure a vSphere Trust Authority Cluster

You can use HTTP requests to perform vSphere Trust Authority Cluster management operations.

You can retrieve details about vSphere Trust Authority Clusters, update the state of a cluster, and check the result of the update operation. Some operations require you to specify parameters in the body of the HTTP request according to your vSphere Trust Authority environment. For details about the syntax of each HTTP request body, see the API Reference documentation.

Prerequisites

• Verify that you have access to a working vSphere Trust Authority environment.
• Verify that you have Trusted Infrastructure administrative privileges.

Procedure

1. Retrieve a list of clusters for a vCenter Server instance that are configured as Trust Authority Clusters.

   GET https://<vcenter_ip_address_or_fqdn>/api/vcenter/trusted-infrastructure/trust-authority-clusters

   You receive the list in the response body.

2. Update the state of a cluster.

   PATCH https://<vcenter_ip_address_or_fqdn>/api/vcenter/trusted-infrastructure/trust-authority-clusters/<cluster>?vmw-task=true

   You receive the task ID in the response body. You can use the task ID to check the status of the task by running the following HTTP request.

   GET https://<vcenter_ip_address_or_fqdn>/api/cis/tasks/<task_ID>

3. Check the result of the last update operation for the same cluster.

   GET https://<vcenter_ip_address_or_fqdn>/api/vcenter/trusted-infrastructure/trust-authority-clusters/<cluster>

   You receive the ID and current state of the cluster in the response body.