> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Datastores

Retrieve a list of datastores based on specified filters.

**Required Permission**:

* `cyera.read.datastore`

<Note>
  External Documentation

  To learn more, visit the [Cyera documentation](https://api.cyera.io/docs#tag/datastores/get/v2/datastores).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter             | Description                                                                          |
  | --------------------- | ------------------------------------------------------------------------------------ |
  | Created After         | Retrieve datastores created on or after the specified timestamp.                     |
  | Datastore Name        | A datastore name to filter by.                                                       |
  | Datastore UIDs        | A comma-separated list of datastore UIDs to filter by.                               |
  | Infrastructure        | A comma-separated list of infrastructures to filter by.                              |
  | Limit                 | The maximum number of datastores to retrieve in the result. Valid range is `1-1000`. |
  | Offset                | The pagination offset indicating the starting point for the next set of results.     |
  | Platform Identifier   | An Account platform identifier to filter by.                                         |
  | Provider              | A datastore provider to filter by.                                                   |
  | Regions               | A comma-separated list of regions to filter by.                                      |
  | Return All Pages      | Automatically fetch all resources, page by page.                                     |
  | Scanning State Status | A comma-separated list of scanning state statuses to filter by.                      |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter                | Description                                                                               |
  | ------------------------ | ----------------------------------------------------------------------------------------- |
  | Cloud Provider URL       | A datastore cloud provider URL to filter by.                                              |
  | Datastore Data Type      | A datastore data type to filter by.                                                       |
  | Datastore Size In GB     | The size (GB) of the datastore to filter by (applies to unstructured datastores only).    |
  | Discovery Date After     | Retrieve datastores discovered on or after the specified timestamp.                       |
  | Discovery Date Before    | Retrieve datastores discovered on or before the specified timestamp.                      |
  | Latest Scan After        | Retrieve datastores whose latest data scan occurred on or after the specified timestamp.  |
  | Latest Scan Before       | Retrieve datastores whose latest data scan occurred on or before the specified timestamp. |
  | Modification Time After  | Retrieve datastores which were last modified on or after the specified timestamp.         |
  | Modification Time Before | Retrieve datastores which were last modified on or before the specified timestamp.        |
  | Project IDs              | A comma-separated list of project IDs to filter by.                                       |
  | Was Scanned              | Select to filter datastores that were scanned.                                            |
</div>

## Example Output

```json theme={"dark"}
{
	"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](https://library.blinkops.com/workflows/list-datastores-with-cyera-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-datastores-with-cyera-and-send-results-via-email/canvas" />
</div>