Create a VM firewall rule

Adds an inbound/outbound rule, or attaches a project security group (type=group).

Authorization

bearerAuth

AuthorizationBearer <token>

API key created in the portal (Settings → API Keys). Send as Authorization: Bearer <key>.

In: header

Path Parameters

project_uuid*string

Project UUID.

vmid*integer

VM identifier (VMID).

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Create or update a VM firewall rule, or attach a security group.

pos?integer

Rule position to update (required for PUT).

position?integer

Insert at this position (POST). Omit to append.

type*string

in / out for a packet filter, or group to attach a security group.

Value in

"in"
"out"
"group"

action*string

ACCEPT or DROP, or the security-group identifier when type is group.

proto?string

Required for in / out rules.

Value in

"tcp"
"udp"
"icmp"

source?string

Source address, CIDR, or IP set.

dest?string

Destination address, CIDR, or IP set.

sport?string

Source port or range.

dport?string

Destination port or range.

comment?string

Optional comment.

enable*boolean

Whether the rule is enabled.

Response Body

`application/json`

curl -X POST "https://example.com/cloud/project/string/vm/0/firewall/rules/" \  -H "Content-Type: application/json" \  -d '{    "type": "in",    "action": "string",    "enable": true  }'

{  "message": "string"}