dataset_versions

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

Overview

Name	dataset_versions
Type	Resource
Id	aws.bedrock_agentcore_control.dataset_versions

Fields

The following fields are returned by SELECT queries:

list_dataset_versions

Name	Datatype	Description
created_at	string (date-time)	The timestamp when this version was published.
dataset_version	string	The version number of this published snapshot. (pattern: <code>(DRAFT|[0-9]+)</code>)
example_count	integer (int64)	The number of examples in this version.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_dataset_versions	select	dataset_id, region	nextToken, maxResults	Lists all published versions of a dataset, sorted by version number descending (newest first). Does not include the DRAFT working copy.
create_dataset_version	insert	dataset_id, region		Publishes the current DRAFT as a new numbered version. The DRAFT is preserved and remains editable after publishing. Returns immediately with status UPDATING. Poll GetDataset until status transitions to ACTIVE or UPDATE_FAILED.

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
dataset_id	string	The unique identifier of the dataset to publish a version for.
region	string	AWS region (default: us-east-1)
maxResults	integer	The maximum number of versions to return per page.
nextToken	string	The token for the next page of results.

SELECT examples

list_dataset_versions

Lists all published versions of a dataset, sorted by version number descending (newest first). Does not include the DRAFT working copy.

SELECT
created_at,
dataset_version,
example_count
FROM aws.bedrock_agentcore_control.dataset_versions
WHERE dataset_id = '{{ dataset_id }}' -- required
AND region = '{{ region }}' -- required
AND nextToken = '{{ nextToken }}'
AND maxResults = '{{ maxResults }}'
;

INSERT examples

create_dataset_version

Publishes the current DRAFT as a new numbered version. The DRAFT is preserved and remains editable after publishing. Returns immediately with status UPDATING. Poll GetDataset until status transitions to ACTIVE or UPDATE_FAILED.

INSERT INTO aws.bedrock_agentcore_control.dataset_versions (
clientToken,
dataset_id,
region
)
SELECT 
'{{ clientToken }}',
'{{ dataset_id }}',
'{{ region }}'
RETURNING
created_at,
dataset_arn,
dataset_id,
dataset_version,
status
;

Manifest

# Description fields are for documentation purposes
- name: dataset_versions
props:
  - name: dataset_id
    value: "{{ dataset_id }}"
    description: Required parameter for the dataset_versions resource.
  - name: region
    value: "{{ region }}"
    description: Required parameter for the dataset_versions resource.
  - name: clientToken
    value: "{{ clientToken }}"