MCP Tools Reference: saasservicemgmt

Alat: get_flag_revision

Mendapatkan resource FlagRevision. Parameter wajib: 'name' (misalnya, projects/my-project/locations/us-central1/flagRevisions/my-flagrevision).

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP get_flag_revision.

Permintaan Curl 
                  
curl --location 'https://saasservicemgmt.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "get_flag_revision",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

Struktur permintaan untuk metode GetFlagRevision.

GetFlagRevisionRequest

Representasi JSON 
{
  "name": string
}
Kolom
name

string

Wajib. Nama resource dalam layanan.

Skema Output

Snapshot EvaluationSpec untuk Flag.

FlagRevision

Representasi JSON 
{
  "name": string,
  "flag": string,
  "evaluationSpec": {
    object (EvaluationSpec)
  },
  "snapshot": {
    object (Flag)
  },
  "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}/flagRevisions/{flag_revision_id}"
flag

string

Wajib. Tidak dapat diubah. Nama Flag yang direvisi.
evaluationSpec
(deprecated)

object (EvaluationSpec)

Hanya output. Tidak dapat diubah. Snapshot EvaluationSpec untuk flag. TIDAK DIGUNAKAN LAGI: Gunakan snapshot sebagai gantinya.
snapshot

object (Flag)

Hanya output. Tidak dapat diubah. Cuplikan Flag.
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".

EvaluationSpec

Representasi JSON 
{
  "variants": [
    {
      object (Variant)
    }
  ],
  "defaultTarget": string,
  "allocations": [
    {
      object (Allocation)
    }
  ],
  "rules": [
    {
      object (EvaluationRule)
    }
  ],
  "attributes": [
    string
  ]
}
Kolom
variants[]
(deprecated)

object (Variant)

Opsional. Daftar varian.
defaultTarget

string

Wajib. Varian atau alokasi default flag.
allocations[]

object (Allocation)

Opsional. Daftar alokasi.
rules[]

object (EvaluationRule)

Opsional. Aturan evaluasi menentukan logika untuk mengevaluasi tanda terhadap konteks tertentu. Aturan dievaluasi secara berurutan dalam urutan yang ditentukan.
attributes[]

string

Opsional. Nama atribut konteks yang digunakan dalam aturan evaluasi dan alokasi.

Varian

Representasi JSON 
{
  "name": string,

  // Union field value can be only one of the following:
  "boolValue": boolean,
  "intValue": string,
  "stringValue": string,
  "doubleValue": number
  // End of list of possible types for union field value.
}
Kolom
name

string

Wajib. Nama varian. Panjang maksimum: 128 byte.
Kolom union value. value adalah nilai flag tunggal untuk varian. value hanya ada berupa salah satu diantara berikut:
boolValue

boolean

Opsional. Nilai tanda boolean.
intValue

string (int64 format)

Opsional. Nilai tanda bilangan bulat.
stringValue

string

Opsional. Nilai tanda string.
doubleValue

number

Opsional. Nilai tanda ganda.

Alokasi

Representasi JSON 
{
  "id": string,
  "randomizedOn": string,
  "description": string,
  "slots": [
    {
      object (AllocationSlot)
    }
  ]
}
Kolom
id

string

Wajib. ID Alokasi. Panjang maksimum: 128 byte.
randomizedOn

string

Wajib. Kunci atribut konteks yang digunakan untuk pemisahan traffic.
description

string

Opsional. Deskripsi alokasi. Panjang maksimum: 500 byte.
slots[]

object (AllocationSlot)

Wajib. Slot menentukan distribusi varian yang diberi bobot.

AllocationSlot

Representasi JSON 
{
  "variant": string,
  "weight": integer
}
Kolom
variant

string

Wajib. Varian slot alokasi.
weight

integer

Wajib. Bobot menentukan proporsi traffic yang akan dialokasikan ke varian, relatif terhadap slot lain dalam alokasi yang sama.

EvaluationRule

Representasi JSON 
{
  "id": string,
  "condition": string,
  "target": string
}
Kolom
id

string

Wajib. ID aturan evaluasi. Panjang maksimum: 128 byte.
condition

string

Wajib. Ekspresi Common Expression Language (CEL) yang dievaluasi ke boolean. Ekspresi dievaluasi berdasarkan konteks yang diberikan. Jika menampilkan nilai benar (true), target aturan akan diterapkan.
target

string

Wajib. Target varian atau alokasi yang akan diterapkan jika kondisi terpenuhi. Nilai ini harus cocok dengan nama varian yang ditentukan atau ID alokasi.

Flag

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/{flag_id}"
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 flag_value_type 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 evaluation_spec yang ditentukan, dua varian default, "Diaktifkan" (dengan bool_value = true) dan "Dinonaktifkan" (dengan bool_value = false), akan dibuat secara default, dan "Dinonaktifkan" akan ditetapkan sebagai default_target.
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".

FlagVariant

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.

LabelsEntry

Representasi JSON 
{
  "key": string,
  "value": string
}
Kolom
key

string
value

string

AnnotationsEntry

Representasi JSON 
{
  "key": string,
  "value": string
}
Kolom
key

string
value

string

Stempel waktu

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z).
nanos

integer

Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nanos non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif.

LabelsEntry

Representasi JSON 
{
  "key": string,
  "value": string
}
Kolom
key

string
value

string

AnnotationsEntry

Representasi JSON 
{
  "key": string,
  "value": string
}
Kolom
key

string
value

string

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ❌