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

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

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

## Request

- Base URL: `https://observability.googleapis.com`
- URL: `https://observability.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/buckets`
- 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 buckets of a project in a particular location.

## Path parameters

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

## Query parameters

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

## Response `200`

Successful response

- ListBucketsResponse: Response for listing buckets.
  - `buckets` Bucket[]: Optional. The list of buckets.
    - `cmekSettings` CmekSettings: Settings for configuring CMEK for a bucket.
      - `kmsKey` string: Optional. The resource name for the configured Cloud KMS key. The format is: projects/[PROJECT_ID]/locations/[LOCATION]/keyRings/[KEYRING]/cryptoKeys/[KEY] For example: projects/my-project/locations/us-central1/keyRings/my-ring/cryptoKeys/my-key
      - `kmsKeyVersion` string: Output only. The CryptoKeyVersion resource name for the configured Cloud KMS key. The format is: projects/[PROJECT_ID]/locations/[LOCATION]/keyRings/[KEYRING]/cryptoKeys/[KEY]/cryptoKeyVersions/[VERSION] For example: projects/my-project/locations/us-central1/keyRings/my-ring/cryptoKeys/my-key/cryptoKeyVersions/1 This read-only field is used to convey the specific configured CryptoKeyVersion of the `kms_key` that has been configured. It is populated when the CMEK settings are bound to a single key version.
      - `serviceAccountId` string: Output only. The service account used to access the key.
    - `createTime` string, google-datetime: Output only. Create timestamp.
    - `deleteTime` string, google-datetime: Output only. Delete timestamp.
    - `description` string: Optional. Description of the bucket.
    - `displayName` string: Optional. User friendly display name.
    - `name` string: Identifier. Name of the bucket. The format is: projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]
    - `purgeTime` string, google-datetime: Output only. Timestamp when the bucket in soft-deleted state is purged.
    - `updateTime` string, google-datetime: Output only. Update timestamp.
  - `nextPageToken` string: Optional. 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)