Skip to content

QAppsClient#

Index > QApps > QAppsClient

Auto-generated documentation for QApps type annotations stubs module mypy-boto3-qapps.

QAppsClient#

Type annotations and code completion for boto3.client("qapps"). boto3 documentation

# QAppsClient usage example

from boto3.session import Session
from mypy_boto3_qapps.client import QAppsClient

def get_qapps_client() -> QAppsClient:
    return Session().client("qapps")

Exceptions#

boto3 client exceptions are generated in runtime. This class provides code completion for boto3.client("qapps").exceptions structure.

# Exceptions.exceptions usage example

client = boto3.client("qapps")

try:
    do_something(client)
except (
    client.exceptions.AccessDeniedException,
    client.exceptions.ClientError,
    client.exceptions.ConflictException,
    client.exceptions.ContentTooLargeException,
    client.exceptions.InternalServerException,
    client.exceptions.ResourceNotFoundException,
    client.exceptions.ServiceQuotaExceededException,
    client.exceptions.ThrottlingException,
    client.exceptions.UnauthorizedException,
    client.exceptions.ValidationException,
) as e:
    print(e)
# Exceptions.exceptions type checking example

from mypy_boto3_qapps.client import Exceptions

def handle_error(exc: Exceptions.AccessDeniedException) -> None:
    ...

Methods#

associate_library_item_review#

Associates a rating or review for a library item with the user submitting the request.

Type annotations and code completion for boto3.client("qapps").associate_library_item_review method. boto3 documentation

# associate_library_item_review method definition

