create_dataset_version¶
Operation¶
async
¶
create_dataset_version(input: CreateDatasetVersionInput, plugins: list[Plugin] | None = None) -> CreateDatasetVersionOutput
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:
| Name | Type | Description | Default |
|---|---|---|---|
input
|
CreateDatasetVersionInput
|
An instance of |
required |
plugins
|
list[Plugin] | None
|
A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations. |
None
|
Returns:
| Type | Description |
|---|---|
CreateDatasetVersionOutput
|
An instance of |
Input¶
dataclass
¶
Dataclass for CreateDatasetVersionInput structure.
Attributes¶
class-attribute
instance-attribute
¶
client_token: str | None = None
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.
class-attribute
instance-attribute
¶
dataset_id: str | None = None
The unique identifier of the dataset to publish a version for.
Output¶
dataclass
¶
Dataclass for CreateDatasetVersionOutput structure.
Attributes¶
instance-attribute
¶
created_at: datetime
The timestamp when the version creation was initiated.
instance-attribute
¶
status: DatasetStatus
Always UPDATING immediately after this call. Poll GetDataset until
status transitions to ACTIVE or UPDATE_FAILED.