REST Resource: projects.locations.backends

Resource: Backend

Backend adalah resource utama App Hosting.

Representasi 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
}
Kolom
name

string

ID. Nama resource backend.

Format:

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

string

Opsional. Nama yang dapat dibaca manusia. Maksimal 63 karakter.
servingLocality

enum (ServingLocality)

Wajib diisi. Tidak dapat diubah. Menentukan cara App Hosting akan menayangkan konten untuk backend ini. Paket ini akan dimuat ke satu region (REGIONAL_STRICT) atau diizinkan untuk menggunakan infrastruktur layanan replika global (GLOBAL_ACCESS) dari App Hosting.
codebase

object (Codebase)

Opsional. Jika ditentukan, koneksi ke repositori sumber eksternal untuk memantau update berbasis peristiwa pada backend.
uri

string

Hanya output. URI utama untuk berkomunikasi dengan backend.
managedResources[]

object (ManagedResource)

Hanya output. Daftar resource yang dikelola oleh backend ini.
serviceAccount

string

Wajib diisi. Nama akun layanan yang digunakan untuk Cloud Build dan Cloud Run. Harus memiliki peran role/firebaseapphosting.googleapis.com/computeRunner atau izin yang setara.
appId

string

Opsional. ID Aplikasi Web yang terkait dengan backend.
environment

string

Opsional. Nama lingkungan backend, yang digunakan untuk memuat variabel lingkungan dari konfigurasi khusus lingkungan.
reconciling

boolean

Hanya output. Kolom yang, jika true (benar), menunjukkan bahwa sistem bekerja untuk melakukan penyesuaian pada backend selama LRO.
createTime

string (Timestamp format)

Hanya output. Waktu backend dibuat.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Hanya output. Waktu backend terakhir diperbarui.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
deleteTime

string (Timestamp format)

Hanya output. Waktu backend dihapus.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
labels

map (key: string, value: string)

Opsional. Peta nilai kunci tidak terstruktur yang dapat digunakan untuk mengatur dan mengategorikan objek.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
annotations

map (key: string, value: string)

Opsional. Peta nilai kunci tidak terstruktur yang dapat ditetapkan oleh alat eksternal untuk menyimpan dan metadata arbitrer. Objek tersebut tidak dapat dikueri dan harus dipertahankan saat memodifikasi objek.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
uid

string

Hanya output. ID unik yang ditetapkan sistem.
etag

string

Hanya output. Checksum yang dihitung oleh server berdasarkan nilai lain; mungkin dikirim saat pembaruan atau penghapusan untuk memastikan operasi dilakukan pada resource yang diharapkan.

Lokalitas Penayangan

Menentukan cara App Hosting mereplikasi dan menayangkan data backend.

Enum
SERVING_LOCALITY_UNSPECIFIED Tidak ditentukan. Akan menampilkan error jika digunakan.
REGIONAL_STRICT Dalam mode ini, App Hosting menayangkan konten backend dari region induk yang dipilih. Hosting Aplikasi hanya menyimpan data dan infrastruktur inferensi di region yang dipilih tersebut dan tidak mereplikasi data Anda ke region lain.
GLOBAL_ACCESS Dalam mode ini, App Hosting menayangkan konten backend Anda dari beberapa titik kehadiran (POP) di seluruh dunia. App Hosting mereplikasi konfigurasi backend dan data yang di-cache ke POP ini serta menggunakan CDN global untuk lebih mengurangi latensi respons. Resource Cloud yang dikelola App Hosting di project Anda, seperti layanan Cloud Run, build Cloud Build, dan Image Artifact Registry, masih terbatas pada region induk backend Anda. Respons yang di-cache oleh CDN dapat disimpan di POP selama durasi TTL cache.

Codebase

Koneksi ke repositori sumber eksternal untuk memantau update berbasis peristiwa pada backend.

Representasi JSON 
{
  "repository": string,
  "rootDirectory": string
}
Kolom
repository

string

Wajib diisi. Nama resource untuk Developer Connect gitRepositoryLink yang terhubung ke backend ini, dalam format:

projects/{project}/locations/{location}/connections/{connection}/gitRepositoryLinks/{repositoryLink}

Koneksi untuk gitRepositoryLink harus dibuat menggunakan Aplikasi GitHub Firebase App Hosting melalui Firebase Console.
rootDirectory

string

Opsional. Jika repository disediakan, direktori yang terkait dengan root repositori yang akan digunakan sebagai root untuk aplikasi web yang di-deploy.

Resource Terkelola

Resource eksternal yang dikelola oleh App Hosting pada project.

Representasi 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.
}
Kolom

Kolom union managed_resource.

managed_resource hanya dapat berupa salah satu dari yang berikut:
runService

object (RunService)

Cloud Run service, yang dikelola oleh App Hosting.

{i>RunService<i}

Cloud Run service terkelola.

Representasi JSON 
{
  "service": string
}
Kolom
service

string

Opsional. Nama Cloud Run service, dalam format:

projects/{project}/locations/{location}/services/{serviceId}

Metode

create

 Membuat backend baru di project dan lokasi tertentu.

delete

 Menghapus satu backend.

get

 Mendapatkan informasi tentang backend.

getTraffic

 Mendapatkan informasi tentang traffic backend.

list

 Mencantumkan backend dalam project dan lokasi tertentu.

patch

 Memperbarui informasi untuk satu backend.

updateTraffic

 Memperbarui traffic backend.