Skip to content
v2.278.0

CfnApplicationProps Struct ​

Properties for defining a CfnApplication.

Example ​

ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_qbusiness as qbusiness } from 'aws-cdk-lib';
const cfnApplicationProps: qbusiness.CfnApplicationProps = {
  displayName: 'displayName',

  // the properties below are optional
  attachmentsConfiguration: {
    attachmentsControlMode: 'attachmentsControlMode',
  },
  autoSubscriptionConfiguration: {
    autoSubscribe: 'autoSubscribe',

    // the properties below are optional
    defaultSubscriptionType: 'defaultSubscriptionType',
  },
  clientIdsForOidc: ['clientIdsForOidc'],
  description: 'description',
  encryptionConfiguration: {
    kmsKeyId: 'kmsKeyId',
  },
  iamIdentityProviderArn: 'iamIdentityProviderArn',
  identityCenterInstanceArn: 'identityCenterInstanceArn',
  identityType: 'identityType',
  personalizationConfiguration: {
    personalizationControlMode: 'personalizationControlMode',
  },
  qAppsConfiguration: {
    qAppsControlMode: 'qAppsControlMode',
  },
  quickSightConfiguration: {
    clientNamespace: 'clientNamespace',
  },
  roleArn: 'roleArn',
  tags: [{
    key: 'key',
    value: 'value',
  }],
};
python
from aws_cdk import CfnTag
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk import aws_qbusiness as qbusiness

cfn_application_props = qbusiness.CfnApplicationProps(
    display_name="displayName",

    # the properties below are optional
    attachments_configuration=qbusiness.CfnApplication.AttachmentsConfigurationProperty(
        attachments_control_mode="attachmentsControlMode"
    ),
    auto_subscription_configuration=qbusiness.CfnApplication.AutoSubscriptionConfigurationProperty(
        auto_subscribe="autoSubscribe",

        # the properties below are optional
        default_subscription_type="defaultSubscriptionType"
    ),
    client_ids_for_oidc=["clientIdsForOidc"],
    description="description",
    encryption_configuration=qbusiness.CfnApplication.EncryptionConfigurationProperty(
        kms_key_id="kmsKeyId"
    ),
    iam_identity_provider_arn="iamIdentityProviderArn",
    identity_center_instance_arn="identityCenterInstanceArn",
    identity_type="identityType",
    personalization_configuration=qbusiness.CfnApplication.PersonalizationConfigurationProperty(
        personalization_control_mode="personalizationControlMode"
    ),
    q_apps_configuration=qbusiness.CfnApplication.QAppsConfigurationProperty(
        q_apps_control_mode="qAppsControlMode"
    ),
    quick_sight_configuration=qbusiness.CfnApplication.QuickSightConfigurationProperty(
        client_namespace="clientNamespace"
    ),
    role_arn="roleArn",
    tags=[CfnTag(
        key="key",
        value="value"
    )]
)
java
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import software.amazon.awscdk.services.qbusiness.*;

CfnApplicationProps cfnApplicationProps = CfnApplicationProps.builder()
        .displayName("displayName")

        // the properties below are optional
        .attachmentsConfiguration(AttachmentsConfigurationProperty.builder()
                .attachmentsControlMode("attachmentsControlMode")
                .build())
        .autoSubscriptionConfiguration(AutoSubscriptionConfigurationProperty.builder()
                .autoSubscribe("autoSubscribe")

                // the properties below are optional
                .defaultSubscriptionType("defaultSubscriptionType")
                .build())
        .clientIdsForOidc(List.of("clientIdsForOidc"))
        .description("description")
        .encryptionConfiguration(EncryptionConfigurationProperty.builder()
                .kmsKeyId("kmsKeyId")
                .build())
        .iamIdentityProviderArn("iamIdentityProviderArn")
        .identityCenterInstanceArn("identityCenterInstanceArn")
        .identityType("identityType")
        .personalizationConfiguration(PersonalizationConfigurationProperty.builder()
                .personalizationControlMode("personalizationControlMode")
                .build())
        .qAppsConfiguration(QAppsConfigurationProperty.builder()
                .qAppsControlMode("qAppsControlMode")
                .build())
        .quickSightConfiguration(QuickSightConfigurationProperty.builder()
                .clientNamespace("clientNamespace")
                .build())
        .roleArn("roleArn")
        .tags(List.of(CfnTag.builder()
                .key("key")
                .value("value")
                .build()))
        .build();
