REST Resource: sites.versions

संसाधन: वर्शन

Version, कॉन्फ़िगरेशन और स्टैटिक फ़ाइलों का कलेक्शन है. इससे यह तय होता है कि साइट कैसी दिखेगी.

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
}
फ़ील्ड
name

string

वर्शन के लिए पूरी तरह क्वालिफ़ाइड रिसॉर्स का नाम, फ़ॉर्मैट में:

sites/SITE_ID/versions/VERSION_ID

versions.create को कॉल करने पर, यह नाम जवाब के मुख्य हिस्से में दिखेगा.
status

enum (VersionStatus)

वर्शन के डिप्लॉयमेंट की स्थिति.

सही तरीके से डिप्लॉय करने के लिए, versions.create पर कॉल करके नया वर्शन (CREATED स्थिति) बनाएं. सभी ज़रूरी फ़ाइलें अपलोड करें और वर्शन को FINALIZED स्टेटस में अपडेट करें.

ध्यान दें कि अगर वर्शन को 12 घंटे से ज़्यादा समय के लिए CREATED में छोड़ दिया जाता है, तो सिस्टम अपने-आप वर्शन को ABANDONED के तौर पर मार्क कर देगा.

versions.delete पर कॉल करके भी वर्शन की स्थिति को DELETED में बदला जा सकता है.
config

object (ServingConfig)

साइट के व्यवहार के लिए कॉन्फ़िगरेशन. यह कॉन्फ़िगरेशन firebase.json फ़ाइल में मौजूद है.
labels

map (key: string, value: string)

अतिरिक्त मेटाडेटा और/या फ़िल्टर करने के लिए इस्तेमाल किए जाने वाले लेबल.

एक ऑब्जेक्ट, जिसमें "key": value पेयर की सूची है. उदाहरण: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वर्शन बनाए जाने का समय.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
createUser

object (ActingUser)

सिर्फ़ आउटपुट के लिए. उस उपयोगकर्ता की पहचान करता है जिसने वर्शन बनाया है.
finalizeTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह समय जब वर्शन FINALIZED था.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
finalizeUser

object (ActingUser)

सिर्फ़ आउटपुट के लिए. उस उपयोगकर्ता की पहचान करता है जिसने वर्शन को FINALIZED किया है.
deleteTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह समय जब वर्शन DELETED था.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
deleteUser

object (ActingUser)

सिर्फ़ आउटपुट के लिए. उस उपयोगकर्ता की पहचान करता है जिसने वर्शन को DELETED किया है.
fileCount

string (int64 format)

सिर्फ़ आउटपुट के लिए. वर्शन से जुड़ी फ़ाइलों की कुल संख्या.

इस वैल्यू का हिसाब, वर्शन FINALIZED के बाद लगाया जाता है.
versionBytes

string (int64 format)

सिर्फ़ आउटपुट के लिए. वर्शन की कुल सेव की गई बाइट साइज़.

इस वैल्यू का हिसाब, वर्शन FINALIZED के बाद लगाया जाता है.

वर्शन की स्थिति

डिप्लॉयमेंट के लाइफ़साइकल में किसी खास वर्शन का मौजूदा स्टेटस.

एनम्स
VERSION_STATUS_UNSPECIFIED डिफ़ॉल्ट स्थिति; का इस्तेमाल जान-बूझकर नहीं किया जाना चाहिए.
CREATED वर्शन बना दिया गया है और फ़िलहाल कॉन्टेंट को वर्शन में जोड़ा जा रहा है.
FINALIZED वर्शन में पूरा कॉन्टेंट जोड़ दिया गया है और वर्शन अब बदला नहीं जा सकता.
DELETED इस वर्शन को मिटा दिया गया है.
ABANDONED इस वर्शन को 12 घंटों के अंदर FINALIZED में अपडेट नहीं किया गया और यह अपने-आप मिट गया.
EXPIRED इस वर्शन में, सेव करके रखे गए वर्शन की संख्या, साइट से कॉन्फ़िगर करने की सीमा से बाहर है. इसलिए, वर्शन का कॉन्टेंट मिटाने के लिए शेड्यूल किया गया है.
CLONING इस वर्शन को किसी दूसरे वर्शन से क्लोन किया जा रहा है. सारा कॉन्टेंट अब भी कॉपी किया जा रहा है.

