---
title: "GET /datasets"
method: GET
path: "/datasets"
---

# GET /datasets

`GET /datasets`

Retrieves information about datasets.

## Query parameters

- `nextToken` string
- `maxResults` integer

## Response `200`

Success

- ListDatasetsResponse
  - `datasetSummaries` DatasetSummary[] — A list of <code>DatasetSummary</code> objects.
    - `datasetName` string — The name of the dataset.
    - `status` 'CREATING' | 'ACTIVE' | 'DELETING' — The status of the dataset.
    - `creationTime` string, date-time — The time the dataset was created.
    - `lastUpdateTime` string, date-time — The last time the dataset was updated.
    - `triggers` DatasetTrigger[] — A list of triggers. A trigger causes dataset content to be populated at a specified time interval or when another dataset is populated. The list of triggers can be empty or contain up to five <code>DataSetTrigger</code> objects
      - `schedule` object — The Schedule when the trigger is initiated.
        - `expression` string — The expression that defines when to trigger an update. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html">Schedule Expressions for Rules</a> in the <i>Amazon CloudWatch Events User Guide</i>.
      - `dataset` object — The dataset whose content creation triggers the creation of this dataset's contents.
        - `name` string, required — The name of the dataset whose content generation triggers the new dataset content generation.
    - `actions` DatasetActionSummary[] — A list of <code>DataActionSummary</code> objects.
      - `actionName` string — The name of the action that automatically creates the dataset's contents.
      - `actionType` 'QUERY' | 'CONTAINER' — The type of action by which the dataset's contents are automatically created.
  - `nextToken` string — The token to retrieve the next set of results, or <code>null</code> if there are no more results.

## Other responses

- `480` — InvalidRequestException
- `481` — InternalFailureException
- `482` — ServiceUnavailableException
- `483` — ThrottlingException

---

[API](https://skmtc.net/aws/apis/iotanalytics.md) · [All operations](https://skmtc.net/aws/apis/iotanalytics/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iotanalytics/versions/e78558b7408d/schema)