aws_sdk_iot/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
10impl ::aws_smithy_runtime_api::client::interceptors::Intercept for EndpointOverrideFeatureTrackerInterceptor {
11    fn name(&self) -> &'static str {
12        "EndpointOverrideFeatureTrackerInterceptor"
13    }
14
15    fn read_before_execution(
16        &self,
17        _context: &::aws_smithy_runtime_api::client::interceptors::context::BeforeSerializationInterceptorContextRef<'_>,
18        cfg: &mut ::aws_smithy_types::config_bag::ConfigBag,
19    ) -> ::std::result::Result<(), ::aws_smithy_runtime_api::box_error::BoxError> {
20        if cfg.load::<::aws_types::endpoint_config::EndpointUrl>().is_some() {
21            cfg.interceptor_state()
22                .store_append(::aws_runtime::sdk_feature::AwsSdkFeature::EndpointOverride);
23        }
24        ::std::result::Result::Ok(())
25    }
26}
27
28#[cfg(test)]
29mod test {
30
31    /// For region ap-east-1 with FIPS disabled and DualStack disabled
32    #[test]
33    fn test_1() {
34        let params = crate::config::endpoint::Params::builder()
35            .region("ap-east-1".to_string())
36            .use_fips(false)
37            .use_dual_stack(false)
38            .build()
39            .expect("invalid params");
40        let resolver = crate::config::endpoint::DefaultResolver::new();
41        let endpoint = resolver.resolve_endpoint(&params);
42        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.ap-east-1.amazonaws.com");
43        assert_eq!(
44            endpoint,
45            ::aws_smithy_types::endpoint::Endpoint::builder()
46                .url("https://iot.ap-east-1.amazonaws.com")
47                .build()
48        );
49    }
50
51    /// For region ap-northeast-1 with FIPS disabled and DualStack disabled
52    #[test]
53    fn test_2() {
54        let params = crate::config::endpoint::Params::builder()
55            .region("ap-northeast-1".to_string())
56            .use_fips(false)
57            .use_dual_stack(false)
58            .build()
59            .expect("invalid params");
60        let resolver = crate::config::endpoint::DefaultResolver::new();
61        let endpoint = resolver.resolve_endpoint(&params);
62        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.ap-northeast-1.amazonaws.com");
63        assert_eq!(
64            endpoint,
65            ::aws_smithy_types::endpoint::Endpoint::builder()
66                .url("https://iot.ap-northeast-1.amazonaws.com")
67                .build()
68        );
69    }
70
71    /// For region ap-northeast-2 with FIPS disabled and DualStack disabled
72    #[test]
73    fn test_3() {
74        let params = crate::config::endpoint::Params::builder()
75            .region("ap-northeast-2".to_string())
76            .use_fips(false)
77            .use_dual_stack(false)
78            .build()
79            .expect("invalid params");
80        let resolver = crate::config::endpoint::DefaultResolver::new();
81        let endpoint = resolver.resolve_endpoint(&params);
82        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.ap-northeast-2.amazonaws.com");
83        assert_eq!(
84            endpoint,
85            ::aws_smithy_types::endpoint::Endpoint::builder()
86                .url("https://iot.ap-northeast-2.amazonaws.com")
87                .build()
88        );
89    }
90
91    /// For region ap-south-1 with FIPS disabled and DualStack disabled
92    #[test]
93    fn test_4() {
94        let params = crate::config::endpoint::Params::builder()
95            .region("ap-south-1".to_string())
96            .use_fips(false)
97            .use_dual_stack(false)
98            .build()
99            .expect("invalid params");
100        let resolver = crate::config::endpoint::DefaultResolver::new();
101        let endpoint = resolver.resolve_endpoint(&params);
102        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.ap-south-1.amazonaws.com");
103        assert_eq!(
104            endpoint,
105            ::aws_smithy_types::endpoint::Endpoint::builder()
106                .url("https://iot.ap-south-1.amazonaws.com")
107                .build()
108        );
109    }
110
111    /// For region ap-southeast-1 with FIPS disabled and DualStack disabled
112    #[test]
113    fn test_5() {
114        let params = crate::config::endpoint::Params::builder()
115            .region("ap-southeast-1".to_string())
116            .use_fips(false)
117            .use_dual_stack(false)
118            .build()
119            .expect("invalid params");
120        let resolver = crate::config::endpoint::DefaultResolver::new();
121        let endpoint = resolver.resolve_endpoint(&params);
122        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.ap-southeast-1.amazonaws.com");
123        assert_eq!(
124            endpoint,
125            ::aws_smithy_types::endpoint::Endpoint::builder()
126                .url("https://iot.ap-southeast-1.amazonaws.com")
127                .build()
128        );
129    }
130
131    /// For region ap-southeast-2 with FIPS disabled and DualStack disabled
132    #[test]
133    fn test_6() {
134        let params = crate::config::endpoint::Params::builder()
135            .region("ap-southeast-2".to_string())
136            .use_fips(false)
137            .use_dual_stack(false)
138            .build()
139            .expect("invalid params");
140        let resolver = crate::config::endpoint::DefaultResolver::new();
141        let endpoint = resolver.resolve_endpoint(&params);
142        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.ap-southeast-2.amazonaws.com");
143        assert_eq!(
144            endpoint,
145            ::aws_smithy_types::endpoint::Endpoint::builder()
146                .url("https://iot.ap-southeast-2.amazonaws.com")
147                .build()
148        );
149    }
150
151    /// For region ca-central-1 with FIPS disabled and DualStack disabled
152    #[test]
153    fn test_7() {
154        let params = crate::config::endpoint::Params::builder()
155            .region("ca-central-1".to_string())
156            .use_fips(false)
157            .use_dual_stack(false)
158            .build()
159            .expect("invalid params");
160        let resolver = crate::config::endpoint::DefaultResolver::new();
161        let endpoint = resolver.resolve_endpoint(&params);
162        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.ca-central-1.amazonaws.com");
163        assert_eq!(
164            endpoint,
165            ::aws_smithy_types::endpoint::Endpoint::builder()
166                .url("https://iot.ca-central-1.amazonaws.com")
167                .build()
168        );
169    }
170
171    /// For region ca-central-1 with FIPS enabled and DualStack disabled
172    #[test]
173    fn test_8() {
174        let params = crate::config::endpoint::Params::builder()
175            .region("ca-central-1".to_string())
176            .use_fips(true)
177            .use_dual_stack(false)
178            .build()
179            .expect("invalid params");
180        let resolver = crate::config::endpoint::DefaultResolver::new();
181        let endpoint = resolver.resolve_endpoint(&params);
182        let endpoint = endpoint.expect("Expected valid endpoint: https://iot-fips.ca-central-1.amazonaws.com");
183        assert_eq!(
184            endpoint,
185            ::aws_smithy_types::endpoint::Endpoint::builder()
186                .url("https://iot-fips.ca-central-1.amazonaws.com")
187                .build()
188        );
189    }
190
191    /// For region eu-central-1 with FIPS disabled and DualStack disabled
192    #[test]
193    fn test_9() {
194        let params = crate::config::endpoint::Params::builder()
195            .region("eu-central-1".to_string())
196            .use_fips(false)
197            .use_dual_stack(false)
198            .build()
199            .expect("invalid params");
200        let resolver = crate::config::endpoint::DefaultResolver::new();
201        let endpoint = resolver.resolve_endpoint(&params);
202        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.eu-central-1.amazonaws.com");
203        assert_eq!(
204            endpoint,
205            ::aws_smithy_types::endpoint::Endpoint::builder()
206                .url("https://iot.eu-central-1.amazonaws.com")
207                .build()
208        );
209    }
210
211    /// For region eu-north-1 with FIPS disabled and DualStack disabled
212    #[test]
213    fn test_10() {
214        let params = crate::config::endpoint::Params::builder()
215            .region("eu-north-1".to_string())
216            .use_fips(false)
217            .use_dual_stack(false)
218            .build()
219            .expect("invalid params");
220        let resolver = crate::config::endpoint::DefaultResolver::new();
221        let endpoint = resolver.resolve_endpoint(&params);
222        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.eu-north-1.amazonaws.com");
223        assert_eq!(
224            endpoint,
225            ::aws_smithy_types::endpoint::Endpoint::builder()
226                .url("https://iot.eu-north-1.amazonaws.com")
227                .build()
228        );
229    }
230
231    /// For region eu-west-1 with FIPS disabled and DualStack disabled
232    #[test]
233    fn test_11() {
234        let params = crate::config::endpoint::Params::builder()
235            .region("eu-west-1".to_string())
236            .use_fips(false)
237            .use_dual_stack(false)
238            .build()
239            .expect("invalid params");
240        let resolver = crate::config::endpoint::DefaultResolver::new();
241        let endpoint = resolver.resolve_endpoint(&params);
242        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.eu-west-1.amazonaws.com");
243        assert_eq!(
244            endpoint,
245            ::aws_smithy_types::endpoint::Endpoint::builder()
246                .url("https://iot.eu-west-1.amazonaws.com")
247                .build()
248        );
249    }
250
251    /// For region eu-west-2 with FIPS disabled and DualStack disabled
252    #[test]
253    fn test_12() {
254        let params = crate::config::endpoint::Params::builder()
255            .region("eu-west-2".to_string())
256            .use_fips(false)
257            .use_dual_stack(false)
258            .build()
259            .expect("invalid params");
260        let resolver = crate::config::endpoint::DefaultResolver::new();
261        let endpoint = resolver.resolve_endpoint(&params);
262        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.eu-west-2.amazonaws.com");
263        assert_eq!(
264            endpoint,
265            ::aws_smithy_types::endpoint::Endpoint::builder()
266                .url("https://iot.eu-west-2.amazonaws.com")
267                .build()
268        );
269    }
270
271    /// For region eu-west-3 with FIPS disabled and DualStack disabled
272    #[test]
273    fn test_13() {
274        let params = crate::config::endpoint::Params::builder()
275            .region("eu-west-3".to_string())
276            .use_fips(false)
277            .use_dual_stack(false)
278            .build()
279            .expect("invalid params");
280        let resolver = crate::config::endpoint::DefaultResolver::new();
281        let endpoint = resolver.resolve_endpoint(&params);
282        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.eu-west-3.amazonaws.com");
283        assert_eq!(
284            endpoint,
285            ::aws_smithy_types::endpoint::Endpoint::builder()
286                .url("https://iot.eu-west-3.amazonaws.com")
287                .build()
288        );
289    }
290
291    /// For region me-south-1 with FIPS disabled and DualStack disabled
292    #[test]
293    fn test_14() {
294        let params = crate::config::endpoint::Params::builder()
295            .region("me-south-1".to_string())
296            .use_fips(false)
297            .use_dual_stack(false)
298            .build()
299            .expect("invalid params");
300        let resolver = crate::config::endpoint::DefaultResolver::new();
301        let endpoint = resolver.resolve_endpoint(&params);
302        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.me-south-1.amazonaws.com");
303        assert_eq!(
304            endpoint,
305            ::aws_smithy_types::endpoint::Endpoint::builder()
306                .url("https://iot.me-south-1.amazonaws.com")
307                .build()
308        );
309    }
310
311    /// For region sa-east-1 with FIPS disabled and DualStack disabled
312    #[test]
313    fn test_15() {
314        let params = crate::config::endpoint::Params::builder()
315            .region("sa-east-1".to_string())
316            .use_fips(false)
317            .use_dual_stack(false)
318            .build()
319            .expect("invalid params");
320        let resolver = crate::config::endpoint::DefaultResolver::new();
321        let endpoint = resolver.resolve_endpoint(&params);
322        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.sa-east-1.amazonaws.com");
323        assert_eq!(
324            endpoint,
325            ::aws_smithy_types::endpoint::Endpoint::builder()
326                .url("https://iot.sa-east-1.amazonaws.com")
327                .build()
328        );
329    }
330
331    /// For region us-east-1 with FIPS disabled and DualStack disabled
332    #[test]
333    fn test_16() {
334        let params = crate::config::endpoint::Params::builder()
335            .region("us-east-1".to_string())
336            .use_fips(false)
337            .use_dual_stack(false)
338            .build()
339            .expect("invalid params");
340        let resolver = crate::config::endpoint::DefaultResolver::new();
341        let endpoint = resolver.resolve_endpoint(&params);
342        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.us-east-1.amazonaws.com");
343        assert_eq!(
344            endpoint,
345            ::aws_smithy_types::endpoint::Endpoint::builder()
346                .url("https://iot.us-east-1.amazonaws.com")
347                .build()
348        );
349    }
350
351    /// For region us-east-1 with FIPS enabled and DualStack disabled
352    #[test]
353    fn test_17() {
354        let params = crate::config::endpoint::Params::builder()
355            .region("us-east-1".to_string())
356            .use_fips(true)
357            .use_dual_stack(false)
358            .build()
359            .expect("invalid params");
360        let resolver = crate::config::endpoint::DefaultResolver::new();
361        let endpoint = resolver.resolve_endpoint(&params);
362        let endpoint = endpoint.expect("Expected valid endpoint: https://iot-fips.us-east-1.amazonaws.com");
363        assert_eq!(
364            endpoint,
365            ::aws_smithy_types::endpoint::Endpoint::builder()
366                .url("https://iot-fips.us-east-1.amazonaws.com")
367                .build()
368        );
369    }
370
371    /// For region us-east-2 with FIPS disabled and DualStack disabled
372    #[test]
373    fn test_18() {
374        let params = crate::config::endpoint::Params::builder()
375            .region("us-east-2".to_string())
376            .use_fips(false)
377            .use_dual_stack(false)
378            .build()
379            .expect("invalid params");
380        let resolver = crate::config::endpoint::DefaultResolver::new();
381        let endpoint = resolver.resolve_endpoint(&params);
382        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.us-east-2.amazonaws.com");
383        assert_eq!(
384            endpoint,
385            ::aws_smithy_types::endpoint::Endpoint::builder()
386                .url("https://iot.us-east-2.amazonaws.com")
387                .build()
388        );
389    }
390
391    /// For region us-east-2 with FIPS enabled and DualStack disabled
392    #[test]
393    fn test_19() {
394        let params = crate::config::endpoint::Params::builder()
395            .region("us-east-2".to_string())
396            .use_fips(true)
397            .use_dual_stack(false)
398            .build()
399            .expect("invalid params");
400        let resolver = crate::config::endpoint::DefaultResolver::new();
401        let endpoint = resolver.resolve_endpoint(&params);
402        let endpoint = endpoint.expect("Expected valid endpoint: https://iot-fips.us-east-2.amazonaws.com");
403        assert_eq!(
404            endpoint,
405            ::aws_smithy_types::endpoint::Endpoint::builder()
406                .url("https://iot-fips.us-east-2.amazonaws.com")
407                .build()
408        );
409    }
410
411    /// For region us-west-1 with FIPS disabled and DualStack disabled
412    #[test]
413    fn test_20() {
414        let params = crate::config::endpoint::Params::builder()
415            .region("us-west-1".to_string())
416            .use_fips(false)
417            .use_dual_stack(false)
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://iot.us-west-1.amazonaws.com");
423        assert_eq!(
424            endpoint,
425            ::aws_smithy_types::endpoint::Endpoint::builder()
426                .url("https://iot.us-west-1.amazonaws.com")
427                .build()
428        );
429    }
430
431    /// For region us-west-1 with FIPS enabled and DualStack disabled
432    #[test]
433    fn test_21() {
434        let params = crate::config::endpoint::Params::builder()
435            .region("us-west-1".to_string())
436            .use_fips(true)
437            .use_dual_stack(false)
438            .build()
439            .expect("invalid params");
440        let resolver = crate::config::endpoint::DefaultResolver::new();
441        let endpoint = resolver.resolve_endpoint(&params);
442        let endpoint = endpoint.expect("Expected valid endpoint: https://iot-fips.us-west-1.amazonaws.com");
443        assert_eq!(
444            endpoint,
445            ::aws_smithy_types::endpoint::Endpoint::builder()
446                .url("https://iot-fips.us-west-1.amazonaws.com")
447                .build()
448        );
449    }
450
451    /// For region us-west-2 with FIPS disabled and DualStack disabled
452    #[test]
453    fn test_22() {
454        let params = crate::config::endpoint::Params::builder()
455            .region("us-west-2".to_string())
456            .use_fips(false)
457            .use_dual_stack(false)
458            .build()
459            .expect("invalid params");
460        let resolver = crate::config::endpoint::DefaultResolver::new();
461        let endpoint = resolver.resolve_endpoint(&params);
462        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.us-west-2.amazonaws.com");
463        assert_eq!(
464            endpoint,
465            ::aws_smithy_types::endpoint::Endpoint::builder()
466                .url("https://iot.us-west-2.amazonaws.com")
467                .build()
468        );
469    }
470
471    /// For region us-west-2 with FIPS enabled and DualStack disabled
472    #[test]
473    fn test_23() {
474        let params = crate::config::endpoint::Params::builder()
475            .region("us-west-2".to_string())
476            .use_fips(true)
477            .use_dual_stack(false)
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://iot-fips.us-west-2.amazonaws.com");
483        assert_eq!(
484            endpoint,
485            ::aws_smithy_types::endpoint::Endpoint::builder()
486                .url("https://iot-fips.us-west-2.amazonaws.com")
487                .build()
488        );
489    }
490
491    /// For region us-east-1 with FIPS enabled and DualStack enabled
492    #[test]
493    fn test_24() {
494        let params = crate::config::endpoint::Params::builder()
495            .region("us-east-1".to_string())
496            .use_fips(true)
497            .use_dual_stack(true)
498            .build()
499            .expect("invalid params");
500        let resolver = crate::config::endpoint::DefaultResolver::new();
501        let endpoint = resolver.resolve_endpoint(&params);
502        let endpoint = endpoint.expect("Expected valid endpoint: https://iot-fips.us-east-1.api.aws");
503        assert_eq!(
504            endpoint,
505            ::aws_smithy_types::endpoint::Endpoint::builder()
506                .url("https://iot-fips.us-east-1.api.aws")
507                .build()
508        );
509    }
510
511    /// For region us-east-1 with FIPS disabled and DualStack enabled
512    #[test]
513    fn test_25() {
514        let params = crate::config::endpoint::Params::builder()
515            .region("us-east-1".to_string())
516            .use_fips(false)
517            .use_dual_stack(true)
518            .build()
519            .expect("invalid params");
520        let resolver = crate::config::endpoint::DefaultResolver::new();
521        let endpoint = resolver.resolve_endpoint(&params);
522        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.us-east-1.api.aws");
523        assert_eq!(
524            endpoint,
525            ::aws_smithy_types::endpoint::Endpoint::builder()
526                .url("https://iot.us-east-1.api.aws")
527                .build()
528        );
529    }
530
531    /// For region cn-north-1 with FIPS disabled and DualStack disabled
532    #[test]
533    fn test_26() {
534        let params = crate::config::endpoint::Params::builder()
535            .region("cn-north-1".to_string())
536            .use_fips(false)
537            .use_dual_stack(false)
538            .build()
539            .expect("invalid params");
540        let resolver = crate::config::endpoint::DefaultResolver::new();
541        let endpoint = resolver.resolve_endpoint(&params);
542        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.cn-north-1.amazonaws.com.cn");
543        assert_eq!(
544            endpoint,
545            ::aws_smithy_types::endpoint::Endpoint::builder()
546                .url("https://iot.cn-north-1.amazonaws.com.cn")
547                .build()
548        );
549    }
550
551    /// For region cn-northwest-1 with FIPS disabled and DualStack disabled
552    #[test]
553    fn test_27() {
554        let params = crate::config::endpoint::Params::builder()
555            .region("cn-northwest-1".to_string())
556            .use_fips(false)
557            .use_dual_stack(false)
558            .build()
559            .expect("invalid params");
560        let resolver = crate::config::endpoint::DefaultResolver::new();
561        let endpoint = resolver.resolve_endpoint(&params);
562        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.cn-northwest-1.amazonaws.com.cn");
563        assert_eq!(
564            endpoint,
565            ::aws_smithy_types::endpoint::Endpoint::builder()
566                .url("https://iot.cn-northwest-1.amazonaws.com.cn")
567                .build()
568        );
569    }
570
571    /// For region cn-north-1 with FIPS enabled and DualStack enabled
572    #[test]
573    fn test_28() {
574        let params = crate::config::endpoint::Params::builder()
575            .region("cn-north-1".to_string())
576            .use_fips(true)
577            .use_dual_stack(true)
578            .build()
579            .expect("invalid params");
580        let resolver = crate::config::endpoint::DefaultResolver::new();
581        let endpoint = resolver.resolve_endpoint(&params);
582        let endpoint = endpoint.expect("Expected valid endpoint: https://iot-fips.cn-north-1.api.amazonwebservices.com.cn");
583        assert_eq!(
584            endpoint,
585            ::aws_smithy_types::endpoint::Endpoint::builder()
586                .url("https://iot-fips.cn-north-1.api.amazonwebservices.com.cn")
587                .build()
588        );
589    }
590
591    /// For region cn-north-1 with FIPS enabled and DualStack disabled
592    #[test]
593    fn test_29() {
594        let params = crate::config::endpoint::Params::builder()
595            .region("cn-north-1".to_string())
596            .use_fips(true)
597            .use_dual_stack(false)
598            .build()
599            .expect("invalid params");
600        let resolver = crate::config::endpoint::DefaultResolver::new();
601        let endpoint = resolver.resolve_endpoint(&params);
602        let endpoint = endpoint.expect("Expected valid endpoint: https://iot-fips.cn-north-1.amazonaws.com.cn");
603        assert_eq!(
604            endpoint,
605            ::aws_smithy_types::endpoint::Endpoint::builder()
606                .url("https://iot-fips.cn-north-1.amazonaws.com.cn")
607                .build()
608        );
609    }
610
611    /// For region cn-north-1 with FIPS disabled and DualStack enabled
612    #[test]
613    fn test_30() {
614        let params = crate::config::endpoint::Params::builder()
615            .region("cn-north-1".to_string())
616            .use_fips(false)
617            .use_dual_stack(true)
618            .build()
619            .expect("invalid params");
620        let resolver = crate::config::endpoint::DefaultResolver::new();
621        let endpoint = resolver.resolve_endpoint(&params);
622        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.cn-north-1.api.amazonwebservices.com.cn");
623        assert_eq!(
624            endpoint,
625            ::aws_smithy_types::endpoint::Endpoint::builder()
626                .url("https://iot.cn-north-1.api.amazonwebservices.com.cn")
627                .build()
628        );
629    }
630
631    /// For region us-gov-east-1 with FIPS disabled and DualStack disabled
632    #[test]
633    fn test_31() {
634        let params = crate::config::endpoint::Params::builder()
635            .region("us-gov-east-1".to_string())
636            .use_fips(false)
637            .use_dual_stack(false)
638            .build()
639            .expect("invalid params");
640        let resolver = crate::config::endpoint::DefaultResolver::new();
641        let endpoint = resolver.resolve_endpoint(&params);
642        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.us-gov-east-1.amazonaws.com");
643        assert_eq!(
644            endpoint,
645            ::aws_smithy_types::endpoint::Endpoint::builder()
646                .url("https://iot.us-gov-east-1.amazonaws.com")
647                .build()
648        );
649    }
650
651    /// For region us-gov-east-1 with FIPS enabled and DualStack disabled
652    #[test]
653    fn test_32() {
654        let params = crate::config::endpoint::Params::builder()
655            .region("us-gov-east-1".to_string())
656            .use_fips(true)
657            .use_dual_stack(false)
658            .build()
659            .expect("invalid params");
660        let resolver = crate::config::endpoint::DefaultResolver::new();
661        let endpoint = resolver.resolve_endpoint(&params);
662        let endpoint = endpoint.expect("Expected valid endpoint: https://iot-fips.us-gov-east-1.amazonaws.com");
663        assert_eq!(
664            endpoint,
665            ::aws_smithy_types::endpoint::Endpoint::builder()
666                .url("https://iot-fips.us-gov-east-1.amazonaws.com")
667                .build()
668        );
669    }
670
671    /// For region us-gov-west-1 with FIPS disabled and DualStack disabled
672    #[test]
673    fn test_33() {
674        let params = crate::config::endpoint::Params::builder()
675            .region("us-gov-west-1".to_string())
676            .use_fips(false)
677            .use_dual_stack(false)
678            .build()
679            .expect("invalid params");
680        let resolver = crate::config::endpoint::DefaultResolver::new();
681        let endpoint = resolver.resolve_endpoint(&params);
682        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.us-gov-west-1.amazonaws.com");
683        assert_eq!(
684            endpoint,
685            ::aws_smithy_types::endpoint::Endpoint::builder()
686                .url("https://iot.us-gov-west-1.amazonaws.com")
687                .build()
688        );
689    }
690
691    /// For region us-gov-west-1 with FIPS enabled and DualStack disabled
692    #[test]
693    fn test_34() {
694        let params = crate::config::endpoint::Params::builder()
695            .region("us-gov-west-1".to_string())
696            .use_fips(true)
697            .use_dual_stack(false)
698            .build()
699            .expect("invalid params");
700        let resolver = crate::config::endpoint::DefaultResolver::new();
701        let endpoint = resolver.resolve_endpoint(&params);
702        let endpoint = endpoint.expect("Expected valid endpoint: https://iot-fips.us-gov-west-1.amazonaws.com");
703        assert_eq!(
704            endpoint,
705            ::aws_smithy_types::endpoint::Endpoint::builder()
706                .url("https://iot-fips.us-gov-west-1.amazonaws.com")
707                .build()
708        );
709    }
710
711    /// For region us-gov-east-1 with FIPS enabled and DualStack enabled
712    #[test]
713    fn test_35() {
714        let params = crate::config::endpoint::Params::builder()
715            .region("us-gov-east-1".to_string())
716            .use_fips(true)
717            .use_dual_stack(true)
718            .build()
719            .expect("invalid params");
720        let resolver = crate::config::endpoint::DefaultResolver::new();
721        let endpoint = resolver.resolve_endpoint(&params);
722        let endpoint = endpoint.expect("Expected valid endpoint: https://iot-fips.us-gov-east-1.api.aws");
723        assert_eq!(
724            endpoint,
725            ::aws_smithy_types::endpoint::Endpoint::builder()
726                .url("https://iot-fips.us-gov-east-1.api.aws")
727                .build()
728        );
729    }
730
731    /// For region us-gov-east-1 with FIPS disabled and DualStack enabled
732    #[test]
733    fn test_36() {
734        let params = crate::config::endpoint::Params::builder()
735            .region("us-gov-east-1".to_string())
736            .use_fips(false)
737            .use_dual_stack(true)
738            .build()
739            .expect("invalid params");
740        let resolver = crate::config::endpoint::DefaultResolver::new();
741        let endpoint = resolver.resolve_endpoint(&params);
742        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.us-gov-east-1.api.aws");
743        assert_eq!(
744            endpoint,
745            ::aws_smithy_types::endpoint::Endpoint::builder()
746                .url("https://iot.us-gov-east-1.api.aws")
747                .build()
748        );
749    }
750
751    /// For region us-iso-east-1 with FIPS enabled and DualStack disabled
752    #[test]
753    fn test_37() {
754        let params = crate::config::endpoint::Params::builder()
755            .region("us-iso-east-1".to_string())
756            .use_fips(true)
757            .use_dual_stack(false)
758            .build()
759            .expect("invalid params");
760        let resolver = crate::config::endpoint::DefaultResolver::new();
761        let endpoint = resolver.resolve_endpoint(&params);
762        let endpoint = endpoint.expect("Expected valid endpoint: https://iot-fips.us-iso-east-1.c2s.ic.gov");
763        assert_eq!(
764            endpoint,
765            ::aws_smithy_types::endpoint::Endpoint::builder()
766                .url("https://iot-fips.us-iso-east-1.c2s.ic.gov")
767                .build()
768        );
769    }
770
771    /// For region us-iso-east-1 with FIPS disabled and DualStack disabled
772    #[test]
773    fn test_38() {
774        let params = crate::config::endpoint::Params::builder()
775            .region("us-iso-east-1".to_string())
776            .use_fips(false)
777            .use_dual_stack(false)
778            .build()
779            .expect("invalid params");
780        let resolver = crate::config::endpoint::DefaultResolver::new();
781        let endpoint = resolver.resolve_endpoint(&params);
782        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.us-iso-east-1.c2s.ic.gov");
783        assert_eq!(
784            endpoint,
785            ::aws_smithy_types::endpoint::Endpoint::builder()
786                .url("https://iot.us-iso-east-1.c2s.ic.gov")
787                .build()
788        );
789    }
790
791    /// For region us-isob-east-1 with FIPS enabled and DualStack disabled
792    #[test]
793    fn test_39() {
794        let params = crate::config::endpoint::Params::builder()
795            .region("us-isob-east-1".to_string())
796            .use_fips(true)
797            .use_dual_stack(false)
798            .build()
799            .expect("invalid params");
800        let resolver = crate::config::endpoint::DefaultResolver::new();
801        let endpoint = resolver.resolve_endpoint(&params);
802        let endpoint = endpoint.expect("Expected valid endpoint: https://iot-fips.us-isob-east-1.sc2s.sgov.gov");
803        assert_eq!(
804            endpoint,
805            ::aws_smithy_types::endpoint::Endpoint::builder()
806                .url("https://iot-fips.us-isob-east-1.sc2s.sgov.gov")
807                .build()
808        );
809    }
810
811    /// For region us-isob-east-1 with FIPS disabled and DualStack disabled
812    #[test]
813    fn test_40() {
814        let params = crate::config::endpoint::Params::builder()
815            .region("us-isob-east-1".to_string())
816            .use_fips(false)
817            .use_dual_stack(false)
818            .build()
819            .expect("invalid params");
820        let resolver = crate::config::endpoint::DefaultResolver::new();
821        let endpoint = resolver.resolve_endpoint(&params);
822        let endpoint = endpoint.expect("Expected valid endpoint: https://iot.us-isob-east-1.sc2s.sgov.gov");
823        assert_eq!(
824            endpoint,
825            ::aws_smithy_types::endpoint::Endpoint::builder()
826                .url("https://iot.us-isob-east-1.sc2s.sgov.gov")
827                .build()
828        );
829    }
830
831    /// For custom endpoint with region set and fips disabled and dualstack disabled
832    #[test]
833    fn test_41() {
834        let params = crate::config::endpoint::Params::builder()
835            .region("us-east-1".to_string())
836            .use_fips(false)
837            .use_dual_stack(false)
838            .endpoint("https://example.com".to_string())
839            .build()
840            .expect("invalid params");
841        let resolver = crate::config::endpoint::DefaultResolver::new();
842        let endpoint = resolver.resolve_endpoint(&params);
843        let endpoint = endpoint.expect("Expected valid endpoint: https://example.com");
844        assert_eq!(
845            endpoint,
846            ::aws_smithy_types::endpoint::Endpoint::builder().url("https://example.com").build()
847        );
848    }
849
850    /// For custom endpoint with region not set and fips disabled and dualstack disabled
851    #[test]
852    fn test_42() {
853        let params = crate::config::endpoint::Params::builder()
854            .use_fips(false)
855            .use_dual_stack(false)
856            .endpoint("https://example.com".to_string())
857            .build()
858            .expect("invalid params");
859        let resolver = crate::config::endpoint::DefaultResolver::new();
860        let endpoint = resolver.resolve_endpoint(&params);
861        let endpoint = endpoint.expect("Expected valid endpoint: https://example.com");
862        assert_eq!(
863            endpoint,
864            ::aws_smithy_types::endpoint::Endpoint::builder().url("https://example.com").build()
865        );
866    }
867
868    /// For custom endpoint with fips enabled and dualstack disabled
869    #[test]
870    fn test_43() {
871        let params = crate::config::endpoint::Params::builder()
872            .region("us-east-1".to_string())
873            .use_fips(true)
874            .use_dual_stack(false)
875            .endpoint("https://example.com".to_string())
876            .build()
877            .expect("invalid params");
878        let resolver = crate::config::endpoint::DefaultResolver::new();
879        let endpoint = resolver.resolve_endpoint(&params);
880        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]");
881        assert_eq!(format!("{}", error), "Invalid Configuration: FIPS and custom endpoint are not supported")
882    }
883
884    /// For custom endpoint with fips disabled and dualstack enabled
885    #[test]
886    fn test_44() {
887        let params = crate::config::endpoint::Params::builder()
888            .region("us-east-1".to_string())
889            .use_fips(false)
890            .use_dual_stack(true)
891            .endpoint("https://example.com".to_string())
892            .build()
893            .expect("invalid params");
894        let resolver = crate::config::endpoint::DefaultResolver::new();
895        let endpoint = resolver.resolve_endpoint(&params);
896        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]");
897        assert_eq!(
898            format!("{}", error),
899            "Invalid Configuration: Dualstack and custom endpoint are not supported"
900        )
901    }
902
903    /// Missing region
904    #[test]
905    fn test_45() {
906        let params = crate::config::endpoint::Params::builder().build().expect("invalid params");
907        let resolver = crate::config::endpoint::DefaultResolver::new();
908        let endpoint = resolver.resolve_endpoint(&params);
909        let error = endpoint.expect_err("expected error: Invalid Configuration: Missing Region [Missing region]");
910        assert_eq!(format!("{}", error), "Invalid Configuration: Missing Region")
911    }
912}
913
914/// Endpoint resolver trait specific to AWS IoT
915pub trait ResolveEndpoint: ::std::marker::Send + ::std::marker::Sync + ::std::fmt::Debug {
916    /// Resolve an endpoint with the given parameters
917    fn resolve_endpoint<'a>(&'a self, params: &'a crate::config::endpoint::Params) -> ::aws_smithy_runtime_api::client::endpoint::EndpointFuture<'a>;
918
919    /// Convert this service-specific resolver into a `SharedEndpointResolver`
920    ///
921    /// The resulting resolver will downcast `EndpointResolverParams` into `crate::config::endpoint::Params`.
922    fn into_shared_resolver(self) -> ::aws_smithy_runtime_api::client::endpoint::SharedEndpointResolver
923    where
924        Self: Sized + 'static,
925    {
926        ::aws_smithy_runtime_api::client::endpoint::SharedEndpointResolver::new(DowncastParams(self))
927    }
928}
929
930#[derive(Debug)]
931struct DowncastParams<T>(T);
932impl<T> ::aws_smithy_runtime_api::client::endpoint::ResolveEndpoint for DowncastParams<T>
933where
934    T: ResolveEndpoint,
935{
936    fn resolve_endpoint<'a>(
937        &'a self,
938        params: &'a ::aws_smithy_runtime_api::client::endpoint::EndpointResolverParams,
939    ) -> ::aws_smithy_runtime_api::client::endpoint::EndpointFuture<'a> {
940        let ep = match params.get::<crate::config::endpoint::Params>() {
941            Some(params) => self.0.resolve_endpoint(params),
942            None => ::aws_smithy_runtime_api::client::endpoint::EndpointFuture::ready(Err("params of expected type was not present".into())),
943        };
944        ep
945    }
946}
947
948/// The default endpoint resolver
949#[derive(Debug, Default)]
950pub struct DefaultResolver {
951    partition_resolver: crate::endpoint_lib::partition::PartitionResolver,
952}
953
954impl DefaultResolver {
955    /// Create a new endpoint resolver with default settings
956    pub fn new() -> Self {
957        Self {
958            partition_resolver: crate::endpoint_lib::DEFAULT_PARTITION_RESOLVER.clone(),
959        }
960    }
961
962    fn resolve_endpoint(
963        &self,
964        params: &crate::config::endpoint::Params,
965    ) -> ::std::result::Result<::aws_smithy_types::endpoint::Endpoint, ::aws_smithy_runtime_api::box_error::BoxError> {
966        let mut diagnostic_collector = crate::endpoint_lib::diagnostic::DiagnosticCollector::new();
967        Ok(
968            crate::config::endpoint::internals::resolve_endpoint(params, &mut diagnostic_collector, &self.partition_resolver)
969                .map_err(|err| err.with_source(diagnostic_collector.take_last_error()))?,
970        )
971    }
972}
973
974impl crate::config::endpoint::ResolveEndpoint for DefaultResolver {
975    fn resolve_endpoint(&self, params: &crate::config::endpoint::Params) -> ::aws_smithy_runtime_api::client::endpoint::EndpointFuture<'_> {
976        ::aws_smithy_runtime_api::client::endpoint::EndpointFuture::ready(self.resolve_endpoint(params))
977    }
978}
979
980#[non_exhaustive]
981#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::fmt::Debug)]
982/// Configuration parameters for resolving the correct endpoint
983pub struct Params {
984    /// The AWS region used to dispatch the request.
985    pub(crate) region: ::std::option::Option<::std::string::String>,
986    /// When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.
987    pub(crate) use_dual_stack: bool,
988    /// 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.
989    pub(crate) use_fips: bool,
990    /// Override the endpoint used to send this request
991    pub(crate) endpoint: ::std::option::Option<::std::string::String>,
992}
993impl Params {
994    /// Create a builder for [`Params`]
995    pub fn builder() -> crate::config::endpoint::ParamsBuilder {
996        crate::config::endpoint::ParamsBuilder::default()
997    }
998    /// The AWS region used to dispatch the request.
999    pub fn region(&self) -> ::std::option::Option<&str> {
1000        self.region.as_deref()
1001    }
1002    /// When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.
1003    pub fn use_dual_stack(&self) -> ::std::option::Option<bool> {
1004        Some(self.use_dual_stack)
1005    }
1006    /// 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.
1007    pub fn use_fips(&self) -> ::std::option::Option<bool> {
1008        Some(self.use_fips)
1009    }
1010    /// Override the endpoint used to send this request
1011    pub fn endpoint(&self) -> ::std::option::Option<&str> {
1012        self.endpoint.as_deref()
1013    }
1014}
1015
1016/// Builder for [`Params`]
1017#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::default::Default, ::std::fmt::Debug)]
1018pub struct ParamsBuilder {
1019    region: ::std::option::Option<::std::string::String>,
1020    use_dual_stack: ::std::option::Option<bool>,
1021    use_fips: ::std::option::Option<bool>,
1022    endpoint: ::std::option::Option<::std::string::String>,
1023}
1024impl ParamsBuilder {
1025    /// Consume this builder, creating [`Params`].
1026    pub fn build(self) -> ::std::result::Result<crate::config::endpoint::Params, crate::config::endpoint::InvalidParams> {
1027        if let Some(region) = &self.region {
1028            if !crate::endpoint_lib::host::is_valid_host_label(
1029                region.as_ref() as &str,
1030                true,
1031                &mut crate::endpoint_lib::diagnostic::DiagnosticCollector::new(),
1032            ) {
1033                return Err(crate::config::endpoint::InvalidParams::invalid_value(
1034                    "region",
1035                    "must be a valid host label",
1036                ));
1037            }
1038        };
1039        Ok(
1040            #[allow(clippy::unnecessary_lazy_evaluations)]
1041            crate::config::endpoint::Params {
1042                region: self.region,
1043                use_dual_stack: self
1044                    .use_dual_stack
1045                    .or_else(|| Some(false))
1046                    .ok_or_else(|| crate::config::endpoint::InvalidParams::missing("use_dual_stack"))?,
1047                use_fips: self
1048                    .use_fips
1049                    .or_else(|| Some(false))
1050                    .ok_or_else(|| crate::config::endpoint::InvalidParams::missing("use_fips"))?,
1051                endpoint: self.endpoint,
1052            },
1053        )
1054    }
1055    /// Sets the value for region
1056    ///
1057    /// The AWS region used to dispatch the request.
1058    pub fn region(mut self, value: impl Into<::std::string::String>) -> Self {
1059        self.region = Some(value.into());
1060        self
1061    }
1062
1063    /// Sets the value for region
1064    ///
1065    /// The AWS region used to dispatch the request.
1066    pub fn set_region(mut self, param: Option<::std::string::String>) -> Self {
1067        self.region = param;
1068        self
1069    }
1070    /// Sets the value for use_dual_stack
1071    ///
1072    /// When unset, this parameter has a default value of `false`.
1073    /// When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.
1074    pub fn use_dual_stack(mut self, value: impl Into<bool>) -> Self {
1075        self.use_dual_stack = Some(value.into());
1076        self
1077    }
1078
1079    /// Sets the value for use_dual_stack
1080    ///
1081    /// When unset, this parameter has a default value of `false`.
1082    /// When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.
1083    pub fn set_use_dual_stack(mut self, param: Option<bool>) -> Self {
1084        self.use_dual_stack = param;
1085        self
1086    }
1087    /// Sets the value for use_fips
1088    ///
1089    /// When unset, this parameter has a default value of `false`.
1090    /// 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.
1091    pub fn use_fips(mut self, value: impl Into<bool>) -> Self {
1092        self.use_fips = Some(value.into());
1093        self
1094    }
1095
1096    /// Sets the value for use_fips
1097    ///
1098    /// When unset, this parameter has a default value of `false`.
1099    /// 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.
1100    pub fn set_use_fips(mut self, param: Option<bool>) -> Self {
1101        self.use_fips = param;
1102        self
1103    }
1104    /// Sets the value for endpoint
1105    ///
1106    /// Override the endpoint used to send this request
1107    pub fn endpoint(mut self, value: impl Into<::std::string::String>) -> Self {
1108        self.endpoint = Some(value.into());
1109        self
1110    }
1111
1112    /// Sets the value for endpoint
1113    ///
1114    /// Override the endpoint used to send this request
1115    pub fn set_endpoint(mut self, param: Option<::std::string::String>) -> Self {
1116        self.endpoint = param;
1117        self
1118    }
1119}
1120
1121/// An error that occurred during endpoint resolution
1122#[derive(Debug)]
1123pub struct InvalidParams {
1124    field: std::borrow::Cow<'static, str>,
1125    kind: InvalidParamsErrorKind,
1126}
1127
1128/// The kind of invalid parameter error
1129#[derive(Debug)]
1130enum InvalidParamsErrorKind {
1131    MissingField,
1132    InvalidValue { message: &'static str },
1133}
1134
1135impl InvalidParams {
1136    #[allow(dead_code)]
1137    fn missing(field: &'static str) -> Self {
1138        Self {
1139            field: field.into(),
1140            kind: InvalidParamsErrorKind::MissingField,
1141        }
1142    }
1143
1144    #[allow(dead_code)]
1145    fn invalid_value(field: &'static str, message: &'static str) -> Self {
1146        Self {
1147            field: field.into(),
1148            kind: InvalidParamsErrorKind::InvalidValue { message },
1149        }
1150    }
1151}
1152
1153impl std::fmt::Display for InvalidParams {
1154    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
1155        match self.kind {
1156            InvalidParamsErrorKind::MissingField => write!(f, "a required field was missing: `{}`", self.field),
1157            InvalidParamsErrorKind::InvalidValue { message } => write!(f, "invalid value for field: `{}` - {}", self.field, message),
1158        }
1159    }
1160}
1161
1162impl std::error::Error for InvalidParams {}
1163
1164mod internals;
aws_sdk_iot/config/endpoint.rs

aws_sdk_iot/config/
endpoint.rs
