Method: projects.buckets.list

Lists the linked storage buckets for a project.

HTTP request

GET https://firebasestorage.googleapis.com/v1beta/{parent=projects/*}/buckets

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. Resource name of the parent Firebase project, projects/{project_number}.

Authorization requires the following IAM permission on the specified resource parent:

  • firebasestorage.buckets.list

Query parameters

Parameters
pageSize

integer

The maximum number of buckets to return. If not set, the server will use a reasonable default.

pageToken

string

A page token, received from a previous buckets.list call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to buckets.list must match the call that provided the page token.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

The response returned by buckets.list.

JSON representation
{
  "buckets": [
    {
      object (Bucket)
    }
  ],
  "nextPageToken": string
}
Fields
buckets[]

object (Bucket)

The list of linked buckets.

nextPageToken

string

A token that can be sent as pageToken to retrieve the next page. If this field is omitted, there are no subsequent pages.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/firebase

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the parent resource:

  • firebasestorage.buckets.list

For more information, see the IAM documentation.