aws_sdk_ec2/operation/enable_instance_sql_ha_standby_detections/
builders.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::enable_instance_sql_ha_standby_detections::_enable_instance_sql_ha_standby_detections_output::EnableInstanceSqlHaStandbyDetectionsOutputBuilder;
3
4pub use crate::operation::enable_instance_sql_ha_standby_detections::_enable_instance_sql_ha_standby_detections_input::EnableInstanceSqlHaStandbyDetectionsInputBuilder;
5
6impl crate::operation::enable_instance_sql_ha_standby_detections::builders::EnableInstanceSqlHaStandbyDetectionsInputBuilder {
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::enable_instance_sql_ha_standby_detections::EnableInstanceSqlHaStandbyDetectionsOutput,
13        ::aws_smithy_runtime_api::client::result::SdkError<
14            crate::operation::enable_instance_sql_ha_standby_detections::EnableInstanceSqlHaStandbyDetectionsError,
15            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16        >,
17    > {
18        let mut fluent_builder = client.enable_instance_sql_ha_standby_detections();
19        fluent_builder.inner = self;
20        fluent_builder.send().await
21    }
22}
23/// Fluent builder constructing a request to `EnableInstanceSqlHaStandbyDetections`.
24///
25/// <p>Enable Amazon EC2 instances running in an SQL Server High Availability cluster for SQL Server High Availability instance standby detection monitoring. Once enabled, Amazon Web Services monitors the metadata for the instances to determine whether they are active or standby nodes in the SQL Server High Availability cluster. If the instances are determined to be standby failover nodes, Amazon Web Services automatically applies SQL Server licensing fee waiver for those instances.</p>
26/// <p>To register an instance, it must be running a Windows SQL Server license-included AMI and have the Amazon Web Services Systems Manager agent installed and running. Only Windows Server 2019 and later and SQL Server (Standard and Enterprise editions) 2017 and later are supported. For more information, see <a href="https://docs.aws.amazon.com/sql-server-ec2/latest/userguide/prerequisites-and-requirements.html"> Prerequisites for using SQL Server High Availability instance standby detection</a>.</p>
27#[derive(::std::clone::Clone, ::std::fmt::Debug)]
28pub struct EnableInstanceSqlHaStandbyDetectionsFluentBuilder {
29    handle: ::std::sync::Arc<crate::client::Handle>,
30    inner: crate::operation::enable_instance_sql_ha_standby_detections::builders::EnableInstanceSqlHaStandbyDetectionsInputBuilder,
31    config_override: ::std::option::Option<crate::config::Builder>,
32}
33impl
34    crate::client::customize::internal::CustomizableSend<
35        crate::operation::enable_instance_sql_ha_standby_detections::EnableInstanceSqlHaStandbyDetectionsOutput,
36        crate::operation::enable_instance_sql_ha_standby_detections::EnableInstanceSqlHaStandbyDetectionsError,
37    > for EnableInstanceSqlHaStandbyDetectionsFluentBuilder
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::enable_instance_sql_ha_standby_detections::EnableInstanceSqlHaStandbyDetectionsOutput,
45            crate::operation::enable_instance_sql_ha_standby_detections::EnableInstanceSqlHaStandbyDetectionsError,
46        >,
47    > {
48        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
49    }
50}
51impl EnableInstanceSqlHaStandbyDetectionsFluentBuilder {
52    /// Creates a new `EnableInstanceSqlHaStandbyDetectionsFluentBuilder`.
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 EnableInstanceSqlHaStandbyDetections as a reference.
61    pub fn as_input(
62        &self,
63    ) -> &crate::operation::enable_instance_sql_ha_standby_detections::builders::EnableInstanceSqlHaStandbyDetectionsInputBuilder {
64        &self.inner
65    }
66    /// Sends the request and returns the response.
67    ///
68    /// If an error occurs, an `SdkError` will be returned with additional details that
69    /// can be matched against.
70    ///
71    /// By default, any retryable failures will be retried twice. Retry behavior
72    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
73    /// set when configuring the client.
74    pub async fn send(
75        self,
76    ) -> ::std::result::Result<
77        crate::operation::enable_instance_sql_ha_standby_detections::EnableInstanceSqlHaStandbyDetectionsOutput,
78        ::aws_smithy_runtime_api::client::result::SdkError<
79            crate::operation::enable_instance_sql_ha_standby_detections::EnableInstanceSqlHaStandbyDetectionsError,
80            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
81        >,
82    > {
83        let input = self
84            .inner
85            .build()
86            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
87        let runtime_plugins =
88            crate::operation::enable_instance_sql_ha_standby_detections::EnableInstanceSqlHaStandbyDetections::operation_runtime_plugins(
89                self.handle.runtime_plugins.clone(),
90                &self.handle.conf,
91                self.config_override,
92            );
93        crate::operation::enable_instance_sql_ha_standby_detections::EnableInstanceSqlHaStandbyDetections::orchestrate(&runtime_plugins, input).await
94    }
95
96    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
97    pub fn customize(
98        self,
99    ) -> crate::client::customize::CustomizableOperation<
100        crate::operation::enable_instance_sql_ha_standby_detections::EnableInstanceSqlHaStandbyDetectionsOutput,
101        crate::operation::enable_instance_sql_ha_standby_detections::EnableInstanceSqlHaStandbyDetectionsError,
102        Self,
103    > {
104        crate::client::customize::CustomizableOperation::new(self)
105    }
106    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
107        self.set_config_override(::std::option::Option::Some(config_override.into()));
108        self
109    }
110
111    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
112        self.config_override = config_override;
113        self
114    }
115    ///
116    /// Appends an item to `InstanceIds`.
117    ///
118    /// To override the contents of this collection use [`set_instance_ids`](Self::set_instance_ids).
119    ///
120    /// <p>The IDs of the instances to enable for SQL Server High Availability standby detection monitoring.</p>
121    pub fn instance_ids(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
122        self.inner = self.inner.instance_ids(input.into());
123        self
124    }
125    /// <p>The IDs of the instances to enable for SQL Server High Availability standby detection monitoring.</p>
126    pub fn set_instance_ids(mut self, input: ::std::option::Option<::std::vec::Vec<::std::string::String>>) -> Self {
127        self.inner = self.inner.set_instance_ids(input);
128        self
129    }
130    /// <p>The IDs of the instances to enable for SQL Server High Availability standby detection monitoring.</p>
131    pub fn get_instance_ids(&self) -> &::std::option::Option<::std::vec::Vec<::std::string::String>> {
132        self.inner.get_instance_ids()
133    }
134    /// <p>The ARN of the Secrets Manager secret containing the SQL Server access credentials. The specified secret must contain valid SQL Server credentials for the specified instances. If not specified, deafult local user credentials will be used by the Amazon Web Services Systems Manager agent. To enable instances with different credentials, you must make separate requests.</p>
135    pub fn sql_server_credentials(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
136        self.inner = self.inner.sql_server_credentials(input.into());
137        self
138    }
139    /// <p>The ARN of the Secrets Manager secret containing the SQL Server access credentials. The specified secret must contain valid SQL Server credentials for the specified instances. If not specified, deafult local user credentials will be used by the Amazon Web Services Systems Manager agent. To enable instances with different credentials, you must make separate requests.</p>
140    pub fn set_sql_server_credentials(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
141        self.inner = self.inner.set_sql_server_credentials(input);
142        self
143    }
144    /// <p>The ARN of the Secrets Manager secret containing the SQL Server access credentials. The specified secret must contain valid SQL Server credentials for the specified instances. If not specified, deafult local user credentials will be used by the Amazon Web Services Systems Manager agent. To enable instances with different credentials, you must make separate requests.</p>
145    pub fn get_sql_server_credentials(&self) -> &::std::option::Option<::std::string::String> {
146        self.inner.get_sql_server_credentials()
147    }
148    /// <p>Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p>
149    pub fn dry_run(mut self, input: bool) -> Self {
150        self.inner = self.inner.dry_run(input);
151        self
152    }
153    /// <p>Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p>
154    pub fn set_dry_run(mut self, input: ::std::option::Option<bool>) -> Self {
155        self.inner = self.inner.set_dry_run(input);
156        self
157    }
158    /// <p>Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p>
159    pub fn get_dry_run(&self) -> &::std::option::Option<bool> {
160        self.inner.get_dry_run()
161    }
162}