@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AWSQAppsClient extends AmazonWebServiceClient implements AWSQApps
The Amazon Q Apps feature capability within Amazon Q Business allows web experience users to create lightweight, purpose-built AI apps to fulfill specific tasks from within their web experience. For example, users can create an Q Appthat exclusively generates marketing-related content to improve your marketing team's productivity or a Q App for marketing content-generation like writing customer emails and creating promotional content using a certain style of voice, tone, and branding. For more information, see Amazon Q App in the Amazon Q Business User Guide.
LOGGING_AWS_REQUEST_METRICENDPOINT_PREFIX| Modifier and Type | Method and Description |
|---|---|
AssociateLibraryItemReviewResult |
associateLibraryItemReview(AssociateLibraryItemReviewRequest request)
Associates a rating or review for a library item with the user submitting the request.
|
AssociateQAppWithUserResult |
associateQAppWithUser(AssociateQAppWithUserRequest request)
This operation creates a link between the user's identity calling the operation and a specific Q App.
|
static AWSQAppsClientBuilder |
builder() |
CreateLibraryItemResult |
createLibraryItem(CreateLibraryItemRequest request)
Creates a new library item for an Amazon Q App, allowing it to be discovered and used by other allowed users.
|
CreateQAppResult |
createQApp(CreateQAppRequest request)
Creates a new Amazon Q App based on the provided definition.
|
DeleteLibraryItemResult |
deleteLibraryItem(DeleteLibraryItemRequest request)
Deletes a library item for an Amazon Q App, removing it from the library so it can no longer be discovered or
used by other users.
|
DeleteQAppResult |
deleteQApp(DeleteQAppRequest request)
Deletes an Amazon Q App owned by the user.
|
DisassociateLibraryItemReviewResult |
disassociateLibraryItemReview(DisassociateLibraryItemReviewRequest request)
Removes a rating or review previously submitted by the user for a library item.
|
DisassociateQAppFromUserResult |
disassociateQAppFromUser(DisassociateQAppFromUserRequest request)
Disassociates a Q App from a user removing the user's access to run the Q App.
|
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful, request, typically used for debugging issues
where a service isn't acting as expected.
|
GetLibraryItemResult |
getLibraryItem(GetLibraryItemRequest request)
Retrieves details about a library item for an Amazon Q App, including its metadata, categories, ratings, and
usage statistics.
|
GetQAppResult |
getQApp(GetQAppRequest request)
Retrieves the full details of an Q App, including its definition specifying the cards and flow.
|
GetQAppSessionResult |
getQAppSession(GetQAppSessionRequest request)
Retrieves the current state and results for an active session of an Amazon Q App.
|
ImportDocumentResult |
importDocument(ImportDocumentRequest request)
Uploads a file that can then be used either as a default in a
FileUploadCard from Q App definition
or as a file that is used inside a single Q App run. |
ListLibraryItemsResult |
listLibraryItems(ListLibraryItemsRequest request)
Lists the library items for Amazon Q Apps that are published and available for users in your Amazon Web Services
account.
|
ListQAppsResult |
listQApps(ListQAppsRequest request)
Lists the Amazon Q Apps owned by or associated with the user either because they created it or because they used
it from the library in the past.
|
ListTagsForResourceResult |
listTagsForResource(ListTagsForResourceRequest request)
Lists the tags associated with an Amazon Q Apps resource.
|
PredictQAppResult |
predictQApp(PredictQAppRequest request)
Generates an Amazon Q App definition based on either a conversation or a problem statement provided as input.The
resulting app definition can be used to call
CreateQApp. |
void |
shutdown()
Shuts down this client object, releasing any resources that might be held
open.
|
StartQAppSessionResult |
startQAppSession(StartQAppSessionRequest request)
Starts a new session for an Amazon Q App, allowing inputs to be provided and the app to be run.
|
StopQAppSessionResult |
stopQAppSession(StopQAppSessionRequest request)
Stops an active session for an Amazon Q App.This deletes all data related to the session and makes it invalid for
future uses.
|
TagResourceResult |
tagResource(TagResourceRequest request)
Associates tags with an Amazon Q Apps resource.
|
UntagResourceResult |
untagResource(UntagResourceRequest request)
Disassociates tags from an Amazon Q Apps resource.
|
UpdateLibraryItemResult |
updateLibraryItem(UpdateLibraryItemRequest request)
Updates the metadata and status of a library item for an Amazon Q App.
|
UpdateQAppResult |
updateQApp(UpdateQAppRequest request)
Updates an existing Amazon Q App, allowing modifications to its title, description, and definition.
|
UpdateQAppSessionResult |
updateQAppSession(UpdateQAppSessionRequest request)
Updates the session for a given Q App
sessionId. |
addRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffsetpublic static AWSQAppsClientBuilder builder()
public AssociateLibraryItemReviewResult associateLibraryItemReview(AssociateLibraryItemReviewRequest request)
Associates a rating or review for a library item with the user submitting the request. This increments the rating count for the specified library item.
associateLibraryItemReview in interface AWSQAppsassociateLibraryItemReviewRequest - ResourceNotFoundException - The requested resource could not be found.AccessDeniedException - The client is not authorized to perform the requested operation.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.UnauthorizedException - The client is not authenticated or authorized to perform the requested operation.ServiceQuotaExceededException - The requested operation could not be completed because it would exceed the service's quota or limit.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public AssociateQAppWithUserResult associateQAppWithUser(AssociateQAppWithUserRequest request)
This operation creates a link between the user's identity calling the operation and a specific Q App. This is useful to mark the Q App as a favorite for the user if the user doesn't own the Amazon Q App so they can still run it and see it in their inventory of Q Apps.
associateQAppWithUser in interface AWSQAppsassociateQAppWithUserRequest - ResourceNotFoundException - The requested resource could not be found.AccessDeniedException - The client is not authorized to perform the requested operation.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.UnauthorizedException - The client is not authenticated or authorized to perform the requested operation.ServiceQuotaExceededException - The requested operation could not be completed because it would exceed the service's quota or limit.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public CreateLibraryItemResult createLibraryItem(CreateLibraryItemRequest request)
Creates a new library item for an Amazon Q App, allowing it to be discovered and used by other allowed users.
createLibraryItem in interface AWSQAppscreateLibraryItemRequest - ResourceNotFoundException - The requested resource could not be found.AccessDeniedException - The client is not authorized to perform the requested operation.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.UnauthorizedException - The client is not authenticated or authorized to perform the requested operation.ServiceQuotaExceededException - The requested operation could not be completed because it would exceed the service's quota or limit.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public CreateQAppResult createQApp(CreateQAppRequest request)
Creates a new Amazon Q App based on the provided definition. The Q App definition specifies the cards and flow of the Q App. This operation also calculates the dependencies between the cards by inspecting the references in the prompts.
createQApp in interface AWSQAppscreateQAppRequest - AccessDeniedException - The client is not authorized to perform the requested operation.ConflictException - The requested operation could not be completed due to a conflict with the current state of the resource.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.UnauthorizedException - The client is not authenticated or authorized to perform the requested operation.ServiceQuotaExceededException - The requested operation could not be completed because it would exceed the service's quota or limit.ContentTooLargeException - The requested operation could not be completed because the content exceeds the maximum allowed size.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public DeleteLibraryItemResult deleteLibraryItem(DeleteLibraryItemRequest request)
Deletes a library item for an Amazon Q App, removing it from the library so it can no longer be discovered or used by other users.
deleteLibraryItem in interface AWSQAppsdeleteLibraryItemRequest - ResourceNotFoundException - The requested resource could not be found.AccessDeniedException - The client is not authorized to perform the requested operation.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.UnauthorizedException - The client is not authenticated or authorized to perform the requested operation.ServiceQuotaExceededException - The requested operation could not be completed because it would exceed the service's quota or limit.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public DeleteQAppResult deleteQApp(DeleteQAppRequest request)
Deletes an Amazon Q App owned by the user. If the Q App was previously published to the library, it is also removed from the library.
deleteQApp in interface AWSQAppsdeleteQAppRequest - ResourceNotFoundException - The requested resource could not be found.AccessDeniedException - The client is not authorized to perform the requested operation.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.UnauthorizedException - The client is not authenticated or authorized to perform the requested operation.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public DisassociateLibraryItemReviewResult disassociateLibraryItemReview(DisassociateLibraryItemReviewRequest request)
Removes a rating or review previously submitted by the user for a library item.
disassociateLibraryItemReview in interface AWSQAppsdisassociateLibraryItemReviewRequest - ResourceNotFoundException - The requested resource could not be found.AccessDeniedException - The client is not authorized to perform the requested operation.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.UnauthorizedException - The client is not authenticated or authorized to perform the requested operation.ServiceQuotaExceededException - The requested operation could not be completed because it would exceed the service's quota or limit.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public DisassociateQAppFromUserResult disassociateQAppFromUser(DisassociateQAppFromUserRequest request)
Disassociates a Q App from a user removing the user's access to run the Q App.
disassociateQAppFromUser in interface AWSQAppsdisassociateQAppFromUserRequest - ResourceNotFoundException - The requested resource could not be found.AccessDeniedException - The client is not authorized to perform the requested operation.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.UnauthorizedException - The client is not authenticated or authorized to perform the requested operation.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public GetLibraryItemResult getLibraryItem(GetLibraryItemRequest request)
Retrieves details about a library item for an Amazon Q App, including its metadata, categories, ratings, and usage statistics.
getLibraryItem in interface AWSQAppsgetLibraryItemRequest - ResourceNotFoundException - The requested resource could not be found.AccessDeniedException - The client is not authorized to perform the requested operation.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.UnauthorizedException - The client is not authenticated or authorized to perform the requested operation.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public GetQAppResult getQApp(GetQAppRequest request)
Retrieves the full details of an Q App, including its definition specifying the cards and flow.
getQApp in interface AWSQAppsgetQAppRequest - ResourceNotFoundException - The requested resource could not be found.AccessDeniedException - The client is not authorized to perform the requested operation.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.UnauthorizedException - The client is not authenticated or authorized to perform the requested operation.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public GetQAppSessionResult getQAppSession(GetQAppSessionRequest request)
Retrieves the current state and results for an active session of an Amazon Q App.
getQAppSession in interface AWSQAppsgetQAppSessionRequest - ResourceNotFoundException - The requested resource could not be found.AccessDeniedException - The client is not authorized to perform the requested operation.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.UnauthorizedException - The client is not authenticated or authorized to perform the requested operation.ServiceQuotaExceededException - The requested operation could not be completed because it would exceed the service's quota or limit.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public ImportDocumentResult importDocument(ImportDocumentRequest request)
Uploads a file that can then be used either as a default in a FileUploadCard from Q App definition
or as a file that is used inside a single Q App run. The purpose of the document is determined by a scope
parameter that indicates whether it is at the app definition level or at the app session level.
importDocument in interface AWSQAppsimportDocumentRequest - ResourceNotFoundException - The requested resource could not be found.AccessDeniedException - The client is not authorized to perform the requested operation.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.UnauthorizedException - The client is not authenticated or authorized to perform the requested operation.ServiceQuotaExceededException - The requested operation could not be completed because it would exceed the service's quota or limit.ContentTooLargeException - The requested operation could not be completed because the content exceeds the maximum allowed size.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public ListLibraryItemsResult listLibraryItems(ListLibraryItemsRequest request)
Lists the library items for Amazon Q Apps that are published and available for users in your Amazon Web Services account.
listLibraryItems in interface AWSQAppslistLibraryItemsRequest - ResourceNotFoundException - The requested resource could not be found.AccessDeniedException - The client is not authorized to perform the requested operation.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.UnauthorizedException - The client is not authenticated or authorized to perform the requested operation.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public ListQAppsResult listQApps(ListQAppsRequest request)
Lists the Amazon Q Apps owned by or associated with the user either because they created it or because they used it from the library in the past. The user identity is extracted from the credentials used to invoke this operation..
listQApps in interface AWSQAppslistQAppsRequest - AccessDeniedException - The client is not authorized to perform the requested operation.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.UnauthorizedException - The client is not authenticated or authorized to perform the requested operation.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)
Lists the tags associated with an Amazon Q Apps resource.
listTagsForResource in interface AWSQAppslistTagsForResourceRequest - ResourceNotFoundException - The requested resource could not be found.AccessDeniedException - The client is not authorized to perform the requested operation.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public PredictQAppResult predictQApp(PredictQAppRequest request)
Generates an Amazon Q App definition based on either a conversation or a problem statement provided as input.The
resulting app definition can be used to call CreateQApp. This API doesn't create Amazon Q Apps
directly.
predictQApp in interface AWSQAppspredictQAppRequest - AccessDeniedException - The client is not authorized to perform the requested operation.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.UnauthorizedException - The client is not authenticated or authorized to perform the requested operation.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public StartQAppSessionResult startQAppSession(StartQAppSessionRequest request)
Starts a new session for an Amazon Q App, allowing inputs to be provided and the app to be run.
Each Q App session will be condensed into a single conversation in the web experience.
startQAppSession in interface AWSQAppsstartQAppSessionRequest - ResourceNotFoundException - The requested resource could not be found.AccessDeniedException - The client is not authorized to perform the requested operation.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.UnauthorizedException - The client is not authenticated or authorized to perform the requested operation.ServiceQuotaExceededException - The requested operation could not be completed because it would exceed the service's quota or limit.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public StopQAppSessionResult stopQAppSession(StopQAppSessionRequest request)
Stops an active session for an Amazon Q App.This deletes all data related to the session and makes it invalid for future uses. The results of the session will be persisted as part of the conversation.
stopQAppSession in interface AWSQAppsstopQAppSessionRequest - ResourceNotFoundException - The requested resource could not be found.AccessDeniedException - The client is not authorized to perform the requested operation.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.UnauthorizedException - The client is not authenticated or authorized to perform the requested operation.ServiceQuotaExceededException - The requested operation could not be completed because it would exceed the service's quota or limit.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public TagResourceResult tagResource(TagResourceRequest request)
Associates tags with an Amazon Q Apps resource.
tagResource in interface AWSQAppstagResourceRequest - ResourceNotFoundException - The requested resource could not be found.AccessDeniedException - The client is not authorized to perform the requested operation.ConflictException - The requested operation could not be completed due to a conflict with the current state of the resource.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public UntagResourceResult untagResource(UntagResourceRequest request)
Disassociates tags from an Amazon Q Apps resource.
untagResource in interface AWSQAppsuntagResourceRequest - ResourceNotFoundException - The requested resource could not be found.AccessDeniedException - The client is not authorized to perform the requested operation.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public UpdateLibraryItemResult updateLibraryItem(UpdateLibraryItemRequest request)
Updates the metadata and status of a library item for an Amazon Q App.
updateLibraryItem in interface AWSQAppsupdateLibraryItemRequest - ResourceNotFoundException - The requested resource could not be found.AccessDeniedException - The client is not authorized to perform the requested operation.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.UnauthorizedException - The client is not authenticated or authorized to perform the requested operation.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public UpdateQAppResult updateQApp(UpdateQAppRequest request)
Updates an existing Amazon Q App, allowing modifications to its title, description, and definition.
updateQApp in interface AWSQAppsupdateQAppRequest - ResourceNotFoundException - The requested resource could not be found.AccessDeniedException - The client is not authorized to perform the requested operation.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.UnauthorizedException - The client is not authenticated or authorized to perform the requested operation.ContentTooLargeException - The requested operation could not be completed because the content exceeds the maximum allowed size.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public UpdateQAppSessionResult updateQAppSession(UpdateQAppSessionRequest request)
Updates the session for a given Q App sessionId. This is only valid when at least one card of the
session is in the WAITING state. Data for each WAITING card can be provided as input.
If inputs are not provided, the call will be accepted but session will not move forward. Inputs for cards that
are not in the WAITING status will be ignored.
updateQAppSession in interface AWSQAppsupdateQAppSessionRequest - ResourceNotFoundException - The requested resource could not be found.AccessDeniedException - The client is not authorized to perform the requested operation.ValidationException - The input failed to satisfy the constraints specified by the service.InternalServerException - An internal service error occurred while processing the request.UnauthorizedException - The client is not authenticated or authorized to perform the requested operation.ServiceQuotaExceededException - The requested operation could not be completed because it would exceed the service's quota or limit.ThrottlingException - The requested operation could not be completed because too many requests were sent at once. Wait a bit
and try again later.public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing the request.
getCachedResponseMetadata in interface AWSQAppsrequest - The originally executed requestpublic void shutdown()
AmazonWebServiceClientshutdown in interface AWSQAppsshutdown in class AmazonWebServiceClient