REST Resource: projects.configs.variables

Resource: Variable

Menjelaskan satu variabel dalam resource RuntimeConfig. Nama ini menunjukkan nama variabel hierarkis. Misalnya, ports/serving_port adalah nama variabel yang valid. Nilai variabel adalah string buram dan hanya variabel daun yang dapat memiliki nilai (yaitu, variabel yang tidak memiliki variabel turunan).

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

string

Nama resource variabel, dalam format:

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

[PROJECT_ID] harus berupa project ID yang valid, [CONFIG_NAME] harus berupa resource RuntimeConfig yang valid, dan [VARIABLE_NAME] mengikuti penamaan jalur file sistem file Unix.

[VARIABLE_NAME] dapat berisi huruf, angka, garis miring, dan tanda hubung ASCII. Garis miring digunakan sebagai pemisah elemen jalur dan bukan bagian dari [VARIABLE_NAME] itu sendiri, sehingga [VARIABLE_NAME] harus berisi minimal satu karakter non-garis miring. Beberapa garis miring digabungkan menjadi satu karakter garis miring. Setiap segmen jalur harus cocok dengan ekspresi reguler 0-9A-Za-z?. Panjang [VARIABLE_NAME] harus kurang dari 256 karakter.

Setelah membuat variabel, Anda tidak dapat mengubah nama variabel.
updateTime

string (Timestamp format)

Hanya output. Waktu pembaruan variabel terakhir. Stempel waktu akan berupa stempel waktu UTC.

Stempel waktu dalam format RFC3339 UTC "Zulu", akurat hingga nanodetik. Contoh: "2014-10-02T15:01:23.045123456Z".
state

enum(VariableState)

Hanya output. Status variabel saat ini. Status variabel menunjukkan hasil panggilan variables().watch dan terlihat melalui panggilan get dan list.

Kolom union contents. Nilai variabel. Nilai ini dapat berupa nilai biner atau string. Anda harus menentukan salah satu dari value atau text. Menentukan keduanya akan menyebabkan server menampilkan error. contents hanya dapat berupa salah satu dari hal berikut:
value

string (bytes format)

Nilai biner variabel. Panjang nilai harus kurang dari 4096 byte. Nilai kosong juga diterima. Nilai harus dienkode dengan base64, dan harus mematuhi IETF RFC4648 (https://www.ietf.org/rfc/rfc4648.txt). Hanya satu dari value atau text yang dapat ditetapkan.

String berenkode base64.
text

string

Nilai string variabel. Panjang nilai harus kurang dari 4096 byte. Nilai kosong juga diterima. Misalnya, text: "my text value". String harus berupa UTF-8 yang valid.

VariableState

VariableState menjelaskan status terakhir yang diketahui dari variabel dan digunakan selama panggilan variables().watch untuk membedakan status variabel.

Enum
VARIABLE_STATE_UNSPECIFIED Status variabel default.
UPDATED Variabel diperbarui, saat variables().watch dieksekusi.
DELETED Variabel dihapus, saat variables().watch dieksekusi.

Metode

create

 Membuat variabel dalam konfigurasi yang diberikan.

delete

 Menghapus satu atau beberapa variabel.

get

 Mendapatkan informasi tentang satu variabel.

list

 Mencantumkan variabel dalam konfigurasi tertentu, yang cocok dengan filter yang diberikan.

testIamPermissions

 Menampilkan izin yang dimiliki pemanggil pada resource yang ditentukan.

update

 Memperbarui variabel yang ada dengan nilai baru.

watch

 Mengamati variabel tertentu dan menunggu perubahan pada nilai variabel.