BedrockAgentCoreControl / Client / create_dataset_version

create_dataset_version

BedrockAgentCoreControl.Client.create_dataset_version(**kwargs)

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.

See also: AWS API Documentation

Request Syntax

response = client.create_dataset_version(
    datasetId='string',
    clientToken='string'
)

Parameters:

• datasetId (string) –

  [REQUIRED]

  The unique identifier of the dataset to publish a version for.

• clientToken (string) –

  A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If you don’t specify this field, a value is randomly generated for you. If this token matches a previous request, the service ignores the request, but doesn’t return an error. For more information, see Ensuring idempotency.

  This field is autopopulated if not provided.

Return type:

dict

Returns:

Response Syntax

{
    'datasetArn': 'string',
    'datasetId': 'string',
    'status': 'CREATING'|'UPDATING'|'DELETING'|'ACTIVE'|'CREATE_FAILED'|'UPDATE_FAILED'|'DELETE_FAILED',
    'datasetVersion': 'string',
    'createdAt': 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) –

    Always UPDATING immediately after this call. Poll GetDataset until status transitions to ACTIVE or UPDATE_FAILED.

  • datasetVersion (string) –

    The version number being created.

  • createdAt (datetime) –

    The timestamp when the version creation was initiated.

Exceptions

• BedrockAgentCoreControl.Client.exceptions.ServiceQuotaExceededException

• BedrockAgentCoreControl.Client.exceptions.ValidationException

• BedrockAgentCoreControl.Client.exceptions.ConflictException

• BedrockAgentCoreControl.Client.exceptions.AccessDeniedException

• BedrockAgentCoreControl.Client.exceptions.ResourceNotFoundException

• BedrockAgentCoreControl.Client.exceptions.ThrottlingException

• BedrockAgentCoreControl.Client.exceptions.InternalServerException