aws_sdk_timestreamwrite/operation/create_table/
builders.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::create_table::_create_table_output::CreateTableOutputBuilder;
3
4pub use crate::operation::create_table::_create_table_input::CreateTableInputBuilder;
5
6impl crate::operation::create_table::builders::CreateTableInputBuilder {
7    /// Sends a request with this input using the given client.
8    pub async fn send_with(
9        self,
10        client: &crate::Client,
11    ) -> ::std::result::Result<
12        crate::operation::create_table::CreateTableOutput,
13        ::aws_smithy_runtime_api::client::result::SdkError<
14            crate::operation::create_table::CreateTableError,
15            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16        >,
17    > {
18        let mut fluent_builder = client.create_table();
19        fluent_builder.inner = self;
20        fluent_builder.send().await
21    }
22}
23/// Fluent builder constructing a request to `CreateTable`.
24///
25/// <p>Adds a new table to an existing database in your account. In an Amazon Web Services account, table names must be at least unique within each Region if they are in the same database. You might have identical table names in the same Region if the tables are in separate databases. While creating the table, you must specify the table name, database name, and the retention properties. <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Service quotas apply</a>. See <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-table.html">code sample</a> for details.</p>
26#[derive(::std::clone::Clone, ::std::fmt::Debug)]
27pub struct CreateTableFluentBuilder {
28    handle: ::std::sync::Arc<crate::client::Handle>,
29    inner: crate::operation::create_table::builders::CreateTableInputBuilder,
30    config_override: ::std::option::Option<crate::config::Builder>,
31}
32impl
33    crate::client::customize::internal::CustomizableSend<
34        crate::operation::create_table::CreateTableOutput,
35        crate::operation::create_table::CreateTableError,
36    > for CreateTableFluentBuilder
37{
38    fn send(
39        self,
40        config_override: crate::config::Builder,
41    ) -> crate::client::customize::internal::BoxFuture<
42        crate::client::customize::internal::SendResult<
43            crate::operation::create_table::CreateTableOutput,
44            crate::operation::create_table::CreateTableError,
45        >,
46    > {
47        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
48    }
49}
50impl CreateTableFluentBuilder {
51    /// Creates a new `CreateTableFluentBuilder`.
52    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
53        Self {
54            handle,
55            inner: ::std::default::Default::default(),
56            config_override: ::std::option::Option::None,
57        }
58    }
59    /// Access the CreateTable as a reference.
60    pub fn as_input(&self) -> &crate::operation::create_table::builders::CreateTableInputBuilder {
61        &self.inner
62    }
63    /// Sends the request and returns the response.
64    ///
65    /// If an error occurs, an `SdkError` will be returned with additional details that
66    /// can be matched against.
67    ///
68    /// By default, any retryable failures will be retried twice. Retry behavior
69    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
70    /// set when configuring the client.
71    pub async fn send(
72        self,
73    ) -> ::std::result::Result<
74        crate::operation::create_table::CreateTableOutput,
75        ::aws_smithy_runtime_api::client::result::SdkError<
76            crate::operation::create_table::CreateTableError,
77            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
78        >,
79    > {
80        let input = self
81            .inner
82            .build()
83            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
84        let runtime_plugins = crate::operation::create_table::CreateTable::operation_runtime_plugins(
85            self.handle.runtime_plugins.clone(),
86            &self.handle.conf,
87            self.config_override,
88        );
89        crate::operation::create_table::CreateTable::orchestrate(&runtime_plugins, input).await
90    }
91
92    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
93    pub fn customize(
94        self,
95    ) -> crate::client::customize::CustomizableOperation<
96        crate::operation::create_table::CreateTableOutput,
97        crate::operation::create_table::CreateTableError,
98        Self,
99    > {
100        crate::client::customize::CustomizableOperation::new(self)
101    }
102    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
103        self.set_config_override(::std::option::Option::Some(config_override.into()));
104        self
105    }
106
107    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
108        self.config_override = config_override;
109        self
110    }
111    /// <p>The name of the Timestream database.</p>
112    pub fn database_name(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
113        self.inner = self.inner.database_name(input.into());
114        self
115    }
116    /// <p>The name of the Timestream database.</p>
117    pub fn set_database_name(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
118        self.inner = self.inner.set_database_name(input);
119        self
120    }
121    /// <p>The name of the Timestream database.</p>
122    pub fn get_database_name(&self) -> &::std::option::Option<::std::string::String> {
123        self.inner.get_database_name()
124    }
125    /// <p>The name of the Timestream table.</p>
126    pub fn table_name(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
127        self.inner = self.inner.table_name(input.into());
128        self
129    }
130    /// <p>The name of the Timestream table.</p>
131    pub fn set_table_name(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
132        self.inner = self.inner.set_table_name(input);
133        self
134    }
135    /// <p>The name of the Timestream table.</p>
136    pub fn get_table_name(&self) -> &::std::option::Option<::std::string::String> {
137        self.inner.get_table_name()
138    }
139    /// <p>The duration for which your time-series data must be stored in the memory store and the magnetic store.</p>
140    pub fn retention_properties(mut self, input: crate::types::RetentionProperties) -> Self {
141        self.inner = self.inner.retention_properties(input);
142        self
143    }
144    /// <p>The duration for which your time-series data must be stored in the memory store and the magnetic store.</p>
145    pub fn set_retention_properties(mut self, input: ::std::option::Option<crate::types::RetentionProperties>) -> Self {
146        self.inner = self.inner.set_retention_properties(input);
147        self
148    }
149    /// <p>The duration for which your time-series data must be stored in the memory store and the magnetic store.</p>
150    pub fn get_retention_properties(&self) -> &::std::option::Option<crate::types::RetentionProperties> {
151        self.inner.get_retention_properties()
152    }
153    ///
154    /// Appends an item to `Tags`.
155    ///
156    /// To override the contents of this collection use [`set_tags`](Self::set_tags).
157    ///
158    /// <p>A list of key-value pairs to label the table.</p>
159    pub fn tags(mut self, input: crate::types::Tag) -> Self {
160        self.inner = self.inner.tags(input);
161        self
162    }
163    /// <p>A list of key-value pairs to label the table.</p>
164    pub fn set_tags(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::Tag>>) -> Self {
165        self.inner = self.inner.set_tags(input);
166        self
167    }
168    /// <p>A list of key-value pairs to label the table.</p>
169    pub fn get_tags(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::Tag>> {
170        self.inner.get_tags()
171    }
172    /// <p>Contains properties to set on the table when enabling magnetic store writes.</p>
173    pub fn magnetic_store_write_properties(mut self, input: crate::types::MagneticStoreWriteProperties) -> Self {
174        self.inner = self.inner.magnetic_store_write_properties(input);
175        self
176    }
177    /// <p>Contains properties to set on the table when enabling magnetic store writes.</p>
178    pub fn set_magnetic_store_write_properties(mut self, input: ::std::option::Option<crate::types::MagneticStoreWriteProperties>) -> Self {
179        self.inner = self.inner.set_magnetic_store_write_properties(input);
180        self
181    }
182    /// <p>Contains properties to set on the table when enabling magnetic store writes.</p>
183    pub fn get_magnetic_store_write_properties(&self) -> &::std::option::Option<crate::types::MagneticStoreWriteProperties> {
184        self.inner.get_magnetic_store_write_properties()
185    }
186    /// <p>The schema of the table.</p>
187    pub fn schema(mut self, input: crate::types::Schema) -> Self {
188        self.inner = self.inner.schema(input);
189        self
190    }
191    /// <p>The schema of the table.</p>
192    pub fn set_schema(mut self, input: ::std::option::Option<crate::types::Schema>) -> Self {
193        self.inner = self.inner.set_schema(input);
194        self
195    }
196    /// <p>The schema of the table.</p>
197    pub fn get_schema(&self) -> &::std::option::Option<crate::types::Schema> {
198        self.inner.get_schema()
199    }
200}