aws_sdk_workdocs/config/
endpoint.rs

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

aws_sdk_workdocs/config/
endpoint.rs
