UpdateDataSource
Updates an existing Amazon Kendra data source.
Request Syntax
{
"Configuration": {
"BoxConfiguration": {
"CommentFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"CrawlComments": boolean
,
"CrawlTasks": boolean
,
"CrawlWebLinks": boolean
,
"EnterpriseId": "string
",
"ExclusionPatterns": [ "string
" ],
"FileFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"InclusionPatterns": [ "string
" ],
"SecretArn": "string
",
"TaskFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"UseChangeLog": boolean
,
"VpcConfiguration": {
"SecurityGroupIds": [ "string
" ],
"SubnetIds": [ "string
" ]
},
"WebLinkFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
]
},
"ConfluenceConfiguration": {
"AttachmentConfiguration": {
"AttachmentFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"CrawlAttachments": boolean
},
"BlogConfiguration": {
"BlogFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
]
},
"ExclusionPatterns": [ "string
" ],
"InclusionPatterns": [ "string
" ],
"PageConfiguration": {
"PageFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
]
},
"SecretArn": "string
",
"ServerUrl": "string
",
"SpaceConfiguration": {
"CrawlArchivedSpaces": boolean
,
"CrawlPersonalSpaces": boolean
,
"ExcludeSpaces": [ "string
" ],
"IncludeSpaces": [ "string
" ],
"SpaceFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
]
},
"Version": "string
",
"VpcConfiguration": {
"SecurityGroupIds": [ "string
" ],
"SubnetIds": [ "string
" ]
}
},
"DatabaseConfiguration": {
"AclConfiguration": {
"AllowedGroupsColumnName": "string
"
},
"ColumnConfiguration": {
"ChangeDetectingColumns": [ "string
" ],
"DocumentDataColumnName": "string
",
"DocumentIdColumnName": "string
",
"DocumentTitleColumnName": "string
",
"FieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
]
},
"ConnectionConfiguration": {
"DatabaseHost": "string
",
"DatabaseName": "string
",
"DatabasePort": number
,
"SecretArn": "string
",
"TableName": "string
"
},
"DatabaseEngineType": "string
",
"SqlConfiguration": {
"QueryIdentifiersEnclosingOption": "string
"
},
"VpcConfiguration": {
"SecurityGroupIds": [ "string
" ],
"SubnetIds": [ "string
" ]
}
},
"FsxConfiguration": {
"ExclusionPatterns": [ "string
" ],
"FieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"FileSystemId": "string
",
"FileSystemType": "string
",
"InclusionPatterns": [ "string
" ],
"SecretArn": "string
",
"VpcConfiguration": {
"SecurityGroupIds": [ "string
" ],
"SubnetIds": [ "string
" ]
}
},
"GitHubConfiguration": {
"ExclusionFileNamePatterns": [ "string
" ],
"ExclusionFileTypePatterns": [ "string
" ],
"ExclusionFolderNamePatterns": [ "string
" ],
"GitHubCommitConfigurationFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"GitHubDocumentCrawlProperties": {
"CrawlIssue": boolean
,
"CrawlIssueComment": boolean
,
"CrawlIssueCommentAttachment": boolean
,
"CrawlPullRequest": boolean
,
"CrawlPullRequestComment": boolean
,
"CrawlPullRequestCommentAttachment": boolean
,
"CrawlRepositoryDocuments": boolean
},
"GitHubIssueAttachmentConfigurationFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"GitHubIssueCommentConfigurationFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"GitHubIssueDocumentConfigurationFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"GitHubPullRequestCommentConfigurationFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"GitHubPullRequestDocumentAttachmentConfigurationFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"GitHubPullRequestDocumentConfigurationFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"GitHubRepositoryConfigurationFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"InclusionFileNamePatterns": [ "string
" ],
"InclusionFileTypePatterns": [ "string
" ],
"InclusionFolderNamePatterns": [ "string
" ],
"OnPremiseConfiguration": {
"HostUrl": "string
",
"OrganizationName": "string
",
"SslCertificateS3Path": {
"Bucket": "string
",
"Key": "string
"
}
},
"RepositoryFilter": [ "string
" ],
"SaaSConfiguration": {
"HostUrl": "string
",
"OrganizationName": "string
"
},
"SecretArn": "string
",
"Type": "string
",
"UseChangeLog": boolean
,
"VpcConfiguration": {
"SecurityGroupIds": [ "string
" ],
"SubnetIds": [ "string
" ]
}
},
"GoogleDriveConfiguration": {
"ExcludeMimeTypes": [ "string
" ],
"ExcludeSharedDrives": [ "string
" ],
"ExcludeUserAccounts": [ "string
" ],
"ExclusionPatterns": [ "string
" ],
"FieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"InclusionPatterns": [ "string
" ],
"SecretArn": "string
"
},
"JiraConfiguration": {
"AttachmentFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"CommentFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"ExclusionPatterns": [ "string
" ],
"InclusionPatterns": [ "string
" ],
"IssueFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"IssueSubEntityFilter": [ "string
" ],
"IssueType": [ "string
" ],
"JiraAccountUrl": "string
",
"Project": [ "string
" ],
"ProjectFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"SecretArn": "string
",
"Status": [ "string
" ],
"UseChangeLog": boolean
,
"VpcConfiguration": {
"SecurityGroupIds": [ "string
" ],
"SubnetIds": [ "string
" ]
},
"WorkLogFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
]
},
"OneDriveConfiguration": {
"DisableLocalGroups": boolean
,
"ExclusionPatterns": [ "string
" ],
"FieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"InclusionPatterns": [ "string
" ],
"OneDriveUsers": {
"OneDriveUserList": [ "string
" ],
"OneDriveUserS3Path": {
"Bucket": "string
",
"Key": "string
"
}
},
"SecretArn": "string
",
"TenantDomain": "string
"
},
"QuipConfiguration": {
"AttachmentFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"CrawlAttachments": boolean
,
"CrawlChatRooms": boolean
,
"CrawlFileComments": boolean
,
"Domain": "string
",
"ExclusionPatterns": [ "string
" ],
"FolderIds": [ "string
" ],
"InclusionPatterns": [ "string
" ],
"MessageFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"SecretArn": "string
",
"ThreadFieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"VpcConfiguration": {
"SecurityGroupIds": [ "string
" ],
"SubnetIds": [ "string
" ]
}
},
"S3Configuration": {
"AccessControlListConfiguration": {
"KeyPath": "string
"
},
"BucketName": "string
",
"DocumentsMetadataConfiguration": {
"S3Prefix": "string
"
},
"ExclusionPatterns": [ "string
" ],
"InclusionPatterns": [ "string
" ],
"InclusionPrefixes": [ "string
" ]
},
"SalesforceConfiguration": {
"ChatterFeedConfiguration": {
"DocumentDataFieldName": "string
",
"DocumentTitleFieldName": "string
",
"FieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"IncludeFilterTypes": [ "string
" ]
},
"CrawlAttachments": boolean
,
"ExcludeAttachmentFilePatterns": [ "string
" ],
"IncludeAttachmentFilePatterns": [ "string
" ],
"KnowledgeArticleConfiguration": {
"CustomKnowledgeArticleTypeConfigurations": [
{
"DocumentDataFieldName": "string
",
"DocumentTitleFieldName": "string
",
"FieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"Name": "string
"
}
],
"IncludedStates": [ "string
" ],
"StandardKnowledgeArticleTypeConfiguration": {
"DocumentDataFieldName": "string
",
"DocumentTitleFieldName": "string
",
"FieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
]
}
},
"SecretArn": "string
",
"ServerUrl": "string
",
"StandardObjectAttachmentConfiguration": {
"DocumentTitleFieldName": "string
",
"FieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
]
},
"StandardObjectConfigurations": [
{
"DocumentDataFieldName": "string
",
"DocumentTitleFieldName": "string
",
"FieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"Name": "string
"
}
]
},
"ServiceNowConfiguration": {
"AuthenticationType": "string
",
"HostUrl": "string
",
"KnowledgeArticleConfiguration": {
"CrawlAttachments": boolean
,
"DocumentDataFieldName": "string
",
"DocumentTitleFieldName": "string
",
"ExcludeAttachmentFilePatterns": [ "string
" ],
"FieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"FilterQuery": "string
",
"IncludeAttachmentFilePatterns": [ "string
" ]
},
"SecretArn": "string
",
"ServiceCatalogConfiguration": {
"CrawlAttachments": boolean
,
"DocumentDataFieldName": "string
",
"DocumentTitleFieldName": "string
",
"ExcludeAttachmentFilePatterns": [ "string
" ],
"FieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"IncludeAttachmentFilePatterns": [ "string
" ]
},
"ServiceNowBuildVersion": "string
"
},
"SharePointConfiguration": {
"CrawlAttachments": boolean
,
"DisableLocalGroups": boolean
,
"DocumentTitleFieldName": "string
",
"ExclusionPatterns": [ "string
" ],
"FieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"InclusionPatterns": [ "string
" ],
"SecretArn": "string
",
"SharePointVersion": "string
",
"SslCertificateS3Path": {
"Bucket": "string
",
"Key": "string
"
},
"Urls": [ "string
" ],
"UseChangeLog": boolean
,
"VpcConfiguration": {
"SecurityGroupIds": [ "string
" ],
"SubnetIds": [ "string
" ]
}
},
"SlackConfiguration": {
"CrawlBotMessage": boolean
,
"ExcludeArchived": boolean
,
"ExclusionPatterns": [ "string
" ],
"FieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"InclusionPatterns": [ "string
" ],
"LookBackPeriod": number
,
"PrivateChannelFilter": [ "string
" ],
"PublicChannelFilter": [ "string
" ],
"SecretArn": "string
",
"SinceCrawlDate": "string
",
"SlackEntityList": [ "string
" ],
"TeamId": "string
",
"UseChangeLog": boolean
,
"VpcConfiguration": {
"SecurityGroupIds": [ "string
" ],
"SubnetIds": [ "string
" ]
}
},
"WebCrawlerConfiguration": {
"AuthenticationConfiguration": {
"BasicAuthentication": [
{
"Credentials": "string
",
"Host": "string
",
"Port": number
}
]
},
"CrawlDepth": number
,
"MaxContentSizePerPageInMegaBytes": number
,
"MaxLinksPerPage": number
,
"MaxUrlsPerMinuteCrawlRate": number
,
"ProxyConfiguration": {
"Credentials": "string
",
"Host": "string
",
"Port": number
},
"UrlExclusionPatterns": [ "string
" ],
"UrlInclusionPatterns": [ "string
" ],
"Urls": {
"SeedUrlConfiguration": {
"SeedUrls": [ "string
" ],
"WebCrawlerMode": "string
"
},
"SiteMapsConfiguration": {
"SiteMaps": [ "string
" ]
}
}
},
"WorkDocsConfiguration": {
"CrawlComments": boolean
,
"ExclusionPatterns": [ "string
" ],
"FieldMappings": [
{
"DataSourceFieldName": "string
",
"DateFieldFormat": "string
",
"IndexFieldName": "string
"
}
],
"InclusionPatterns": [ "string
" ],
"OrganizationId": "string
",
"UseChangeLog": boolean
}
},
"CustomDocumentEnrichmentConfiguration": {
"InlineConfigurations": [
{
"Condition": {
"ConditionDocumentAttributeKey": "string
",
"ConditionOnValue": {
"DateValue": number
,
"LongValue": number
,
"StringListValue": [ "string
" ],
"StringValue": "string
"
},
"Operator": "string
"
},
"DocumentContentDeletion": boolean
,
"Target": {
"TargetDocumentAttributeKey": "string
",
"TargetDocumentAttributeValue": {
"DateValue": number
,
"LongValue": number
,
"StringListValue": [ "string
" ],
"StringValue": "string
"
},
"TargetDocumentAttributeValueDeletion": boolean
}
}
],
"PostExtractionHookConfiguration": {
"InvocationCondition": {
"ConditionDocumentAttributeKey": "string
",
"ConditionOnValue": {
"DateValue": number
,
"LongValue": number
,
"StringListValue": [ "string
" ],
"StringValue": "string
"
},
"Operator": "string
"
},
"LambdaArn": "string
",
"S3Bucket": "string
"
},
"PreExtractionHookConfiguration": {
"InvocationCondition": {
"ConditionDocumentAttributeKey": "string
",
"ConditionOnValue": {
"DateValue": number
,
"LongValue": number
,
"StringListValue": [ "string
" ],
"StringValue": "string
"
},
"Operator": "string
"
},
"LambdaArn": "string
",
"S3Bucket": "string
"
},
"RoleArn": "string
"
},
"Description": "string
",
"Id": "string
",
"IndexId": "string
",
"LanguageCode": "string
",
"Name": "string
",
"RoleArn": "string
",
"Schedule": "string
"
}
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
The request accepts the following data in JSON format.
- Configuration
-
Configuration information for an Amazon Kendra data source you want to update.
Type: DataSourceConfiguration object
Required: No
- CustomDocumentEnrichmentConfiguration
-
Configuration information for altering document metadata and content during the document ingestion process when you update a data source.
For more information on how to create, modify and delete document metadata, or make other content alterations when you ingest documents into Amazon Kendra, see Customizing document metadata during the ingestion process.
Type: CustomDocumentEnrichmentConfiguration object
Required: No
- Description
-
The description of the data source you want to update.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 1000.
Pattern:
^\P{C}*$
Required: No
- Id
-
The identifier of the data source you want to update.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 100.
Pattern:
[a-zA-Z0-9][a-zA-Z0-9_-]*
Required: Yes
- IndexId
-
The identifier of the index used with the data source you want to update.
Type: String
Length Constraints: Fixed length of 36.
Pattern:
[a-zA-Z0-9][a-zA-Z0-9-]*
Required: Yes
- LanguageCode
-
The code for a language. This allows you to support a language for all documents when updating the data source. English is supported by default. For more information on supported languages, including their codes, see Adding documents in languages other than English.
Type: String
Length Constraints: Minimum length of 2. Maximum length of 10.
Pattern:
[a-zA-Z-]*
Required: No
- Name
-
The name of the data source you want to update. You must first delete the data source and re-create it to change the name of a data source.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 1000.
Pattern:
[a-zA-Z0-9][a-zA-Z0-9_-]*
Required: No
- RoleArn
-
The Amazon Resource Name (ARN) of a role with permission to access the data source. For more information, see IAM Roles for Amazon Kendra.
Type: String
Length Constraints: Minimum length of 0. 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: No
- Schedule
-
The sync schedule for the data source you want to update.
Type: String
Required: No
Response Elements
If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.
Errors
For information about the errors that are common to all actions, see Common Errors.
- AccessDeniedException
-
HTTP Status Code: 400
- ConflictException
-
HTTP Status Code: 400
- InternalServerException
-
HTTP Status Code: 500
- ResourceNotFoundException
-
HTTP Status Code: 400
- ThrottlingException
-
HTTP Status Code: 400
- ValidationException
-
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: