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.