Working with UMDS Depots

In an air-gapped vCenter Server environment, you can use the vSphere Automation REST API to add a UMDS depot to the depots managed by Depot Manager.

After you install and configure the Update Manager Download Service (UMDS) on a physical machine with Internet access, you can add the UMDS depot to Depot Manager. Only one UMDS depot can be added at a time to Depot Manager. When you add a UMDS depot, its content is not immediately synchronized. To synchronize the content of the UMDS depots, you must use the POST https://<vcenter_ip_address_or_fqdn>/api/esx/settings/depots?action=sync&vmw-task=true request or wait for the scheduled synchronization to take place.

To add a UMDS depot, use the PUT https://<vcenter_ip_address_or_fqdn>/api/esx/settings/depots/umds request and submit a Umds.SetSpec JSON object in the request body.. The UMDS specification must contain the URI location to the index.xml file of the depot. Optionally, you can set a description and indicate whether the depot must be enabled. By enabling the UMDS depot, you instruct Depot Manager to synchronize only the content that is available on that depot.

You can always edit the initial UMDS depot settings, by using the PATCH https://<vcenter_ip_address_or_fqdn>/api/esx/settings/depots/umds request and submit a Umds.UpdateSpec JSON object in the request body.

To retrieve information about the currently configured UMDS depot, use the GET https://<vcenter_ip_address_or_fqdn>/api/esx/settings/depots/umds request. You can remove a currently configured UMDS depot and all its downloaded content from Depot Manager by using the DELETE https://<vcenter_ip_address_or_fqdn>/api/esx/settings/depots/umds?vmw-task=true request.