Esx. Settings. Repository. Software. Drafts. Alternative Images. Base Image Get

Esx. Settings. Repository. Software. Drafts. Alternative Images. Base Image Get

Returns the base-image specification of the alternative image.

This operation was added in vSphere API 9.0.0.0.

Returns an authorization error if you do not have all of the privileges described as follows:

  • Operation execution requires VcIntegrity.lifecycleSoftwareSpecification.Read.
Request
URI
GET
https://{api_host}/esx/settings/repository/software/drafts/{draft}/alternative-images/{image}/base-image
COPY
Path Parameters
string
draft
Required

Identifier of the draft.

The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

string
image
Required

Identifier of the alternative image.

The parameter must be an identifier for the resource type: com.vmware.esx.settings.image.


Authentication
This operation uses the following authentication methods.
Responses
200

Base-image specification.

Returns Esx.Settings.BaseImageInfo of type(s) application/json
"Esx.Settings.BaseImageInfo Object"

401

If the caller is not authenticated.

Returns Vapi.Std.Errors.Unauthenticated of type(s) application/json
"Vapi.Std.Errors.Unauthenticated Object"

403

If the caller does not have the necessary privileges.

Returns Vapi.Std.Errors.Unauthorized of type(s) application/json
"Vapi.Std.Errors.Unauthorized Object"

404

If there is no draft associated with draft or no image associated with image in the system.

Returns Vapi.Std.Errors.NotFound of type(s) application/json
"Vapi.Std.Errors.NotFound Object"

500

If there is unknown internal error. The accompanying error message will give more details about the failure.

Returns Vapi.Std.Errors.Error of type(s) application/json
"Vapi.Std.Errors.Error Object"

503

If the service is not available.

Returns Vapi.Std.Errors.ServiceUnavailable of type(s) application/json
"Vapi.Std.Errors.ServiceUnavailable Object"

Code Samples
COPY
                    curl -H 'Authorization: <value>' https://{api_host}/esx/settings/repository/software/drafts/{draft}/alternative-images/{image}/base-image