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

aws_sdk_datapipeline/config/
endpoint.rs
