View Source aws_qbusiness (aws v1.0.4)

Amazon Q is in preview release and is subject to change.

This is the Amazon Q (for business use) API Reference. Amazon Q is a fully managed, generative-AI powered enterprise chat assistant that you can deploy within your organization. Amazon Q enhances employee productivity by supporting key tasks such as question-answering, knowledge discovery, writing email messages, summarizing text, drafting document outlines, and brainstorming ideas. Users ask questions of Amazon Q and get answers that are presented in a conversational manner. For an introduction to the service, see the Amazon Q (for business use) Developer Guide : https://docs.aws.amazon.com/amazonq/latest/business-use-dg/what-is.html.

For an overview of the Amazon Q APIs, see Overview of Amazon Q API operations: https://docs.aws.amazon.com/amazonq/latest/business-use-dg/api-ref.html#api-overview.

For information about the IAM access control permissions you need to use this API, see IAM roles for Amazon Q: https://docs.aws.amazon.com/amazonq/latest/business-use-dg/iam-roles.html in the Amazon Q (for business use) Developer Guide.

You can use the following AWS SDKs to access Amazon Q APIs:

  • AWS SDK for C++: https://docs.aws.amazon.com/sdk-for-cpp

  • AWS SDK for Go: https://docs.aws.amazon.com/sdk-for-go

  • AWS SDK for Java: https://docs.aws.amazon.com/sdk-for-java

  • AWS SDK for JavaScript: https://docs.aws.amazon.com/sdk-for-javascript

  • AWS SDK for .NET: https://docs.aws.amazon.com/sdk-for-net

  • AWS SDK for Python (Boto3): https://docs.aws.amazon.com/pythonsdk

  • AWS SDK for Ruby: https://docs.aws.amazon.com/sdk-for-ruby

The following resources provide additional information about using the Amazon Q API:

  • Setting up for Amazon Q: https://docs.aws.amazon.com/amazonq/latest/business-use-dg/setting-up.html

  • Amazon Q CLI Reference: https://awscli.amazonaws.com/v2/documentation/api/latest/reference/qbusiness/index.html

  • Amazon Web Services General Reference: https://docs.aws.amazon.com/general/latest/gr/amazonq.html

Summary

Functions

Asynchronously deletes one or more documents added using the BatchPutDocument API from an Amazon Q index.

Adds one or more documents to an Amazon Q index.

Starts or continues a non-streaming Amazon Q conversation.
Creates an Amazon Q application.

Creates an Amazon Q index.

Creates an Amazon Q plugin.
Adds a retriever to your Amazon Q application.
Creates a universally unique identifier (UUID) mapped to a list of local user ids within an application.
Creates an Amazon Q web experience.
Deletes an Amazon Q application.
Deletes chat controls configured for an existing Amazon Q application.
Deletes an Amazon Q web experience conversation.

Deletes a group so that all users and sub groups that belong to the group can no longer access documents only available to that group.

Deletes the retriever used by an Amazon Q application.
Gets information about an existing Amazon Q application.
Gets information about an chat controls configured for an existing Amazon Q application.
Gets information about an existing Amazon Q data source connector.
Describes a group by group name.
Gets information about an existing Amazon Q index.
Gets information about an existing Amazon Q plugin.
Gets information about an existing retriever used by an Amazon Q application.
Describes the universally unique identifier (UUID) associated with a local user in a data source.
Gets information about an existing Amazon Q web experience.
Lists Amazon Q applications.
Lists one or more Amazon Q conversations.
Get information about an Amazon Q data source connector synchronization.
Lists the Amazon Q data source connectors that you have created.
A list of documents attached to an index.
Provides a list of groups that are mapped to users.
Lists the Amazon Q indices you have created.
Gets a list of messages associated with an Amazon Q web experience.
Lists configured Amazon Q plugins.
Lists the retriever used by an Amazon Q application.

Gets a list of tags associated with a specified resource.

Lists one or more Amazon Q Web Experiences.
Enables your end user to to provide feedback on their Amazon Q generated chat responses.

Create, or updates, a mapping of users—who have access to a document—to groups.

