aws_sdk_iotthingsgraph/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 ap-northeast-1 with FIPS disabled and DualStack disabled
33    #[test]
34    fn test_1() {
35        let params = crate::config::endpoint::Params::builder()
36            .region("ap-northeast-1".to_string())
37            .use_fips(false)
38            .use_dual_stack(false)
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://iotthingsgraph.ap-northeast-1.amazonaws.com");
44        assert_eq!(
45            endpoint,
46            ::aws_smithy_types::endpoint::Endpoint::builder()
47                .url("https://iotthingsgraph.ap-northeast-1.amazonaws.com")
48                .build()
49        );
50    }
51
52    /// For region ap-northeast-2 with FIPS disabled and DualStack disabled
53    #[test]
54    fn test_2() {
55        let params = crate::config::endpoint::Params::builder()
56            .region("ap-northeast-2".to_string())
57            .use_fips(false)
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://iotthingsgraph.ap-northeast-2.amazonaws.com");
64        assert_eq!(
65            endpoint,
66            ::aws_smithy_types::endpoint::Endpoint::builder()
67                .url("https://iotthingsgraph.ap-northeast-2.amazonaws.com")
68                .build()
69        );
70    }
71
72    /// For region ap-southeast-2 with FIPS disabled and DualStack disabled
73    #[test]
74    fn test_3() {
75        let params = crate::config::endpoint::Params::builder()
76            .region("ap-southeast-2".to_string())
77            .use_fips(false)
78            .use_dual_stack(false)
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://iotthingsgraph.ap-southeast-2.amazonaws.com");
84        assert_eq!(
85            endpoint,
86            ::aws_smithy_types::endpoint::Endpoint::builder()
87                .url("https://iotthingsgraph.ap-southeast-2.amazonaws.com")
88                .build()
89        );
90    }
91
92    /// For region eu-west-1 with FIPS disabled and DualStack disabled
93    #[test]
94    fn test_4() {
95        let params = crate::config::endpoint::Params::builder()
96            .region("eu-west-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://iotthingsgraph.eu-west-1.amazonaws.com");
104        assert_eq!(
105            endpoint,
106            ::aws_smithy_types::endpoint::Endpoint::builder()
107                .url("https://iotthingsgraph.eu-west-1.amazonaws.com")
108                .build()
109        );
110    }
111
112    /// For region us-east-1 with FIPS disabled and DualStack disabled
113    #[test]
114    fn test_5() {
115        let params = crate::config::endpoint::Params::builder()
116            .region("us-east-1".to_string())
117            .use_fips(false)
118            .use_dual_stack(false)
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://iotthingsgraph.us-east-1.amazonaws.com");
124        assert_eq!(
125            endpoint,
126            ::aws_smithy_types::endpoint::Endpoint::builder()
127                .url("https://iotthingsgraph.us-east-1.amazonaws.com")
128                .build()
129        );
130    }
131
132    /// For region us-west-2 with FIPS disabled and DualStack disabled
133    #[test]
134    fn test_6() {
135        let params = crate::config::endpoint::Params::builder()
136            .region("us-west-2".to_string())
137            .use_fips(false)
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://iotthingsgraph.us-west-2.amazonaws.com");
144        assert_eq!(
145            endpoint,
146            ::aws_smithy_types::endpoint::Endpoint::builder()
147                .url("https://iotthingsgraph.us-west-2.amazonaws.com")
148                .build()
149        );
150    }
151
152    /// For region us-east-1 with FIPS enabled and DualStack enabled
153    #[test]
154    fn test_7() {
155        let params = crate::config::endpoint::Params::builder()
156            .region("us-east-1".to_string())
157            .use_fips(true)
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://iotthingsgraph-fips.us-east-1.api.aws");
164        assert_eq!(
165            endpoint,
166            ::aws_smithy_types::endpoint::Endpoint::builder()
167                .url("https://iotthingsgraph-fips.us-east-1.api.aws")
168                .build()
169        );
170    }
171
172    /// For region us-east-1 with FIPS enabled and DualStack disabled
173    #[test]
174    fn test_8() {
175        let params = crate::config::endpoint::Params::builder()
176            .region("us-east-1".to_string())
177            .use_fips(true)
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://iotthingsgraph-fips.us-east-1.amazonaws.com");
184        assert_eq!(
185            endpoint,
186            ::aws_smithy_types::endpoint::Endpoint::builder()
187                .url("https://iotthingsgraph-fips.us-east-1.amazonaws.com")
188                .build()
189        );
190    }
191
192    /// For region us-east-1 with FIPS disabled and DualStack enabled
193    #[test]
194    fn test_9() {
195        let params = crate::config::endpoint::Params::builder()
196            .region("us-east-1".to_string())
197            .use_fips(false)
198            .use_dual_stack(true)
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://iotthingsgraph.us-east-1.api.aws");
204        assert_eq!(
205            endpoint,
206            ::aws_smithy_types::endpoint::Endpoint::builder()
207                .url("https://iotthingsgraph.us-east-1.api.aws")
208                .build()
209        );
210    }
211
212    /// For region cn-north-1 with FIPS enabled and DualStack enabled
213    #[test]
214    fn test_10() {
215        let params = crate::config::endpoint::Params::builder()
216            .region("cn-north-1".to_string())
217            .use_fips(true)
218            .use_dual_stack(true)
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://iotthingsgraph-fips.cn-north-1.api.amazonwebservices.com.cn");
224        assert_eq!(
225            endpoint,
226            ::aws_smithy_types::endpoint::Endpoint::builder()
227                .url("https://iotthingsgraph-fips.cn-north-1.api.amazonwebservices.com.cn")
228                .build()
229        );
230    }
231
232    /// For region cn-north-1 with FIPS enabled and DualStack disabled
233    #[test]
234    fn test_11() {
235        let params = crate::config::endpoint::Params::builder()
236            .region("cn-north-1".to_string())
237            .use_fips(true)
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://iotthingsgraph-fips.cn-north-1.amazonaws.com.cn");
244        assert_eq!(
245            endpoint,
246            ::aws_smithy_types::endpoint::Endpoint::builder()
247                .url("https://iotthingsgraph-fips.cn-north-1.amazonaws.com.cn")
248                .build()
249        );
250    }
251
252    /// For region cn-north-1 with FIPS disabled and DualStack enabled
253    #[test]
254    fn test_12() {
255        let params = crate::config::endpoint::Params::builder()
256            .region("cn-north-1".to_string())
257            .use_fips(false)
258            .use_dual_stack(true)
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://iotthingsgraph.cn-north-1.api.amazonwebservices.com.cn");
264        assert_eq!(
265            endpoint,
266            ::aws_smithy_types::endpoint::Endpoint::builder()
267                .url("https://iotthingsgraph.cn-north-1.api.amazonwebservices.com.cn")
268                .build()
269        );
270    }
271
272    /// For region cn-north-1 with FIPS disabled and DualStack disabled
273    #[test]
274    fn test_13() {
275        let params = crate::config::endpoint::Params::builder()
276            .region("cn-north-1".to_string())
277            .use_fips(false)
278            .use_dual_stack(false)
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://iotthingsgraph.cn-north-1.amazonaws.com.cn");
284        assert_eq!(
285            endpoint,
286            ::aws_smithy_types::endpoint::Endpoint::builder()
287                .url("https://iotthingsgraph.cn-north-1.amazonaws.com.cn")
288                .build()
289        );
290    }
291
292    /// For region us-gov-east-1 with FIPS enabled 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(true)
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://iotthingsgraph-fips.us-gov-east-1.api.aws");
304        assert_eq!(
305            endpoint,
306            ::aws_smithy_types::endpoint::Endpoint::builder()
307                .url("https://iotthingsgraph-fips.us-gov-east-1.api.aws")
308                .build()
309        );
310    }
311
312    /// For region us-gov-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-gov-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://iotthingsgraph-fips.us-gov-east-1.amazonaws.com");
324        assert_eq!(
325            endpoint,
326            ::aws_smithy_types::endpoint::Endpoint::builder()
327                .url("https://iotthingsgraph-fips.us-gov-east-1.amazonaws.com")
328                .build()
329        );
330    }
331
332    /// For region us-gov-east-1 with FIPS disabled and DualStack enabled
333    #[test]
334    fn test_16() {
335        let params = crate::config::endpoint::Params::builder()
336            .region("us-gov-east-1".to_string())
337            .use_fips(false)
338            .use_dual_stack(true)
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://iotthingsgraph.us-gov-east-1.api.aws");
344        assert_eq!(
345            endpoint,
346            ::aws_smithy_types::endpoint::Endpoint::builder()
347                .url("https://iotthingsgraph.us-gov-east-1.api.aws")
348                .build()
349        );
350    }
351
352    /// For region us-gov-east-1 with FIPS disabled and DualStack disabled
353    #[test]
354    fn test_17() {
355        let params = crate::config::endpoint::Params::builder()
356            .region("us-gov-east-1".to_string())
357            .use_fips(false)
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://iotthingsgraph.us-gov-east-1.amazonaws.com");
364        assert_eq!(
365            endpoint,
366            ::aws_smithy_types::endpoint::Endpoint::builder()
367                .url("https://iotthingsgraph.us-gov-east-1.amazonaws.com")
368                .build()
369        );
370    }
371
372    /// For region us-iso-east-1 with FIPS enabled and DualStack disabled
373    #[test]
374    fn test_18() {
375        let params = crate::config::endpoint::Params::builder()
376            .region("us-iso-east-1".to_string())
377            .use_fips(true)
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://iotthingsgraph-fips.us-iso-east-1.c2s.ic.gov");
384        assert_eq!(
385            endpoint,
386            ::aws_smithy_types::endpoint::Endpoint::builder()
387                .url("https://iotthingsgraph-fips.us-iso-east-1.c2s.ic.gov")
388                .build()
389        );
390    }
391
392    /// For region us-iso-east-1 with FIPS disabled and DualStack disabled
393    #[test]
394    fn test_19() {
395        let params = crate::config::endpoint::Params::builder()
396            .region("us-iso-east-1".to_string())
397            .use_fips(false)
398            .use_dual_stack(false)
399            .build()
400            .expect("invalid params");
401        let resolver = crate::config::endpoint::DefaultResolver::new();
402        let endpoint = resolver.resolve_endpoint(&params);
403        let endpoint = endpoint.expect("Expected valid endpoint: https://iotthingsgraph.us-iso-east-1.c2s.ic.gov");
404        assert_eq!(
405            endpoint,
406            ::aws_smithy_types::endpoint::Endpoint::builder()
407                .url("https://iotthingsgraph.us-iso-east-1.c2s.ic.gov")
408                .build()
409        );
410    }
411
412    /// For region us-isob-east-1 with FIPS enabled and DualStack disabled
413    #[test]
414    fn test_20() {
415        let params = crate::config::endpoint::Params::builder()
416            .region("us-isob-east-1".to_string())
417            .use_fips(true)
418            .use_dual_stack(false)
419            .build()
420            .expect("invalid params");
421        let resolver = crate::config::endpoint::DefaultResolver::new();
422        let endpoint = resolver.resolve_endpoint(&params);
423        let endpoint = endpoint.expect("Expected valid endpoint: https://iotthingsgraph-fips.us-isob-east-1.sc2s.sgov.gov");
424        assert_eq!(
425            endpoint,
426            ::aws_smithy_types::endpoint::Endpoint::builder()
427                .url("https://iotthingsgraph-fips.us-isob-east-1.sc2s.sgov.gov")
428                .build()
429        );
430    }
431
432    /// For region us-isob-east-1 with FIPS disabled and DualStack disabled
433    #[test]
434    fn test_21() {
435        let params = crate::config::endpoint::Params::builder()
436            .region("us-isob-east-1".to_string())
437            .use_fips(false)
438            .use_dual_stack(false)
439            .build()
440            .expect("invalid params");
441        let resolver = crate::config::endpoint::DefaultResolver::new();
442        let endpoint = resolver.resolve_endpoint(&params);
443        let endpoint = endpoint.expect("Expected valid endpoint: https://iotthingsgraph.us-isob-east-1.sc2s.sgov.gov");
444        assert_eq!(
445            endpoint,
446            ::aws_smithy_types::endpoint::Endpoint::builder()
447                .url("https://iotthingsgraph.us-isob-east-1.sc2s.sgov.gov")
448                .build()
449        );
450    }
451
452    /// For custom endpoint with region set and fips disabled and dualstack disabled
453    #[test]
454    fn test_22() {
455        let params = crate::config::endpoint::Params::builder()
456            .region("us-east-1".to_string())
457            .use_fips(false)
458            .use_dual_stack(false)
459            .endpoint("https://example.com".to_string())
460            .build()
461            .expect("invalid params");
462        let resolver = crate::config::endpoint::DefaultResolver::new();
463        let endpoint = resolver.resolve_endpoint(&params);
464        let endpoint = endpoint.expect("Expected valid endpoint: https://example.com");
465        assert_eq!(
466            endpoint,
467            ::aws_smithy_types::endpoint::Endpoint::builder().url("https://example.com").build()
468        );
469    }
470
471    /// For custom endpoint with region not set and fips disabled and dualstack disabled
472    #[test]
473    fn test_23() {
474        let params = crate::config::endpoint::Params::builder()
475            .use_fips(false)
476            .use_dual_stack(false)
477            .endpoint("https://example.com".to_string())
478            .build()
479            .expect("invalid params");
480        let resolver = crate::config::endpoint::DefaultResolver::new();
481        let endpoint = resolver.resolve_endpoint(&params);
482        let endpoint = endpoint.expect("Expected valid endpoint: https://example.com");
483        assert_eq!(
484            endpoint,
485            ::aws_smithy_types::endpoint::Endpoint::builder().url("https://example.com").build()
486        );
487    }
488
489    /// For custom endpoint with fips enabled and dualstack disabled
490    #[test]
491    fn test_24() {
492        let params = crate::config::endpoint::Params::builder()
493            .region("us-east-1".to_string())
494            .use_fips(true)
495            .use_dual_stack(false)
496            .endpoint("https://example.com".to_string())
497            .build()
498            .expect("invalid params");
499        let resolver = crate::config::endpoint::DefaultResolver::new();
500        let endpoint = resolver.resolve_endpoint(&params);
501        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]");
502        assert_eq!(format!("{}", error), "Invalid Configuration: FIPS and custom endpoint are not supported")
503    }
504
505    /// For custom endpoint with fips disabled and dualstack enabled
506    #[test]
507    fn test_25() {
508        let params = crate::config::endpoint::Params::builder()
509            .region("us-east-1".to_string())
510            .use_fips(false)
511            .use_dual_stack(true)
512            .endpoint("https://example.com".to_string())
513            .build()
514            .expect("invalid params");
515        let resolver = crate::config::endpoint::DefaultResolver::new();
516        let endpoint = resolver.resolve_endpoint(&params);
517        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]");
518        assert_eq!(
519            format!("{}", error),
520            "Invalid Configuration: Dualstack and custom endpoint are not supported"
521        )
522    }
523
524    /// Missing region
525    #[test]
526    fn test_26() {
527        let params = crate::config::endpoint::Params::builder().build().expect("invalid params");
528        let resolver = crate::config::endpoint::DefaultResolver::new();
529        let endpoint = resolver.resolve_endpoint(&params);
530        let error = endpoint.expect_err("expected error: Invalid Configuration: Missing Region [Missing region]");
531        assert_eq!(format!("{}", error), "Invalid Configuration: Missing Region")
532    }
533}
534
535/// Endpoint resolver trait specific to AWS IoT Things Graph
536pub trait ResolveEndpoint: ::std::marker::Send + ::std::marker::Sync + ::std::fmt::Debug {
537    /// Resolve an endpoint with the given parameters
538    fn resolve_endpoint<'a>(&'a self, params: &'a crate::config::endpoint::Params) -> ::aws_smithy_runtime_api::client::endpoint::EndpointFuture<'a>;
539
540    /// Convert this service-specific resolver into a `SharedEndpointResolver`
541    ///
542    /// The resulting resolver will downcast `EndpointResolverParams` into `crate::config::endpoint::Params`.
543    fn into_shared_resolver(self) -> ::aws_smithy_runtime_api::client::endpoint::SharedEndpointResolver
544    where
545        Self: Sized + 'static,
546    {
547        ::aws_smithy_runtime_api::client::endpoint::SharedEndpointResolver::new(DowncastParams(self))
548    }
549}
550
551#[derive(Debug)]
552struct DowncastParams<T>(T);
553impl<T> ::aws_smithy_runtime_api::client::endpoint::ResolveEndpoint for DowncastParams<T>
554where
555    T: ResolveEndpoint,
556{
557    fn resolve_endpoint<'a>(
558        &'a self,
559        params: &'a ::aws_smithy_runtime_api::client::endpoint::EndpointResolverParams,
560    ) -> ::aws_smithy_runtime_api::client::endpoint::EndpointFuture<'a> {
561        let ep = match params.get::<crate::config::endpoint::Params>() {
562            Some(params) => self.0.resolve_endpoint(params),
563            None => ::aws_smithy_runtime_api::client::endpoint::EndpointFuture::ready(Err("params of expected type was not present".into())),
564        };
565        ep
566    }
567}
568
569/// The default endpoint resolver
570#[derive(Debug, Default)]
571pub struct DefaultResolver {
572    partition_resolver: crate::endpoint_lib::partition::PartitionResolver,
573}
574
575impl DefaultResolver {
576    /// Create a new endpoint resolver with default settings
577    pub fn new() -> Self {
578        Self {
579            partition_resolver: crate::endpoint_lib::DEFAULT_PARTITION_RESOLVER.clone(),
580        }
581    }
582
583    fn resolve_endpoint(
584        &self,
585        params: &crate::config::endpoint::Params,
586    ) -> ::std::result::Result<::aws_smithy_types::endpoint::Endpoint, ::aws_smithy_runtime_api::box_error::BoxError> {
587        let mut diagnostic_collector = crate::endpoint_lib::diagnostic::DiagnosticCollector::new();
588        Ok(
589            crate::config::endpoint::internals::resolve_endpoint(params, &mut diagnostic_collector, &self.partition_resolver)
590                .map_err(|err| err.with_source(diagnostic_collector.take_last_error()))?,
591        )
592    }
593}
594
595impl crate::config::endpoint::ResolveEndpoint for DefaultResolver {
596    fn resolve_endpoint(&self, params: &crate::config::endpoint::Params) -> ::aws_smithy_runtime_api::client::endpoint::EndpointFuture<'_> {
597        ::aws_smithy_runtime_api::client::endpoint::EndpointFuture::ready(self.resolve_endpoint(params))
598    }
599}
600
601#[non_exhaustive]
602#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::fmt::Debug)]
603/// Configuration parameters for resolving the correct endpoint
604pub struct Params {
605    /// The AWS region used to dispatch the request.
606    pub(crate) region: ::std::option::Option<::std::string::String>,
607    /// When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.
608    pub(crate) use_dual_stack: bool,
609    /// 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.
610    pub(crate) use_fips: bool,
611    /// Override the endpoint used to send this request
612    pub(crate) endpoint: ::std::option::Option<::std::string::String>,
613}
614impl Params {
615    /// Create a builder for [`Params`]
616    pub fn builder() -> crate::config::endpoint::ParamsBuilder {
617        crate::config::endpoint::ParamsBuilder::default()
618    }
619    /// The AWS region used to dispatch the request.
620    pub fn region(&self) -> ::std::option::Option<&str> {
621        self.region.as_deref()
622    }
623    /// When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.
624    pub fn use_dual_stack(&self) -> ::std::option::Option<bool> {
625        Some(self.use_dual_stack)
626    }
627    /// 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.
628    pub fn use_fips(&self) -> ::std::option::Option<bool> {
629        Some(self.use_fips)
630    }
631    /// Override the endpoint used to send this request
632    pub fn endpoint(&self) -> ::std::option::Option<&str> {
633        self.endpoint.as_deref()
634    }
635}
636
637/// Builder for [`Params`]
638#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::default::Default, ::std::fmt::Debug)]
639pub struct ParamsBuilder {
640    region: ::std::option::Option<::std::string::String>,
641    use_dual_stack: ::std::option::Option<bool>,
642    use_fips: ::std::option::Option<bool>,
643    endpoint: ::std::option::Option<::std::string::String>,
644}
645impl ParamsBuilder {
646    /// Consume this builder, creating [`Params`].
647    pub fn build(self) -> ::std::result::Result<crate::config::endpoint::Params, crate::config::endpoint::InvalidParams> {
648        if let Some(region) = &self.region {
649            if !crate::endpoint_lib::host::is_valid_host_label(
650                region.as_ref() as &str,
651                true,
652                &mut crate::endpoint_lib::diagnostic::DiagnosticCollector::new(),
653            ) {
654                return Err(crate::config::endpoint::InvalidParams::invalid_value(
655                    "region",
656                    "must be a valid host label",
657                ));
658            }
659        };
660        Ok(
661            #[allow(clippy::unnecessary_lazy_evaluations)]
662            crate::config::endpoint::Params {
663                region: self.region,
664                use_dual_stack: self
665                    .use_dual_stack
666                    .or_else(|| Some(false))
667                    .ok_or_else(|| crate::config::endpoint::InvalidParams::missing("use_dual_stack"))?,
668                use_fips: self
669                    .use_fips
670                    .or_else(|| Some(false))
671                    .ok_or_else(|| crate::config::endpoint::InvalidParams::missing("use_fips"))?,
672                endpoint: self.endpoint,
673            },
674        )
675    }
676    /// Sets the value for region
677    ///
678    /// The AWS region used to dispatch the request.
679    pub fn region(mut self, value: impl Into<::std::string::String>) -> Self {
680        self.region = Some(value.into());
681        self
682    }
683
684    /// Sets the value for region
685    ///
686    /// The AWS region used to dispatch the request.
687    pub fn set_region(mut self, param: Option<::std::string::String>) -> Self {
688        self.region = param;
689        self
690    }
691    /// Sets the value for use_dual_stack
692    ///
693    /// When unset, this parameter has a default value of `false`.
694    /// When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.
695    pub fn use_dual_stack(mut self, value: impl Into<bool>) -> Self {
696        self.use_dual_stack = Some(value.into());
697        self
698    }
699
700    /// Sets the value for use_dual_stack
701    ///
702    /// When unset, this parameter has a default value of `false`.
703    /// When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.
704    pub fn set_use_dual_stack(mut self, param: Option<bool>) -> Self {
705        self.use_dual_stack = param;
706        self
707    }
708    /// Sets the value for use_fips
709    ///
710    /// When unset, this parameter has a default value of `false`.
711    /// 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.
712    pub fn use_fips(mut self, value: impl Into<bool>) -> Self {
713        self.use_fips = Some(value.into());
714        self
715    }
716
717    /// Sets the value for use_fips
718    ///
719    /// When unset, this parameter has a default value of `false`.
720    /// 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.
721    pub fn set_use_fips(mut self, param: Option<bool>) -> Self {
722        self.use_fips = param;
723        self
724    }
725    /// Sets the value for endpoint
726    ///
727    /// Override the endpoint used to send this request
728    pub fn endpoint(mut self, value: impl Into<::std::string::String>) -> Self {
729        self.endpoint = Some(value.into());
730        self
731    }
732
733    /// Sets the value for endpoint
734    ///
735    /// Override the endpoint used to send this request
736    pub fn set_endpoint(mut self, param: Option<::std::string::String>) -> Self {
737        self.endpoint = param;
738        self
739    }
740}
741
742/// An error that occurred during endpoint resolution
743#[derive(Debug)]
744pub struct InvalidParams {
745    field: std::borrow::Cow<'static, str>,
746    kind: InvalidParamsErrorKind,
747}
748
749/// The kind of invalid parameter error
750#[derive(Debug)]
751enum InvalidParamsErrorKind {
752    MissingField,
753    InvalidValue { message: &'static str },
754}
755
756impl InvalidParams {
757    #[allow(dead_code)]
758    fn missing(field: &'static str) -> Self {
759        Self {
760            field: field.into(),
761            kind: InvalidParamsErrorKind::MissingField,
762        }
763    }
764
765    #[allow(dead_code)]
766    fn invalid_value(field: &'static str, message: &'static str) -> Self {
767        Self {
768            field: field.into(),
769            kind: InvalidParamsErrorKind::InvalidValue { message },
770        }
771    }
772}
773
774impl std::fmt::Display for InvalidParams {
775    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
776        match self.kind {
777            InvalidParamsErrorKind::MissingField => write!(f, "a required field was missing: `{}`", self.field),
778            InvalidParamsErrorKind::InvalidValue { message } => write!(f, "invalid value for field: `{}` - {}", self.field, message),
779        }
780    }
781}
782
783impl std::error::Error for InvalidParams {}
784
785mod internals;
aws_sdk_iotthingsgraph/config/endpoint.rs

aws_sdk_iotthingsgraph/config/
endpoint.rs
