Overview

An L3 network is a collection of network configurations for VM instances, including the IP range, gateway, DNS, and network services.
  • An IP range includes the start IP address, end IP address, netmask, and gateway. For example, specify the IP range from 172.20.12.2 to 172.20.12.255, set the netmask to 255.255.0.0, and set the gateway to 172.20.0.1. In addition, you can use a CIDR to specify an IP range, such as 192.168.1.0/24.
  • DNS provides DNS resolution services used for configuring VM networks.

Public Network

Generally, a public network is a type of network wherein anyone has access and through it can directly connect to the Internet. Due to a fact that the public network is a logical concept, you can also customize the public network when you cannot access the Internet. In addition, the public network can provide the network service in a vRouter network and a VPC network.
  • The public network can be used in the flat network environment to create VM instances.
  • The public network can be used in the vRouter network environment to create vRouters.
  • The public network can be used in the VPC network environment to create VPC vRouters.

System Network

A system network is a specific network used by a management node.
  • The system network can be used as a management network to deploy and set related resources, such as a host, primary storage, backup storage, and vRouter.
  • The system network can be used as a migration network to migrate VM instances.
  • Assume that your network resources are insufficient, and that you cannot use a management network separately. Then, the public network will act as the management network.
  • An independent system network can be used in a specific manner, such as managing the vRouter network.
  • The system network cannot be used to create regular VM instances.

Private Network

A private network is known as a business network or an access network. Generally, VM instances use the private network. The private network is specified as the network used by VM instances, and supports three network architecture models: flat network, vRouter network, and VPC network.

Specific Network Scenarios

  • Management Network
    A management network is a type of a system network, which can be used for managing and controlling the corresponding physical resources.
    • For example, when you access a host, a backup storage, a primary storage, and other resources that require an IP address, use the management network.
    • When you create vRouters or VPC vRouters, you need an IP address that can be interconnected between management networks in vRouters or VPC vRouters. With this IP address, you can deploy an agent and obtain messages returned by the agent.
  • Storage Network

    A storage network is the network specified by the shared storage. You can use the storage network to check the health state of a VM instance. We recommend that you plan for an independent storage network in advance to avoid potential risks.

  • VDI Network

    When you create clusters, you can specify CIDR for the VDI network. In the VDI scenario, the network traffics generated by the protocol communication between server side and client side use the VDI network. If you do not make any configuration to the VDI network, notice that the management network will be used by default.

  • Migration Network

    When you create clusters, you can specify CIDR for the migration network, which can be used for VM migrations. If you do not make any configuration to the migration network, notice that the management network will be used for VM migrations.

  • Image Synchronization Network
    An image synchronization network is the network that images can be synchronized among backup storages with the ImageStore type in the same management node.
    • If you have deployed an independent network for synchronizing images, you can specify CIDR for the image synchronization network.
    • If you do not make any configuration to the image synchronization network, the management network will be used by default.
    • If you set both source image store and target image store as the image synchronization network, only the target image store can take effect.
  • Data Network
    A data network is the network where data can transfer between a compute node and a backup storage.
    • If you use an independent data network, you can avoid network congestion, and improve the data transfer rate.
    • If you do not make any configuration to the data network, the management network will be used by default.
  • Backup Network
    ZStack provides backup services, which are add-on licensed features. A backup network is the network where you can back up your local VM instances, volumes, or databases to the local backup storage. Also, the backup network is the network where you can restore the local backup data from the local backup storage.
    • If you deploy an independent network for local backups, you can specify CIDR for the backup network.
    • If you use an independent network, you can avoid network congestion and improve the data transfer rate.
    • If you do not make any configuration to the backup network, note that the management network will be used for local backup by default.
    Note:

    Backup Service is a separate feature module. To use this feature, purchase both the Base License and the Plus License of Backup Service. The Plus License cannot be used independently.

  • Traffic Network

    A traffic network is the specified network of a port mirroring, which can be used to mirror the network traffic in the NIC to remote access. In addition, the traffic network cannot act as other networks, and cannot be used to create VM instances.

Notice

  • When you create VM instances, you can specify multiple networks. That is, you can specify multiple flat networks, vRouter networks, VPC networks, or a combination of flat networks, vRouter networks, and VPC networks.
  • We support multi-layer networks. In addition, the L2 networks of multi-layer networks can intercommunicate. Therefore, you need to pay a special attention to avoid the conflict of IP address spaces.
  • You can create multiple L3 networks by using an L2 network. If the L2 network is the HarewareVxlanNetwork type, the private network that you created can only support the flat network and other corresponding network services rather than vRouter network.

