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

Client for Amazon WorkSpaces Web

Client for invoking operations on Amazon WorkSpaces Web. Each operation on Amazon WorkSpaces Web 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_workspacesweb::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_workspacesweb::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 AssociateBrowserSettings operation has a Client::associate_browser_settings, 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_browser_settings()
    .portal_arn("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_browser_settings( &self ) -> AssociateBrowserSettingsFluentBuilder

Constructs a fluent builder for the AssociateBrowserSettings operation.

source§

impl Client

source

pub fn associate_network_settings( &self ) -> AssociateNetworkSettingsFluentBuilder

Constructs a fluent builder for the AssociateNetworkSettings operation.

source§

impl Client

source

pub fn associate_trust_store(&self) -> AssociateTrustStoreFluentBuilder

Constructs a fluent builder for the AssociateTrustStore operation.

source§

impl Client

source

pub fn associate_user_access_logging_settings( &self ) -> AssociateUserAccessLoggingSettingsFluentBuilder

Constructs a fluent builder for the AssociateUserAccessLoggingSettings operation.

source§

impl Client

source

pub fn associate_user_settings(&self) -> AssociateUserSettingsFluentBuilder

Constructs a fluent builder for the AssociateUserSettings operation.

source§

impl Client

source

pub fn create_browser_settings(&self) -> CreateBrowserSettingsFluentBuilder

Constructs a fluent builder for the CreateBrowserSettings operation.

source§

impl Client

source

pub fn create_identity_provider(&self) -> CreateIdentityProviderFluentBuilder

Constructs a fluent builder for the CreateIdentityProvider operation.

source§

impl Client

source

pub fn create_network_settings(&self) -> CreateNetworkSettingsFluentBuilder

Constructs a fluent builder for the CreateNetworkSettings operation.

source§

impl Client

source

pub fn create_portal(&self) -> CreatePortalFluentBuilder

Constructs a fluent builder for the CreatePortal operation.

source§

impl Client

source

pub fn create_trust_store(&self) -> CreateTrustStoreFluentBuilder

Constructs a fluent builder for the CreateTrustStore operation.

source§

impl Client

source

pub fn create_user_access_logging_settings( &self ) -> CreateUserAccessLoggingSettingsFluentBuilder

Constructs a fluent builder for the CreateUserAccessLoggingSettings operation.

source§

impl Client

source

pub fn create_user_settings(&self) -> CreateUserSettingsFluentBuilder

Constructs a fluent builder for the CreateUserSettings operation.

source§

impl Client

source

pub fn delete_browser_settings(&self) -> DeleteBrowserSettingsFluentBuilder

Constructs a fluent builder for the DeleteBrowserSettings operation.

source§

impl Client

source

pub fn delete_identity_provider(&self) -> DeleteIdentityProviderFluentBuilder

Constructs a fluent builder for the DeleteIdentityProvider operation.

source§

impl Client

source

pub fn delete_network_settings(&self) -> DeleteNetworkSettingsFluentBuilder

Constructs a fluent builder for the DeleteNetworkSettings operation.

source§

impl Client

source

pub fn delete_portal(&self) -> DeletePortalFluentBuilder

Constructs a fluent builder for the DeletePortal operation.

source§

impl Client

source

pub fn delete_trust_store(&self) -> DeleteTrustStoreFluentBuilder

Constructs a fluent builder for the DeleteTrustStore operation.

source§

impl Client

source§

impl Client

source

pub fn delete_user_settings(&self) -> DeleteUserSettingsFluentBuilder

Constructs a fluent builder for the DeleteUserSettings operation.

source§

impl Client

source

pub fn disassociate_browser_settings( &self ) -> DisassociateBrowserSettingsFluentBuilder

Constructs a fluent builder for the DisassociateBrowserSettings operation.

source§

impl Client

source

pub fn disassociate_network_settings( &self ) -> DisassociateNetworkSettingsFluentBuilder

Constructs a fluent builder for the DisassociateNetworkSettings operation.

source§

impl Client

source

pub fn disassociate_trust_store(&self) -> DisassociateTrustStoreFluentBuilder

Constructs a fluent builder for the DisassociateTrustStore operation.

source§

impl Client

source§

impl Client

source

pub fn disassociate_user_settings( &self ) -> DisassociateUserSettingsFluentBuilder

Constructs a fluent builder for the DisassociateUserSettings operation.

source§

impl Client

source

pub fn get_browser_settings(&self) -> GetBrowserSettingsFluentBuilder

Constructs a fluent builder for the GetBrowserSettings operation.

source§

impl Client

source

pub fn get_identity_provider(&self) -> GetIdentityProviderFluentBuilder

Constructs a fluent builder for the GetIdentityProvider operation.

source§

impl Client

source

pub fn get_network_settings(&self) -> GetNetworkSettingsFluentBuilder

Constructs a fluent builder for the GetNetworkSettings operation.

source§

impl Client

source

pub fn get_portal(&self) -> GetPortalFluentBuilder

Constructs a fluent builder for the GetPortal operation.

source§

impl Client

source

pub fn get_portal_service_provider_metadata( &self ) -> GetPortalServiceProviderMetadataFluentBuilder

Constructs a fluent builder for the GetPortalServiceProviderMetadata operation.

source§

impl Client

source

pub fn get_trust_store(&self) -> GetTrustStoreFluentBuilder

Constructs a fluent builder for the GetTrustStore operation.

source§

impl Client

source

pub fn get_trust_store_certificate( &self ) -> GetTrustStoreCertificateFluentBuilder

Constructs a fluent builder for the GetTrustStoreCertificate operation.

source§

impl Client

source

pub fn get_user_access_logging_settings( &self ) -> GetUserAccessLoggingSettingsFluentBuilder

Constructs a fluent builder for the GetUserAccessLoggingSettings operation.

source§

impl Client

source

pub fn get_user_settings(&self) -> GetUserSettingsFluentBuilder

Constructs a fluent builder for the GetUserSettings operation.

source§

impl Client

source

pub fn list_browser_settings(&self) -> ListBrowserSettingsFluentBuilder

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

source§

impl Client

source

pub fn list_identity_providers(&self) -> ListIdentityProvidersFluentBuilder

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

source§

impl Client

source

pub fn list_network_settings(&self) -> ListNetworkSettingsFluentBuilder

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

source§

impl Client

source

pub fn list_portals(&self) -> ListPortalsFluentBuilder

Constructs a fluent builder for the ListPortals 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 list_trust_store_certificates( &self ) -> ListTrustStoreCertificatesFluentBuilder

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

source§

impl Client

source

pub fn list_trust_stores(&self) -> ListTrustStoresFluentBuilder

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

source§

impl Client

source

pub fn list_user_access_logging_settings( &self ) -> ListUserAccessLoggingSettingsFluentBuilder

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

source§

impl Client

source

pub fn list_user_settings(&self) -> ListUserSettingsFluentBuilder

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

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_browser_settings(&self) -> UpdateBrowserSettingsFluentBuilder

Constructs a fluent builder for the UpdateBrowserSettings operation.

source§

impl Client

source

pub fn update_identity_provider(&self) -> UpdateIdentityProviderFluentBuilder

Constructs a fluent builder for the UpdateIdentityProvider operation.

source§

impl Client

source

pub fn update_network_settings(&self) -> UpdateNetworkSettingsFluentBuilder

Constructs a fluent builder for the UpdateNetworkSettings operation.

source§

impl Client

source

pub fn update_portal(&self) -> UpdatePortalFluentBuilder

Constructs a fluent builder for the UpdatePortal operation.

source§

impl Client

source

pub fn update_trust_store(&self) -> UpdateTrustStoreFluentBuilder

Constructs a fluent builder for the UpdateTrustStore operation.

source§

impl Client

source

pub fn update_user_access_logging_settings( &self ) -> UpdateUserAccessLoggingSettingsFluentBuilder

Constructs a fluent builder for the UpdateUserAccessLoggingSettings operation.

source§

impl Client

source

pub fn update_user_settings(&self) -> UpdateUserSettingsFluentBuilder

Constructs a fluent builder for the UpdateUserSettings operation.

source§

impl Client

source

pub fn with_config( client: Client<DynConnector, DynMiddleware<DynConnector>>, conf: Config ) -> Self

Creates a client with the given service configuration.

source

pub fn conf(&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.
source

pub fn from_conf(conf: Config) -> Self

Creates a new client from the service Config.

Panics
  • This method will panic if the conf 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 conf is missing an HTTP connector. If you experience this panic, set the http_connector on the Config passed into this function to fix it.

Trait Implementations§

source§

impl Clone for Client

source§

fn clone(&self) -> Self

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
source§

impl From<Client<DynConnector, DynMiddleware<DynConnector>, Standard>> for Client

source§

fn from(client: Client<DynConnector, DynMiddleware<DynConnector>>) -> Self

Converts to this type from the input type.

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 Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

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

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere 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 Twhere 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> Same<T> for T

§

type Output = T

Should always be Self
source§

impl<T> ToOwned for Twhere 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 Twhere 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 Twhere 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