REST API - list-task

vcenter trusted infrastructure trust authority clusters attestation os esx base images: list-task

Return a list of trusted ESX base images. This operation was added in vSphere API 7.0.0.

Request:

HTTP request

GET https://{server}/api/vcenter/trusted-infrastructure/trust-authority-clusters/{cluster}/attestation/os/esx/base-images

?version={value-1}
&version={value-2}
&display_name={value-1}
&display_name={value-2}
&health={value-1}
&health={value-2}
&vmw-task=true

Path Parameters

Name Type Description
Required
cluster string The id of the cluster on which the operation will be executed.

Query Parameters:

Name Type Description
bold = required
version string[] Search criteria by ESX base image version numbers. This attribute was added in vSphere API 7.0.0.

Optional. version if {@term.unset} return all ESX version numbers.When clients pass a value of this structure as a parameter, the field must contain identifiers for the resource type: com.vmware.vcenter.trusted_infrastructure.trust_authority_clusters.attestation.os.esx.BaseImage. When operations return a value of this structure as a result, the field will contain identifiers for the resource type: com.vmware.vcenter.trusted_infrastructure.trust_authority_clusters.attestation.os.esx.BaseImage.

display_name string[] Search criteria by ESX base image version version numbers. This attribute was added in vSphere API 7.0.0.

Optional. displayName if {@term.unset} return all ESX display version numbers.

health string[] Search criteria by health indicator. This attribute was added in vSphere API 7.0.0.

Optional. health if {@term.unset} return all health indicators.

Response:

HTTP Status Code: 202

Response Body Structure:

"obj-103"

Headers:

None

Type:

Name Type Description
bold = required
- string A list of configured trusted ESX base images.

Errors:

HTTP Status Code Type Description
500 error if there is a generic error.
400 invalid_argument if the cluster id is empty.
404 not_found if the cluster is not found.
401 unauthenticated if the caller is not authenticated.