This API v2 documentation is currently still on progress. For any issue, please contact support@runcloud.io

RunCloud

Firewall object

GET

/v2/servers/{{serverId}}/security/firewalls/{{firewallId}}

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request GET 'https://manage.runcloud.io/api/v2/servers/{{serverId}}/security/firewalls/{{firewallId}}'

Responses

🟢200Success

application/json

Body

data

array [object {7}]

required

integer

required

Firewall rule ID

type

string

required

Type of firewall rule, either Global or Rich

port

string

required

Port Number

protocol

string

required

Protocol used for the firewall rule

ipAddress

null

required

IP Address

firewallAction

null

required

Accept or reject the IP

created_at

string

required

Time which firewall rule was created at

meta

object

required

pagination

object

required

Pagination details on Firewall Rule

Example

{
  "data": [
    {
      "id": 77,
      "type": "global",
      "port": "22",
      "protocol": "tcp",
      "ipAddress": null,
      "firewallAction": null,
      "created_at": "2024-06-06 04:38:34"
    },
    {
      "id": 79,
      "type": "global",
      "port": "443",
      "protocol": "tcp",
      "ipAddress": null,
      "firewallAction": null,
      "created_at": "2024-06-06 04:38:34"
    },
    {
      "id": 78,
      "type": "global",
      "port": "80",
      "protocol": "tcp",
      "ipAddress": null,
      "firewallAction": null,
      "created_at": "2024-06-06 04:38:34"
    },
    {
      "id": 113,
      "type": "rich",
      "port": "9000",
      "protocol": "tcp",
      "ipAddress": "192.168.43.0/24",
      "firewallAction": "accept",
      "created_at": "2024-07-24 09:16:41"
    }
  ],
  "meta": {
    "pagination": {
      "total": 4,
      "count": 4,
      "per_page": 15,
      "current_page": 1,
      "total_pages": 1,
      "links": {}
    }
  }
}

Modified at 2024-09-04 07:29:10

List firewall rules

Deploy rules to server