Skip to main content
Retrieve a list of datastores based on specified filters. Required Permission:
  • cyera.read.datastore
External DocumentationTo learn more, visit the Cyera documentation.

Basic Parameters

ParameterDescription
Created AfterRetrieve datastores created on or after the specified timestamp.
Datastore NameA datastore name to filter by.
Datastore UIDsA comma-separated list of datastore UIDs to filter by.
InfrastructureA comma-separated list of infrastructures to filter by.
LimitThe maximum number of datastores to retrieve in the result. Valid range is 1-1000.
OffsetThe pagination offset indicating the starting point for the next set of results.
Platform IdentifierAn Account platform identifier to filter by.
ProviderA datastore provider to filter by.
RegionsA comma-separated list of regions to filter by.
Return All PagesAutomatically fetch all resources, page by page.
Scanning State StatusA comma-separated list of scanning state statuses to filter by.

Advanced Parameters

ParameterDescription
Cloud Provider URLA datastore cloud provider URL to filter by.
Datastore Data TypeA datastore data type to filter by.
Datastore Size In GBThe size (GB) of the datastore to filter by (applies to unstructured datastores only).
Discovery Date AfterRetrieve datastores discovered on or after the specified timestamp.
Discovery Date BeforeRetrieve datastores discovered on or before the specified timestamp.
Latest Scan AfterRetrieve datastores whose latest data scan occurred on or after the specified timestamp.
Latest Scan BeforeRetrieve datastores whose latest data scan occurred on or before the specified timestamp.
Modification Time AfterRetrieve datastores which were last modified on or after the specified timestamp.
Modification Time BeforeRetrieve datastores which were last modified on or before the specified timestamp.
Project IDsA comma-separated list of project IDs to filter by.
Was ScannedSelect to filter datastores that were scanned.

Example Output

{
	"limit": 10,
	"offset": 0,
	"results": [
		{
			"account": {
				"inPlatformIdentifier": "012345678901",
				"name": "AWS-QA"
			},
			"arn": "arn:aws:s3:::example-bucket",
			"autoScan": false,
			"azureId": "/subscriptions/.../resourceGroups/...",
			"classificationGroups": [
				"Personal",
				"Health",
				"Financial",
				"IT \u0026 Security",
				"Business \u0026 IP"
			],
			"classificationLevel": "Classification Level",
			"cloudProviderTags": [
				{
					"key": "env",
					"value": "prod"
				},
				{
					"key": "business-owner",
					"value": "some@admin.com"
				}
			],
			"cloudProviderUrl": "https://example.sharepoint.com/sites/example",
			"collections": [
				"Learned",
				"File"
			],
			"createdDate": "2022-11-05T12:51:08.000Z",
			"customCollections": [
				"Custom 1",
				"Custom 2"
			],
			"dataType": "Unstructured",
			"datastoreOwners": [
				{
					"datastoreOwnerUid": "id",
					"datastoreUid": "id",
					"email": "some@admin.com",
					"ownerType": "application-owner",
					"source": "Manual"
				}
			],
			"datastoreSizeInGiB": 0.1096641831099987,
			"discoveredDate": "2022-11-05T12:51:08.000Z",
			"driveId": "3b4d83a8-1fe3-498d-b3d6-8cb15feceabc",
			"encrypted": true,
			"engine": "s3",
			"frameworks": [
				"GDPR - Personal",
				"Reportable Data Breach"
			],
			"ghost": false,
			"infrastructure": "s3",
			"issues": {
				"closed": 0,
				"inProgress": 0,
				"open": 0
			},
			"lastDataRefresh": "The start time of the latest datascan",
			"lastModifiedTime": "The last modified time of the asset. The calculation method varies based on datastore type.",
			"learned": false,
			"logging": "Enabled (Access and Audit Logs)",
			"name": "users-bucket",
			"owner": "some@admin.com",
			"projectIds": [
				"Project ID 1",
				"Project ID 2"
			],
			"provider": "AWS",
			"publicAccessibilityState": "Datastore public accessibility state",
			"rdsEndpoint": "my-database-instance-1234.cluster-abc123xyz.us-west-2.rds.amazonaws.com",
			"recordCountBySensitivity": {
				"Internal": 0,
				"Not Sensitive": 0,
				"Sensitive": 0,
				"Unclassified": 0,
				"Very Sensitive": 0
			},
			"regions": [
				"us-east-1",
				"us-east-2"
			],
			"scanningState": "Scanning State",
			"sensitivity": "VerySensitive",
			"sensitivityDisplayName": "Top Secret",
			"siteId": "example.sharepoint.com,0000000-0000-0000-0000-000000000000,0000000-0000-0000-0000-000000000000",
			"siteName": "Docs",
			"sslEnforced": "Enabled",
			"type": "RDS",
			"uid": "379661c3-ad91-4691-ab58-8704ff5f6a9e",
			"userId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
			"userTags": [
				{
					"key": "env",
					"uid": "id",
					"value": "prod"
				}
			],
			"vpc": "Virtual Private Network"
		}
	],
	"total": 1
}

Workflow Library Example

List Datastores with Cyera and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop