Ports

A port is a virtual network card to which a mapping of MAC address and IP address is assigned.An IP address is assigned to a port within the subnet in which the port resides.

Ports are used to connect devices to private subnets, global router subnets, and public subnets.If you disconnect a port from a device, it will also be disconnected from the subnet. A private subnet cannot be deleted if it has at least one port.

You can work with ports in the control panel, using the OpenStack CLI or Terraform.

In cloud networks, service ports are automatically created and management is not available:

• two DHCP ports on a private subnet. Created when DHCP is enabled on the subnet, deleted when DHCP is disabled;
• three service ports on the global router subnet for network equipment. Created when the private network is connected to the global router, deleted when the private network is disconnected from the global router or when the global router is removed;
• VRRP ports and downlinks on the private subnets where the load balancer resides. The number of service ports depends on the type of load balancer, see Load Bal ancer Ports for details;
• port on the private subnet where the file storage is located. Created together with the subnet for the file storage, can be deleted only with the storage.

Add a port to a subnet⁠

Private subnet, global router subnet

Control panel

1. In the dashboard, on the top menu, click Products and select Cloud Servers.

2. Go to Network → Private Networks tab.

3. Open the Network page → Ports tab.

4. Click Add Port.

5. Select a subnet.

6. Enter the IP address of the port.

7. Optional: select the server or Managed Kubernetes cluster node to which you want to add this port.

8. Click Add Port.

OpenStack CLI

1. Open the OpenStack CLI.

2. Create a port on the subnet:

   openstack port create \
     --network <network> \
     --fixed-ip subnet=<subnet>,ip-address=<port_ip_address> \
     <port_name>

   Specify:

   • <network> — The ID or name of the private network, the global router network, can be viewed with the command openstack network list;
   • <subnet> — The ID or subnet name can be viewed with the command openstack subnet list;
   • <port_ip_address> — The IP address of the port;
   • <port_name> — port name.

Public subnet

Control panel

1. In the dashboard, on the top menu, click Products and select Cloud Servers.

2. Go to Network → Public Networks tab.

3. Open the subnet card → Ports tab.

4. Click Add Port.

5. Select a subnet.

6. Enter the IP address of the port.

7. Click Add Port.

OpenStack CLI

1. Open the OpenStack CLI.

2. Create a port on the subnet:

   openstack port create \
     --network <network> \
     --fixed-ip subnet=<subnet>,ip-address=<port_ip_address> \
     <port_name>

   Specify:

   • <network> — ID or name of the public network, matches the parameter <subnet> can be viewed with the command openstack subnet list;
   • <subnet> — The ID or subnet name can be viewed with the command openstack subnet list;
   • <port_ip_address> — The IP address of the port;
   • <port_name> — port name.

Add a cloud server or Managed Kubernetes cluster node to the subnet via port⁠

A cloud server can be added to a private subnet, a global router subnet, or a public subnet after server creation. The Managed Kubernetes cluster node can be added to a private subnet or a global router subnet.

To do this, you need to add a port to the server or node.

Control panel

1. In the dashboard, on the top menu, click Products and select Cloud Servers.
2. Go to the Servers section.
3. Open the server page → Ports tab.
4. Click Add Port.
5. Select private subnet, global router subnet, or public subnet.
6. Enter the IP address of the port.
7. Click Add.

OpenStack CLI

1. Open the OpenStack CLI.

2. Create a port on the subnet:

   openstack port create \
     --network <network> \
     --fixed-ip subnet=<subnet>,ip-address=<port_ip_address> \
     <port_name>

   Specify:

   • <network> — The ID or name of a private subnet, global router subnet, or public subnet can be viewed with the command openstack network list. For a public subnet it is the same as the parameter <subnet>;
   • <subnet> — The ID or subnet name can be viewed with the command openstack subnet list;
   • <port_ip_address> — The IP address of the port;
   • <port_name> — port name.

3. Add a port to the cloud server:

   openstack server add port <server> <port>

   Specify:

   • <server> — The ID or name of the cloud server can be viewed with the command openstack server list;
   • <port> — The port ID or name can be viewed with the command openstack port list.

Connect a public IP address to a port on a private subnet⁠

If a cloud server or load balancer is connected to a port on the private subnet, you can connect a public IP address to the port.

To connect a public IP address in the device sections of the Control Panel, use the Public IP Addresses instructions.

Control panel

1. Make sure the device is on a subnet that meets the requirements. To prepare the subnet, use the instructions Prepare a private subnet to connect a public IP address.
2. In the dashboard, on the top menu, click Products and select Cloud Servers.
3. Go to Network → Private Networks tab.
4. Open the Network page → Ports tab.
5. In the port card of the cloud server or load balancer, click Connect Public IP.
6. Select a public IP address.
7. Click Connect.

