QApps / Client / update_q_app
update_q_app#
- QApps.Client.update_q_app(**kwargs)#
Updates an existing Amazon Q App, allowing modifications to its title, description, and definition.
See also: AWS API Documentation
Request Syntax
response = client.update_q_app( instanceId='string', appId='string', title='string', description='string', appDefinition={ 'cards': [ { 'textInput': { 'title': 'string', 'id': 'string', 'type': 'text-input'|'q-query'|'file-upload'|'q-plugin', 'placeholder': 'string', 'defaultValue': 'string' }, 'qQuery': { 'title': 'string', 'id': 'string', 'type': 'text-input'|'q-query'|'file-upload'|'q-plugin', 'prompt': 'string', 'outputSource': 'approved-sources'|'llm', 'attributeFilter': { 'andAllFilters': [ {'... recursive ...'}, ], 'orAllFilters': [ {'... recursive ...'}, ], 'notFilter': {'... recursive ...'}, 'equalsTo': { 'name': 'string', 'value': { 'stringValue': 'string', 'stringListValue': [ 'string', ], 'longValue': 123, 'dateValue': datetime(2015, 1, 1) } }, 'containsAll': { 'name': 'string', 'value': { 'stringValue': 'string', 'stringListValue': [ 'string', ], 'longValue': 123, 'dateValue': datetime(2015, 1, 1) } }, 'containsAny': { 'name': 'string', 'value': { 'stringValue': 'string', 'stringListValue': [ 'string', ], 'longValue': 123, 'dateValue': datetime(2015, 1, 1) } }, 'greaterThan': { 'name': 'string', 'value': { 'stringValue': 'string', 'stringListValue': [ 'string', ], 'longValue': 123, 'dateValue': datetime(2015, 1, 1) } }, 'greaterThanOrEquals': { 'name': 'string', 'value': { 'stringValue': 'string', 'stringListValue': [ 'string', ], 'longValue': 123, 'dateValue': datetime(2015, 1, 1) } }, 'lessThan': { 'name': 'string', 'value': { 'stringValue': 'string', 'stringListValue': [ 'string', ], 'longValue': 123, 'dateValue': datetime(2015, 1, 1) } }, 'lessThanOrEquals': { 'name': 'string', 'value': { 'stringValue': 'string', 'stringListValue': [ 'string', ], 'longValue': 123, 'dateValue': datetime(2015, 1, 1) } } } }, 'qPlugin': { 'title': 'string', 'id': 'string', 'type': 'text-input'|'q-query'|'file-upload'|'q-plugin', 'prompt': 'string', 'pluginId': 'string' }, 'fileUpload': { 'title': 'string', 'id': 'string', 'type': 'text-input'|'q-query'|'file-upload'|'q-plugin', 'filename': 'string', 'fileId': 'string', 'allowOverride': True|False } }, ], 'initialPrompt': 'string' } )
- Parameters:
instanceId (string) –
[REQUIRED]
The unique identifier of the Amazon Q Business application environment instance.
appId (string) –
[REQUIRED]
The unique identifier of the Q App to update.
title (string) – The new title for the Q App.
description (string) – The new description for the Q App.
appDefinition (dict) –
The new definition specifying the cards and flow for the Q App.
cards (list) – [REQUIRED]
The cards that make up the Q App definition.
(dict) –
The properties defining an input card in an Amazon Q App.
Note
This is a Tagged Union structure. Only one of the following top level keys can be set:
textInput
,qQuery
,qPlugin
,fileUpload
.textInput (dict) –
A container for the properties of the text input card.
title (string) – [REQUIRED]
The title or label of the text input card.
id (string) – [REQUIRED]
The unique identifier of the text input card.
type (string) – [REQUIRED]
The type of the card.
placeholder (string) –
The placeholder text to display in the text input field.
defaultValue (string) –
The default value to pre-populate in the text input field.
qQuery (dict) –
A container for the properties of the query input card.
title (string) – [REQUIRED]
The title or label of the query card.
id (string) – [REQUIRED]
The unique identifier of the query card.
type (string) – [REQUIRED]
The type of the card.
prompt (string) – [REQUIRED]
The prompt or instructions displayed for the query card.
outputSource (string) –
The source or type of output to generate for the query card.
attributeFilter (dict) –
Turns on filtering of responses based on document attributes or metadata fields.
andAllFilters (list) –
Performs a logical
AND
operation on all supplied filters.(dict) –
The filter criteria used on responses based on document attributes or metadata fields.
orAllFilters (list) –
Performs a logical
OR
operation on all supplied filters.(dict) –
The filter criteria used on responses based on document attributes or metadata fields.
notFilter (dict) –
Performs a logical
NOT
operation on all supplied filters.equalsTo (dict) –
Performs an equals operation on two document attributes or metadata fields. Supported for the following document attribute value types:
dateValue
,longValue
,stringListValue
andstringValue
.name (string) – [REQUIRED]
The identifier for the attribute.
value (dict) – [REQUIRED]
The value of the attribute.
Note
This is a Tagged Union structure. Only one of the following top level keys can be set:
stringValue
,stringListValue
,longValue
,dateValue
.stringValue (string) –
A string.
stringListValue (list) –
A list of strings.
(string) –
longValue (integer) –
A long integer value.
dateValue (datetime) –
A date expressed as an ISO 8601 string.
It’s important for the time zone to be included in the ISO 8601 date-time format. For example, 2012-03-25T12:30:10+01:00 is the ISO 8601 date-time format for March 25th 2012 at 12:30PM (plus 10 seconds) in Central European Time.
containsAll (dict) –
Returns
true
when a document contains all the specified document attributes or metadata fields. Supported for the following document attribute value types:stringListValue
.name (string) – [REQUIRED]
The identifier for the attribute.
value (dict) – [REQUIRED]
The value of the attribute.
Note
This is a Tagged Union structure. Only one of the following top level keys can be set:
stringValue
,stringListValue
,longValue
,dateValue
.stringValue (string) –
A string.
stringListValue (list) –
A list of strings.
(string) –
longValue (integer) –
A long integer value.
dateValue (datetime) –
A date expressed as an ISO 8601 string.
It’s important for the time zone to be included in the ISO 8601 date-time format. For example, 2012-03-25T12:30:10+01:00 is the ISO 8601 date-time format for March 25th 2012 at 12:30PM (plus 10 seconds) in Central European Time.
containsAny (dict) –
Returns
true
when a document contains any of the specified document attributes or metadata fields. Supported for the following document attribute value types:stringListValue
.name (string) – [REQUIRED]
The identifier for the attribute.
value (dict) – [REQUIRED]
The value of the attribute.
Note
This is a Tagged Union structure. Only one of the following top level keys can be set:
stringValue
,stringListValue
,longValue
,dateValue
.stringValue (string) –
A string.
stringListValue (list) –
A list of strings.
(string) –
longValue (integer) –
A long integer value.
dateValue (datetime) –
A date expressed as an ISO 8601 string.
It’s important for the time zone to be included in the ISO 8601 date-time format. For example, 2012-03-25T12:30:10+01:00 is the ISO 8601 date-time format for March 25th 2012 at 12:30PM (plus 10 seconds) in Central European Time.
greaterThan (dict) –
Performs a greater than operation on two document attributes or metadata fields. Supported for the following document attribute value types:
dateValue
andlongValue
.name (string) – [REQUIRED]
The identifier for the attribute.
value (dict) – [REQUIRED]
The value of the attribute.
Note
This is a Tagged Union structure. Only one of the following top level keys can be set:
stringValue
,stringListValue
,longValue
,dateValue
.stringValue (string) –
A string.
stringListValue (list) –
A list of strings.
(string) –
longValue (integer) –
A long integer value.
dateValue (datetime) –
A date expressed as an ISO 8601 string.
It’s important for the time zone to be included in the ISO 8601 date-time format. For example, 2012-03-25T12:30:10+01:00 is the ISO 8601 date-time format for March 25th 2012 at 12:30PM (plus 10 seconds) in Central European Time.
greaterThanOrEquals (dict) –
Performs a greater than or equals operation on two document attributes or metadata fields. Supported for the following document attribute value types:
dateValue
andlongValue
.name (string) – [REQUIRED]
The identifier for the attribute.
value (dict) – [REQUIRED]
The value of the attribute.
Note
This is a Tagged Union structure. Only one of the following top level keys can be set:
stringValue
,stringListValue
,longValue
,dateValue
.stringValue (string) –
A string.
stringListValue (list) –
A list of strings.
(string) –
longValue (integer) –
A long integer value.
dateValue (datetime) –
A date expressed as an ISO 8601 string.
It’s important for the time zone to be included in the ISO 8601 date-time format. For example, 2012-03-25T12:30:10+01:00 is the ISO 8601 date-time format for March 25th 2012 at 12:30PM (plus 10 seconds) in Central European Time.
lessThan (dict) –
Performs a less than operation on two document attributes or metadata fields. Supported for the following document attribute value types:
dateValue
andlongValue
.name (string) – [REQUIRED]
The identifier for the attribute.
value (dict) – [REQUIRED]
The value of the attribute.
Note
This is a Tagged Union structure. Only one of the following top level keys can be set:
stringValue
,stringListValue
,longValue
,dateValue
.stringValue (string) –
A string.
stringListValue (list) –
A list of strings.
(string) –
longValue (integer) –
A long integer value.
dateValue (datetime) –
A date expressed as an ISO 8601 string.
It’s important for the time zone to be included in the ISO 8601 date-time format. For example, 2012-03-25T12:30:10+01:00 is the ISO 8601 date-time format for March 25th 2012 at 12:30PM (plus 10 seconds) in Central European Time.
lessThanOrEquals (dict) –
Performs a less than or equals operation on two document attributes or metadata fields.Supported for the following document attribute value type:
dateValue
andlongValue
.name (string) – [REQUIRED]
The identifier for the attribute.
value (dict) – [REQUIRED]
The value of the attribute.
Note
This is a Tagged Union structure. Only one of the following top level keys can be set:
stringValue
,stringListValue
,longValue
,dateValue
.stringValue (string) –
A string.
stringListValue (list) –
A list of strings.
(string) –
longValue (integer) –
A long integer value.
dateValue (datetime) –
A date expressed as an ISO 8601 string.
It’s important for the time zone to be included in the ISO 8601 date-time format. For example, 2012-03-25T12:30:10+01:00 is the ISO 8601 date-time format for March 25th 2012 at 12:30PM (plus 10 seconds) in Central European Time.
qPlugin (dict) –
A container for the properties of the plugin input card.
title (string) – [REQUIRED]
The title or label of the plugin card.
id (string) – [REQUIRED]
The unique identifier of the plugin card.
type (string) – [REQUIRED]
The type of the card.
prompt (string) – [REQUIRED]
The prompt or instructions displayed for the plugin card.
pluginId (string) – [REQUIRED]
The unique identifier of the plugin used by the card.
fileUpload (dict) –
A container for the properties of the file upload input card.
title (string) – [REQUIRED]
The title or label of the file upload card.
id (string) – [REQUIRED]
The unique identifier of the file upload card.
type (string) – [REQUIRED]
The type of the card.
filename (string) –
The default filename to use for the file upload card.
fileId (string) –
The identifier of a pre-uploaded file associated with the card.
allowOverride (boolean) –
A flag indicating if the user can override the default file for the upload card.
initialPrompt (string) –
The initial prompt displayed when the Q App is started.
- Return type:
dict
- Returns:
Response Syntax
{ 'appId': 'string', 'appArn': 'string', 'title': 'string', 'description': 'string', 'initialPrompt': 'string', 'appVersion': 123, 'status': 'PUBLISHED'|'DRAFT'|'DELETED', 'createdAt': datetime(2015, 1, 1), 'createdBy': 'string', 'updatedAt': datetime(2015, 1, 1), 'updatedBy': 'string', 'requiredCapabilities': [ 'FileUpload'|'CreatorMode'|'RetrievalMode'|'PluginMode', ] }
Response Structure
(dict) –
appId (string) –
The unique identifier of the updated Q App.
appArn (string) –
The Amazon Resource Name (ARN) of the updated Q App.
title (string) –
The new title of the updated Q App.
description (string) –
The new description of the updated Q App.
initialPrompt (string) –
The initial prompt for the updated Q App.
appVersion (integer) –
The new version of the updated Q App.
status (string) –
The status of the updated Q App.
createdAt (datetime) –
The date and time the Q App was originally created.
createdBy (string) –
The user who originally created the Q App.
updatedAt (datetime) –
The date and time the Q App was last updated.
updatedBy (string) –
The user who last updated the Q App.
requiredCapabilities (list) –
The capabilities required for the updated Q App.
(string) –
Exceptions
QApps.Client.exceptions.ResourceNotFoundException
QApps.Client.exceptions.AccessDeniedException
QApps.Client.exceptions.ValidationException
QApps.Client.exceptions.InternalServerException
QApps.Client.exceptions.UnauthorizedException
QApps.Client.exceptions.ContentTooLargeException
QApps.Client.exceptions.ThrottlingException