firewalls

Creates, updates, deletes, gets or lists a firewalls resource.

Overview

Name	firewalls
Type	Resource
Id	digitalocean.firewalls.firewalls

Fields

Name	Datatype	Description
column_anon	``

Methods

Name	Accessible by	Required Params	Description
firewalls_get	SELECT	firewall_id	To show information about an existing firewall, send a GET request to /v2/firewalls/$FIREWALL_ID.
firewalls_list	SELECT		To list all of the firewalls available on your account, send a GET request to /v2/firewalls.
firewalls_create	INSERT		To create a new firewall, send a POST request to /v2/firewalls. The request must contain at least one inbound or outbound access rule.
firewalls_delete	DELETE	firewall_id	To delete a firewall send a DELETE request to /v2/firewalls/$FIREWALL_ID. No response body will be sent back, but the response code will indicate success. Specifically, the response code will be a 204, which means that the action was successful with no returned body data.
firewalls_update	EXEC	firewall_id	To update the configuration of an existing firewall, send a PUT request to /v2/firewalls/$FIREWALL_ID. The request should contain a full representation of the firewall including existing attributes. Note that any attributes that are not provided will be reset to their default values.

SELECT examples

To list all of the firewalls available on your account, send a GET request to /v2/firewalls.

SELECT
column_anon
FROM digitalocean.firewalls.firewalls
;

INSERT example

Use the following StackQL query and manifest file to create a new firewalls resource.

All Properties

/*+ create */
INSERT INTO digitalocean.firewalls.firewalls (
data__name,
data__droplet_ids,
data__tags,
data__inbound_rules,
data__outbound_rules
)
SELECT 
'{{ name }}',
'{{ droplet_ids }}',
'{{ tags }}',
'{{ inbound_rules }}',
'{{ outbound_rules }}'
;

Manifest

- name: firewalls
  props:
    - name: name
      value: string
    - name: droplet_ids
      value: array
    - name: tags
      value: array
    - name: inbound_rules
      value: array
      props:
        - name: protocol
          value: string
        - name: ports
          value: string
        - name: sources
          props:
            - name: addresses
              value: array
            - name: droplet_ids
              value: array
            - name: load_balancer_uids
              value: array
            - name: kubernetes_ids
              value: array
            - name: tags
              value: array
    - name: outbound_rules
      value: array
      props:
        - name: protocol
          value: string
        - name: ports
          value: string
        - name: destinations
          props:
            - name: addresses
              value: array
            - name: droplet_ids
              value: array
            - name: load_balancer_uids
              value: array
            - name: kubernetes_ids
              value: array
            - name: tags
              value: array

DELETE example

Deletes the specified firewalls resource.

/*+ delete */
DELETE FROM digitalocean.firewalls.firewalls
WHERE firewall_id = '{{ firewall_id }}';