QBusiness / Client / create_application

create_application

QBusiness.Client.create_application(**kwargs)

Creates an Amazon Q Business application.

Note

There are new tiers for Amazon Q Business. Not all features in Amazon Q Business Pro are also available in Amazon Q Business Lite. For information on what’s included in Amazon Q Business Lite and what’s included in Amazon Q Business Pro, see Amazon Q Business tiers. You must use the Amazon Q Business console to assign subscription tiers to users.

See also: AWS API Documentation

Request Syntax

response = client.create_application(
    displayName='string',
    roleArn='string',
    identityCenterInstanceArn='string',
    description='string',
    encryptionConfiguration={
        'kmsKeyId': 'string'
    },
    tags=[
        {
            'key': 'string',
            'value': 'string'
        },
    ],
    clientToken='string',
    attachmentsConfiguration={
        'attachmentsControlMode': 'ENABLED'|'DISABLED'
    }
)

Parameters:

• displayName (string) –

  [REQUIRED]

  A name for the Amazon Q Business application.

• roleArn (string) – The Amazon Resource Name (ARN) of an IAM role with permissions to access your Amazon CloudWatch logs and metrics.

• identityCenterInstanceArn (string) – The Amazon Resource Name (ARN) of the IAM Identity Center instance you are either creating for—or connecting to—your Amazon Q Business application.

• description (string) – A description for the Amazon Q Business application.

• encryptionConfiguration (dict) –

  The identifier of the KMS key that is used to encrypt your data. Amazon Q Business doesn’t support asymmetric keys.

  • kmsKeyId (string) –

    The identifier of the KMS key. Amazon Q Business doesn’t support asymmetric keys.

• tags (list) –

  A list of key-value pairs that identify or categorize your Amazon Q Business application. You can also use tags to help control access to the application. Tag keys and values can consist of Unicode letters, digits, white space, and any of the following symbols: _ . : / = + - @.

  • (dict) –

    A list of key/value pairs that identify an index, FAQ, or data source. Tag keys and values can consist of Unicode letters, digits, white space, and any of the following symbols: _ . : / = + - @.

    • key (string) – [REQUIRED]

      The key for the tag. Keys are not case sensitive and must be unique for the Amazon Q Business application or data source.

    • value (string) – [REQUIRED]

      The value associated with the tag. The value may be an empty string but it can’t be null.

• clientToken (string) –

  A token that you provide to identify the request to create your Amazon Q Business application.

  This field is autopopulated if not provided.

• attachmentsConfiguration (dict) –

  An option to allow end users to upload files directly during chat.

  • attachmentsControlMode (string) – [REQUIRED]

    Status information about whether file upload functionality is activated or deactivated for your end user.

Return type:

dict

Returns:

Response Syntax

{
    'applicationId': 'string',
    'applicationArn': 'string'
}

Response Structure

• (dict) –

  • applicationId (string) –

    The identifier of the Amazon Q Business application.

  • applicationArn (string) –

    The Amazon Resource Name (ARN) of the Amazon Q Business application.

Exceptions

• QBusiness.Client.exceptions.ResourceNotFoundException

• QBusiness.Client.exceptions.InternalServerException

• QBusiness.Client.exceptions.ConflictException

• QBusiness.Client.exceptions.ThrottlingException

• QBusiness.Client.exceptions.ValidationException

• QBusiness.Client.exceptions.AccessDeniedException

• QBusiness.Client.exceptions.ServiceQuotaExceededException