सर्विंग कॉन्फ़िगरेशन

कॉन्टेंट दिखाने से पहले, किसी साइट पर आने वाले अनुरोधों को रूट और प्रोसेस करने का तरीका. यूआरएल अनुरोध के पाथ का मिलान, कॉन्फ़िगरेशन में बताए गए यूआरएल पैटर्न से किया जाता है. इसके बाद, होस्टिंग सेवा किसी खास प्राथमिकता क्रम के हिसाब से, लागू कॉन्फ़िगरेशन लागू करती है.

JSON के काेड में दिखाना 
{
  "headers": [
    {
      object (Header)
    }
  ],
  "redirects": [
    {
      object (Redirect)
    }
  ],
  "rewrites": [
    {
      object (Rewrite)
    }
  ],
  "cleanUrls": boolean,
  "trailingSlashBehavior": enum (TrailingSlashBehavior),
  "i18n": {
    object (I18nConfig)
  }
}
फ़ील्ड
headers[]

object (Header)

ऑब्जेक्ट का कलेक्शन, जहां हर ऑब्जेक्ट ऐसे यूआरएल पैटर्न को तय करता है जो अनुरोध वाले यूआरएल पाथ से मेल खाने पर, तय किए गए कस्टम रिस्पॉन्स हेडर को लागू करने के लिए होस्टिंग को ट्रिगर करता है.
redirects[]

object (Redirect)

ऑब्जेक्ट का कलेक्शन (जिसे रीडायरेक्ट नियम कहा जाता है) होता है. इसमें हर नियम एक ऐसे यूआरएल पैटर्न के बारे में बताता है जो अनुरोध किए गए यूआरएल पाथ से मेल खाने पर, बताए गए डेस्टिनेशन पाथ पर रीडायरेक्ट करके जवाब देने के लिए होस्टिंग को ट्रिगर करता है.
rewrites[]

object (Rewrite)

ऑब्जेक्ट का कलेक्शन (जिसे रीराइट नियम कहा जाता है), जहां हर नियम एक ऐसे यूआरएल पैटर्न के बारे में बताता है जो अनुरोध किए गए यूआरएल पाथ से मेल खाने पर, होस्टिंग को इस तरह से ट्रिगर करता है जैसे कि सेवा को तय डेस्टिनेशन यूआरएल दिया गया हो.
cleanUrls

boolean

तय करता है कि अपलोड की गई फ़ाइलों में से फ़ाइल एक्सटेंशन को छोड़ना है या नहीं.
trailingSlashBehavior

enum (TrailingSlashBehavior)

यह बताता है कि यूआरएल पाथ में, बाद में लगे स्लैश को कैसे मैनेज किया जाए.
i18n

object (I18nConfig)

ज़रूरी नहीं. i18n रीराइट बिहेवियर के बारे में बताता है.

Header ऐसे यूआरएल पैटर्न के बारे में बताता है जो अनुरोध किए गए यूआरएल पाथ से मेल खाने पर, तय किए गए कस्टम रिस्पॉन्स हेडर को लागू करने के लिए होस्टिंग को ट्रिगर करता है.

JSON के काेड में दिखाना 
{
  "headers": {
    string: string,
    ...
  },

  // Union field pattern can be only one of the following:
  "glob": string,
  "regex": string
  // End of list of possible types for union field pattern.
}
फ़ील्ड
headers

map (key: string, value: string)

ज़रूरी है. जवाब में जोड़ने के लिए अतिरिक्त हेडर.

एक ऑब्जेक्ट, जिसमें "key": value पेयर की सूची है. उदाहरण: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
यूनियन फ़ील्ड pattern.
ज़रूरी है. अनुरोध किए गए यूआरएल पाथ से मैच करने वाला स्ट्रिंग यूआरएल पैटर्न. इससे यह तय होता है कि इस कस्टम रिस्पॉन्स हेडर को लागू करना है या नहीं. यह बैश-स्टाइल ग्लोब या RE2 रेगुलर एक्सप्रेशन हो सकता है.

pattern इनमें से सिर्फ़ एक हो सकता है:
glob

string

उपयोगकर्ता ने अनुरोध के यूआरएल पाथ से मिलान करने के लिए, ग्लोब दिया.
regex

string