def associate_library_item_review(
    self,
    *,
    instanceId: str,
    libraryItemId: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
# associate_library_item_review method usage example with argument unpacking

kwargs: AssociateLibraryItemReviewInputRequestTypeDef = {  # (1)
    "instanceId": ...,
    "libraryItemId": ...,
}

parent.associate_library_item_review(**kwargs)
  1. See AssociateLibraryItemReviewInputRequestTypeDef

associate_q_app_with_user#

This operation creates a link between the user's identity calling the operation and a specific Q App.

Type annotations and code completion for boto3.client("qapps").associate_q_app_with_user method. boto3 documentation

# associate_q_app_with_user method definition

def associate_q_app_with_user(
    self,
    *,
    instanceId: str,
    appId: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
# associate_q_app_with_user method usage example with argument unpacking

kwargs: AssociateQAppWithUserInputRequestTypeDef = {  # (1)
    "instanceId": ...,
    "appId": ...,
}

parent.associate_q_app_with_user(**kwargs)
  1. See AssociateQAppWithUserInputRequestTypeDef

batch_create_category#

Creates Categories for the Amazon Q Business application environment instance.

Type annotations and code completion for boto3.client("qapps").batch_create_category method. boto3 documentation

# batch_create_category method definition

def batch_create_category(
    self,
    *,
    instanceId: str,
    categories: Sequence[BatchCreateCategoryInputCategoryTypeDef],  # (1)
) -> EmptyResponseMetadataTypeDef:  # (2)
    ...
  1. See BatchCreateCategoryInputCategoryTypeDef
  2. See EmptyResponseMetadataTypeDef
# batch_create_category method usage example with argument unpacking

kwargs: BatchCreateCategoryInputRequestTypeDef = {  # (1)
    "instanceId": ...,
    "categories": ...,
}

parent.batch_create_category(**kwargs)
  1. See BatchCreateCategoryInputRequestTypeDef

batch_delete_category#

Deletes Categories for the Amazon Q Business application environment instance.

Type annotations and code completion for boto3.client("qapps").batch_delete_category method. boto3 documentation

# batch_delete_category method definition

def batch_delete_category(
    self,
    *,
    instanceId: str,
    categories: Sequence[str],
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
# batch_delete_category method usage example with argument unpacking

kwargs: BatchDeleteCategoryInputRequestTypeDef = {  # (1)
    "instanceId": ...,
    "categories": ...,
}

parent.batch_delete_category(**kwargs)
  1. See BatchDeleteCategoryInputRequestTypeDef

batch_update_category#

Updates Categories for the Amazon Q Business application environment instance.

Type annotations and code completion for boto3.client("qapps").batch_update_category method. boto3 documentation

# batch_update_category method definition

def batch_update_category(
    self,
    *,
    instanceId: str,
    categories: Sequence[CategoryInputTypeDef],  # (1)
) -> EmptyResponseMetadataTypeDef:  # (2)
    ...
  1. See CategoryInputTypeDef
  2. See EmptyResponseMetadataTypeDef
# batch_update_category method usage example with argument unpacking

kwargs: BatchUpdateCategoryInputRequestTypeDef = {  # (1)
    "instanceId": ...,
    "categories": ...,
}

parent.batch_update_category(**kwargs)
  1. See BatchUpdateCategoryInputRequestTypeDef

can_paginate#

Check if an operation can be paginated.

Type annotations and code completion for boto3.client("qapps").can_paginate method. boto3 documentation

# can_paginate method definition

def can_paginate(
    self,
    operation_name: str,
) -> bool:
    ...

close#

Closes underlying endpoint connections.

Type annotations and code completion for boto3.client("qapps").close method. boto3 documentation

# close method definition

def close(
    self,
) -> None:
    ...

create_library_item#

Creates a new library item for an Amazon Q App, allowing it to be discovered and used by other allowed users.

Type annotations and code completion for boto3.client("qapps").create_library_item method. boto3 documentation

# create_library_item method definition

def create_library_item(
    self,
    *,
    instanceId: str,
    appId: str,
    appVersion: int,
    categories: Sequence[str],
) -> CreateLibraryItemOutputTypeDef:  # (1)
    ...
  1. See CreateLibraryItemOutputTypeDef
# create_library_item method usage example with argument unpacking

kwargs: CreateLibraryItemInputRequestTypeDef = {  # (1)
    "instanceId": ...,
    "appId": ...,
    "appVersion": ...,
    "categories": ...,
}

parent.create_library_item(**kwargs)
  1. See CreateLibraryItemInputRequestTypeDef

create_q_app#

Creates a new Amazon Q App based on the provided definition.

Type annotations and code completion for boto3.client("qapps").create_q_app method. boto3 documentation

# create_q_app method definition

def create_q_app(
    self,
    *,
    instanceId: str,
    title: str,
    appDefinition: AppDefinitionInputTypeDef,  # (1)
    description: str = ...,
    tags: Mapping[str, str] = ...,
) -> CreateQAppOutputTypeDef:  # (2)
    ...
  1. See AppDefinitionInputTypeDef
  2. See CreateQAppOutputTypeDef
# create_q_app method usage example with argument unpacking

kwargs: CreateQAppInputRequestTypeDef = {  # (1)
    "instanceId": ...,
    "title": ...,
    "appDefinition": ...,
}

parent.create_q_app(**kwargs)
  1. See CreateQAppInputRequestTypeDef

delete_library_item#

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.

Type annotations and code completion for boto3.client("qapps").delete_library_item method. boto3 documentation

# delete_library_item method definition

def delete_library_item(
    self,
    *,
    instanceId: str,
    libraryItemId: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
# delete_library_item method usage example with argument unpacking

kwargs: DeleteLibraryItemInputRequestTypeDef = {  # (1)
    "instanceId": ...,
    "libraryItemId": ...,
}

parent.delete_library_item(**kwargs)
  1. See DeleteLibraryItemInputRequestTypeDef

delete_q_app#

Deletes an Amazon Q App owned by the user.

Type annotations and code completion for boto3.client("qapps").delete_q_app method. boto3 documentation

# delete_q_app method definition

def delete_q_app(
    self,
    *,
    instanceId: str,
    appId: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
# delete_q_app method usage example with argument unpacking

kwargs: DeleteQAppInputRequestTypeDef = {  # (1)
    "instanceId": ...,
    "appId": ...,
}

parent.delete_q_app(**kwargs)
  1. See DeleteQAppInputRequestTypeDef

disassociate_library_item_review#

Removes a rating or review previously submitted by the user for a library item.

Type annotations and code completion for boto3.client("qapps").disassociate_library_item_review method. boto3 documentation

# disassociate_library_item_review method definition

def disassociate_library_item_review(
    self,
    *,
    instanceId: str,
    libraryItemId: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
# disassociate_library_item_review method usage example with argument unpacking

kwargs: DisassociateLibraryItemReviewInputRequestTypeDef = {  # (1)
    "instanceId": ...,
    "libraryItemId": ...,
}

parent.disassociate_library_item_review(**kwargs)
  1. See DisassociateLibraryItemReviewInputRequestTypeDef

disassociate_q_app_from_user#

Disassociates a Q App from a user removing the user's access to run the Q App.

Type annotations and code completion for boto3.client("qapps").disassociate_q_app_from_user method. boto3 documentation

# disassociate_q_app_from_user method definition

def disassociate_q_app_from_user(
    self,
    *,
    instanceId: str,
    appId: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
# disassociate_q_app_from_user method usage example with argument unpacking

kwargs: DisassociateQAppFromUserInputRequestTypeDef = {  # (1)
    "instanceId": ...,
    "appId": ...,
}

parent.disassociate_q_app_from_user(**kwargs)
  1. See DisassociateQAppFromUserInputRequestTypeDef

generate_presigned_url#

Generate a presigned url given a client, its method, and arguments.

Type annotations and code completion for boto3.client("qapps").generate_presigned_url method. boto3 documentation

# generate_presigned_url method definition

def generate_presigned_url(
    self,
    ClientMethod: str,
    Params: Mapping[str, Any] = ...,
    ExpiresIn: int = 3600,
    HttpMethod: str = ...,
) -> str:
    ...

get_library_item#

Retrieves details about a library item for an Amazon Q App, including its metadata, categories, ratings, and usage statistics.

Type annotations and code completion for boto3.client("qapps").get_library_item method. boto3 documentation

# get_library_item method definition

def get_library_item(
    self,
    *,
    instanceId: str,
    libraryItemId: str,
    appId: str = ...,
) -> GetLibraryItemOutputTypeDef:  # (1)
    ...
  1. See GetLibraryItemOutputTypeDef
# get_library_item method usage example with argument unpacking

kwargs: GetLibraryItemInputRequestTypeDef = {  # (1)
    "instanceId": ...,
    "libraryItemId": ...,
}

parent.get_library_item(**kwargs)
  1. See GetLibraryItemInputRequestTypeDef

get_q_app#

Retrieves the full details of an Q App, including its definition specifying the cards and flow.

Type annotations and code completion for boto3.client("qapps").get_q_app method. boto3 documentation

# get_q_app method definition

def get_q_app(
    self,
    *,
    instanceId: str,
    appId: str,
) -> GetQAppOutputTypeDef:  # (1)
    ...
  1. See GetQAppOutputTypeDef
# get_q_app method usage example with argument unpacking

kwargs: GetQAppInputRequestTypeDef = {  # (1)
    "instanceId": ...,
    "appId": ...,
}

parent.get_q_app(**kwargs)
  1. See GetQAppInputRequestTypeDef

get_q_app_session#

Retrieves the current state and results for an active session of an Amazon Q App.

Type annotations and code completion for boto3.client("qapps").get_q_app_session method. boto3 documentation

# get_q_app_session method definition

def get_q_app_session(
    self,
    *,
    instanceId: str,
    sessionId: str,
) -> GetQAppSessionOutputTypeDef:  # (1)
    ...
  1. See GetQAppSessionOutputTypeDef
# get_q_app_session method usage example with argument unpacking

kwargs: GetQAppSessionInputRequestTypeDef = {  # (1)
    "instanceId": ...,
    "sessionId": ...,
}

parent.get_q_app_session(**kwargs)
  1. See GetQAppSessionInputRequestTypeDef

import_document#

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.

Type annotations and code completion for boto3.client("qapps").import_document method. boto3 documentation

# import_document method definition

def import_document(
    self,
    *,
    instanceId: str,
    cardId: str,
    appId: str,
    fileContentsBase64: str,
    fileName: str,
    scope: DocumentScopeType,  # (1)
    sessionId: str = ...,
) -> ImportDocumentOutputTypeDef:  # (2)
    ...
  1. See DocumentScopeType
  2. See ImportDocumentOutputTypeDef
# import_document method usage example with argument unpacking

kwargs: ImportDocumentInputRequestTypeDef = {  # (1)
    "instanceId": ...,
    "cardId": ...,
    "appId": ...,
    "fileContentsBase64": ...,
    "fileName": ...,
    "scope": ...,
}

parent.import_document(**kwargs)
  1. See ImportDocumentInputRequestTypeDef

list_categories#

Lists the categories of a Amazon Q Business application environment instance.

Type annotations and code completion for boto3.client("qapps").list_categories method. boto3 documentation

# list_categories method definition

def list_categories(
    self,
    *,
    instanceId: str,
) -> ListCategoriesOutputTypeDef:  # (1)
    ...
  1. See ListCategoriesOutputTypeDef
# list_categories method usage example with argument unpacking

kwargs: ListCategoriesInputRequestTypeDef = {  # (1)
    "instanceId": ...,
}

parent.list_categories(**kwargs)
  1. See ListCategoriesInputRequestTypeDef

list_library_items#

Lists the library items for Amazon Q Apps that are published and available for users in your Amazon Web Services account.

Type annotations and code completion for boto3.client("qapps").list_library_items method. boto3 documentation

# list_library_items method definition

def list_library_items(
    self,
    *,
    instanceId: str,
    limit: int = ...,
    nextToken: str = ...,
    categoryId: str = ...,
) -> ListLibraryItemsOutputTypeDef:  # (1)
    ...
  1. See ListLibraryItemsOutputTypeDef
# list_library_items method usage example with argument unpacking

kwargs: ListLibraryItemsInputRequestTypeDef = {  # (1)
    "instanceId": ...,
}

parent.list_library_items(**kwargs)
  1. See ListLibraryItemsInputRequestTypeDef

list_q_apps#

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.

Type annotations and code completion for boto3.client("qapps").list_q_apps method. boto3 documentation

# list_q_apps method definition

def list_q_apps(
    self,
    *,
    instanceId: str,
    limit: int = ...,
    nextToken: str = ...,
) -> ListQAppsOutputTypeDef:  # (1)
    ...
  1. See ListQAppsOutputTypeDef
# list_q_apps method usage example with argument unpacking

kwargs: ListQAppsInputRequestTypeDef = {  # (1)
    "instanceId": ...,
}

parent.list_q_apps(**kwargs)
  1. See ListQAppsInputRequestTypeDef

list_tags_for_resource#

Lists the tags associated with an Amazon Q Apps resource.

Type annotations and code completion for boto3.client("qapps").list_tags_for_resource method. boto3 documentation

# list_tags_for_resource method definition

def list_tags_for_resource(
    self,
    *,
    resourceARN: str,
) -> ListTagsForResourceResponseTypeDef:  # (1)
    ...
  1. See ListTagsForResourceResponseTypeDef
# list_tags_for_resource method usage example with argument unpacking

kwargs: ListTagsForResourceRequestRequestTypeDef = {  # (1)
    "resourceARN": ...,
}

parent.list_tags_for_resource(**kwargs)
  1. See ListTagsForResourceRequestRequestTypeDef

predict_q_app#

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.

Type annotations and code completion for boto3.client("qapps").predict_q_app method. boto3 documentation

# predict_q_app method definition

def predict_q_app(
    self,
    *,
    instanceId: str,
    options: PredictQAppInputOptionsTypeDef = ...,  # (1)
) -> PredictQAppOutputTypeDef:  # (2)
    ...
  1. See PredictQAppInputOptionsTypeDef
  2. See PredictQAppOutputTypeDef
# predict_q_app method usage example with argument unpacking

kwargs: PredictQAppInputRequestTypeDef = {  # (1)
    "instanceId": ...,
}

parent.predict_q_app(**kwargs)
  1. See PredictQAppInputRequestTypeDef

start_q_app_session#

Starts a new session for an Amazon Q App, allowing inputs to be provided and the app to be run.

Type annotations and code completion for boto3.client("qapps").start_q_app_session method. boto3 documentation

# start_q_app_session method definition

def start_q_app_session(
    self,
    *,
    instanceId: str,
    appId: str,
    appVersion: int,
    initialValues: Sequence[CardValueTypeDef] = ...,  # (1)
    tags: Mapping[str, str] = ...,
) -> StartQAppSessionOutputTypeDef:  # (2)
    ...
  1. See CardValueTypeDef
  2. See StartQAppSessionOutputTypeDef
# start_q_app_session method usage example with argument unpacking

kwargs: StartQAppSessionInputRequestTypeDef = {  # (1)
    "instanceId": ...,
    "appId": ...,
    "appVersion": ...,
}

parent.start_q_app_session(**kwargs)
  1. See StartQAppSessionInputRequestTypeDef

stop_q_app_session#

Stops an active session for an Amazon Q App.This deletes all data related to the session and makes it invalid for future uses.

Type annotations and code completion for boto3.client("qapps").stop_q_app_session method. boto3 documentation

# stop_q_app_session method definition

def stop_q_app_session(
    self,
    *,
    instanceId: str,
    sessionId: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
# stop_q_app_session method usage example with argument unpacking

kwargs: StopQAppSessionInputRequestTypeDef = {  # (1)
    "instanceId": ...,
    "sessionId": ...,
}

parent.stop_q_app_session(**kwargs)
  1. See StopQAppSessionInputRequestTypeDef

tag_resource#

Associates tags with an Amazon Q Apps resource.

Type annotations and code completion for boto3.client("qapps").tag_resource method. boto3 documentation

# tag_resource method definition

def tag_resource(
    self,
    *,
    resourceARN: str,
    tags: Mapping[str, str],
) -> Dict[str, Any]:
    ...
# tag_resource method usage example with argument unpacking

kwargs: TagResourceRequestRequestTypeDef = {  # (1)
    "resourceARN": ...,
    "tags": ...,
}

parent.tag_resource(**kwargs)
  1. See TagResourceRequestRequestTypeDef

untag_resource#

Disassociates tags from an Amazon Q Apps resource.

Type annotations and code completion for boto3.client("qapps").untag_resource method. boto3 documentation

# untag_resource method definition

def untag_resource(
    self,
    *,
    resourceARN: str,
    tagKeys: Sequence[str],
) -> Dict[str, Any]:
    ...
# untag_resource method usage example with argument unpacking

kwargs: UntagResourceRequestRequestTypeDef = {  # (1)
    "resourceARN": ...,
    "tagKeys": ...,
}

parent.untag_resource(**kwargs)
  1. See UntagResourceRequestRequestTypeDef

update_library_item#

Updates the library item for an Amazon Q App.

Type annotations and code completion for boto3.client("qapps").update_library_item method. boto3 documentation

# update_library_item method definition

def update_library_item(
    self,
    *,
    instanceId: str,
    libraryItemId: str,
    status: LibraryItemStatusType = ...,  # (1)
    categories: Sequence[str] = ...,
) -> UpdateLibraryItemOutputTypeDef:  # (2)
    ...
  1. See LibraryItemStatusType
  2. See UpdateLibraryItemOutputTypeDef
# update_library_item method usage example with argument unpacking

kwargs: UpdateLibraryItemInputRequestTypeDef = {  # (1)
    "instanceId": ...,
    "libraryItemId": ...,
}

parent.update_library_item(**kwargs)
  1. See UpdateLibraryItemInputRequestTypeDef

update_library_item_metadata#

Updates the verification status of a library item for an Amazon Q App.

Type annotations and code completion for boto3.client("qapps").update_library_item_metadata method. boto3 documentation

# update_library_item_metadata method definition

def update_library_item_metadata(
    self,
    *,
    instanceId: str,
    libraryItemId: str,
    isVerified: bool = ...,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
# update_library_item_metadata method usage example with argument unpacking

kwargs: UpdateLibraryItemMetadataInputRequestTypeDef = {  # (1)
    "instanceId": ...,
    "libraryItemId": ...,
}

parent.update_library_item_metadata(**kwargs)
  1. See UpdateLibraryItemMetadataInputRequestTypeDef

update_q_app#

Updates an existing Amazon Q App, allowing modifications to its title, description, and definition.

Type annotations and code completion for boto3.client("qapps").update_q_app method. boto3 documentation

# update_q_app method definition

def update_q_app(
    self,
    *,
    instanceId: str,
    appId: str,
    title: str = ...,
    description: str = ...,
    appDefinition: AppDefinitionInputTypeDef = ...,  # (1)
) -> UpdateQAppOutputTypeDef:  # (2)
    ...
  1. See AppDefinitionInputTypeDef
  2. See UpdateQAppOutputTypeDef
# update_q_app method usage example with argument unpacking

kwargs: UpdateQAppInputRequestTypeDef = {  # (1)
    "instanceId": ...,
    "appId": ...,
}

parent.update_q_app(**kwargs)
  1. See UpdateQAppInputRequestTypeDef

update_q_app_session#

Updates the session for a given Q App sessionId.

Type annotations and code completion for boto3.client("qapps").update_q_app_session method. boto3 documentation

# update_q_app_session method definition

def update_q_app_session(
    self,
    *,
    instanceId: str,
    sessionId: str,
    values: Sequence[CardValueTypeDef] = ...,  # (1)
) -> UpdateQAppSessionOutputTypeDef:  # (2)
    ...
  1. See CardValueTypeDef
  2. See UpdateQAppSessionOutputTypeDef
# update_q_app_session method usage example with argument unpacking

kwargs: UpdateQAppSessionInputRequestTypeDef = {  # (1)
    "instanceId": ...,
    "sessionId": ...,
}

parent.update_q_app_session(**kwargs)
  1. See UpdateQAppSessionInputRequestTypeDef

get_paginator#

Type annotations and code completion for boto3.client("qapps").get_paginator method with overloads.