OPERATIONAL DEFECT DATABASE
...
...
Attempting to perform actions against a vApp or VM as an Organization level user in the Cloud Director Tenant UI.Many operations on the vApp or VM, for example the Edit options, are greyed out.On screens where the VM power operations are available, attempting them fails with a message of the form: The entity xxxxx is undergoing maintenance operations When editing the VM through API, the following message is displayed in the response: [ UUID ] The entity xxxxx is undergoing maintenance operations." majorErrorCode="409" minorErrorCode="INVALID_STATE" Attempting to perform actions as a System level user succeeds without issue.
This message is returned when a vApp has been placed in maintenance mode.When a vApp is in maintenance mode, it is read-only to Organization level users and only System users can modify it. More details on maintenance mode for vApps is available in the Cloud Director API documentation, VMware Cloud Director API, User Operations, POST /vApp/{id}/action/enterMaintenanceMode.
To allow Organization users to perform operations on the vApp again disable maintenance mode.This can be done by using the Cloud Director API's exitMaintenanceMode operation against the vApp in question, VMware Cloud Director API, User Operations, POST /vApp/{id}/action/exitMaintenanceMode.Example steps to exit maintenance mode for a vApp as an Organization user would be as follows: Retrieve the UUID of the vApp which is in maintenance mode, this can be seen in the URL in a browser after opening the vApp in the Cloud Director Tenant portal. Example URL:https://vcloud.example.com/tenant/ExampleOrg/vdcs/<VDC_UUID>/vapp/vapp-<VAPP_UUID>/generalvApp UUID:vapp-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx Using the vApp UUID construct the URL for the exit maintenance mode operation for the vApp. Example URL:https://vcloud.example.com/api/vApp/vapp-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/action/exitMaintenanceMode Log into the Cloud Director API as a System Administrator: Request:POST https://vcloud.example.com/cloudapi/1.0.0/sessions/providerRequest Headers:Accept:application/json;version=37.2Authorization:Basic (Encoded username@system / password) NOTE: the API version in the Accept header is based on the Cloud Director version. Copy the value of the response header X-VMWARE-VCLOUD-ACCESS-TOKEN which is our login Bearer token used for further requests. Response Headers:X-VMWARE-VCLOUD-ACCESS-TOKEN:eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJhZG1pbml...bY1pTknnRprwEg Using the constructed URL in step 2 and the authorization bearer token from step 4, send the API call to exit the vApp from maintenance mode: Request:POST https://vcloud.example.com/api/vApp/vapp-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/action/exitMaintenanceModeRequest Headers:Accept:application/json;version=37.2Authorization:Bear eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJhZG1pbml...bY1pTknnRprwEg With the vApp out of maintenance mode Organization users should be able to perform operations.
For more information on connecting to the Cloud Director API see, How to establish an API connection VMware Cloud Director (56948).
Click on a version to see all relevant bugs
VMware Integration
Learn more about where this data comes from
Bug Scrub Advisor
Streamline upgrades with automated vendor bug scrubs
BugZero Enterprise
Wish you caught this bug sooner? Get proactive today.
