REST Resource: sites.versions

자원: 버전

Version 사이트 표시 방법을 결정하는 구성 및 정적 파일 모음입니다.

JSON 표현
{
  "name": string,
  "status": enum (VersionStatus),
  "config": {
    object (ServingConfig)
  },
  "labels": {
    string: string,
    ...
  },
  "createTime": string,
  "createUser": {
    object (ActingUser)
  },
  "finalizeTime": string,
  "finalizeUser": {
    object (ActingUser)
  },
  "deleteTime": string,
  "deleteUser": {
    object (ActingUser)
  },
  "fileCount": string,
  "versionBytes": string
}
필드
name

string

해당 버전의 정규화된 리소스 이름으로, 형식은 다음과 같습니다.

sites/ SITE_ID /versions/ VERSION_ID

이 이름은 versions.create 호출할 때 응답 본문에 제공됩니다.

status

enum ( VersionStatus )

버전의 배포 상태입니다.

성공적인 배포를 위해서는 versions.create 호출하여 새 버전( CREATED 상태)을 만들고 원하는 모든 파일을 해당 버전에 업로드한 다음 버전을 FINALIZED 상태로 업데이트하세요 .

버전을 CREATED 상태로 12시간 이상 놔두면 시스템이 자동으로 해당 버전을 ABANDONED 로 표시합니다.

versions.delete 호출하여 버전 상태를 DELETED 로 변경할 수도 있습니다.

config

object ( ServingConfig )

사이트 동작에 대한 구성입니다. 이 구성은 firebase.json 파일에 있습니다.

labels

map (key: string, value: string)

추가 메타데이터 및/또는 필터링에 사용되는 라벨입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

createTime

string ( Timestamp format)

출력만 가능합니다. 버전이 생성된 시간입니다.

RFC3339 UTC "Zulu" 형식의 타임스탬프이며 해상도는 나노초이며 최대 9자리 소수 자릿수입니다. 예: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z" .

createUser

object ( ActingUser )

출력만 가능합니다. 버전을 생성한 사용자를 식별합니다.

finalizeTime

string ( Timestamp format)

출력만 가능합니다. 버전이 FINALIZED 시간입니다.

RFC3339 UTC "Zulu" 형식의 타임스탬프이며 해상도는 나노초이며 최대 9자리 소수 자릿수입니다. 예: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z" .

finalizeUser

object ( ActingUser )

출력만 가능합니다. 버전을 FINALIZED 사용자를 식별합니다.

deleteTime

string ( Timestamp format)

출력만 가능합니다. 버전이 DELETED 시간입니다.

RFC3339 UTC "Zulu" 형식의 타임스탬프이며 해상도는 나노초이며 최대 9자리 소수 자릿수입니다. 예: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z" .

deleteUser

object ( ActingUser )

출력만 가능합니다. 버전을 DELETED 사용자를 식별합니다.

fileCount

string ( int64 format)

출력만 가능합니다. 버전과 관련된 총 파일 수입니다.

이 값은 버전이 FINALIZED 된 후에 계산됩니다.

versionBytes

string ( int64 format)

출력만 가능합니다. 버전의 총 저장된 바이트 크기입니다.

이 값은 버전이 FINALIZED 된 후에 계산됩니다.

버전상태

배포 수명 주기에서 특정 버전의 현재 알려진 상태입니다.

열거형
VERSION_STATUS_UNSPECIFIED 기본 상태입니다. 의도적으로 사용해서는 안 됩니다.
CREATED 버전이 생성되었으며 현재 버전에 콘텐츠가 추가되고 있습니다.
FINALIZED 모든 콘텐츠가 버전에 추가되었으며 더 이상 버전을 변경할 수 없습니다.
DELETED 버전이 삭제되었습니다.
ABANDONED 해당 버전은 12시간 이내에 FINALIZED 로 업데이트되지 않아 자동으로 삭제되었습니다.
EXPIRED 버전이 사이트에서 구성한 유지 버전 수 제한을 벗어나므로 해당 버전의 콘텐츠가 삭제되도록 예약되었습니다.
CLONING 버전이 다른 버전에서 복제되고 있습니다. 모든 콘텐츠가 아직 복사되고 있습니다.

ServingConfig

