BedrockAgentCoreControl / Client / delete_dataset

delete_dataset¶

BedrockAgentCoreControl.Client.delete_dataset(**kwargs)¶

Deletes a dataset version or an entire dataset asynchronously. If datasetVersion is absent, deletes all versions and the dataset record itself. If provided, deletes only that specific version.

Request Syntax

response = client.delete_dataset(
    datasetId='string',
    datasetVersion='string'
)

Parameters:

datasetId (string) –
[REQUIRED]

The unique identifier of the dataset to delete.
datasetVersion (string) – Optional version to delete. If absent, deletes the entire dataset. If provided, deletes only that specific version.

Return type:

dict

Returns:

Response Syntax

{
    'datasetArn': 'string',
    'datasetId': 'string',
    'status': 'CREATING'|'UPDATING'|'DELETING'|'ACTIVE'|'CREATE_FAILED'|'UPDATE_FAILED'|'DELETE_FAILED',
    'datasetVersion': 'string',
    'updatedAt': datetime(2015, 1, 1)
}

Response Structure

(dict) –
- datasetArn (string) –
  
  The Amazon Resource Name (ARN) of the dataset.
- datasetId (string) –
  
  The unique identifier of the dataset.
- status (string) –
  
  The current status of the dataset after the delete request.
- datasetVersion (string) –
  
  The version that was deleted.
- updatedAt (datetime) –
  
  The timestamp when the delete was initiated.

Exceptions

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