REST API - import_from_imgdb-task

vcenter trusted infrastructure trust authority clusters attestation os esx base images: import from imgdb-task

Import ESX metadata as a new trusted base image to each host in the cluster.

Import a boot_imgdb.tgz file which contains metadata that describes a trusted ESX base image. A boot_imgdb.tgz file can be downloaded from a representative host.

. This operation was added in vSphere API 7.0.0.


HTTP request

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


Path Parameters

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

Body Parameters:

Name Type Description
bold = required
- binary ESX metadata on a cluster level.


HTTP Status Code: 202

Response Body Structure:





Name Type Description
bold = required
- string The imported imgdb version identifier.


HTTP Status Code Type Description
400 already_exists if ESX metadata for the same version has already been added.
500 error if there is a generic error.
400 invalid_argument if the imgdb is invalid or cluster id is empty.
404 not_found if the cluster is not found.
401 unauthenticated if the caller is not authenticated.