Esx. Settings. Depot Content. Base Images List

Esx. Settings. Depot Content. Base Images List

Returns a list of currently available base images in the depot.

This operation was added in vSphere API 7.0.0.0.

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

  • Operation execution requires VcIntegrity.lifecycleSettings.Read.
Request
URI
GET
https://{api_host}/esx/settings/depot-content/base-images
COPY
Query Parameters
filter
Optional

The specification of matching base images.

If missing or null, the behavior is equivalent to a Esx.Settings.DepotContent.BaseImages.FilterSpec with all properties missing or null, which means all base images match the filter.


Authentication
This operation uses the following authentication methods.
Responses
200

List of base images in the depot. These will be sorted by the version of the base image.

Returns Array of Esx.Settings.DepotContent.BaseImages.Summary of type(s) application/json
[
    "Esx.Settings.DepotContent.BaseImages.Summary Object"
]

401

if the caller is not authenticated.

Returns Vapi.Std.Errors.Unauthenticated of type(s) application/json
"Vapi.Std.Errors.Unauthenticated 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/depot-content/base-images