Resource REST: sites.versions

Resource: Versi

Version adalah kumpulan file statis dan konfigurasi yang menentukan cara situs ditampilkan.

Representasi JSON

{
  "name": string,
  "status": enum (VersionStatus),
  "config": {
    object (ServingConfig)
  },
  "labels": {
    string: string,
    ...
  },
  "createTime": string,
  "createUser": {
    object (ActingUser)
  },
  "finalizeTime": string,
  "finalizeUser": {
    object (ActingUser)
  },
  "deleteTime": string,
  "deleteUser": {
    object (ActingUser)
  },
  "fileCount": string,
  "versionBytes": string
}
Kolom
name

string

ID unik untuk versi, dalam format:

sites/site-name/versions/versionID

Nama ini diberikan dalam isi respons saat Anda memanggil endpoint versions.create.

status

enum (VersionStatus)

Status penerapan versi.

Agar penerapan berhasil, panggil endpoint versions.create untuk membuat versi yang baru (status CREATED), upload semua file yang diinginkan ke versi tersebut, lalu perbarui status versi menjadi FINALIZED.

Perlu diperhatikan bahwa jika Anda membiarkan versi dalam status CREATED selama lebih dari 12 jam, sistem akan otomatis menandai versi tersebut sebagai ABANDONED.

Anda juga dapat mengubah status versi menjadi DELETED dengan memanggil endpoint versions.delete.

config

object (ServingConfig)

Konfigurasi untuk perilaku situs. Konfigurasi ini ada di file firebase.json.

labels

map (key: string, value: string)

Label yang digunakan untuk metadata dan/atau pemfilteran tambahan.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

createTime

string (format Timestamp)

Hanya output. Waktu saat versi dibuat.

Stempel waktu dalam format RFC3339 UTC "Zulu", akurat hingga nanodetik. Contoh: "2014-10-02T15:01:23.045123456Z".

createUser

object (ActingUser)

Hanya output. Mengidentifikasi pengguna yang membuat versi.

finalizeTime

string (format Timestamp)

Hanya output. Waktu saat versi FINALIZED.

Stempel waktu dalam format RFC3339 UTC "Zulu", akurat hingga nanodetik. Contoh: "2014-10-02T15:01:23.045123456Z".

finalizeUser

object (ActingUser)

Hanya output. Mengidentifikasi pengguna yang FINALIZED versi.

deleteTime

string (format Timestamp)

Hanya output. Waktu saat versi DELETED.

Stempel waktu dalam format RFC3339 UTC "Zulu", akurat hingga nanodetik. Contoh: "2014-10-02T15:01:23.045123456Z".

deleteUser

object (ActingUser)

Hanya output. Mengidentifikasi pengguna yang DELETED versi.

fileCount

string (int64 format)

Hanya output. Jumlah total file yang terkait dengan versi.
Nilai ini dihitung setelah versi FINALIZED.

versionBytes

string (int64 format)

Hanya output. Total ukuran byte tersimpan dari versi ini.
Nilai ini dihitung setelah versi FINALIZED.

VersionStatus

Status yang diketahui saat ini dari versi tertentu dalam siklus proses penerapan.

Enumerasi
VERSION_STATUS_UNSPECIFIED Status default; tidak boleh digunakan secara sengaja.
CREATED Versi telah dibuat, dan konten sedang ditambahkan ke versi.
FINALIZED Semua konten telah ditambahkan ke versi, dan versi tidak dapat diubah lagi.
DELETED Versi telah dihapus.
ABANDONED Versi tidak diupdate ke FINALIZED dalam 12 jam dan otomatis dihapus.
EXPIRED Versi ini di luar batas yang dikonfigurasikan oleh situs untuk jumlah versi yang dipertahankan, sehingga konten versi dijadwalkan untuk dihapus.

ServingConfig

Konfigurasi terkait bagaimana permintaan masuk ke situs harus dirutekan dan diproses sebelum menayangkan konten. Pola dicocokkan dan diterapkan sesuai dengan urutan prioritas tertentu.

Representasi JSON

{
  "headers": [
    {
      object (Header)
    }
  ],
  "redirects": [
    {
      object (Redirect)
    }
  ],
  "rewrites": [
    {
      object (Rewrite)
    }
  ],
  "cleanUrls": boolean,
  "trailingSlashBehavior": enum (TrailingSlashBehavior)
}
Kolom
headers[]

object (Header)

Daftar header respons kustom yang ditambahkan ke konten jika jalur URL permintaan cocok dengan glob.

redirects[]

object (Redirect)

Daftar glob yang akan menyebabkan respons dialihkan ke lokasi lain.

rewrites[]

object (Rewrite)

Daftar operasi penulisan ulang yang akan bertindak seolah-olah layanan diberi URL tujuan.

cleanUrls

boolean

Menentukan apakah ekstensi file akan dihapus dari file yang diupload.

trailingSlashBehavior

enum (TrailingSlashBehavior)

Menentukan cara menangani garis miring penutup pada jalur URL.

Header

header menentukan header kustom yang akan ditambahkan ke respons jika jalur URL permintaan cocok dengan pola.

Representasi JSON

{
  "glob": string,
  "headers": {
    string: string,
    ...
  }
}
Kolom
glob

string

Wajib ada. Pola glob yang disediakan pengguna untuk dicocokkan dengan jalur URL permintaan.

headers

map (key: string, value: string)

Wajib ada. Header tambahan untuk ditambahkan ke respons.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Redirect

redirect menunjukkan konfigurasi untuk menampilkan respons pengalihan HTTP jika ada jalur URL permintaan yang cocok.

Representasi JSON

{
  "glob": string,
  "statusCode": number,
  "location": string
}
Kolom
glob

string

Wajib ada. Pola glob yang disediakan pengguna untuk dicocokkan dengan jalur URL permintaan.

statusCode

number

Wajib ada. Kode HTTP status untuk ditampilkan dalam respons. Kode ini harus berupa kode status 3xx yang valid.

location

string

Wajib ada. Nilai yang akan dimasukkan ke dalam header lokasi HTTP pada respons.
Lokasi dapat berisi nilai grup tangkapan dari pola yang menggunakan awalan : untuk menentukan segmen, dan opsi * untuk mencatat sisa URL. Misalnya:

"glob": "/:capture*",
"statusCode": 301,
"location": "https://example.com/foo/:capture"

Rewrite

rewrite menunjukkan operasi penulisan ulang konten internal pada versi. Jika polanya cocok, permintaan akan ditangani seolah-olah berada di lokasi tujuan yang ditentukan dalam konfigurasi.

Representasi JSON

{
  "glob": string,

  // Union field behavior can be only one of the following:
  "path": string,
  "function": string,
  "run": {
    object (CloudRunRewrite)
  }
  // End of list of possible types for union field behavior.
}
Kolom
glob