Skip to main content

tags

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

Overview

Nametags
TypeResource
Iddigitalocean.firewalls.tags

Fields

SELECT not supported for this resource, use SHOW METHODS to view available operations for the resource.

Methods

NameAccessible byRequired ParamsDescription
firewalls_add_tagsINSERTfirewall_id, data__tagsTo assign a tag representing a group of Droplets to a firewall, send a POST request to /v2/firewalls/$FIREWALL_ID/tags. In the body of the request, there should be a tags attribute containing a list of tag names. 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_delete_tagsDELETEfirewall_id, data__tagsTo remove a tag representing a group of Droplets from a firewall, send a DELETE request to /v2/firewalls/$FIREWALL_ID/tags. In the body of the request, there should be a tags attribute containing a list of tag names. 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.

INSERT example

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

/*+ create */
INSERT INTO digitalocean.firewalls.tags (
data__tags,
firewall_id
)
SELECT
'{{ tags }}',
'{{ firewall_id }}'
;

DELETE example

Deletes the specified tags resource.

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