المصدر: الإصدار
Version
عبارة عن تكوين ومجموعة من الملفات الثابتة التي تحدد كيفية عرض الموقع.
تمثيل جيسون |
---|
{ "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 | الإخراج فقط. إجمالي حجم البايتات المخزنة للإصدار. يتم حساب هذه القيمة بعد |
VersionStatus
الحالة المعروفة الحالية لإصدار معين في دورة حياة النشر.
التعدادات | |
---|---|
VERSION_STATUS_UNSPECIFIED | الحالة الافتراضية؛ لا ينبغي أن تستخدم عمدا. |
CREATED | تم إنشاء الإصدار، ويتم حاليًا إضافة المحتوى إلى الإصدار. |
FINALIZED | تمت إضافة كل المحتوى إلى الإصدار، ولم يعد من الممكن تغيير الإصدار. |
DELETED | تم حذف النسخة. |
ABANDONED | لم يتم تحديث الإصدار إلى FINALIZED خلال 12 ساعة وتم حذفه تلقائيًا. |
EXPIRED | الإصدار خارج الحد الذي تم تكوينه بواسطة الموقع لعدد الإصدارات التي تم الاحتفاظ بها، لذا تتم جدولة محتوى الإصدار للحذف. |
CLONING | يتم الآن استنساخ الإصدار من إصدار آخر. لا يزال يتم نسخ كافة المحتويات. |
تكوين الخدمة
التكوين الخاص بكيفية توجيه الطلبات الواردة إلى الموقع ومعالجتها قبل تقديم المحتوى. تتم مطابقة مسارات طلب URL مع أنماط URL المحددة في التكوين، ثم تقوم الاستضافة بتطبيق التكوين المطبق وفقًا لترتيب أولوية محدد.
تمثيل جيسون |
---|
{ "headers": [ { object ( |
مجالات | |
---|---|
headers[] | مصفوفة من الكائنات، حيث يحدد كل كائن نمط عنوان URL الذي، في حالة مطابقته لمسار عنوان URL للطلب، يؤدي إلى تشغيل الاستضافة لتطبيق رؤوس الاستجابة المخصصة المحددة. |
redirects[] | مصفوفة من الكائنات (تسمى قواعد إعادة التوجيه)، حيث تحدد كل قاعدة نمط عنوان URL الذي، إذا كان مطابقًا لمسار عنوان URL للطلب، يؤدي إلى تشغيل الاستضافة للاستجابة بإعادة التوجيه إلى مسار الوجهة المحدد. |
rewrites[] | مصفوفة من الكائنات (تسمى قواعد إعادة الكتابة)، حيث تحدد كل قاعدة نمط عنوان URL الذي، في حالة مطابقته لمسار عنوان URL للطلب، يؤدي إلى تشغيل الاستضافة للاستجابة كما لو تم منح الخدمة عنوان URL المقصود المحدد. |
cleanUrls | يحدد ما إذا كان سيتم إسقاط امتداد الملف من الملفات التي تم تحميلها. |
trailingSlashBehavior | يحدد كيفية التعامل مع شرطة مائلة زائدة في مسار URL. |
i18n | خياري. يحدد سلوك إعادة كتابة i18n. |
رأس
يحدد Header
نمط عنوان URL الذي، في حالة مطابقته لمسار عنوان URL للطلب، يؤدي إلى تشغيل الاستضافة لتطبيق رؤوس الاستجابة المخصصة المحددة.
تمثيل جيسون |
---|
{ "headers": { string: string, ... }, // Union field |
مجالات | |
---|---|
headers | مطلوب. الرؤوس الإضافية المراد إضافتها إلى الاستجابة. كائن يحتوي على قائمة |
pattern حقل الاتحادمطلوب. نمط عنوان URL لسلسلة لمطابقته مع مسار عنوان URL للطلب لتحديد ما إذا كان سيتم تطبيق رأس الاستجابة المخصصة هذا أم لا. يمكن أن يكون إما تعبيرًا عاديًا بنمط Bash أو تعبيرًا عاديًا RE2. يمكن أن يكون pattern واحدًا فقط مما يلي: | |
glob | الكرة الأرضية التي يوفرها المستخدم للمطابقة مع مسار عنوان URL للطلب. |
regex | التعبير العادي RE2 المقدم من المستخدم للمطابقة مع مسار عنوان URL للطلب. |
إعادة توجيه
تحدد Redirect
نمط عنوان URL الذي، في حالة مطابقته لمسار عنوان URL للطلب، يؤدي إلى تشغيل الاستضافة للاستجابة بإعادة التوجيه إلى مسار الوجهة المحدد.
تمثيل جيسون |
---|
{ "statusCode": integer, "location": string, // Union field |
مجالات | |
---|---|
statusCode | مطلوب. رمز الحالة HTTP الذي سيتم عرضه في الاستجابة. يجب أن يكون رمز الحالة 3xx صالحًا. |
location | مطلوب. القيمة المطلوب وضعها في رأس موقع HTTP للاستجابة. يمكن أن يحتوي الموقع على قيم مجموعة الالتقاط من النمط باستخدام بادئة |
pattern حقل الاتحادمطلوب. نمط عنوان URL لسلسلة لمطابقته مع مسار عنوان URL للطلب لتحديد ما إذا كان سيتم تطبيق إعادة التوجيه هذه أم لا. يمكن أن يكون إما تعبيرًا عاديًا بنمط Bash أو تعبيرًا عاديًا RE2. يمكن أن يكون pattern واحدًا فقط مما يلي: | |
glob | الكرة الأرضية التي يوفرها المستخدم للمطابقة مع مسار عنوان URL للطلب. |
regex | التعبير العادي RE2 المقدم من المستخدم للمطابقة مع مسار عنوان URL للطلب. |
اعادة كتابة
تحدد Rewrite
نمط عنوان URL الذي، في حالة مطابقته لمسار عنوان URL للطلب، يؤدي إلى تشغيل الاستضافة للاستجابة كما لو تم منح الخدمة عنوان URL المقصود المحدد.
تمثيل جيسون |
---|
{ "functionRegion": string, // Union field |
مجالات | |
---|---|
functionRegion | خياري. حدد منطقة سحابية لاستدعاءات الوظائف المعاد كتابتها. إذا لم يتم توفيره، فسيتم تعيينه افتراضيًا على us-central1. |
pattern حقل الاتحادمطلوب. نمط عنوان URL لسلسلة لمطابقته مع مسار عنوان URL للطلب لتحديد ما إذا كان سيتم تطبيق عملية إعادة الكتابة هذه أم لا. يمكن أن يكون إما تعبيرًا عاديًا بنمط Bash أو تعبيرًا عاديًا RE2. يمكن أن يكون pattern واحدًا فقط مما يلي: | |
glob | الكرة الأرضية التي يوفرها المستخدم للمطابقة مع مسار عنوان URL للطلب. |
regex | التعبير العادي RE2 المقدم من المستخدم للمطابقة مع مسار عنوان URL للطلب. |
behavior الميداني للاتحاد .مطلوب. سلوك إعادة الكتابة. يمكن أن يكون behavior واحدًا مما يلي فقط: | |
path | مسار URL لإعادة كتابة الطلب إليه. |
function | وظيفة وكيل الطلبات. يجب أن يتطابق تمامًا مع اسم الوظيفة المصدرة. |
run | سيتم إعادة توجيه الطلب إلى Cloud Run. |
CloudRunRewrite
عملية إعادة كتابة تم تكوينها لتوجيه الطلبات إلى خدمة Cloud Run. إذا لم تكن خدمة Cloud Run موجودة عند إعداد أو تحديث تكوين Firebase Hosting، فسيفشل الطلب. يتم تمرير أي أخطاء من خدمة Cloud Run إلى المستخدم النهائي (على سبيل المثال، إذا قمت بحذف خدمة، فإن أي طلبات موجهة إلى تلك الخدمة تتلقى خطأ 404
).
تمثيل جيسون |
---|
{ "serviceId": string, "region": string, "tag": string } |
مجالات | |
---|---|
serviceId | مطلوب. المعرف المحدد من قبل المستخدم لخدمة Cloud Run. |
region | خياري. المنطقة المقدمة من قبل المستخدم حيث تتم استضافة خدمة Cloud Run. الإعدادات الافتراضية لـ |
tag | خياري. علامة TrafficConfig المقدمة من المستخدم لإرسال حركة المرور إليها. عند الحذف، يتم إرسال حركة المرور إلى URI على مستوى الخدمة |
TrailingSlashBehavior
يحدد ما إذا كان يجب إضافة شرطة مائلة زائدة أو إزالتها من مسار عنوان URL للطلب.
التعدادات | |
---|---|
TRAILING_SLASH_BEHAVIOR_UNSPECIFIED | لم يتم تحديد أي سلوك. يتم عرض الملفات في موقعها المحدد فقط، ولا تتم إضافة الشرطة المائلة اللاحقة إلا إلى فهارس الدليل. |
ADD | تتم إضافة الشرطة المائلة الزائدة إلى فهارس الدليل وكذلك إلى أي مسار URL لا ينتهي بامتداد الملف. |
REMOVE | تتم إزالة الشرطة المائلة الزائدة من فهارس الدليل وكذلك من أي مسار URL لا ينتهي بامتداد الملف. |
I18nConfig
إذا تم توفيره، فسيتم تمكين إعادة كتابة i18n.
تمثيل جيسون |
---|
{ "root": string } |
مجالات | |
---|---|
root | مطلوب. المسار الذي يوفره المستخدم حيث سيتم البحث عن المحتوى الخاص بالبلد واللغة داخل الدليل العام. |
طُرق | |
---|---|
| إنشاء إصدار جديد على الموقع المستهدف المحدد باستخدام محتوى الإصدار المحدد. |
| إنشاء نسخة جديدة للموقع المحدد. |
| يحذف الإصدار المحدد. |
| الحصول على الإصدار المحدد الذي تم إنشاؤه للموقع المحدد. |
| يسرد الإصدارات التي تم إنشاؤها للموقع المحدد. |
| يقوم بتحديث بيانات التعريف المحددة للإصدار المحدد. |
| يضيف ملفات المحتوى إلى الإصدار المحدد. |