diff --git a/openapi.yaml b/openapi.yaml index f626886f0..8674475ec 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -10319,15 +10319,20 @@ paths: description: | Creates a Firewall to filter network traffic. Use the `rules` property to create inbound and outbound access rules. Use the `devices` property to assign the - Firewall to a Linode service. Currently, Firewalls can only be assigned to Linode + Firewall to a service. Currently, Firewalls can only be assigned to Linode instances. - A Firewall can be assigned to a single Linode service at a time. + A Firewall can be assigned to multiple Linode instances at a time. + + A Linode instance can have one active, assigned Firewall at a time. + Additional disabled Firewalls can still be added to a Linode instance. A `firewall_create` Event is generated when this endpoint returns successfully. - Cloud Firewall is not available in every data center region. For the current list of availability, access the Regions List ([GET /regions](/docs/api/regions/#regions-list)) endpoint or see the [Cloud Firewall Product Documentation](https://www.linode.com/docs/products/networking/cloud-firewall/).notice will be removed when this endpoint is out of - beta. + Cloud Firewall is not fully available in every data center region. For the current list + of locations with full availability, access the Regions List ([GET /regions](/docs/api/regions/#regions-list)) + endpoint or see the [Cloud Firewall Product Documentation](https://www.linode.com/docs/products/networking/cloud-firewall/). + Certain Regions have partial Firewall availability operationId: createFirewalls x-linode-cli-action: create security: @@ -10350,23 +10355,14 @@ paths: properties: devices: type: object - description: > - A Firewall Device assigns a Firewall to a Linode service. Currently, Firewalls - can only be assigned to Linode instances. - - * A Firewall can be assigned to a single Linode service at a time. - - * Additional disabled Firewalls can be assigned to a service, but they cannot be enabled if five other active Firewalls - are already assigned to the same service. - - - **Note:** When a Firewall is assigned to a Linode and you attempt - to [migrate the Linode to a data center](/docs/api/linode-instances/#dc-migrationpending-host-migration-initiate) that does not support Cloud Firewalls, the migration will fail. - Use the [List Regions](/docs/api/regions/#regions-list) endpoint to view a list of a data center's capabilities. + description: | + Devices to create for this Firewall. + When a Device is created, the Firewall is assigned to its associated service. + Currently, Devices can only be created for Linode instances. properties: linodes: description: > - An array of Linode IDs. A Firewall Device will be created for each ID. + An array of Linode IDs. A Firewall Device is created for each ID. type: array items: type: integer @@ -17070,6 +17066,7 @@ components: x-linode-cli-display: 5 status: type: string + readOnly: true description: > The status of this Firewall. @@ -20940,8 +20937,7 @@ components: description: | Information about your status in our referral program. - This information becomes accessible after this Profile's Account has established at - least $25.00 USD of total payments. + This information becomes accessible after this Profile's Account has established at least $25.00 USD of total payments. readOnly: true properties: code: