Assign a firewall group to a virtual server

Assign a specific firewall group to a virtual server (VM). This is useful for applying network rules to your server to enhance security. The endpoint returns an ID to track the assignment status.

Path Parameters

vmid integer · min: 1 required Example

Unique vmid identifier

Headers

Accept Example

Content-Type Example

Body

required

application/json

groupId string required

Responses

200

success boolean

timestamp string

requestId string

data object

POST https://cloud.hostup.se/api/vm/{vmid}/firewall/group

For AI assistants

cURL

curl -X POST "https://cloud.hostup.se/api/vm/17394/firewall/group" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "groupId": "string"
  }'

Response

{
  "success": true,
  "timestamp": "string",
  "requestId": "string",
  "data": {
    "assignment": {
      "id": "string",
      "group_id": "string",
      "hostbill_account_id": "string",
      "client_id": 0,
      "proxmox_vm_id": "string",
      "server_id": "string",
      "last_applied_at": "string",
      "last_applied_status": "string",
      "last_error": "string",
      "created_at": "string",
      "updated_at": "string"
    },
    "message": "string"
  }
}

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "timestamp": {
      "type": "string"
    },
    "requestId": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "properties": {
        "assignment": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "group_id": {
              "type": "string"
            },
            "hostbill_account_id": {
              "type": "string"
            },
            "client_id": {
              "type": "integer"
            },
            "proxmox_vm_id": {
              "type": "string"
            },
            "server_id": {
              "type": "string"
            },
            "last_applied_at": {
              "type": "string"
            },
            "last_applied_status": {
              "type": "string"
            },
            "last_error": {
              "type": "string",
              "nullable": true
            },
            "created_at": {
              "type": "string"
            },
            "updated_at": {
              "type": "string"
            }
          }
        },
        "message": {
          "type": "string"
        }
      }
    }
  }
}

Request Body

{
  "groupId": "string"
}