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.

Request:

HTTP request

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

?action=import-from-imgdb
&vmw-task=true
"YmluYXJ5"

Path Parameters

Name Type Description
Required
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.

Response:

HTTP Status Code: 202

Response Body Structure:

"obj-103"

Headers:

None

Type:

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

Errors:

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.