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