Inventory

Properties

Name Description Optional Optional Value Starting Version
uuid The UUID. For more information, see Resource Property. 0.6
name The name. For more information, see Resource Property. 0.6
description The description. For more information, see Resource Property. Yes 0.6
zoneUuid The zone UUID. For more information, see Zone. 0.6
l2NetworkUuid The parent L2 network UUID. For more information, see L2 Network. 0.6
state The state. For more information, see State.
  • Enabled
  • Disabled
0.6
dnsDomain The DNS domain. For more information, see Domain. Yes 0.6
ipRanges The IP ranges. For more information, see IP Range. 0.6
dns The DNS. For more information, see L3 Network DNS. 0.6
networkServices The network services. For more information, see L3 Network Service Reference. 0.6
type The L3 network type.
  • L3BasicNetwork
0.6
createDate The creation date. For more information, see Resource Property. 0.6
lastOpDate The last operation date. For more information, see Resource Property. 0.6

Sample

{     "inventories": [         {             "category": "Private",             "createDate": "Nov 2, 2017 1:21:40 PM",             "dns": [                 "223.5.5.5"             ],             "ipRanges": [                 {                     "createDate": "Nov 2, 2017 1:21:41 PM",                     "endIp": "10.141.74.100",                     "gateway": "10.141.0.1",                     "l3NetworkUuid": "a0190782ed35439b92959844c96a7323",                     "lastOpDate": "Nov 2, 2017 1:21:41 PM",                     "name": "l3-bp",                     "netmask": "255.255.0.0",                     "networkCidr": "10.141.0.1/16",                     "startIp": "10.141.74.1",                     "uuid": "954f7884656e48a395a022935569b65d"                 }             ],             "l2NetworkUuid": "8f6a39152a72439b9ece210154de0339",             "lastOpDate": "Nov 2, 2017 1:21:40 PM",             "name": "l3-bp",             "networkServices": [                 {                     "l3NetworkUuid": "a0190782ed35439b92959844c96a7323",                     "networkServiceProviderUuid": "a903477ad67746e8a4f773c5e28b5884",                     "networkServiceType": "SecurityGroup"                 },                 {                     "l3NetworkUuid": "a0190782ed35439b92959844c96a7323",                     "networkServiceProviderUuid": "a963ab4a76384a4ab3b88fb39ef627fc",                     "networkServiceType": "Eip"                 },                 {                     "l3NetworkUuid": "a0190782ed35439b92959844c96a7323",                     "networkServiceProviderUuid": "a963ab4a76384a4ab3b88fb39ef627fc",                     "networkServiceType": "DHCP"                 },                 {                     "l3NetworkUuid": "a0190782ed35439b92959844c96a7323",                     "networkServiceProviderUuid": "a963ab4a76384a4ab3b88fb39ef627fc",                     "networkServiceType": "Userdata"                 }             ],             "state": "Enabled",             "system": false,             "type": "L3BasicNetwork",             "uuid": "a0190782ed35439b92959844c96a7323",             "zoneUuid": "e59b71e99d8a4ea1952b578388b8cd1d"         }     ],     "success": true }

State

An L3 network has two available states.
  • Enabled:

    Indicates that new VM instances can be created.

  • Disabled:

    Indicates that new VM instances cannot be created.

DNS Domain

A DNS domain is used to expand hostnames of VM instances on the L3 network to Full Qualified Domain Names (FQDNs). For example, if the hostname of a VM instance is vm1 and the DNS domain of the L3 network is zstack.org, the final hostname of the VM instance will be expanded to vm1.zstack.org.

IP Range

The current ZStack version supports only IPv4 IP range.

Inventory
Name Description Optional Optional Value Starting Version
uuid The UUID. For more information, see Resource Property. 0.6
name The name. For more information, see Resource Property. 0.6
description The description. For more information, see Resource Property. Yes 0.6
startIp The start IP address in the IP range. 0.6
endIp The end IP address in the IP range. 0.6
netmask The netmask. 0.6
gateway The subnet gateway. 0.6
createDate The creation date. For more information, see Resource Property. 0.6
lastOpDate The last operation date. For more information, see Resource Property. 0.6
Sample
{     "inventories": [         {             "createDate": "Oct 30, 2017 3:59:06 PM",             "endIp": "10.141.250.100",             "gateway": "10.141.0.1",             "l3NetworkUuid": "54bc8bea439a49dc82acbe302da05c66",             "lastOpDate": "Oct 30, 2017 3:59:06 PM",             "name": "L3-Flat",             "netmask": "255.255.0.0",             "networkCidr": "10.141.0.1/16",             "startIp": "10.141.250.1",             "uuid": "f0b8e83e4dc646c69c7f9a0ff53b6367"         }     ],     "success": true }

