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

Client for AWS AppSync

Client for invoking operations on AWS AppSync. Each operation on AWS AppSync 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_appsync::Client::new(&config);

Occasionally, SDKs may have additional service-specific 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_appsync::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 AssociateApi operation has a Client::associate_api, 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.associate_api()
    .domain_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 associate_api(&self) -> AssociateApiFluentBuilder

Constructs a fluent builder for the AssociateApi operation.

source§

impl Client

source

pub fn associate_merged_graphql_api( &self ) -> AssociateMergedGraphqlApiFluentBuilder

Constructs a fluent builder for the AssociateMergedGraphqlApi operation.

source§

impl Client

source

pub fn associate_source_graphql_api( &self ) -> AssociateSourceGraphqlApiFluentBuilder

Constructs a fluent builder for the AssociateSourceGraphqlApi operation.

source§

impl Client

source

pub fn create_api_cache(&self) -> CreateApiCacheFluentBuilder

Constructs a fluent builder for the CreateApiCache operation.

source§

impl Client

source

pub fn create_api_key(&self) -> CreateApiKeyFluentBuilder

Constructs a fluent builder for the CreateApiKey operation.

source§

impl Client

source

pub fn create_data_source(&self) -> CreateDataSourceFluentBuilder

Constructs a fluent builder for the CreateDataSource operation.

source§

impl Client

source

pub fn create_domain_name(&self) -> CreateDomainNameFluentBuilder

Constructs a fluent builder for the CreateDomainName operation.

source§

impl Client

source

pub fn create_function(&self) -> CreateFunctionFluentBuilder

Constructs a fluent builder for the CreateFunction operation.

source§

impl Client

source

pub fn create_graphql_api(&self) -> CreateGraphqlApiFluentBuilder

Constructs a fluent builder for the CreateGraphqlApi operation.

source§

impl Client

source

pub fn create_resolver(&self) -> CreateResolverFluentBuilder

Constructs a fluent builder for the CreateResolver operation.

source§

impl Client

source

pub fn create_type(&self) -> CreateTypeFluentBuilder

Constructs a fluent builder for the CreateType operation.

source§

impl Client

source

pub fn delete_api_cache(&self) -> DeleteApiCacheFluentBuilder

Constructs a fluent builder for the DeleteApiCache operation.

source§

impl Client

source

pub fn delete_api_key(&self) -> DeleteApiKeyFluentBuilder

Constructs a fluent builder for the DeleteApiKey operation.

source§

impl Client

source

pub fn delete_data_source(&self) -> DeleteDataSourceFluentBuilder

Constructs a fluent builder for the DeleteDataSource operation.

source§

impl Client

source

pub fn delete_domain_name(&self) -> DeleteDomainNameFluentBuilder

Constructs a fluent builder for the DeleteDomainName operation.

source§

impl Client

source

pub fn delete_function(&self) -> DeleteFunctionFluentBuilder

Constructs a fluent builder for the DeleteFunction operation.

source§

impl Client

source

pub fn delete_graphql_api(&self) -> DeleteGraphqlApiFluentBuilder

Constructs a fluent builder for the DeleteGraphqlApi operation.

source§

impl Client

source

pub fn delete_resolver(&self) -> DeleteResolverFluentBuilder

Constructs a fluent builder for the DeleteResolver operation.

source§

impl Client

source

pub fn delete_type(&self) -> DeleteTypeFluentBuilder

Constructs a fluent builder for the DeleteType operation.

source§

impl Client

source

pub fn disassociate_api(&self) -> DisassociateApiFluentBuilder

Constructs a fluent builder for the DisassociateApi operation.

source§

impl Client

source

pub fn disassociate_merged_graphql_api( &self ) -> DisassociateMergedGraphqlApiFluentBuilder

Constructs a fluent builder for the DisassociateMergedGraphqlApi operation.

source§

impl Client

source

pub fn disassociate_source_graphql_api( &self ) -> DisassociateSourceGraphqlApiFluentBuilder

Constructs a fluent builder for the DisassociateSourceGraphqlApi operation.

source§

impl Client

source

pub fn evaluate_code(&self) -> EvaluateCodeFluentBuilder

Constructs a fluent builder for the EvaluateCode operation.

source§

impl Client

source

pub fn evaluate_mapping_template(&self) -> EvaluateMappingTemplateFluentBuilder

Constructs a fluent builder for the EvaluateMappingTemplate operation.

source§

impl Client

source

pub fn flush_api_cache(&self) -> FlushApiCacheFluentBuilder

Constructs a fluent builder for the FlushApiCache operation.

source§

impl Client

source

pub fn get_api_association(&self) -> GetApiAssociationFluentBuilder

Constructs a fluent builder for the GetApiAssociation operation.

source§

impl Client

source

pub fn get_api_cache(&self) -> GetApiCacheFluentBuilder

Constructs a fluent builder for the GetApiCache operation.

source§

impl Client

source

