resources
Creates, updates, deletes, gets or lists a resources resource.
Overview
| Name | resources |
| Type | Resource |
| Id | cloudflare.resource_tagging.resources |
Fields
The following fields are returned by SELECT queries:
- list
List tagged resources response.
| Name | Datatype | Description |
|---|---|---|
id | string | Identifies the unique resource. (example: 023e105f4ecef8ad9ca31a8372d0c353) |
name | string | Human-readable name of the resource. (example: my-worker-script) |
access_application_id | string (uuid) | Access application ID is required only for access_application_policy resources (example: f174e90a-fafe-4643-bbbc-4a0ed4fc8415) |
worker_id | string | Worker ID is required only for worker_version resources (example: 3f72a691-44b3-4c11-8642-c18a88ddaa5e) |
zone_id | string | Zone ID is required only for zone-level resources (example: 023e105f4ecef8ad9ca31a8372d0c353) |
etag | string | ETag 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) |
tags | object | Contains key-value pairs of tags. |
type | string | (access_application) |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
list | select | account_id | type, tag, cursor | Lists 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.
| Name | Datatype | Description |
|---|---|---|
account_id | string | The Cloudflare account ID. |
cursor | string | Cursor for pagination. |
tag | array | Filter 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. |
type | array | Filter by resource type. Can be repeated to filter by multiple types (OR logic). Example: ?type=zone&type=worker |
SELECT examples
- list
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 }}'
;