REST Resource: projects.configs.variables

리소스: 변수

RuntimeConfig 리소스 내의 단일 변수를 설명합니다. 이름은 계층적 변수 이름을 나타냅니다. 예를 들어 ports/serving_port은 유효한 변수 이름입니다. 변수 값은 불투명 문자열이며 리프 변수 (하위 변수가 없는 변수)만 값을 가질 수 있습니다.

JSON 표현 
{
  "name": string,
  "updateTime": string,
  "state": enum(VariableState),

  // Union field contents can be only one of the following:
  "value": string,
  "text": string
  // End of list of possible types for union field contents.
}
필드
name

string

다음 형식의 변수 리소스 이름입니다.

projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAME]

[PROJECT_ID]는 유효한 프로젝트 ID여야 하며, [CONFIG_NAME]는 유효한 RuntimeConfig 리소스여야 하며, [VARIABLE_NAME]는 Unix 파일 시스템 파일 경로 이름 지정을 따라야 합니다.

[VARIABLE_NAME]에는 ASCII 문자, 숫자, 슬래시, 대시가 포함될 수 있습니다. 슬래시는 경로 요소 구분자로 사용되며 [VARIABLE_NAME] 자체의 일부가 아니므로 [VARIABLE_NAME]에는 슬래시가 아닌 문자가 하나 이상 포함되어야 합니다. 여러 개의 슬래시가 단일 슬래시 문자로 병합됩니다. 각 경로 세그먼트는 정규 표현식 0-9A-Za-z와 일치해야 합니다. [VARIABLE_NAME]의 길이는 256자(영문 기준) 미만이어야 합니다.

변수를 만든 후에는 변수 이름을 변경할 수 없습니다.
updateTime

string (Timestamp format)

출력 전용입니다. 마지막 변수 업데이트 시간입니다. 타임스탬프는 UTC 타임스탬프입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프로 정밀도는 나노초 수준입니다. 예를 들면 "2014-10-02T15:01:23.045123456Z"입니다.
state

enum(VariableState)

출력 전용입니다. 변수의 현재 상태입니다. 변수 상태는 variables().watch 호출의 결과를 나타내며 get 및 list 호출을 통해 확인할 수 있습니다.

통합 필드 contents. 변수의 값입니다. 바이너리 또는 문자열 값일 수 있습니다. value 또는 text 중 하나를 지정해야 합니다. 둘 다 지정하면 서버에서 오류를 반환합니다. contents은 다음 중 하나여야 합니다.
value

string (bytes format)

변수의 바이너리 값입니다. 값의 길이는 4,096바이트 미만이어야 합니다. 빈 값도 허용됩니다. 값은 base64로 인코딩되어야 하며 IETF RFC4648 (https://www.ietf.org/rfc/rfc4648.txt)을 준수해야 합니다. value 또는 text 중 하나만 설정할 수 있습니다.

base64 인코딩 문자열입니다.
text

string

변수의 문자열 값입니다. 값의 길이는 4,096바이트 미만이어야 합니다. 빈 값도 허용됩니다. 예를 들면 text: "my text value"입니다. 문자열은 유효한 UTF-8이어야 합니다.

VariableState

VariableState는 변수의 마지막으로 알려진 상태를 설명하며 variables().watch 호출 중에 변수의 상태를 구별하는 데 사용됩니다.

열거형
VARIABLE_STATE_UNSPECIFIED 기본 변수 상태입니다.
UPDATED variables().watch가 실행되는 동안 변수가 업데이트되었습니다.
DELETED variables().watch가 실행되는 동안 변수가 삭제되었습니다.

메서드

create

 지정된 구성 내에 변수를 만듭니다.

delete

 변수 또는 여러 변수를 삭제합니다.

get

 단일 변수에 관한 정보를 가져옵니다.

list

 제공된 필터와 일치하는 지정된 구성 내의 변수를 나열합니다.

testIamPermissions

 지정된 리소스에 대해 호출자가 보유한 권한을 반환합니다.

update

 기존 변수를 새 값으로 업데이트합니다.

watch

 특정 변수를 감시하고 변수 값이 변경되기를 기다립니다.