OpenStack CLI

1. Open the OpenStack CLI.

2. Connect a public IP address to the port:

   openstack floating ip set --port <port> <public_ip_address>

   Specify:

   • <port> — The port ID of a cloud server or load balancer can be viewed with the command openstack port list;
   • <public_ip_address> — ID, or public IP address, can be viewed with the command openstack floating ip list.

Disconnect a public IP address from a port on a private subnet⁠

To disable the public IP address in the device sections in the Control Panel, use the Public IP Addresses instructions.

Control panel

1. In the dashboard, on the top menu, click Products and select Cloud Servers.
2. Go to Network → Private Networks tab.
3. Open the Network page → Ports tab.
4. In the port card of the cloud server or load balancer, next to the public IP address, click .
5. Select Disable public IP address.
6. Optional: If you no longer need the public IP address, check the Delete Address checkbox.
7. Click Save.

OpenStack CLI

1. Open the OpenStack CLI.

2. Disconnect the public IP address from the port:

   openstack floating ip unset --port <public_ip_address>

   Specify <public_ip_address> — The ID or public IP address, can be viewed using the openstack floating ip list command.

Assign a security group to a port⁠

To assign a security group on the Cloud Server page in the Control Panel, use the Assign Security Group instructions.

To be able to assign a security group to a port, port security must be enabled on the port network. You can view the filtering status of the network in the Control Panel: from the top menu, click Products → Cloud Servers → Network → Private Networks or Public Networks tab . A network with filtering enabled is marked with a .

Private subnet, global router subnet

Control panel

1. In the Dashboard, on the top menu, click Products and select Cloud Servers.

2. Go to Network → Private Networks tab.

3. Open the Network page → Ports tab.

4. In the port card, in the security groups field, click .If security group selection is not available, port security is disabled on the network .To use security groups, create a new private network.

5. In the Security Groups field, check the groups you want to assign to the port, or click New Security Group and create a group.

6. Click Save.

OpenStack CLI

1. Open the OpenStack CLI.

2. Make sure that port security is enabled on the network — the port_security_enabled field is set to true:

   openstack network show <network>

   Specify <network> — The ID or name of the network.

   If the port_security_enabled field is false, create a new private network to use the security groups.

3. Assign a security group to the port:

   openstack port set \
     --security-group <security_group> \
     <port>

   Specify:

   • <security_group> — The ID or name of the security group can be viewed with the command openstack security group list;
   • <port> — The port ID or name can be viewed with the command openstack port list.

Public subnet

Control panel

1. In the Dashboard, on the top menu, click Products and select Cloud Servers.

2. Go to Network → Public Networks tab.

3. Open the subnet card → Ports tab.

4. On the port row in the Security Groups field. click .If security group selection is not available. the network has disabled port security.To use security groups . create a new public subnet.

5. In the Security Groups field, check the groups you want to assign to the port, or click New Security Group and create a group.

6. Click Save.

OpenStack CLI

1. Open the OpenStack CLI.

2. Make sure that port security is enabled on the subnet — the port_security_enabled field is set to true:

   openstack subnet show <subnet>

   Specify <subnet> — The ID or name of the subnet.

   If the port_security_enabled field is false, create a new public subnet to use the security groups.

3. Assign a security group to the port:

   openstack port set \
     --security-group <security_group> \
     <port>

   Specify:

   • <security_group> — The ID or name of the security group can be viewed with the command openstack security group list;
   • <port> — The port ID or name can be viewed with the command openstack port list.

Disconnect the security group from the port⁠

Private subnet, global router subnet

Control panel

1. In the dashboard, on the top menu, click Products and select Cloud Servers.

2. Go to Network → Private Networks tab.

3. Open the Network page → Ports tab.

4. In the port card, in the Security Groups field, click .

5. In the Security Groups field, uncheck the checkboxes of the groups that you want to disconnect from the port.

6. Click Save.

OpenStack CLI

1. Open the OpenStack CLI.

2. Disconnect the security group from the port:

   openstack port unset \
     --security-group <security_group> \
     <port>

   Specify:

   • <security_group> — The ID or name of the security group can be viewed with the command openstack security group list;
   • <port> — The port ID or name can be viewed with the command openstack port list.

Public subnet

Control panel

1. In the dashboard, on the top menu, click Products and select Cloud Servers.

2. Go to Network → Public Networks tab.

3. Open the subnet card → Ports tab.

4. On the port line, in the Security Groups field, click .

5. In the Security Groups field, uncheck the checkboxes of the groups that you want to disconnect from the port.