DNS

An L3 network can have one or more DNS take effect when the DNS network service is enabled.

L2 Network and L3 Network

Similar to a layer 2 broadcast domain that can contain multiple subnets, you can create multiple L3 networks on the same L2 network. However, these L3 networks are not isolated from each other, and can be listened, which might be a potential risk.

L3 Network Service Reference

Network service reference denotes the network services enabled on the L3 network and their service providers.

Inventory
Name Description Optional Optional Value Starting Version
l3NetworkUuid The L3 network UUID. 0.6
networkServiceProviderUuid The UUID of the network service provider. 0.6
networkServiceType The network service type.
  • DHCP
  • DNS
  • SNAT
  • PortForwarding
  • EIP
  • SecurityGroup
  • Userdata
  • LoadBalancer
  • IPsec
  • CentralizedDNS
  • VRouterRoute
  • VipQos
0.6
Sample
{     "inventories": [         {             "l3NetworkUuid": "cdb7f3151c50453ba0e8c89356e250f6",             "networkServiceProviderUuid": "a903477ad67746e8a4f773c5e28b5884",             "networkServiceType": "SecurityGroup"         },         {             "l3NetworkUuid": "cdb7f3151c50453ba0e8c89356e250f6",             "networkServiceProviderUuid": "a963ab4a76384a4ab3b88fb39ef627fc",             "networkServiceType": "Userdata"         },         {             "l3NetworkUuid": "cdb7f3151c50453ba0e8c89356e250f6",             "networkServiceProviderUuid": "a963ab4a76384a4ab3b88fb39ef627fc",             "networkServiceType": "DHCP"         }     ],     "success": true }

Address Pool Inventory

Name Description Optional Optional Value Starting Version
uuid The UUID. For more information, see Resource Property. 3.9.0
name The name. For more information, see Resource Property. 3.9.0
description The description. For more information, see Resource Property. 3.9.0
l3NetworkUuid The L3 network UUID. 3.9.0
startIp The start IP address. 3.9.0
endIp The end IP address. 3.9.0
netmask The netmask. 3.9.0
gateway The gateway. 3.9.0
networkCidr The network CIDR. 3.9.0
ipVersion The IP version. 3.9.0
addressMode The allocation mode of the IPv6 address. 3.9.0
prefixLen The length of the netmask. 3.9.0
ipRangeType The IP range type.
  • Normal
  • AddressPool
3.9.0
groupBy Groups rows into subgroups based on values of columns or expressions. This field is equivalent to the Group By clause in MySQL, such as groupBy=type. Yes 3.9.0
createDate The creation date. For more information, see Resource Property 3.9.0
lastOpDate The last operation date. For more information, see Resource Property 3.9.0
userTags The user tags. For more information, see CreateUserTag. Yes 3.9.0
systemTags The system tags. For more information, see CreateSystemTag. Yes 3.9.0
Sample
{   "inventories": [     {       "l3NetworkUuid": "81ce7828f3f63c0ea8a69dd9139bdaa0",       "name": "Test-IPRange",       "networkCidr": "192.168.10.0/24",       "ipRangeType": "AddressPool"     }   ] }





























Back to Top

Download

Already filled the basic info?Click here.

Enter at least 2 characters.
Invalid mobile number.
Enter at least 4 characters.
Invalid email address.
Wrong code. Try again. Send Code Resend Code (60s)

An email with a verification code will be sent to you. Make sure the address you provided is valid and correct.

Download

Not filled the basic info yet? Click here.

Invalid email address or mobile number.

Email Us

contact@zstack.io
ZStack Training and Certification
Enter at least 2 characters.
Invalid mobile number.
Enter at least 4 characters.
Invalid email address.
Wrong code. Try again. Send Code Resend Code (60s)

Email Us

contact@zstack.io
Request Trial
Enter at least 2 characters.
Invalid mobile number.
Enter at least 4 characters.
Invalid email address.
Wrong code. Try again. Send Code Resend Code (60s)

Email Us

contact@zstack.io

The download link is sent to your email address.

If you don't see it, check your spam folder, subscription folder, or AD folder. After receiving the email, click the URL to download the documentation.

The download link is sent to your email address.

If you don't see it, check your spam folder, subscription folder, or AD folder.
Or click on the URL below. (For Internet Explorer, right-click the URL and save it.)

Thank you for using ZStack products and services.

Submit successfully.

We'll connect soon.

Thank you for using ZStack products and services.