Struct aws_sdk_personalize::client::Client

source ·
pub struct Client { /* private fields */ }
Expand description

Client for Amazon Personalize

Client for invoking operations on Amazon Personalize. Each operation on Amazon Personalize is a method on this this struct. .send() MUST be invoked on the generated operations to dispatch the request to the service.

§Constructing a Client

A Config is required to construct a client. For most use cases, the aws-config crate should be used to automatically resolve this config using aws_config::load_from_env(), since this will resolve an SdkConfig which can be shared across multiple different AWS SDK clients. This config resolution process can be customized by calling aws_config::from_env() instead, which returns a ConfigLoader that uses the builder pattern to customize the default config.

In the simplest case, creating a client looks as follows:

let config = aws_config::load_from_env().await;
let client = aws_sdk_personalize::Client::new(&config);

Occasionally, SDKs may have additional service-specific values that can be set on the Config that is absent from SdkConfig, or slightly different settings for a specific client may be desired. The Config struct implements From<&SdkConfig>, so setting these specific settings can be done as follows:

let sdk_config = ::aws_config::load_from_env().await;
let config = aws_sdk_personalize::config::Builder::from(&sdk_config)
    .some_service_specific_setting("value")
    .build();

See the aws-config docs and Config for more information on customizing configuration.

Note: Client construction is expensive due to connection thread pool initialization, and should be done once at application start-up.

§Using the Client

A client has a function for every operation that can be performed by the service. For example, the CreateBatchInferenceJob operation has a Client::create_batch_inference_job, function which returns a builder for that operation. The fluent builder ultimately has a send() function that returns an async future that returns a result, as illustrated below:

let result = client.create_batch_inference_job()
    .job_name("example")
    .send()
    .await;

The underlying HTTP requests that get made by this can be modified with the customize_operation function on the fluent builder. See the customize module for more information.

Implementations§

source§

impl Client

source

pub fn create_batch_inference_job(&self) -> CreateBatchInferenceJobFluentBuilder

Constructs a fluent builder for the CreateBatchInferenceJob operation.

source§

impl Client

source

pub fn create_batch_segment_job(&self) -> CreateBatchSegmentJobFluentBuilder

Constructs a fluent builder for the CreateBatchSegmentJob operation.

source§

impl Client

source

pub fn create_campaign(&self) -> CreateCampaignFluentBuilder

Constructs a fluent builder for the CreateCampaign operation.

source§

impl Client

source

pub fn create_dataset(&self) -> CreateDatasetFluentBuilder

Constructs a fluent builder for the CreateDataset operation.

source§

impl Client

source

pub fn create_dataset_export_job(&self) -> CreateDatasetExportJobFluentBuilder

Constructs a fluent builder for the CreateDatasetExportJob operation.

source§

impl Client

source

pub fn create_dataset_group(&self) -> CreateDatasetGroupFluentBuilder

Constructs a fluent builder for the CreateDatasetGroup operation.

source§

impl Client

source

pub fn create_dataset_import_job(&self) -> CreateDatasetImportJobFluentBuilder

Constructs a fluent builder for the CreateDatasetImportJob operation.

source§

impl Client

source

pub fn create_event_tracker(&self) -> CreateEventTrackerFluentBuilder

Constructs a fluent builder for the CreateEventTracker operation.

source§

impl Client

source

pub fn create_filter(&self) -> CreateFilterFluentBuilder

Constructs a fluent builder for the CreateFilter operation.

source§

impl Client

source

pub fn create_metric_attribution(&self) -> CreateMetricAttributionFluentBuilder

Constructs a fluent builder for the CreateMetricAttribution operation.

source§

impl Client

source

pub fn create_recommender(&self) -> CreateRecommenderFluentBuilder

Constructs a fluent builder for the CreateRecommender operation.

source§

impl Client

source

pub fn create_schema(&self) -> CreateSchemaFluentBuilder

Constructs a fluent builder for the CreateSchema operation.

source§

impl Client

source

pub fn create_solution(&self) -> CreateSolutionFluentBuilder

Constructs a fluent builder for the CreateSolution operation.

source§

impl Client

source

pub fn create_solution_version(&self) -> CreateSolutionVersionFluentBuilder

Constructs a fluent builder for the CreateSolutionVersion operation.

source§

impl Client

source

pub fn delete_campaign(&self) -> DeleteCampaignFluentBuilder

Constructs a fluent builder for the DeleteCampaign operation.

source§

impl Client

source

pub fn delete_dataset(&self) -> DeleteDatasetFluentBuilder

Constructs a fluent builder for the DeleteDataset operation.

source§

impl Client

source

pub fn delete_dataset_group(&self) -> DeleteDatasetGroupFluentBuilder

Constructs a fluent builder for the DeleteDatasetGroup operation.

source§

impl Client

source

pub fn delete_event_tracker(&self) -> DeleteEventTrackerFluentBuilder