Starts a data source connector synchronization job.

Stops an Amazon Q data source connector synchronization job already in progress.

Adds the specified tag to the specified Amazon Q application or data source resource.

Removes a tag from an Amazon Q application or a data source.
Updates an existing Amazon Q application.
Updates an set of chat controls configured for an existing Amazon Q application.
Updates an existing Amazon Q data source connector.
Updates the retriever used for your Amazon Q application.
Updates a information associated with a user id.

Functions

Link to this function

batch_delete_document(Client, ApplicationId, IndexId, Input)

View Source

Asynchronously deletes one or more documents added using the BatchPutDocument API from an Amazon Q index.

You can see the progress of the deletion, and any error messages related to the process, by using CloudWatch.
Link to this function

batch_delete_document(Client, ApplicationId, IndexId, Input0, Options0)

View Source
Link to this function

batch_put_document(Client, ApplicationId, IndexId, Input)

View Source

Adds one or more documents to an Amazon Q index.

You use this API to:

  • ingest your structured and unstructured documents and documents stored in an Amazon S3 bucket into an Amazon Q index.

  • add custom attributes to documents in an Amazon Q index.

  • attach an access control list to the documents added to an Amazon Q index.

You can see the progress of the deletion, and any error messages related to the process, by using CloudWatch.
Link to this function

batch_put_document(Client, ApplicationId, IndexId, Input0, Options0)

View Source
Link to this function

chat_sync(Client, ApplicationId, Input)

View Source
Starts or continues a non-streaming Amazon Q conversation.
Link to this function

chat_sync(Client, ApplicationId, Input0, Options0)

View Source
Link to this function

create_application(Client, Input)

View Source
Creates an Amazon Q application.
Link to this function

create_application(Client, Input0, Options0)

View Source
Link to this function

create_index(Client, ApplicationId, Input)

View Source

Creates an Amazon Q index.

To determine if index creation has completed, check the Status field returned from a call to DescribeIndex. The Status field is set to ACTIVE when the index is ready to use.

Once the index is active, you can index your documents using the BatchPutDocument : https://docs.aws.amazon.com/amazonq/latest/api-reference/API_BatchPutDocument.html API or the CreateDataSource : https://docs.aws.amazon.com/amazonq/latest/api-reference/API_CreateDataSource.html API.
Link to this function

create_index(Client, ApplicationId, Input0, Options0)

View Source
Link to this function

create_plugin(Client, ApplicationId, Input)

View Source
Creates an Amazon Q plugin.
Link to this function

create_plugin(Client, ApplicationId, Input0, Options0)

View Source
Link to this function

create_retriever(Client, ApplicationId, Input)

View Source
Adds a retriever to your Amazon Q application.
Link to this function

create_retriever(Client, ApplicationId, Input0, Options0)

View Source
Link to this function

create_user(Client, ApplicationId, Input)

View Source
Creates a universally unique identifier (UUID) mapped to a list of local user ids within an application.
Link to this function

create_user(Client, ApplicationId, Input0, Options0)

View Source
Link to this function

create_web_experience(Client, ApplicationId, Input)

View Source
Creates an Amazon Q web experience.
Link to this function

create_web_experience(Client, ApplicationId, Input0, Options0)

View Source
Link to this function

delete_application(Client, ApplicationId, Input)

View Source
Deletes an Amazon Q application.
Link to this function

delete_application(Client, ApplicationId, Input0, Options0)

View Source
Link to this function

delete_chat_controls_configuration(Client, ApplicationId, Input)

View Source
Deletes chat controls configured for an existing Amazon Q application.
Link to this function

delete_chat_controls_configuration(Client, ApplicationId, Input0, Options0)

View Source
Link to this function

delete_conversation(Client, ApplicationId, ConversationId, Input)

View Source
Deletes an Amazon Q web experience conversation.
Link to this function

delete_conversation(Client, ApplicationId, ConversationId, Input0, Options0)

View Source
Link to this function

delete_data_source(Client, ApplicationId, DataSourceId, IndexId, Input)

View Source

Deletes an Amazon Q data source connector.

