Method: sites.versions.files.list

Liệt kê các tệp còn lại sẽ được tải lên cho phiên bản cụ thể.

yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
parent

string

Bắt buộc. Phiên bản để liệt kê tệp, ở định dạng:

sites/SITE_ID/versions/VERSION_ID

Tham số truy vấn

Thông số
status

enum (Status)

Loại tệp cần được liệt kê cho phiên bản đã chỉ định.

pageSize

integer

Số lượng tệp phiên bản tối đa cần trả về.

Dịch vụ có thể trả về số thấp hơn nếu có ít tệp phiên bản hơn số lượng tối đa này.
Nếu bạn không chỉ định, giá trị mặc định sẽ là 1000.

pageToken

string

Mã thông báo từ lệnh gọi trước đó đến files.list cho máy chủ biết vị trí cần tiếp tục liệt kê.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "files": [
    {
      object (VersionFile)
    }
  ],
  "nextPageToken": string
}
Trường
files[]

object (VersionFile)

Danh sách đường dẫn đến hàm băm của các tệp trong phiên bản đã chỉ định.

nextPageToken

string

Mã thông báo phân trang, nếu có thêm kết quả ngoài kết quả trong phản hồi này.

Hãy đưa mã thông báo này vào lệnh gọi tiếp theo của bạn đến files.list. Mã thông báo trang chỉ tồn tại trong thời gian ngắn và không nên được lưu trữ.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • 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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về việc xác thực.

Trạng thái

Trạng thái hiện tại của các tệp đang được thêm vào phiên bản.

Enum
STATUS_UNSPECIFIED Trạng thái mặc định; không được cố ý sử dụng.
EXPECTED Tệp này đã được đưa vào phiên bản và dự kiến sẽ được tải lên trong tương lai gần.
ACTIVE Tệp đã được tải lên tính năng Lưu trữ Firebase.

Tệp phiên bản

Tệp nội dung tĩnh là một phần của một phiên bản.

Biểu diễn dưới dạng JSON
{
  "path": string,
  "hash": string,
  "status": enum (Status)
}
Trường
path

string

URI mà nội dung của tệp sẽ hiển thị.

hash

string

Hàm băm nội dung SHA256 của tệp.

status

enum (Status)

Chỉ có đầu ra. Trạng thái hiện tại của một tệp cụ thể trong phiên bản được chỉ định.

Giá trị sẽ là pending upload hoặc uploaded.