Constructs a fluent builder for the DeleteEventTracker operation.

source§

impl Client

source

pub fn delete_filter(&self) -> DeleteFilterFluentBuilder

Constructs a fluent builder for the DeleteFilter operation.

source§

impl Client

source

pub fn delete_metric_attribution(&self) -> DeleteMetricAttributionFluentBuilder

Constructs a fluent builder for the DeleteMetricAttribution operation.

source§

impl Client

source

pub fn delete_recommender(&self) -> DeleteRecommenderFluentBuilder

Constructs a fluent builder for the DeleteRecommender operation.

source§

impl Client

source

pub fn delete_schema(&self) -> DeleteSchemaFluentBuilder

Constructs a fluent builder for the DeleteSchema operation.

source§

impl Client

source

pub fn delete_solution(&self) -> DeleteSolutionFluentBuilder

Constructs a fluent builder for the DeleteSolution operation.

source§

impl Client

source

pub fn describe_algorithm(&self) -> DescribeAlgorithmFluentBuilder

Constructs a fluent builder for the DescribeAlgorithm operation.

source§

impl Client

source

pub fn describe_batch_inference_job( &self ) -> DescribeBatchInferenceJobFluentBuilder

Constructs a fluent builder for the DescribeBatchInferenceJob operation.

source§

impl Client

source

pub fn describe_batch_segment_job(&self) -> DescribeBatchSegmentJobFluentBuilder

Constructs a fluent builder for the DescribeBatchSegmentJob operation.

source§

impl Client

source

pub fn describe_campaign(&self) -> DescribeCampaignFluentBuilder

Constructs a fluent builder for the DescribeCampaign operation.

source§

impl Client

source

pub fn describe_dataset(&self) -> DescribeDatasetFluentBuilder

Constructs a fluent builder for the DescribeDataset operation.

source§

impl Client

source

pub fn describe_dataset_export_job( &self ) -> DescribeDatasetExportJobFluentBuilder

Constructs a fluent builder for the DescribeDatasetExportJob operation.

source§

impl Client

source

pub fn describe_dataset_group(&self) -> DescribeDatasetGroupFluentBuilder

Constructs a fluent builder for the DescribeDatasetGroup operation.

source§

impl Client

source

pub fn describe_dataset_import_job( &self ) -> DescribeDatasetImportJobFluentBuilder

Constructs a fluent builder for the DescribeDatasetImportJob operation.

source§

impl Client

source

pub fn describe_event_tracker(&self) -> DescribeEventTrackerFluentBuilder

Constructs a fluent builder for the DescribeEventTracker operation.

source§

impl Client

source

pub fn describe_feature_transformation( &self ) -> DescribeFeatureTransformationFluentBuilder

Constructs a fluent builder for the DescribeFeatureTransformation operation.

source§

impl Client

source

pub fn describe_filter(&self) -> DescribeFilterFluentBuilder

Constructs a fluent builder for the DescribeFilter operation.

source§

impl Client

source

pub fn describe_metric_attribution( &self ) -> DescribeMetricAttributionFluentBuilder

Constructs a fluent builder for the DescribeMetricAttribution operation.

source§

impl Client

source

pub fn describe_recipe(&self) -> DescribeRecipeFluentBuilder

Constructs a fluent builder for the DescribeRecipe operation.

source§

impl Client

source

pub fn describe_recommender(&self) -> DescribeRecommenderFluentBuilder

Constructs a fluent builder for the DescribeRecommender operation.

source§

impl Client

source

pub fn describe_schema(&self) -> DescribeSchemaFluentBuilder

Constructs a fluent builder for the DescribeSchema operation.

source§

impl Client

source

pub fn describe_solution(&self) -> DescribeSolutionFluentBuilder

Constructs a fluent builder for the DescribeSolution operation.

source§

impl Client

source

pub fn describe_solution_version(&self) -> DescribeSolutionVersionFluentBuilder

Constructs a fluent builder for the DescribeSolutionVersion operation.

source§

impl Client

source

pub fn get_solution_metrics(&self) -> GetSolutionMetricsFluentBuilder

Constructs a fluent builder for the GetSolutionMetrics operation.

source§

impl Client

source

pub fn list_batch_inference_jobs(&self) -> ListBatchInferenceJobsFluentBuilder

Constructs a fluent builder for the ListBatchInferenceJobs operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn list_batch_segment_jobs(&self) -> ListBatchSegmentJobsFluentBuilder

Constructs a fluent builder for the ListBatchSegmentJobs operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn list_campaigns(&self) -> ListCampaignsFluentBuilder

Constructs a fluent builder for the ListCampaigns operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn list_dataset_export_jobs(&self) -> ListDatasetExportJobsFluentBuilder

Constructs a fluent builder for the ListDatasetExportJobs operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn list_dataset_groups(&self) -> ListDatasetGroupsFluentBuilder