콘텐츠를 제공하기 전에 사이트로 들어오는 요청을 라우팅하고 처리하는 방법에 대한 구성입니다. URL 요청 경로는 구성에 지정된 URL 패턴과 일치하며, 호스팅은 특정 우선순위 에 따라 적용 가능한 구성을 적용합니다.

JSON 표현
{
  "headers": [
    {
      object (Header)
    }
  ],
  "redirects": [
    {
      object (Redirect)
    }
  ],
  "rewrites": [
    {
      object (Rewrite)
    }
  ],
  "cleanUrls": boolean,
  "trailingSlashBehavior": enum (TrailingSlashBehavior),
  "i18n": {
    object (I18nConfig)
  }
}
필드
headers[]

object ( Header )

각 개체가 요청 URL 경로와 일치하는 경우 호스팅을 트리거하여 지정된 사용자 지정 응답 헤더를 적용하는 URL 패턴을 지정하는 개체 배열입니다.

redirects[]

object ( Redirect )

각 규칙이 요청 URL 경로와 일치하는 경우 지정된 대상 경로에 대한 리디렉션으로 응답하도록 호스팅을 트리거하는 URL 패턴을 지정하는 개체 배열(리디렉션 규칙이라고 함)입니다.

rewrites[]

object ( Rewrite )

각 규칙이 요청 URL 경로와 일치하는 경우 호스팅이 서비스에 지정된 대상 URL이 제공된 것처럼 응답하도록 트리거하는 URL 패턴을 지정하는 객체 배열(재작성 규칙이라고 함)입니다.

cleanUrls

boolean

업로드된 파일에서 파일 확장자를 삭제할지 여부를 정의합니다.

trailingSlashBehavior

enum ( TrailingSlashBehavior )

URL 경로에서 후행 슬래시를 처리하는 방법을 정의합니다.

i18n

object ( I18nConfig )

선택 과목. i18n 재작성 동작을 정의합니다.

Header 요청 URL 경로와 일치하는 경우 호스팅을 트리거하여 지정된 사용자 지정 응답 헤더를 적용하는 URL 패턴을 지정합니다.

JSON 표현
{
  "headers": {
    string: string,
    ...
  },

  // Union field pattern can be only one of the following:
  "glob": string,
  "regex": string
  // End of list of possible types for union field pattern.
}
필드
headers

map (key: string, value: string)

필수의. 응답에 추가할 추가 헤더입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

유니온 필드 pattern .
필수의. 이 사용자 정의 응답 헤더를 적용할지 여부를 결정하기 위해 요청 URL 경로와 일치시킬 문자열 URL 패턴입니다. Bash 스타일 glob 또는 RE2 정규 표현식일 수 있습니다.

pattern 다음 중 하나만 가능합니다.
glob

string

요청 URL 경로와 일치시킬 사용자 제공 glob 입니다.

regex

string

요청 URL 경로와 일치시킬 사용자 제공 RE2 정규식입니다.

리디렉션

Redirect 요청 URL 경로와 일치하는 경우 호스팅이 지정된 대상 경로에 대한 리디렉션으로 응답하도록 트리거하는 URL 패턴을 지정합니다.

JSON 표현
{
  "statusCode": integer,
  "location": string,

  // Union field pattern can be only one of the following:
  "glob": string,
  "regex": string
  // End of list of possible types for union field pattern.
}
필드
statusCode

integer

필수의. 응답으로 반환할 상태 HTTP 코드입니다. 유효한 3xx 상태 코드여야 합니다.

location

string

필수의. 응답의 HTTP 위치 헤더에 넣을 값입니다.

위치에는 세그먼트를 식별하기 위한 : 접두사와 나머지 URL을 캡처하기 위한 선택적인 * 사용하여 패턴의 캡처 그룹 값이 포함될 수 있습니다. 예를 들어:

"glob": "/:capture*",
"statusCode": 301,
"location": "https://example.com/foo/:capture"

유니온 필드 pattern .
필수의. 이 리디렉션을 적용할지 여부를 결정하기 위해 요청 URL 경로와 일치시킬 문자열 URL 패턴입니다. Bash 스타일 glob 또는 RE2 정규 표현식일 수 있습니다.

pattern 다음 중 하나만 가능합니다.
glob

string

요청 URL 경로와 일치시킬 사용자 제공 glob 입니다.

regex

