UNPKG

aws-cdk-lib

Version:

Version 2 of the AWS Cloud Development Kit library

942 lines 118 kB
import * as cdk from "../../core"; import * as constructs from "constructs"; import * as cfn_parse from "../../core/lib/helpers-internal"; /** * Creates an Amazon Q Business application. * * > 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](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/tiers.html#user-sub-tiers) . You must use the Amazon Q Business console to assign subscription tiers to users. * > * > An Amazon Q Apps service linked role will be created if it's absent in the AWS account when `QAppsConfiguration` is enabled in the request. For more information, see [Using service-linked roles for Q Apps](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/using-service-linked-roles-qapps.html) . * > * > When you create an application, Amazon Q Business may securely transmit data for processing from your selected AWS region, but within your geography. For more information, see [Cross region inference in Amazon Q Business](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/cross-region-inference.html) . * * @cloudformationResource AWS::QBusiness::Application * @stability external * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-application.html */ export declare class CfnApplication extends cdk.CfnResource implements cdk.IInspectable, cdk.ITaggableV2 { /** * The CloudFormation resource type name for this resource class. */ static readonly CFN_RESOURCE_TYPE_NAME: string; /** * Build a CfnApplication from CloudFormation properties * * A factory method that creates a new instance of this class from an object * containing the CloudFormation properties of this resource. * Used in the @aws-cdk/cloudformation-include module. * * @internal */ static _fromCloudFormation(scope: constructs.Construct, id: string, resourceAttributes: any, options: cfn_parse.FromCloudFormationOptions): CfnApplication; /** * The Amazon Resource Name (ARN) of the Amazon Q Business application. * * @cloudformationAttribute ApplicationArn */ readonly attrApplicationArn: string; /** * The identifier for the Amazon Q Business application. * * @cloudformationAttribute ApplicationId */ readonly attrApplicationId: string; /** * The Unix timestamp when the Amazon Q Business application was created. * * @cloudformationAttribute CreatedAt */ readonly attrCreatedAt: string; /** * The Amazon Resource Name (ARN) of the AWS IAM Identity Center instance attached to your Amazon Q Business application. * * @cloudformationAttribute IdentityCenterApplicationArn */ readonly attrIdentityCenterApplicationArn: string; /** * The status of the Amazon Q Business application. The application is ready to use when the status is `ACTIVE` . * * @cloudformationAttribute Status */ readonly attrStatus: string; /** * The Unix timestamp when the Amazon Q Business application was last updated. * * @cloudformationAttribute UpdatedAt */ readonly attrUpdatedAt: string; /** * Configuration information for the file upload during chat feature. */ attachmentsConfiguration?: CfnApplication.AttachmentsConfigurationProperty | cdk.IResolvable; /** * Subscription configuration information for an Amazon Q Business application using IAM identity federation for user management. */ autoSubscriptionConfiguration?: CfnApplication.AutoSubscriptionConfigurationProperty | cdk.IResolvable; /** * Tag Manager which manages the tags for this resource */ readonly cdkTagManager: cdk.TagManager; /** * The OIDC client ID for a Amazon Q Business application. */ clientIdsForOidc?: Array<string>; /** * A description for the Amazon Q Business application. */ description?: string; /** * The name of the Amazon Q Business application. */ displayName: string; /** * Provides the identifier of the AWS KMS key used to encrypt data indexed by Amazon Q Business. */ encryptionConfiguration?: CfnApplication.EncryptionConfigurationProperty | cdk.IResolvable; /** * The Amazon Resource Name (ARN) of an identity provider being used by an Amazon Q Business application. */ iamIdentityProviderArn?: 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. */ identityCenterInstanceArn?: string; /** * The authentication type being used by a Amazon Q Business application. */ identityType?: string; /** * Configuration information about chat response personalization. */ personalizationConfiguration?: cdk.IResolvable | CfnApplication.PersonalizationConfigurationProperty; /** * Configuration information about Amazon Q Apps. */ qAppsConfiguration?: cdk.IResolvable | CfnApplication.QAppsConfigurationProperty; /** * The Amazon QuickSight configuration for an Amazon Q Business application that uses QuickSight as the identity provider. */ quickSightConfiguration?: cdk.IResolvable | CfnApplication.QuickSightConfigurationProperty; /** * The Amazon Resource Name (ARN) of an IAM role with permissions to access your Amazon CloudWatch logs and metrics. */ roleArn?: string; /** * A list of key-value pairs that identify or categorize your Amazon Q Business application. */ tags?: Array<cdk.CfnTag>; /** * @param scope Scope in which this resource is defined * @param id Construct identifier for this resource (unique in its scope) * @param props Resource properties */ constructor(scope: constructs.Construct, id: string, props: CfnApplicationProps); protected get cfnProperties(): Record<string, any>; /** * Examines the CloudFormation resource and discloses attributes * * @param inspector tree inspector to collect and process attributes */ inspect(inspector: cdk.TreeInspector): void; protected renderProperties(props: Record<string, any>): Record<string, any>; } export declare namespace CfnApplication { /** * Configuration information for the file upload during chat feature. * * @struct * @stability external * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-application-attachmentsconfiguration.html */ interface AttachmentsConfigurationProperty { /** * Status information about whether file upload functionality is activated or deactivated for your end user. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-application-attachmentsconfiguration.html#cfn-qbusiness-application-attachmentsconfiguration-attachmentscontrolmode */ readonly attachmentsControlMode: string; } /** * Subscription configuration information for an Amazon Q Business application using IAM identity federation for user management. * * @struct * @stability external * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-application-autosubscriptionconfiguration.html */ interface AutoSubscriptionConfigurationProperty { /** * Describes whether automatic subscriptions are enabled for an Amazon Q Business application using IAM identity federation for user management. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-application-autosubscriptionconfiguration.html#cfn-qbusiness-application-autosubscriptionconfiguration-autosubscribe */ readonly autoSubscribe: string; /** * Describes the default subscription type assigned to an Amazon Q Business application using IAM identity federation for user management. * * If the value for `autoSubscribe` is set to `ENABLED` you must select a value for this field. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-application-autosubscriptionconfiguration.html#cfn-qbusiness-application-autosubscriptionconfiguration-defaultsubscriptiontype */ readonly defaultSubscriptionType?: string; } /** * 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. * * @struct * @stability external * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-application-encryptionconfiguration.html */ interface EncryptionConfigurationProperty { /** * The identifier of the AWS KMS key. * * Amazon Q Business doesn't support asymmetric keys. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-application-encryptionconfiguration.html#cfn-qbusiness-application-encryptionconfiguration-kmskeyid */ readonly kmsKeyId?: string; } /** * Configuration information about chat response personalization. * * For more information, see [Personalizing chat responses](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/personalizing-chat-responses.html) . * * @struct * @stability external * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-application-personalizationconfiguration.html */ interface PersonalizationConfigurationProperty { /** * An option to allow Amazon Q Business to customize chat responses using user specific metadata—specifically, location and job information—in your IAM Identity Center instance. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-application-personalizationconfiguration.html#cfn-qbusiness-application-personalizationconfiguration-personalizationcontrolmode */ readonly personalizationControlMode: string; } /** * Configuration information about Amazon Q Apps. * * @struct * @stability external * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-application-qappsconfiguration.html */ interface QAppsConfigurationProperty { /** * Status information about whether end users can create and use Amazon Q Apps in the web experience. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-application-qappsconfiguration.html#cfn-qbusiness-application-qappsconfiguration-qappscontrolmode */ readonly qAppsControlMode: string; } /** * The Amazon QuickSight configuration for an Amazon Q Business application that uses QuickSight as the identity provider. * * For more information, see [Creating an Amazon QuickSight integrated application](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/create-quicksight-integrated-application.html) . * * @struct * @stability external * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-application-quicksightconfiguration.html */ interface QuickSightConfigurationProperty { /** * The Amazon QuickSight namespace that is used as the identity provider. * * For more information about QuickSight namespaces, see [Namespace operations](https://docs.aws.amazon.com/quicksight/latest/developerguide/namespace-operations.html) . * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-application-quicksightconfiguration.html#cfn-qbusiness-application-quicksightconfiguration-clientnamespace */ readonly clientNamespace: string; } } /** * Properties for defining a `CfnApplication` * * @struct * @stability external * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-application.html */ export interface CfnApplicationProps { /** * Configuration information for the file upload during chat feature. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-application.html#cfn-qbusiness-application-attachmentsconfiguration */ readonly attachmentsConfiguration?: CfnApplication.AttachmentsConfigurationProperty | cdk.IResolvable; /** * Subscription configuration information for an Amazon Q Business application using IAM identity federation for user management. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-application.html#cfn-qbusiness-application-autosubscriptionconfiguration */ readonly autoSubscriptionConfiguration?: CfnApplication.AutoSubscriptionConfigurationProperty | cdk.IResolvable; /** * The OIDC client ID for a Amazon Q Business application. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-application.html#cfn-qbusiness-application-clientidsforoidc */ readonly clientIdsForOidc?: Array<string>; /** * A description for the Amazon Q Business application. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-application.html#cfn-qbusiness-application-description */ readonly description?: string; /** * The name of the Amazon Q Business application. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-application.html#cfn-qbusiness-application-displayname */ readonly displayName: string; /** * 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. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-application.html#cfn-qbusiness-application-encryptionconfiguration */ readonly encryptionConfiguration?: CfnApplication.EncryptionConfigurationProperty | cdk.IResolvable; /** * The Amazon Resource Name (ARN) of an identity provider being used by an Amazon Q Business application. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-application.html#cfn-qbusiness-application-iamidentityproviderarn */ readonly iamIdentityProviderArn?: 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` * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-application.html#cfn-qbusiness-application-identitycenterinstancearn */ readonly identityCenterInstanceArn?: string; /** * The authentication type being used by a Amazon Q Business application. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-application.html#cfn-qbusiness-application-identitytype */ readonly identityType?: string; /** * Configuration information about chat response personalization. * * For more information, see [Personalizing chat responses](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/personalizing-chat-responses.html) . * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-application.html#cfn-qbusiness-application-personalizationconfiguration */ readonly personalizationConfiguration?: cdk.IResolvable | CfnApplication.PersonalizationConfigurationProperty; /** * Configuration information about Amazon Q Apps. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-application.html#cfn-qbusiness-application-qappsconfiguration */ readonly qAppsConfiguration?: cdk.IResolvable | CfnApplication.QAppsConfigurationProperty; /** * The Amazon QuickSight configuration for an Amazon Q Business application that uses QuickSight as the identity provider. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-application.html#cfn-qbusiness-application-quicksightconfiguration */ readonly quickSightConfiguration?: cdk.IResolvable | CfnApplication.QuickSightConfigurationProperty; /** * 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)](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/using-service-linked-roles.html#slr-permissions) and use it as the application's role. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-application.html#cfn-qbusiness-application-rolearn */ readonly roleArn?: string; /** * 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: _ . : / = + - @. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-application.html#cfn-qbusiness-application-tags */ readonly tags?: Array<cdk.CfnTag>; } /** * Creates a new data accessor for an ISV to access data from a Amazon Q Business application. * * The data accessor is an entity that represents the ISV's access to the Amazon Q Business application's data. It includes the IAM role ARN for the ISV, a friendly name, and a set of action configurations that define the specific actions the ISV is allowed to perform and any associated data filters. When the data accessor is created, an IAM Identity Center application is also created to manage the ISV's identity and authentication for accessing the Amazon Q Business application. * * @cloudformationResource AWS::QBusiness::DataAccessor * @stability external * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-dataaccessor.html */ export declare class CfnDataAccessor extends cdk.CfnResource implements cdk.IInspectable, cdk.ITaggableV2 { /** * The CloudFormation resource type name for this resource class. */ static readonly CFN_RESOURCE_TYPE_NAME: string; /** * Build a CfnDataAccessor from CloudFormation properties * * A factory method that creates a new instance of this class from an object * containing the CloudFormation properties of this resource. * Used in the @aws-cdk/cloudformation-include module. * * @internal */ static _fromCloudFormation(scope: constructs.Construct, id: string, resourceAttributes: any, options: cfn_parse.FromCloudFormationOptions): CfnDataAccessor; /** * The timestamp when the data accessor was created. * * @cloudformationAttribute CreatedAt */ readonly attrCreatedAt: string; /** * The Amazon Resource Name (ARN) of the data accessor. * * @cloudformationAttribute DataAccessorArn */ readonly attrDataAccessorArn: string; /** * The unique identifier of the data accessor. * * @cloudformationAttribute DataAccessorId */ readonly attrDataAccessorId: string; /** * The Amazon Resource Name (ARN) of the associated IAM Identity Center application. * * @cloudformationAttribute IdcApplicationArn */ readonly attrIdcApplicationArn: string; /** * The timestamp when the data accessor was last updated. * * @cloudformationAttribute UpdatedAt */ readonly attrUpdatedAt: string; /** * A list of action configurations specifying the allowed actions and any associated filters. */ actionConfigurations: Array<CfnDataAccessor.ActionConfigurationProperty | cdk.IResolvable> | cdk.IResolvable; /** * The unique identifier of the Amazon Q Business application. */ applicationId: string; /** * Tag Manager which manages the tags for this resource */ readonly cdkTagManager: cdk.TagManager; /** * The friendly name of the data accessor. */ displayName: string; /** * The Amazon Resource Name (ARN) of the IAM role for the ISV associated with this data accessor. */ principal: string; /** * The tags to associate with the data accessor. */ tags?: Array<cdk.CfnTag>; /** * @param scope Scope in which this resource is defined * @param id Construct identifier for this resource (unique in its scope) * @param props Resource properties */ constructor(scope: constructs.Construct, id: string, props: CfnDataAccessorProps); protected get cfnProperties(): Record<string, any>; /** * Examines the CloudFormation resource and discloses attributes * * @param inspector tree inspector to collect and process attributes */ inspect(inspector: cdk.TreeInspector): void; protected renderProperties(props: Record<string, any>): Record<string, any>; } export declare namespace CfnDataAccessor { /** * Specifies an allowed action and its associated filter configuration. * * @struct * @stability external * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-actionconfiguration.html */ interface ActionConfigurationProperty { /** * The Amazon Q Business action that is allowed. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-actionconfiguration.html#cfn-qbusiness-dataaccessor-actionconfiguration-action */ readonly action: string; /** * The filter configuration for the action, if any. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-actionconfiguration.html#cfn-qbusiness-dataaccessor-actionconfiguration-filterconfiguration */ readonly filterConfiguration?: CfnDataAccessor.ActionFilterConfigurationProperty | cdk.IResolvable; } /** * Specifies filters to apply to an allowed action. * * @struct * @stability external * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-actionfilterconfiguration.html */ interface ActionFilterConfigurationProperty { /** * Enables filtering of responses based on document attributes or metadata fields. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-actionfilterconfiguration.html#cfn-qbusiness-dataaccessor-actionfilterconfiguration-documentattributefilter */ readonly documentAttributeFilter: CfnDataAccessor.AttributeFilterProperty | cdk.IResolvable; } /** * Enables filtering of responses based on document attributes or metadata fields. * * @struct * @stability external * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-attributefilter.html */ interface AttributeFilterProperty { /** * Performs a logical `AND` operation on all supplied filters. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-attributefilter.html#cfn-qbusiness-dataaccessor-attributefilter-andallfilters */ readonly andAllFilters?: Array<CfnDataAccessor.AttributeFilterProperty | cdk.IResolvable> | cdk.IResolvable; /** * Returns `true` when a document contains all the specified document attributes or metadata fields. * * Supported for the following [document attribute value types](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeValue.html) : `stringListValue` . * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-attributefilter.html#cfn-qbusiness-dataaccessor-attributefilter-containsall */ readonly containsAll?: CfnDataAccessor.DocumentAttributeProperty | cdk.IResolvable; /** * Returns `true` when a document contains any of the specified document attributes or metadata fields. * * Supported for the following [document attribute value types](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeValue.html) : `stringListValue` . * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-attributefilter.html#cfn-qbusiness-dataaccessor-attributefilter-containsany */ readonly containsAny?: CfnDataAccessor.DocumentAttributeProperty | cdk.IResolvable; /** * Performs an equals operation on two document attributes or metadata fields. * * Supported for the following [document attribute value types](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeValue.html) : `dateValue` , `longValue` , `stringListValue` and `stringValue` . * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-attributefilter.html#cfn-qbusiness-dataaccessor-attributefilter-equalsto */ readonly equalsTo?: CfnDataAccessor.DocumentAttributeProperty | cdk.IResolvable; /** * Performs a greater than operation on two document attributes or metadata fields. * * Supported for the following [document attribute value types](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeValue.html) : `dateValue` and `longValue` . * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-attributefilter.html#cfn-qbusiness-dataaccessor-attributefilter-greaterthan */ readonly greaterThan?: CfnDataAccessor.DocumentAttributeProperty | cdk.IResolvable; /** * Performs a greater or equals than operation on two document attributes or metadata fields. * * Supported for the following [document attribute value types](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeValue.html) : `dateValue` and `longValue` . * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-attributefilter.html#cfn-qbusiness-dataaccessor-attributefilter-greaterthanorequals */ readonly greaterThanOrEquals?: CfnDataAccessor.DocumentAttributeProperty | cdk.IResolvable; /** * Performs a less than operation on two document attributes or metadata fields. * * Supported for the following [document attribute value types](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeValue.html) : `dateValue` and `longValue` . * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-attributefilter.html#cfn-qbusiness-dataaccessor-attributefilter-lessthan */ readonly lessThan?: CfnDataAccessor.DocumentAttributeProperty | cdk.IResolvable; /** * Performs a less than or equals operation on two document attributes or metadata fields.Supported for the following [document attribute value type](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeValue.html) : `dateValue` and `longValue` . * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-attributefilter.html#cfn-qbusiness-dataaccessor-attributefilter-lessthanorequals */ readonly lessThanOrEquals?: CfnDataAccessor.DocumentAttributeProperty | cdk.IResolvable; /** * Performs a logical `NOT` operation on all supplied filters. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-attributefilter.html#cfn-qbusiness-dataaccessor-attributefilter-notfilter */ readonly notFilter?: CfnDataAccessor.AttributeFilterProperty | cdk.IResolvable; /** * Performs a logical `OR` operation on all supplied filters. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-attributefilter.html#cfn-qbusiness-dataaccessor-attributefilter-orallfilters */ readonly orAllFilters?: Array<CfnDataAccessor.AttributeFilterProperty | cdk.IResolvable> | cdk.IResolvable; } /** * A document attribute or metadata field. * * @struct * @stability external * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-documentattribute.html */ interface DocumentAttributeProperty { /** * The identifier for the attribute. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-documentattribute.html#cfn-qbusiness-dataaccessor-documentattribute-name */ readonly name: string; /** * The value of the attribute. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-documentattribute.html#cfn-qbusiness-dataaccessor-documentattribute-value */ readonly value: CfnDataAccessor.DocumentAttributeValueProperty | cdk.IResolvable; } /** * The value of a document attribute. * * You can only provide one value for a document attribute. * * @struct * @stability external * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-documentattributevalue.html */ interface DocumentAttributeValueProperty { /** * 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. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-documentattributevalue.html#cfn-qbusiness-dataaccessor-documentattributevalue-datevalue */ readonly dateValue?: string; /** * A long integer value. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-documentattributevalue.html#cfn-qbusiness-dataaccessor-documentattributevalue-longvalue */ readonly longValue?: number; /** * A list of strings. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-documentattributevalue.html#cfn-qbusiness-dataaccessor-documentattributevalue-stringlistvalue */ readonly stringListValue?: Array<string>; /** * A string. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-dataaccessor-documentattributevalue.html#cfn-qbusiness-dataaccessor-documentattributevalue-stringvalue */ readonly stringValue?: string; } } /** * Properties for defining a `CfnDataAccessor` * * @struct * @stability external * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-dataaccessor.html */ export interface CfnDataAccessorProps { /** * A list of action configurations specifying the allowed actions and any associated filters. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-dataaccessor.html#cfn-qbusiness-dataaccessor-actionconfigurations */ readonly actionConfigurations: Array<CfnDataAccessor.ActionConfigurationProperty | cdk.IResolvable> | cdk.IResolvable; /** * The unique identifier of the Amazon Q Business application. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-dataaccessor.html#cfn-qbusiness-dataaccessor-applicationid */ readonly applicationId: string; /** * The friendly name of the data accessor. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-dataaccessor.html#cfn-qbusiness-dataaccessor-displayname */ readonly displayName: string; /** * The Amazon Resource Name (ARN) of the IAM role for the ISV associated with this data accessor. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-dataaccessor.html#cfn-qbusiness-dataaccessor-principal */ readonly principal: string; /** * The tags to associate with the data accessor. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-dataaccessor.html#cfn-qbusiness-dataaccessor-tags */ readonly tags?: Array<cdk.CfnTag>; } /** * Creates a data source connector for an Amazon Q Business application. * * `CreateDataSource` is a synchronous operation. The operation returns 200 if the data source was successfully created. Otherwise, an exception is raised. * * @cloudformationResource AWS::QBusiness::DataSource * @stability external * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-qbusiness-datasource.html */ export declare class CfnDataSource extends cdk.CfnResource implements cdk.IInspectable, cdk.ITaggableV2 { /** * The CloudFormation resource type name for this resource class. */ static readonly CFN_RESOURCE_TYPE_NAME: string; /** * Build a CfnDataSource from CloudFormation properties * * A factory method that creates a new instance of this class from an object * containing the CloudFormation properties of this resource. * Used in the @aws-cdk/cloudformation-include module. * * @internal */ static _fromCloudFormation(scope: constructs.Construct, id: string, resourceAttributes: any, options: cfn_parse.FromCloudFormationOptions): CfnDataSource; /** * The Unix timestamp when the Amazon Q Business data source was created. * * @cloudformationAttribute CreatedAt */ readonly attrCreatedAt: string; /** * The Amazon Resource Name (ARN) of a data source in an Amazon Q Business application. * * @cloudformationAttribute DataSourceArn */ readonly attrDataSourceArn: string; /** * The identifier of the Amazon Q Business data source. * * @cloudformationAttribute DataSourceId */ readonly attrDataSourceId: string; /** * The status of the Amazon Q Business data source. * * @cloudformationAttribute Status */ readonly attrStatus: string; /** * The type of the Amazon Q Business data source. * * @cloudformationAttribute Type */ readonly attrType: string; /** * The Unix timestamp when the Amazon Q Business data source was last updated. * * @cloudformationAttribute UpdatedAt */ readonly attrUpdatedAt: string; /** * The identifier of the Amazon Q Business application the data source will be attached to. */ applicationId: string; /** * Tag Manager which manages the tags for this resource */ readonly cdkTagManager: cdk.TagManager; /** * Use this property to specify a JSON or YAML schema with configuration properties specific to your data source connector to connect your data source repository to Amazon Q Business . */ configuration: any | cdk.IResolvable; /** * A description for the data source connector. */ description?: string; /** * The name of the Amazon Q Business data source. */ displayName: string; /** * Provides the configuration information for altering document metadata and content during the document ingestion process. */ documentEnrichmentConfiguration?: CfnDataSource.DocumentEnrichmentConfigurationProperty | cdk.IResolvable; /** * The identifier of the index the data source is attached to. */ indexId: string; /** * The configuration for extracting information from media in documents. */ mediaExtractionConfiguration?: cdk.IResolvable | CfnDataSource.MediaExtractionConfigurationProperty; /** * The Amazon Resource Name (ARN) of an IAM role with permission to access the data source and required resources. */ roleArn?: string; /** * Sets the frequency for Amazon Q Business to check the documents in your data source repository and update your index. */ syncSchedule?: string; /** * A list of key-value pairs that identify or categorize the data source connector. */ tags?: Array<cdk.CfnTag>; /** * Configuration information for an Amazon VPC (Virtual Private Cloud) to connect to your data source. */ vpcConfiguration?: CfnDataSource.DataSourceVpcConfigurationProperty | cdk.IResolvable; /** * @param scope Scope in which this resource is defined * @param id Construct identifier for this resource (unique in its scope) * @param props Resource properties */ constructor(scope: constructs.Construct, id: string, props: CfnDataSourceProps); protected get cfnProperties(): Record<string, any>; /** * Examines the CloudFormation resource and discloses attributes * * @param inspector tree inspector to collect and process attributes */ inspect(inspector: cdk.TreeInspector): void; protected renderProperties(props: Record<string, any>): Record<string, any>; } export declare namespace CfnDataSource { /** * Provides the configuration information for altering document metadata and content during the document ingestion process. * * For more information, see [Custom document enrichment](https://docs.aws.amazon.com/amazonq/latest/business-use-dg/custom-document-enrichment.html) . * * @struct * @stability external * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-datasource-documentenrichmentconfiguration.html */ interface DocumentEnrichmentConfigurationProperty { /** * Configuration information to alter document attributes or metadata fields and content when ingesting documents into Amazon Q Business. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-datasource-documentenrichmentconfiguration.html#cfn-qbusiness-datasource-documentenrichmentconfiguration-inlineconfigurations */ readonly inlineConfigurations?: Array<CfnDataSource.InlineDocumentEnrichmentConfigurationProperty | cdk.IResolvable> | cdk.IResolvable; /** * Configuration information for invoking a Lambda function in AWS Lambda on the structured documents with their metadata and text extracted. * * You can use a Lambda function to apply advanced logic for creating, modifying, or deleting document metadata and content. For more information, see [Using Lambda functions](https://docs.aws.amazon.com/amazonq/latest/business-use-dg/cde-lambda-operations.html) . * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-datasource-documentenrichmentconfiguration.html#cfn-qbusiness-datasource-documentenrichmentconfiguration-postextractionhookconfiguration */ readonly postExtractionHookConfiguration?: CfnDataSource.HookConfigurationProperty | cdk.IResolvable; /** * Configuration information for invoking a Lambda function in AWS Lambda on the original or raw documents before extracting their metadata and text. * * You can use a Lambda function to apply advanced logic for creating, modifying, or deleting document metadata and content. For more information, see [Using Lambda functions](https://docs.aws.amazon.com/amazonq/latest/business-use-dg/cde-lambda-operations.html) . * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-datasource-documentenrichmentconfiguration.html#cfn-qbusiness-datasource-documentenrichmentconfiguration-preextractionhookconfiguration */ readonly preExtractionHookConfiguration?: CfnDataSource.HookConfigurationProperty | cdk.IResolvable; } /** * Provides the configuration information for applying basic logic to alter document metadata and content when ingesting documents into Amazon Q Business. * * To apply advanced logic, to go beyond what you can do with basic logic, see [`HookConfiguration`](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_HookConfiguration.html) . * * For more information, see [Custom document enrichment](https://docs.aws.amazon.com/amazonq/latest/business-use-dg/custom-document-enrichment.html) . * * @struct * @stability external * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-datasource-inlinedocumentenrichmentconfiguration.html */ interface InlineDocumentEnrichmentConfigurationProperty { /** * Configuration of the condition used for the target document attribute or metadata field when ingesting documents into Amazon Q Business . * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-datasource-inlinedocumentenrichmentconfiguration.html#cfn-qbusiness-datasource-inlinedocumentenrichmentconfiguration-condition */ readonly condition?: CfnDataSource.DocumentAttributeConditionProperty | cdk.IResolvable; /** * `TRUE` to delete content if the condition used for the target attribute is met. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-datasource-inlinedocumentenrichmentconfiguration.html#cfn-qbusiness-datasource-inlinedocumentenrichmentconfiguration-documentcontentoperator */ readonly documentContentOperator?: string; /** * Configuration of the target document attribute or metadata field when ingesting documents into Amazon Q Business . * * You can also include a value. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-datasource-inlinedocumentenrichmentconfiguration.html#cfn-qbusiness-datasource-inlinedocumentenrichmentconfiguration-target */ readonly target?: CfnDataSource.DocumentAttributeTargetProperty | cdk.IResolvable; } /** * The condition used for the target document attribute or metadata field when ingesting documents into Amazon Q Business. * * You use this with [`DocumentAttributeTarget`](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeTarget.html) to apply the condition. * * For example, you can create the 'Department' target field and have it prefill department names associated with the documents based on information in the 'Source_URI' field. Set the condition that if the 'Source_URI' field contains 'financial' in its URI value, then prefill the target field 'Department' with the target value 'Finance' for the document. * * Amazon Q Business can't create a target field if it has not already been created as an index field. After you create your index field, you can create a document metadata field using `DocumentAttributeTarget` . Amazon Q Business then will map your newly created metadata field to your index field. * * @struct * @stability external * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-datasource-documentattributecondition.html */ interface DocumentAttributeConditionProperty { /** * The identifier of the document attribute used for the condition. * * For example, 'Source_URI' could be an identifier for the attribute or metadata field that contains source URIs associated with the documents. * * Amazon Q Business currently doesn't support `_document_body` as an attribute key used for the condition. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-datasource-documentattributecondition.html#cfn-qbusiness-datasource-documentattributecondition-key */ readonly key: string; /** * The identifier of the document attribute used for the condition. * * For example, 'Source_URI' could be an identifier for the attribute or metadata field that contains source URIs associated with the documents. * * Amazon Q Business currently does not support `_document_body` as an attribute key used for the condition. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-datasource-documentattributecondition.html#cfn-qbusiness-datasource-documentattributecondition-operator */ readonly operator: string; /** * The value of a document attribute. * * You can only provide one value for a document attribute. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-datasource-documentattributecondition.html#cfn-qbusiness-datasource-documentattributecondition-value */ readonly value?: CfnDataSource.DocumentAttributeValueProperty | cdk.IResolvable; } /** * The value of a document attribute. * * You can only provide one value for a document attribute. * * @struct * @stability external * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-datasource-documentattributevalue.html */ interface DocumentAttributeValueProperty { /** * 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. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-datasource-documentattributevalue.html#cfn-qbusiness-datasource-documentattributevalue-datevalue */ readonly dateValue?: string; /** * A long integer value. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-datasource-documentattributevalue.html#cfn-qbusiness-datasource-documentattributevalue-longvalue */ readonly longValue?: number; /** * A list of strings. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-datasource-documentattributevalue.html#cfn-qbusiness-datasource-documentattributevalue-stringlistvalue */ readonly stringListValue?: Array<string>; /** * A string. * * @see http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-qbusiness-datasource-documentattributevalue.html#cfn-qbusiness-datasource-documentattributevalue-stringvalue */ readonly stringValue?: string; } /** * The target document attribute or metadata field you want to alter when ingesting documents into Amazon Q Business. * * For example, you can delete all customer identification numbers associated with the documents, stored in the document metadata field called 'Customer_ID' by setting the target key as 'Customer_ID' and the deletion flag to `TRUE` . This removes all customer ID values in the field 'Customer_ID'. This would scrub personally identifiable information from each document's metadata. * * Amazon Q Business can't create a target field if it has not already been created as an index field. After you create your index field, you can create a document metadata field using [`DocumentAttributeTarget`](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeTarget.html) . Amazon Q Business will then map your newly created document attribute to your index field. * * You can also use this with [`DocumentAttributeCondition`](https://docs.aws.amazon.com/amazonq/la