उपयोगकर्ता से मिला RE2 रेगुलर एक्सप्रेशन, जो अनुरोध वाले यूआरएल पाथ से मैच करता है.

रीडायरेक्ट

Redirect से ऐसे यूआरएल पैटर्न के बारे में पता चलता है जो अनुरोध किए गए यूआरएल पाथ से मेल खाने पर, बताए गए डेस्टिनेशन पाथ पर रीडायरेक्ट करने के लिए होस्टिंग को ट्रिगर करता है.

JSON के काेड में दिखाना 
{
  "statusCode": integer,
  "location": string,

  // Union field pattern can be only one of the following:
  "glob": string,
  "regex": string
  // End of list of possible types for union field pattern.
}
फ़ील्ड
statusCode

integer

ज़रूरी है. रिस्पॉन्स में दिखने वाला एचटीटीपी कोड. यह एक मान्य 3xx स्टेटस कोड होना चाहिए.
location

string

ज़रूरी है. रिस्पॉन्स में एचटीटीपी लोकेशन हेडर में डाली जाने वाली वैल्यू.

जगह की जानकारी में, पैटर्न से कैप्चर ग्रुप की वैल्यू शामिल हो सकती हैं. इसके लिए, सेगमेंट की पहचान करने के लिए : प्रीफ़िक्स का इस्तेमाल किया जा सकता है. साथ ही, बाकी यूआरएल को कैप्चर करने के लिए, * का इस्तेमाल किया जा सकता है. हालांकि, ऐसा करना ज़रूरी नहीं है. उदाहरण के लिए:

"glob": "/:capture*",
"statusCode": 301,
"location": "https://example.com/foo/:capture"
यूनियन फ़ील्ड pattern.
ज़रूरी है. वह स्ट्रिंग यूआरएल पैटर्न जिसे अनुरोध यूआरएल पाथ से मैच करना है. इससे यह तय होता है कि इस रीडायरेक्ट को लागू करना है या नहीं. यह बैश-स्टाइल ग्लोब या RE2 रेगुलर एक्सप्रेशन हो सकता है.

pattern इनमें से सिर्फ़ एक हो सकता है:
glob

string

उपयोगकर्ता ने अनुरोध के यूआरएल पाथ से मिलान करने के लिए, ग्लोब दिया.
regex

string

उपयोगकर्ता से मिला RE2 रेगुलर एक्सप्रेशन, जो अनुरोध वाले यूआरएल पाथ से मैच करता है.

पुनर्लेखन करें

Rewrite ऐसे यूआरएल पैटर्न के बारे में बताता है जो अनुरोध किए गए यूआरएल पाथ से मेल खाने पर, होस्टिंग को इस तरह से ट्रिगर करता है जैसे कि सेवा को दिए गए डेस्टिनेशन यूआरएल में रिस्पॉन्स दिया गया हो.

JSON के काेड में दिखाना 
{
  "functionRegion": string,

  // Union field pattern can be only one of the following:
  "glob": string,
  "regex": string
  // End of list of possible types for union field pattern.

  // 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.
}
फ़ील्ड
functionRegion

string

ज़रूरी नहीं. फ़ंक्शन को फिर से शुरू करने के लिए, क्लाउड क्षेत्र तय करें. अगर यह पैरामीटर उपलब्ध नहीं कराया जाता है, तो us-central1 डिफ़ॉल्ट वैल्यू सेट की जाती है.
यूनियन फ़ील्ड pattern.
ज़रूरी है. स्ट्रिंग यूआरएल पैटर्न, जो अनुरोध यूआरएल पाथ से मैच करता है. इससे यह तय होता है कि रीराइट को लागू करना है या नहीं. यह बैश-स्टाइल ग्लोब या RE2 रेगुलर एक्सप्रेशन हो सकता है.

pattern इनमें से सिर्फ़ एक हो सकता है:
glob

string

उपयोगकर्ता ने अनुरोध के यूआरएल पाथ से मिलान करने के लिए, ग्लोब दिया.
regex

string

उपयोगकर्ता से मिला RE2 रेगुलर एक्सप्रेशन, जो अनुरोध वाले यूआरएल पाथ से मैच करता है.
यूनियन फ़ील्ड behavior.
ज़रूरी है. दोबारा लिखने का तरीका.

