pub struct Client { /* private fields */ }
Expand description
Client for QApps
Client for invoking operations on QApps. Each operation on QApps 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_qapps::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_qapps::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 AssociateLibraryItemReview
operation has
a Client::associate_library_item_review
, 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_library_item_review()
.instance_id("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 associate_library_item_review(
&self,
) -> AssociateLibraryItemReviewFluentBuilder
pub fn associate_library_item_review( &self, ) -> AssociateLibraryItemReviewFluentBuilder
Constructs a fluent builder for the AssociateLibraryItemReview
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier for the Amazon Q Business application environment instance.
library_item_id(impl Into<String>)
/set_library_item_id(Option<String>)
:
required: trueThe unique identifier of the library item to associate the review with.
- On success, responds with
AssociateLibraryItemReviewOutput
- On failure, responds with
SdkError<AssociateLibraryItemReviewError>
Source§impl Client
impl Client
Sourcepub fn associate_q_app_with_user(&self) -> AssociateQAppWithUserFluentBuilder
pub fn associate_q_app_with_user(&self) -> AssociateQAppWithUserFluentBuilder
Constructs a fluent builder for the AssociateQAppWithUser
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
app_id(impl Into<String>)
/set_app_id(Option<String>)
:
required: trueThe ID of the Amazon Q App to associate with the user.
- On success, responds with
AssociateQAppWithUserOutput
- On failure, responds with
SdkError<AssociateQAppWithUserError>
Source§impl Client
impl Client
Sourcepub fn batch_create_category(&self) -> BatchCreateCategoryFluentBuilder
pub fn batch_create_category(&self) -> BatchCreateCategoryFluentBuilder
Constructs a fluent builder for the BatchCreateCategory
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
categories(BatchCreateCategoryInputCategory)
/set_categories(Option<Vec::<BatchCreateCategoryInputCategory>>)
:
required: trueThe list of category objects to be created
- On success, responds with
BatchCreateCategoryOutput
- On failure, responds with
SdkError<BatchCreateCategoryError>
Source§impl Client
impl Client
Sourcepub fn batch_delete_category(&self) -> BatchDeleteCategoryFluentBuilder
pub fn batch_delete_category(&self) -> BatchDeleteCategoryFluentBuilder
Constructs a fluent builder for the BatchDeleteCategory
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
categories(impl Into<String>)
/set_categories(Option<Vec::<String>>)
:
required: trueThe list of IDs of the categories to be deleted.
- On success, responds with
BatchDeleteCategoryOutput
- On failure, responds with
SdkError<BatchDeleteCategoryError>
Source§impl Client
impl Client
Sourcepub fn batch_update_category(&self) -> BatchUpdateCategoryFluentBuilder
pub fn batch_update_category(&self) -> BatchUpdateCategoryFluentBuilder
Constructs a fluent builder for the BatchUpdateCategory
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
categories(CategoryInput)
/set_categories(Option<Vec::<CategoryInput>>)
:
required: trueThe list of categories to be updated with their new values.
- On success, responds with
BatchUpdateCategoryOutput
- On failure, responds with
SdkError<BatchUpdateCategoryError>
Source§impl Client
impl Client
Sourcepub fn create_library_item(&self) -> CreateLibraryItemFluentBuilder
pub fn create_library_item(&self) -> CreateLibraryItemFluentBuilder
Constructs a fluent builder for the CreateLibraryItem
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
app_id(impl Into<String>)
/set_app_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q App to publish to the library.
app_version(i32)
/set_app_version(Option<i32>)
:
required: trueThe version of the Amazon Q App to publish to the library.
categories(impl Into<String>)
/set_categories(Option<Vec::<String>>)
:
required: trueThe categories to associate with the library item for easier discovery.
- On success, responds with
CreateLibraryItemOutput
with field(s):library_item_id(String)
:The unique identifier of the new library item.
status(String)
:The status of the new library item, such as “Published”.
created_at(DateTime)
:The date and time the library item was created.
created_by(String)
:The user who created the library item.
updated_at(Option<DateTime>)
:The date and time the library item was last updated.
updated_by(Option<String>)
:The user who last updated the library item.
rating_count(i32)
:The number of ratings the library item has received from users.
is_verified(Option<bool>)
:Indicates whether the library item has been verified.
- On failure, responds with
SdkError<CreateLibraryItemError>
Source§impl Client
impl Client
Sourcepub fn create_presigned_url(&self) -> CreatePresignedUrlFluentBuilder
pub fn create_presigned_url(&self) -> CreatePresignedUrlFluentBuilder
Constructs a fluent builder for the CreatePresignedUrl
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
card_id(impl Into<String>)
/set_card_id(Option<String>)
:
required: trueThe unique identifier of the card the file is associated with.
app_id(impl Into<String>)
/set_app_id(Option<String>)
:
required: trueThe unique identifier of the Q App the file is associated with.
file_contents_sha256(impl Into<String>)
/set_file_contents_sha256(Option<String>)
:
required: trueThe Base64-encoded SHA-256 digest of the contents of the file to be uploaded.
file_name(impl Into<String>)
/set_file_name(Option<String>)
:
required: trueThe name of the file to be uploaded.
scope(DocumentScope)
/set_scope(Option<DocumentScope>)
:
required: trueWhether the file is associated with a Q App definition or a specific Q App session.
session_id(impl Into<String>)
/set_session_id(Option<String>)
:
required: falseThe unique identifier of the Q App session the file is associated with, if applicable.
- On success, responds with
CreatePresignedUrlOutput
with field(s):file_id(String)
:The unique identifier assigned to the file to be uploaded.
presigned_url(String)
:The URL for a presigned S3 POST operation used to upload a file.
presigned_url_fields(HashMap::<String, String>)
:The form fields to include in the presigned S3 POST operation used to upload a file.
presigned_url_expiration(DateTime)
:The date and time that the presigned URL will expire in ISO 8601 format.
- On failure, responds with
SdkError<CreatePresignedUrlError>
Source§impl Client
impl Client
Sourcepub fn create_q_app(&self) -> CreateQAppFluentBuilder
pub fn create_q_app(&self) -> CreateQAppFluentBuilder
Constructs a fluent builder for the CreateQApp
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
title(impl Into<String>)
/set_title(Option<String>)
:
required: trueThe title of the new Q App.
description(impl Into<String>)
/set_description(Option<String>)
:
required: falseThe description of the new Q App.
app_definition(AppDefinitionInput)
/set_app_definition(Option<AppDefinitionInput>)
:
required: trueThe definition of the new Q App, specifying the cards and flow.
tags(impl Into<String>, impl Into<String>)
/set_tags(Option<HashMap::<String, String>>)
:
required: falseOptional tags to associate with the new Q App.
- On success, responds with
CreateQAppOutput
with field(s):app_id(String)
:The unique identifier of the new Q App.
app_arn(String)
:The Amazon Resource Name (ARN) of the new Q App.
title(String)
:The title of the new Q App.
description(Option<String>)
:The description of the new Q App.
initial_prompt(Option<String>)
:The initial prompt displayed when the Q App is started.
app_version(i32)
:The version of the new Q App.
status(AppStatus)
:The status of the new Q App, such as “Created”.
created_at(DateTime)
:The date and time the Q App was created.
created_by(String)
:The user who created the Q App.
updated_at(DateTime)
:The date and time the Q App was last updated.
updated_by(String)
:The user who last updated the Q App.
required_capabilities(Option<Vec::<AppRequiredCapability>>)
:The capabilities required to run the Q App, such as file upload or third-party integrations.
- On failure, responds with
SdkError<CreateQAppError>
Source§impl Client
impl Client
Sourcepub fn delete_library_item(&self) -> DeleteLibraryItemFluentBuilder
pub fn delete_library_item(&self) -> DeleteLibraryItemFluentBuilder
Constructs a fluent builder for the DeleteLibraryItem
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
library_item_id(impl Into<String>)
/set_library_item_id(Option<String>)
:
required: trueThe unique identifier of the library item to delete.
- On success, responds with
DeleteLibraryItemOutput
- On failure, responds with
SdkError<DeleteLibraryItemError>
Source§impl Client
impl Client
Sourcepub fn delete_q_app(&self) -> DeleteQAppFluentBuilder
pub fn delete_q_app(&self) -> DeleteQAppFluentBuilder
Constructs a fluent builder for the DeleteQApp
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
app_id(impl Into<String>)
/set_app_id(Option<String>)
:
required: trueThe unique identifier of the Q App to delete.
- On success, responds with
DeleteQAppOutput
- On failure, responds with
SdkError<DeleteQAppError>
Source§impl Client
impl Client
Sourcepub fn describe_q_app_permissions(&self) -> DescribeQAppPermissionsFluentBuilder
pub fn describe_q_app_permissions(&self) -> DescribeQAppPermissionsFluentBuilder
Constructs a fluent builder for the DescribeQAppPermissions
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
app_id(impl Into<String>)
/set_app_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q App for which to retrieve permissions.
- On success, responds with
DescribeQAppPermissionsOutput
with field(s):resource_arn(Option<String>)
:The Amazon Resource Name (ARN) of the Amazon Q App for which permissions are returned.
app_id(Option<String>)
:The unique identifier of the Amazon Q App for which permissions are returned.
permissions(Option<Vec::<PermissionOutput>>)
:The list of permissions granted for the Amazon Q App.
- On failure, responds with
SdkError<DescribeQAppPermissionsError>
Source§impl Client
impl Client
Sourcepub fn disassociate_library_item_review(
&self,
) -> DisassociateLibraryItemReviewFluentBuilder
pub fn disassociate_library_item_review( &self, ) -> DisassociateLibraryItemReviewFluentBuilder
Constructs a fluent builder for the DisassociateLibraryItemReview
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
library_item_id(impl Into<String>)
/set_library_item_id(Option<String>)
:
required: trueThe unique identifier of the library item to remove the review from.
- On success, responds with
DisassociateLibraryItemReviewOutput
- On failure, responds with
SdkError<DisassociateLibraryItemReviewError>
Source§impl Client
impl Client
Sourcepub fn disassociate_q_app_from_user(
&self,
) -> DisassociateQAppFromUserFluentBuilder
pub fn disassociate_q_app_from_user( &self, ) -> DisassociateQAppFromUserFluentBuilder
Constructs a fluent builder for the DisassociateQAppFromUser
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
app_id(impl Into<String>)
/set_app_id(Option<String>)
:
required: trueThe unique identifier of the Q App to disassociate from the user.
- On success, responds with
DisassociateQAppFromUserOutput
- On failure, responds with
SdkError<DisassociateQAppFromUserError>
Source§impl Client
impl Client
Sourcepub fn export_q_app_session_data(&self) -> ExportQAppSessionDataFluentBuilder
pub fn export_q_app_session_data(&self) -> ExportQAppSessionDataFluentBuilder
Constructs a fluent builder for the ExportQAppSessionData
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
session_id(impl Into<String>)
/set_session_id(Option<String>)
:
required: trueThe unique identifier of the Q App data collection session.
- On success, responds with
ExportQAppSessionDataOutput
with field(s):csv_file_link(String)
:The link where the exported Q App session data can be downloaded from.
expires_at(DateTime)
:The date and time when the link for the exported Q App session data expires.
session_arn(String)
:The Amazon Resource Name (ARN) of the Q App data collection session.
- On failure, responds with
SdkError<ExportQAppSessionDataError>
Source§impl Client
impl Client
Sourcepub fn get_library_item(&self) -> GetLibraryItemFluentBuilder
pub fn get_library_item(&self) -> GetLibraryItemFluentBuilder
Constructs a fluent builder for the GetLibraryItem
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
library_item_id(impl Into<String>)
/set_library_item_id(Option<String>)
:
required: trueThe unique identifier of the library item to retrieve.
app_id(impl Into<String>)
/set_app_id(Option<String>)
:
required: falseThe unique identifier of the Amazon Q App associated with the library item.
- On success, responds with
GetLibraryItemOutput
with field(s):library_item_id(String)
:The unique identifier of the library item.
app_id(String)
:The unique identifier of the Q App associated with the library item.
app_version(i32)
:The version of the Q App associated with the library item.
categories(Vec::<Category>)
:The categories associated with the library item for discovery.
status(String)
:The status of the library item, such as “Published”.
created_at(DateTime)
:The date and time the library item was created.
created_by(String)
:The user who created the library item.
updated_at(Option<DateTime>)
:The date and time the library item was last updated.
updated_by(Option<String>)
:The user who last updated the library item.
rating_count(i32)
:The number of ratings the library item has received from users.
is_rated_by_user(Option<bool>)
:Whether the current user has rated the library item.
user_count(Option<i32>)
:The number of users who have associated the Q App with their account.
is_verified(Option<bool>)
:Indicates whether the library item has been verified.
- On failure, responds with
SdkError<GetLibraryItemError>
Source§impl Client
impl Client
Sourcepub fn get_q_app(&self) -> GetQAppFluentBuilder
pub fn get_q_app(&self) -> GetQAppFluentBuilder
Constructs a fluent builder for the GetQApp
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
app_id(impl Into<String>)
/set_app_id(Option<String>)
:
required: trueThe unique identifier of the Q App to retrieve.
app_version(i32)
/set_app_version(Option<i32>)
:
required: falseThe version of the Q App.
- On success, responds with
GetQAppOutput
with field(s):app_id(String)
:The unique identifier of the Q App.
app_arn(String)
:The Amazon Resource Name (ARN) of the Q App.
title(String)
:The title of the Q App.
description(Option<String>)
:The description of the Q App.
initial_prompt(Option<String>)
:The initial prompt displayed when the Q App is started.
app_version(i32)
:The version of the Q App.
status(AppStatus)
:The status of the Q App.
created_at(DateTime)
:The date and time the Q App was created.
created_by(String)
:The user who created the Q App.
updated_at(DateTime)
:The date and time the Q App was last updated.
updated_by(String)
:The user who last updated the Q App.
required_capabilities(Option<Vec::<AppRequiredCapability>>)
:The capabilities required to run the Q App, such as file upload or third-party integrations.
app_definition(Option<AppDefinition>)
:The full definition of the Q App, specifying the cards and flow.
- On failure, responds with
SdkError<GetQAppError>
Source§impl Client
impl Client
Sourcepub fn get_q_app_session(&self) -> GetQAppSessionFluentBuilder
pub fn get_q_app_session(&self) -> GetQAppSessionFluentBuilder
Constructs a fluent builder for the GetQAppSession
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
session_id(impl Into<String>)
/set_session_id(Option<String>)
:
required: trueThe unique identifier of the Q App session to retrieve.
- On success, responds with
GetQAppSessionOutput
with field(s):session_id(String)
:The unique identifier of the Q App session.
session_arn(String)
:The Amazon Resource Name (ARN) of the Q App session.
session_name(Option<String>)
:The name of the Q App session.
app_version(Option<i32>)
:The version of the Q App used for the session.
latest_published_app_version(Option<i32>)
:The latest published version of the Q App used for the session.
status(ExecutionStatus)
:The current status of the Q App session.
card_status(HashMap::<String, CardStatus>)
:The current status for each card in the Q App session.
user_is_host(Option<bool>)
:Indicates whether the current user is the owner of the Q App data collection session.
- On failure, responds with
SdkError<GetQAppSessionError>
Source§impl Client
impl Client
Sourcepub fn get_q_app_session_metadata(&self) -> GetQAppSessionMetadataFluentBuilder
pub fn get_q_app_session_metadata(&self) -> GetQAppSessionMetadataFluentBuilder
Constructs a fluent builder for the GetQAppSessionMetadata
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
session_id(impl Into<String>)
/set_session_id(Option<String>)
:
required: trueThe unique identifier of the Q App session.
- On success, responds with
GetQAppSessionMetadataOutput
with field(s):session_id(String)
:The unique identifier of the Q App session.
session_arn(String)
:The Amazon Resource Name (ARN) of the Q App session.
session_name(Option<String>)
:The name of the Q App session.
sharing_configuration(Option<SessionSharingConfiguration>)
:The sharing configuration of the Q App data collection session.
session_owner(Option<bool>)
:Indicates whether the current user is the owner of the Q App session.
- On failure, responds with
SdkError<GetQAppSessionMetadataError>
Source§impl Client
impl Client
Sourcepub fn import_document(&self) -> ImportDocumentFluentBuilder
pub fn import_document(&self) -> ImportDocumentFluentBuilder
Constructs a fluent builder for the ImportDocument
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
card_id(impl Into<String>)
/set_card_id(Option<String>)
:
required: trueThe unique identifier of the card the file is associated with.
app_id(impl Into<String>)
/set_app_id(Option<String>)
:
required: trueThe unique identifier of the Q App the file is associated with.
file_contents_base64(impl Into<String>)
/set_file_contents_base64(Option<String>)
:
required: trueThe base64-encoded contents of the file to upload.
file_name(impl Into<String>)
/set_file_name(Option<String>)
:
required: trueThe name of the file being uploaded.
scope(DocumentScope)
/set_scope(Option<DocumentScope>)
:
required: trueWhether the file is associated with a Q App definition or a specific Q App session.
session_id(impl Into<String>)
/set_session_id(Option<String>)
:
required: falseThe unique identifier of the Q App session the file is associated with, if applicable.
- On success, responds with
ImportDocumentOutput
with field(s):file_id(Option<String>)
:The unique identifier assigned to the uploaded file.
- On failure, responds with
SdkError<ImportDocumentError>
Source§impl Client
impl Client
Sourcepub fn list_categories(&self) -> ListCategoriesFluentBuilder
pub fn list_categories(&self) -> ListCategoriesFluentBuilder
Constructs a fluent builder for the ListCategories
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
- On success, responds with
ListCategoriesOutput
with field(s):categories(Option<Vec::<Category>>)
:The categories of a Amazon Q Business application environment instance.
- On failure, responds with
SdkError<ListCategoriesError>
Source§impl Client
impl Client
Sourcepub fn list_library_items(&self) -> ListLibraryItemsFluentBuilder
pub fn list_library_items(&self) -> ListLibraryItemsFluentBuilder
Constructs a fluent builder for the ListLibraryItems
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
limit(i32)
/set_limit(Option<i32>)
:
required: falseThe maximum number of library items to return in the response.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseThe token to request the next page of results.
category_id(impl Into<String>)
/set_category_id(Option<String>)
:
required: falseOptional category to filter the library items by.
- On success, responds with
ListLibraryItemsOutput
with field(s):library_items(Option<Vec::<LibraryItemMember>>)
:The list of library items meeting the request criteria.
next_token(Option<String>)
:The token to use to request the next page of results.
- On failure, responds with
SdkError<ListLibraryItemsError>
Source§impl Client
impl Client
Sourcepub fn list_q_app_session_data(&self) -> ListQAppSessionDataFluentBuilder
pub fn list_q_app_session_data(&self) -> ListQAppSessionDataFluentBuilder
Constructs a fluent builder for the ListQAppSessionData
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
session_id(impl Into<String>)
/set_session_id(Option<String>)
:
required: trueThe unique identifier of the Q App data collection session.
- On success, responds with
ListQAppSessionDataOutput
with field(s):session_id(String)
:The unique identifier of the Q App data collection session.
session_arn(String)
:The Amazon Resource Name (ARN) of the Q App data collection session.
session_data(Option<Vec::<QAppSessionData>>)
:The collected responses of a Q App session.
next_token(Option<String>)
:The pagination token that indicates the next set of results to retrieve.
- On failure, responds with
SdkError<ListQAppSessionDataError>
Source§impl Client
impl Client
Sourcepub fn list_q_apps(&self) -> ListQAppsFluentBuilder
pub fn list_q_apps(&self) -> ListQAppsFluentBuilder
Constructs a fluent builder for the ListQApps
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
limit(i32)
/set_limit(Option<i32>)
:
required: falseThe maximum number of Q Apps to return in the response.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseThe token to request the next page of results.
- On success, responds with
ListQAppsOutput
with field(s):apps(Vec::<UserAppItem>)
:The list of Amazon Q Apps meeting the request criteria.
next_token(Option<String>)
:The token to use to request the next page of results.
- On failure, responds with
SdkError<ListQAppsError>
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 Amazon Resource Name (ARN) of the resource whose tags should be listed.
- On success, responds with
ListTagsForResourceOutput
with field(s):tags(Option<HashMap::<String, String>>)
:The list of tags that are assigned to the resource.
- On failure, responds with
SdkError<ListTagsForResourceError>
Source§impl Client
impl Client
Sourcepub fn predict_q_app(&self) -> PredictQAppFluentBuilder
pub fn predict_q_app(&self) -> PredictQAppFluentBuilder
Constructs a fluent builder for the PredictQApp
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
options(PredictQAppInputOptions)
/set_options(Option<PredictQAppInputOptions>)
:
required: falseThe input to generate the Q App definition from, either a conversation or problem statement.
- On success, responds with
PredictQAppOutput
with field(s):app(Option<PredictAppDefinition>)
:The generated Q App definition.
problem_statement(String)
:The problem statement extracted from the input conversation, if provided.
- On failure, responds with
SdkError<PredictQAppError>
Source§impl Client
impl Client
Sourcepub fn start_q_app_session(&self) -> StartQAppSessionFluentBuilder
pub fn start_q_app_session(&self) -> StartQAppSessionFluentBuilder
Constructs a fluent builder for the StartQAppSession
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
app_id(impl Into<String>)
/set_app_id(Option<String>)
:
required: trueThe unique identifier of the Q App to start a session for.
app_version(i32)
/set_app_version(Option<i32>)
:
required: trueThe version of the Q App to use for the session.
initial_values(CardValue)
/set_initial_values(Option<Vec::<CardValue>>)
:
required: falseOptional initial input values to provide for the Q App session.
session_id(impl Into<String>)
/set_session_id(Option<String>)
:
required: falseThe unique identifier of the a Q App session.
tags(impl Into<String>, impl Into<String>)
/set_tags(Option<HashMap::<String, String>>)
:
required: falseOptional tags to associate with the new Q App session.
- On success, responds with
StartQAppSessionOutput
with field(s):session_id(String)
:The unique identifier of the new or retrieved Q App session.
session_arn(String)
:The Amazon Resource Name (ARN) of the new Q App session.
- On failure, responds with
SdkError<StartQAppSessionError>
Source§impl Client
impl Client
Sourcepub fn stop_q_app_session(&self) -> StopQAppSessionFluentBuilder
pub fn stop_q_app_session(&self) -> StopQAppSessionFluentBuilder
Constructs a fluent builder for the StopQAppSession
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
session_id(impl Into<String>)
/set_session_id(Option<String>)
:
required: trueThe unique identifier of the Q App session to stop.
- On success, responds with
StopQAppSessionOutput
- On failure, responds with
SdkError<StopQAppSessionError>
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 Amazon Resource Name (ARN) of the resource to tag.
tags(impl Into<String>, impl Into<String>)
/set_tags(Option<HashMap::<String, String>>)
:
required: trueThe tags to associate with the resource.
- 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 Amazon Resource Name (ARN) of the resource to disassociate the tag from.
tag_keys(impl Into<String>)
/set_tag_keys(Option<Vec::<String>>)
:
required: trueThe keys of the tags to disassociate from the resource.
- On success, responds with
UntagResourceOutput
- On failure, responds with
SdkError<UntagResourceError>
Source§impl Client
impl Client
Sourcepub fn update_library_item(&self) -> UpdateLibraryItemFluentBuilder
pub fn update_library_item(&self) -> UpdateLibraryItemFluentBuilder
Constructs a fluent builder for the UpdateLibraryItem
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
library_item_id(impl Into<String>)
/set_library_item_id(Option<String>)
:
required: trueThe unique identifier of the library item to update.
status(LibraryItemStatus)
/set_status(Option<LibraryItemStatus>)
:
required: falseThe new status to set for the library item, such as “Published” or “Hidden”.
categories(impl Into<String>)
/set_categories(Option<Vec::<String>>)
:
required: falseThe new categories to associate with the library item.
- On success, responds with
UpdateLibraryItemOutput
with field(s):library_item_id(String)
:The unique identifier of the updated library item.
app_id(String)
:The unique identifier of the Q App associated with the library item.
app_version(i32)
:The version of the Q App associated with the library item.
categories(Vec::<Category>)
:The categories associated with the updated library item.
status(String)
:The new status of the updated library item.
created_at(DateTime)
:The date and time the library item was originally created.
created_by(String)
:The user who originally created the library item.
updated_at(Option<DateTime>)
:The date and time the library item was last updated.
updated_by(Option<String>)
:The user who last updated the library item.
rating_count(i32)
:The number of ratings the library item has received.
is_rated_by_user(Option<bool>)
:Whether the current user has rated the library item.
user_count(Option<i32>)
:The number of users who have the associated Q App.
is_verified(Option<bool>)
:Indicates whether the library item has been verified.
- On failure, responds with
SdkError<UpdateLibraryItemError>
Source§impl Client
impl Client
Sourcepub fn update_library_item_metadata(
&self,
) -> UpdateLibraryItemMetadataFluentBuilder
pub fn update_library_item_metadata( &self, ) -> UpdateLibraryItemMetadataFluentBuilder
Constructs a fluent builder for the UpdateLibraryItemMetadata
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
library_item_id(impl Into<String>)
/set_library_item_id(Option<String>)
:
required: trueThe unique identifier of the updated library item.
is_verified(bool)
/set_is_verified(Option<bool>)
:
required: falseThe verification status of the library item
- On success, responds with
UpdateLibraryItemMetadataOutput
- On failure, responds with
SdkError<UpdateLibraryItemMetadataError>
Source§impl Client
impl Client
Sourcepub fn update_q_app(&self) -> UpdateQAppFluentBuilder
pub fn update_q_app(&self) -> UpdateQAppFluentBuilder
Constructs a fluent builder for the UpdateQApp
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
app_id(impl Into<String>)
/set_app_id(Option<String>)
:
required: trueThe unique identifier of the Q App to update.
title(impl Into<String>)
/set_title(Option<String>)
:
required: falseThe new title for the Q App.
description(impl Into<String>)
/set_description(Option<String>)
:
required: falseThe new description for the Q App.
app_definition(AppDefinitionInput)
/set_app_definition(Option<AppDefinitionInput>)
:
required: falseThe new definition specifying the cards and flow for the Q App.
- On success, responds with
UpdateQAppOutput
with field(s):app_id(String)
:The unique identifier of the updated Q App.
app_arn(String)
:The Amazon Resource Name (ARN) of the updated Q App.
title(String)
:The new title of the updated Q App.
description(Option<String>)
:The new description of the updated Q App.
initial_prompt(Option<String>)
:The initial prompt for the updated Q App.
app_version(i32)
:The new version of the updated Q App.
status(AppStatus)
:The status of the updated Q App.
created_at(DateTime)
:The date and time the Q App was originally created.
created_by(String)
:The user who originally created the Q App.
updated_at(DateTime)
:The date and time the Q App was last updated.
updated_by(String)
:The user who last updated the Q App.
required_capabilities(Option<Vec::<AppRequiredCapability>>)
:The capabilities required for the updated Q App.
- On failure, responds with
SdkError<UpdateQAppError>
Source§impl Client
impl Client
Sourcepub fn update_q_app_permissions(&self) -> UpdateQAppPermissionsFluentBuilder
pub fn update_q_app_permissions(&self) -> UpdateQAppPermissionsFluentBuilder
Constructs a fluent builder for the UpdateQAppPermissions
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
app_id(impl Into<String>)
/set_app_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q App for which permissions are being updated.
grant_permissions(PermissionInput)
/set_grant_permissions(Option<Vec::<PermissionInput>>)
:
required: falseThe list of permissions to grant for the Amazon Q App.
revoke_permissions(PermissionInput)
/set_revoke_permissions(Option<Vec::<PermissionInput>>)
:
required: falseThe list of permissions to revoke for the Amazon Q App.
- On success, responds with
UpdateQAppPermissionsOutput
with field(s):resource_arn(Option<String>)
:The Amazon Resource Name (ARN) of the Amazon Q App for which permissions were updated.
app_id(Option<String>)
:The unique identifier of the Amazon Q App for which permissions were updated.
permissions(Option<Vec::<PermissionOutput>>)
:The updated list of permissions for the Amazon Q App.
- On failure, responds with
SdkError<UpdateQAppPermissionsError>
Source§impl Client
impl Client
Sourcepub fn update_q_app_session(&self) -> UpdateQAppSessionFluentBuilder
pub fn update_q_app_session(&self) -> UpdateQAppSessionFluentBuilder
Constructs a fluent builder for the UpdateQAppSession
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
session_id(impl Into<String>)
/set_session_id(Option<String>)
:
required: trueThe unique identifier of the Q App session to provide input for.
values(CardValue)
/set_values(Option<Vec::<CardValue>>)
:
required: falseThe input values to provide for the current state of the Q App session.
- On success, responds with
UpdateQAppSessionOutput
with field(s):session_id(String)
:The unique identifier of the updated Q App session.
session_arn(String)
:The Amazon Resource Name (ARN) of the updated Q App session.
- On failure, responds with
SdkError<UpdateQAppSessionError>
Source§impl Client
impl Client
Sourcepub fn update_q_app_session_metadata(
&self,
) -> UpdateQAppSessionMetadataFluentBuilder
pub fn update_q_app_session_metadata( &self, ) -> UpdateQAppSessionMetadataFluentBuilder
Constructs a fluent builder for the UpdateQAppSessionMetadata
operation.
- The fluent builder is configurable:
instance_id(impl Into<String>)
/set_instance_id(Option<String>)
:
required: trueThe unique identifier of the Amazon Q Business application environment instance.
session_id(impl Into<String>)
/set_session_id(Option<String>)
:
required: trueThe unique identifier of the Q App session to update configuration for.
session_name(impl Into<String>)
/set_session_name(Option<String>)
:
required: falseThe new name for the Q App session.
sharing_configuration(SessionSharingConfiguration)
/set_sharing_configuration(Option<SessionSharingConfiguration>)
:
required: trueThe new sharing configuration for the Q App data collection session.
- On success, responds with
UpdateQAppSessionMetadataOutput
with field(s):session_id(String)
:The unique identifier of the updated Q App session.
session_arn(String)
:The Amazon Resource Name (ARN) of the updated Q App session.
session_name(Option<String>)
:The new name of the updated Q App session.
sharing_configuration(Option<SessionSharingConfiguration>)
:The new sharing configuration of the updated Q App data collection session.
- On failure, responds with
SdkError<UpdateQAppSessionMetadataError>
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);