6. Click Save.

OpenStack CLI

1. Open the OpenStack CLI.

2. Disconnect the security group from the port:

   openstack port unset \
     --security-group <security_group> \
     <port>

   Specify:

   • <security_group> — The ID or name of the security group can be viewed with the command openstack security group list;
   • <port> — The port ID or name can be viewed with the command openstack port list.

Add authorized IP/MAC addresses per port⁠

If port security is enabled on the network, port traffic can only be sent from one IP/MAC address pair, which is assigned when the port is added to the subnet. If traffic is sent through the port from addresses that are not specified on the port, such traffic will be blocked. To allow traffic from addresses that are not listed on the port, you must add the allowed IP/MAC addresses to the port settings.

For example, if you have self-deployed on a cloud server:

• VPN server — you must allow all IP addresses (subnet 0.0.0.0/0);
• Kubernetes cluster with CNI Calico in Direct routing mode — you need to allow the subnet that is used in the cluster. No configuration is required for CNI Flannel.

If the additional addresses are not needed, you can remove them from the port.

You do not need to configure authorized addresses in Managed Kubernetes clusters, cloud databases, ready-made 1C cloud, as well as on cloud servers created from images with applications. All necessary settings for them have already been made.

A maximum of 10 additional IP/MAC address pairs can be added per port.

Private subnet, global router subnet

Control panel

1. In the dashboard, on the top menu, click Products and select Cloud Servers.

2. Go to Network → Private Networks tab.

3. Open the Network page → Ports tab.

4. In the port card, in the Security Groups field, click .

5. If you want to allow all IP addresses, click Allow All IP Addresses for VPN. Traffic from the 0.0.0.0/0 subnet with the default port MAC address will be allowed.

6. If you want to allow traffic from specific addresses:

   6.1.Click Add IP/MAC Pair.

   6.2.Enter the IP address or subnet in CIDR format.

   6.3.Optional: Enter a MAC address that matches the IP address, or leave the MAC address of the default port.

   6.4.To add another address pair, repeat steps 6.1 through 6.3.

7. Click Save.

OpenStack CLI

1. Open the OpenStack CLI.

2. Add resolved addresses:

   openstack port set \
     --allowed-address ip-address=<ip_address>[,mac-address=<mac_address>] \
     <port>

   Specify:

   • <ip_address> — IP address or subnet. If you want to allow all IP addresses, enter subnet 0.0.0.0/0;
   • optional: , mac-address=<mac_address> is the MAC address corresponding to the IP address. The parameter <mac_address> is the MAC address value. If you do not specify a MAC address, the port's primary MAC address will be used;
   • <port> — The port ID can be viewed with the command openstack port list.

Public subnet

Control panel

1. In the dashboard, on the top menu, click Products and select Cloud Servers.

2. Go to Network → Public Networks tab.

3. Open the subnet card → Ports tab.

4. On the port line, in the Security Groups field, click .

5. If you want to allow all IP addresses, click Allow All IP Addresses for VPN. Traffic from the 0.0.0.0/0 subnet with the default port MAC address will be allowed.

6. If you want to allow traffic from specific addresses:

   6.1.Click Add IP/MAC Pair.

   6.2.Enter the IP address or subnet in CIDR format.

   6.3.Optional: Enter a MAC address that matches the IP address, or leave the MAC address of the default port.

   6.4.To add another address pair, repeat steps 6.1 through 6.3.

7. Click Save.

OpenStack CLI

1. Open the OpenStack CLI.

2. Add resolved addresses:

   openstack port set \
     --allowed-address ip-address=<ip_address>[,mac-address=<mac_address>] \
     <port>

   Specify:

   • <ip_address> — IP address or subnet. If you want to allow all IP addresses, enter subnet 0.0.0.0/0;
   • optional: , mac-address=<mac_address> is the MAC address corresponding to the IP address. The parameter <mac_address> is the MAC address value. If you do not specify a MAC address, the default port MAC address will be used;
   • <port> — The port ID can be viewed with the command openstack port list.

Remove authorized IP/MAC addresses from the port⁠

Private subnet, global router subnet

Control panel

1. In the Dashboard, on the top menu, click Products and select Cloud Servers.

2. Go to Network → Private Networks tab.

3. Open the Network page → Ports tab.

4. In the port card, in the Security Groups field, click .

5. In the address pair row, click .

6. Click Save.

OpenStack CLI

1. Open the OpenStack CLI.

2. Remove the allowed addresses from the port. The IP/MAC address pair that was assigned when the port was created will remain allowed:

   openstack port set \
     --no-allowed-address \
     <port>

