REST Resource: projects.locations.saas

Resource: Saas

SaaS adalah representasi layanan SaaS yang dikelola oleh Produsen.

Representasi JSON
{
  "name": string,
  "locations": [
    {
      object (Location)
    }
  ],
  "state": enum (State),
  "conditions": [
    {
      object (SaasCondition)
    }
  ],
  "error": {
    object (Status)
  },
  "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}/saas/{saas}"

locations[]

object (Location)

Opsional. Daftar lokasi tempat layanan tersedia. Rollout merujuk ke daftar untuk membuat rencana peluncuran.

state

enum (State)

Hanya output. Status SaaS. Selalu dalam status AKTIF jika applicationTemplate kosong.

conditions[]

object (SaasCondition)

Hanya output. Serangkaian kondisi yang menunjukkan berbagai kondisi yang dapat dimiliki resource ini.

error

object (Status)

Hanya output. Jika statusnya GAGAL, kode dan pesan error yang sesuai. Secara default, kode=OK untuk semua status lainnya.

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".

Lokasi

Informasi lokasi tempat layanan tersedia.

Representasi JSON
{
  "name": string
}
Kolom
name

string

Opsional. Nama lokasi.

Negara bagian/Provinsi

Status SaaS.

Enum
STATE_TYPE_UNSPECIFIED Jenis status tidak ditentukan.
ACTIVE

Tidak digunakan lagi: Gunakan STATE_ACTIVE.

RUNNING

Tidak digunakan lagi: Gunakan STATE_RUNNING.

FAILED

Tidak digunakan lagi: Gunakan STATE_FAILED.

STATE_ACTIVE SaaS sudah siap
STATE_RUNNING Dalam proses mengimpor, menyinkronkan, atau mereplikasi ApplicationTemplate
STATE_FAILED Kegagalan selama proses mengimpor, menyinkronkan, atau mereplikasi pemrosesan ApplicationTemplate

SaasCondition

SaasCondition menjelaskan status Saas.

Representasi JSON
{
  "status": enum (Status),
  "type": enum (Type),
  "lastTransitionTime": string,
  "message": string,
  "reason": string
}
Kolom
status

enum (Status)

Wajib. Status kondisi.

type

enum (Type)

Wajib. Jenis kondisi.

lastTransitionTime

string (Timestamp format)

Wajib. Terakhir kali kondisi bertransisi dari satu status ke status lainnya.

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".

message

string

Wajib. Pesan yang dapat dibaca manusia yang menunjukkan detail tentang transisi terakhir.

reason

string

Wajib. Alasan singkat untuk transisi terakhir kondisi.

Status

Enumerasi status kondisi.

Enum
STATUS_UNSPECIFIED Status kondisi tidak ditentukan.
STATUS_UNKNOWN Kondisi tidak diketahui.
STATUS_TRUE Kondisinya benar.
STATUS_FALSE Kondisinya salah.

Jenis

Enumerasi jenis kondisi.

Enum
TYPE_UNSPECIFIED Jenis kondisi tidak ditentukan.
TYPE_READY Jenis kondisi sudah siap.
TYPE_SYNCHRONIZED Jenis kondisi disinkronkan.

Metode

create

Buat SaaS baru.

delete

Menghapus satu SaaS.

get

Mengambil satu SaaS.

list

Mengambil koleksi SaaS.

patch

Memperbarui satu SaaS.