When users leave your company, you might want to delete their user profile from Virtual Private Cloud OnDemand.

You can delete users from Virtual Private Cloud OnDemand to revoke their access to the service. In this way, you can recover any resources that were assigned to the user. If you delete users who are signed in at the time, their sessions will be forcibly terminated and they will be signed out. The user is deleted and does not appear in the user list. The end user's resources (such as any virtual machines that they own) are moved to the administrator who deleted the user.

To temporarily suspend a user's account, you can change the user's state from active to inactive. See Update a User for information.

Prerequisites
■

You have signed up and registered for Virtual Private Cloud OnDemand and received an email with a user name and password for an Account Administrator.

■

Using the URL in the confirmation email, you have logged in to Virtual Private Cloud OnDemand using the Web UI, set your password, and accepted the Terms of Service.

■

You have logged in as an administrator using the /api/iam/login API and received an OATH token. See Log In and Receive Access Token for information.

Procedure
1

If necessary, issue a request to get the ID for the user who you want to delete: 

GET https://vca.vmware.com/api/iam/Users

In the request, include the OAuth token and the Accept header: 

Accept: application/json;version=5.7
Authorization: Bearer OAuth_token

Include the OAuth token in all subsequent API requests as a request header.

The returned response includes the list of users for your account.

2

Issue the request to delete the user: 

DELETE https://vca.vmware.com/api/iam/Users/user_id
Example: Request and Response to Delete a User

Request Header – Delete user 

DELETE https://vca.vmware.com/api/iam/Users/aef1ee7e-c645-49db-83ae-ce9ad164df53
Accept: application/json;version=5.7
Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJqdGkiOiJiN2VjNjUyZi1mZmUzLTRh…

Request body not required.

Response Header – Delete user 

Status: 204 NO CONTENT
Connection: close
Content-Length: 0
Content-Type: text/plain; charset=UTF-8
Date: Thu, 26 Jun 2014 05:30:20 GMT
Server: Apache-Coyote/1.1

Response body not returned.