Public subnet

Control panel

1. In the dashboard, on the top menu, click Products and select Cloud Servers.

2. Go to Network → Public Networks tab.

3. Open the subnet card → Ports tab.

4. On the port line, in the Security Groups field, click .

5. In the address pair row, click .

6. Click Save.

OpenStack CLI

1. Open the OpenStack CLI.

2. Remove the allowed addresses from the port. The IP/MAC address pair that was assigned when the port was created will remain allowed:

   openstack port set \
     --no-allowed-address \
     <port>

Enable port⁠

Private subnet, global router subnet

Control panel

1. In the Dashboard, on the top menu, click Products and select Cloud Servers.

2. Go to Network → Private Networks tab.

3. Open the Network page → Ports tab.

4. In the port card, enable the port.

OpenStack CLI

1. Open the OpenStack CLI.

2. Look at the list of ports in the subnet and copy the ID or name of the desired port:

   openstack port list --fixed-ip subnet=<subnet>

   Specify <subnet> — The ID or name of the subnet, can be viewed with the openstack subnet list command.

3. Turn on the port:

   openstack port set --enable <port>

   Specify <port> — The port ID or name you copied in step 2.

Public subnet

Control panel

1. In the dashboard, on the top menu, click Products and select Cloud Servers.

2. Go to Network → Public Networks tab.

3. Open the subnet card → Ports tab.

4. In the port line, enable the port.

OpenStack CLI

1. Open the OpenStack CLI.

2. Look at the list of ports in the subnet and copy the ID or name of the desired port:

   openstack port list --fixed-ip subnet=<subnet>

   Specify <subnet> — The ID or name of the subnet, can be viewed with the openstack subnet list command.

3. Turn on the port:

   openstack port set --enable <port>

   Specify <port> — The port ID or name you copied in step 2.

Disable the port⁠

Private subnet, global router subnet

Control panel

1. In the dashboard, on the top menu, click Products and select Cloud Servers.

2. Go to Network → Private Networks tab.

3. Open the Network page → Ports tab.

4. In the port card, disable the port.

OpenStack CLI

1. Open the OpenStack CLI.

2. Look at the list of ports in the subnet and copy the ID or name of the desired port:

   openstack port list --fixed-ip subnet=<subnet>

   Specify <subnet> — The ID or name of the subnet, can be viewed with the openstack subnet list command.

3. Disconnect the port:

   openstack port set --disable <port>

   Specify <port> — The port ID or name you copied in step 2.

Public subnet

Control panel

1. In the dashboard, on the top menu, click Products and select Cloud Servers.

2. Go to Network → Public Networks tab.

3. Open the subnet card → Ports tab.

4. In the port row, disable the port.

OpenStack CLI

1. Open the OpenStack CLI.

2. Look at the list of ports in the subnet and copy the ID or name of the desired port:

   openstack port list --fixed-ip subnet=<subnet>

   Specify <subnet> — The ID or name of the subnet, can be viewed with the openstack subnet list command.

3. Disconnect the port:

   openstack port set --disable <port>

   Specify <port> — The port ID or name you copied in step 2.

Delete port⁠

Private subnet, global router subnet

Control panel

1. In the dashboard, on the top menu, click Products and select Cloud Servers.

2. Go to Network → Private Networks tab.

3. Open the Network page → Ports tab.

4. In the port card, click .

   If the button is inactive , a device that prohibits removal is connected to the port . Remove this device and return to step 1.

   Use the instructions to remove the device:

   • remove the cloud router;
   • remove the Managed Kubernetes cluster;
   • delete file storage;
   • remove the load balancer.

5. Click Delete.

OpenStack CLI

1. Open the OpenStack CLI.

2. Look at the list of ports in the subnet and copy the ID or name of the desired port:

   openstack port list --fixed-ip subnet=<subnet>

   Specify <subnet> — The ID or name of the subnet, can be viewed with the openstack subnet list command.

3. Delete the port:

   openstack port delete <port>

   Specify <port> — The port ID or name you copied in step 2.

Public subnet

Control panel

1. In the dashboard, on the top menu, click Products and select Cloud Servers.

2. Go to Network → Public Networks tab.

3. Open the subnet card → Ports tab.

4. On the port line, click .

5. Click Delete.

OpenStack CLI

1. Open the OpenStack CLI.

2. Look at the list of ports in the subnet and copy the ID or name of the desired port:

   openstack port list --fixed-ip subnet=<subnet>

   Specify <subnet> — The ID or name of the subnet, can be viewed with the openstack subnet list command.

3. Delete the port:

   openstack port delete <port>

   Specify <port> — The port ID or name you copied in step 2.