1.5
Table Of Contents
- vCloud API Programming Guide
- Contents
- vCloud API Programming Guide
- About the VMware vCloud API
- Hello vCloud: A Simplified RESTful Workflow
- Exploring a Cloud
- Provisioning an Organization with vApps, Templates, and Media
- Deploying and Operating vApps
- Summary of vCloud API vApp and Virtual Machine Operations Requests
- Create a vApp From a Template
- Compose a vApp From Existing Virtual Machines
- Recompose a vApp to Add or Remove Virtual Machines
- Operate a vApp
- Configuring vApps and Virtual Machines
- Retrieve the Configuration Links for a vApp
- Retrieve the Configuration Links for a Virtual Machine
- Retrieve or Update a Modifiable Section
- Update a vApp Network Configuration
- Update the NetworkConnectionSection of a Virtual Machine
- Retrieve or Modify the CPU Configuration of a Virtual Machine
- Retrieve or Modify the GuestCustomizationSection of a Virtual Machine
- Retrieve or Modify ProductSection Elements
- Retrieve or Modify Groups of Related Sections in a Virtual Machine
- Retrieve or Modify the Hard Disk Configuration of a Virtual Machine
- Creating, Provisioning, and Managing Organizations
- Summary of Administrative Requests
- Administrator Credentials and Privileges
- Organization Administration
- Network Administration
- vDC Administration
- Catalog Administration
- User and Group Administration
- Working With Roles and Rights
- Controlling Access to vApps and Catalogs
- Using vCloud API Extensions to Provision and Manage a Cloud
- Working With Object Metadata
- Using the Query Service
- Configuring and Using Blocking Tasks and Notifications
- XML Representations in the vCloud API
- Index
The response is a Task element. When the task is complete, the network is updated.
Response:
202 Accepted
Content-Type: application/vnd.vmware.vcloud.task+xml
...
<Task ...
operation="Updating Network RoutedOrgNetwork (59)" ... >
...
</Task>
Create an Isolated Organization Network
An isolated organization network is accessible only by the organization for which it is created. Only virtual
machines in this organization can connect to and see traffic on the isolated network.
Prerequisites
n
Verify that you are logged in as a system administrator.
n
Retrieve the list of network pools. See “External Networks and Network Pools,” on page 121 for
information about how to retrieve these lists.
Procedure
1 Choose a network pool on which to base the internal (inside the firewall) part of the new network.
2 Create an OrgNetwork element.
Specify the name and href of the network pool you chose in Step 1 in the NetworkPool element of this
OrgNetwork. See the request portion of “Example: Create an Isolated Organization Network,” on
page 136.
3 POST the OrgNetwork element you created in Step 2 to the URL for adding networks to the organization.
See the request portion of “Example: Create an Isolated Organization Network,” on page 136.
The server creates the new organization network, and returns an OrgNetwork element that includes the contents
you POSTed, along with a set of Link elements that you can use to access, remove, or modify it. Users can
reference this network using the URL specified in the href attribute of the Link where rel="alternate". The
new network is added to the list of Networks shown in the AdminOrg element that represents the organization.
See the response portion of “Example: Create an Isolated Organization Network,” on page 136.
Example: Create an Isolated Organization Network
This example adds an isolated network with a DHCP service to the organization created in “Example: Create
an Organization,” on page 113. The Configuration does not need a ParentNetwork element. All the resources
needed by the network come from the specified NetworkPool. Set the FenceMode to isolated.
Request:
POST https://vcloud.example.com/api/admin/org/26/networks
Content-Type: application/vnd.vmware.admin.orgNetwork+xml
...
<?xml version="1.0" encoding="UTF-8"?>
<OrgNetwork
name="IsolatedOrgNet"
xmlns="http://www.vmware.com/vcloud/v1.5">
<Description>Isolated Organization Network</Description>
<Configuration>
<FenceMode>isolated</FenceMode>
vCloud API Programming Guide
136 VMware, Inc.