behavior इनमें से सिर्फ़ एक हो सकता है:
path

string

अनुरोध को फिर से लिखने के लिए, यूआरएल पाथ.
function

string

अनुरोध को प्रॉक्सी करने का फ़ंक्शन. एक्सपोर्ट किए गए फ़ंक्शन के नाम से पूरी तरह मेल खाना चाहिए.
run

object (CloudRunRewrite)

अनुरोध को Cloud Run पर भेजा जाएगा.

CloudRunRewrite

कॉन्फ़िगर किया गया रीराइट, जो Cloud Run सेवा के अनुरोधों को भेजता है. अगर Firebase होस्टिंग कॉन्फ़िगरेशन को सेट या अपडेट करते समय Cloud Run सेवा मौजूद नहीं है, तो अनुरोध पूरा नहीं होगा. Cloud Run सेवा से जुड़ी कोई भी गड़बड़ी असली उपयोगकर्ता को भेज दी जाती है. उदाहरण के लिए, अगर किसी सेवा को मिटाया जाता है, तो उस सेवा को भेजे गए किसी भी अनुरोध को 404 गड़बड़ी मिलती है.

JSON के काेड में दिखाना 
{
  "serviceId": string,
  "region": string,
  "tag": string
}
फ़ील्ड
serviceId

string

ज़रूरी है. Cloud Run सेवा का उपयोगकर्ता का तय किया गया आईडी.
region

string

ज़रूरी नहीं. उपयोगकर्ता का वह इलाका जहां Cloud Run सेवा होस्ट की जाती है.

उपलब्ध न होने पर, डिफ़ॉल्ट वैल्यू us-central1 होती है.
tag

string

ज़रूरी नहीं. उपयोगकर्ता से मिला ट्रैफ़िक कॉन्फ़िगरेशन टैग, जिस पर ट्रैफ़िक भेजा जा रहा है.

इसे हटाए जाने पर, ट्रैफ़िक को पूरी सेवा के यूआरआई पर भेजा जाता है

ट्रेलिंगस्लैश बिहेवियर

तय करता है कि अनुरोध के यूआरएल पाथ में बाद में स्लैश को जोड़ा जाना चाहिए या हटाया जाना चाहिए.

एनम्स
TRAILING_SLASH_BEHAVIOR_UNSPECIFIED

किसी व्यवहार की जानकारी नहीं दी गई है.

फ़ाइलों को उनकी सटीक जगह पर ही दिखाया जाता है और पीछे आने वाले स्लैश सिर्फ़ डायरेक्ट्री इंडेक्स में जोड़े जाते हैं.
ADD आखिरी स्लैश को डायरेक्ट्री इंडेक्स में जोड़ा जाता है. साथ ही, उन सभी यूआरएल पाथ में भी जोड़े जाते हैं जो फ़ाइल एक्सटेंशन पर खत्म नहीं होते हैं.
REMOVE ट्रेलिंग स्लैश को डायरेक्ट्री इंडेक्स से हटा दिया जाता है. साथ ही, उन यूआरएल पाथ से भी हटाया जाता है जो फ़ाइल एक्सटेंशन पर खत्म नहीं होते हैं.

I18nकॉन्फ़िगरेशन

अगर दिया गया हो, तो i18n रीराइट की सुविधा चालू हो जाती है.

JSON के काेड में दिखाना 
{
  "root": string
}
फ़ील्ड
root

string

ज़रूरी है. उपयोगकर्ता का दिया गया पाथ, जहां देश और भाषा के हिसाब से कॉन्टेंट को सार्वजनिक डायरेक्ट्री में खोजा जाएगा.

तरीके

clone

 तय किए गए वर्शन की सामग्री का इस्तेमाल करके, टारगेट साइट पर एक नया वर्शन बनाता है.

create

 बताई गई साइट के लिए नया वर्शन बनाता है.

delete

 तय किए गए वर्शन को मिटाता है.

get

 बताई गई साइट के लिए बनाया गया वर्शन पाएं.

list

 यह डायलॉग बॉक्स बताई गई साइट के लिए बनाए गए वर्शन की सूची बनाता है.

patch

 बताए गए वर्शन के लिए मेटाडेटा को अपडेट करता है.

populateFiles

 बताए गए वर्शन में कॉन्टेंट फ़ाइलें जोड़ता है.