REST Resource: projects.locations.flags

리소스: 플래그

단일 플래그를 나타냅니다.

JSON 표현 
{
  "name": string,
  "key": string,
  "valueType": enum (FlagValueType),
  "flagValueType": enum (ValueType),
  "evaluationSpec": {
    object (EvaluationSpec)
  },
  "unitKind": string,
  "description": string,
  "variants": [
    {
      object (FlagVariant)
    }
  ],
  "flagSet": string,
  "state": enum (State),
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string
}
필드
name

string

식별자. 표준 명명 규칙을 따르는 리소스 이름 (리소스의 전체 URI)입니다.

"projects/{project}/locations/{location}/flags/{flagId}"
key

string

필수 항목입니다. 변경할 수 없습니다. 런타임 평가 API (OpenFeature)에서 사용되는 플래그 키입니다. This is the corrected translation.
valueType
(deprecated)

enum (FlagValueType)

선택사항입니다. 변경할 수 없습니다. 지원 중단됨: 대신 flagValueType을 사용하세요. 플래그 값 유형입니다.
flagValueType

enum (ValueType)

선택사항입니다. 변경할 수 없습니다. 플래그 값 유형입니다.
evaluationSpec

object (EvaluationSpec)

선택사항입니다. 플래그 값을 평가하는 방법에 관한 사양입니다.

evaluationSpec을 지정하지 않고 불리언 플래그를 생성하면 기본적으로 두 가지 기본 변형인 '사용 설정됨' (boolValue = true)과 '사용 중지됨' (boolValue = false)이 생성되고 '사용 중지됨'이 defaultTarget으로 설정됩니다.
unitKind

string

필수 항목입니다. 변경할 수 없습니다. 이 플래그를 사용할 수 있는 UnitKind
description

string

선택사항입니다. 플래그에 대한 설명입니다. 최대 길이: 500바이트
variants[]

object (FlagVariant)

선택사항입니다. 변형 목록입니다.
flagSet

string

선택사항입니다. 이 플래그가 속한 플래그 세트입니다.
state

enum (State)

선택사항입니다. 플래그의 현재 상태입니다.
labels

map (key: string, value: string)

선택사항입니다. 분류에 사용할 수 있는 리소스의 라벨입니다. Kubernetes 리소스 라벨과 유사합니다.

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

map (key: string, value: string)

선택사항입니다. 주석은 리소스와 함께 저장되는 구조화되지 않은 키-값 맵으로, 임의의 메타데이터를 저장하고 검색하기 위해 외부 도구에서 설정할 수 있습니다. 이러한 속성은 쿼리할 수 없으며 객체를 수정할 때 보존해야 합니다.

자세한 내용은 https://kubernetes.io/docs/user-guide/annotations를 참고하세요.

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

string

출력 전용입니다. 리소스의 고유 식별자입니다. UID는 서비스의 범위 내에서 이 리소스의 특정 시점과 공간에서 고유합니다. 일반적으로 리소스가 생성될 때 서버에서 생성되며 변경할 수 없습니다. UID는 리소스 이름을 재사용하는 리소스를 고유하게 식별하는 데 사용되며 UUID4여야 합니다.
etag

string

출력 전용입니다. 리소스의 버전 또는 세대를 고유하게 식별하는 불투명 값입니다. 클라이언트 및 서버의 리소스 작성 순서가 일치함을 확인하는 데 사용될 수 있습니다.
createTime

string (Timestamp format)

출력 전용입니다. 리소스가 생성된 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. 리소스가 최종 업데이트된 타임스탬프입니다. 사용자가 리소스를 변경하면 이 값이 새로고침되어야 합니다. 서비스가 리소스를 변경하면 이 값이 새로고침되어야 합니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

FlagValueType

열거형
FLAG_VALUE_TYPE_UNSPECIFIED
FLAG_VALUE_TYPE_BOOL 불리언 플래그 값 유형입니다.
FLAG_VALUE_TYPE_INT 정수 플래그 값 유형입니다.
FLAG_VALUE_TYPE_STRING 문자열 플래그 값 유형입니다.
FLAG_VALUE_TYPE_DOUBLE double 플래그 유형입니다.

ValueType

플래그 값 유형입니다.

열거형
FLAG_VALUE_TYPE_UNSPECIFIED 지정되지 않은 플래그 값 유형입니다.
FLAG_VALUE_TYPE_BOOLEAN 불리언 플래그 값 유형입니다.
FLAG_VALUE_TYPE_INTEGER 정수 플래그 값 유형입니다.
FLAG_VALUE_TYPE_STRING 문자열 플래그 값 유형입니다.
FLAG_VALUE_TYPE_DOUBLE double 플래그 값 유형입니다.

FlagVariant

변수는 값의 식별자입니다 (값에 할당된 이름).

JSON 표현 
{
  "id": string,
  "trackingId": string,
  "description": string,

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "integerValue": string,
  "stringValue": string,
  "doubleValue": number
  // End of list of possible types for union field value.
}
필드
id

string

필수 항목입니다. 변형 ID입니다. 최대 길이: 128바이트
trackingId

string

선택사항입니다. trackingId는 서비스 범위 내에서 변형의 이름과 값에 따라 고유합니다. 일반적으로 서버에서 생성되며 변경할 수 없습니다. trackingId는 변형을 고유하게 식별하고 추적하는 데 사용됩니다.
description

string

선택사항입니다. 이 변형이 수행하거나 나타내는 항목에 대한 사람이 읽을 수 있는 설명입니다.
통합 필드 value. value는 변형의 단일 플래그 값입니다. value은 다음 중 하나여야 합니다.
booleanValue

boolean

선택사항입니다. 불리언 변형 값입니다.
integerValue

string (int64 format)

선택사항입니다. 정수 변형 값입니다.
stringValue

string

선택사항입니다. 문자열 변형 값입니다.
doubleValue

number

선택사항입니다. double 변형 값입니다.

주

State는 플래그의 상태를 정의합니다.

열거형
FLAG_STATE_UNSPECIFIED 플래그 상태가 지정되지 않았습니다.
FLAG_STATE_IN_DEVELOPMENT 플래그가 개발 상태입니다.
FLAG_STATE_ACTIVE 플래그가 활성 상태입니다.
FLAG_STATE_SUNSETTING 플래그가 지원 중단된 상태입니다.
FLAG_STATE_CLEANUP 플래그가 정리 상태입니다.

메서드

create

 새 플래그를 만듭니다.

delete

 단일 플래그를 삭제합니다.

get

 단일 플래그를 가져옵니다.

list

 플래그 컬렉션을 가져옵니다.

patch

 단일 플래그를 업데이트합니다.