Skip to navigation
API Referencenetwork-acls

Create a new Network ACL Rule for an ACL List

Authentication

X-API-Client-IDstring
API Client ID
X-API-Client-Secretstring
API Client Secret

Path parameters

listIdstringRequired
ID of the Network ACL List

Request

This endpoint expects an object.
cidrListstringRequired

Remote CIDR — source CIDR for Ingress rules, destination CIDR for Egress rules.

protocolstringRequired

Protocol the rule applies to. One of TCP, UDP, ICMP, or ALL.

actionstringRequired
Whether to allow or deny matching traffic.
trafficTypestringRequired
Direction of traffic the rule applies to.
numberstringOptional

Rule number (1-1000). Unique within the ACL list and determines evaluation order.

startPortintegerOptional1-65535

Start of the port range. Used for TCP and UDP protocols.

endPortintegerOptional1-65535

End of the port range. Used for TCP and UDP protocols.

icmpTypestringOptional

ICMP message type. Used for the ICMP protocol.

icmpCodestringOptional

ICMP message code. Used for the ICMP protocol.

Response

The Network ACL Rule has been created
idstringformat: "uuid"
Unique identifier for the ACL rule.
aclListIdstringformat: "uuid"
Identifier of the ACL list the rule belongs to.
numberinteger
Rule number. Determines evaluation order within the ACL list.
protocolstring

Protocol the rule applies to. One of TCP, UDP, ICMP, or ALL.

cidrListstring

Remote CIDR — source CIDR for Ingress rules, destination CIDR for Egress rules.

actionstring
Whether matching traffic is allowed or denied.
trafficTypestring
Direction of traffic the rule applies to.
startPortintegerOptional

Start of the port range. Used for TCP and UDP protocols.

endPortintegerOptional

End of the port range. Used for TCP and UDP protocols.

icmpTypeintegerOptional

ICMP message type. Used for the ICMP protocol.

icmpCodeintegerOptional

ICMP message code. Used for the ICMP protocol.

createdAtdatetimeOptional
When the rule was created.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error