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

식별자. 백엔드의 리소스 이름입니다.

형식:

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에 사용되는 서비스 계정의 이름입니다. 역할/firebaseapphosting.googleapis.com/computeRunner 또는 이에 상응하는 권한이 있어야 합니다.
appId

string

선택사항입니다. 백엔드와 연결된 웹 앱의 ID입니다.
environment

string

선택사항입니다. 백엔드의 환경 이름으로, 환경별 구성에서 환경 변수를 로드하는 데 사용됩니다.
reconciling

boolean

출력 전용입니다. true인 경우 LRO 중에 시스템이 백엔드를 조정하려고 시도 중임을 나타내는 필드입니다.
createTime

string (Timestamp format)

출력 전용입니다. 백엔드가 생성된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. 백엔드가 마지막으로 업데이트된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
deleteTime

string (Timestamp format)

출력 전용입니다. 백엔드가 삭제된 시간입니다.

RFC3339 UTC '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

출력 전용입니다. 시스템에서 할당한 고유 식별자입니다.
etag

string

출력 전용입니다. 다른 값을 기반으로 서버에서 계산된 체크섬 예상된 리소스에서 작업이 완료되도록 업데이트 또는 삭제 시 전송될 수 있습니다.

게재 지역

App Hosting에서 백엔드의 데이터를 복제하고 제공하는 방법을 지정합니다.

열거형
SERVING_LOCALITY_UNSPECIFIED 지정되지 않음. 사용하면 오류가 반환됩니다.
REGIONAL_STRICT 이 모드에서 App Hosting은 선택한 상위 리전에서 백엔드의 콘텐츠를 제공합니다. App Hosting은 선택한 리전에서만 데이터 및 제공 인프라를 유지하고 다른 리전에 데이터를 복제하지 않습니다.
GLOBAL_ACCESS 이 모드에서 App Hosting은 전 세계 여러 접속 지점 (POP)에서 백엔드 콘텐츠를 제공합니다. App Hosting은 백엔드 구성 및 캐시된 데이터를 이러한 POP로 복제하고 글로벌 CDN을 사용하여 응답 지연 시간을 더욱 단축합니다. 프로젝트에서 Cloud Run 서비스, Cloud Build 빌드, Artifact Registry 이미지와 같이 App Hosting에서 관리하는 Cloud 리소스는 여전히 백엔드의 상위 리전에만 제한됩니다. CDN에 의해 캐시된 응답은 캐시의 TTL 기간 동안 POP에 저장될 수 있습니다.

코드베이스

백엔드에 대한 이벤트 기반 업데이트를 감시하기 위한 외부 소스 저장소에 대한 연결입니다.

JSON 표현 
{
  "repository": string,
  "rootDirectory": string
}
필드
repository

string

필수 항목입니다. 이 백엔드에 연결된 Developer Connect gitRepositoryLink의 리소스 이름으로, 형식은 다음과 같습니다.

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

gitRepositoryLink의 연결은 Firebase Console을 통해 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

RunService

관리형 Cloud Run service

JSON 표현 
{
  "service": string
}
필드
service

string

선택사항입니다. Cloud Run service의 이름으로, 형식은 다음과 같습니다.

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

메소드

create

 지정된 프로젝트 및 위치에 새 백엔드를 만듭니다.

delete

 단일 백엔드를 삭제합니다.

get

 백엔드 정보를 가져옵니다.

getTraffic

 백엔드의 트래픽 정보를 가져옵니다.

list

 지정된 프로젝트 및 위치의 백엔드를 나열합니다.

patch

 단일 백엔드의 정보를 업데이트합니다.

updateTraffic

 백엔드의 트래픽을 업데이트합니다.