Developer Documentation
Import From IMGDB Task Trust Authority Clusters Attestation OS ESX Base Images
Released in v7.0.0Import 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.
Request
URLURL
https://{api_host}/api/vcenter/trusted-infrastructure/trust-authority-clusters/{cluster}/attestation/os/esx/base-images?action=import-from-imgdb&vmw-task=true
Path Parameters
Path Parameters
| Required | Parameter Name | Type | Description |
|---|---|---|---|
| required |
|
string | The id of the cluster on which the operation will be executed. The parameter must be an identifier for the resource type: ClusterComputeResource. |
Query Parameters
Query Parameters
| Required | Parameter Name | Type | Description |
|---|---|---|---|
| required |
|
string | vmw-task=true is set in order to call this as an async API. The return value then becomes the Task ID instead that is used to query the result from the Task API. |
Response
Response
Response BodyResponse Body
202 Accepted returns
string
of type application/json
The imported imgdb version identifier. The result will be an identifier for the resource type: com.vmware.vcenter.trusted_infrastructure.trust_authority_clusters.attestation.os.esx.BaseImage.
Errors
| Code | Returns | Description |
|---|---|---|
| 404 | Error | com.vmware.vapi.std.errors.error : if there is a generic error. | com.vmware.vapi.std.errors.not_found : if the cluster is not found. |
| 409 | Error | com.vmware.vapi.std.errors.already_exists : if ESX metadata for the same version has already been added. |
| default | Error | Not available |
| 400 | Error | com.vmware.vapi.std.errors.invalid_argument : if the imgdb is invalid or cluster id is empty. |
| 401 | Error | com.vmware.vapi.std.errors.unauthenticated : if the caller is not authenticated. |
