REST API - get

esx settings depot content base images versions: get

Returns information about a given base-image version in the depot.

Request:

HTTP request

GET https://{server}/api/esx/settings/depot-content/base-images/versions/{version}

Path Parameters

Name Type Description
Required
version string Version of the base-image.

Response:

HTTP Status Code: 200

Response Body Structure:

{
    "summary""string",
    "components"[
        {
            "display_version""string",
            "name""obj-103",
            "display_name""string",
            "version""string"
        },
        {
            "display_version""string",
            "name""obj-103",
            "display_name""string",
            "version""string"
        }
    ],
    "release_date""2015-01-01T22:13:05.651Z",
    "display_version""string",
    "kb""http://myurl.com",
    "description""string",
    "display_name""string",
    "category""SECURITY",
    "version""obj-103"
}

Headers:

None

Type:

Name Type Description
bold = required
- info Information about the given base-image.
-.display_name string Display name of the base-image.

-.version string Version of the base-image.

When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: com.vmware.esx.settings.base_image. When operations return a value of this structure as a result, the field will be an identifier for the resource type: com.vmware.esx.settings.base_image.

-.display_version string Human readable version of the base-image.

-.summary string Summary of the base-image.

-.description string Discription of the base-image.

-.category string Category of the base-image.

Defines possible values of categories for a base-image. Value is one of:
SECURITY: Security
ENHANCEMENT: Enhancement
BUGFIX: Bugfix

-.kb URI Link to kb article related to this the base-image.

-.release_date date_time Release date of the base-image.

-.components component_version_info[] List of components in this base-image.

-.components[].name string Identifier of the component.

When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: com.vmware.esx.settings.component. When operations return a value of this structure as a result, the field will be an identifier for the resource type: com.vmware.esx.settings.component.

-.components[].display_name string Display name of the component.

-.components[].version string Version of the component.

-.components[].display_version string Human readable version of the base-image.

Errors:

HTTP Status Code Type Description
500 error If there is unknown internal error. The accompanying error message will give more details about the failure.
404 not_found if base-image with given version is not found.
503 service_unavailable If the service is not available.
401 unauthenticated if the caller is not authenticated.