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

aws_sdk_imagebuilder/config/
endpoint.rs