pub fn get_data_source(&self) -> GetDataSourceFluentBuilder

Constructs a fluent builder for the GetDataSource operation.

source§

impl Client

source

pub fn get_domain_name(&self) -> GetDomainNameFluentBuilder

Constructs a fluent builder for the GetDomainName operation.

source§

impl Client

source

pub fn get_function(&self) -> GetFunctionFluentBuilder

Constructs a fluent builder for the GetFunction operation.

source§

impl Client

source

pub fn get_graphql_api(&self) -> GetGraphqlApiFluentBuilder

Constructs a fluent builder for the GetGraphqlApi operation.

source§

impl Client

source

pub fn get_introspection_schema(&self) -> GetIntrospectionSchemaFluentBuilder

Constructs a fluent builder for the GetIntrospectionSchema operation.

source§

impl Client

source

pub fn get_resolver(&self) -> GetResolverFluentBuilder

Constructs a fluent builder for the GetResolver operation.

source§

impl Client

source

pub fn get_schema_creation_status(&self) -> GetSchemaCreationStatusFluentBuilder

Constructs a fluent builder for the GetSchemaCreationStatus operation.

source§

impl Client

source

pub fn get_source_api_association(&self) -> GetSourceApiAssociationFluentBuilder

Constructs a fluent builder for the GetSourceApiAssociation operation.

source§

impl Client

source

pub fn get_type(&self) -> GetTypeFluentBuilder

Constructs a fluent builder for the GetType operation.

source§

impl Client

source

pub fn list_api_keys(&self) -> ListApiKeysFluentBuilder

Constructs a fluent builder for the ListApiKeys operation.

source§

impl Client

source

pub fn list_data_sources(&self) -> ListDataSourcesFluentBuilder

Constructs a fluent builder for the ListDataSources operation.

source§

impl Client

source

pub fn list_domain_names(&self) -> ListDomainNamesFluentBuilder

Constructs a fluent builder for the ListDomainNames operation.

source§

impl Client

source

pub fn list_functions(&self) -> ListFunctionsFluentBuilder

Constructs a fluent builder for the ListFunctions operation.

source§

impl Client

source

pub fn list_graphql_apis(&self) -> ListGraphqlApisFluentBuilder

Constructs a fluent builder for the ListGraphqlApis operation.

source§

impl Client

source

pub fn list_resolvers(&self) -> ListResolversFluentBuilder

Constructs a fluent builder for the ListResolvers operation.

source§

impl Client

source

pub fn list_resolvers_by_function(&self) -> ListResolversByFunctionFluentBuilder

Constructs a fluent builder for the ListResolversByFunction operation.

source§

impl Client

source

pub fn list_source_api_associations( &self ) -> ListSourceApiAssociationsFluentBuilder

Constructs a fluent builder for the ListSourceApiAssociations operation.

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 list_types(&self) -> ListTypesFluentBuilder

Constructs a fluent builder for the ListTypes operation.

source§

impl Client

source

pub fn list_types_by_association(&self) -> ListTypesByAssociationFluentBuilder

Constructs a fluent builder for the ListTypesByAssociation operation.

source§

impl Client

source

pub fn start_schema_creation(&self) -> StartSchemaCreationFluentBuilder

Constructs a fluent builder for the StartSchemaCreation operation.

source§

impl Client

source

pub fn start_schema_merge(&self) -> StartSchemaMergeFluentBuilder

Constructs a fluent builder for the StartSchemaMerge 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_api_cache(&self) -> UpdateApiCacheFluentBuilder

Constructs a fluent builder for the UpdateApiCache operation.

source§

impl Client

source

pub fn update_api_key(&self) -> UpdateApiKeyFluentBuilder

Constructs a fluent builder for the UpdateApiKey operation.

source§

impl Client

source

pub fn update_data_source(&self) -> UpdateDataSourceFluentBuilder

Constructs a fluent builder for the UpdateDataSource operation.

source§

impl Client

source

pub fn update_domain_name(&self) -> UpdateDomainNameFluentBuilder

Constructs a fluent builder for the UpdateDomainName operation.

source§

impl Client

source

pub fn update_function(&self) -> UpdateFunctionFluentBuilder

Constructs a fluent builder for the UpdateFunction operation.

source§

impl Client

source

pub fn update_graphql_api(&self) -> UpdateGraphqlApiFluentBuilder

Constructs a fluent builder for the UpdateGraphqlApi operation.

source§

impl Client

source

pub fn update_resolver(&self) -> UpdateResolverFluentBuilder

Constructs a fluent builder for the UpdateResolver operation.

source§

impl Client

source

pub fn update_source_api_association( &self ) -> UpdateSourceApiAssociationFluentBuilder

Constructs a fluent builder for the UpdateSourceApiAssociation operation.

source§

impl Client

source

pub fn update_type(&self) -> UpdateTypeFluentBuilder

Constructs a fluent builder for the UpdateType 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 !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<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