Sumber daya: Versi
Version
adalah konfigurasi dan kumpulan file statis yang menentukan bagaimana suatu situs ditampilkan.
Representasi JSON |
---|
{ "name": string, "status": enum ( |
Bidang | |
---|---|
name | Nama sumber daya yang sepenuhnya memenuhi syarat untuk versi tersebut, dalam format: Nama ini diberikan di isi respons saat Anda memanggil |
status | Status penerapan versi. Agar penerapan berhasil, panggil Perhatikan bahwa jika Anda membiarkan versi dalam status Anda juga dapat mengubah status versi menjadi |
config | Konfigurasi untuk perilaku situs. Konfigurasi ini ada di file |
labels | Label yang digunakan untuk metadata tambahan dan/atau pemfilteran. Sebuah objek yang berisi daftar |
createTime | Hanya keluaran. Waktu pembuatan versi. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
createUser | Hanya keluaran. Mengidentifikasi pengguna yang membuat versi. |
finalizeTime | Hanya keluaran. Waktu saat versi tersebut Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
finalizeUser | Hanya keluaran. Mengidentifikasi pengguna yang |
deleteTime | Hanya keluaran. Waktu saat versi tersebut Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
deleteUser | Hanya keluaran. Mengidentifikasi pengguna yang |
fileCount | Hanya keluaran. Jumlah total file yang terkait dengan versi tersebut. Nilai ini dihitung setelah versi |
versionBytes | Hanya keluaran. Total ukuran byte versi yang disimpan. Nilai ini dihitung setelah versi |
Status Versi
Status yang diketahui saat ini dari versi tertentu dalam siklus hidup penerapan.
Enum | |
---|---|
VERSION_STATUS_UNSPECIFIED | Status bawaan; tidak boleh digunakan dengan sengaja. |
CREATED | Versi telah dibuat, dan konten sedang ditambahkan ke versi tersebut. |
FINALIZED | Semua konten telah ditambahkan ke versi, dan versi tidak dapat diubah lagi. |
DELETED | Versi telah dihapus. |
ABANDONED | Versi tidak diperbarui ke FINALIZED dalam waktu 12 jam dan dihapus secara otomatis. |
EXPIRED | Versi tersebut berada di luar batas yang dikonfigurasi situs untuk jumlah versi yang dipertahankan, sehingga konten versi tersebut dijadwalkan untuk dihapus. |
CLONING | Versi ini sedang diklon dari versi lain. Semua konten masih disalin. |
Konfigurasi Penyajian
Konfigurasi bagaimana permintaan masuk ke situs harus dirutekan dan diproses sebelum menyajikan konten. Jalur permintaan URL dicocokkan dengan pola URL yang ditentukan dalam konfigurasi, kemudian Hosting menerapkan konfigurasi yang berlaku sesuai dengan urutan prioritas tertentu.
Representasi JSON |
---|
{ "headers": [ { object ( |
Bidang | |
---|---|
headers[] | Array objek, yang setiap objeknya menentukan pola URL yang, jika cocok dengan jalur URL permintaan, akan memicu Hosting untuk menerapkan header respons kustom yang ditentukan. |
redirects[] | Array objek (disebut aturan pengalihan), yang setiap aturannya menentukan pola URL yang, jika cocok dengan jalur URL permintaan, akan memicu Hosting untuk merespons dengan pengalihan ke jalur tujuan yang ditentukan. |
rewrites[] | Array objek (disebut aturan penulisan ulang), yang setiap aturannya menentukan pola URL yang, jika cocok dengan jalur URL permintaan, akan memicu Hosting untuk merespons seolah-olah layanan diberi URL tujuan yang ditentukan. |
cleanUrls | Menentukan apakah akan menghapus ekstensi file dari file yang diunggah. |
trailingSlashBehavior | Mendefinisikan cara menangani garis miring di jalur URL. |
i18n | Opsional. Mendefinisikan perilaku penulisan ulang i18n. |
Tajuk
Header
menentukan pola URL yang, jika cocok dengan jalur URL permintaan, akan memicu Hosting untuk menerapkan header respons khusus yang ditentukan.
Representasi JSON |
---|
{ "headers": { string: string, ... }, // Union field |
Bidang | |
---|---|
headers | Diperlukan. Header tambahan untuk ditambahkan ke respons. Sebuah objek yang berisi daftar |
pattern bidang persatuan.Diperlukan. Pola URL string yang cocok dengan jalur URL permintaan untuk menentukan apakah akan menerapkan header respons khusus ini. Dapat berupa glob gaya Bash atau ekspresi reguler RE2. pattern hanya dapat berupa salah satu dari berikut ini: | |
glob | Glob yang disediakan pengguna untuk dicocokkan dengan jalur URL permintaan. |
regex | Ekspresi reguler RE2 yang disediakan pengguna untuk dicocokkan dengan jalur URL permintaan. |
Pengalihan
Redirect
menentukan pola URL yang, jika cocok dengan jalur URL permintaan, akan memicu Hosting merespons dengan pengalihan ke jalur tujuan yang ditentukan.
Representasi JSON |
---|
{ "statusCode": integer, "location": string, // Union field |
Bidang | |
---|---|
statusCode | Diperlukan. Kode HTTP status yang akan dikembalikan sebagai respons. Itu harus berupa kode status 3xx yang valid. |
location | Diperlukan. Nilai yang akan dimasukkan ke dalam header lokasi HTTP respons. Lokasi dapat berisi nilai grup pengambilan dari pola menggunakan awalan |
pattern bidang persatuan.Diperlukan. Pola URL string yang cocok dengan jalur URL permintaan untuk menentukan apakah akan menerapkan pengalihan ini. Dapat berupa glob gaya Bash atau ekspresi reguler RE2. pattern hanya dapat berupa salah satu dari berikut ini: | |
glob | Glob yang disediakan pengguna untuk dicocokkan dengan jalur URL permintaan. |
regex | Ekspresi reguler RE2 yang disediakan pengguna untuk dicocokkan dengan jalur URL permintaan. |
Menulis kembali
Rewrite
menentukan pola URL yang, jika cocok dengan jalur URL permintaan, akan memicu Hosting untuk merespons seolah-olah layanan diberi URL tujuan yang ditentukan.
Representasi JSON |
---|
{ "functionRegion": string, // Union field |
Bidang | |
---|---|
functionRegion | Opsional. Tentukan wilayah Cloud untuk pemanggilan Fungsi yang ditulis ulang. Jika tidak disediakan, defaultnya adalah us-central1. |
pattern bidang persatuan.Diperlukan. Pola URL string yang cocok dengan jalur URL permintaan untuk menentukan apakah akan menerapkan penulisan ulang ini. Dapat berupa glob gaya Bash atau ekspresi reguler RE2. pattern hanya dapat berupa salah satu dari berikut ini: | |
glob | Glob yang disediakan pengguna untuk dicocokkan dengan jalur URL permintaan. |
regex | Ekspresi reguler RE2 yang disediakan pengguna untuk dicocokkan dengan jalur URL permintaan. |
behavior lapangan serikat pekerja.Diperlukan. Perilaku penulisan ulang. behavior hanya dapat berupa salah satu dari berikut ini: | |
path | Jalur URL tujuan penulisan ulang permintaan. |
function | Fungsi untuk memproksi permintaan. Harus sama persis dengan nama fungsi yang diekspor. |
run | Permintaan akan diteruskan ke Cloud Run. |
CloudRunTulis Ulang
Penulisan ulang terkonfigurasi yang mengarahkan permintaan ke layanan Cloud Run. Jika layanan Cloud Run tidak ada saat menyetel atau memperbarui konfigurasi Firebase Hosting Anda, maka permintaan akan gagal. Setiap error dari layanan Cloud Run diteruskan ke pengguna akhir (misalnya, jika Anda menghapus suatu layanan, setiap permintaan yang diarahkan ke layanan tersebut akan menerima error 404
).
Representasi JSON |
---|
{ "serviceId": string, "region": string, "tag": string } |
Bidang | |
---|---|
serviceId | Diperlukan. ID layanan Cloud Run yang ditentukan pengguna. |
region | Opsional. Wilayah yang disediakan pengguna tempat layanan Cloud Run dihosting. Defaultnya adalah |
tag | Opsional. Tag TrafficConfig yang disediakan pengguna untuk mengirimkan lalu lintas. Jika dihilangkan, lalu lintas dikirim ke URI seluruh layanan |
Perilaku TrailingSlash
Menentukan apakah garis miring harus ditambahkan atau dihapus dari jalur URL permintaan.
Enum | |
---|---|
TRAILING_SLASH_BEHAVIOR_UNSPECIFIED | Tidak ada perilaku yang ditentukan. File disajikan di lokasi persisnya saja, dan garis miring di akhir hanya ditambahkan ke indeks direktori. |
ADD | Garis miring tambahan ditambahkan ke indeks direktori serta jalur URL mana pun yang tidak diakhiri dengan ekstensi file. |
REMOVE | Garis miring tambahan dihapus dari indeks direktori serta dari jalur URL apa pun yang tidak diakhiri dengan ekstensi file. |
I18nConfig
Jika disediakan, penulisan ulang i18n diaktifkan.
Representasi JSON |
---|
{ "root": string } |
Bidang | |
---|---|
root | Diperlukan. Jalur yang disediakan pengguna tempat konten spesifik negara dan bahasa akan dicari dalam direktori publik. |
Metode | |
---|---|
| Membuat versi baru di situs target yang ditentukan menggunakan konten versi yang ditentukan. |
| Membuat versi baru untuk situs tertentu. |
| Menghapus versi yang ditentukan. |
| Dapatkan versi tertentu yang telah dibuat untuk situs tertentu. |
| Mencantumkan versi yang telah dibuat untuk situs tertentu. |
| Memperbarui metadata yang ditentukan untuk versi yang ditentukan. |
| Menambahkan file konten ke versi yang ditentukan. |