[New] Firewall Endpoints (#223)

* Adding POST/Firewall Work in Progress DO NOT MERGE

* First changes

* More edits to Post Firewalls

* Update POST /networking/firewalls

Updates reflect latest dev changes to collection.

* Improve description text for POST /networking/firewalls

Add information about inbound and outbound behavior.

* added beta server and indents

* Remove unnecessary quotations from examples

* Add GET /networking/firewalls/{firewallId}

* Update Shell request example for POST /networking/firewalls

* Update ipv6 example to display as list.

* Added DELETE /firewalls/:id endpoint

Also:
- Add Beta endpoint notice to GET /firewalls/:id endpoint
- Change path parameter description to read something more generic, as it's shared now with DELETE

* PUT Firewall endpoint

* Update example request URLs to match endpoints

* Added GET /networking/firewalls endpoint

* Update PUT /firewalls/{firewallId}

* Fix typo in Delete Firewall endpoint

* Added Add Firewall Devices endpoint

POST /networking/firewalls/{firewallId}/devices

* Add `firewall_device_add` event

* Firewall collection updates

Reviewed existing Firewall endpoints and schemas

Added:
- GET /networking/firewalls/{firewallId}/devices
- POST /networking/firewalls/{firewallId}/devices
- GET /networking/firewalls/{firewallId}/devices/{deviceId}
- DELETE /networking/firewalls/{firewallId}/devices/{deviceId}
- GET /networking/firewalls/{firewallId}/rules
- POST /networking/firewalls/{firewallId}/rules

* Add events for firewalls

* Fix typo that appears across firewall endpoints

* [Update] FirewallRuleConfig

- Refactor the start_port and end_port properties into a single
ports property
- Remove the ALL protocol
- Copy edit of some other firewall endpoints and schemas

* [Update] Firewall limits

Inserting descriptions for these limits:
- Up to three active Firewalls per Device
- Up to 25 Rules per Firewall
- Up to 255 addresses or networks per Rule
- Up to 15 pieces in a Rule's ports string

Did not include a description of how an Account's Firewall limit
is the same as the Account's thing limit, as we do not describe
the thing limit in other areas of the API reference.

* Update List Firewalls shell example

* Add List Firewalls OAuth scope.

* Fix Delete Firewall and Delete Firwall Device response

This also fixes CLI build error.

* Update Create Firewall Device's CLI example

* Update Create Firewall's CLI example

* Fix Travis errors

POST /{firewall_id}/devices missing allOf array

* Add label character limits to Firewall collection.

* Update status field for Firewall schema

Added information about the different available Firewall
statuses.

* Update PUT /firewalls/{firewallId}

Shell example had incorrect formatting.

* Fix Shell example for /firewalls/{firewallId}/devices

* Fix shell example for PUT /firewalls/{firewallId}/rules

* Fix shell example POST /firewalls

Missing curly brace

* Update requestBody for POST /firewalls

status field is readOnly for this endpoint. Created
the request body by referencing individual Firewall Schema properties.
status field is not readOnly for all Firewall endpoints (i.e. PUT
/firewalls/{firewallId}

* Add note: Linode migration will fail if DC does not support Firewalls

* Fix Delete Firewall shell example

* Fix shell example: Create Firewall Device

* Fix shell example: Delete Firewall Device

* Fix shell example: Update Firewall Rules

* Minor copy edit

* Small copy edit suggested by jottinger.

Co-authored-by: hzoppetti <[email protected]>
Co-authored-by: Andy Stevens <[email protected]>
Co-authored-by: nmelehan <[email protected]>
Co-authored-by: nmelehan <[email protected]>

Author: 4 people