aws_sdk_frauddetector/lib.rs
1#![allow(deprecated)]
2#![allow(unknown_lints)]
3#![allow(clippy::module_inception)]
4#![allow(clippy::upper_case_acronyms)]
5#![allow(clippy::large_enum_variant)]
6#![allow(clippy::wrong_self_convention)]
7#![allow(clippy::should_implement_trait)]
8#![allow(clippy::disallowed_names)]
9#![allow(clippy::vec_init_then_push)]
10#![allow(clippy::type_complexity)]
11#![allow(clippy::needless_return)]
12#![allow(clippy::derive_partial_eq_without_eq)]
13#![allow(clippy::result_large_err)]
14#![allow(clippy::unnecessary_map_on_constructor)]
15#![allow(rustdoc::bare_urls)]
16#![allow(rustdoc::redundant_explicit_links)]
17#![forbid(unsafe_code)]
18#![warn(missing_docs)]
19#![cfg_attr(docsrs, feature(doc_auto_cfg))]
20//! This is the Amazon Fraud Detector API Reference. This guide is for developers who need detailed information about Amazon Fraud Detector API actions, data types, and errors. For more information about Amazon Fraud Detector features, see the [Amazon Fraud Detector User Guide](https://docs.aws.amazon.com/frauddetector/latest/ug/).
21//!
22//! We provide the Query API as well as AWS software development kits (SDK) for Amazon Fraud Detector in Java and Python programming languages.
23//!
24//! The Amazon Fraud Detector Query API provides HTTPS requests that use the HTTP verb GET or POST and a Query parameter Action. AWS SDK provides libraries, sample code, tutorials, and other resources for software developers who prefer to build applications using language-specific APIs instead of submitting a request over HTTP or HTTPS. These libraries provide basic functions that automatically take care of tasks such as cryptographically signing your requests, retrying requests, and handling error responses, so that it is easier for you to get started. For more information about the AWS SDKs, go to [Tools to build on AWS](https://aws.amazon.com/developer/tools/) page, scroll down to the __SDK__ section, and choose plus (+) sign to expand the section.
25//!
26//! ## Getting Started
27//!
28//! > Examples are available for many services and operations, check out the
29//! > [examples folder in GitHub](https://github.com/awslabs/aws-sdk-rust/tree/main/examples).
30//!
31//! The SDK provides one crate per AWS service. You must add [Tokio](https://crates.io/crates/tokio)
32//! as a dependency within your Rust project to execute asynchronous code. To add `aws-sdk-frauddetector` to
33//! your project, add the following to your **Cargo.toml** file:
34//!
35//! ```toml
36//! [dependencies]
37//! aws-config = { version = "1.1.7", features = ["behavior-version-latest"] }
38//! aws-sdk-frauddetector = "1.65.0"
39//! tokio = { version = "1", features = ["full"] }
40//! ```
41//!
42//! Then in code, a client can be created with the following:
43//!
44//! ```rust,no_run
45//! use aws_sdk_frauddetector as frauddetector;
46//!
47//! #[::tokio::main]
48//! async fn main() -> Result<(), frauddetector::Error> {
49//! let config = aws_config::load_from_env().await;
50//! let client = aws_sdk_frauddetector::Client::new(&config);
51//!
52//! // ... make some calls with the client
53//!
54//! Ok(())
55//! }
56//! ```
57//!
58//! See the [client documentation](https://docs.rs/aws-sdk-frauddetector/latest/aws_sdk_frauddetector/client/struct.Client.html)
59//! for information on what calls can be made, and the inputs and outputs for each of those calls.
60//!
61//! ## Using the SDK
62//!
63//! Until the SDK is released, we will be adding information about using the SDK to the
64//! [Developer Guide](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/welcome.html). Feel free to suggest
65//! additional sections for the guide by opening an issue and describing what you are trying to do.
66//!
67//! ## Getting Help
68//!
69//! * [GitHub discussions](https://github.com/awslabs/aws-sdk-rust/discussions) - For ideas, RFCs & general questions
70//! * [GitHub issues](https://github.com/awslabs/aws-sdk-rust/issues/new/choose) - For bug reports & feature requests
71//! * [Generated Docs (latest version)](https://awslabs.github.io/aws-sdk-rust/)
72//! * [Usage examples](https://github.com/awslabs/aws-sdk-rust/tree/main/examples)
73//!
74//!
75//! # Crate Organization
76//!
77//! The entry point for most customers will be [`Client`], which exposes one method for each API
78//! offered by Amazon Fraud Detector. The return value of each of these methods is a "fluent builder",
79//! where the different inputs for that API are added by builder-style function call chaining,
80//! followed by calling `send()` to get a [`Future`](std::future::Future) that will result in
81//! either a successful output or a [`SdkError`](crate::error::SdkError).
82//!
83//! Some of these API inputs may be structs or enums to provide more complex structured information.
84//! These structs and enums live in [`types`](crate::types). There are some simpler types for
85//! representing data such as date times or binary blobs that live in [`primitives`](crate::primitives).
86//!
87//! All types required to configure a client via the [`Config`](crate::Config) struct live
88//! in [`config`](crate::config).
89//!
90//! The [`operation`](crate::operation) module has a submodule for every API, and in each submodule
91//! is the input, output, and error type for that API, as well as builders to construct each of those.
92//!
93//! There is a top-level [`Error`](crate::Error) type that encompasses all the errors that the
94//! client can return. Any other error type can be converted to this `Error` type via the
95//! [`From`](std::convert::From) trait.
96//!
97//! The other modules within this crate are not required for normal usage.
98
99// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
100pub use error_meta::Error;
101
102#[doc(inline)]
103pub use config::Config;
104
105/// Client for calling Amazon Fraud Detector.
106/// ## Constructing a `Client`
107///
108/// A [`Config`] is required to construct a client. For most use cases, the [`aws-config`]
109/// crate should be used to automatically resolve this config using
110/// [`aws_config::load_from_env()`], since this will resolve an [`SdkConfig`] which can be shared
111/// across multiple different AWS SDK clients. This config resolution process can be customized
112/// by calling [`aws_config::from_env()`] instead, which returns a [`ConfigLoader`] that uses
113/// the [builder pattern] to customize the default config.
114///
115/// In the simplest case, creating a client looks as follows:
116/// ```rust,no_run
117/// # async fn wrapper() {
118/// let config = aws_config::load_from_env().await;
119/// let client = aws_sdk_frauddetector::Client::new(&config);
120/// # }
121/// ```
122///
123/// Occasionally, SDKs may have additional service-specific values that can be set on the [`Config`] that
124/// is absent from [`SdkConfig`], or slightly different settings for a specific client may be desired.
125/// The [`Builder`](crate::config::Builder) struct implements `From<&SdkConfig>`, so setting these specific settings can be
126/// done as follows:
127///
128/// ```rust,no_run
129/// # async fn wrapper() {
130/// let sdk_config = ::aws_config::load_from_env().await;
131/// let config = aws_sdk_frauddetector::config::Builder::from(&sdk_config)
132/// # /*
133/// .some_service_specific_setting("value")
134/// # */
135/// .build();
136/// # }
137/// ```
138///
139/// See the [`aws-config` docs] and [`Config`] for more information on customizing configuration.
140///
141/// _Note:_ Client construction is expensive due to connection thread pool initialization, and should
142/// be done once at application start-up.
143///
144/// [`Config`]: crate::Config
145/// [`ConfigLoader`]: https://docs.rs/aws-config/*/aws_config/struct.ConfigLoader.html
146/// [`SdkConfig`]: https://docs.rs/aws-config/*/aws_config/struct.SdkConfig.html
147/// [`aws-config` docs]: https://docs.rs/aws-config/*
148/// [`aws-config`]: https://crates.io/crates/aws-config
149/// [`aws_config::from_env()`]: https://docs.rs/aws-config/*/aws_config/fn.from_env.html
150/// [`aws_config::load_from_env()`]: https://docs.rs/aws-config/*/aws_config/fn.load_from_env.html
151/// [builder pattern]: https://rust-lang.github.io/api-guidelines/type-safety.html#builders-enable-construction-of-complex-values-c-builder
152/// # Using the `Client`
153///
154/// A client has a function for every operation that can be performed by the service.
155/// For example, the [`CancelBatchImportJob`](crate::operation::cancel_batch_import_job) operation has
156/// a [`Client::cancel_batch_import_job`], function which returns a builder for that operation.
157/// The fluent builder ultimately has a `send()` function that returns an async future that
158/// returns a result, as illustrated below:
159///
160/// ```rust,ignore
161/// let result = client.cancel_batch_import_job()
162/// .job_id("example")
163/// .send()
164/// .await;
165/// ```
166///
167/// The underlying HTTP requests that get made by this can be modified with the `customize_operation`
168/// function on the fluent builder. See the [`customize`](crate::client::customize) module for more
169/// information.
170pub mod client;
171
172/// Configuration for Amazon Fraud Detector.
173pub mod config;
174
175/// Common errors and error handling utilities.
176pub mod error;
177
178mod error_meta;
179
180/// Information about this crate.
181pub mod meta;
182
183/// All operations that this crate can perform.
184pub mod operation;
185
186/// Primitives such as `Blob` or `DateTime` used by other types.
187pub mod primitives;
188
189/// Data structures used by operation inputs/outputs.
190pub mod types;
191
192mod auth_plugin;
193
194pub(crate) mod protocol_serde;
195
196mod sdk_feature_tracker;
197
198mod serialization_settings;
199
200mod endpoint_lib;
201
202mod lens;
203
204mod serde_util;
205
206mod json_errors;
207
208#[doc(inline)]
209pub use client::Client;