csharp
// Install: dotnet add package Amazon.CDK.Lib
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.QBusiness;

var cfnApplicationProps = new CfnApplicationProps {
    DisplayName = "displayName",

    // the properties below are optional
    AttachmentsConfiguration = new AttachmentsConfigurationProperty {
        AttachmentsControlMode = "attachmentsControlMode"
    },
    AutoSubscriptionConfiguration = new AutoSubscriptionConfigurationProperty {
        AutoSubscribe = "autoSubscribe",

        // the properties below are optional
        DefaultSubscriptionType = "defaultSubscriptionType"
    },
    ClientIdsForOidc = new [] { "clientIdsForOidc" },
    Description = "description",
    EncryptionConfiguration = new EncryptionConfigurationProperty {
        KmsKeyId = "kmsKeyId"
    },
    IamIdentityProviderArn = "iamIdentityProviderArn",
    IdentityCenterInstanceArn = "identityCenterInstanceArn",
    IdentityType = "identityType",
    PersonalizationConfiguration = new PersonalizationConfigurationProperty {
        PersonalizationControlMode = "personalizationControlMode"
    },
    QAppsConfiguration = new QAppsConfigurationProperty {
        QAppsControlMode = "qAppsControlMode"
    },
    QuickSightConfiguration = new QuickSightConfigurationProperty {
        ClientNamespace = "clientNamespace"
    },
    RoleArn = "roleArn",
    Tags = new [] { new CfnTag {
        Key = "key",
        Value = "value"
    } }
};
go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import "github.com/aws/aws-cdk-go/awscdk"

cfnApplicationProps := &CfnApplicationProps{
	DisplayName: jsii.String("displayName"),

	// the properties below are optional
	AttachmentsConfiguration: &AttachmentsConfigurationProperty{
		AttachmentsControlMode: jsii.String("attachmentsControlMode"),
	},
	AutoSubscriptionConfiguration: &AutoSubscriptionConfigurationProperty{
		AutoSubscribe: jsii.String("autoSubscribe"),

		// the properties below are optional
		DefaultSubscriptionType: jsii.String("defaultSubscriptionType"),
	},
	ClientIdsForOidc: []*string{
		jsii.String("clientIdsForOidc"),
	},
	Description: jsii.String("description"),
	EncryptionConfiguration: &EncryptionConfigurationProperty{
		KmsKeyId: jsii.String("kmsKeyId"),
	},
	IamIdentityProviderArn: jsii.String("iamIdentityProviderArn"),
	IdentityCenterInstanceArn: jsii.String("identityCenterInstanceArn"),
	IdentityType: jsii.String("identityType"),
	PersonalizationConfiguration: &PersonalizationConfigurationProperty{
		PersonalizationControlMode: jsii.String("personalizationControlMode"),
	},
	QAppsConfiguration: &QAppsConfigurationProperty{
		QAppsControlMode: jsii.String("qAppsControlMode"),
	},
	QuickSightConfiguration: &QuickSightConfigurationProperty{
		ClientNamespace: jsii.String("clientNamespace"),
	},
	RoleArn: jsii.String("roleArn"),
	Tags: []CfnTag{
		&CfnTag{
			Key: jsii.String("key"),
			Value: jsii.String("value"),
		},
	},
}

Properties ​

