Organization Administration - VMware VCLOUD API 1.0 - API Programming Manual

vCloud API Programming Guide
Example 6-2. List the Top-Level Administrative Objects in a vCloud
Request:
GET http://vcloud.example.com/api/v1.0/admin
Response:
200 OK
Content-Type: application/vnd.vmware.admin.vcloud+xml
...
<VCloud name="vCloud" href="http://vcloud.example.com/api/v1.0/admin" ...>
<Link rel="add" type="application/vnd.vmware.admin.role+xml"
<Link rel="add" type="application/vnd.vmware.admin.organization+xml"
<Description>Example Corporation's vCloud</Description>
<OrganizationReferences>
<OrganizationReference type="application/vnd.vmware.admin.organization+xml"
<OrganizationReference ... />
...
</OrganizationReferences>
<ProviderVdcReferences>
<ProviderVdcReference type="application/vnd.vmware.admin.providervdc+xml"
<ProviderVdcReference ... />
...
</ProviderVdcReferences>
<RightReferences>
<RightReference type="application/vnd.vmware.admin.right+xml name="vApp_Deploy"
<RightReference type="application/vnd.vmware.admin.right+xml name="Catalog: Sharing"
<RightReference ... />
...
</RightReferences>
<RoleReferences>
<RoleReference type="application/vnd.vmware.admin.role+xml"
<RoleReference type="application/vnd.vmware.admin.role+xml" name="Catalog Creator"
<RoleReference ... />
...
</RoleReferences>
<Networks>
<Network type="application/vnd.vmware.admin.network+xml" name="ExternalNetwork-VC1"
<Network type="application/vnd.vmware.admin.network+xml" name="ExternalNetwork-VC2"
<Network ... />
...
</Networks>
</VCloud>

Organization Administration

An AdminOrg is an extended representation of an Org object, and is accessed at API‐URL/admin/org/id,
rather than API‐URL/org/id. Although system administrators work with AdminOrg elements to create and
modify organizations, most modifications to an AdminOrg also modify some user‐visible property of the
corresponding Org.
94
href="http://vcloud.example.com/api/v1.0/admin/roles"/>
href="http://vcloud.example.com/api/v1.0/admin/orgs"/>
name="Engineering"
href="http://vcloud.example.com/api/v1.0/admin/org/44"/>
name="Main Provider"
href="http://vcloud.example.com/api/v1.0/admin/providervdc/2"/>
href="http://vcloud.example.com/api/v1.0/admin/right/3"/>
href="http://vcloud.example.com/api/v1.0/admin/right/7"/>
name="Organization Administrator"
href="http://vcloud.example.com/api/v1.0/admin/role/102"/>
href="http://vcloud.example.com/api/v1.0/admin/role/103"/>
href="http://vcloud.example.com/api/v1.0/admin/network/7"/>
href="http://vcloud.example.com/api/v1.0/admin/network/33"/>
VMware, Inc.