Skip to main content

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