attachmentsConfigurationoptionalIResolvable | CfnApplication.AttachmentsConfigurationPropertyattachments_configurationoptionaltyping.Union[IResolvable, AttachmentsConfigurationProperty]attachmentsConfigurationoptionalIResolvableAttachmentsConfigurationoptionalIResolvableAttachmentsConfigurationoptionalinterface{} #
Configuration information for the file upload during chat feature.
autoSubscriptionConfigurationoptionalIResolvable | CfnApplication.AutoSubscriptionConfigurationPropertyauto_subscription_configurationoptionaltyping.Union[IResolvable, AutoSubscriptionConfigurationProperty]autoSubscriptionConfigurationoptionalIResolvableAutoSubscriptionConfigurationoptionalIResolvableAutoSubscriptionConfigurationoptionalinterface{} #
Subscription configuration information for an Amazon Q Business application using IAM identity federation for user management.
clientIdsForOidcoptionalstring[]client_ids_for_oidcoptionaltyping.List[str]clientIdsForOidcoptionalList<String>ClientIdsForOidcoptionalstring[]ClientIdsForOidcoptional*[]*string #
The OIDC client ID for a Amazon Q Business application.
descriptionoptionalstringdescriptionoptionalstrdescriptionoptionalStringDescriptionoptionalstringDescriptionoptional*string #
A description for the Amazon Q Business application.
displayNamestringdisplay_namestrdisplayNameStringDisplayNamestringDisplayName*string required #
The name of the Amazon Q Business application.
encryptionConfigurationoptionalIResolvable | CfnApplication.EncryptionConfigurationPropertyencryption_configurationoptionaltyping.Union[IResolvable, EncryptionConfigurationProperty]encryptionConfigurationoptionalIResolvableEncryptionConfigurationoptionalIResolvableEncryptionConfigurationoptionalinterface{} #
Provides the identifier of the AWS key used to encrypt data indexed by Amazon Q Business.

Amazon Q Business doesn't support asymmetric keys.

iamIdentityProviderArnoptionalstringiam_identity_provider_arnoptionalstriamIdentityProviderArnoptionalStringIamIdentityProviderArnoptionalstringIamIdentityProviderArnoptional*string #
The Amazon Resource Name (ARN) of an identity provider being used by an Amazon Q Business application.
identityCenterInstanceArnoptionalstringidentity_center_instance_arnoptionalstridentityCenterInstanceArnoptionalStringIdentityCenterInstanceArnoptionalstringIdentityCenterInstanceArnoptional*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.

Required : Yes

identityTypeoptionalstringidentity_typeoptionalstridentityTypeoptionalStringIdentityTypeoptionalstringIdentityTypeoptional*string #
The authentication type being used by a Amazon Q Business application.
personalizationConfigurationoptionalIResolvable | CfnApplication.PersonalizationConfigurationPropertypersonalization_configurationoptionaltyping.Union[IResolvable, PersonalizationConfigurationProperty]personalizationConfigurationoptionalIResolvablePersonalizationConfigurationoptionalIResolvablePersonalizationConfigurationoptionalinterface{} #
Configuration information about chat response personalization.

For more information, see Personalizing chat responses .

qAppsConfigurationoptionalIResolvable | CfnApplication.QAppsConfigurationPropertyq_apps_configurationoptionaltyping.Union[IResolvable, QAppsConfigurationProperty]qAppsConfigurationoptionalIResolvableQAppsConfigurationoptionalIResolvableQAppsConfigurationoptionalinterface{} #
Configuration information about Amazon Q Apps.
quickSightConfigurationoptionalIResolvable | CfnApplication.QuickSightConfigurationPropertyquick_sight_configurationoptionaltyping.Union[IResolvable, QuickSightConfigurationProperty]quickSightConfigurationoptionalIResolvableQuickSightConfigurationoptionalIResolvableQuickSightConfigurationoptionalinterface{} #
The Amazon Quick Suite configuration for an Amazon Q Business application that uses Quick Suite as the identity provider.
roleArnoptionalstringrole_arnoptionalstrroleArnoptionalStringRoleArnoptionalstringRoleArnoptional*string #
The Amazon Resource Name (ARN) of an IAM role with permissions to access your Amazon CloudWatch logs and metrics.

If this property is not specified, Amazon Q Business will create a service linked role (SLR) and use it as the application's role.

tagsoptionalCfnTag[]tagsoptionaltyping.List[CfnTag]tagsoptionalList<CfnTag>TagsoptionalCfnTag[]Tagsoptional*[]CfnTag #
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: _ . : / = + -