VMware VCLOUD API 1.0 - API

VMware, Inc. 99
Chapter 6 Administrative Operations
Remove an Organization
AnorganizationadministratorcanusetheremovelinkinanAdminOrgbodytoremovetheorganizationfrom
thevCloud.Example 6‐8doesthis,makingaDELETErequesttotheremovelinkreturnedinExample 6‐4.
Example 6-8. Remove an Organization
Request:
DELETE http://vcloud.example.com/api/v1.0/admin/org/26
Response:
204 No Content
Network Administration
Anewlycreatedorganizationhasnonetworksinit.Anorganizationadministratormustcreatean
organizationnetworkfromresourcesprovidedbyoneoftheexternalnetworkslistedintheNetworkselement
oftheVCloudresponse(seeExample 6‐2onpage 94).
View the Properties of an External Network
Tocreateanorganizationnetwork,andorganizationadministratormustchooseaparentnetworkfromoneof
thenetworksgroupedintheNetworkselementofthecloud.Togetmoreinformationaboutanyofthese
networks,anadministratorcanmakeaGETrequesttothenetwork’sURL(thehrefelementofthe
Network
element).Example 6‐9makessucharequesttothehrefofaNetworkelementreturnedinExample 6‐2on
page 94.TheresponseisanExternalNetworkelementthatshowstheConfigurationandotherproperties
ofthenetwork,includingaProviderInfoelementthatspecifiesdetailsoftheunderlyingvSpherenetwork.
The
ExternalNetworkelementisread‐only.
Example 6-9. View the Properties of an External Network
Request:
GET http://vcloud.example.com/api/v1.0/admin/network/7
Response:
200 OK
Content-Type:pplication/vnd.vmware.admin.network+xm
...
<ExternalNetwork xmlns="http://www.vmware.com/vcloud/v1"
href="http://vcloud.example.com/api/v1.0/admin/network/7"
name="ExternalNetwork-VC1" ...>
<Description>VLAN 7</Description>
<Configuration>
...
</Configuration>
<ProviderInfo>
NETWORK:dvportgroup-1587 on com.vmware.vcloud.entity.vimserver:1043863313
</ProviderInfo>
</ExternalNetwork>
NOTEBeforeyoucanremoveanorganization,youmustdisableitanddeleteorchangeownershipofall
objectsthattheorganizationusersown.