pub struct Client { /* private fields */ }
Expand description
Client for Amazon Chime SDK Identity
Client for invoking operations on Amazon Chime SDK Identity. Each operation on Amazon Chime SDK Identity 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_chimesdkidentity::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 Builder
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_chimesdkidentity::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 CreateAppInstance
operation has
a Client::create_app_instance
, 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_app_instance()
.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
impl Client
Sourcepub fn create_app_instance(&self) -> CreateAppInstanceFluentBuilder
pub fn create_app_instance(&self) -> CreateAppInstanceFluentBuilder
Constructs a fluent builder for the CreateAppInstance
operation.
- The fluent builder is configurable:
name(impl Into<String>)
/set_name(Option<String>)
:
required: trueThe name of the
AppInstance
.metadata(impl Into<String>)
/set_metadata(Option<String>)
:
required: falseThe metadata of the
AppInstance
. Limited to a 1KB string in UTF-8.client_request_token(impl Into<String>)
/set_client_request_token(Option<String>)
:
required: trueThe unique ID of the request. Use different tokens to create different
AppInstances
.tags(Tag)
/set_tags(Option<Vec::<Tag>>)
:
required: falseTags assigned to the
AppInstance
.
- On success, responds with
CreateAppInstanceOutput
with field(s):app_instance_arn(Option<String>)
:The Amazon Resource Number (ARN) of the
AppInstance
.
- On failure, responds with
SdkError<CreateAppInstanceError>
Source§impl Client
impl Client
Sourcepub fn create_app_instance_admin(&self) -> CreateAppInstanceAdminFluentBuilder
pub fn create_app_instance_admin(&self) -> CreateAppInstanceAdminFluentBuilder
Constructs a fluent builder for the CreateAppInstanceAdmin
operation.
- The fluent builder is configurable:
app_instance_admin_arn(impl Into<String>)
/set_app_instance_admin_arn(Option<String>)
:
required: trueThe ARN of the administrator of the current
AppInstance
.app_instance_arn(impl Into<String>)
/set_app_instance_arn(Option<String>)
:
required: trueThe ARN of the
AppInstance
.
- On success, responds with
CreateAppInstanceAdminOutput
with field(s):app_instance_admin(Option<Identity>)
:The ARN and name of the administrator, the ARN of the
AppInstance
, and the created and last-updated timestamps. All timestamps use epoch milliseconds.app_instance_arn(Option<String>)
:The ARN of the of the admin for the
AppInstance
.
- On failure, responds with
SdkError<CreateAppInstanceAdminError>
Source§impl Client
impl Client
Sourcepub fn create_app_instance_bot(&self) -> CreateAppInstanceBotFluentBuilder
pub fn create_app_instance_bot(&self) -> CreateAppInstanceBotFluentBuilder
Constructs a fluent builder for the CreateAppInstanceBot
operation.
- The fluent builder is configurable:
app_instance_arn(impl Into<String>)
/set_app_instance_arn(Option<String>)
:
required: trueThe ARN of the
AppInstance
request.name(impl Into<String>)
/set_name(Option<String>)
:
required: falseThe user’s name.
metadata(impl Into<String>)
/set_metadata(Option<String>)
:
required: falseThe request metadata. Limited to a 1KB string in UTF-8.
client_request_token(impl Into<String>)
/set_client_request_token(Option<String>)
:
required: trueThe unique ID for the client making the request. Use different tokens for different
AppInstanceBots
.tags(Tag)
/set_tags(Option<Vec::<Tag>>)
:
required: falseThe tags assigned to the
AppInstanceBot
.configuration(Configuration)
/set_configuration(Option<Configuration>)
:
required: trueConfiguration information about the Amazon Lex V2 V2 bot.
- On success, responds with
CreateAppInstanceBotOutput
with field(s):app_instance_bot_arn(Option<String>)
:The ARN of the
AppinstanceBot
.
- On failure, responds with
SdkError<CreateAppInstanceBotError>
Source§impl Client
impl Client
Sourcepub fn create_app_instance_user(&self) -> CreateAppInstanceUserFluentBuilder
pub fn create_app_instance_user(&self) -> CreateAppInstanceUserFluentBuilder
Constructs a fluent builder for the CreateAppInstanceUser
operation.
- The fluent builder is configurable:
app_instance_arn(impl Into<String>)
/set_app_instance_arn(Option<String>)
:
required: trueThe ARN of the
AppInstance
request.app_instance_user_id(impl Into<String>)
/set_app_instance_user_id(Option<String>)
:
required: trueThe user ID of the
AppInstance
.name(impl Into<String>)
/set_name(Option<String>)
:
required: trueThe user’s name.
metadata(impl Into<String>)
/set_metadata(Option<String>)
:
required: falseThe request’s metadata. Limited to a 1KB string in UTF-8.
client_request_token(impl Into<String>)
/set_client_request_token(Option<String>)
:
required: trueThe unique ID of the request. Use different tokens to request additional
AppInstances
.tags(Tag)
/set_tags(Option<Vec::<Tag>>)
:
required: falseTags assigned to the
AppInstanceUser
.expiration_settings(ExpirationSettings)
/set_expiration_settings(Option<ExpirationSettings>)
:
required: falseSettings that control the interval after which the
AppInstanceUser
is automatically deleted.
- On success, responds with
CreateAppInstanceUserOutput
with field(s):app_instance_user_arn(Option<String>)
:The user’s ARN.
- On failure, responds with
SdkError<CreateAppInstanceUserError>
Source§impl Client
impl Client
Sourcepub fn delete_app_instance(&self) -> DeleteAppInstanceFluentBuilder
pub fn delete_app_instance(&self) -> DeleteAppInstanceFluentBuilder
Constructs a fluent builder for the DeleteAppInstance
operation.
- The fluent builder is configurable:
app_instance_arn(impl Into<String>)
/set_app_instance_arn(Option<String>)
:
required: trueThe ARN of the
AppInstance
.
- On success, responds with
DeleteAppInstanceOutput
- On failure, responds with
SdkError<DeleteAppInstanceError>
Source§impl Client
impl Client
Sourcepub fn delete_app_instance_admin(&self) -> DeleteAppInstanceAdminFluentBuilder
pub fn delete_app_instance_admin(&self) -> DeleteAppInstanceAdminFluentBuilder
Constructs a fluent builder for the DeleteAppInstanceAdmin
operation.
- The fluent builder is configurable:
app_instance_admin_arn(impl Into<String>)
/set_app_instance_admin_arn(Option<String>)
:
required: trueThe ARN of the
AppInstance
’s administrator.app_instance_arn(impl Into<String>)
/set_app_instance_arn(Option<String>)
:
required: trueThe ARN of the
AppInstance
.
- On success, responds with
DeleteAppInstanceAdminOutput
- On failure, responds with
SdkError<DeleteAppInstanceAdminError>
Source§impl Client
impl Client
Sourcepub fn delete_app_instance_bot(&self) -> DeleteAppInstanceBotFluentBuilder
pub fn delete_app_instance_bot(&self) -> DeleteAppInstanceBotFluentBuilder
Constructs a fluent builder for the DeleteAppInstanceBot
operation.
- The fluent builder is configurable:
app_instance_bot_arn(impl Into<String>)
/set_app_instance_bot_arn(Option<String>)
:
required: trueThe ARN of the
AppInstanceBot
being deleted.
- On success, responds with
DeleteAppInstanceBotOutput
- On failure, responds with
SdkError<DeleteAppInstanceBotError>
Source§impl Client
impl Client
Sourcepub fn delete_app_instance_user(&self) -> DeleteAppInstanceUserFluentBuilder
pub fn delete_app_instance_user(&self) -> DeleteAppInstanceUserFluentBuilder
Constructs a fluent builder for the DeleteAppInstanceUser
operation.
- The fluent builder is configurable:
app_instance_user_arn(impl Into<String>)
/set_app_instance_user_arn(Option<String>)
:
required: trueThe ARN of the user request being deleted.
- On success, responds with
DeleteAppInstanceUserOutput
- On failure, responds with
SdkError<DeleteAppInstanceUserError>
Source§impl Client
impl Client
Sourcepub fn deregister_app_instance_user_endpoint(
&self,
) -> DeregisterAppInstanceUserEndpointFluentBuilder
pub fn deregister_app_instance_user_endpoint( &self, ) -> DeregisterAppInstanceUserEndpointFluentBuilder
Constructs a fluent builder for the DeregisterAppInstanceUserEndpoint
operation.
- The fluent builder is configurable:
app_instance_user_arn(impl Into<String>)
/set_app_instance_user_arn(Option<String>)
:
required: trueThe ARN of the
AppInstanceUser
.endpoint_id(impl Into<String>)
/set_endpoint_id(Option<String>)
:
required: trueThe unique identifier of the
AppInstanceUserEndpoint
.
- On success, responds with
DeregisterAppInstanceUserEndpointOutput
- On failure, responds with
SdkError<DeregisterAppInstanceUserEndpointError>
Source§impl Client
impl Client
Sourcepub fn describe_app_instance(&self) -> DescribeAppInstanceFluentBuilder
pub fn describe_app_instance(&self) -> DescribeAppInstanceFluentBuilder
Constructs a fluent builder for the DescribeAppInstance
operation.
- The fluent builder is configurable:
app_instance_arn(impl Into<String>)
/set_app_instance_arn(Option<String>)
:
required: trueThe ARN of the
AppInstance
.
- On success, responds with
DescribeAppInstanceOutput
with field(s):app_instance(Option<AppInstance>)
:The ARN, metadata, created and last-updated timestamps, and the name of the
AppInstance
. All timestamps use epoch milliseconds.
- On failure, responds with
SdkError<DescribeAppInstanceError>
Source§impl Client
impl Client
Sourcepub fn describe_app_instance_admin(
&self,
) -> DescribeAppInstanceAdminFluentBuilder
pub fn describe_app_instance_admin( &self, ) -> DescribeAppInstanceAdminFluentBuilder
Constructs a fluent builder for the DescribeAppInstanceAdmin
operation.
- The fluent builder is configurable:
app_instance_admin_arn(impl Into<String>)
/set_app_instance_admin_arn(Option<String>)
:
required: trueThe ARN of the
AppInstanceAdmin
.app_instance_arn(impl Into<String>)
/set_app_instance_arn(Option<String>)
:
required: trueThe ARN of the
AppInstance
.
- On success, responds with
DescribeAppInstanceAdminOutput
with field(s):app_instance_admin(Option<AppInstanceAdmin>)
:The ARN and name of the
AppInstanceUser
, the ARN of theAppInstance
, and the created and last-updated timestamps. All timestamps use epoch milliseconds.
- On failure, responds with
SdkError<DescribeAppInstanceAdminError>
Source§impl Client
impl Client
Sourcepub fn describe_app_instance_bot(&self) -> DescribeAppInstanceBotFluentBuilder
pub fn describe_app_instance_bot(&self) -> DescribeAppInstanceBotFluentBuilder
Constructs a fluent builder for the DescribeAppInstanceBot
operation.
- The fluent builder is configurable:
app_instance_bot_arn(impl Into<String>)
/set_app_instance_bot_arn(Option<String>)
:
required: trueThe ARN of the
AppInstanceBot
.
- On success, responds with
DescribeAppInstanceBotOutput
with field(s):app_instance_bot(Option<AppInstanceBot>)
:The detials of the
AppInstanceBot
.
- On failure, responds with
SdkError<DescribeAppInstanceBotError>
Source§impl Client
impl Client
Sourcepub fn describe_app_instance_user(&self) -> DescribeAppInstanceUserFluentBuilder
pub fn describe_app_instance_user(&self) -> DescribeAppInstanceUserFluentBuilder
Constructs a fluent builder for the DescribeAppInstanceUser
operation.
- The fluent builder is configurable:
app_instance_user_arn(impl Into<String>)
/set_app_instance_user_arn(Option<String>)
:
required: trueThe ARN of the
AppInstanceUser
.
- On success, responds with
DescribeAppInstanceUserOutput
with field(s):app_instance_user(Option<AppInstanceUser>)
:The name of the
AppInstanceUser
.
- On failure, responds with
SdkError<DescribeAppInstanceUserError>
Source§impl Client
impl Client
Sourcepub fn describe_app_instance_user_endpoint(
&self,
) -> DescribeAppInstanceUserEndpointFluentBuilder
pub fn describe_app_instance_user_endpoint( &self, ) -> DescribeAppInstanceUserEndpointFluentBuilder
Constructs a fluent builder for the DescribeAppInstanceUserEndpoint
operation.
- The fluent builder is configurable:
app_instance_user_arn(impl Into<String>)
/set_app_instance_user_arn(Option<String>)
:
required: trueThe ARN of the
AppInstanceUser
.endpoint_id(impl Into<String>)
/set_endpoint_id(Option<String>)
:
required: trueThe unique identifier of the
AppInstanceUserEndpoint
.
- On success, responds with
DescribeAppInstanceUserEndpointOutput
with field(s):app_instance_user_endpoint(Option<AppInstanceUserEndpoint>)
:The full details of an
AppInstanceUserEndpoint
: theAppInstanceUserArn
, ID, name, type, resource ARN, attributes, allow messages, state, and created and last updated timestamps. All timestamps use epoch milliseconds.
- On failure, responds with
SdkError<DescribeAppInstanceUserEndpointError>
Source§impl Client
impl Client
Sourcepub fn get_app_instance_retention_settings(
&self,
) -> GetAppInstanceRetentionSettingsFluentBuilder
pub fn get_app_instance_retention_settings( &self, ) -> GetAppInstanceRetentionSettingsFluentBuilder
Constructs a fluent builder for the GetAppInstanceRetentionSettings
operation.
- The fluent builder is configurable:
app_instance_arn(impl Into<String>)
/set_app_instance_arn(Option<String>)
:
required: trueThe ARN of the
AppInstance
.
- On success, responds with
GetAppInstanceRetentionSettingsOutput
with field(s):app_instance_retention_settings(Option<AppInstanceRetentionSettings>)
:The retention settings for the
AppInstance
.initiate_deletion_timestamp(Option<DateTime>)
:The timestamp representing the time at which the specified items are retained, in Epoch Seconds.
- On failure, responds with
SdkError<GetAppInstanceRetentionSettingsError>
Source§impl Client
impl Client
Sourcepub fn list_app_instance_admins(&self) -> ListAppInstanceAdminsFluentBuilder
pub fn list_app_instance_admins(&self) -> ListAppInstanceAdminsFluentBuilder
Constructs a fluent builder for the ListAppInstanceAdmins
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
app_instance_arn(impl Into<String>)
/set_app_instance_arn(Option<String>)
:
required: trueThe ARN of the
AppInstance
.max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of administrators that you want to return.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseThe token returned from previous API requests until the number of administrators is reached.
- On success, responds with
ListAppInstanceAdminsOutput
with field(s):app_instance_arn(Option<String>)
:The ARN of the
AppInstance
.app_instance_admins(Option<Vec::<AppInstanceAdminSummary>>)
:The information for each administrator.
next_token(Option<String>)
:The token returned from previous API requests until the number of administrators is reached.
- On failure, responds with
SdkError<ListAppInstanceAdminsError>
Source§impl Client
impl Client
Sourcepub fn list_app_instance_bots(&self) -> ListAppInstanceBotsFluentBuilder
pub fn list_app_instance_bots(&self) -> ListAppInstanceBotsFluentBuilder
Constructs a fluent builder for the ListAppInstanceBots
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
app_instance_arn(impl Into<String>)
/set_app_instance_arn(Option<String>)
:
required: trueThe ARN of the
AppInstance
.max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of requests to return.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseThe token passed by previous API calls until all requested bots are returned.
- On success, responds with
ListAppInstanceBotsOutput
with field(s):app_instance_arn(Option<String>)
:The ARN of the AppInstance.
app_instance_bots(Option<Vec::<AppInstanceBotSummary>>)
:The information for each requested
AppInstanceBot
.next_token(Option<String>)
:The token passed by previous API calls until all requested bots are returned.
- On failure, responds with
SdkError<ListAppInstanceBotsError>
Source§impl Client
impl Client
Sourcepub fn list_app_instance_user_endpoints(
&self,
) -> ListAppInstanceUserEndpointsFluentBuilder
pub fn list_app_instance_user_endpoints( &self, ) -> ListAppInstanceUserEndpointsFluentBuilder
Constructs a fluent builder for the ListAppInstanceUserEndpoints
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
app_instance_user_arn(impl Into<String>)
/set_app_instance_user_arn(Option<String>)
:
required: trueThe ARN of the
AppInstanceUser
.max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of endpoints that you want to return.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseThe token passed by previous API calls until all requested endpoints are returned.
- On success, responds with
ListAppInstanceUserEndpointsOutput
with field(s):app_instance_user_endpoints(Option<Vec::<AppInstanceUserEndpointSummary>>)
:The information for each requested
AppInstanceUserEndpoint
.next_token(Option<String>)
:The token passed by previous API calls until all requested endpoints are returned.
- On failure, responds with
SdkError<ListAppInstanceUserEndpointsError>
Source§impl Client
impl Client
Sourcepub fn list_app_instance_users(&self) -> ListAppInstanceUsersFluentBuilder
pub fn list_app_instance_users(&self) -> ListAppInstanceUsersFluentBuilder
Constructs a fluent builder for the ListAppInstanceUsers
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
app_instance_arn(impl Into<String>)
/set_app_instance_arn(Option<String>)
:
required: trueThe ARN of the
AppInstance
.max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of requests that you want returned.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseThe token passed by previous API calls until all requested users are returned.
- On success, responds with
ListAppInstanceUsersOutput
with field(s):app_instance_arn(Option<String>)
:The ARN of the
AppInstance
.app_instance_users(Option<Vec::<AppInstanceUserSummary>>)
:The information for each requested
AppInstanceUser
.next_token(Option<String>)
:The token passed by previous API calls until all requested users are returned.
- On failure, responds with
SdkError<ListAppInstanceUsersError>
Source§impl Client
impl Client
Sourcepub fn list_app_instances(&self) -> ListAppInstancesFluentBuilder
pub fn list_app_instances(&self) -> ListAppInstancesFluentBuilder
Constructs a fluent builder for the ListAppInstances
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of
AppInstance
s that you want to return.next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseThe token passed by previous API requests until you reach the maximum number of
AppInstances
.
- On success, responds with
ListAppInstancesOutput
with field(s):app_instances(Option<Vec::<AppInstanceSummary>>)
:The information for each
AppInstance
.next_token(Option<String>)
:The token passed by previous API requests until the maximum number of
AppInstance
s is reached.
- On failure, responds with
SdkError<ListAppInstancesError>
Source§impl Client
impl Client
Constructs a fluent builder for the ListTagsForResource
operation.
- The fluent builder is configurable:
resource_arn(impl Into<String>)
/set_resource_arn(Option<String>)
:
required: trueThe ARN of the resource.
- On success, responds with
ListTagsForResourceOutput
with field(s):tags(Option<Vec::<Tag>>)
:The tag key-value pairs.
- On failure, responds with
SdkError<ListTagsForResourceError>
Source§impl Client
impl Client
Sourcepub fn put_app_instance_retention_settings(
&self,
) -> PutAppInstanceRetentionSettingsFluentBuilder
pub fn put_app_instance_retention_settings( &self, ) -> PutAppInstanceRetentionSettingsFluentBuilder
Constructs a fluent builder for the PutAppInstanceRetentionSettings
operation.
- The fluent builder is configurable:
app_instance_arn(impl Into<String>)
/set_app_instance_arn(Option<String>)
:
required: trueThe ARN of the
AppInstance
.app_instance_retention_settings(AppInstanceRetentionSettings)
/set_app_instance_retention_settings(Option<AppInstanceRetentionSettings>)
:
required: trueThe time in days to retain data. Data type: number.
- On success, responds with
PutAppInstanceRetentionSettingsOutput
with field(s):app_instance_retention_settings(Option<AppInstanceRetentionSettings>)
:The time in days to retain data. Data type: number.
initiate_deletion_timestamp(Option<DateTime>)
:The time at which the API deletes data.
- On failure, responds with
SdkError<PutAppInstanceRetentionSettingsError>
Source§impl Client
impl Client
Sourcepub fn put_app_instance_user_expiration_settings(
&self,
) -> PutAppInstanceUserExpirationSettingsFluentBuilder
pub fn put_app_instance_user_expiration_settings( &self, ) -> PutAppInstanceUserExpirationSettingsFluentBuilder
Constructs a fluent builder for the PutAppInstanceUserExpirationSettings
operation.
- The fluent builder is configurable:
app_instance_user_arn(impl Into<String>)
/set_app_instance_user_arn(Option<String>)
:
required: trueThe ARN of the
AppInstanceUser
.expiration_settings(ExpirationSettings)
/set_expiration_settings(Option<ExpirationSettings>)
:
required: falseSettings that control the interval after which an
AppInstanceUser
is automatically deleted.
- On success, responds with
PutAppInstanceUserExpirationSettingsOutput
with field(s):app_instance_user_arn(Option<String>)
:The ARN of the
AppInstanceUser
.expiration_settings(Option<ExpirationSettings>)
:Settings that control the interval after which an
AppInstanceUser
is automatically deleted.
- On failure, responds with
SdkError<PutAppInstanceUserExpirationSettingsError>
Source§impl Client
impl Client
Sourcepub fn register_app_instance_user_endpoint(
&self,
) -> RegisterAppInstanceUserEndpointFluentBuilder
pub fn register_app_instance_user_endpoint( &self, ) -> RegisterAppInstanceUserEndpointFluentBuilder
Constructs a fluent builder for the RegisterAppInstanceUserEndpoint
operation.
- The fluent builder is configurable:
app_instance_user_arn(impl Into<String>)
/set_app_instance_user_arn(Option<String>)
:
required: trueThe ARN of the
AppInstanceUser
.name(impl Into<String>)
/set_name(Option<String>)
:
required: falseThe name of the
AppInstanceUserEndpoint
.r#type(AppInstanceUserEndpointType)
/set_type(Option<AppInstanceUserEndpointType>)
:
required: trueThe type of the
AppInstanceUserEndpoint
. Supported types:-
APNS
: The mobile notification service for an Apple device. -
APNS_SANDBOX
: The sandbox environment of the mobile notification service for an Apple device. -
GCM
: The mobile notification service for an Android device.
Populate the
ResourceArn
value of each type asPinpointAppArn
.-
resource_arn(impl Into<String>)
/set_resource_arn(Option<String>)
:
required: trueThe ARN of the resource to which the endpoint belongs.
endpoint_attributes(EndpointAttributes)
/set_endpoint_attributes(Option<EndpointAttributes>)
:
required: trueThe attributes of an
Endpoint
.client_request_token(impl Into<String>)
/set_client_request_token(Option<String>)
:
required: trueThe unique ID assigned to the request. Use different tokens to register other endpoints.
allow_messages(AllowMessages)
/set_allow_messages(Option<AllowMessages>)
:
required: falseBoolean that controls whether the AppInstanceUserEndpoint is opted in to receive messages.
ALL
indicates the endpoint receives all messages.NONE
indicates the endpoint receives no messages.
- On success, responds with
RegisterAppInstanceUserEndpointOutput
with field(s):app_instance_user_arn(Option<String>)
:The ARN of the
AppInstanceUser
.endpoint_id(Option<String>)
:The unique identifier of the
AppInstanceUserEndpoint
.
- On failure, responds with
SdkError<RegisterAppInstanceUserEndpointError>
Source§impl Client
impl Client
Sourcepub fn tag_resource(&self) -> TagResourceFluentBuilder
pub fn tag_resource(&self) -> TagResourceFluentBuilder
Constructs a fluent builder for the TagResource
operation.
- The fluent builder is configurable:
resource_arn(impl Into<String>)
/set_resource_arn(Option<String>)
:
required: trueThe resource ARN.
tags(Tag)
/set_tags(Option<Vec::<Tag>>)
:
required: trueThe tag key-value pairs.
- On success, responds with
TagResourceOutput
- On failure, responds with
SdkError<TagResourceError>
Source§impl Client
impl Client
Sourcepub fn untag_resource(&self) -> UntagResourceFluentBuilder
pub fn untag_resource(&self) -> UntagResourceFluentBuilder
Constructs a fluent builder for the UntagResource
operation.
- The fluent builder is configurable:
resource_arn(impl Into<String>)
/set_resource_arn(Option<String>)
:
required: trueThe resource ARN.
tag_keys(impl Into<String>)
/set_tag_keys(Option<Vec::<String>>)
:
required: trueThe tag keys.
- On success, responds with
UntagResourceOutput
- On failure, responds with
SdkError<UntagResourceError>
Source§impl Client
impl Client
Sourcepub fn update_app_instance(&self) -> UpdateAppInstanceFluentBuilder
pub fn update_app_instance(&self) -> UpdateAppInstanceFluentBuilder
Constructs a fluent builder for the UpdateAppInstance
operation.
- The fluent builder is configurable:
app_instance_arn(impl Into<String>)
/set_app_instance_arn(Option<String>)
:
required: trueThe ARN of the
AppInstance
.name(impl Into<String>)
/set_name(Option<String>)
:
required: trueThe name that you want to change.
metadata(impl Into<String>)
/set_metadata(Option<String>)
:
required: trueThe metadata that you want to change.
- On success, responds with
UpdateAppInstanceOutput
with field(s):app_instance_arn(Option<String>)
:The ARN of the
AppInstance
.
- On failure, responds with
SdkError<UpdateAppInstanceError>
Source§impl Client
impl Client
Sourcepub fn update_app_instance_bot(&self) -> UpdateAppInstanceBotFluentBuilder
pub fn update_app_instance_bot(&self) -> UpdateAppInstanceBotFluentBuilder
Constructs a fluent builder for the UpdateAppInstanceBot
operation.
- The fluent builder is configurable:
app_instance_bot_arn(impl Into<String>)
/set_app_instance_bot_arn(Option<String>)
:
required: trueThe ARN of the
AppInstanceBot
.name(impl Into<String>)
/set_name(Option<String>)
:
required: trueThe name of the
AppInstanceBot
.metadata(impl Into<String>)
/set_metadata(Option<String>)
:
required: trueThe metadata of the
AppInstanceBot
.configuration(Configuration)
/set_configuration(Option<Configuration>)
:
required: falseThe configuration for the bot update.
- On success, responds with
UpdateAppInstanceBotOutput
with field(s):app_instance_bot_arn(Option<String>)
:The ARN of the
AppInstanceBot
.
- On failure, responds with
SdkError<UpdateAppInstanceBotError>
Source§impl Client
impl Client
Sourcepub fn update_app_instance_user(&self) -> UpdateAppInstanceUserFluentBuilder
pub fn update_app_instance_user(&self) -> UpdateAppInstanceUserFluentBuilder
Constructs a fluent builder for the UpdateAppInstanceUser
operation.
- The fluent builder is configurable:
app_instance_user_arn(impl Into<String>)
/set_app_instance_user_arn(Option<String>)
:
required: trueThe ARN of the
AppInstanceUser
.name(impl Into<String>)
/set_name(Option<String>)
:
required: trueThe name of the
AppInstanceUser
.metadata(impl Into<String>)
/set_metadata(Option<String>)
:
required: trueThe metadata of the
AppInstanceUser
.
- On success, responds with
UpdateAppInstanceUserOutput
with field(s):app_instance_user_arn(Option<String>)
:The ARN of the
AppInstanceUser
.
- On failure, responds with
SdkError<UpdateAppInstanceUserError>
Source§impl Client
impl Client
Sourcepub fn update_app_instance_user_endpoint(
&self,
) -> UpdateAppInstanceUserEndpointFluentBuilder
pub fn update_app_instance_user_endpoint( &self, ) -> UpdateAppInstanceUserEndpointFluentBuilder
Constructs a fluent builder for the UpdateAppInstanceUserEndpoint
operation.
- The fluent builder is configurable:
app_instance_user_arn(impl Into<String>)
/set_app_instance_user_arn(Option<String>)
:
required: trueThe ARN of the
AppInstanceUser
.endpoint_id(impl Into<String>)
/set_endpoint_id(Option<String>)
:
required: trueThe unique identifier of the
AppInstanceUserEndpoint
.name(impl Into<String>)
/set_name(Option<String>)
:
required: falseThe name of the
AppInstanceUserEndpoint
.allow_messages(AllowMessages)
/set_allow_messages(Option<AllowMessages>)
:
required: falseBoolean that controls whether the
AppInstanceUserEndpoint
is opted in to receive messages.ALL
indicates the endpoint will receive all messages.NONE
indicates the endpoint will receive no messages.
- On success, responds with
UpdateAppInstanceUserEndpointOutput
with field(s):app_instance_user_arn(Option<String>)
:The ARN of the
AppInstanceUser
.endpoint_id(Option<String>)
:The unique identifier of the
AppInstanceUserEndpoint
.
- On failure, responds with
SdkError<UpdateAppInstanceUserEndpointError>
Source§impl Client
impl Client
Sourcepub fn from_conf(conf: Config) -> Self
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
andtime_source
configured. - No
behavior_version
is provided.
The panic message for each of these will have instructions on how to resolve them.
Source§impl Client
impl Client
Sourcepub fn new(sdk_config: &SdkConfig) -> Self
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 thesleep_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 thehttp_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, setbehavior_version
on the Config or enable thebehavior-version-latest
Cargo feature.
Trait Implementations§
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> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
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 moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
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 moreSource§impl<T> Paint for Twhere
T: ?Sized,
impl<T> Paint for Twhere
T: ?Sized,
Source§fn fg(&self, value: Color) -> Painted<&T>
fn fg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self
with the foreground set to
value
.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like red()
and
green()
, which have the same functionality but are
pithier.
§Example
Set foreground color to white using fg()
:
use yansi::{Paint, Color};
painted.fg(Color::White);
Set foreground color to white using white()
.
use yansi::Paint;
painted.white();
Source§fn bright_black(&self) -> Painted<&T>
fn bright_black(&self) -> Painted<&T>
Source§fn bright_red(&self) -> Painted<&T>
fn bright_red(&self) -> Painted<&T>
Source§fn bright_green(&self) -> Painted<&T>
fn bright_green(&self) -> Painted<&T>
Source§fn bright_yellow(&self) -> Painted<&T>
fn bright_yellow(&self) -> Painted<&T>
Source§fn bright_blue(&self) -> Painted<&T>
fn bright_blue(&self) -> Painted<&T>
Source§fn bright_magenta(&self) -> Painted<&T>
fn bright_magenta(&self) -> Painted<&T>
Source§fn bright_cyan(&self) -> Painted<&T>
fn bright_cyan(&self) -> Painted<&T>
Source§fn bright_white(&self) -> Painted<&T>
fn bright_white(&self) -> Painted<&T>
Source§fn bg(&self, value: Color) -> Painted<&T>
fn bg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self
with the background set to
value
.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like on_red()
and
on_green()
, which have the same functionality but
are pithier.
§Example
Set background color to red using fg()
:
use yansi::{Paint, Color};
painted.bg(Color::Red);
Set background color to red using on_red()
.
use yansi::Paint;
painted.on_red();
Source§fn on_primary(&self) -> Painted<&T>
fn on_primary(&self) -> Painted<&T>
Source§fn on_magenta(&self) -> Painted<&T>
fn on_magenta(&self) -> Painted<&T>
Source§fn on_bright_black(&self) -> Painted<&T>
fn on_bright_black(&self) -> Painted<&T>
Source§fn on_bright_red(&self) -> Painted<&T>
fn on_bright_red(&self) -> Painted<&T>
Source§fn on_bright_green(&self) -> Painted<&T>
fn on_bright_green(&self) -> Painted<&T>
Source§fn on_bright_yellow(&self) -> Painted<&T>
fn on_bright_yellow(&self) -> Painted<&T>
Source§fn on_bright_blue(&self) -> Painted<&T>
fn on_bright_blue(&self) -> Painted<&T>
Source§fn on_bright_magenta(&self) -> Painted<&T>
fn on_bright_magenta(&self) -> Painted<&T>
Source§fn on_bright_cyan(&self) -> Painted<&T>
fn on_bright_cyan(&self) -> Painted<&T>
Source§fn on_bright_white(&self) -> Painted<&T>
fn on_bright_white(&self) -> Painted<&T>
Source§fn attr(&self, value: Attribute) -> Painted<&T>
fn attr(&self, value: Attribute) -> Painted<&T>
Enables the styling Attribute
value
.
This method should be used rarely. Instead, prefer to use
attribute-specific builder methods like bold()
and
underline()
, which have the same functionality
but are pithier.
§Example
Make text bold using attr()
:
use yansi::{Paint, Attribute};
painted.attr(Attribute::Bold);
Make text bold using using bold()
.
use yansi::Paint;
painted.bold();
Source§fn rapid_blink(&self) -> Painted<&T>
fn rapid_blink(&self) -> Painted<&T>
Source§fn quirk(&self, value: Quirk) -> Painted<&T>
fn quirk(&self, value: Quirk) -> Painted<&T>
Enables the yansi
Quirk
value
.
This method should be used rarely. Instead, prefer to use quirk-specific
builder methods like mask()
and
wrap()
, which have the same functionality but are
pithier.
§Example
Enable wrapping using .quirk()
:
use yansi::{Paint, Quirk};
painted.quirk(Quirk::Wrap);
Enable wrapping using wrap()
.
use yansi::Paint;
painted.wrap();
Source§fn clear(&self) -> Painted<&T>
👎Deprecated since 1.0.1: renamed to resetting()
due to conflicts with Vec::clear()
.
The clear()
method will be removed in a future release.
fn clear(&self) -> Painted<&T>
resetting()
due to conflicts with Vec::clear()
.
The clear()
method will be removed in a future release.Source§fn whenever(&self, value: Condition) -> Painted<&T>
fn whenever(&self, value: Condition) -> Painted<&T>
Conditionally enable styling based on whether the Condition
value
applies. Replaces any previous condition.
See the crate level docs for more details.
§Example
Enable styling painted
only when both stdout
and stderr
are TTYs:
use yansi::{Paint, Condition};
painted.red().on_yellow().whenever(Condition::STDOUTERR_ARE_TTY);