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
status="running"
startTime="2011-06-28T10:31:39.788-07:00"
operationName="networkCreateOrgNetwork"
operation="Creating Network RoutedOrgNetwork(54)"
expiryTime="2011-10-06T10:31:39.788-07:00"
...
</Task>
</Tasks>
<Configuration>
...
</Configuration>
<NetworkPool
href="https://vcloud.example.com/api/admin/extension/networkPool/313" />
<AllowedExternalIpAddresses />
</OrgNetwork>
Add a Virtual Private Network to a Routed Organization Network
An organization network with a routed connection can include a virtual private network feature. You can
include the virtual private network when you create the organization network, or you can add it later.
The Features element of an organization network with a routed connection can define a virtual private network
(VPN) with zero or more tunnels. Virtual machines can use these tunnels for secure communications between
organization networks in a single cloud, between two clouds, or between a cloud and any external IP address.
You can include the definition of an IpsecVpnService when you create an organization network. This procedure
shows how to add one later, and provides a generalized procedure for updating any kind of organization
network.
Prerequisites
Verify that you are logged in as a system administrator.
Procedure
1 Retrieve a routed organization network.
Use a request like this one:
GET https://vcloud.example.com/api/admin/network/59
2 Insert an IpsecVpnService element into the Features of the retrieved OrgNetwork.
3 POST the modified OrgNetwork element to the network's edit URL.
Example: Add a Virtual Private Network to a Routed Organization Network
This example adds a VPN to the organization network created in “Example: Create an Organization Network
With a Routed Connection,” on page 128. Start with the OrgNetwork element from the response to the request
made in Step 1
<OrgNetwork
xmlns="http://www.vmware.com/vcloud/v1.5"
name="RoutedOrgNetwork"
id="urn:vcloud:network:59"
type="application/vnd.vmware.vcloud.network+xml"
href="https://vcloud.example.com/api/admin/network/59" ... >
<VCloudExtension
required="false">
<vmext:VimObjectRef>
<vmext:VimServerRef
Chapter 6 Creating, Provisioning, and Managing Organizations
VMware, Inc. 131