List Trust Authority Clusters
Returns a list of clusters for this vCenter instance which matches the TrustAuthorityClusters.FilterSpec. if you do not have all of the privileges described as follows: - Operation execution requires TrustedAdmin.ReadTrustedHosts. - The resource ClusterComputeResource referenced by the attribute TrustAuthorityClusters.FilterSpec.cluster requires System.View.
Request
URLURL
https://{api_host}/api/vcenter/trusted-infrastructure/trust-authority-clusters
Query Parameters
Query Parameters
array of
string
cluster
Optional
Identifies the cluster. cluster If {@term.unset} return all Trust Authority Clusters. When clients pass a value of this structure as a parameter, the field must contain identifiers for the resource type: ClusterComputeResource. When operations return a value of this structure as a result, the field will contain identifiers for the resource type: ClusterComputeResource.
state
Optional
The state of the TrustAuthorityClusters. state If {@term.unset} return all Trust Authority Clusters.
Header Parameters
Header Parameters
string
vmware-api-session-id
Required
Required session ID, acquired from Create Session API under CIS product
vmware-api-session-id example
"b00db39f948d13ea1e59b4d6fce56389"
Authentication
This operation uses the following authentication methods.
Response
Response
Response BodyResponse Body
200 OK returns
array of
TrustedInfrastructureTrustAuthorityClustersSummary
of type application/json
List of TrustAuthorityClusters.Summary for a TrustAuthorityClusters.
[
{
"cluster": "string",
"state": "ENABLE"
}
]
string
cluster
Required
Identifies the cluster. When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: ClusterComputeResource. When operations return a value of this structure as a result, the field will be an identifier for the resource type: ClusterComputeResource.
state
Required
The TrustAuthorityClusters.State enumerated type defines the states of the TrustAuthorityClusters.
ENABLE : The TrustAuthorityClusters is enabled.
DISABLE : The TrustAuthorityClusters is disabled.
Possible values are: ENABLE , DISABLE
Errors
default
‘Default’ means this response is used for all HTTP codes that are not covered individually for this operation.
Code Samples
PowerCLI Client SDK Example
Invoke-ListTrustedInfrastructureTrustAuthorityClusters -Cluster "MyCluster" -State "ENABLE"
cURL Command
curl -H "vmware-api-session-id: b00db39f948d13ea1e59b4d6fce56389" https://{api_host}/api/vcenter/trusted-infrastructure/trust-authority-clusters
Vendor Extensions
This operation contains the following vendor extensions defined in the spec:
x-vmw-doc-operation: list
Availability
Added in 7.0.0.0
