firewall-ruleset

Create firewall ruleset rule

Creates a new firewall ruleset rule by the given {ruleset-uuid}.

post/1.3/firewall-ruleset/{ruleset-uuid}/rule

Request

  • Base URL: https://api.upcloud.com
  • URL: https://api.upcloud.com/1.3/firewall-ruleset/{ruleset-uuid}/rule
  • Auth: HTTP bearer

Path parameters

ruleset-uuidstring uuid required

The unique identifier for the server.

Example:01234567-89ab-cdef-0123-456789abcdef

Firewall ruleset UUID

Request body

enabledboolean

Enabled

action'accept' | 'drop' required

Rule action.

commentstring

Comments

destination_address_startstring ip-address
destination_address_endstring ip-address
destination_port_startinteger
destination_port_endinteger
destination_address_cidrstring
direction'in' | 'out' required

Rule direction.

family'IPv4' | 'IPv6' | '' required

Rule family.

icmp_typeinteger

ICMP type.

positioninteger
protocol'tcp' | 'udp' | 'icmp' | 'esp' | 'ah' | 'all' | ''

Rule protocol.

source_address_startstring ip-address
source_address_endstring ip-address
source_port_startinteger
source_port_endinteger
source_address_cidrstring

Example request

{
  "direction": "in",
  "action": "accept",
  "family": "IPv4",
  "protocol": "tcp",
  "enabled": false
}

Response

Created

uuidstring uuid

The unique identifier for the server.

enabledboolean

Enabled

actionunknown required
commentstring

Comments

destination_address_startstring ip-address
destination_address_endstring ip-address
destination_port_startinteger
destination_port_endinteger
destination_address_cidrstring
directionunknown required
familyunknown required
icmp_typeinteger
positioninteger
protocolunknown
source_address_startstring ip-address
source_address_endstring ip-address
source_port_startinteger
source_port_endinteger
source_address_cidrstring ip-address

Example response

{
  "uuid": "16e7d7fc-9a90-4f42-83f5-ea0396f1592b",
  "direction": "in",
  "action": "accept",
  "family": "IPv4",
  "protocol": "tcp",
  "enabled": false
}

Changes

No recorded changes to this operation across all 1 revision of this API.