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 )

संस्करण की तैनाती स्थिति.

एक सफल तैनाती के लिए, एक नया संस्करण ( CREATED स्थिति) बनाने के लिए versions.create कॉल करें, संस्करण में सभी वांछित फ़ाइलें अपलोड करें , फिर संस्करण को 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)

केवल आउटपुट. वह समय जब संस्करण बनाया गया था.

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

createUser

object ( ActingUser )

केवल आउटपुट. उस उपयोगकर्ता की पहचान करता है जिसने संस्करण बनाया है।

finalizeTime

string ( Timestamp format)

केवल आउटपुट. वह समय जब संस्करण को FINALIZED था।

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

finalizeUser

object ( ActingUser )

केवल आउटपुट. उस उपयोगकर्ता की पहचान करता है जिसने संस्करण को FINALIZED ।

deleteTime

string ( Timestamp format)

केवल आउटपुट. वह समय जब संस्करण DELETED था।

RFC3339 UTC "ज़ुलु" प्रारूप में एक टाइमस्टैम्प, नैनोसेकंड रिज़ॉल्यूशन और नौ भिन्नात्मक अंकों तक। उदाहरण: "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 )

यह परिभाषित करता है कि URL पथ में अनुगामी स्लैश को कैसे संभालना है।

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

अनुरोध URL पथ से मेल खाने के लिए उपयोगकर्ता द्वारा प्रदत्त ग्लोब ।

regex

string

अनुरोध URL पथ से मिलान करने के लिए उपयोगकर्ता द्वारा प्रदत्त 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

आवश्यक। प्रतिक्रिया में लौटने के लिए स्थिति HTTP कोड। यह एक वैध 3xx स्थिति कोड होना चाहिए।

location

string

आवश्यक। प्रतिक्रिया के HTTP स्थान शीर्षलेख में डाला जाने वाला मान।

स्थान में सेगमेंट की पहचान करने के लिए : उपसर्ग और शेष यूआरएल को कैप्चर करने के लिए वैकल्पिक * उपयोग करके पैटर्न से कैप्चर समूह मान शामिल हो सकते हैं। उदाहरण के लिए:

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

संघ क्षेत्र pattern .
आवश्यक। इस रीडायरेक्ट को लागू करना है या नहीं यह निर्धारित करने के लिए अनुरोध यूआरएल पथ के खिलाफ मिलान करने के लिए एक स्ट्रिंग यूआरएल पैटर्न। या तो बैश-स्टाइल ग्लोब या RE2 रेगुलर एक्सप्रेशन हो सकता है।

pattern निम्नलिखित में से केवल एक हो सकता है:
glob

string

अनुरोध URL पथ से मेल खाने के लिए उपयोगकर्ता द्वारा प्रदत्त ग्लोब ।

regex

string

अनुरोध URL पथ से मिलान करने के लिए उपयोगकर्ता द्वारा प्रदत्त 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

अनुरोध URL पथ से मेल खाने के लिए उपयोगकर्ता द्वारा प्रदत्त ग्लोब ।

regex

string

अनुरोध URL पथ से मिलान करने के लिए उपयोगकर्ता द्वारा प्रदत्त RE2 नियमित अभिव्यक्ति।

संघक्षेत्र behavior .
आवश्यक। पुनर्लेखन का व्यवहार.

behavior निम्नलिखित में से केवल एक ही हो सकता है:
path

string

अनुरोध को फिर से लिखने के लिए यूआरएल पथ।

function

string

प्रॉक्सी के लिए फ़ंक्शन अनुरोध करता है। निर्यातित फ़ंक्शन नाम से बिल्कुल मेल खाना चाहिए.

run

object ( CloudRunRewrite )

अनुरोध क्लाउड रन को भेज दिया जाएगा।

CloudRunRewrite

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

JSON प्रतिनिधित्व
{
  "serviceId": string,
  "region": string,
  "tag": string
}
खेत
serviceId

string

आवश्यक। क्लाउड रन सेवा की उपयोगकर्ता-परिभाषित आईडी।

region

string

वैकल्पिक। उपयोगकर्ता द्वारा प्रदत्त क्षेत्र जहां क्लाउड रन सेवा होस्ट की जाती है।

यदि आपूर्ति नहीं की गई तो डिफ़ॉल्ट रूप से us-central1 ।

tag

string

वैकल्पिक। ट्रैफ़िक भेजने के लिए उपयोगकर्ता द्वारा प्रदान किया गया ट्रैफ़िक कॉन्फ़िग टैग।

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

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

परिभाषित करता है कि अनुरोध URL पथ से पिछला स्लैश जोड़ा जाना चाहिए या हटाया जाना चाहिए।

एनम्स
TRAILING_SLASH_BEHAVIOR_UNSPECIFIED

कोई व्यवहार निर्दिष्ट नहीं है.

फ़ाइलें केवल उनके सटीक स्थान पर ही परोसी जाती हैं, और अनुगामी स्लैश केवल निर्देशिका अनुक्रमणिका में जोड़े जाते हैं।

ADD ट्रेलिंग स्लैश को डायरेक्टरी इंडेक्स के साथ-साथ फ़ाइल एक्सटेंशन में समाप्त न होने वाले किसी भी यूआरएल पथ में जोड़ा जाता है ।
REMOVE ट्रेलिंग स्लैश को निर्देशिका अनुक्रमणिका के साथ-साथ फ़ाइल एक्सटेंशन में समाप्त न होने वाले किसी भी URL पथ से हटा दिया जाता है।

I18nकॉन्फिग

यदि प्रदान किया गया है, तो i18n पुनर्लेखन सक्षम है।

JSON प्रतिनिधित्व
{
  "root": string
}
खेत
root

string

आवश्यक। उपयोगकर्ता द्वारा प्रदत्त पथ जहां सार्वजनिक निर्देशिका के भीतर देश और भाषा विशिष्ट सामग्री की तलाश की जाएगी।

तरीकों

clone

 निर्दिष्ट संस्करण की सामग्री का उपयोग करके निर्दिष्ट लक्ष्य साइट पर एक नया संस्करण बनाता है।

create

 निर्दिष्ट साइट के लिए एक नया संस्करण बनाता है।

delete

 निर्दिष्ट संस्करण हटा देता है.

get

 निर्दिष्ट संस्करण प्राप्त करें जो निर्दिष्ट साइट के लिए बनाया गया है।

list

 उन संस्करणों को सूचीबद्ध करता है जो निर्दिष्ट साइट के लिए बनाए गए हैं।

patch

 निर्दिष्ट संस्करण के लिए निर्दिष्ट मेटाडेटा को अद्यतन करता है।

populateFiles

 निर्दिष्ट संस्करण में सामग्री फ़ाइलें जोड़ता है।