ทรัพยากร: เวอร์ชัน
Version
คือการกำหนดค่าและคอลเลกชันของไฟล์คงที่ซึ่งกำหนดวิธีการแสดงไซต์
การเป็นตัวแทน JSON |
---|
{ "name": string, "status": enum ( |
เขตข้อมูล | |
---|---|
name | ชื่อทรัพยากรที่มีคุณสมบัติครบถ้วนสำหรับเวอร์ชัน ในรูปแบบ: ชื่อนี้ระบุไว้ในเนื้อหาการตอบสนองเมื่อคุณเรียกใช้ |
status | สถานะการใช้งานของเวอร์ชัน เพื่อการปรับใช้ที่ประสบความสำเร็จ ให้เรียก โปรดทราบว่าหากคุณปล่อยให้เวอร์ชันอยู่ในสถานะ คุณยังสามารถเปลี่ยนสถานะของเวอร์ชันเป็น |
config | การกำหนดค่าสำหรับพฤติกรรมของไซต์ การกำหนดค่านี้มีอยู่ในไฟล์ |
labels | ป้ายกำกับที่ใช้สำหรับข้อมูลเมตาเพิ่มเติมและ/หรือการกรอง วัตถุที่มีรายการ |
createTime | เอาท์พุทเท่านั้น เวลาที่สร้างเวอร์ชัน การประทับเวลาในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและเศษส่วนสูงสุดเก้าหลัก ตัวอย่าง: |
createUser | เอาท์พุทเท่านั้น ระบุผู้ใช้ที่สร้างเวอร์ชัน |
finalizeTime | เอาท์พุทเท่านั้น เวลาที่เวอร์ชัน การประทับเวลาในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและเศษส่วนสูงสุดเก้าหลัก ตัวอย่าง: |
finalizeUser | เอาท์พุทเท่านั้น ระบุผู้ใช้ที่ |
deleteTime | เอาท์พุทเท่านั้น เวลาที่เวอร์ชันถูก การประทับเวลาในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและเศษส่วนสูงสุดเก้าหลัก ตัวอย่าง: |
deleteUser | เอาท์พุทเท่านั้น ระบุผู้ใช้ที่ |
fileCount | เอาท์พุทเท่านั้น จำนวนไฟล์ทั้งหมดที่เกี่ยวข้องกับเวอร์ชัน ค่านี้จะถูกคำนวณหลังจากเวอร์ชัน |
versionBytes | เอาท์พุทเท่านั้น ขนาดไบต์ทั้งหมดที่จัดเก็บไว้ของเวอร์ชัน ค่านี้จะถูกคำนวณหลังจากเวอร์ชัน |
สถานะเวอร์ชัน
สถานะที่ทราบในปัจจุบันของเวอร์ชันเฉพาะในวงจรการใช้งาน
เอนัม | |
---|---|
VERSION_STATUS_UNSPECIFIED | สถานะเริ่มต้น ไม่ควรใช้โดยเจตนา |
CREATED | สร้างเวอร์ชันแล้ว และกำลังเพิ่มเนื้อหาลงในเวอร์ชัน |
FINALIZED | เพิ่มเนื้อหาทั้งหมดลงในเวอร์ชันแล้ว และไม่สามารถเปลี่ยนแปลงเวอร์ชันได้อีกต่อไป |
DELETED | เวอร์ชันถูกลบแล้ว |
ABANDONED | เวอร์ชันไม่ได้รับการอัปเดตเป็น FINALIZED ภายใน 12 ชั่วโมงและถูกลบโดยอัตโนมัติ |
EXPIRED | เวอร์ชันอยู่นอกขีดจำกัดที่ไซต์กำหนดไว้สำหรับจำนวนเวอร์ชันที่เก็บรักษาไว้ ดังนั้นเนื้อหาของเวอร์ชันจึงถูกกำหนดเวลาสำหรับการลบ |
CLONING | เวอร์ชันนี้กำลังถูกโคลนจากเวอร์ชันอื่น เนื้อหาทั้งหมดยังคงถูกคัดลอกไป |
การแสดงการกำหนดค่า
การกำหนดค่าสำหรับวิธีกำหนดเส้นทางและประมวลผลคำขอขาเข้าไปยังไซต์ก่อนแสดงเนื้อหา เส้นทางคำขอ URL จะจับคู่กับรูปแบบ URL ที่ระบุในการกำหนดค่า จากนั้นโฮสติ้งจะใช้การกำหนดค่าที่เกี่ยวข้องตาม ลำดับลำดับความสำคัญ เฉพาะ
การเป็นตัวแทน JSON |
---|
{ "headers": [ { object ( |
เขตข้อมูล | |
---|---|
headers[] | อาร์เรย์ของออบเจ็กต์ โดยที่แต่ละออบเจ็กต์ระบุรูปแบบ URL ซึ่งหากจับคู่กับเส้นทาง URL คำขอ จะทริกเกอร์โฮสติ้งให้ใช้ส่วนหัวการตอบกลับแบบกำหนดเองที่ระบุ |
redirects[] | อาร์เรย์ของออบเจ็กต์ (เรียกว่ากฎการเปลี่ยนเส้นทาง) โดยแต่ละกฎระบุรูปแบบ URL ซึ่งหากจับคู่กับเส้นทาง URL คำขอ จะทริกเกอร์โฮสติ้งให้ตอบสนองด้วยการเปลี่ยนเส้นทางไปยังเส้นทางปลายทางที่ระบุ |
rewrites[] | อาร์เรย์ของออบเจ็กต์ (เรียกว่ากฎการเขียนซ้ำ) โดยแต่ละกฎระบุรูปแบบ URL ซึ่งหากจับคู่กับเส้นทาง URL คำขอ จะทริกเกอร์โฮสติ้งให้ตอบสนองราวกับว่าบริการได้รับ URL ปลายทางที่ระบุ |
cleanUrls | กำหนดว่าจะทิ้งนามสกุลไฟล์จากไฟล์ที่อัพโหลดหรือไม่ |
trailingSlashBehavior | กำหนดวิธีจัดการกับเครื่องหมายสแลชต่อท้ายในเส้นทาง URL |
i18n | ไม่จำเป็น. กำหนดลักษณะการเขียนซ้ำของ i18n |
หัวข้อ
Header
ระบุรูปแบบ URL ที่หากตรงกับเส้นทาง URL คำขอ จะทริกเกอร์โฮสติ้งให้ใช้ส่วนหัวการตอบกลับแบบกำหนดเองที่ระบุ
การเป็นตัวแทน JSON |
---|
{ "headers": { string: string, ... }, // Union field |
เขตข้อมูล | |
---|---|
headers | ที่จำเป็น. ส่วนหัวเพิ่มเติมที่จะเพิ่มในการตอบกลับ วัตถุที่มีรายการ |
pattern แบบสนามยูเนี่ยนที่จำเป็น. รูปแบบ URL สตริงที่จะจับคู่กับเส้นทาง URL คำขอเพื่อพิจารณาว่าจะใช้ส่วนหัวการตอบกลับที่กำหนดเองนี้หรือไม่ อาจเป็นได้ทั้งแบบ Bash-style glob หรือนิพจน์ทั่วไป RE2 pattern สามารถมีได้เพียงอย่างใดอย่างหนึ่งต่อไปนี้: | |
glob | glob ที่ผู้ใช้ระบุจะจับคู่กับเส้นทาง URL คำขอ |
regex | นิพจน์ทั่วไป RE2 ที่ผู้ใช้ระบุเพื่อจับคู่กับเส้นทาง URL คำขอ |
เปลี่ยนเส้นทาง
Redirect
ระบุรูปแบบ URL ที่หากตรงกับเส้นทาง URL คำขอ จะทริกเกอร์โฮสติ้งให้ตอบสนองด้วยการเปลี่ยนเส้นทางไปยังเส้นทางปลายทางที่ระบุ
การเป็นตัวแทน JSON |
---|
{ "statusCode": integer, "location": string, // Union field |
เขตข้อมูล | |
---|---|
statusCode | ที่จำเป็น. รหัส HTTP สถานะที่จะส่งคืนในการตอบกลับ ต้องเป็นรหัสสถานะ 3xx ที่ถูกต้อง |
location | ที่จำเป็น. ค่าที่จะใส่ในส่วนหัวตำแหน่ง HTTP ของการตอบกลับ ตำแหน่งสามารถมีค่ากลุ่มการจับจากรูปแบบโดยใช้ |
pattern แบบสนามยูเนี่ยนที่จำเป็น. รูปแบบ URL สตริงที่จะจับคู่กับเส้นทาง URL คำขอเพื่อพิจารณาว่าจะใช้การเปลี่ยนเส้นทางนี้หรือไม่ อาจเป็นได้ทั้งแบบ Bash-style glob หรือนิพจน์ทั่วไป RE2 pattern สามารถมีได้เพียงอย่างใดอย่างหนึ่งต่อไปนี้: | |
glob | glob ที่ผู้ใช้ระบุจะจับคู่กับเส้นทาง URL คำขอ |
regex | นิพจน์ทั่วไป RE2 ที่ผู้ใช้ระบุเพื่อจับคู่กับเส้นทาง URL คำขอ |
เขียนใหม่
Rewrite
จะระบุรูปแบบ URL ที่หากตรงกับเส้นทาง URL คำขอ จะทริกเกอร์โฮสติ้งให้ตอบสนองเสมือนว่าบริการได้รับ URL ปลายทางที่ระบุ
การเป็นตัวแทน JSON |
---|
{ "functionRegion": string, // Union field |
เขตข้อมูล | |
---|---|
functionRegion | ไม่จำเป็น. ระบุภูมิภาคคลาวด์สำหรับการเรียกใช้ฟังก์ชันที่เขียนใหม่ หากไม่ได้ระบุไว้ จะใช้ค่าเริ่มต้นเป็น us-central1 |
pattern แบบสนามยูเนี่ยนที่จำเป็น. รูปแบบ URL สตริงที่จะจับคู่กับเส้นทาง URL คำขอเพื่อพิจารณาว่าจะใช้การเขียนซ้ำนี้หรือไม่ อาจเป็นได้ทั้งแบบ Bash-style glob หรือนิพจน์ทั่วไป RE2 pattern สามารถมีได้เพียงอย่างใดอย่างหนึ่งต่อไปนี้: | |
glob | glob ที่ผู้ใช้ระบุจะจับคู่กับเส้นทาง URL คำขอ |
regex | นิพจน์ทั่วไป RE2 ที่ผู้ใช้ระบุเพื่อจับคู่กับเส้นทาง URL คำขอ |
behavior สนามยูเนี่ยนที่จำเป็น. พฤติกรรมของการเขียนซ้ำ behavior สามารถเป็นได้เพียงอย่างใดอย่างหนึ่งต่อไปนี้: | |
path | เส้นทาง URL ที่จะเขียนคำขอใหม่ |
function | ฟังก์ชั่นการร้องขอพร็อกซี ต้องตรงกับชื่อฟังก์ชันที่ส่งออกทุกประการ |
run | คำขอจะถูกส่งต่อไปยัง Cloud Run |
CloudRunเขียนใหม่
การเขียนซ้ำที่กำหนดค่าไว้ซึ่งส่งคำขอไปยังบริการ Cloud Run หากไม่มีบริการ Cloud Run เมื่อตั้งค่าหรืออัปเดตการกำหนดค่า Firebase Hosting แสดงว่าคำขอล้มเหลว ข้อผิดพลาดจากบริการ Cloud Run จะถูกส่งต่อไปยังผู้ใช้ปลายทาง (เช่น หากคุณลบบริการ คำขอใดๆ ที่ส่งไปยังบริการนั้นจะได้รับข้อผิดพลาด 404
)
การเป็นตัวแทน JSON |
---|
{ "serviceId": string, "region": string, "tag": string } |
เขตข้อมูล | |
---|---|
serviceId | ที่จำเป็น. ID ที่ผู้ใช้กำหนดของบริการ Cloud Run |
region | ไม่จำเป็น. ภูมิภาคที่ผู้ใช้ระบุซึ่งโฮสต์บริการ Cloud Run ค่าเริ่มต้นเป็น |
tag | ไม่จำเป็น. แท็ก TrafficConfig ที่ผู้ใช้ระบุเพื่อส่งการรับส่งข้อมูลไป เมื่อละเว้น การรับส่งข้อมูลจะถูกส่งไปยัง URI ทั่วทั้งบริการ |
พฤติกรรม TrailingSlash
กำหนดว่าควรเพิ่มหรือลบเครื่องหมายทับต่อท้ายจากเส้นทาง URL คำขอ
เอนัม | |
---|---|
TRAILING_SLASH_BEHAVIOR_UNSPECIFIED | ไม่มีการระบุลักษณะการทำงาน ไฟล์จะแสดงในตำแหน่งที่แน่นอนเท่านั้น และเครื่องหมายทับต่อท้ายจะถูกเพิ่มลงในดัชนีไดเร็กทอรีเท่านั้น |
ADD | เครื่องหมายสแลชต่อท้ายจะ ถูกเพิ่มลง ในดัชนีไดเรกทอรีตลอดจนเส้นทาง URL ใด ๆ ที่ไม่ลงท้ายด้วยนามสกุลไฟล์ |
REMOVE | เครื่องหมายทับต่อท้ายจะ ถูกลบออก จากดัชนีไดเรกทอรี รวมถึงจากเส้นทาง URL ใดๆ ที่ไม่ได้ลงท้ายด้วยนามสกุลไฟล์ |
I18nConfig
หากระบุไว้ การเขียนซ้ำ i18n จะถูกเปิดใช้งาน
การเป็นตัวแทน JSON |
---|
{ "root": string } |
เขตข้อมูล | |
---|---|
root | ที่จำเป็น. เส้นทางที่ผู้ใช้ระบุซึ่งจะค้นหาเนื้อหาเฉพาะประเทศและภาษาภายในไดเรกทอรีสาธารณะ |
วิธีการ | |
---|---|
| สร้างเวอร์ชันใหม่บนไซต์เป้าหมายที่ระบุโดยใช้เนื้อหาของเวอร์ชันที่ระบุ |
| สร้างเวอร์ชันใหม่สำหรับไซต์ที่ระบุ |
| ลบเวอร์ชันที่ระบุ |
| รับเวอร์ชันที่ระบุที่สร้างขึ้นสำหรับไซต์ที่ระบุ |
| แสดงรายการเวอร์ชันที่สร้างขึ้นสำหรับไซต์ที่ระบุ |
| อัพเดตข้อมูลเมตาที่ระบุสำหรับเวอร์ชันที่ระบุ |
| เพิ่มไฟล์เนื้อหาลงในเวอร์ชันที่ระบุ |