Defines a vNet and lists the available operations for managing it.
Virtual networks, or vNets, connect the vServers within an account and connect vServers to an external network.
The APIs and CLI provide operations for:
Use either the cloud infrastructure API actions or the cloud infrastructure CLI command to perform these operations.
Describes the types of virtual networks.
A virtual network can be of the following types:
Private vNet – A private vNet is created based on the private network from the network domain of the virtual datacenter (vDC). Private vNets are accessible only within an account. All vServers that have membership of a private vNet in common can communicate freely through that subnet.
Public network – This type of networks can be shared among several accounts in a vDC. All vServers that share a public network also have external communication beyond vDCs and can be used to host public services.
A vServer is a member of one or more vNets. The membership of a vServer must be specified when the vServer is created.
Lists the API action and CLI command for creating a vNet.
A cloud user can create private vNets according to the user requirements and within the limits of the account quota.
A public network available in an account is visible to cloud users. However, a cloud user cannot create a public network. The number of public network IP addresses allocated to the cloud user is controlled by the cloud administrator.
Example 3-9 Creating a vNet using the Cloud Infrastructure API
https://<EnterpriseControllerHostname>/iaas/?Action=CreateVnet&Version=1&AccessKeyId=AK_1&name=privatevnetWebApi&Timestamp=1331058639019&Expires=1331058939019&SignatureMethod=SHA512withRSA&SignatureVersion=1&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST
Example 3-10 Creating a vNet using the Cloud Infrastructure CLI
iaas-create-vnet --base-url https://<EnterpriseControllerHostname>/ --access-key-file ak.file --name myVNET
Lists the API action and CLI command for displaying a vNet.
A cloud user can get information about vNets. The cloud user can restrict the vNets included in the result by specifying filters. If there is no match, no message is returned and the response is empty.
When viewing vNets, a list of available vNets for the account is returned with the following attributes:
ID
Name
Description
Status: In addition to the standard values for status, a vNet reports the NOT CONNECTED status when the vNet is not associated with a vDC server pool. The iaas-connect-vnet
operation connects the vNet to a server pool and changes the status to OK.
IP address
vNet type: public_external or private
Cloud Infrastructure API Action | Cloud Infrastructure CLI Command |
---|---|
Example 3-11 Viewing vNet information using the Cloud Infrastructure API
https://<EnterpriseControllerHostname>/iaas/?Action=DescribeVnets&Version=1&AccessKeyId=AK_3&Timestamp=1318283467620&Expires=1318283767620&SignatureMethod=SHA512withRSA&SignatureVersion=1&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST
Example 3-12 Viewing vNet information using the Cloud Infrastructure CLI
iaas-describe-vnets --base-url https://<EnterpriseControllerHostname>/ -a ak.file
Lists the API action and CLI command for connecting a vNet.
A cloud user can associate a vNet with all the server pools of a vDC.
Cloud Infrastructure API Action | Cloud Infrastructure CLI Command |
---|---|
Example 3-13 Connecting a vNet using the Cloud Infrastructure API
https://<EnterpriseControllerHostname>/iaas/?Action=ConnectVnet&Version=1&AccessKeyId=AK_3&vnet=VNET-00cd848c-771a-4091-b3f4-195a090bbc01&Timestamp=1318283467620&Expires=1318283767620&SignatureMethod=SHA512withRSA&SignatureVersion=1&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST
Example 3-14 Connecting a vNet using the Cloud Infrastructure CLI
iaas-connect-vnet --base-url https://<EnterpriseControllerHostname>/ -a ak.file --vnet VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t
Lists the API action and CLI command for deleting a vNet.
A cloud user can delete only private vNets.
Example 3-15 Deleting a vNet using the Cloud Infrastructure API
https://<EnterpriseControllerHostname>/iaas/?Action=DeleteVnet&Version=1&AccessKeyId=AK_3&vnet=VNET-00cd848c-771a-4091-b3f4-195a090bbc01&Timestamp=1318283467620&Expires=1318283767620&SignatureMethod=SHA512withRSA&SignatureVersion=1&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST
Example 3-16 Deleting a vNet using the Cloud Infrastructure CLI
iaas-delete-vnet --base-url https://<EnterpriseControllerHostname>/ -a ak.file --vnet VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t