REST Resource: projects.locations.backends

संसाधन: बैकएंड

बैकएंड, ऐप्लिकेशन होस्टिंग का मुख्य संसाधन है.

JSON के काेड में दिखाना
{
  "name": string,
  "displayName": string,
  "servingLocality": enum (ServingLocality),
  "codebase": {
    object (Codebase)
  },
  "uri": string,
  "managedResources": [
    {
      object (ManagedResource)
    }
  ],
  "serviceAccount": string,
  "appId": string,
  "environment": string,
  "reconciling": boolean,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string
}
फ़ील्ड
name

string

आइडेंटिफ़ायर. बैकएंड के संसाधन का नाम.

प्रारूप:

projects/{project}/locations/{locationId}/backends/{backendId}.

displayName

string

ज़रूरी नहीं. इस नाम को कोई भी व्यक्ति आसानी से पढ़ सकता है. 63 वर्ण की सीमा.

servingLocality

enum (ServingLocality)

ज़रूरी है. इम्यूटेबल. इससे पता चलता है कि ऐप्लिकेशन होस्टिंग की मदद से, इस बैकएंड के लिए कॉन्टेंट कैसे दिखाया जाएगा. इसे या तो किसी एक क्षेत्र (regionAL_STRICT) में शामिल किया जाएगा या ऐप्लिकेशन होस्टिंग के ग्लोबल रेप्लिकेटेड सर्विंग इन्फ़्रास्ट्रक्चर (Global_ACCESS) का इस्तेमाल करने की अनुमति दी जाएगी.

codebase

object (Codebase)

ज़रूरी नहीं. अगर कहा जाए, तो बैकएंड में इवेंट-ड्रिवन अपडेट देखने के लिए किसी बाहरी सोर्स रिपॉज़िटरी से कनेक्शन.

uri

string

सिर्फ़ आउटपुट के लिए. बैकएंड से संपर्क करने के लिए मुख्य यूआरआई.

managedResources[]

object (ManagedResource)

सिर्फ़ आउटपुट के लिए. इस बैकएंड से मैनेज किए जाने वाले संसाधनों की सूची.

serviceAccount

string

ज़रूरी है. Cloud Build और Cloud Run के लिए इस्तेमाल किए जाने वाले सेवा खाते का नाम. इसके पास, भूमिकाएं/firebaseapphosting.googleapis.com/computeRunner या इसके बराबर की अनुमतियां होनी चाहिए.

appId

string

ज़रूरी नहीं. बैकएंड से जुड़ा वेब ऐप्लिकेशन का आईडी.

environment

string

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

reconciling

boolean

सिर्फ़ आउटपुट के लिए. अगर फ़ील्ड सही है, तो यह बताता है कि सिस्टम, एलआरओ के दौरान बैकएंड में बदलाव करने के लिए काम कर रहा है.

createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. जिस समय बैकएंड बनाया गया था.

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

updateTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. बैकएंड को पिछली बार अपडेट किए जाने का समय.

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

deleteTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह समय जब बैकएंड मिटाया गया.

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

labels

map (key: string, value: string)

ज़रूरी नहीं. कुंजी की वैल्यू को मिलाकर बनाया गया ऐसा मैप जिसका इस्तेमाल, ऑब्जेक्ट को व्यवस्थित करने और कैटगरी में बांटने के लिए किया जा सकता है.

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

annotations

map (key: string, value: string)

ज़रूरी नहीं. बिना स्ट्रक्चर वाली कुंजी की वैल्यू का मैप, जिसे बाहरी टूल की मदद से स्टोर और आर्बिट्रेरी मेटाडेटा के लिए सेट किया जा सकता है. इन क्वेरी के लिए क्वेरी नहीं की जा सकती. साथ ही, ऑब्जेक्ट में बदलाव करते समय इन्हें सुरक्षित रखा जाना चाहिए.

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

uid

string

सिर्फ़ आउटपुट के लिए. सिस्टम से असाइन किया गया यूनीक आइडेंटिफ़ायर.

etag

string

सिर्फ़ आउटपुट के लिए. अन्य वैल्यू के आधार पर सर्वर से तय किया गया चेकसम; को अपडेट करने या मिटाने पर भेजा जा सकता है, ताकि यह पक्का किया जा सके कि कार्रवाई अनुमानित संसाधन पर हो.

सेवा देने वाला इलाका

इससे पता चलता है कि ऐप्लिकेशन होस्टिंग की सुविधा आपके बैकएंड के डेटा की कॉपी कैसे बनाती है और उसे कैसे दिखाती है.

