update-intra-dc-firewall-policy.md

{{{ "title": "Update Intra Data Center Firewall Policy", "date": "6-12-2015", "author": "Jared Ruckle", "attachments": [] }}}

Updates a given firewall policy associated with a given account in a given data center (an "intra data center firewall policy"). Calls to this operation must include a token acquired from the authentication endpoint. See the Login API for information on acquiring this token.

When to Use It

Use this API operation when you need to update a firewall policy in a given data center for a given account.

NOTE: This API operation is experimental only, and subject to change with no notice. Please plan accordingly.

URL

Structure

PUT https://api.ctl.io/v2-experimental/firewallPolicies/{sourceAccountAlias}/{dataCenter}/{firewallPolicy}

Example

PUT https://api.ctl.io/v2-experimental/firewallPolicies/SRC_ALIAS/WA1/e46ef2500e1011e5b9390800200c9a66

Request

URI Parameters

Name	Type	Description	Req.
sourceAccountAlias	string	Short code for a particular account	Yes
dataCenter	string	Short string representing the data center associated with the policy of interest. Valid codes can be retrieved from the [Get Data Center List](../Data Centers/get-data-center.md) API operation.	Yes
destinationAccountAlias	string	Short code for a particular account	No

Content Properties

Name	Type	Description	Req.
enabled	boolean	Indicates if the policy is enabled (true) or disabled (false)	No
source	string	Source addresses for traffic on the originating firewall, specified using CIDR notation	No
destination	string	Destination addresses for traffic on the terminating firewall, specified using CIDR notation	No
ports	string	Type of ports associated with the policy. Supported ports include: any, icmp, TCP and UDP with single ports (tcp/123, udp/123) and port ranges (tcp/123-456, udp/123-456). Some common ports include: tcp/21 (for FTP), tcp/990 (FTPS), tcp/80 (HTTP 80), tcp/8080 (HTTP 8080), tcp/443 (HTTPS 443), icmp (PING), tcp/3389 (RDP), and tcp/22 (SSH/SFTP).	No

Examples

JSON

{
    "enabled":false,
    "source":["123.45.678.1/32"],
    "destination":["234.4.678.2/32"],
    "ports":["udp/8080"]
}

Response

Entity Definition

The response will not contain JSON content, but should return the HTTP 204 No Content response upon the successful update of firewall policy attributes.