Skip to main content

aws_sdk_bedrockagentcorecontrol/client/
get_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 [`GetDataset`](crate::operation::get_dataset::builders::GetDatasetFluentBuilder) operation.
4    ///
5    /// - The fluent builder is configurable:
6    ///   - [`dataset_id(impl Into<String>)`](crate::operation::get_dataset::builders::GetDatasetFluentBuilder::dataset_id) / [`set_dataset_id(Option<String>)`](crate::operation::get_dataset::builders::GetDatasetFluentBuilder::set_dataset_id):<br>required: **true**<br><p>The unique identifier of the dataset to retrieve.</p><br>
7    ///   - [`dataset_version(impl Into<String>)`](crate::operation::get_dataset::builders::GetDatasetFluentBuilder::dataset_version) / [`set_dataset_version(Option<String>)`](crate::operation::get_dataset::builders::GetDatasetFluentBuilder::set_dataset_version):<br>required: **false**<br>Version to retrieve: "DRAFT" or a version number. Defaults to DRAFT if absent.<br>
8    /// - On success, responds with [`GetDatasetOutput`](crate::operation::get_dataset::GetDatasetOutput) with field(s):
9    ///   - [`dataset_arn(String)`](crate::operation::get_dataset::GetDatasetOutput::dataset_arn): <p>The Amazon Resource Name (ARN) of the dataset.</p>
10    ///   - [`dataset_id(String)`](crate::operation::get_dataset::GetDatasetOutput::dataset_id): <p>The unique identifier of the dataset.</p>
11    ///   - [`dataset_version(String)`](crate::operation::get_dataset::GetDatasetOutput::dataset_version): The resolved version: "DRAFT" (default) or the requested version number.
12    ///   - [`dataset_name(String)`](crate::operation::get_dataset::GetDatasetOutput::dataset_name): <p>The name of the dataset.</p>
13    ///   - [`description(Option<String>)`](crate::operation::get_dataset::GetDatasetOutput::description): <p>The description of the dataset.</p>
14    ///   - [`status(DatasetStatus)`](crate::operation::get_dataset::GetDatasetOutput::status): <p>The current status of the dataset.</p>
15    ///   - [`draft_status(Option<DraftStatus>)`](crate::operation::get_dataset::GetDatasetOutput::draft_status): Publish synchronization state. Only authoritative when status == ACTIVE. MODIFIED — DRAFT has unpublished changes (or no published versions yet). UNMODIFIED — DRAFT matches the latest published version exactly.
16    ///   - [`failure_reason(Option<String>)`](crate::operation::get_dataset::GetDatasetOutput::failure_reason): Populated when status is CREATE_FAILED, UPDATE_FAILED, or DELETE_FAILED.
17    ///   - [`schema_type(DatasetSchemaType)`](crate::operation::get_dataset::GetDatasetOutput::schema_type): The schema type declared at create time. Immutable after creation.
18    ///   - [`kms_key_arn(Option<String>)`](crate::operation::get_dataset::GetDatasetOutput::kms_key_arn): AWS KMS key ARN used for SSE-KMS on service S3 writes, if configured.
19    ///   - [`example_count(i64)`](crate::operation::get_dataset::GetDatasetOutput::example_count): Example count for DRAFT.
20    ///   - [`download_url(Option<String>)`](crate::operation::get_dataset::GetDatasetOutput::download_url): Presigned S3 URL to download the consolidated dataset.jsonl file for the resolved version (DRAFT or published). TTL: 5 minutes. Omitted if the file does not yet exist (e.g. during CREATING) or on presign failure.
21    ///   - [`download_url_expires_at(Option<DateTime>)`](crate::operation::get_dataset::GetDatasetOutput::download_url_expires_at): Expiry timestamp for downloadUrl.
22    ///   - [`created_at(DateTime)`](crate::operation::get_dataset::GetDatasetOutput::created_at): <p>The timestamp when the dataset was created.</p>
23    ///   - [`updated_at(DateTime)`](crate::operation::get_dataset::GetDatasetOutput::updated_at): <p>The timestamp when the dataset was last updated.</p>
24    ///   - [`tags(Option<HashMap::<String, String>>)`](crate::operation::get_dataset::GetDatasetOutput::tags): <p>The tags associated with the dataset.</p>
25    /// - On failure, responds with [`SdkError<GetDatasetError>`](crate::operation::get_dataset::GetDatasetError)
26    pub fn get_dataset(&self) -> crate::operation::get_dataset::builders::GetDatasetFluentBuilder {
27        crate::operation::get_dataset::builders::GetDatasetFluentBuilder::new(self.handle.clone())
28    }
29}