vCloud API Programming Guide
Response:
201 Created
Content-Type: application/vnd.vmware.admin.user+xml
...
<Group name="Engineering" type="application/vnd.vmware.admin.group+xml"
<Link rel="edit" type="application/vnd.vmware.admin.group+xml"
<Link rel="remove" href="http://vcloud.example.com/api/v1.0/admin/group/44"/>
<Description>Research and development</Description>
...
<UsersList/>
<Role type="application/vnd.vmware.admin.role+xml" name="vApp Wrangler"
</Group>
View Group Metadata
Each group in an organization can be referenced by the URL contained in one of its GroupReference
elements. These elements are contained by the Groups element of an AdminOrg body. A group's URL also
appears in the response to the request that imports the group. An administrator can GET a group URL to view
the Group body.
Modify Group Metadata
An administrator can modify a Group body to change its Description or Role by PUTting a modified Group
body to the edit URL for the group. See Example
Remove a Group
An administrator can use the remove link in a Group body to remove a group from a vCloud. Example
removes the group imported in Example
Example 6-30. Remove a Group
Request:
DELETE http://vcloud.example.com/api/v1.0/admin/group/44
Response:
204 No Content
Role Administration
A role associates the name of a user or group with a set of rights. Role names must be unique in a vCloud
instance.
Create a Role
A system administrator can create a role by aggregating a set of rights in a Role body, and then POSTing the
body to the add URL for roles. Example
vCloud shown in Example
the POSTed content, a link to the new object, and links of type edit and remove that an administrator can use
to manage this role.
114
href="http://vcloud.example.com/api/v1.0/admin/group/44" ...>
href="http://vcloud.example.com/api/v1.0/admin/group/44"/>
href="http://vcloud.example.com/api/v1.0/admin/role/102"/>
6‐29.
6‐31 creates a new role named vAppWrangler and adds it to the
6‐2. The response, like other responses to requests that create an object, includes
6‐27 for an example of the workflow for this type of request.
6‐30
VMware, Inc.