REST Resource: projects.locations.backends

Recurso: Backend

Un backend es el recurso principal de App Hosting.

Representación 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
}
Campos
name

string

Identificador. El nombre del recurso del backend.

Formato:

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

string

Opcional. Nombre legible por humanos. Límite de 63 caracteres.
servingLocality

enum (ServingLocality)

Obligatorio. Inmutable. Especifica cómo Hosting de apps entregará el contenido de este backend. Estará contenido en una sola región (REGIONAL_STRICT) o podrá usar la infraestructura de entrega replicada global de App Hosting (GLOBAL_ACCESS).
codebase

object (Codebase)

Opcional. Si se especifica, la conexión a un repositorio de código fuente externo para buscar actualizaciones del backend controladas por eventos.
uri

string

Solo salida. El URI principal para comunicarse con el backend.
managedResources[]

object (ManagedResource)

Solo salida. Una lista de los recursos que administra este backend.
serviceAccount

string

Obligatorio. El nombre de la cuenta de servicio que se usó para Cloud Build y Cloud Run. Debe tener el rol roles/firebaseapphosting.googleapis.com/computeRunner o permisos equivalentes.
appId

string

Opcional. Es el ID de una app web asociada con el backend.
environment

string

Opcional. El nombre del entorno del backend, que se usa para cargar variables de entorno desde la configuración específica del entorno.
reconciling

boolean

Solo salida. Un campo que, si es verdadero, indica que el sistema está trabajando para realizar ajustes en el backend durante una LRO.
createTime

string (Timestamp format)

Solo salida. Hora en la que se creó el backend.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Solo salida. Hora en la que se actualizó el backend por última vez.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
deleteTime

string (Timestamp format)

Solo salida. Hora en la que se borró el backend.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
labels

map (key: string, value: string)

Opcional. Mapa de clave-valor no estructurado que se puede usar para organizar y categorizar objetos.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
annotations

map (key: string, value: string)

Opcional. Mapa clave-valor no estructurado que puede establecerse por herramientas externas para almacenar metadatos arbitrarios. No se pueden consultar y deben conservarse cuando se modifican objetos.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
uid

string

Solo salida. Es un identificador único asignado por el sistema.
etag

string

Solo salida. Suma de verificación procesada por el servidor basada en otros valores se puede enviar cuando se actualice o borre para garantizar que la operación se realice en el recurso esperado.

ServingLocality

Especifica cómo App Hosting replica y entrega los datos de tu backend.

Enums
SERVING_LOCALITY_UNSPECIFIED Sin especificar. Se mostrará un error si se usa.
REGIONAL_STRICT En este modo, App Hosting entrega el contenido de tu backend desde la región superior elegida. App Hosting solo mantiene los datos y la infraestructura de entrega en la región elegida y no replica tus datos en otras regiones.
GLOBAL_ACCESS En este modo, App Hosting entrega el contenido de tu backend desde múltiples puntos de presencia (POP) en todo el mundo. App Hosting replica la configuración de tu backend y los datos almacenados en caché en estos POP y usa una CDN global para disminuir aún más la latencia de respuesta. Los recursos de Cloud mantenidos por App Hosting en tu proyecto, como los servicios de Cloud Run, la compilación de Cloud Build y las imágenes de Artifact Registry, siguen confinados a la región superior de tu backend. Las respuestas almacenadas en caché por la CDN pueden almacenarse en los POP mientras dure el TTL de la caché.

Base de código

La conexión a un repositorio de código fuente externo para buscar actualizaciones del backend controladas por eventos.

Representación JSON 
{
  "repository": string,
  "rootDirectory": string
}
Campos
repository

string

Obligatorio. El nombre del recurso de Developer Connect gitRepositoryLink conectado a este backend, en el formato:

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

La conexión para gitRepositoryLink se debe realizar con la app de GitHub de Firebase App Hosting a través de Firebase console.
rootDirectory

string

Opcional. Si se proporciona repository, el directorio relativo a la raíz del repositorio que se usará como raíz para la app web implementada.

ManagedResource

Un recurso externo administrado por App Hosting en el proyecto.

Representación 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.
}
Campos

Campo de unión managed_resource.

managed_resource puede ser una de las siguientes opciones:
runService

object (RunService)

Un service de Cloud Run administrado por App Hosting

Servicio de ejecución

Un service administrado de Cloud Run

Representación JSON 
{
  "service": string
}
Campos
service

string

Opcional. El nombre de Cloud Run service, en el formato:

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

Métodos

create

 Crea un nuevo backend en una ubicación y un proyecto determinados.

delete

 Borra un solo backend.

get

 Obtiene información sobre un backend.

getTraffic

 Obtiene información sobre el tráfico de un backend.

list

 Enumera los backends en un proyecto y una ubicación determinados.

patch

 Actualiza la información de un solo backend.

updateTraffic

 Actualiza el tráfico de un backend.