aws_sdk_cloudfront/operation/copy_distribution/builders.rs
1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::copy_distribution::_copy_distribution_output::CopyDistributionOutputBuilder;
3
4pub use crate::operation::copy_distribution::_copy_distribution_input::CopyDistributionInputBuilder;
5
6impl crate::operation::copy_distribution::builders::CopyDistributionInputBuilder {
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::copy_distribution::CopyDistributionOutput,
13 ::aws_smithy_runtime_api::client::result::SdkError<
14 crate::operation::copy_distribution::CopyDistributionError,
15 ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16 >,
17 > {
18 let mut fluent_builder = client.copy_distribution();
19 fluent_builder.inner = self;
20 fluent_builder.send().await
21 }
22}
23/// Fluent builder constructing a request to `CopyDistribution`.
24///
25/// <p>Creates a staging distribution using the configuration of the provided primary distribution. A staging distribution is a copy of an existing distribution (called the primary distribution) that you can use in a continuous deployment workflow.</p>
26/// <p>After you create a staging distribution, you can use <code>UpdateDistribution</code> to modify the staging distribution's configuration. Then you can use <code>CreateContinuousDeploymentPolicy</code> to incrementally move traffic to the staging distribution.</p>
27/// <p>This API operation requires the following IAM permissions:</p>
28/// <ul>
29/// <li>
30/// <p><a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_GetDistribution.html">GetDistribution</a></p></li>
31/// <li>
32/// <p><a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CreateDistribution.html">CreateDistribution</a></p></li>
33/// <li>
34/// <p><a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CopyDistribution.html">CopyDistribution</a></p></li>
35/// </ul>
36#[derive(::std::clone::Clone, ::std::fmt::Debug)]
37pub struct CopyDistributionFluentBuilder {
38 handle: ::std::sync::Arc<crate::client::Handle>,
39 inner: crate::operation::copy_distribution::builders::CopyDistributionInputBuilder,
40 config_override: ::std::option::Option<crate::config::Builder>,
41}
42impl
43 crate::client::customize::internal::CustomizableSend<
44 crate::operation::copy_distribution::CopyDistributionOutput,
45 crate::operation::copy_distribution::CopyDistributionError,
46 > for CopyDistributionFluentBuilder
47{
48 fn send(
49 self,
50 config_override: crate::config::Builder,
51 ) -> crate::client::customize::internal::BoxFuture<
52 crate::client::customize::internal::SendResult<
53 crate::operation::copy_distribution::CopyDistributionOutput,
54 crate::operation::copy_distribution::CopyDistributionError,
55 >,
56 > {
57 ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
58 }
59}
60impl CopyDistributionFluentBuilder {
61 /// Creates a new `CopyDistributionFluentBuilder`.
62 pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
63 Self {
64 handle,
65 inner: ::std::default::Default::default(),
66 config_override: ::std::option::Option::None,
67 }
68 }
69 /// Access the CopyDistribution as a reference.
70 pub fn as_input(&self) -> &crate::operation::copy_distribution::builders::CopyDistributionInputBuilder {
71 &self.inner
72 }
73 /// Sends the request and returns the response.
74 ///
75 /// If an error occurs, an `SdkError` will be returned with additional details that
76 /// can be matched against.
77 ///
78 /// By default, any retryable failures will be retried twice. Retry behavior
79 /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
80 /// set when configuring the client.
81 pub async fn send(
82 self,
83 ) -> ::std::result::Result<
84 crate::operation::copy_distribution::CopyDistributionOutput,
85 ::aws_smithy_runtime_api::client::result::SdkError<
86 crate::operation::copy_distribution::CopyDistributionError,
87 ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
88 >,
89 > {
90 let input = self
91 .inner
92 .build()
93 .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
94 let runtime_plugins = crate::operation::copy_distribution::CopyDistribution::operation_runtime_plugins(
95 self.handle.runtime_plugins.clone(),
96 &self.handle.conf,
97 self.config_override,
98 );
99 crate::operation::copy_distribution::CopyDistribution::orchestrate(&runtime_plugins, input).await
100 }
101
102 /// Consumes this builder, creating a customizable operation that can be modified before being sent.
103 pub fn customize(
104 self,
105 ) -> crate::client::customize::CustomizableOperation<
106 crate::operation::copy_distribution::CopyDistributionOutput,
107 crate::operation::copy_distribution::CopyDistributionError,
108 Self,
109 > {
110 crate::client::customize::CustomizableOperation::new(self)
111 }
112 pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
113 self.set_config_override(::std::option::Option::Some(config_override.into()));
114 self
115 }
116
117 pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
118 self.config_override = config_override;
119 self
120 }
121 /// <p>The identifier of the primary distribution whose configuration you are copying. To get a distribution ID, use <code>ListDistributions</code>.</p>
122 pub fn primary_distribution_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
123 self.inner = self.inner.primary_distribution_id(input.into());
124 self
125 }
126 /// <p>The identifier of the primary distribution whose configuration you are copying. To get a distribution ID, use <code>ListDistributions</code>.</p>
127 pub fn set_primary_distribution_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
128 self.inner = self.inner.set_primary_distribution_id(input);
129 self
130 }
131 /// <p>The identifier of the primary distribution whose configuration you are copying. To get a distribution ID, use <code>ListDistributions</code>.</p>
132 pub fn get_primary_distribution_id(&self) -> &::std::option::Option<::std::string::String> {
133 self.inner.get_primary_distribution_id()
134 }
135 /// <p>The type of distribution that your primary distribution will be copied to. The only valid value is <code>True</code>, indicating that you are copying to a staging distribution.</p>
136 pub fn staging(mut self, input: bool) -> Self {
137 self.inner = self.inner.staging(input);
138 self
139 }
140 /// <p>The type of distribution that your primary distribution will be copied to. The only valid value is <code>True</code>, indicating that you are copying to a staging distribution.</p>
141 pub fn set_staging(mut self, input: ::std::option::Option<bool>) -> Self {
142 self.inner = self.inner.set_staging(input);
143 self
144 }
145 /// <p>The type of distribution that your primary distribution will be copied to. The only valid value is <code>True</code>, indicating that you are copying to a staging distribution.</p>
146 pub fn get_staging(&self) -> &::std::option::Option<bool> {
147 self.inner.get_staging()
148 }
149 /// <p>The version identifier of the primary distribution whose configuration you are copying. This is the <code>ETag</code> value returned in the response to <code>GetDistribution</code> and <code>GetDistributionConfig</code>.</p>
150 pub fn if_match(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
151 self.inner = self.inner.if_match(input.into());
152 self
153 }
154 /// <p>The version identifier of the primary distribution whose configuration you are copying. This is the <code>ETag</code> value returned in the response to <code>GetDistribution</code> and <code>GetDistributionConfig</code>.</p>
155 pub fn set_if_match(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
156 self.inner = self.inner.set_if_match(input);
157 self
158 }
159 /// <p>The version identifier of the primary distribution whose configuration you are copying. This is the <code>ETag</code> value returned in the response to <code>GetDistribution</code> and <code>GetDistributionConfig</code>.</p>
160 pub fn get_if_match(&self) -> &::std::option::Option<::std::string::String> {
161 self.inner.get_if_match()
162 }
163 /// <p>A value that uniquely identifies a request to create a resource. This helps to prevent CloudFront from creating a duplicate resource if you accidentally resubmit an identical request.</p>
164 pub fn caller_reference(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
165 self.inner = self.inner.caller_reference(input.into());
166 self
167 }
168 /// <p>A value that uniquely identifies a request to create a resource. This helps to prevent CloudFront from creating a duplicate resource if you accidentally resubmit an identical request.</p>
169 pub fn set_caller_reference(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
170 self.inner = self.inner.set_caller_reference(input);
171 self
172 }
173 /// <p>A value that uniquely identifies a request to create a resource. This helps to prevent CloudFront from creating a duplicate resource if you accidentally resubmit an identical request.</p>
174 pub fn get_caller_reference(&self) -> &::std::option::Option<::std::string::String> {
175 self.inner.get_caller_reference()
176 }
177 /// <p>A Boolean flag to specify the state of the staging distribution when it's created. When you set this value to <code>True</code>, the staging distribution is enabled. When you set this value to <code>False</code>, the staging distribution is disabled.</p>
178 /// <p>If you omit this field, the default value is <code>True</code>.</p>
179 pub fn enabled(mut self, input: bool) -> Self {
180 self.inner = self.inner.enabled(input);
181 self
182 }
183 /// <p>A Boolean flag to specify the state of the staging distribution when it's created. When you set this value to <code>True</code>, the staging distribution is enabled. When you set this value to <code>False</code>, the staging distribution is disabled.</p>
184 /// <p>If you omit this field, the default value is <code>True</code>.</p>
185 pub fn set_enabled(mut self, input: ::std::option::Option<bool>) -> Self {
186 self.inner = self.inner.set_enabled(input);
187 self
188 }
189 /// <p>A Boolean flag to specify the state of the staging distribution when it's created. When you set this value to <code>True</code>, the staging distribution is enabled. When you set this value to <code>False</code>, the staging distribution is disabled.</p>
190 /// <p>If you omit this field, the default value is <code>True</code>.</p>
191 pub fn get_enabled(&self) -> &::std::option::Option<bool> {
192 self.inner.get_enabled()
193 }
194}