REST Resource: projects.locations.backends

資源：後端

後端是 App Hosting 的主要資源，

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

ID。後端的資源名稱。

格式：

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

string

選用設定。人類可讀的名稱。長度上限為 63 個半形字元。
servingLocality

enum (ServingLocality)

執行個體類型，不可變動。指定 App Hosting 如何為這個後端提供內容。金鑰可能會位於單一區域 (REGIONAL_STRICT)，或是允許使用 App Hosting 的全域複製服務基礎架構 (GLOBAL_ACCESS)。
codebase

object (Codebase)

選用設定。如果有指定，會連線至外部來源存放區，監控後端的事件驅動更新。
uri

string

僅供輸出。用來與後端通訊的主要 URI。
managedResources[]

object (ManagedResource)

僅供輸出。這個後端管理的資源清單。
serviceAccount

string

執行個體類型，用於 Cloud Build 和 Cloud Run 的服務帳戶名稱。必須具備 role/firebaseapphosting.googleapis.com/computeRunner 或同等權限。
appId

string

選用設定。與後端相關聯的網頁應用程式 ID。
environment

string

選用設定。後端的環境名稱，用於從特定環境設定載入環境變數。
reconciling

boolean

僅供輸出。如果欄位為 true，表示系統在 LRO 期間正在努力調整後端。
createTime

string (Timestamp format)

僅供輸出。建立後端的時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
updateTime

string (Timestamp format)

僅供輸出。上次更新後端的時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
deleteTime

string (Timestamp format)

僅供輸出。刪除後端的時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："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

僅供輸出。系統指派的專屬 ID。
etag

string

僅供輸出。以其他值為基礎的伺服器運算總和檢查碼；更新或刪除時可能傳送，以確保作業會在預期的資源上完成。

提供地區資訊

指定 App Hosting 如何複製及提供後端資料。

列舉
SERVING_LOCALITY_UNSPECIFIED 未指定。使用後會傳回錯誤。
REGIONAL_STRICT 在這個模式下，App Hosting 會從所選的父項區域提供後端內容。App Hosting 僅會將資料和供應基礎架構保存在所選區域，不會將資料複製到其他區域。
GLOBAL_ACCESS 在這個模式下，App Hosting 會從世界各地的多個服務點 (POP) 提供後端內容。App Hosting 會將後端設定和快取資料複製到這些 POP，並使用全域 CDN 進一步縮短回應延遲時間。專案中由 App Hosting 維護的 Cloud 資源 (例如 Cloud Run 服務、Cloud Build 建構作業和 Artifact Registry 映像檔) 仍僅限與後端的上層區域共用。CDN 快取的回應可能會在快取的存留時間期間儲存在 POP 中。

程式碼集

與外部來源存放區的連線，用於監控後端的事件驅動更新。

JSON 表示法 
{
  "repository": string,
  "rootDirectory": string
}
欄位
repository

string

執行個體類型，連線至這個後端的 Developer Connect gitRepositoryLink 資源名稱，格式如下：

projects/{專案}/locations/{位置}/connections/{connection}/gitRepositoryLinks/{repositoryLink}

與 gitRepositoryLink 的連線必須使用 Firebase 控制台的 Firebase App Hosting GitHub 應用程式建立。
rootDirectory

string

選用設定。如果提供 repository，就會提供存放區根目錄的相對目錄，以便做為已部署網頁應用程式的根目錄。

代管資源

專案中由 App Hosting 代管的外部資源。

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)

由 App Hosting 代管的 Cloud Run service。

執行服務

代管 Cloud Run service。

JSON 表示法 
{
  "service": string
}
欄位
service

string

選用設定。Cloud Run service 的名稱，格式如下：

projects/{專案}/locations/{位置}/services/{serviceId}

方法

create

 在指定專案和位置建立新的後端。

delete

 刪除單一後端。

get

 取得後端相關資訊。

getTraffic

 取得後端流量的相關資訊。

list

 列出指定專案和位置中的後端。

patch

 更新單一後端的資訊。

updateTraffic

 更新後端的流量。