v2
Creates, updates, deletes, gets or lists a v2 resource.
Overview
| Name | v2 |
| Type | Resource |
| Id | cloudflare.images.v2 |
Fields
The following fields are returned by SELECT queries:
- list
List images response
| Name | Datatype | Description |
|---|---|---|
continuation_token | string | Continuation token to fetch next page. Passed as a query param when requesting List V2 api endpoint. |
images | array |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
list | select | account_id | continuation_token, per_page, sort_order, creator, meta.<field>[<operator>] | List up to 10000 images with up to 1000 results per page. Use the optional parameters below to get a specific range of images. Pagination is supported via continuation_token. Metadata Filtering (Optional): You can optionally filter images by custom metadata fields using the meta.<field>[<operator>]=<value> syntax. Supported Operators: - eq / eq:string / eq:number / eq:boolean - Exact match - in / in:string / in:number - Match any value in list (pipe-separated) Metadata Filter Constraints: - Maximum 5 metadata filters per request - Maximum 5 levels of nesting (e.g., meta.first.second.third.fourth.fifth) - Maximum 10 elements for list operators (in) - Supports string, number, and boolean value types Examples: **List all images:** /images/v2 **Filter by metadata [eq]:** /images/v2?meta.status[eq:string]=active **Filter by metadata [in]:** /images/v2?meta.status[in]=pending|deleted|flagged **Filter by metadata [in:number]:** /images/v2?meta.ratings[in:number]=4|5 **Filter by nested metadata:** /images/v2?meta.region.name[eq]=eu-west **Combine metadata filters with creator:** /images/v2?meta.status[eq]=active&creator=user123 **Multiple metadata filters (AND logic):** /images/v2?meta.status[eq]=active&meta.priority[eq:number]=5 |
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. |
continuation_token | string | |
creator | string | |
meta.<field>[<operator>] | string | Optional metadata filter(s). Multiple filters can be combined with AND logic. Operators: - eq, eq:string, eq:number, eq:boolean - Exact match - in, in:string, in:number - Match any value in pipe-separated list Examples: - meta.status[eq]=active - meta.priority[eq:number]=5 - meta.enabled[eq:boolean]=true - meta.region[in]=us-east|us-west|eu-west |
per_page | number | |
sort_order | string |
SELECT examples
- list
List up to 10000 images with up to 1000 results per page. Use the optional parameters below to get a specific range of images. Pagination is supported via continuation_token. Metadata Filtering (Optional): You can optionally filter images by custom metadata fields using the meta.<field>[<operator>]=<value> syntax. Supported Operators: - eq / eq:string / eq:number / eq:boolean - Exact match - in / in:string / in:number - Match any value in list (pipe-separated) Metadata Filter Constraints: - Maximum 5 metadata filters per request - Maximum 5 levels of nesting (e.g., meta.first.second.third.fourth.fifth) - Maximum 10 elements for list operators (in) - Supports string, number, and boolean value types Examples: **List all images:** /images/v2 **Filter by metadata [eq]:** /images/v2?meta.status[eq:string]=active **Filter by metadata [in]:** /images/v2?meta.status[in]=pending|deleted|flagged **Filter by metadata [in:number]:** /images/v2?meta.ratings[in:number]=4|5 **Filter by nested metadata:** /images/v2?meta.region.name[eq]=eu-west **Combine metadata filters with creator:** /images/v2?meta.status[eq]=active&creator=user123 **Multiple metadata filters (AND logic):** /images/v2?meta.status[eq]=active&meta.priority[eq:number]=5
SELECT
continuation_token,
images
FROM cloudflare.images.v2
WHERE account_id = '{{ account_id }}' -- required
AND continuation_token = '{{ continuation_token }}'
AND per_page = '{{ per_page }}'
AND sort_order = '{{ sort_order }}'
AND creator = '{{ creator }}'
AND meta.<field>[<operator>] = '{{ meta.<field>[<operator>] }}'
;