VMware VCLOUD API 1.0 - API - Role Administration

vCloud API Programming Guide
114 VMware, Inc.
Response:
201 Created
Content-Type: application/vnd.vmware.admin.user+xml
...
<Group name="Engineering" type="application/vnd.vmware.admin.group+xml"
href="http://vcloud.example.com/api/v1.0/admin/group/44" ...>
<Link rel="edit" type="application/vnd.vmware.admin.group+xml"
href="http://vcloud.example.com/api/v1.0/admin/group/44"/>
<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"
href="http://vcloud.example.com/api/v1.0/admin/role/102"/>
</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 6‐27foranexampleoftheworkflowforthistypeofrequest.
Remove a Group
AnadministratorcanusetheremovelinkinaGroupbodytoremoveagroupfromavCloud.Example 6‐30
removesthegroupimportedinExample 6‐29.
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 6‐31createsanewrolenamedvAppWranglerandaddsittothe
vCloudshowninExample 6‐2. Theresponse,likeother
responsestorequeststhatcreateanobject,includes
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.