The REST API Connection configuration guidelines can be found here.

Amazon S3 Connector's Connection type must always be specified as "s3".

The Properties specific to the Amazon S3 Connector's Connection are described below.


Amazon S3 Connection Properties


FieldRequiredDefaultMultipleNotesExample
propertiesYes-NoConfiguration object
regionYes-NoThe AWS region where the S3 storage is located."us-east-2"
useGlobalEndpointNotrueNoSet to true to use the global endpoint (if set to false, the connection might fail, depending on the bucket region).true / false
s3StorageClassYes-YesList of storage classes to be retrieved.

[ "Standard",             "ReducedRedundancy"]

indexContainersNofalseNoIf set to true,  folders will be indexed.
true / false
scanRecursivelyNotrueNoIf set to true, discovered items are scanned recursively.true / false
scanExcludedItemsNofalseNoIf set to true, scans excluded container items so documents inside them can be processed.true / false
includesNo[]YesList of regular expressions to match documents to be included in the crawl.[".*sales.*", ".*finance.*"]
excludesNo[]YesList of regular expressions to match documents to be excluded from the crawl.[".*food.*", ".*drinks.*"]

Create example


POST /aspire/_api/connections
{
	"type": "s3",
	"description": "Amazon S3 Connection Test",
	"credential": "5af67012-c59a-44ad-91b5-c1122d963f25",
	"properties": {
		"region": "us-east-2",
		"useGlobalEndpoint": true,
		"s3StorageClass": [
			"Standard",
			"ReducedRedundancy",
			"IntelligentTiering",
			"StandardInfrequentAccess",
			"OneZoneInfrequentAccess",
			"Glacier",
			"DeepArchive"
		],
		"indexContainers": false,
		"scanRecursively": true,
		"scanExcludedItems": false,
		"includes": [],
		"excludes": []
	}
}



  • No labels