aws_sdk_iotdeviceadvisor/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://api.iotdeviceadvisor.ap-northeast-1.amazonaws.com");
21        assert_eq!(
22            endpoint,
23            ::aws_smithy_types::endpoint::Endpoint::builder()
24                .url("https://api.iotdeviceadvisor.ap-northeast-1.amazonaws.com")
25                .build()
26        );
27    }
28
29    /// For region eu-west-1 with FIPS disabled and DualStack disabled
30    #[test]
31    fn test_2() {
32        let params = crate::config::endpoint::Params::builder()
33            .region("eu-west-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://api.iotdeviceadvisor.eu-west-1.amazonaws.com");
41        assert_eq!(
42            endpoint,
43            ::aws_smithy_types::endpoint::Endpoint::builder()
44                .url("https://api.iotdeviceadvisor.eu-west-1.amazonaws.com")
45                .build()
46        );
47    }
48
49    /// For region us-east-1 with FIPS disabled and DualStack disabled
50    #[test]
51    fn test_3() {
52        let params = crate::config::endpoint::Params::builder()
53            .region("us-east-1".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://api.iotdeviceadvisor.us-east-1.amazonaws.com");
61        assert_eq!(
62            endpoint,
63            ::aws_smithy_types::endpoint::Endpoint::builder()
64                .url("https://api.iotdeviceadvisor.us-east-1.amazonaws.com")
65                .build()
66        );
67    }
68
69    /// For region us-west-2 with FIPS disabled and DualStack disabled
70    #[test]
71    fn test_4() {
72        let params = crate::config::endpoint::Params::builder()
73            .region("us-west-2".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://api.iotdeviceadvisor.us-west-2.amazonaws.com");
81        assert_eq!(
82            endpoint,
83            ::aws_smithy_types::endpoint::Endpoint::builder()
84                .url("https://api.iotdeviceadvisor.us-west-2.amazonaws.com")
85                .build()
86        );
87    }
88
89    /// For region us-east-1 with FIPS enabled and DualStack enabled
90    #[test]
91    fn test_5() {
92        let params = crate::config::endpoint::Params::builder()
93            .region("us-east-1".to_string())
94            .use_fips(true)
95            .use_dual_stack(true)
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://api.iotdeviceadvisor-fips.us-east-1.api.aws");
101        assert_eq!(
102            endpoint,
103            ::aws_smithy_types::endpoint::Endpoint::builder()
104                .url("https://api.iotdeviceadvisor-fips.us-east-1.api.aws")
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://api.iotdeviceadvisor-fips.us-east-1.amazonaws.com");
121        assert_eq!(
122            endpoint,
123            ::aws_smithy_types::endpoint::Endpoint::builder()
124                .url("https://api.iotdeviceadvisor-fips.us-east-1.amazonaws.com")
125                .build()
126        );
127    }
128
129    /// For region us-east-1 with FIPS disabled and DualStack enabled
130    #[test]
131    fn test_7() {
132        let params = crate::config::endpoint::Params::builder()
133            .region("us-east-1".to_string())
134            .use_fips(false)
135            .use_dual_stack(true)
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://api.iotdeviceadvisor.us-east-1.api.aws");
141        assert_eq!(
142            endpoint,
143            ::aws_smithy_types::endpoint::Endpoint::builder()
144                .url("https://api.iotdeviceadvisor.us-east-1.api.aws")
145                .build()
146        );
147    }
148
149    /// For region cn-north-1 with FIPS enabled and DualStack enabled
150    #[test]
151    fn test_8() {
152        let params = crate::config::endpoint::Params::builder()
153            .region("cn-north-1".to_string())
154            .use_fips(true)
155            .use_dual_stack(true)
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://api.iotdeviceadvisor-fips.cn-north-1.api.amazonwebservices.com.cn");
161        assert_eq!(
162            endpoint,
163            ::aws_smithy_types::endpoint::Endpoint::builder()
164                .url("https://api.iotdeviceadvisor-fips.cn-north-1.api.amazonwebservices.com.cn")
165                .build()
166        );
167    }
168
169    /// For region cn-north-1 with FIPS enabled and DualStack disabled
170    #[test]
171    fn test_9() {
172        let params = crate::config::endpoint::Params::builder()
173            .region("cn-north-1".to_string())
174            .use_fips(true)
175            .use_dual_stack(false)
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://api.iotdeviceadvisor-fips.cn-north-1.amazonaws.com.cn");
181        assert_eq!(
182            endpoint,
183            ::aws_smithy_types::endpoint::Endpoint::builder()
184                .url("https://api.iotdeviceadvisor-fips.cn-north-1.amazonaws.com.cn")
185                .build()
186        );
187    }
188
189    /// For region cn-north-1 with FIPS disabled and DualStack enabled
190    #[test]
191    fn test_10() {
192        let params = crate::config::endpoint::Params::builder()
193            .region("cn-north-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://api.iotdeviceadvisor.cn-north-1.api.amazonwebservices.com.cn");
201        assert_eq!(
202            endpoint,
203            ::aws_smithy_types::endpoint::Endpoint::builder()
204                .url("https://api.iotdeviceadvisor.cn-north-1.api.amazonwebservices.com.cn")
205                .build()
206        );
207    }
208
209    /// For region cn-north-1 with FIPS disabled and DualStack disabled
210    #[test]
211    fn test_11() {
212        let params = crate::config::endpoint::Params::builder()
213            .region("cn-north-1".to_string())
214            .use_fips(false)
215            .use_dual_stack(false)
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://api.iotdeviceadvisor.cn-north-1.amazonaws.com.cn");
221        assert_eq!(
222            endpoint,
223            ::aws_smithy_types::endpoint::Endpoint::builder()
224                .url("https://api.iotdeviceadvisor.cn-north-1.amazonaws.com.cn")
225                .build()
226        );
227    }
228
229    /// For region us-gov-east-1 with FIPS enabled and DualStack enabled
230    #[test]
231    fn test_12() {
232        let params = crate::config::endpoint::Params::builder()
233            .region("us-gov-east-1".to_string())
234            .use_fips(true)
235            .use_dual_stack(true)
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://api.iotdeviceadvisor-fips.us-gov-east-1.api.aws");
241        assert_eq!(
242            endpoint,
243            ::aws_smithy_types::endpoint::Endpoint::builder()
244                .url("https://api.iotdeviceadvisor-fips.us-gov-east-1.api.aws")
245                .build()
246        );
247    }
248
249    /// For region us-gov-east-1 with FIPS enabled and DualStack disabled
250    #[test]
251    fn test_13() {
252        let params = crate::config::endpoint::Params::builder()
253            .region("us-gov-east-1".to_string())
254            .use_fips(true)
255            .use_dual_stack(false)
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://api.iotdeviceadvisor-fips.us-gov-east-1.amazonaws.com");
261        assert_eq!(
262            endpoint,
263            ::aws_smithy_types::endpoint::Endpoint::builder()
264                .url("https://api.iotdeviceadvisor-fips.us-gov-east-1.amazonaws.com")
265                .build()
266        );
267    }
268
269    /// For region us-gov-east-1 with FIPS disabled and DualStack enabled
270    #[test]
271    fn test_14() {
272        let params = crate::config::endpoint::Params::builder()
273            .region("us-gov-east-1".to_string())
274            .use_fips(false)
275            .use_dual_stack(true)
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://api.iotdeviceadvisor.us-gov-east-1.api.aws");
281        assert_eq!(
282            endpoint,
283            ::aws_smithy_types::endpoint::Endpoint::builder()
284                .url("https://api.iotdeviceadvisor.us-gov-east-1.api.aws")
285                .build()
286        );
287    }
288
289    /// For region us-gov-east-1 with FIPS disabled and DualStack disabled
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(false)
295            .use_dual_stack(false)
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://api.iotdeviceadvisor.us-gov-east-1.amazonaws.com");
301        assert_eq!(
302            endpoint,
303            ::aws_smithy_types::endpoint::Endpoint::builder()
304                .url("https://api.iotdeviceadvisor.us-gov-east-1.amazonaws.com")
305                .build()
306        );
307    }
308
309    /// For region us-iso-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-iso-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://api.iotdeviceadvisor-fips.us-iso-east-1.c2s.ic.gov");
321        assert_eq!(
322            endpoint,
323            ::aws_smithy_types::endpoint::Endpoint::builder()
324                .url("https://api.iotdeviceadvisor-fips.us-iso-east-1.c2s.ic.gov")
325                .build()
326        );
327    }
328
329    /// For region us-iso-east-1 with FIPS disabled and DualStack disabled
330    #[test]
331    fn test_17() {
332        let params = crate::config::endpoint::Params::builder()
333            .region("us-iso-east-1".to_string())
334            .use_fips(false)
335            .use_dual_stack(false)
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://api.iotdeviceadvisor.us-iso-east-1.c2s.ic.gov");
341        assert_eq!(
342            endpoint,
343            ::aws_smithy_types::endpoint::Endpoint::builder()
344                .url("https://api.iotdeviceadvisor.us-iso-east-1.c2s.ic.gov")
345                .build()
346        );
347    }
348
349    /// For region us-isob-east-1 with FIPS enabled and DualStack disabled
350    #[test]
351    fn test_18() {
352        let params = crate::config::endpoint::Params::builder()
353            .region("us-isob-east-1".to_string())
354            .use_fips(true)
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://api.iotdeviceadvisor-fips.us-isob-east-1.sc2s.sgov.gov");
361        assert_eq!(
362            endpoint,
363            ::aws_smithy_types::endpoint::Endpoint::builder()
364                .url("https://api.iotdeviceadvisor-fips.us-isob-east-1.sc2s.sgov.gov")
365                .build()
366        );
367    }
368
369    /// For region us-isob-east-1 with FIPS disabled and DualStack disabled
370    #[test]
371    fn test_19() {
372        let params = crate::config::endpoint::Params::builder()
373            .region("us-isob-east-1".to_string())
374            .use_fips(false)
375            .use_dual_stack(false)
376            .build()
377            .expect("invalid params");
378        let resolver = crate::config::endpoint::DefaultResolver::new();
379        let endpoint = resolver.resolve_endpoint(&params);
380        let endpoint = endpoint.expect("Expected valid endpoint: https://api.iotdeviceadvisor.us-isob-east-1.sc2s.sgov.gov");
381        assert_eq!(
382            endpoint,
383            ::aws_smithy_types::endpoint::Endpoint::builder()
384                .url("https://api.iotdeviceadvisor.us-isob-east-1.sc2s.sgov.gov")
385                .build()
386        );
387    }
388
389    /// For custom endpoint with region set and fips disabled and dualstack disabled
390    #[test]
391    fn test_20() {
392        let params = crate::config::endpoint::Params::builder()
393            .region("us-east-1".to_string())
394            .use_fips(false)
395            .use_dual_stack(false)
396            .endpoint("https://example.com".to_string())
397            .build()
398            .expect("invalid params");
399        let resolver = crate::config::endpoint::DefaultResolver::new();
400        let endpoint = resolver.resolve_endpoint(&params);
401        let endpoint = endpoint.expect("Expected valid endpoint: https://example.com");
402        assert_eq!(
403            endpoint,
404            ::aws_smithy_types::endpoint::Endpoint::builder().url("https://example.com").build()
405        );
406    }
407
408    /// For custom endpoint with region not set and fips disabled and dualstack disabled
409    #[test]
410    fn test_21() {
411        let params = crate::config::endpoint::Params::builder()
412            .use_fips(false)
413            .use_dual_stack(false)
414            .endpoint("https://example.com".to_string())
415            .build()
416            .expect("invalid params");
417        let resolver = crate::config::endpoint::DefaultResolver::new();
418        let endpoint = resolver.resolve_endpoint(&params);
419        let endpoint = endpoint.expect("Expected valid endpoint: https://example.com");
420        assert_eq!(
421            endpoint,
422            ::aws_smithy_types::endpoint::Endpoint::builder().url("https://example.com").build()
423        );
424    }
425
426    /// For custom endpoint with fips enabled and dualstack disabled
427    #[test]
428    fn test_22() {
429        let params = crate::config::endpoint::Params::builder()
430            .region("us-east-1".to_string())
431            .use_fips(true)
432            .use_dual_stack(false)
433            .endpoint("https://example.com".to_string())
434            .build()
435            .expect("invalid params");
436        let resolver = crate::config::endpoint::DefaultResolver::new();
437        let endpoint = resolver.resolve_endpoint(&params);
438        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]");
439        assert_eq!(format!("{}", error), "Invalid Configuration: FIPS and custom endpoint are not supported")
440    }
441
442    /// For custom endpoint with fips disabled and dualstack enabled
443    #[test]
444    fn test_23() {
445        let params = crate::config::endpoint::Params::builder()
446            .region("us-east-1".to_string())
447            .use_fips(false)
448            .use_dual_stack(true)
449            .endpoint("https://example.com".to_string())
450            .build()
451            .expect("invalid params");
452        let resolver = crate::config::endpoint::DefaultResolver::new();
453        let endpoint = resolver.resolve_endpoint(&params);
454        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]");
455        assert_eq!(
456            format!("{}", error),
457            "Invalid Configuration: Dualstack and custom endpoint are not supported"
458        )
459    }
460
461    /// Missing region
462    #[test]
463    fn test_24() {
464        let params = crate::config::endpoint::Params::builder().build().expect("invalid params");
465        let resolver = crate::config::endpoint::DefaultResolver::new();
466        let endpoint = resolver.resolve_endpoint(&params);
467        let error = endpoint.expect_err("expected error: Invalid Configuration: Missing Region [Missing region]");
468        assert_eq!(format!("{}", error), "Invalid Configuration: Missing Region")
469    }
470}
471
472/// Endpoint resolver trait specific to AWS IoT Core Device Advisor
473pub trait ResolveEndpoint: ::std::marker::Send + ::std::marker::Sync + ::std::fmt::Debug {
474    /// Resolve an endpoint with the given parameters
475    fn resolve_endpoint<'a>(&'a self, params: &'a crate::config::endpoint::Params) -> ::aws_smithy_runtime_api::client::endpoint::EndpointFuture<'a>;
476
477    /// Convert this service-specific resolver into a `SharedEndpointResolver`
478    ///
479    /// The resulting resolver will downcast `EndpointResolverParams` into `crate::config::endpoint::Params`.
480    fn into_shared_resolver(self) -> ::aws_smithy_runtime_api::client::endpoint::SharedEndpointResolver
481    where
482        Self: Sized + 'static,
483    {
484        ::aws_smithy_runtime_api::client::endpoint::SharedEndpointResolver::new(DowncastParams(self))
485    }
486}
487
488#[derive(Debug)]
489struct DowncastParams<T>(T);
490impl<T> ::aws_smithy_runtime_api::client::endpoint::ResolveEndpoint for DowncastParams<T>
491where
492    T: ResolveEndpoint,
493{
494    fn resolve_endpoint<'a>(
495        &'a self,
496        params: &'a ::aws_smithy_runtime_api::client::endpoint::EndpointResolverParams,
497    ) -> ::aws_smithy_runtime_api::client::endpoint::EndpointFuture<'a> {
498        let ep = match params.get::<crate::config::endpoint::Params>() {
499            Some(params) => self.0.resolve_endpoint(params),
500            None => ::aws_smithy_runtime_api::client::endpoint::EndpointFuture::ready(Err("params of expected type was not present".into())),
501        };
502        ep
503    }
504}
505
506/// The default endpoint resolver
507#[derive(Debug, Default)]
508pub struct DefaultResolver {
509    partition_resolver: crate::endpoint_lib::partition::PartitionResolver,
510}
511
512impl DefaultResolver {
513    /// Create a new endpoint resolver with default settings
514    pub fn new() -> Self {
515        Self {
516            partition_resolver: crate::endpoint_lib::DEFAULT_PARTITION_RESOLVER.clone(),
517        }
518    }
519
520    fn resolve_endpoint(
521        &self,
522        params: &crate::config::endpoint::Params,
523    ) -> ::std::result::Result<::aws_smithy_types::endpoint::Endpoint, ::aws_smithy_runtime_api::box_error::BoxError> {
524        let mut diagnostic_collector = crate::endpoint_lib::diagnostic::DiagnosticCollector::new();
525        Ok(
526            crate::config::endpoint::internals::resolve_endpoint(params, &mut diagnostic_collector, &self.partition_resolver)
527                .map_err(|err| err.with_source(diagnostic_collector.take_last_error()))?,
528        )
529    }
530}
531
532impl crate::config::endpoint::ResolveEndpoint for DefaultResolver {
533    fn resolve_endpoint(&self, params: &crate::config::endpoint::Params) -> ::aws_smithy_runtime_api::client::endpoint::EndpointFuture<'_> {
534        ::aws_smithy_runtime_api::client::endpoint::EndpointFuture::ready(self.resolve_endpoint(params))
535    }
536}
537
538#[non_exhaustive]
539#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::fmt::Debug)]
540/// Configuration parameters for resolving the correct endpoint
541pub struct Params {
542    /// The AWS region used to dispatch the request.
543    pub(crate) region: ::std::option::Option<::std::string::String>,
544    /// When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.
545    pub(crate) use_dual_stack: bool,
546    /// 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.
547    pub(crate) use_fips: bool,
548    /// Override the endpoint used to send this request
549    pub(crate) endpoint: ::std::option::Option<::std::string::String>,
550}
551impl Params {
552    /// Create a builder for [`Params`]
553    pub fn builder() -> crate::config::endpoint::ParamsBuilder {
554        crate::config::endpoint::ParamsBuilder::default()
555    }
556    /// The AWS region used to dispatch the request.
557    pub fn region(&self) -> ::std::option::Option<&str> {
558        self.region.as_deref()
559    }
560    /// When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.
561    pub fn use_dual_stack(&self) -> ::std::option::Option<bool> {
562        Some(self.use_dual_stack)
563    }
564    /// 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.
565    pub fn use_fips(&self) -> ::std::option::Option<bool> {
566        Some(self.use_fips)
567    }
568    /// Override the endpoint used to send this request
569    pub fn endpoint(&self) -> ::std::option::Option<&str> {
570        self.endpoint.as_deref()
571    }
572}
573
574/// Builder for [`Params`]
575#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::default::Default, ::std::fmt::Debug)]
576pub struct ParamsBuilder {
577    region: ::std::option::Option<::std::string::String>,
578    use_dual_stack: ::std::option::Option<bool>,
579    use_fips: ::std::option::Option<bool>,
580    endpoint: ::std::option::Option<::std::string::String>,
581}
582impl ParamsBuilder {
583    /// Consume this builder, creating [`Params`].
584    pub fn build(self) -> ::std::result::Result<crate::config::endpoint::Params, crate::config::endpoint::InvalidParams> {
585        Ok(
586            #[allow(clippy::unnecessary_lazy_evaluations)]
587            crate::config::endpoint::Params {
588                region: self.region,
589                use_dual_stack: self
590                    .use_dual_stack
591                    .or_else(|| Some(false))
592                    .ok_or_else(|| crate::config::endpoint::InvalidParams::missing("use_dual_stack"))?,
593                use_fips: self
594                    .use_fips
595                    .or_else(|| Some(false))
596                    .ok_or_else(|| crate::config::endpoint::InvalidParams::missing("use_fips"))?,
597                endpoint: self.endpoint,
598            },
599        )
600    }
601    /// Sets the value for region
602    ///
603    /// The AWS region used to dispatch the request.
604    pub fn region(mut self, value: impl Into<::std::string::String>) -> Self {
605        self.region = Some(value.into());
606        self
607    }
608
609    /// Sets the value for region
610    ///
611    /// The AWS region used to dispatch the request.
612    pub fn set_region(mut self, param: Option<::std::string::String>) -> Self {
613        self.region = param;
614        self
615    }
616    /// Sets the value for use_dual_stack
617    ///
618    /// When unset, this parameter has a default value of `false`.
619    /// When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.
620    pub fn use_dual_stack(mut self, value: impl Into<bool>) -> Self {
621        self.use_dual_stack = Some(value.into());
622        self
623    }
624
625    /// Sets the value for use_dual_stack
626    ///
627    /// When unset, this parameter has a default value of `false`.
628    /// When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.
629    pub fn set_use_dual_stack(mut self, param: Option<bool>) -> Self {
630        self.use_dual_stack = param;
631        self
632    }
633    /// Sets the value for use_fips
634    ///
635    /// When unset, this parameter has a default value of `false`.
636    /// 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.
637    pub fn use_fips(mut self, value: impl Into<bool>) -> Self {
638        self.use_fips = Some(value.into());
639        self
640    }
641
642    /// Sets the value for use_fips
643    ///
644    /// When unset, this parameter has a default value of `false`.
645    /// 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.
646    pub fn set_use_fips(mut self, param: Option<bool>) -> Self {
647        self.use_fips = param;
648        self
649    }
650    /// Sets the value for endpoint
651    ///
652    /// Override the endpoint used to send this request
653    pub fn endpoint(mut self, value: impl Into<::std::string::String>) -> Self {
654        self.endpoint = Some(value.into());
655        self
656    }
657
658    /// Sets the value for endpoint
659    ///
660    /// Override the endpoint used to send this request
661    pub fn set_endpoint(mut self, param: Option<::std::string::String>) -> Self {
662        self.endpoint = param;
663        self
664    }
665}
666
667/// An error that occurred during endpoint resolution
668#[derive(Debug)]
669pub struct InvalidParams {
670    field: std::borrow::Cow<'static, str>,
671}
672
673impl InvalidParams {
674    #[allow(dead_code)]
675    fn missing(field: &'static str) -> Self {
676        Self { field: field.into() }
677    }
678}
679
680impl std::fmt::Display for InvalidParams {
681    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
682        write!(f, "a required field was missing: `{}`", self.field)
683    }
684}
685
686impl std::error::Error for InvalidParams {}
687
688mod internals;
aws_sdk_iotdeviceadvisor/config/endpoint.rs

aws_sdk_iotdeviceadvisor/config/
endpoint.rs
