REST Resource: projects.locations.flags

Resource: Flag

Mewakili satu Bendera.

Representasi 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
}
Kolom
name

string

ID. Nama resource (URI lengkap resource) yang mengikuti skema penamaan standar:

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

key

string

Wajib. Tidak dapat diubah. Kunci tanda yang digunakan dalam API evaluasi runtime (OpenFeature). Panjang maksimum: 256 byte.

valueType
(deprecated)

enum (FlagValueType)

Opsional. Tidak dapat diubah. Tidak digunakan lagi: Gunakan flagValueType sebagai gantinya. Jenis nilai flag.

flagValueType

enum (ValueType)

Opsional. Tidak dapat diubah. Jenis nilai flag.

evaluationSpec

object (EvaluationSpec)

Opsional. Spesifikasi cara nilai tanda harus dievaluasi.

Jika flag bool dibuat tanpa evaluationSpec yang ditentukan, dua varian default, "Enabled" (dengan boolValue = true) dan "Disabled" (dengan boolValue = false), akan dibuat secara default, dan "Disabled" ditetapkan sebagai defaultTarget.

unitKind

string

Wajib. Tidak dapat diubah. UnitKind yang dapat menggunakan tanda ini.

description

string

Opsional. Deskripsi tanda. Panjang maksimum: 500 byte.

variants[]

object (FlagVariant)

Opsional. Daftar varian.

flagSet

string

Opsional. Setelan tanda yang dimiliki tanda ini.

state

enum (State)

Opsional. Status tanda saat ini.

labels

map (key: string, value: string)

Opsional. Label pada resource, yang dapat digunakan untuk kategorisasi, mirip dengan label resource Kubernetes.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

annotations

map (key: string, value: string)

Opsional. Anotasi adalah peta nilai kunci tidak terstruktur yang disimpan dengan resource yang dapat ditetapkan oleh alat eksternal untuk menyimpan dan mengambil metadata arbitrer. Objek ini tidak dapat dikueri dan harus dipertahankan saat mengubah objek.

Info selengkapnya: https://kubernetes.io/docs/user-guide/annotations

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

uid

string

Hanya output. ID unik resource. UID bersifat unik dalam waktu dan ruang untuk resource ini dalam cakupan layanan. ID ini biasanya dibuat oleh server saat pembuatan resource berhasil dan tidak boleh diubah. UID digunakan untuk mengidentifikasi resource secara unik dengan penggunaan ulang nama resource. Nilai ini harus berupa UUID4.

etag

string

Hanya output. Nilai buram yang secara unik mengidentifikasi versi atau generasi resource. Nilai ini dapat digunakan untuk mengonfirmasi bahwa klien dan server menyetujui pengurutan resource yang sedang ditulis.

createTime

string (Timestamp format)

Hanya output. Stempel waktu saat resource dibuat.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Hanya output. Stempel waktu saat resource terakhir diperbarui. Setiap perubahan pada resource yang dilakukan oleh pengguna harus memperbarui nilai ini. Perubahan pada resource yang dilakukan oleh layanan harus memperbarui nilai ini.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

FlagValueType

Enum
FLAG_VALUE_TYPE_UNSPECIFIED
FLAG_VALUE_TYPE_BOOL Jenis nilai tanda boolean.
FLAG_VALUE_TYPE_INT Jenis nilai tanda bilangan bulat.
FLAG_VALUE_TYPE_STRING Jenis nilai tanda string.
FLAG_VALUE_TYPE_DOUBLE Jenis bendera ganda.

ValueType

Jenis nilai flag.

Enum
FLAG_VALUE_TYPE_UNSPECIFIED Jenis nilai tanda tidak ditentukan.
FLAG_VALUE_TYPE_BOOLEAN Jenis nilai tanda boolean.
FLAG_VALUE_TYPE_INTEGER Jenis nilai tanda bilangan bulat.
FLAG_VALUE_TYPE_STRING Jenis nilai tanda string.
FLAG_VALUE_TYPE_DOUBLE Jenis nilai tanda ganda.

FlagVariant

Varian adalah ID untuk nilai (nama yang ditetapkan ke nilai).

Representasi 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.
}
Kolom
id

string

Wajib. ID Varian. Panjang maksimum: 128 byte.

trackingId

string

Opsional. trackingId bersifat unik bergantung pada nama dan nilai varian dalam cakupan layanan. Biasanya dihasilkan oleh server dan tidak boleh diubah. trackingId digunakan untuk mengidentifikasi dan melacak varian secara unik.

description

string

Opsional. Deskripsi yang dapat dibaca manusia tentang fungsi atau representasi varian ini.

Kolom union value. value adalah nilai flag tunggal untuk varian. value hanya ada berupa salah satu diantara berikut:
booleanValue

boolean

Opsional. Nilai varian Boolean.

integerValue

string (int64 format)

Opsional. Nilai varian bilangan bulat.

stringValue

string

Opsional. Nilai varian string.

doubleValue

number

Opsional. Nilai varian ganda.

Negara bagian/Provinsi

Status menentukan status tanda.

Enum
FLAG_STATE_UNSPECIFIED Status tanda tidak ditentukan.
FLAG_STATE_IN_DEVELOPMENT Bendera dalam status pengembangan.
FLAG_STATE_ACTIVE Bendera dalam status aktif.
FLAG_STATE_SUNSETTING Flag dalam status tidak digunakan lagi.
FLAG_STATE_CLEANUP Bendera dalam status pembersihan.

Metode

create

Buat tanda baru.

delete

Menghapus satu tanda.

get

Mengambil satu tanda.

list

Mengambil kumpulan tanda.

patch

Perbarui satu tanda.