Learn about the Armor API

The API follows basic RESTful conventions and uses HTTP methods to describe the type of request that is being submitted.

In general, endpoints follow these guidelines:

Method	Description
GET	Use this method to receive an array of objects from a collection. You can also use this method to receive a specific item from the collection.
POST	Use this method to create an object.
PUT	Use this method to update an object. Here, you will update the entire object.
PATCH	Use this method to update an object. Here, you will only submit the specific properties that should be updated.
DELETE	Use this method to delete an object.

Name	Description	Type	Required
id	The ID of the firewall rule	Integer	Optional
destinations	Array of RuleMember objects	Array	Required
sources	Array of RuleMember objects	Array	Required
services	Array of Service objects	Array	Required
action	Allow, block	Enumeration	Required
name	Name of the firewall rule	String	Required
description	Description of the firewall rule	String	Optional
sortOrder	Sort Order for the firewall rule	Integer	Required
isEnabled	Specifies whether the rule is enabled	Boolean	Required
readonly	Reserved for Armor defined rules, should always be false	Boolean	Required

Name	Description	Type	Required
id	The ID of the rule member	Integer	Required
name	The Name of the rule member	String	Required
type	"group," "any"	Enumeration	Required
values	Array of network addresses	Array	Optional (Only if type is group)

Name	Description	Type	Required
id	ID of the service	Integer	Required
deviceId	ID of the device the service belongs to	Integer	Required
location	Name of the location	String	Required
name	Name of the service	String	Required
description	Name of the description	String	Optional
values	Array of ServiceValue	Array	Required

Name	Description	Type	Required
port	Port of the service to open. Eithis this or minimum/maximum port ranges must be specified.	Integer	Optional
protocol	tcp, udp, icmp	Enumeration	Required
subprotocol	ICMP protocol only. Available enum values: "echo-reply", "echo-request", "destination-unreachable", "source-quench", "time-exceeded"	Enumeration	Optional
minimum	The minimumport range for the service. If this is specified, maximum is required. Either this or "port" should be specified.	Integer	Optional
maximum	The maximum port range for the service. If this is specified, minimum is required. Either this or "port" should be specified.	Integer	Optional

Return	Description
200	Your request is successful.
202	Your request is accepted, but may take longer than usual to complete.
400	Your request failed.
404	Your resource does not exist. For example, the virtual machine you specified does not exist.
500	An error occurred on the server side and cannot process the request.