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.
Creates an Amazon Q index.
Deletes an Amazon Q data source connector.
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.
Gets a list of tags associated with a specified resource.
Create, or updates, a mapping of users—who have access to a document—to groups.
Starts a data source connector synchronization job.
Adds the specified tag to the specified Amazon Q application or data source resource.
Functions
Asynchronously deletes one or more documents added using the BatchPutDocument
API from an Amazon Q index.
batch_delete_document(Client, ApplicationId, IndexId, Input0, Options0)
View SourceAdds 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.
batch_put_document(Client, ApplicationId, IndexId, Input0, Options0)
View SourceCreates 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.
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.
delete_chat_controls_configuration(Client, ApplicationId, Input0, Options0)
View Sourcedelete_conversation(Client, ApplicationId, ConversationId, Input0, Options0)
View Sourcedelete_data_source(Client, ApplicationId, DataSourceId, IndexId, Input)
View SourceDeletes an Amazon Q data source connector.
While the data source is being deleted, theStatus
field returned by a call to the DescribeDataSource
API is set to DELETING
.
delete_data_source(Client, ApplicationId, DataSourceId, IndexId, Input0, Options0)
View SourceDeletes 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 thePutGroup
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
.
delete_group(Client, ApplicationId, GroupName, IndexId, Input0, Options0)
View Sourcedelete_retriever(Client, ApplicationId, RetrieverId, Input0, Options0)
View Sourcedelete_web_experience(Client, ApplicationId, WebExperienceId, Input)
View Sourcedelete_web_experience(Client, ApplicationId, WebExperienceId, Input0, Options0)
View Sourceget_application(Client, ApplicationId, QueryMap, HeadersMap, Options0)
View Sourceget_chat_controls_configuration(Client, ApplicationId, QueryMap, HeadersMap)
View Sourceget_chat_controls_configuration(Client, ApplicationId, QueryMap, HeadersMap, Options0)
View Sourceget_data_source(Client, ApplicationId, DataSourceId, IndexId, QueryMap, HeadersMap)
View Sourceget_data_source(Client, ApplicationId, DataSourceId, IndexId, QueryMap, HeadersMap, Options0)
View Sourceget_group(Client, ApplicationId, GroupName, IndexId, QueryMap, HeadersMap)
View Sourceget_group(Client, ApplicationId, GroupName, IndexId, QueryMap, HeadersMap, Options0)
View Sourceget_index(Client, ApplicationId, IndexId, QueryMap, HeadersMap, Options0)
View Sourceget_plugin(Client, ApplicationId, PluginId, QueryMap, HeadersMap, Options0)
View Sourceget_retriever(Client, ApplicationId, RetrieverId, QueryMap, HeadersMap)
View Sourceget_retriever(Client, ApplicationId, RetrieverId, QueryMap, HeadersMap, Options0)
View Sourceget_user(Client, ApplicationId, UserId, QueryMap, HeadersMap, Options0)
View Sourceget_web_experience(Client, ApplicationId, WebExperienceId, QueryMap, HeadersMap)
View Sourceget_web_experience(Client, ApplicationId, WebExperienceId, QueryMap, HeadersMap, Options0)
View Sourcelist_conversations(Client, ApplicationId, UserId, QueryMap, HeadersMap)
View Sourcelist_conversations(Client, ApplicationId, UserId, QueryMap, HeadersMap, Options0)
View Sourcelist_data_source_sync_jobs(Client, ApplicationId, DataSourceId, IndexId)
View Sourcelist_data_source_sync_jobs(Client, ApplicationId, DataSourceId, IndexId, QueryMap, HeadersMap)
View Sourcelist_data_source_sync_jobs(Client, ApplicationId, DataSourceId, IndexId, QueryMap, HeadersMap, Options0)
View Sourcelist_data_sources(Client, ApplicationId, IndexId, QueryMap, HeadersMap)
View Sourcelist_data_sources(Client, ApplicationId, IndexId, QueryMap, HeadersMap, Options0)
View Sourcelist_documents(Client, ApplicationId, IndexId, QueryMap, HeadersMap)
View Sourcelist_documents(Client, ApplicationId, IndexId, QueryMap, HeadersMap, Options0)
View Sourcelist_groups(Client, ApplicationId, IndexId, UpdatedEarlierThan, QueryMap, HeadersMap)
View Sourcelist_groups(Client, ApplicationId, IndexId, UpdatedEarlierThan, QueryMap, HeadersMap, Options0)
View Sourcelist_indices(Client, ApplicationId, QueryMap, HeadersMap, Options0)
View Sourcelist_messages(Client, ApplicationId, ConversationId, UserId, QueryMap, HeadersMap)
View Sourcelist_messages(Client, ApplicationId, ConversationId, UserId, QueryMap, HeadersMap, Options0)
View Sourcelist_plugins(Client, ApplicationId, QueryMap, HeadersMap, Options0)
View Sourcelist_retrievers(Client, ApplicationId, QueryMap, HeadersMap, Options0)
View SourceGets a list of tags associated with a specified resource.
Amazon Q applications and data sources can have tags associated with them.list_tags_for_resource(Client, ResourceARN, QueryMap, HeadersMap, Options0)
View Sourcelist_web_experiences(Client, ApplicationId, QueryMap, HeadersMap, Options0)
View Sourceput_feedback(Client, ApplicationId, ConversationId, MessageId, Input)
View Sourceput_feedback(Client, ApplicationId, ConversationId, MessageId, Input0, Options0)
View SourceCreate, 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.start_data_source_sync_job(Client, ApplicationId, DataSourceId, IndexId, Input)
View SourceStarts a data source connector synchronization job.
If a synchronization job is already in progress, Amazon Q returns aConflictException
.
start_data_source_sync_job(Client, ApplicationId, DataSourceId, IndexId, Input0, Options0)
View Sourcestop_data_source_sync_job(Client, ApplicationId, DataSourceId, IndexId, Input)
View Sourcestop_data_source_sync_job(Client, ApplicationId, DataSourceId, IndexId, Input0, Options0)
View SourceAdds 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.