aws_sdk_eks/operation/update_cluster_version/
builders.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::update_cluster_version::_update_cluster_version_output::UpdateClusterVersionOutputBuilder;
3
4pub use crate::operation::update_cluster_version::_update_cluster_version_input::UpdateClusterVersionInputBuilder;
5
6impl crate::operation::update_cluster_version::builders::UpdateClusterVersionInputBuilder {
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::update_cluster_version::UpdateClusterVersionOutput,
13        ::aws_smithy_runtime_api::client::result::SdkError<
14            crate::operation::update_cluster_version::UpdateClusterVersionError,
15            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16        >,
17    > {
18        let mut fluent_builder = client.update_cluster_version();
19        fluent_builder.inner = self;
20        fluent_builder.send().await
21    }
22}
23/// Fluent builder constructing a request to `UpdateClusterVersion`.
24///
25/// <p>Updates an Amazon EKS cluster to the specified Kubernetes version. Your cluster continues to function during the update. The response output includes an update ID that you can use to track the status of your cluster update with the <a href="https://docs.aws.amazon.com/eks/latest/APIReference/API_DescribeUpdate.html"> <code>DescribeUpdate</code> </a> API operation.</p>
26/// <p>Cluster updates are asynchronous, and they should finish within a few minutes. During an update, the cluster status moves to <code>UPDATING</code> (this status transition is eventually consistent). When the update is complete (either <code>Failed</code> or <code>Successful</code>), the cluster status moves to <code>Active</code>.</p>
27/// <p>If your cluster has managed node groups attached to it, all of your node groups' Kubernetes versions must match the cluster's Kubernetes version in order to update the cluster to a new Kubernetes version.</p>
28#[derive(::std::clone::Clone, ::std::fmt::Debug)]
29pub struct UpdateClusterVersionFluentBuilder {
30    handle: ::std::sync::Arc<crate::client::Handle>,
31    inner: crate::operation::update_cluster_version::builders::UpdateClusterVersionInputBuilder,
32    config_override: ::std::option::Option<crate::config::Builder>,
33}
34impl
35    crate::client::customize::internal::CustomizableSend<
36        crate::operation::update_cluster_version::UpdateClusterVersionOutput,
37        crate::operation::update_cluster_version::UpdateClusterVersionError,
38    > for UpdateClusterVersionFluentBuilder
39{
40    fn send(
41        self,
42        config_override: crate::config::Builder,
43    ) -> crate::client::customize::internal::BoxFuture<
44        crate::client::customize::internal::SendResult<
45            crate::operation::update_cluster_version::UpdateClusterVersionOutput,
46            crate::operation::update_cluster_version::UpdateClusterVersionError,
47        >,
48    > {
49        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
50    }
51}
52impl UpdateClusterVersionFluentBuilder {
53    /// Creates a new `UpdateClusterVersionFluentBuilder`.
54    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
55        Self {
56            handle,
57            inner: ::std::default::Default::default(),
58            config_override: ::std::option::Option::None,
59        }
60    }
61    /// Access the UpdateClusterVersion as a reference.
62    pub fn as_input(&self) -> &crate::operation::update_cluster_version::builders::UpdateClusterVersionInputBuilder {
63        &self.inner
64    }
65    /// Sends the request and returns the response.
66    ///
67    /// If an error occurs, an `SdkError` will be returned with additional details that
68    /// can be matched against.
69    ///
70    /// By default, any retryable failures will be retried twice. Retry behavior
71    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
72    /// set when configuring the client.
73    pub async fn send(
74        self,
75    ) -> ::std::result::Result<
76        crate::operation::update_cluster_version::UpdateClusterVersionOutput,
77        ::aws_smithy_runtime_api::client::result::SdkError<
78            crate::operation::update_cluster_version::UpdateClusterVersionError,
79            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
80        >,
81    > {
82        let input = self
83            .inner
84            .build()
85            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
86        let runtime_plugins = crate::operation::update_cluster_version::UpdateClusterVersion::operation_runtime_plugins(
87            self.handle.runtime_plugins.clone(),
88            &self.handle.conf,
89            self.config_override,
90        );
91        crate::operation::update_cluster_version::UpdateClusterVersion::orchestrate(&runtime_plugins, input).await
92    }
93
94    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
95    pub fn customize(
96        self,
97    ) -> crate::client::customize::CustomizableOperation<
98        crate::operation::update_cluster_version::UpdateClusterVersionOutput,
99        crate::operation::update_cluster_version::UpdateClusterVersionError,
100        Self,
101    > {
102        crate::client::customize::CustomizableOperation::new(self)
103    }
104    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
105        self.set_config_override(::std::option::Option::Some(config_override.into()));
106        self
107    }
108
109    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
110        self.config_override = config_override;
111        self
112    }
113    /// <p>The name of the Amazon EKS cluster to update.</p>
114    pub fn name(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
115        self.inner = self.inner.name(input.into());
116        self
117    }
118    /// <p>The name of the Amazon EKS cluster to update.</p>
119    pub fn set_name(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
120        self.inner = self.inner.set_name(input);
121        self
122    }
123    /// <p>The name of the Amazon EKS cluster to update.</p>
124    pub fn get_name(&self) -> &::std::option::Option<::std::string::String> {
125        self.inner.get_name()
126    }
127    /// <p>The desired Kubernetes version following a successful update.</p>
128    pub fn version(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
129        self.inner = self.inner.version(input.into());
130        self
131    }
132    /// <p>The desired Kubernetes version following a successful update.</p>
133    pub fn set_version(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
134        self.inner = self.inner.set_version(input);
135        self
136    }
137    /// <p>The desired Kubernetes version following a successful update.</p>
138    pub fn get_version(&self) -> &::std::option::Option<::std::string::String> {
139        self.inner.get_version()
140    }
141    /// <p>A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.</p>
142    pub fn client_request_token(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
143        self.inner = self.inner.client_request_token(input.into());
144        self
145    }
146    /// <p>A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.</p>
147    pub fn set_client_request_token(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
148        self.inner = self.inner.set_client_request_token(input);
149        self
150    }
151    /// <p>A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.</p>
152    pub fn get_client_request_token(&self) -> &::std::option::Option<::std::string::String> {
153        self.inner.get_client_request_token()
154    }
155    /// <p>Set this value to <code>true</code> to override upgrade-blocking readiness checks when updating a cluster.</p>
156    pub fn force(mut self, input: bool) -> Self {
157        self.inner = self.inner.force(input);
158        self
159    }
160    /// <p>Set this value to <code>true</code> to override upgrade-blocking readiness checks when updating a cluster.</p>
161    pub fn set_force(mut self, input: ::std::option::Option<bool>) -> Self {
162        self.inner = self.inner.set_force(input);
163        self
164    }
165    /// <p>Set this value to <code>true</code> to override upgrade-blocking readiness checks when updating a cluster.</p>
166    pub fn get_force(&self) -> &::std::option::Option<bool> {
167        self.inner.get_force()
168    }
169}
aws_sdk_eks/operation/update_cluster_version/builders.rs

aws_sdk_eks/operation/update_cluster_version/
builders.rs
