VMware VCLOUD API 1.0 - API - Organization Administration

vCloud API Programming Guide
94 VMware, Inc.
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"
href="http://vcloud.example.com/api/v1.0/admin/roles"/>
<Link rel="add" type="application/vnd.vmware.admin.organization+xml"
href="http://vcloud.example.com/api/v1.0/admin/orgs"/>
<Description>Example Corporation’s vCloud</Description>
<OrganizationReferences>
<OrganizationReference type="application/vnd.vmware.admin.organization+xml"
name="Engineering"
href="http://vcloud.example.com/api/v1.0/admin/org/44"/>
<OrganizationReference ... />
...
</OrganizationReferences>
<ProviderVdcReferences>
<ProviderVdcReference type="application/vnd.vmware.admin.providervdc+xml"
name="Main Provider"
href="http://vcloud.example.com/api/v1.0/admin/providervdc/2"/>
<ProviderVdcReference ... />
...
</ProviderVdcReferences>
<RightReferences>
<RightReference type="application/vnd.vmware.admin.right+xml name="vApp_Deploy"
href="http://vcloud.example.com/api/v1.0/admin/right/3"/>
<RightReference type="application/vnd.vmware.admin.right+xml name="Catalog: Sharing"
href="http://vcloud.example.com/api/v1.0/admin/right/7"/>
<RightReference ... />
...
</RightReferences>
<RoleReferences>
<RoleReference type="application/vnd.vmware.admin.role+xml"
name="Organization Administrator"
href="http://vcloud.example.com/api/v1.0/admin/role/102"/>
<RoleReference type="application/vnd.vmware.admin.role+xml" name="Catalog Creator"
href="http://vcloud.example.com/api/v1.0/admin/role/103"/>
<RoleReference ... />
...
</RoleReferences>
<Networks>
<Network type="application/vnd.vmware.admin.network+xml" name="ExternalNetwork-VC1"
href="http://vcloud.example.com/api/v1.0/admin/network/7"/>
<Network type="application/vnd.vmware.admin.network+xml" name="ExternalNetwork-VC2"
href="http://vcloud.example.com/api/v1.0/admin/network/33"/>
<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.