Loading...
 

Get Firewall Details


HTTP VerbGET
URI Template/account/{accID}/node/{nodeID}/firewall
MIME Typeapplication/vnd.pncp.v.1.0+json onwards
Normal HTTP Response Code200 OK
Invoked ByResellers can invoke this for their own account as well as any other account they own. End-clients can invoke this for their account only.
Response ModeSynchronous.

Sample Request

GET /pncp-external-api-rest/account/88/node/1/firewall HTTP/1.1
Accept: application/vnd.pncp.v.5.0+json
Authorization: PNCP Q7x4qkpHwmWYzMk7CKJvKWZyScIlJaYY1fFWMuMB1lI=
Content-Length: 0
User-Agent: Jakarta Commons-HttpClient/3.1
Host: YOUR_API_URL

Sample Response

HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
Pragma: no-cache
Expires: Thu, 01 Jan 1970 00:00:00 GMT
Cache-Control: no-cache
Cache-Control: no-store
Content-Type: application/vnd.pncp.v.5.0+json
Transfer-Encoding: chunked
Date: Tue, 31 Jan 2012 15:54:24 GMT

 {
   "firewallStatus":"ON",
   "lastUpdatedTimestamp":"2012/01/31 15:49:43",
   "firewallRules":[
      {
         "name":"rule1",
         "destinationIp":"ANY",
         "destinationPort":"8080",
         "sourceIp":"ANY",
         "sourcePort":"ANY",
         "firewallProtocol":"TCP",
         "firewallRuleAction":"ALLOW",
         "rulePriority":10545,
         "active":true
      }
   ]
}

Notes

  • firewallStatus can be set to NOT_PROVISIONED, ON, OFF or REMOTE_ONLY.
  • lastUpdatedTimestamp is a date of format yyyy/MM/dd HH:mm:ss.
  • sourceIp can be one of the following:
    • ANY (any IP),
    • An IP range (e.g. 64.38.194.0 – 64.38.194.255), or
    • A subnet mask (e.g. 64.38.194.0/24).
  • sourcePort and destinationPort can be set to multiple ports separated by commas (e.g. 8080, 8443) or to ranges (e.g. 8080-8085).
  • destinationIp can be set to either ANY or a public IP of one of the account’s virtual machines.
  • The higher the value of rulePriority, the lower the priority of the rule.