While the data source is being deleted, the Status field returned by a call to the DescribeDataSource API is set to DELETING.
Link to this function

delete_data_source(Client, ApplicationId, DataSourceId, IndexId, Input0, Options0)

View Source
Link to this function

delete_group(Client, ApplicationId, GroupName, IndexId, Input)

View Source

Deletes a group so that all users and sub groups that belong to the group can no longer access documents only available to that group.

For example, after deleting the group "Summer Interns", all interns who belonged to that group no longer see intern-only documents in their chat results.

If you want to delete, update, or replace users or sub groups of a group, you need to use the PutGroup operation. For example, if a user in the group "Engineering" leaves the engineering team and another user takes their place, you provide an updated list of users or sub groups that belong to the "Engineering" group when calling PutGroup.
Link to this function

delete_group(Client, ApplicationId, GroupName, IndexId, Input0, Options0)

View Source
Link to this function

delete_index(Client, ApplicationId, IndexId, Input)

View Source
Deletes an Amazon Q index.
Link to this function

delete_index(Client, ApplicationId, IndexId, Input0, Options0)

View Source
Link to this function

delete_plugin(Client, ApplicationId, PluginId, Input)

View Source
Deletes an Amazon Q plugin.
Link to this function

delete_plugin(Client, ApplicationId, PluginId, Input0, Options0)

View Source
Link to this function

delete_retriever(Client, ApplicationId, RetrieverId, Input)

View Source
Deletes the retriever used by an Amazon Q application.
Link to this function

delete_retriever(Client, ApplicationId, RetrieverId, Input0, Options0)

View Source
Link to this function

delete_user(Client, ApplicationId, UserId, Input)

View Source
Deletes a user by email id.
Link to this function

delete_user(Client, ApplicationId, UserId, Input0, Options0)

View Source
Link to this function

delete_web_experience(Client, ApplicationId, WebExperienceId, Input)

View Source
Deletes an Amazon Q web experience.
Link to this function

delete_web_experience(Client, ApplicationId, WebExperienceId, Input0, Options0)

View Source
Link to this function

get_application(Client, ApplicationId)

View Source
Gets information about an existing Amazon Q application.
Link to this function

get_application(Client, ApplicationId, QueryMap, HeadersMap)

View Source
Link to this function