Constructs a fluent builder for the ListDatasetGroups operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn list_dataset_import_jobs(&self) -> ListDatasetImportJobsFluentBuilder

Constructs a fluent builder for the ListDatasetImportJobs operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn list_datasets(&self) -> ListDatasetsFluentBuilder

Constructs a fluent builder for the ListDatasets operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn list_event_trackers(&self) -> ListEventTrackersFluentBuilder

Constructs a fluent builder for the ListEventTrackers operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn list_filters(&self) -> ListFiltersFluentBuilder

Constructs a fluent builder for the ListFilters operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn list_metric_attribution_metrics( &self ) -> ListMetricAttributionMetricsFluentBuilder

Constructs a fluent builder for the ListMetricAttributionMetrics operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn list_metric_attributions(&self) -> ListMetricAttributionsFluentBuilder

Constructs a fluent builder for the ListMetricAttributions operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn list_recipes(&self) -> ListRecipesFluentBuilder

Constructs a fluent builder for the ListRecipes operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn list_recommenders(&self) -> ListRecommendersFluentBuilder

Constructs a fluent builder for the ListRecommenders operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn list_schemas(&self) -> ListSchemasFluentBuilder

Constructs a fluent builder for the ListSchemas operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn list_solution_versions(&self) -> ListSolutionVersionsFluentBuilder

Constructs a fluent builder for the ListSolutionVersions operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn list_solutions(&self) -> ListSolutionsFluentBuilder

Constructs a fluent builder for the ListSolutions operation. This operation supports pagination; See into_paginator().

source§

impl Client

source

pub fn list_tags_for_resource(&self) -> ListTagsForResourceFluentBuilder

Constructs a fluent builder for the ListTagsForResource operation.

source§

impl Client

source

pub fn start_recommender(&self) -> StartRecommenderFluentBuilder

Constructs a fluent builder for the StartRecommender operation.

source§

impl Client

source

pub fn stop_recommender(&self) -> StopRecommenderFluentBuilder

Constructs a fluent builder for the StopRecommender operation.

source§

impl Client

source

pub fn stop_solution_version_creation( &self ) -> StopSolutionVersionCreationFluentBuilder

Constructs a fluent builder for the StopSolutionVersionCreation operation.

source§

impl Client

source

pub fn tag_resource(&self) -> TagResourceFluentBuilder

Constructs a fluent builder for the TagResource operation.

source§

impl Client

source

pub fn untag_resource(&self) -> UntagResourceFluentBuilder

Constructs a fluent builder for the UntagResource operation.

source§

impl Client

source

pub fn update_campaign(&self) -> UpdateCampaignFluentBuilder

Constructs a fluent builder for the UpdateCampaign operation.

source§

impl Client

source

pub fn update_dataset(&self) -> UpdateDatasetFluentBuilder

Constructs a fluent builder for the UpdateDataset operation.

source§

impl Client

source

pub fn update_metric_attribution(&self) -> UpdateMetricAttributionFluentBuilder

Constructs a fluent builder for the UpdateMetricAttribution operation.

source§

impl Client

source

pub fn update_recommender(&self) -> UpdateRecommenderFluentBuilder

Constructs a fluent builder for the UpdateRecommender operation.

source§

impl Client

source

pub fn from_conf(conf: Config) -> Self

Creates a new client from the service Config.

§Panics

This method will panic in the following cases:

  • Retries or timeouts are enabled without a sleep_impl configured.
  • Identity caching is enabled without a sleep_impl and time_source configured.
  • No behavior_version is provided.

The panic message for each of these will have instructions on how to resolve them.

source

pub fn config(&self) -> &Config

Returns the client’s configuration.

source§

impl Client

source

pub fn new(sdk_config: &SdkConfig) -> Self

Creates a new client from an SDK Config.

§Panics
  • This method will panic if the sdk_config is missing an async sleep implementation. If you experience this panic, set the sleep_impl on the Config passed into this function to fix it.
  • This method will panic if the sdk_config is missing an HTTP connector. If you experience this panic, set the http_connector on the Config passed into this function to fix it.
  • This method will panic if no BehaviorVersion is provided. If you experience this panic, set behavior_version on the Config or enable the behavior-version-latest Cargo feature.

Trait Implementations§

source§

impl Clone for Client

source§

fn clone(&self) -> Client

Returns a copy of the value. Read more
1.0.0 · source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
source§

impl Debug for Client

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl Freeze for Client

§

impl !RefUnwindSafe for Client

§

impl Send for Client

§

impl Sync for Client

§

impl Unpin for Client

§

impl !UnwindSafe for Client

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> IntoEither for T

source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

impl<Unshared, Shared> IntoShared<Shared> for Unshared
where Shared: FromUnshared<Unshared>,

source§

fn into_shared(self) -> Shared

Creates a shared type from an unshared type.
source§

impl<T> Same for T

§

type Output = T

Should always be Self
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more