2024/09/06 - QApps - 1 new 5 updated api methods
Changes Adds UpdateLibraryItemMetadata api to change status of app for admin verification feature and returns isVerified field in any api returning the app or library item.
Updates the verification status of a library item for an Amazon Q App.
See also: AWS API Documentation
Request Syntax
client.update_library_item_metadata( instanceId='string', libraryItemId='string', isVerified=True|False )
string
[REQUIRED]
The unique identifier of the Amazon Q Business application environment instance.
string
[REQUIRED]
The unique identifier of the updated library item.
boolean
The verification status of the library item
None
{'isVerified': 'boolean'}
Creates a new library item for an Amazon Q App, allowing it to be discovered and used by other allowed users.
See also: AWS API Documentation
Request Syntax
client.create_library_item( instanceId='string', appId='string', appVersion=123, categories=[ 'string', ] )
string
[REQUIRED]
The unique identifier of the Amazon Q Business application environment instance.
string
[REQUIRED]
The unique identifier of the Amazon Q App to publish to the library.
integer
[REQUIRED]
The version of the Amazon Q App to publish to the library.
list
[REQUIRED]
The categories to associate with the library item for easier discovery.
(string) --
dict
Response Syntax
{ 'libraryItemId': 'string', 'status': 'string', 'createdAt': datetime(2015, 1, 1), 'createdBy': 'string', 'updatedAt': datetime(2015, 1, 1), 'updatedBy': 'string', 'ratingCount': 123, 'isVerified': True|False }
Response Structure
(dict) --
libraryItemId (string) --
The unique identifier of the new library item.
status (string) --
The status of the new library item, such as "Published".
createdAt (datetime) --
The date and time the library item was created.
createdBy (string) --
The user who created the library item.
updatedAt (datetime) --
The date and time the library item was last updated.
updatedBy (string) --
The user who last updated the library item.
ratingCount (integer) --
The number of ratings the library item has received from users.
isVerified (boolean) --
Indicates whether the library item has been verified.
{'isVerified': 'boolean'}
Retrieves details about a library item for an Amazon Q App, including its metadata, categories, ratings, and usage statistics.
See also: AWS API Documentation
Request Syntax
client.get_library_item( instanceId='string', libraryItemId='string', appId='string' )
string
[REQUIRED]
The unique identifier of the Amazon Q Business application environment instance.
string
[REQUIRED]
The unique identifier of the library item to retrieve.
string
The unique identifier of the Amazon Q App associated with the library item.
dict
Response Syntax
{ 'libraryItemId': 'string', 'appId': 'string', 'appVersion': 123, 'categories': [ { 'id': 'string', 'title': 'string' }, ], 'status': 'string', 'createdAt': datetime(2015, 1, 1), 'createdBy': 'string', 'updatedAt': datetime(2015, 1, 1), 'updatedBy': 'string', 'ratingCount': 123, 'isRatedByUser': True|False, 'userCount': 123, 'isVerified': True|False }
Response Structure
(dict) --
libraryItemId (string) --
The unique identifier of the library item.
appId (string) --
The unique identifier of the Q App associated with the library item.
appVersion (integer) --
The version of the Q App associated with the library item.
categories (list) --
The categories associated with the library item for discovery.
(dict) --
A category used to classify and filter library items for Amazon Q Apps.
id (string) --
The unique identifier of the category.
title (string) --
The title or name of the category.
status (string) --
The status of the library item, such as "Published".
createdAt (datetime) --
The date and time the library item was created.
createdBy (string) --
The user who created the library item.
updatedAt (datetime) --
The date and time the library item was last updated.
updatedBy (string) --
The user who last updated the library item.
ratingCount (integer) --
The number of ratings the library item has received from users.
isRatedByUser (boolean) --
Whether the current user has rated the library item.
userCount (integer) --
The number of users who have associated the Q App with their account.
isVerified (boolean) --
Indicates whether the library item has been verified.
{'libraryItems': {'isVerified': 'boolean'}}
Lists the library items for Amazon Q Apps that are published and available for users in your Amazon Web Services account.
See also: AWS API Documentation
Request Syntax
client.list_library_items( instanceId='string', limit=123, nextToken='string', categoryId='string' )
string
[REQUIRED]
The unique identifier of the Amazon Q Business application environment instance.
integer
The maximum number of library items to return in the response.
string
The token to request the next page of results.
string
Optional category to filter the library items by.
dict
Response Syntax
{ 'libraryItems': [ { 'libraryItemId': 'string', 'appId': 'string', 'appVersion': 123, 'categories': [ { 'id': 'string', 'title': 'string' }, ], 'status': 'string', 'createdAt': datetime(2015, 1, 1), 'createdBy': 'string', 'updatedAt': datetime(2015, 1, 1), 'updatedBy': 'string', 'ratingCount': 123, 'isRatedByUser': True|False, 'userCount': 123, 'isVerified': True|False }, ], 'nextToken': 'string' }
Response Structure
(dict) --
libraryItems (list) --
The list of library items meeting the request criteria.
(dict) --
A library item is a snapshot of an Amazon Q App that can be published so the users in their Amazon Q Apps library can discover it, clone it, and run it.
libraryItemId (string) --
The unique identifier of the library item.
appId (string) --
The unique identifier of the Q App associated with the library item.
appVersion (integer) --
The version of the Q App associated with the library item.
categories (list) --
The categories associated with the library item.
(dict) --
A category used to classify and filter library items for Amazon Q Apps.
id (string) --
The unique identifier of the category.
title (string) --
The title or name of the category.
status (string) --
The status of the library item.
createdAt (datetime) --
The date and time the library item was created.
createdBy (string) --
The user who created the library item.
updatedAt (datetime) --
The date and time the library item was last updated.
updatedBy (string) --
The user who last updated the library item.
ratingCount (integer) --
The number of ratings the library item has received.
isRatedByUser (boolean) --
Whether the current user has rated the library item.
userCount (integer) --
The number of users who have the associated Q App.
isVerified (boolean) --
Indicates whether the library item has been verified.
nextToken (string) --
The token to use to request the next page of results.
{'apps': {'isVerified': 'boolean'}}
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..
See also: AWS API Documentation
Request Syntax
client.list_q_apps( instanceId='string', limit=123, nextToken='string' )
string
[REQUIRED]
The unique identifier of the Amazon Q Business application environment instance.
integer
The maximum number of Q Apps to return in the response.
string
The token to request the next page of results.
dict
Response Syntax
{ 'apps': [ { 'appId': 'string', 'appArn': 'string', 'title': 'string', 'description': 'string', 'createdAt': datetime(2015, 1, 1), 'canEdit': True|False, 'status': 'string', 'isVerified': True|False }, ], 'nextToken': 'string' }
Response Structure
(dict) --
apps (list) --
The list of Amazon Q Apps meeting the request criteria.
(dict) --
An Amazon Q App associated with a user, either owned by the user or favorited.
appId (string) --
The unique identifier of the Q App.
appArn (string) --
The Amazon Resource Name (ARN) of the Q App.
title (string) --
The title of the Q App.
description (string) --
The description of the Q App.
createdAt (datetime) --
The date and time the user's association with the Q App was created.
canEdit (boolean) --
A flag indicating whether the user can edit the Q App.
status (string) --
The status of the user's association with the Q App.
isVerified (boolean) --
Indicates whether the Q App has been verified.
nextToken (string) --
The token to use to request the next page of results.
{'isVerified': 'boolean'}
Updates the library item for an Amazon Q App.
See also: AWS API Documentation
Request Syntax
client.update_library_item( instanceId='string', libraryItemId='string', status='PUBLISHED'|'DISABLED', categories=[ 'string', ] )
string
[REQUIRED]
The unique identifier of the Amazon Q Business application environment instance.
string
[REQUIRED]
The unique identifier of the library item to update.
string
The new status to set for the library item, such as "Published" or "Hidden".
list
The new categories to associate with the library item.
(string) --
dict
Response Syntax
{ 'libraryItemId': 'string', 'appId': 'string', 'appVersion': 123, 'categories': [ { 'id': 'string', 'title': 'string' }, ], 'status': 'string', 'createdAt': datetime(2015, 1, 1), 'createdBy': 'string', 'updatedAt': datetime(2015, 1, 1), 'updatedBy': 'string', 'ratingCount': 123, 'isRatedByUser': True|False, 'userCount': 123, 'isVerified': True|False }
Response Structure
(dict) --
libraryItemId (string) --
The unique identifier of the updated library item.
appId (string) --
The unique identifier of the Q App associated with the library item.
appVersion (integer) --
The version of the Q App associated with the library item.
categories (list) --
The categories associated with the updated library item.
(dict) --
A category used to classify and filter library items for Amazon Q Apps.
id (string) --
The unique identifier of the category.
title (string) --
The title or name of the category.
status (string) --
The new status of the updated library item.
createdAt (datetime) --
The date and time the library item was originally created.
createdBy (string) --
The user who originally created the library item.
updatedAt (datetime) --
The date and time the library item was last updated.
updatedBy (string) --
The user who last updated the library item.
ratingCount (integer) --
The number of ratings the library item has received.
isRatedByUser (boolean) --
Whether the current user has rated the library item.
userCount (integer) --
The number of users who have the associated Q App.
isVerified (boolean) --
Indicates whether the library item has been verified.