get_application(Client, ApplicationId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

get_chat_controls_configuration(Client, ApplicationId)

View Source
Gets information about an chat controls configured for an existing Amazon Q application.
Link to this function

get_chat_controls_configuration(Client, ApplicationId, QueryMap, HeadersMap)

View Source
Link to this function

get_chat_controls_configuration(Client, ApplicationId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

get_data_source(Client, ApplicationId, DataSourceId, IndexId)

View Source
Gets information about an existing Amazon Q data source connector.
Link to this function

get_data_source(Client, ApplicationId, DataSourceId, IndexId, QueryMap, HeadersMap)

View Source
Link to this function

get_data_source(Client, ApplicationId, DataSourceId, IndexId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

get_group(Client, ApplicationId, GroupName, IndexId)

View Source
Describes a group by group name.
Link to this function

get_group(Client, ApplicationId, GroupName, IndexId, QueryMap, HeadersMap)

View Source
Link to this function

get_group(Client, ApplicationId, GroupName, IndexId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

get_index(Client, ApplicationId, IndexId)

View Source
Gets information about an existing Amazon Q index.
Link to this function

get_index(Client, ApplicationId, IndexId, QueryMap, HeadersMap)

View Source
Link to this function

get_index(Client, ApplicationId, IndexId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

get_plugin(Client, ApplicationId, PluginId)

View Source
Gets information about an existing Amazon Q plugin.
Link to this function

get_plugin(Client, ApplicationId, PluginId, QueryMap, HeadersMap)

View Source
Link to this function

get_plugin(Client, ApplicationId, PluginId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

get_retriever(Client, ApplicationId, RetrieverId)

View Source
Gets information about an existing retriever used by an Amazon Q application.
Link to this function

get_retriever(Client, ApplicationId, RetrieverId, QueryMap, HeadersMap)

View Source
Link to this function

get_retriever(Client, ApplicationId, RetrieverId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

get_user(Client, ApplicationId, UserId)

View Source
Describes the universally unique identifier (UUID) associated with a local user in a data source.
Link to this function

get_user(Client, ApplicationId, UserId, QueryMap, HeadersMap)

View Source
Link to this function

get_user(Client, ApplicationId, UserId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

get_web_experience(Client, ApplicationId, WebExperienceId)

View Source
Gets information about an existing Amazon Q web experience.
Link to this function

get_web_experience(Client, ApplicationId, WebExperienceId, QueryMap, HeadersMap)

View Source
Link to this function

get_web_experience(Client, ApplicationId, WebExperienceId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_applications(Client)

View Source
Lists Amazon Q applications.
Link to this function

list_applications(Client, QueryMap, HeadersMap)

View Source
Link to this function

list_applications(Client, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_conversations(Client, ApplicationId, UserId)

View Source
Lists one or more Amazon Q conversations.
Link to this function

list_conversations(Client, ApplicationId, UserId, QueryMap, HeadersMap)

View Source
Link to this function

list_conversations(Client, ApplicationId, UserId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_data_source_sync_jobs(Client, ApplicationId, DataSourceId, IndexId)

View Source
Get information about an Amazon Q data source connector synchronization.
Link to this function

list_data_source_sync_jobs(Client, ApplicationId, DataSourceId, IndexId, QueryMap, HeadersMap)

View Source
Link to this function

list_data_source_sync_jobs(Client, ApplicationId, DataSourceId, IndexId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_data_sources(Client, ApplicationId, IndexId)

View Source
Lists the Amazon Q data source connectors that you have created.
Link to this function

list_data_sources(Client, ApplicationId, IndexId, QueryMap, HeadersMap)

View Source
Link to this function

list_data_sources(Client, ApplicationId, IndexId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_documents(Client, ApplicationId, IndexId)

View Source
A list of documents attached to an index.
Link to this function

list_documents(Client, ApplicationId, IndexId, QueryMap, HeadersMap)

View Source
Link to this function

list_documents(Client, ApplicationId, IndexId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_groups(Client, ApplicationId, IndexId, UpdatedEarlierThan)

View Source
Provides a list of groups that are mapped to users.
Link to this function

list_groups(Client, ApplicationId, IndexId, UpdatedEarlierThan, QueryMap, HeadersMap)

View Source
Link to this function

list_groups(Client, ApplicationId, IndexId, UpdatedEarlierThan, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_indices(Client, ApplicationId)

View Source
Lists the Amazon Q indices you have created.
Link to this function

list_indices(Client, ApplicationId, QueryMap, HeadersMap)

View Source
Link to this function

list_indices(Client, ApplicationId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_messages(Client, ApplicationId, ConversationId, UserId)

View Source
Gets a list of messages associated with an Amazon Q web experience.
Link to this function

list_messages(Client, ApplicationId, ConversationId, UserId, QueryMap, HeadersMap)

View Source
Link to this function

list_messages(Client, ApplicationId, ConversationId, UserId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_plugins(Client, ApplicationId)

View Source
Lists configured Amazon Q plugins.
Link to this function

list_plugins(Client, ApplicationId, QueryMap, HeadersMap)

View Source
Link to this function

list_plugins(Client, ApplicationId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_retrievers(Client, ApplicationId)

View Source
Lists the retriever used by an Amazon Q application.
Link to this function

list_retrievers(Client, ApplicationId, QueryMap, HeadersMap)

View Source
Link to this function

list_retrievers(Client, ApplicationId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_tags_for_resource(Client, ResourceARN)

View Source

Gets a list of tags associated with a specified resource.

Amazon Q applications and data sources can have tags associated with them.
Link to this function

list_tags_for_resource(Client, ResourceARN, QueryMap, HeadersMap)

View Source
Link to this function

list_tags_for_resource(Client, ResourceARN, QueryMap, HeadersMap, Options0)

View Source
Link to this function

list_web_experiences(Client, ApplicationId)

View Source
Lists one or more Amazon Q Web Experiences.
Link to this function

list_web_experiences(Client, ApplicationId, QueryMap, HeadersMap)

View Source
Link to this function

list_web_experiences(Client, ApplicationId, QueryMap, HeadersMap, Options0)

View Source
Link to this function

put_feedback(Client, ApplicationId, ConversationId, MessageId, Input)

View Source
Enables your end user to to provide feedback on their Amazon Q generated chat responses.
Link to this function

put_feedback(Client, ApplicationId, ConversationId, MessageId, Input0, Options0)

View Source
Link to this function

put_group(Client, ApplicationId, IndexId, Input)

View Source

Create, or updates, a mapping of users—who have access to a document—to groups.

You can also map sub groups to groups. For example, the group "Company Intellectual Property Teams" includes sub groups "Research" and "Engineering". These sub groups include their own list of users or people who work in these teams. Only users who work in research and engineering, and therefore belong in the intellectual property group, can see top-secret company documents in their Amazon Q chat results.
Link to this function

put_group(Client, ApplicationId, IndexId, Input0, Options0)

View Source
Link to this function

start_data_source_sync_job(Client, ApplicationId, DataSourceId, IndexId, Input)

View Source

Starts a data source connector synchronization job.

If a synchronization job is already in progress, Amazon Q returns a ConflictException.
Link to this function

start_data_source_sync_job(Client, ApplicationId, DataSourceId, IndexId, Input0, Options0)

View Source
Link to this function

stop_data_source_sync_job(Client, ApplicationId, DataSourceId, IndexId, Input)

View Source
Stops an Amazon Q data source connector synchronization job already in progress.
Link to this function

stop_data_source_sync_job(Client, ApplicationId, DataSourceId, IndexId, Input0, Options0)

View Source
Link to this function

tag_resource(Client, ResourceARN, Input)

View Source

Adds the specified tag to the specified Amazon Q application or data source resource.

If the tag already exists, the existing value is replaced with the new value.
Link to this function

tag_resource(Client, ResourceARN, Input0, Options0)

View Source
Link to this function

untag_resource(Client, ResourceARN, Input)

View Source
Removes a tag from an Amazon Q application or a data source.
Link to this function

untag_resource(Client, ResourceARN, Input0, Options0)

View Source
Link to this function

update_application(Client, ApplicationId, Input)

View Source
Updates an existing Amazon Q application.
Link to this function

update_application(Client, ApplicationId, Input0, Options0)

View Source
Link to this function

update_chat_controls_configuration(Client, ApplicationId, Input)

View Source
Updates an set of chat controls configured for an existing Amazon Q application.
Link to this function

update_chat_controls_configuration(Client, ApplicationId, Input0, Options0)

View Source
Link to this function

update_data_source(Client, ApplicationId, DataSourceId, IndexId, Input)

View Source
Updates an existing Amazon Q data source connector.
Link to this function

update_data_source(Client, ApplicationId, DataSourceId, IndexId, Input0, Options0)

View Source
Link to this function

update_index(Client, ApplicationId, IndexId, Input)

View Source
Updates an Amazon Q index.
Link to this function

update_index(Client, ApplicationId, IndexId, Input0, Options0)

View Source
Link to this function

update_plugin(Client, ApplicationId, PluginId, Input)

View Source
Updates an Amazon Q plugin.
Link to this function

update_plugin(Client, ApplicationId, PluginId, Input0, Options0)

View Source
Link to this function

update_retriever(Client, ApplicationId, RetrieverId, Input)

View Source
Updates the retriever used for your Amazon Q application.
Link to this function

update_retriever(Client, ApplicationId, RetrieverId, Input0, Options0)

View Source
Link to this function

update_user(Client, ApplicationId, UserId, Input)

View Source
Updates a information associated with a user id.
Link to this function

update_user(Client, ApplicationId, UserId, Input0, Options0)

View Source
Link to this function

update_web_experience(Client, ApplicationId, WebExperienceId, Input)

View Source
Updates an Amazon Q web experience.
Link to this function

update_web_experience(Client, ApplicationId, WebExperienceId, Input0, Options0)

View Source