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), либо ему будет разрешено использовать глобально реплицируемую обслуживающую инфраструктуру App Hosting (GLOBAL_ACCESS).

codebase

object ( Codebase )

Необязательный. Если указано, подключение к внешнему исходному репозиторию для отслеживания обновлений серверной части, управляемых событиями.

uri

string

Только вывод. Основной URI для связи с серверной частью.

managedResources[]

object ( ManagedResource )

Только вывод. Список ресурсов, управляемых этим сервером.

serviceAccount

string

Необходимый. Имя сервисной учетной записи, используемой для Cloud Build и Cloud Run. Должна иметь роль roles/firebaseapphosting.googleapis.com/computeRunner или эквивалентные разрешения.

appId

string

Необязательный. Идентификатор веб-приложения, связанного с серверной частью.

environment

string

Необязательный. Имя среды серверной части, используемое для загрузки переменных среды из конкретной конфигурации среды.

reconciling

boolean

Только вывод. Поле, которое, если оно истинно, указывает, что система работает над внесением изменений в серверную часть во время LRO.

createTime

string ( Timestamp format)

Только вывод. Время создания серверной части.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

updateTime

string ( Timestamp format)

Только вывод. Время последнего обновления серверной части.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

deleteTime

string ( Timestamp format)

Только вывод. Время, когда серверная часть была удалена.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "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) по всему миру. Хостинг приложений реплицирует конфигурацию вашей серверной части и кэшированные данные на эти POP и использует глобальную CDN для дальнейшего уменьшения задержки ответа. Облачные ресурсы вашего проекта, поддерживаемые хостингом приложений, такие как службы Cloud Run, сборки Cloud Build и образы реестра артефактов, по-прежнему ограничены родительским регионом вашей серверной части. Ответы, кэшированные CDN, могут храниться в точках POP в течение срока TTL кэша.

Кодовая база

Подключение к внешнему исходному репозиторию для отслеживания обновлений серверной части, управляемых событиями.

JSON-представление 
{
  "repository": string,
  "rootDirectory": string
}
Поля
repository

string

Необходимый. Имя ресурса для Developer Connect gitRepositoryLink подключенного к этому бэкэнду, в формате:

проекты/{project}/locations/{location}/connections/{connection}/gitRepositoryLinks/{repositoryLink}

Соединение для gitRepositoryLink должно быть выполнено с помощью приложения Firebase App Hosting Github через консоль Firebase.

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 )

service Cloud Run, управляемая хостингом приложений.

RunService

Управляемый service Cloud Run.

JSON-представление 
{
  "service": string
}
Поля
service

string

Необязательный. Имя service Cloud Run в формате:

проекты/{project}/locations/{location}/services/{serviceId}

Методы

create

 Создает новый бэкэнд в заданном проекте и местоположении.

delete

 Удаляет один бэкэнд.

get

 Получает информацию о серверной части.

getTraffic

 Получает информацию о трафике серверной части.

list

 Перечисляет серверные части в данном проекте и местоположении.

patch

 Обновляет информацию для одного серверного компонента.

updateTraffic

 Обновляет трафик серверной части.