Modify A Role; Remove A Role; View A Right - VMware VCLOUD API 1.0 - API Programming Manual

vCloud API Programming Guide
<Link rel="edit" type="application/vnd.vmware.admin.role+xml"
<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"
<RightReference type="application/vnd.vmware.admin.right+xml"
<RightReference type="application/vnd.vmware.admin.right+xml"
<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
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
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
which provides a view of one of the RightReferences shown in Example
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"
<Description>Share a Catalog</Description>
<Category>catalog</Category>
</Right>
116
href="http://vcloud.example.com/api/v1.0/admin/role/102"/>
href="http://vcloud.example.com/api/v1.0/admin/right/16"/>
name="vApp: Power Operations"
href="http://vcloud.example.com/api/v1.0/admin/right/9"/>
name="vApp: Download"
href="http://vcloud.example.com/api/v1.0/admin/right/11"/>
type="application/vnd.vmware.admin.right+xml"
href="http://vcloud.example.com/api/v1.0/admin/right/7" ... >
6‐27 for an example of the workflow for this
6‐31.
6‐2.
6‐34,
VMware, Inc.