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
Create an Organization Network With a Routed Connection
An organization network with a routed connection is accessible only by this organization, and provides
controlled access to an external network. System administrators and organization administrators can configure
settings to make specific virtual machines accessible from the external network.
When you create an organization network with a routed connection, you actually create two networks joined
by a virtual router. The network outside the firewall is an existing external network. The one inside the firewall
is created from network pool resources. Firewall and NAT parameters for the virtual router are configured in
the Features element of the network's Configuration.
Prerequisites
n
Verify that you are logged in as a system administrator.
n
Retrieve the lists of external networks and network pools. An organization network with a routed
connection requires you to specify an external network and a network pool. See “External Networks and
Network Pools,” on page 121 for information about how to retrieve these lists.
Procedure
1 Choose an external network on which to base the external (outside the firewall) part of the new network.
2 Choose a network pool on which to base the internal (inside the firewall) part of the new network.
3 Create an OrgNetwork element.
The following requirements apply when you are constructing this element:
n
Set the FenceMode to natRouted.
n
Specify the href of the external network you chose in Step 1 in the ParentNetwork element. The type
and name attributes are optional.
n
Specify the href of the network pool you chose in Step 2 in the NetworkPool element. The type and
name attributes are optional.
See the request portion of “Example: Create an Organization Network With a Routed Connection,” on
page 128.
4 POST the OrgNetwork element you created in Step 3 to the URL for adding networks to the organization.
See the request portion of “Example: Create an Organization Network With a Routed Connection,” on
page 128.
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 Organization Network With a Routed Connection,” on
page 128.
Example: Create an Organization Network With a Routed Connection
This example adds a network to the organization created in “Example: Create an Organization,” on page 113.
The new network has a routed connection to an external network. The Configuration includes a
ParentNetwork element that specifies an ExternalNetwork to which to connect. It also includes a NetworkPool,
which provides resources needed to create the internal network inside the firewall.
vCloud API Programming Guide
128 VMware, Inc.