datasets

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

Overview

Name	datasets
Type	Resource
Id	cloudflare.ai_gateway.datasets

Fields

The following fields are returned by SELECT queries:

get

Returns a single object if found

Name	Datatype	Description
id	string
name	string
gateway_id	string	gateway id
created_at	string (date-time)
enable	boolean
filters	array
modified_at	string (date-time)

list

List objects

Name	Datatype	Description
id	string
name	string
gateway_id	string	gateway id
created_at	string (date-time)
enable	boolean
filters	array
modified_at	string (date-time)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	account_id, gateway_id, id		Retrieves details for a specific AI Gateway dataset.
list	select	account_id, gateway_id	page, per_page, name, enable, search	Lists all AI Gateway evaluator types configured for the account.
create	insert	gateway_id, account_id, name, filters, enable		Creates a new AI Gateway.
update	replace	account_id, gateway_id, id, name, filters, enable		Updates an existing AI Gateway dataset.
delete	delete	account_id, gateway_id, id		Deletes an AI Gateway dataset.

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.
gateway_id	string	The AI Gateway ID.
id	string	Resource ID.
enable	boolean
name	string
page	integer
per_page	integer
search	string

SELECT examples

get

Retrieves details for a specific AI Gateway dataset.

SELECT
id,
name,
gateway_id,
created_at,
enable,
filters,
modified_at
FROM cloudflare.ai_gateway.datasets
WHERE account_id = '{{ account_id }}' -- required
AND gateway_id = '{{ gateway_id }}' -- required
AND id = '{{ id }}' -- required
;

list

Lists all AI Gateway evaluator types configured for the account.

SELECT
id,
name,
gateway_id,
created_at,
enable,
filters,
modified_at
FROM cloudflare.ai_gateway.datasets
WHERE account_id = '{{ account_id }}' -- required
AND gateway_id = '{{ gateway_id }}' -- required
AND page = '{{ page }}'
AND per_page = '{{ per_page }}'
AND name = '{{ name }}'
AND enable = '{{ enable }}'
AND search = '{{ search }}'
;

INSERT examples

create

Creates a new AI Gateway.

INSERT INTO cloudflare.ai_gateway.datasets (
enable,
filters,
name,
gateway_id,
account_id
)
SELECT 
{{ enable }} /* required */,
'{{ filters }}' /* required */,
'{{ name }}' /* required */,
'{{ gateway_id }}',
'{{ account_id }}'
RETURNING
result,
success
;

Manifest

# Description fields are for documentation purposes
- name: datasets
props:
  - name: gateway_id
    value: "{{ gateway_id }}"
    description: Required parameter for the datasets resource.
  - name: account_id
    value: "{{ account_id }}"
    description: Required parameter for the datasets resource.
  - name: enable
    value: {{ enable }}
  - name: filters
    value:
      - key: "{{ key }}"
        operator: "{{ operator }}"
        value: "{{ value }}"
  - name: name
    value: "{{ name }}"

REPLACE examples

update

Updates an existing AI Gateway dataset.

REPLACE cloudflare.ai_gateway.datasets
SET 
enable = {{ enable }},
filters = '{{ filters }}',
name = '{{ name }}'
WHERE 
account_id = '{{ account_id }}' --required
AND gateway_id = '{{ gateway_id }}' --required
AND id = '{{ id }}' --required
AND name = '{{ name }}' --required
AND filters = '{{ filters }}' --required
AND enable = {{ enable }} --required
RETURNING
result,
success;

DELETE examples

delete

Deletes an AI Gateway dataset.

DELETE FROM cloudflare.ai_gateway.datasets
WHERE account_id = '{{ account_id }}' --required
AND gateway_id = '{{ gateway_id }}' --required
AND id = '{{ id }}' --required
;