BedrockAgentCoreControl / Client / list_dataset_versions

list_dataset_versions¶

BedrockAgentCoreControl.Client.list_dataset_versions(**kwargs)¶

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

State guard: Allowed for all statuses including DELETING.

Request Syntax

response = client.list_dataset_versions(
    datasetId='string',
    nextToken='string',
    maxResults=123
)

Parameters:

datasetId (string) –
[REQUIRED]

The unique identifier of the dataset.
nextToken (string) – The token for the next page of results.
maxResults (integer) – The maximum number of versions to return per page.

Return type:

dict

Returns:

Response Syntax

{
    'versions': [
        {
            'datasetVersion': 'string',
            'exampleCount': 123,
            'createdAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

(dict) –
- versions (list) –
  
  The list of published dataset versions.
  - (dict) –
    
    Summary information about a published dataset version.
    - datasetVersion (string) –
      
      Dataset version identifier. Accepts “DRAFT” or a non-negative integer string.
      
      ”DRAFT” refers to the single mutable working copy of the dataset.
      - Always present after CreateDataset ingestion completes.
      - Content changes in-place when examples are added, updated, or deleted.
      - NOT tracked as a DDB DatasetVersionItem — state lives in S3 (draft/manifest.json, draft/dataset.jsonl) and the DatasetItem.exampleCount field.
      - Default for read operations when ?datasetVersion is absent.
      An integer string (e.g. “1”, “2”, “3”) refers to a published, immutable snapshot created by CreateDatasetVersion. Once created, a published version’s content never changes. Stored as a DDB DatasetVersionItem (SK=VERSION#{zero-padded-N}).
    - exampleCount (integer) –
      
      The number of examples in this version.
    - createdAt (datetime) –
      
      The timestamp when this version was published.
- nextToken (string) –
  
  The token for the next page of results, or null if there are no more results.

Exceptions

BedrockAgentCoreControl.Client.exceptions.ValidationException
BedrockAgentCoreControl.Client.exceptions.AccessDeniedException
BedrockAgentCoreControl.Client.exceptions.ResourceNotFoundException
BedrockAgentCoreControl.Client.exceptions.ThrottlingException
BedrockAgentCoreControl.Client.exceptions.InternalServerException