VMware VCLOUD API 1.0 - API - Modify a Role; Remove a Role; View a Right

vCloud API Programming Guide
116 VMware, Inc.
<Link rel="edit" type="application/vnd.vmware.admin.role+xml"
href="http://vcloud.example.com/api/v1.0/admin/role/102"/>
<Link rel="remove" href="http://vcloud.example.com/api/v1.0/admin/role/102"/>
<Description>Create and manage vApps</Description>
<RightReferences>
<RightReference type="application/vnd.vmware.admin.right+xml" name="vApp: View"
href="http://vcloud.example.com/api/v1.0/admin/right/16"/>
<RightReference type="application/vnd.vmware.admin.right+xml"
name="vApp: Power Operations"
href="http://vcloud.example.com/api/v1.0/admin/right/9"/>
<RightReference type="application/vnd.vmware.admin.right+xml"
name="vApp: Download"
href="http://vcloud.example.com/api/v1.0/admin/right/11"/>
<RightReference ... />
...
</RightReferences>
</Role>
Modify a Role
AsystemadministratorcanmodifyaroletoaddorremoverightsorchangethenameoftherolebyPUTting
amodifiedRolebodytotheeditURLoftheRole.SeeExample 6‐27foranexampleoftheworkflowforthis
typeofrequest.
Remove a Role
AsystemadministratorcanusetheremovelinkinaRoleelementtoremovearolefromavCloud.
Example 6‐33removestherolecreatedinExample 6‐31.
Example 6-33. Remove a Role
Request:
DELETE http://vcloud.example.com/api/v1.0/admin/role/102
Response:
204 No Content
View a Right
Asystemadministratorcanview,butnotmodify,thecontentsofaRightelement,asshowninExample 6‐34,
whichprovidesaviewofoneoftheRightReferencesshowninExample 6‐2.
Example 6-34. View a Right
Request:
GET http://vcloud.example.com/api/v1.0/admin/right/7
Response:
200 OK
Content-Type: application/vnd.vmware.admin.right+xml
...
<Right xmlns="http://www.vmware.com/vcloud/v1" name="Catalog: Sharing"
type="application/vnd.vmware.admin.right+xml"
href="http://vcloud.example.com/api/v1.0/admin/right/7" ... >
<Description>Share a Catalog</Description>
<Category>catalog</Category>
</Right>