एनम्स
SERVING_LOCALITY_UNSPECIFIED बताया नहीं गया है. इस्तेमाल किए जाने पर गड़बड़ी मिलेगी.
REGIONAL_STRICT इस मोड में, ऐप्लिकेशन होस्टिंग की सुविधा आपके चुने गए पैरंट इलाके से आपके बैकएंड का कॉन्टेंट उपलब्ध कराती है. ऐप्लिकेशन होस्टिंग सिर्फ़ चुने गए इलाके में डेटा और सेवा इन्फ़्रास्ट्रक्चर का रखरखाव करती है. यह आपके डेटा को अन्य क्षेत्रों के डेटा पर लागू नहीं करती.
GLOBAL_ACCESS इस मोड में, ऐप्लिकेशन होस्टिंग में दुनिया भर में मौजूद कई जगहों (POP) से आपके बैकएंड का कॉन्टेंट दिखाया जाता है. ऐप्लिकेशन होस्टिंग, आपके बैकएंड के कॉन्फ़िगरेशन और कैश मेमोरी में सेव किए गए डेटा को इन पीओपी में कॉपी करता है. साथ ही, रिस्पॉन्स मिलने में लगने वाले समय को कम करने के लिए, ग्लोबल सीडीएन का इस्तेमाल करता है. आपके प्रोजेक्ट पर, ऐप्लिकेशन होस्टिंग से मैनेज किए जाने वाले क्लाउड रिसॉर्स, जैसे कि Cloud Run की सेवाएं, Cloud Build के बिल्ड, और Artifact Registry इमेज की सुविधा अब भी आपके बैकएंड के पैरंट एरिया तक ही सीमित है. सीडीएन के ज़रिए कैश किए गए जवाबों को कैश मेमोरी के TTL की अवधि तक पीओपी में सेव किया जा सकता है.

कोड बेस

बैकएंड में इवेंट-ड्रिवन अपडेट देखने के लिए, डेटा स्टोर करने की बाहरी जगह से कनेक्शन.

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

string

ज़रूरी है. इस बैकएंड से जुड़े डेवलपर कनेक्ट gitRepositoryLink के लिए, संसाधन का नाम इस फ़ॉर्मैट में होना चाहिए:

प्रोजेक्ट/{project}/जगहें/{location}/कनेक्शन/{कनेक्शन}/gitRepositoryLinks/{repositoryLink}

gitRepositoryLink के लिए कनेक्शन, Firebase कंसोल के ज़रिए Firebase ऐप्लिकेशन होस्टिंग GitHub ऐप्लिकेशन का इस्तेमाल करना चाहिए.

rootDirectory

string

ज़रूरी नहीं. अगर repository दिया गया है, तो डिप्लॉय किए गए वेब ऐप्लिकेशन के रूट के तौर पर इस्तेमाल करने के लिए, डेटा स्टोर करने की जगह के रूट से जुड़ी डायरेक्ट्री.

प्रबंधित संसाधन

प्रोजेक्ट पर ऐप्लिकेशन होस्टिंग की मदद से मैनेज किया जाने वाला एक बाहरी संसाधन.

JSON के काेड में दिखाना
{

  // Union field managed_resource can be only one of the following:
  "runService": {
    object (RunService)
  }
  // End of list of possible types for union field managed_resource.
}
फ़ील्ड

यूनियन फ़ील्ड managed_resource.

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

runService

object (RunService)

Cloud Run service, जिसे ऐप्लिकेशन होस्टिंग से मैनेज किया जाता है.

रनसर्विस

मैनेज किया जा रहा Cloud Run service.

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

string

ज़रूरी नहीं. Cloud Run service का नाम, फ़ॉर्मैट में:

प्रोजेक्ट/{project}/locations/{location}/services/{serviceId}

तरीके

create

किसी दिए गए प्रोजेक्ट और जगह में नया बैकएंड बनाता है.

delete

एक बैकएंड को मिटाता है.

get

बैकएंड के बारे में जानकारी मिलती है.

getTraffic

किसी बैकएंड के ट्रैफ़िक के बारे में जानकारी मिलती है.

list

किसी दिए गए प्रोजेक्ट और जगह के बैकएंड की सूची बनाता है.

patch

सिंगल बैकएंड के लिए जानकारी अपडेट करता है.

updateTraffic

किसी बैकएंड का ट्रैफ़िक अपडेट करता है.