aws_sdk_bedrockagentcorecontrol/client/create_dataset.rs
1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2impl super::Client {
3 /// Constructs a fluent builder for the [`CreateDataset`](crate::operation::create_dataset::builders::CreateDatasetFluentBuilder) operation.
4 ///
5 /// - The fluent builder is configurable:
6 /// - [`client_token(impl Into<String>)`](crate::operation::create_dataset::builders::CreateDatasetFluentBuilder::client_token) / [`set_client_token(Option<String>)`](crate::operation::create_dataset::builders::CreateDatasetFluentBuilder::set_client_token):<br>required: **false**<br><p>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 <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency</a>.</p><br>
7 /// - [`dataset_name(impl Into<String>)`](crate::operation::create_dataset::builders::CreateDatasetFluentBuilder::dataset_name) / [`set_dataset_name(Option<String>)`](crate::operation::create_dataset::builders::CreateDatasetFluentBuilder::set_dataset_name):<br>required: **true**<br><p>Human-readable name for the dataset. Must be unique within the account. Immutable after creation.</p><br>
8 /// - [`description(impl Into<String>)`](crate::operation::create_dataset::builders::CreateDatasetFluentBuilder::description) / [`set_description(Option<String>)`](crate::operation::create_dataset::builders::CreateDatasetFluentBuilder::set_description):<br>required: **false**<br><p>A description of the dataset.</p><br>
9 /// - [`source(DataSourceType)`](crate::operation::create_dataset::builders::CreateDatasetFluentBuilder::source) / [`set_source(Option<DataSourceType>)`](crate::operation::create_dataset::builders::CreateDatasetFluentBuilder::set_source):<br>required: **true**<br><p>Source of initial examples. Provide either inline examples or an S3 URI pointing to a JSONL file.</p><br>
10 /// - [`schema_type(DatasetSchemaType)`](crate::operation::create_dataset::builders::CreateDatasetFluentBuilder::schema_type) / [`set_schema_type(Option<DatasetSchemaType>)`](crate::operation::create_dataset::builders::CreateDatasetFluentBuilder::set_schema_type):<br>required: **true**<br><p>Versioned schema type governing the structure of examples. Immutable after creation.</p><br>
11 /// - [`kms_key_arn(impl Into<String>)`](crate::operation::create_dataset::builders::CreateDatasetFluentBuilder::kms_key_arn) / [`set_kms_key_arn(Option<String>)`](crate::operation::create_dataset::builders::CreateDatasetFluentBuilder::set_kms_key_arn):<br>required: **false**<br><p>Optional KMS key ARN for server-side encryption on service Amazon S3 writes.</p><br>
12 /// - [`tags(impl Into<String>, impl Into<String>)`](crate::operation::create_dataset::builders::CreateDatasetFluentBuilder::tags) / [`set_tags(Option<HashMap::<String, String>>)`](crate::operation::create_dataset::builders::CreateDatasetFluentBuilder::set_tags):<br>required: **false**<br><p>A map of tag keys and values to assign to the dataset.</p><br>
13 /// - On success, responds with [`CreateDatasetOutput`](crate::operation::create_dataset::CreateDatasetOutput) with field(s):
14 /// - [`dataset_arn(String)`](crate::operation::create_dataset::CreateDatasetOutput::dataset_arn): <p>The Amazon Resource Name (ARN) of the created dataset.</p>
15 /// - [`dataset_id(String)`](crate::operation::create_dataset::CreateDatasetOutput::dataset_id): <p>The unique identifier of the created dataset.</p>
16 /// - [`status(DatasetStatus)`](crate::operation::create_dataset::CreateDatasetOutput::status): <p>Always CREATING immediately after this call. Poll <code>GetDataset</code> until status transitions to ACTIVE or CREATE_FAILED.</p>
17 /// - [`created_at(DateTime)`](crate::operation::create_dataset::CreateDatasetOutput::created_at): <p>The timestamp when the dataset was created.</p>
18 /// - On failure, responds with [`SdkError<CreateDatasetError>`](crate::operation::create_dataset::CreateDatasetError)
19 pub fn create_dataset(&self) -> crate::operation::create_dataset::builders::CreateDatasetFluentBuilder {
20 crate::operation::create_dataset::builders::CreateDatasetFluentBuilder::new(self.handle.clone())
21 }
22}