REST Resource: projects.locations.backends

Zasób: backend

Backend jest głównym zasobem App Hosting.

Zapis 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
}
Pola
name

string

Identyfikator. Nazwa zasobu backendu.

Format:

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

string

Opcjonalnie. Nazwa zrozumiała dla człowieka. Limit to 63 znaki.
servingLocality

enum (ServingLocality)

Wymagane. Stały. Określa, w jaki sposób App Hosting będzie wyświetlać treść na potrzeby tego backendu. Będzie ona zawarta w jednym regionie (REGIONAL_STRICT) lub będzie mogła korzystać z replikowanej globalnie infrastruktury usługi App Hosting (GLOBAL_ACCESS).
codebase

object (Codebase)

Opcjonalnie. Połączenie z zewnętrznym repozytorium źródłowym w celu sprawdzania opartych na zdarzeniach aktualizacji backendu.
uri

string

Tylko dane wyjściowe. Podstawowy identyfikator URI do komunikacji z backendem.
managedResources[]

object (ManagedResource)

Tylko dane wyjściowe. Lista zasobów zarządzanych przez ten backend.
serviceAccount

string

Wymagane. Nazwa konta usługi używanego w Cloud Build i Cloud Run. Musi mieć rolę role/firebaseapphosting.googleapis.com/computeRunner lub uprawnienia równoważne.
appId

string

Opcjonalnie. Identyfikator aplikacji internetowej powiązanej z backendem.
environment

string

Opcjonalnie. Nazwa środowiska backendu, która służy do wczytywania zmiennych środowiskowych z konfiguracji w danym środowisku.
reconciling

boolean

Tylko dane wyjściowe. Pole, w którym w przypadku wartości true (prawda) wskazuje, że system pracuje nad wprowadzaniem poprawek do backendu podczas LRO.
createTime

string (Timestamp format)

Tylko dane wyjściowe. Czas utworzenia backendu.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Tylko dane wyjściowe. Czas ostatniej aktualizacji backendu.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
deleteTime

string (Timestamp format)

Tylko dane wyjściowe. Czas usunięcia backendu.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
labels

map (key: string, value: string)

Opcjonalnie. Nieustrukturyzowana mapa par klucz-wartość, której można używać do porządkowania i kategoryzowania obiektów.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
annotations

map (key: string, value: string)

Opcjonalnie. Mapa wartości klucza nieuporządkowanego, która może być ustawiana przez narzędzia zewnętrzne do przechowywania i arbitralnych metadanych. Nie można ich tworzyć zapytań i należy je zachować podczas modyfikowania obiektów.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
uid

string

Tylko dane wyjściowe. Przypisany przez system, unikalny identyfikator.
etag

string

Tylko dane wyjściowe. suma kontrolna obliczona przez serwer na podstawie innych wartości; mogą być wysyłane przy aktualizacji lub usunięcia w celu zapewnienia, że operacja zostanie wykonana na oczekiwanym zasobie.

Obsługiwana miejscowość

Określa, w jaki sposób App Hosting replikuje i udostępnia dane backendu.

Wartości w polu enum
SERVING_LOCALITY_UNSPECIFIED Nie określono. Jeśli zostanie użyty, zwróci błąd.
REGIONAL_STRICT W tym trybie App Hosting udostępnia zawartość backendu z wybranego przez Ciebie regionu nadrzędnego. App Hosting przechowuje dane i infrastrukturę udostępniania tylko w wybranym regionie i nie replikuje danych w innych regionach.
GLOBAL_ACCESS W tym trybie App Hosting udostępnia zawartość backendu z wielu punktów dostępu (POP) na całym świecie. App Hosting replikuje konfigurację backendu i dane z pamięci podręcznej do tych serwerów POP oraz wykorzystuje globalną sieć CDN, aby jeszcze bardziej zmniejszyć czas oczekiwania na odpowiedź. Zasoby Cloud obsługiwane przez App Hosting, takie jak usługi Cloud Run, kompilacja Cloud Build i obrazy Artifact Registry, są nadal ograniczone do regionu nadrzędnego backendu. Odpowiedzi w pamięci podręcznej CDN mogą być przechowywane w punktach POP przez czas TTL pamięci podręcznej.

Baza kodu

Połączenie z zewnętrznym repozytorium źródłowym w celu monitorowania w backendzie aktualizacji opartych na zdarzeniach.

Zapis JSON 
{
  "repository": string,
  "rootDirectory": string
}
Pola
repository

string

Wymagane. Nazwa zasobu Developer Connect gitRepositoryLink połączonego z tym backendem w formacie:

projects/{projekt}/locations/{lokalizacja}/connections/{connection}/gitRepositoryLinks/{repositoryLink}

gitRepositoryLink należy połączyć za pomocą aplikacji Firebase App Hosting na GitHubie za pomocą konsoli Firebase.
rootDirectory

string

Opcjonalnie. Jeśli podany jest katalog repository, odnosi się on do katalogu głównego repozytorium, który ma być katalogiem głównym wdrożonej aplikacji internetowej.

Zasób zarządzany

Zasób zewnętrzny zarządzany przez App Hosting w projekcie.

Zapis 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.
}
Pola

Pole sumy managed_resource.

managed_resource może mieć tylko jedną z tych wartości:
runService

object (RunService)

Usługa Cloud Run service zarządzana przez App Hosting.

Uruchomienie usługi

Zarządzana usługa Cloud Run service.

Zapis JSON 
{
  "service": string
}
Pola
service

string

Opcjonalnie. Nazwa Cloud Run service w formacie:

projects/{projekt}/locations/{lokalizacja}/services/{identyfikator usługi}

Metody

create

 Tworzy nowy backend w danym projekcie i lokalizacji.

delete

 Usuwa jeden backend.

get

 Pobiera informacje o backendzie.

getTraffic

 Pobiera informacje o ruchu backendu.

list

 Wyświetla backendy w danym projekcie i lokalizacji.

patch

 Aktualizuje informacje pojedynczego backendu.

updateTraffic

 Aktualizuje ruch backendu.