aws_sdk_honeycode/operation/batch_create_table_rows/builders.rs
1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::batch_create_table_rows::_batch_create_table_rows_output::BatchCreateTableRowsOutputBuilder;
3
4pub use crate::operation::batch_create_table_rows::_batch_create_table_rows_input::BatchCreateTableRowsInputBuilder;
5
6impl crate::operation::batch_create_table_rows::builders::BatchCreateTableRowsInputBuilder {
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::batch_create_table_rows::BatchCreateTableRowsOutput,
13 ::aws_smithy_runtime_api::client::result::SdkError<
14 crate::operation::batch_create_table_rows::BatchCreateTableRowsError,
15 ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16 >,
17 > {
18 let mut fluent_builder = client.batch_create_table_rows();
19 fluent_builder.inner = self;
20 fluent_builder.send().await
21 }
22}
23/// Fluent builder constructing a request to `BatchCreateTableRows`.
24///
25/// <p>The BatchCreateTableRows API allows you to create one or more rows at the end of a table in a workbook. The API allows you to specify the values to set in some or all of the columns in the new rows.</p>
26/// <p>If a column is not explicitly set in a specific row, then the column level formula specified in the table will be applied to the new row. If there is no column level formula but the last row of the table has a formula, then that formula will be copied down to the new row. If there is no column level formula and no formula in the last row of the table, then that column will be left blank for the new rows.</p>
27#[derive(::std::clone::Clone, ::std::fmt::Debug)]
28pub struct BatchCreateTableRowsFluentBuilder {
29 handle: ::std::sync::Arc<crate::client::Handle>,
30 inner: crate::operation::batch_create_table_rows::builders::BatchCreateTableRowsInputBuilder,
31 config_override: ::std::option::Option<crate::config::Builder>,
32}
33impl
34 crate::client::customize::internal::CustomizableSend<
35 crate::operation::batch_create_table_rows::BatchCreateTableRowsOutput,
36 crate::operation::batch_create_table_rows::BatchCreateTableRowsError,
37 > for BatchCreateTableRowsFluentBuilder
38{
39 fn send(
40 self,
41 config_override: crate::config::Builder,
42 ) -> crate::client::customize::internal::BoxFuture<
43 crate::client::customize::internal::SendResult<
44 crate::operation::batch_create_table_rows::BatchCreateTableRowsOutput,
45 crate::operation::batch_create_table_rows::BatchCreateTableRowsError,
46 >,
47 > {
48 ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
49 }
50}
51impl BatchCreateTableRowsFluentBuilder {
52 /// Creates a new `BatchCreateTableRowsFluentBuilder`.
53 pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
54 Self {
55 handle,
56 inner: ::std::default::Default::default(),
57 config_override: ::std::option::Option::None,
58 }
59 }
60 /// Access the BatchCreateTableRows as a reference.
61 pub fn as_input(&self) -> &crate::operation::batch_create_table_rows::builders::BatchCreateTableRowsInputBuilder {
62 &self.inner
63 }
64 /// Sends the request and returns the response.
65 ///
66 /// If an error occurs, an `SdkError` will be returned with additional details that
67 /// can be matched against.
68 ///
69 /// By default, any retryable failures will be retried twice. Retry behavior
70 /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
71 /// set when configuring the client.
72 pub async fn send(
73 self,
74 ) -> ::std::result::Result<
75 crate::operation::batch_create_table_rows::BatchCreateTableRowsOutput,
76 ::aws_smithy_runtime_api::client::result::SdkError<
77 crate::operation::batch_create_table_rows::BatchCreateTableRowsError,
78 ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
79 >,
80 > {
81 let input = self
82 .inner
83 .build()
84 .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
85 let runtime_plugins = crate::operation::batch_create_table_rows::BatchCreateTableRows::operation_runtime_plugins(
86 self.handle.runtime_plugins.clone(),
87 &self.handle.conf,
88 self.config_override,
89 );
90 crate::operation::batch_create_table_rows::BatchCreateTableRows::orchestrate(&runtime_plugins, input).await
91 }
92
93 /// Consumes this builder, creating a customizable operation that can be modified before being sent.
94 pub fn customize(
95 self,
96 ) -> crate::client::customize::CustomizableOperation<
97 crate::operation::batch_create_table_rows::BatchCreateTableRowsOutput,
98 crate::operation::batch_create_table_rows::BatchCreateTableRowsError,
99 Self,
100 > {
101 crate::client::customize::CustomizableOperation::new(self)
102 }
103 pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
104 self.set_config_override(::std::option::Option::Some(config_override.into()));
105 self
106 }
107
108 pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
109 self.config_override = config_override;
110 self
111 }
112 /// <p>The ID of the workbook where the new rows are being added.</p>
113 /// <p>If a workbook with the specified ID could not be found, this API throws ResourceNotFoundException.</p>
114 pub fn workbook_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
115 self.inner = self.inner.workbook_id(input.into());
116 self
117 }
118 /// <p>The ID of the workbook where the new rows are being added.</p>
119 /// <p>If a workbook with the specified ID could not be found, this API throws ResourceNotFoundException.</p>
120 pub fn set_workbook_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
121 self.inner = self.inner.set_workbook_id(input);
122 self
123 }
124 /// <p>The ID of the workbook where the new rows are being added.</p>
125 /// <p>If a workbook with the specified ID could not be found, this API throws ResourceNotFoundException.</p>
126 pub fn get_workbook_id(&self) -> &::std::option::Option<::std::string::String> {
127 self.inner.get_workbook_id()
128 }
129 /// <p>The ID of the table where the new rows are being added.</p>
130 /// <p>If a table with the specified ID could not be found, this API throws ResourceNotFoundException.</p>
131 pub fn table_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
132 self.inner = self.inner.table_id(input.into());
133 self
134 }
135 /// <p>The ID of the table where the new rows are being added.</p>
136 /// <p>If a table with the specified ID could not be found, this API throws ResourceNotFoundException.</p>
137 pub fn set_table_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
138 self.inner = self.inner.set_table_id(input);
139 self
140 }
141 /// <p>The ID of the table where the new rows are being added.</p>
142 /// <p>If a table with the specified ID could not be found, this API throws ResourceNotFoundException.</p>
143 pub fn get_table_id(&self) -> &::std::option::Option<::std::string::String> {
144 self.inner.get_table_id()
145 }
146 ///
147 /// Appends an item to `rowsToCreate`.
148 ///
149 /// To override the contents of this collection use [`set_rows_to_create`](Self::set_rows_to_create).
150 ///
151 /// <p>The list of rows to create at the end of the table. Each item in this list needs to have a batch item id to uniquely identify the element in the request and the cells to create for that row. You need to specify at least one item in this list.</p>
152 /// <p>Note that if one of the column ids in any of the rows in the request does not exist in the table, then the request fails and no updates are made to the table.</p>
153 pub fn rows_to_create(mut self, input: crate::types::CreateRowData) -> Self {
154 self.inner = self.inner.rows_to_create(input);
155 self
156 }
157 /// <p>The list of rows to create at the end of the table. Each item in this list needs to have a batch item id to uniquely identify the element in the request and the cells to create for that row. You need to specify at least one item in this list.</p>
158 /// <p>Note that if one of the column ids in any of the rows in the request does not exist in the table, then the request fails and no updates are made to the table.</p>
159 pub fn set_rows_to_create(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::CreateRowData>>) -> Self {
160 self.inner = self.inner.set_rows_to_create(input);
161 self
162 }
163 /// <p>The list of rows to create at the end of the table. Each item in this list needs to have a batch item id to uniquely identify the element in the request and the cells to create for that row. You need to specify at least one item in this list.</p>
164 /// <p>Note that if one of the column ids in any of the rows in the request does not exist in the table, then the request fails and no updates are made to the table.</p>
165 pub fn get_rows_to_create(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::CreateRowData>> {
166 self.inner.get_rows_to_create()
167 }
168 /// <p>The request token for performing the batch create operation. Request tokens help to identify duplicate requests. If a call times out or fails due to a transient error like a failed network connection, you can retry the call with the same request token. The service ensures that if the first call using that request token is successfully performed, the second call will not perform the operation again.</p>
169 /// <p>Note that request tokens are valid only for a few minutes. You cannot use request tokens to dedupe requests spanning hours or days.</p>
170 pub fn client_request_token(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
171 self.inner = self.inner.client_request_token(input.into());
172 self
173 }
174 /// <p>The request token for performing the batch create operation. Request tokens help to identify duplicate requests. If a call times out or fails due to a transient error like a failed network connection, you can retry the call with the same request token. The service ensures that if the first call using that request token is successfully performed, the second call will not perform the operation again.</p>
175 /// <p>Note that request tokens are valid only for a few minutes. You cannot use request tokens to dedupe requests spanning hours or days.</p>
176 pub fn set_client_request_token(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
177 self.inner = self.inner.set_client_request_token(input);
178 self
179 }
180 /// <p>The request token for performing the batch create operation. Request tokens help to identify duplicate requests. If a call times out or fails due to a transient error like a failed network connection, you can retry the call with the same request token. The service ensures that if the first call using that request token is successfully performed, the second call will not perform the operation again.</p>
181 /// <p>Note that request tokens are valid only for a few minutes. You cannot use request tokens to dedupe requests spanning hours or days.</p>
182 pub fn get_client_request_token(&self) -> &::std::option::Option<::std::string::String> {
183 self.inner.get_client_request_token()
184 }
185}