An administrator can take control of a user's vApps, media, and catalogs.

When an administrator retrieves a User element, it contains a link that the administrator can use to take ownership of that user's vApps, media, and catalogs. This action is typically required when a user leaves the organization and an administrator must transfer ownership of that user's objects to other users.

Prerequisites

This operation requires the rights included in the predefined Organization Administrator role or an equivalent set of rights. Verify that you are logged in to the vCloud Air Compute Service as an Account Administrator.

Procedure

  1. Retrieve the XML representation of the user.
    Use a request like this one: 
    GET https://vcloud.example.com/api/admin/user/85
  2. Examine the response to find the link where rel="takeOwnership". 
    <User
   ...
   href="https://vcloud.example.com/api/admin/user/85" ... >
   ...
   <Link
      rel="takeOwnership"
      href="https://vcloud.example.com/api/admin/user/85/action/takeOwnership"/>
   ... 
</User>
  3. Make a POST request to the URL in the href value of that link. 
    POST  https://vcloud.example.com/api/admin/user/85/action/takeOwnership
    The response is empty (204 No Content).

Results

All vApps, media, and catalogs that belonged to the user now belong to the administrator who made the request. The administrator can then change the ownership as needed. See View or Change the Owner of an Object.