---
title: "GET /v1/projects/{projectsId}/locations/{locationsId}/buckets/{bucketsId}/datasets"
method: GET
path: "/v1/projects/{projectsId}/locations/{locationsId}/buckets/{bucketsId}/datasets"
tags: ["projects"]
---

# GET /v1/projects/{projectsId}/locations/{locationsId}/buckets/{bucketsId}/datasets

`GET /v1/projects/{projectsId}/locations/{locationsId}/buckets/{bucketsId}/datasets`

## Request

- Base URL: `https://observability.googleapis.com`
- URL: `https://observability.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/buckets/{bucketsId}/datasets`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/cloud-platform`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-platform`

List datasets of a bucket.

## Path parameters

- `projectsId` string, required
- `locationsId` string, required
- `bucketsId` string, required

## Query parameters

- `pageSize` integer
- `pageToken` string
- `showDeleted` boolean

## Response `200`

Successful response

- ListDatasetsResponse: Response for listing datasets.
  - `datasets` Dataset[]: The list of datasets.
    - `createTime` string, google-datetime: Output only. Create timestamp.
    - `deleteTime` string, google-datetime: Output only. Delete timestamp.
    - `description` string: Optional. Description of the dataset.
    - `displayName` string: Optional. User friendly display name.
    - `name` string: Identifier. Name of the dataset. The format is: projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]
    - `purgeTime` string, google-datetime: Output only. Timestamp when the dataset in soft-deleted state is purged.
  - `nextPageToken` string: A token that can be sent as `page_token` to retrieve the next page. When this field is omitted, there are no subsequent pages.

---

[API](https://skmtc.dev/google/apis/observability.md) - [All operations](https://skmtc.dev/google/apis/observability/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/observability/revisions/77d49783b542?raw)