string

요청 URL 경로와 일치시킬 사용자 제공 RE2 정규식입니다.

고쳐 쓰기

Rewrite 요청 URL 경로와 일치하는 경우 호스팅이 서비스에 지정된 대상 URL이 제공된 것처럼 응답하도록 트리거하는 URL 패턴을 지정합니다.

JSON 표현
{
  "functionRegion": string,

  // Union field pattern can be only one of the following:
  "glob": string,
  "regex": string
  // End of list of possible types for union field pattern.

  // Union field behavior can be only one of the following:
  "path": string,
  "function": string,
  "run": {
    object (CloudRunRewrite)
  }
  // End of list of possible types for union field behavior.
}
필드
functionRegion

string

선택 과목. 재작성된 Functions 호출을 위한 Cloud 지역을 지정합니다. 제공되지 않은 경우 기본값은 us-central1입니다.

유니온 필드 pattern .
필수의. 이 재작성을 적용할지 여부를 결정하기 위해 요청 URL 경로와 일치시킬 문자열 URL 패턴입니다. Bash 스타일 glob 또는 RE2 정규 표현식일 수 있습니다.

pattern 다음 중 하나만 가능합니다.
glob

string

요청 URL 경로와 일치시킬 사용자 제공 glob 입니다.

regex

string

요청 URL 경로와 일치시킬 사용자 제공 RE2 정규식입니다.

Union 필드 behavior .
필수의. 재작성 동작입니다.

behavior 다음 중 하나만 가능합니다.
path

string

요청을 다시 쓸 URL 경로입니다.

function

string

요청을 프록시하는 기능입니다. 내보낸 함수 이름과 정확히 일치해야 합니다.

run

object ( CloudRunRewrite )

요청이 Cloud Run으로 전달됩니다.

CloudRunRewrite

요청을 Cloud Run 서비스로 전달하는 구성된 재작성입니다. Firebase 호스팅 구성을 설정하거나 업데이트할 때 Cloud Run 서비스가 없으면 요청이 실패합니다. Cloud Run 서비스의 모든 오류는 최종 사용자에게 전달됩니다. 예를 들어 서비스를 삭제하면 해당 서비스로 전달되는 모든 요청에 404 오류가 수신됩니다.

JSON 표현
{
  "serviceId": string,
  "region": string,
  "tag": string
}
필드
serviceId

string

필수의. Cloud Run 서비스의 사용자 정의 ID입니다.

region

string

선택 과목. Cloud Run 서비스가 호스팅되는 사용자 제공 지역입니다.

제공되지 않은 경우 기본값은 us-central1 입니다.

tag

string

선택 과목. 트래픽을 보낼 사용자 제공 TrafficConfig 태그입니다.

생략하면 서비스 전체 URI로 트래픽이 전송됩니다.

후행슬래시 동작

요청 URL 경로에 후행 슬래시를 추가하거나 제거해야 하는지 여부를 정의합니다.

열거형
TRAILING_SLASH_BEHAVIOR_UNSPECIFIED

동작이 지정되지 않았습니다.

파일은 정확한 위치에만 제공되며 후행 슬래시는 디렉터리 인덱스에만 추가됩니다.

ADD 후행 슬래시는 디렉토리 색인뿐만 아니라 파일 확장자로 끝나지 않는 모든 URL 경로에 추가 됩니다.
REMOVE 후행 슬래시는 디렉토리 색인과 파일 확장자로 끝나지 않는 모든 URL 경로에서 제거 됩니다.

I18n구성

제공되면 i18n 재작성이 활성화됩니다.

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

string

필수의. 공개 디렉토리 내에서 국가 및 언어별 콘텐츠를 검색할 사용자 제공 경로입니다.

행동 양식

clone

지정된 버전의 콘텐츠를 사용하여 지정된 대상 사이트에 새 버전을 만듭니다.

create

지정된 사이트에 대한 새 버전을 만듭니다.

delete

지정된 버전을 삭제합니다.

get

지정된 사이트에 대해 생성된 지정된 버전을 가져옵니다.

list

지정된 사이트에 대해 생성된 버전을 나열합니다.

patch

지정된 버전에 대해 지정된 메타데이터를 업데이트합니다.

populateFiles

지정된 버전에 콘텐츠 파일을 추가합니다.