AWS::QBusiness::Application - AWS CloudFormation
SyntaxPropertiesReturn values

AWS::QBusiness::Application

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.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{
  "Type" : "AWS::QBusiness::Application",
  "Properties" : {
      "AttachmentsConfiguration" : AttachmentsConfiguration,
      "Description" : String,
      "DisplayName" : String,
      "EncryptionConfiguration" : EncryptionConfiguration,
      "IdentityCenterInstanceArn" : String,
      "RoleArn" : String,
      "Tags" : [ Tag, ... ]
    }
}

Properties

AttachmentsConfiguration

Configuration information for the file upload during chat feature.

Required: No

Type: AttachmentsConfiguration

Update requires: No interruption

Description

A description for the Amazon Q Business application.

Required: No

Type: String

Pattern: ^[\s\S]*$

Minimum: 0

Maximum: 1000

Update requires: No interruption

DisplayName

The name of the Amazon Q Business application.

Required: Yes

Type: String

Pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$

Minimum: 1

Maximum: 1000

Update requires: No interruption

EncryptionConfiguration

Provides the identifier of the AWS KMS key used to encrypt data indexed by Amazon Q Business. Amazon Q Business doesn't support asymmetric keys.

Required: No

Type: EncryptionConfiguration

Update requires: Replacement

IdentityCenterInstanceArn

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

Required: Yes

Required: Conditional

Type: String

Pattern: ^arn:(aws|aws-us-gov|aws-cn|aws-iso|aws-iso-b):sso:::instance/(sso)?ins-[a-zA-Z0-9-.]{16}$

Minimum: 10

Maximum: 1224

Update requires: No interruption

RoleArn

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

Required: No

Type: String

Pattern: ^arn:[a-z0-9-\.]{1,63}:[a-z0-9-\.]{0,63}:[a-z0-9-\.]{0,63}:[a-z0-9-\.]{0,63}:[^/].{0,1023}$

Minimum: 0

Maximum: 1284

Update requires: No interruption

Tags

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: _ . : / = + - @.

Required: No

Type: Array of Tag

Minimum: 0

Maximum: 200

Update requires: No interruption

Return values

Ref

When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns the application ID. For example:

{"Ref": "application-id"}

For more information about using the Ref function, see Ref.

Fn::GetAtt

The Fn::GetAtt intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the Fn::GetAtt intrinsic function, see Fn::GetAtt.

ApplicationArn

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

ApplicationId

The identifier for the Amazon Q Business application.

CreatedAt

The Unix timestamp when the Amazon Q Business application was created.

IdentityCenterApplicationArn

The Amazon Resource Name (ARN) of the AWS IAM Identity Center instance attached to your Amazon Q Business application.

Status

The status of the Amazon Q Business application. The application is ready to use when the status is ACTIVE.

UpdatedAt

The Unix timestamp when the Amazon Q Business application was last updated.