Go to console

Method: sites.versions.files.list

Lists the remaining files to be uploaded for the specified version.

HTTP request

GET https://firebasehosting.googleapis.com/v1beta1/{parent=sites/*/versions/*}/files

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The parent to list files for, in the format:

sites/site-name/versions/versionID

Query parameters

Parameters
status

enum (Status)

The type of files in the version that should be listed.

pageSize

number

The page size to return. Defaults to 1000.

pageToken

string

The nextPageToken from a previous request, if provided. This will be the encoded version of a firebase.hosting.proto.metadata.ListFilesPageToken.

Request body

The request body must be empty.

Response body

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

JSON representation
{
  "files": [
    {
      object (VersionFile)
    }
  ],
  "nextPageToken": string
}
Fields
files[]

object (VersionFile)

The list path/hashes in the specified version.

nextPageToken

string

The pagination token, if more results exist.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/firebase.hosting.readonly
  • https://www.googleapis.com/auth/firebase.hosting
  • https://www.googleapis.com/auth/firebase.readonly
  • https://www.googleapis.com/auth/firebase
  • https://www.googleapis.com/auth/cloud-platform.read-only
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

Status

The current status of the files being added to a version.

Enums
STATUS_UNSPECIFIED The default status; should not be intentionally used.
EXPECTED The file has been included in the version and is expected to be uploaded in the near future.
ACTIVE The file has already been uploaded to Firebase Hosting.

VersionFile

A static content file that is part of a version.

JSON representation
{
  "path": string,
  "hash": string,
  "status": enum (Status)
}
Fields
path

string

The URI at which the file's content should display.

hash

string

The SHA256 content hash of the file.

status

enum (Status)

Output only. The current status of a particular file in the specified version.
The value will be either pending upload or uploaded.

Try it!