aws_sdk_chime/config/
endpoint.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use ::aws_smithy_runtime_api::client::endpoint::EndpointFuture;
3pub use ::aws_smithy_runtime_api::client::endpoint::SharedEndpointResolver;
4pub use ::aws_smithy_types::endpoint::Endpoint;
5
6#[cfg(test)]
7mod test {
8
9    /// For region aws-global with FIPS disabled and DualStack disabled
10    #[test]
11    fn test_1() {
12        let params = crate::config::endpoint::Params::builder()
13            .region("aws-global".to_string())
14            .use_fips(false)
15            .use_dual_stack(false)
16            .build()
17            .expect("invalid params");
18        let resolver = crate::config::endpoint::DefaultResolver::new();
19        let endpoint = resolver.resolve_endpoint(&params);
20        let endpoint = endpoint.expect("Expected valid endpoint: https://chime.us-east-1.amazonaws.com");
21        assert_eq!(
22            endpoint,
23            ::aws_smithy_types::endpoint::Endpoint::builder()
24                .url("https://chime.us-east-1.amazonaws.com")
25                .property(
26                    "authSchemes",
27                    vec![{
28                        let mut out = ::std::collections::HashMap::<String, ::aws_smithy_types::Document>::new();
29                        out.insert("name".to_string(), "sigv4".to_string().into());
30                        out.insert("signingName".to_string(), "chime".to_string().into());
31                        out.insert("signingRegion".to_string(), "us-east-1".to_string().into());
32                        out
33                    }
34                    .into()]
35                )
36                .build()
37        );
38    }
39
40    /// For region us-east-1 with FIPS enabled and DualStack enabled
41    #[test]
42    fn test_2() {
43        let params = crate::config::endpoint::Params::builder()
44            .region("us-east-1".to_string())
45            .use_fips(true)
46            .use_dual_stack(true)
47            .build()
48            .expect("invalid params");
49        let resolver = crate::config::endpoint::DefaultResolver::new();
50        let endpoint = resolver.resolve_endpoint(&params);
51        let endpoint = endpoint.expect("Expected valid endpoint: https://chime-fips.us-east-1.api.aws");
52        assert_eq!(
53            endpoint,
54            ::aws_smithy_types::endpoint::Endpoint::builder()
55                .url("https://chime-fips.us-east-1.api.aws")
56                .build()
57        );
58    }
59
60    /// For region us-east-1 with FIPS enabled and DualStack disabled
61    #[test]
62    fn test_3() {
63        let params = crate::config::endpoint::Params::builder()
64            .region("us-east-1".to_string())
65            .use_fips(true)
66            .use_dual_stack(false)
67            .build()
68            .expect("invalid params");
69        let resolver = crate::config::endpoint::DefaultResolver::new();
70        let endpoint = resolver.resolve_endpoint(&params);
71        let endpoint = endpoint.expect("Expected valid endpoint: https://chime-fips.us-east-1.amazonaws.com");
72        assert_eq!(
73            endpoint,
74            ::aws_smithy_types::endpoint::Endpoint::builder()
75                .url("https://chime-fips.us-east-1.amazonaws.com")
76                .build()
77        );
78    }
79
80    /// For region us-east-1 with FIPS disabled and DualStack enabled
81    #[test]
82    fn test_4() {
83        let params = crate::config::endpoint::Params::builder()
84            .region("us-east-1".to_string())
85            .use_fips(false)
86            .use_dual_stack(true)
87            .build()
88            .expect("invalid params");
89        let resolver = crate::config::endpoint::DefaultResolver::new();
90        let endpoint = resolver.resolve_endpoint(&params);
91        let endpoint = endpoint.expect("Expected valid endpoint: https://chime.us-east-1.api.aws");
92        assert_eq!(
93            endpoint,
94            ::aws_smithy_types::endpoint::Endpoint::builder()
95                .url("https://chime.us-east-1.api.aws")
96                .build()
97        );
98    }
99
100    /// For region us-east-1 with FIPS disabled and DualStack disabled
101    #[test]
102    fn test_5() {
103        let params = crate::config::endpoint::Params::builder()
104            .region("us-east-1".to_string())
105            .use_fips(false)
106            .use_dual_stack(false)
107            .build()
108            .expect("invalid params");
109        let resolver = crate::config::endpoint::DefaultResolver::new();
110        let endpoint = resolver.resolve_endpoint(&params);
111        let endpoint = endpoint.expect("Expected valid endpoint: https://chime.us-east-1.amazonaws.com");
112        assert_eq!(
113            endpoint,
114            ::aws_smithy_types::endpoint::Endpoint::builder()
115                .url("https://chime.us-east-1.amazonaws.com")
116                .property(
117                    "authSchemes",
118                    vec![{
119                        let mut out = ::std::collections::HashMap::<String, ::aws_smithy_types::Document>::new();
120                        out.insert("name".to_string(), "sigv4".to_string().into());
121                        out.insert("signingName".to_string(), "chime".to_string().into());
122                        out.insert("signingRegion".to_string(), "us-east-1".to_string().into());
123                        out
124                    }
125                    .into()]
126                )
127                .build()
128        );
129    }
130
131    /// For region cn-north-1 with FIPS enabled and DualStack enabled
132    #[test]
133    fn test_6() {
134        let params = crate::config::endpoint::Params::builder()
135            .region("cn-north-1".to_string())
136            .use_fips(true)
137            .use_dual_stack(true)
138            .build()
139            .expect("invalid params");
140        let resolver = crate::config::endpoint::DefaultResolver::new();
141        let endpoint = resolver.resolve_endpoint(&params);
142        let endpoint = endpoint.expect("Expected valid endpoint: https://chime-fips.cn-north-1.api.amazonwebservices.com.cn");
143        assert_eq!(
144            endpoint,
145            ::aws_smithy_types::endpoint::Endpoint::builder()
146                .url("https://chime-fips.cn-north-1.api.amazonwebservices.com.cn")
147                .build()
148        );
149    }
150
151    /// For region cn-north-1 with FIPS enabled and DualStack disabled
152    #[test]
153    fn test_7() {
154        let params = crate::config::endpoint::Params::builder()
155            .region("cn-north-1".to_string())
156            .use_fips(true)
157            .use_dual_stack(false)
158            .build()
159            .expect("invalid params");
160        let resolver = crate::config::endpoint::DefaultResolver::new();
161        let endpoint = resolver.resolve_endpoint(&params);
162        let endpoint = endpoint.expect("Expected valid endpoint: https://chime-fips.cn-north-1.amazonaws.com.cn");
163        assert_eq!(
164            endpoint,
165            ::aws_smithy_types::endpoint::Endpoint::builder()
166                .url("https://chime-fips.cn-north-1.amazonaws.com.cn")
167                .build()
168        );
169    }
170
171    /// For region cn-north-1 with FIPS disabled and DualStack enabled
172    #[test]
173    fn test_8() {
174        let params = crate::config::endpoint::Params::builder()
175            .region("cn-north-1".to_string())
176            .use_fips(false)
177            .use_dual_stack(true)
178            .build()
179            .expect("invalid params");
180        let resolver = crate::config::endpoint::DefaultResolver::new();
181        let endpoint = resolver.resolve_endpoint(&params);
182        let endpoint = endpoint.expect("Expected valid endpoint: https://chime.cn-north-1.api.amazonwebservices.com.cn");
183        assert_eq!(
184            endpoint,
185            ::aws_smithy_types::endpoint::Endpoint::builder()
186                .url("https://chime.cn-north-1.api.amazonwebservices.com.cn")
187                .build()
188        );
189    }
190
191    /// For region cn-north-1 with FIPS disabled and DualStack disabled
192    #[test]
193    fn test_9() {
194        let params = crate::config::endpoint::Params::builder()
195            .region("cn-north-1".to_string())
196            .use_fips(false)
197            .use_dual_stack(false)
198            .build()
199            .expect("invalid params");
200        let resolver = crate::config::endpoint::DefaultResolver::new();
201        let endpoint = resolver.resolve_endpoint(&params);
202        let endpoint = endpoint.expect("Expected valid endpoint: https://chime.cn-north-1.amazonaws.com.cn");
203        assert_eq!(
204            endpoint,
205            ::aws_smithy_types::endpoint::Endpoint::builder()
206                .url("https://chime.cn-north-1.amazonaws.com.cn")
207                .build()
208        );
209    }
210
211    /// For region us-gov-east-1 with FIPS enabled and DualStack enabled
212    #[test]
213    fn test_10() {
214        let params = crate::config::endpoint::Params::builder()
215            .region("us-gov-east-1".to_string())
216            .use_fips(true)
217            .use_dual_stack(true)
218            .build()
219            .expect("invalid params");
220        let resolver = crate::config::endpoint::DefaultResolver::new();
221        let endpoint = resolver.resolve_endpoint(&params);
222        let endpoint = endpoint.expect("Expected valid endpoint: https://chime-fips.us-gov-east-1.api.aws");
223        assert_eq!(
224            endpoint,
225            ::aws_smithy_types::endpoint::Endpoint::builder()
226                .url("https://chime-fips.us-gov-east-1.api.aws")
227                .build()
228        );
229    }
230
231    /// For region us-gov-east-1 with FIPS enabled and DualStack disabled
232    #[test]
233    fn test_11() {
234        let params = crate::config::endpoint::Params::builder()
235            .region("us-gov-east-1".to_string())
236            .use_fips(true)
237            .use_dual_stack(false)
238            .build()
239            .expect("invalid params");
240        let resolver = crate::config::endpoint::DefaultResolver::new();
241        let endpoint = resolver.resolve_endpoint(&params);
242        let endpoint = endpoint.expect("Expected valid endpoint: https://chime-fips.us-gov-east-1.amazonaws.com");
243        assert_eq!(
244            endpoint,
245            ::aws_smithy_types::endpoint::Endpoint::builder()
246                .url("https://chime-fips.us-gov-east-1.amazonaws.com")
247                .build()
248        );
249    }
250
251    /// For region us-gov-east-1 with FIPS disabled and DualStack enabled
252    #[test]
253    fn test_12() {
254        let params = crate::config::endpoint::Params::builder()
255            .region("us-gov-east-1".to_string())
256            .use_fips(false)
257            .use_dual_stack(true)
258            .build()
259            .expect("invalid params");
260        let resolver = crate::config::endpoint::DefaultResolver::new();
261        let endpoint = resolver.resolve_endpoint(&params);
262        let endpoint = endpoint.expect("Expected valid endpoint: https://chime.us-gov-east-1.api.aws");
263        assert_eq!(
264            endpoint,
265            ::aws_smithy_types::endpoint::Endpoint::builder()
266                .url("https://chime.us-gov-east-1.api.aws")
267                .build()
268        );
269    }
270
271    /// For region us-gov-east-1 with FIPS disabled and DualStack disabled
272    #[test]
273    fn test_13() {
274        let params = crate::config::endpoint::Params::builder()
275            .region("us-gov-east-1".to_string())
276            .use_fips(false)
277            .use_dual_stack(false)
278            .build()
279            .expect("invalid params");
280        let resolver = crate::config::endpoint::DefaultResolver::new();
281        let endpoint = resolver.resolve_endpoint(&params);
282        let endpoint = endpoint.expect("Expected valid endpoint: https://chime.us-gov-east-1.amazonaws.com");
283        assert_eq!(
284            endpoint,
285            ::aws_smithy_types::endpoint::Endpoint::builder()
286                .url("https://chime.us-gov-east-1.amazonaws.com")
287                .build()
288        );
289    }
290
291    /// For region us-iso-east-1 with FIPS enabled and DualStack disabled
292    #[test]
293    fn test_14() {
294        let params = crate::config::endpoint::Params::builder()
295            .region("us-iso-east-1".to_string())
296            .use_fips(true)
297            .use_dual_stack(false)
298            .build()
299            .expect("invalid params");
300        let resolver = crate::config::endpoint::DefaultResolver::new();
301        let endpoint = resolver.resolve_endpoint(&params);
302        let endpoint = endpoint.expect("Expected valid endpoint: https://chime-fips.us-iso-east-1.c2s.ic.gov");
303        assert_eq!(
304            endpoint,
305            ::aws_smithy_types::endpoint::Endpoint::builder()
306                .url("https://chime-fips.us-iso-east-1.c2s.ic.gov")
307                .build()
308        );
309    }
310
311    /// For region us-iso-east-1 with FIPS disabled and DualStack disabled
312    #[test]
313    fn test_15() {
314        let params = crate::config::endpoint::Params::builder()
315            .region("us-iso-east-1".to_string())
316            .use_fips(false)
317            .use_dual_stack(false)
318            .build()
319            .expect("invalid params");
320        let resolver = crate::config::endpoint::DefaultResolver::new();
321        let endpoint = resolver.resolve_endpoint(&params);
322        let endpoint = endpoint.expect("Expected valid endpoint: https://chime.us-iso-east-1.c2s.ic.gov");
323        assert_eq!(
324            endpoint,
325            ::aws_smithy_types::endpoint::Endpoint::builder()
326                .url("https://chime.us-iso-east-1.c2s.ic.gov")
327                .build()
328        );
329    }
330
331    /// For region us-isob-east-1 with FIPS enabled and DualStack disabled
332    #[test]
333    fn test_16() {
334        let params = crate::config::endpoint::Params::builder()
335            .region("us-isob-east-1".to_string())
336            .use_fips(true)
337            .use_dual_stack(false)
338            .build()
339            .expect("invalid params");
340        let resolver = crate::config::endpoint::DefaultResolver::new();
341        let endpoint = resolver.resolve_endpoint(&params);
342        let endpoint = endpoint.expect("Expected valid endpoint: https://chime-fips.us-isob-east-1.sc2s.sgov.gov");
343        assert_eq!(
344            endpoint,
345            ::aws_smithy_types::endpoint::Endpoint::builder()
346                .url("https://chime-fips.us-isob-east-1.sc2s.sgov.gov")
347                .build()
348        );
349    }
350
351    /// For region us-isob-east-1 with FIPS disabled and DualStack disabled
352    #[test]
353    fn test_17() {
354        let params = crate::config::endpoint::Params::builder()
355            .region("us-isob-east-1".to_string())
356            .use_fips(false)
357            .use_dual_stack(false)
358            .build()
359            .expect("invalid params");
360        let resolver = crate::config::endpoint::DefaultResolver::new();
361        let endpoint = resolver.resolve_endpoint(&params);
362        let endpoint = endpoint.expect("Expected valid endpoint: https://chime.us-isob-east-1.sc2s.sgov.gov");
363        assert_eq!(
364            endpoint,
365            ::aws_smithy_types::endpoint::Endpoint::builder()
366                .url("https://chime.us-isob-east-1.sc2s.sgov.gov")
367                .build()
368        );
369    }
370
371    /// For custom endpoint with region set and fips disabled and dualstack disabled
372    #[test]
373    fn test_18() {
374        let params = crate::config::endpoint::Params::builder()
375            .region("us-east-1".to_string())
376            .use_fips(false)
377            .use_dual_stack(false)
378            .endpoint("https://example.com".to_string())
379            .build()
380            .expect("invalid params");
381        let resolver = crate::config::endpoint::DefaultResolver::new();
382        let endpoint = resolver.resolve_endpoint(&params);
383        let endpoint = endpoint.expect("Expected valid endpoint: https://example.com");
384        assert_eq!(
385            endpoint,
386            ::aws_smithy_types::endpoint::Endpoint::builder().url("https://example.com").build()
387        );
388    }
389
390    /// For custom endpoint with region not set and fips disabled and dualstack disabled
391    #[test]
392    fn test_19() {
393        let params = crate::config::endpoint::Params::builder()
394            .use_fips(false)
395            .use_dual_stack(false)
396            .endpoint("https://example.com".to_string())
397            .build()
398            .expect("invalid params");
399        let resolver = crate::config::endpoint::DefaultResolver::new();
400        let endpoint = resolver.resolve_endpoint(&params);
401        let endpoint = endpoint.expect("Expected valid endpoint: https://example.com");
402        assert_eq!(
403            endpoint,
404            ::aws_smithy_types::endpoint::Endpoint::builder().url("https://example.com").build()
405        );
406    }
407
408    /// For custom endpoint with fips enabled and dualstack disabled
409    #[test]
410    fn test_20() {
411        let params = crate::config::endpoint::Params::builder()
412            .region("us-east-1".to_string())
413            .use_fips(true)
414            .use_dual_stack(false)
415            .endpoint("https://example.com".to_string())
416            .build()
417            .expect("invalid params");
418        let resolver = crate::config::endpoint::DefaultResolver::new();
419        let endpoint = resolver.resolve_endpoint(&params);
420        let error = endpoint.expect_err("expected error: Invalid Configuration: FIPS and custom endpoint are not supported [For custom endpoint with fips enabled and dualstack disabled]");
421        assert_eq!(format!("{}", error), "Invalid Configuration: FIPS and custom endpoint are not supported")
422    }
423
424    /// For custom endpoint with fips disabled and dualstack enabled
425    #[test]
426    fn test_21() {
427        let params = crate::config::endpoint::Params::builder()
428            .region("us-east-1".to_string())
429            .use_fips(false)
430            .use_dual_stack(true)
431            .endpoint("https://example.com".to_string())
432            .build()
433            .expect("invalid params");
434        let resolver = crate::config::endpoint::DefaultResolver::new();
435        let endpoint = resolver.resolve_endpoint(&params);
436        let error = endpoint.expect_err("expected error: Invalid Configuration: Dualstack and custom endpoint are not supported [For custom endpoint with fips disabled and dualstack enabled]");
437        assert_eq!(
438            format!("{}", error),
439            "Invalid Configuration: Dualstack and custom endpoint are not supported"
440        )
441    }
442
443    /// Missing region
444    #[test]
445    fn test_22() {
446        let params = crate::config::endpoint::Params::builder().build().expect("invalid params");
447        let resolver = crate::config::endpoint::DefaultResolver::new();
448        let endpoint = resolver.resolve_endpoint(&params);
449        let error = endpoint.expect_err("expected error: Invalid Configuration: Missing Region [Missing region]");
450        assert_eq!(format!("{}", error), "Invalid Configuration: Missing Region")
451    }
452}
453
454/// Endpoint resolver trait specific to Amazon Chime
455pub trait ResolveEndpoint: ::std::marker::Send + ::std::marker::Sync + ::std::fmt::Debug {
456    /// Resolve an endpoint with the given parameters
457    fn resolve_endpoint<'a>(&'a self, params: &'a crate::config::endpoint::Params) -> ::aws_smithy_runtime_api::client::endpoint::EndpointFuture<'a>;
458
459    /// Convert this service-specific resolver into a `SharedEndpointResolver`
460    ///
461    /// The resulting resolver will downcast `EndpointResolverParams` into `crate::config::endpoint::Params`.
462    fn into_shared_resolver(self) -> ::aws_smithy_runtime_api::client::endpoint::SharedEndpointResolver
463    where
464        Self: Sized + 'static,
465    {
466        ::aws_smithy_runtime_api::client::endpoint::SharedEndpointResolver::new(DowncastParams(self))
467    }
468}
469
470#[derive(Debug)]
471struct DowncastParams<T>(T);
472impl<T> ::aws_smithy_runtime_api::client::endpoint::ResolveEndpoint for DowncastParams<T>
473where
474    T: ResolveEndpoint,
475{
476    fn resolve_endpoint<'a>(
477        &'a self,
478        params: &'a ::aws_smithy_runtime_api::client::endpoint::EndpointResolverParams,
479    ) -> ::aws_smithy_runtime_api::client::endpoint::EndpointFuture<'a> {
480        let ep = match params.get::<crate::config::endpoint::Params>() {
481            Some(params) => self.0.resolve_endpoint(params),
482            None => ::aws_smithy_runtime_api::client::endpoint::EndpointFuture::ready(Err("params of expected type was not present".into())),
483        };
484        ep
485    }
486}
487
488/// The default endpoint resolver
489#[derive(Debug, Default)]
490pub struct DefaultResolver {
491    partition_resolver: crate::endpoint_lib::partition::PartitionResolver,
492}
493
494impl DefaultResolver {
495    /// Create a new endpoint resolver with default settings
496    pub fn new() -> Self {
497        Self {
498            partition_resolver: crate::endpoint_lib::DEFAULT_PARTITION_RESOLVER.clone(),
499        }
500    }
501
502    fn resolve_endpoint(
503        &self,
504        params: &crate::config::endpoint::Params,
505    ) -> ::std::result::Result<::aws_smithy_types::endpoint::Endpoint, ::aws_smithy_runtime_api::box_error::BoxError> {
506        let mut diagnostic_collector = crate::endpoint_lib::diagnostic::DiagnosticCollector::new();
507        Ok(
508            crate::config::endpoint::internals::resolve_endpoint(params, &mut diagnostic_collector, &self.partition_resolver)
509                .map_err(|err| err.with_source(diagnostic_collector.take_last_error()))?,
510        )
511    }
512}
513
514impl crate::config::endpoint::ResolveEndpoint for DefaultResolver {
515    fn resolve_endpoint(&self, params: &crate::config::endpoint::Params) -> ::aws_smithy_runtime_api::client::endpoint::EndpointFuture<'_> {
516        ::aws_smithy_runtime_api::client::endpoint::EndpointFuture::ready(self.resolve_endpoint(params))
517    }
518}
519
520#[non_exhaustive]
521#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::fmt::Debug)]
522/// Configuration parameters for resolving the correct endpoint
523pub struct Params {
524    /// The AWS region used to dispatch the request.
525    pub(crate) region: ::std::option::Option<::std::string::String>,
526    /// When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.
527    pub(crate) use_dual_stack: bool,
528    /// When true, send this request to the FIPS-compliant regional endpoint. If the configured endpoint does not have a FIPS compliant endpoint, dispatching the request will return an error.
529    pub(crate) use_fips: bool,
530    /// Override the endpoint used to send this request
531    pub(crate) endpoint: ::std::option::Option<::std::string::String>,
532}
533impl Params {
534    /// Create a builder for [`Params`]
535    pub fn builder() -> crate::config::endpoint::ParamsBuilder {
536        crate::config::endpoint::ParamsBuilder::default()
537    }
538    /// The AWS region used to dispatch the request.
539    pub fn region(&self) -> ::std::option::Option<&str> {
540        self.region.as_deref()
541    }
542    /// When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.
543    pub fn use_dual_stack(&self) -> ::std::option::Option<bool> {
544        Some(self.use_dual_stack)
545    }
546    /// When true, send this request to the FIPS-compliant regional endpoint. If the configured endpoint does not have a FIPS compliant endpoint, dispatching the request will return an error.
547    pub fn use_fips(&self) -> ::std::option::Option<bool> {
548        Some(self.use_fips)
549    }
550    /// Override the endpoint used to send this request
551    pub fn endpoint(&self) -> ::std::option::Option<&str> {
552        self.endpoint.as_deref()
553    }
554}
555
556/// Builder for [`Params`]
557#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::default::Default, ::std::fmt::Debug)]
558pub struct ParamsBuilder {
559    region: ::std::option::Option<::std::string::String>,
560    use_dual_stack: ::std::option::Option<bool>,
561    use_fips: ::std::option::Option<bool>,
562    endpoint: ::std::option::Option<::std::string::String>,
563}
564impl ParamsBuilder {
565    /// Consume this builder, creating [`Params`].
566    pub fn build(self) -> ::std::result::Result<crate::config::endpoint::Params, crate::config::endpoint::InvalidParams> {
567        if let Some(region) = &self.region {
568            if !crate::endpoint_lib::host::is_valid_host_label(
569                region.as_ref() as &str,
570                true,
571                &mut crate::endpoint_lib::diagnostic::DiagnosticCollector::new(),
572            ) {
573                return Err(crate::config::endpoint::InvalidParams::invalid_value(
574                    "region",
575                    "must be a valid host label",
576                ));
577            }
578        };
579        Ok(
580            #[allow(clippy::unnecessary_lazy_evaluations)]
581            crate::config::endpoint::Params {
582                region: self.region,
583                use_dual_stack: self
584                    .use_dual_stack
585                    .or_else(|| Some(false))
586                    .ok_or_else(|| crate::config::endpoint::InvalidParams::missing("use_dual_stack"))?,
587                use_fips: self
588                    .use_fips
589                    .or_else(|| Some(false))
590                    .ok_or_else(|| crate::config::endpoint::InvalidParams::missing("use_fips"))?,
591                endpoint: self.endpoint,
592            },
593        )
594    }
595    /// Sets the value for region
596    ///
597    /// The AWS region used to dispatch the request.
598    pub fn region(mut self, value: impl Into<::std::string::String>) -> Self {
599        self.region = Some(value.into());
600        self
601    }
602
603    /// Sets the value for region
604    ///
605    /// The AWS region used to dispatch the request.
606    pub fn set_region(mut self, param: Option<::std::string::String>) -> Self {
607        self.region = param;
608        self
609    }
610    /// Sets the value for use_dual_stack
611    ///
612    /// When unset, this parameter has a default value of `false`.
613    /// When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.
614    pub fn use_dual_stack(mut self, value: impl Into<bool>) -> Self {
615        self.use_dual_stack = Some(value.into());
616        self
617    }
618
619    /// Sets the value for use_dual_stack
620    ///
621    /// When unset, this parameter has a default value of `false`.
622    /// When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.
623    pub fn set_use_dual_stack(mut self, param: Option<bool>) -> Self {
624        self.use_dual_stack = param;
625        self
626    }
627    /// Sets the value for use_fips
628    ///
629    /// When unset, this parameter has a default value of `false`.
630    /// When true, send this request to the FIPS-compliant regional endpoint. If the configured endpoint does not have a FIPS compliant endpoint, dispatching the request will return an error.
631    pub fn use_fips(mut self, value: impl Into<bool>) -> Self {
632        self.use_fips = Some(value.into());
633        self
634    }
635
636    /// Sets the value for use_fips
637    ///
638    /// When unset, this parameter has a default value of `false`.
639    /// When true, send this request to the FIPS-compliant regional endpoint. If the configured endpoint does not have a FIPS compliant endpoint, dispatching the request will return an error.
640    pub fn set_use_fips(mut self, param: Option<bool>) -> Self {
641        self.use_fips = param;
642        self
643    }
644    /// Sets the value for endpoint
645    ///
646    /// Override the endpoint used to send this request
647    pub fn endpoint(mut self, value: impl Into<::std::string::String>) -> Self {
648        self.endpoint = Some(value.into());
649        self
650    }
651
652    /// Sets the value for endpoint
653    ///
654    /// Override the endpoint used to send this request
655    pub fn set_endpoint(mut self, param: Option<::std::string::String>) -> Self {
656        self.endpoint = param;
657        self
658    }
659}
660
661/// An error that occurred during endpoint resolution
662#[derive(Debug)]
663pub struct InvalidParams {
664    field: std::borrow::Cow<'static, str>,
665    kind: InvalidParamsErrorKind,
666}
667
668/// The kind of invalid parameter error
669#[derive(Debug)]
670enum InvalidParamsErrorKind {
671    MissingField,
672    InvalidValue { message: &'static str },
673}
674
675impl InvalidParams {
676    #[allow(dead_code)]
677    fn missing(field: &'static str) -> Self {
678        Self {
679            field: field.into(),
680            kind: InvalidParamsErrorKind::MissingField,
681        }
682    }
683
684    #[allow(dead_code)]
685    fn invalid_value(field: &'static str, message: &'static str) -> Self {
686        Self {
687            field: field.into(),
688            kind: InvalidParamsErrorKind::InvalidValue { message },
689        }
690    }
691}
692
693impl std::fmt::Display for InvalidParams {
694    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
695        match self.kind {
696            InvalidParamsErrorKind::MissingField => write!(f, "a required field was missing: `{}`", self.field),
697            InvalidParamsErrorKind::InvalidValue { message } => write!(f, "invalid value for field: `{}` - {}", self.field, message),
698        }
699    }
700}
701
702impl std::error::Error for InvalidParams {}
703
704mod internals;