BoxConfiguration
Provides the configuration information to connect to Box as your data source.
Contents
- EnterpriseId
-
The identifier of the Box Enterprise platform. You can find the enterprise ID in the Box Developer Console settings or when you create an app in Box and download your authentication credentials. For example, 801234567.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 64.
Pattern:
^[A-Z0-9]*$
Required: Yes
- SecretArn
-
The Amazon Resource Name (ARN) of an AWS Secrets Manager secret that contains the key-value pairs required to connect to your Box platform. The secret must contain a JSON structure with the following keys:
-
clientID—The identifier of the client OAuth 2.0 authentication application created in Box.
-
clientSecret—A set of characters known only to the OAuth 2.0 authentication application created in Box.
-
publicKeyId—The identifier of the public key contained within an identity certificate.
-
privateKey—A set of characters that make up an encryption key.
-
passphrase—A set of characters that act like a password.
You create an application in Box to generate the keys or credentials required for the secret. For more information, see Using a Box data source.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 1284.
Pattern:
arn:[a-z0-9-\.]{1,63}:[a-z0-9-\.]{0,63}:[a-z0-9-\.]{0,63}:[a-z0-9-\.]{0,63}:[^/].{0,1023}
Required: Yes
-
- CommentFieldMappings
-
A list of
DataSourceToIndexFieldMapping
objects that map attributes or field names of Box comments to Amazon Kendra index field names. To create custom fields, use theUpdateIndex
API before you map to Box fields. For more information, see Mapping data source fields. The Box field names must exist in your Box custom metadata.Type: Array of DataSourceToIndexFieldMapping objects
Array Members: Minimum number of 1 item. Maximum number of 100 items.
Required: No
- CrawlComments
-
TRUE
to index comments.Type: Boolean
Required: No
- CrawlTasks
-
TRUE
to index the contents of tasks.Type: Boolean
Required: No
- CrawlWebLinks
-
TRUE
to index web links.Type: Boolean
Required: No
- ExclusionPatterns
-
A list of regular expression patterns to exclude certain files and folders from your Box platform. Files and folders that match the patterns are excluded from the index.Files and folders that don't match the patterns are included in the index. If a file or folder matches both an inclusion and exclusion pattern, the exclusion pattern takes precedence and the file or folder isn't included in the index.
Type: Array of strings
Array Members: Minimum number of 0 items. Maximum number of 250 items.
Length Constraints: Minimum length of 1. Maximum length of 300.
Required: No
- FileFieldMappings
-
A list of
DataSourceToIndexFieldMapping
objects that map attributes or field names of Box files to Amazon Kendra index field names. To create custom fields, use theUpdateIndex
API before you map to Box fields. For more information, see Mapping data source fields. The Box field names must exist in your Box custom metadata.Type: Array of DataSourceToIndexFieldMapping objects
Array Members: Minimum number of 1 item. Maximum number of 100 items.
Required: No
- InclusionPatterns
-
A list of regular expression patterns to include certain files and folders in your Box platform. Files and folders that match the patterns are included in the index. Files and folders that don't match the patterns are excluded from the index. If a file or folder matches both an inclusion and exclusion pattern, the exclusion pattern takes precedence and the file or folder isn't included in the index.
Type: Array of strings
Array Members: Minimum number of 0 items. Maximum number of 250 items.
Length Constraints: Minimum length of 1. Maximum length of 300.
Required: No
- TaskFieldMappings
-
A list of
DataSourceToIndexFieldMapping
objects that map attributes or field names of Box tasks to Amazon Kendra index field names. To create custom fields, use theUpdateIndex
API before you map to Box fields. For more information, see Mapping data source fields. The Box field names must exist in your Box custom metadata.Type: Array of DataSourceToIndexFieldMapping objects
Array Members: Minimum number of 1 item. Maximum number of 100 items.
Required: No
- UseChangeLog
-
TRUE
to use the Slack change log to determine which documents require updating in the index. Depending on the data source change log's size, it may take longer for Amazon Kendra to use the change log than to scan all of your documents.Type: Boolean
Required: No
- VpcConfiguration
-
Configuration information for an Amazon VPC to connect to your Box. For more information, see Configuring a VPC.
Type: DataSourceVpcConfiguration object
Required: No
- WebLinkFieldMappings
-
A list of
DataSourceToIndexFieldMapping
objects that map attributes or field names of Box web links to Amazon Kendra index field names. To create custom fields, use theUpdateIndex
API before you map to Box fields. For more information, see Mapping data source fields. The Box field names must exist in your Box custom metadata.Type: Array of DataSourceToIndexFieldMapping objects
Array Members: Minimum number of 1 item. Maximum number of 100 items.
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: