workers_scripts
Creates, updates, deletes, gets or lists a workers_scripts resource.
Overview
| Name | workers_scripts |
| Type | Resource |
| Id | cloudflare.workers.workers_scripts |
Fields
The following fields are returned by SELECT queries:
- list
List Workers response.
| Name | Datatype | Description |
|---|---|---|
id | string | The name used to identify the script. (example: my-workers-script) |
compatibility_date | string | Date indicating targeted support in the Workers runtime. Backwards incompatible fixes to the runtime following this date will not affect this Worker. (example: 2021-01-01) |
compatibility_flags | array | Flags that enable or disable certain features in the Workers runtime. Used to enable upcoming features or opt in or out of specific changes not included in a compatibility_date. (x-stainless-collection-type: set) |
created_on | string (date-time) | When the script was created. (example: 2017-01-01T00:00:00Z) |
etag | string | Hashed script content, can be used in a If-None-Match header when updating. (example: ea95132c15732412d22c1476fa83f27a) |
handlers | array | The names of handlers exported as part of the default export. |
has_assets | boolean | Whether a Worker contains assets. |
has_modules | boolean | Whether a Worker contains modules. |
last_deployed_from | string | The client most recently used to deploy this Worker. (example: wrangler) |
logpush | boolean | Whether Logpush is turned on for the Worker. |
migration_tag | string | The tag of the Durable Object migration that was most recently applied for this Worker. (example: v1) |
modified_on | string (date-time) | When the script was last modified. (example: 2017-01-01T00:00:00Z) |
named_handlers | array | Named exports, such as Durable Object class implementations and named entrypoints. |
observability | object | Observability settings for the Worker. |
placement | object | Configuration for Smart Placement. Specify mode='smart' for Smart Placement, or one of region/hostname/host. |
placement_mode | string | Configuration for Smart Placement. Specify mode='smart' for Smart Placement, or one of region/hostname/host. (smart, targeted) |
placement_status | string | Status of Smart Placement. (SUCCESS, UNSUPPORTED_APPLICATION, INSUFFICIENT_INVOCATIONS) |
routes | array | Routes associated with the Worker. |
tag | string | The immutable ID of the script. (example: e8f70fdbc8b1fb0b8ddb1af166186758) |
tags | array | Tags associated with the Worker. (x-stainless-collection-type: set) |
tail_consumers | array | List of Workers that will consume logs from the attached Worker. (x-stainless-collection-type: set) |
usage_model | string | Usage model for the Worker invocations. (standard, bundled, unbound) (default: standard, example: standard) |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
list | select | account_id | tags | Fetch a list of uploaded workers. |
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. |
tags | string | Filter scripts by tags. Format: comma-separated list of tag:allowed pairs where allowed is 'yes' or 'no'. |
SELECT examples
- list
Fetch a list of uploaded workers.
SELECT
id,
compatibility_date,
compatibility_flags,
created_on,
etag,
handlers,
has_assets,
has_modules,
last_deployed_from,
logpush,
migration_tag,
modified_on,
named_handlers,
observability,
placement,
placement_mode,
placement_status,
routes,
tag,
tags,
tail_consumers,
usage_model
FROM cloudflare.workers.workers_scripts
WHERE account_id = '{{ account_id }}' -- required
AND tags = '{{ tags }}'
;