Skip to main content

resources

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

Overview

Nameresources
TypeResource
Idcloudflare.resource_tagging.resources

Fields

The following fields are returned by SELECT queries:

List tagged resources response.

NameDatatypeDescription
idstringIdentifies the unique resource. (example: 023e105f4ecef8ad9ca31a8372d0c353)
namestringHuman-readable name of the resource. (example: my-worker-script)
access_application_idstring (uuid)Access application ID is required only for access_application_policy resources (example: f174e90a-fafe-4643-bbbc-4a0ed4fc8415)
worker_idstringWorker ID is required only for worker_version resources (example: 3f72a691-44b3-4c11-8642-c18a88ddaa5e)
zone_idstringZone ID is required only for zone-level resources (example: 023e105f4ecef8ad9ca31a8372d0c353)
etagstringETag identifier for optimistic concurrency control. Formatted as "v1:<hash>" where the hash is the base64url-encoded SHA-256 (truncated to 128 bits) of the tags map canonicalized using RFC 8785 (JSON Canonicalization Scheme). Clients should treat ETags as opaque strings and pass them back via the If-Match header on write operations. (example: v1:RBNvo1WzZ4oRRq0W9-hkng)
tagsobjectContains key-value pairs of tags.
typestring (access_application)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
listselectaccount_idtype, tag, cursorLists all tagged resources for an account.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
account_idstringThe Cloudflare account ID.
cursorstringCursor for pagination.
tagarrayFilter resources by tag criteria. This parameter can be repeated multiple times, with AND logic between parameters. Supported syntax: - Key-only: tag=<key> - Resource must have the tag key (e.g., tag=production) - Key-value: tag=<key>=<value> - Resource must have the tag with specific value (e.g., tag=env=prod) - Multiple values (OR): tag=<key>=<v1>,<v2> - Resource must have tag with any of the values (e.g., tag=env=prod,staging) - Negate key-only: tag=!<key> - Resource must not have the tag key (e.g., tag=!archived) - Negate key-value: tag=<key>!=<value> - Resource must not have the tag with specific value (e.g., tag=region!=us-west-1) Multiple tag parameters are combined with AND logic.
typearrayFilter by resource type. Can be repeated to filter by multiple types (OR logic). Example: ?type=zone&type=worker

SELECT examples

Lists all tagged resources for an account.

SELECT
id,
name,
access_application_id,
worker_id,
zone_id,
etag,
tags,
type
FROM cloudflare.resource_tagging.resources
WHERE account_id = '{{ account_id }}' -- required
AND type = '{{ type }}'
AND tag = '{{ tag }}'
AND cursor = '{{ cursor }}'
;