Esx. Settings. Depot Content. Add Ons List

Esx. Settings. Depot Content. Add Ons List

Returns a list of currently available OEM add-ons 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/add-ons
COPY
Query Parameters
filter
Optional

The specification of matching OEM add-ons.

If missing or null, the behavior is equivalent to a Esx.Settings.DepotContent.AddOns.FilterSpec with all properties missing or null, which means all OEM add-ons match the filter.

string of array
vendors
Optional

Vendors that an add-on must have to match the filter.

This property was added in vSphere API 7.0.0.0.

If missing or null or empty, add-ons from any vendor will match the filter.

string of array
names
Optional

Names that an add-on must have to match the filter.

This property was added in vSphere API 7.0.0.0.

If missing or null or empty, add-ons with any name will match the filter.

When clients pass a value of this schema as a parameter, the property must contain identifiers for the resource type: com.vmware.esx.settings.add_on. When operations return a value of this schema as a response, the property will contain identifiers for the resource type: com.vmware.esx.settings.add_on.

string of array
versions
Optional

Versions that an add-on must have to match the filter.

This property was added in vSphere API 7.0.0.0.

If missing or null or empty, add-ons with any version will match the filter.


Authentication
This operation uses the following authentication methods.
Responses
200

List of OEM add-ons in the depot.

Returns Array of Esx.Settings.DepotContent.AddOns.Summary of type(s) application/json
[
    "Esx.Settings.DepotContent.AddOns.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/add-ons