REST Resource: projects.locations.unitOperations

Resource: UnitOperation

UnitOperation merangkum maksud untuk mengubah/berinteraksi dengan komponen layanan yang diwakili oleh Unit tertentu. Beberapa UnitOperation dapat dibuat (diminta) dan dijadwalkan pada masa mendatang, tetapi hanya satu yang akan diizinkan untuk dieksekusi pada satu waktu (hal ini dapat berubah pada masa mendatang untuk operasi non-mutasi).

UnitOperation memungkinkan aktor yang berbeda berinteraksi dengan unit yang sama untuk berfokus hanya pada perubahan yang mereka minta.

Ini adalah objek dasar yang berisi kolom umum di semua operasi unit. Berikutnya: 22

Representasi JSON 
{
  "name": string,
  "unit": string,
  "parentUnitOperation": string,
  "rollout": string,
  "cancel": boolean,
  "state": enum (UnitOperationState),
  "conditions": [
    {
      object (UnitOperationCondition)
    }
  ],
  "schedule": {
    object (Schedule)
  },
  "engineState": string,
  "errorCategory": enum (UnitOperationErrorCategory),
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,

  // Union field unit_operation_type can be only one of the following:
  "provision": {
    object (Provision)
  },
  "upgrade": {
    object (Upgrade)
  },
  "deprovision": {
    object (Deprovision)
  }
  // End of list of possible types for union field unit_operation_type.
}
Kolom
name

string

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

"projects/{project}/locations/{location}/unitOperations/{unitOperation}"
unit

string

Wajib. Tidak dapat diubah. Unit yang akan dipengaruhi oleh UnitOperation tertentu.
parentUnitOperation

string

Opsional. Referensi ke resource induk: UnitOperation. Jika operasi perlu membuat operasi lain sebagai bagian dari alur kerjanya, setiap operasi turunan harus menyetel kolom ini ke induk. Ini dapat digunakan untuk pelacakan. (Opsional)
rollout

string

Opsional. Menentukan peluncuran mana yang membuat Operasi Unit ini. Nilai ini tidak dapat diubah dan hanya digunakan untuk tujuan pemfilteran. Jika unit dependen dan operasi unit dibuat sebagai bagian dari operasi unit lain, keduanya akan menggunakan rolloutId yang sama.
cancel

boolean

Opsional. Jika benar (true), coba batalkan operasi. Pembatalan dapat gagal jika operasi sudah dijalankan. (Opsional)
state

enum (UnitOperationState)

Opsional. Hanya output. UnitOperationState menjelaskan status operasi unit saat ini.
conditions[]

object (UnitOperationCondition)

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

object (Schedule)

Opsional. Kapan menjadwalkan operasi ini.
engineState

string

Opsional. Hanya output. Status mesin untuk operasi mesin deployment yang sedang berlangsung. Kolom ini tidak transparan untuk penggunaan eksternal.
errorCategory

enum (UnitOperationErrorCategory)

Opsional. Hanya output. UnitOperationErrorCategory menjelaskan kategori error.
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 resource berhasil dibuat 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".
deleteTime

string (Timestamp format)

Hanya output. Stempel waktu saat resource ditandai untuk dihapus (penghapusan adalah operasi asinkron).

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

Kolom union unit_operation_type.

unit_operation_type hanya dapat berupa salah satu dari hal berikut:
provision

object (Provision)
upgrade

object (Upgrade)
deprovision

object (Deprovision)

Penyediaan

Penyediaan adalah operasi unit yang menyediakan resource pokok yang diwakili oleh Unit. Hanya dapat dijalankan jika Unit saat ini tidak disediakan.

Representasi JSON 
{
  "release": string,
  "inputVariables": [
    {
      object (UnitVariable)
    }
  ]
}
Kolom
release

string

Opsional. Referensi ke objek Rilis yang akan digunakan untuk Unit. (opsional).
inputVariables[]

object (UnitVariable)

Opsional. Kumpulan variabel input. Maksimum 100. (opsional)

Upgrade

Upgrade adalah operasi unit yang mengupgrade unit yang disediakan, yang juga dapat mencakup resource pokok yang diwakili oleh Unit. Hanya dapat dieksekusi jika Unit saat ini disediakan.

Representasi JSON 
{
  "release": string,
  "inputVariables": [
    {
      object (UnitVariable)
    }
  ]
}
Kolom
release

string

Opsional. Referensi ke objek Rilis yang akan digunakan untuk Unit. (opsional).
inputVariables[]

object (UnitVariable)

Opsional. Kumpulan variabel input. Maksimum 100. (opsional)

Cabut akses

Jenis ini tidak memiliki kolom.

De-penyediaan adalah operasi unit yang membatalkan penyediaan resource pokok yang diwakili oleh Unit. Hanya dapat dieksekusi jika Unit saat ini disediakan.

UnitOperationState

UnitOperationState menjelaskan status operasi unit saat ini.

Enum
UNIT_OPERATION_STATE_UNKNOWN
UNIT_OPERATION_STATE_PENDING Operasi unit diterima, tetapi belum siap dijalankan.
UNIT_OPERATION_STATE_SCHEDULED Operasi unit diterima dan dijadwalkan.
UNIT_OPERATION_STATE_RUNNING Operasi unit sedang berjalan.
UNIT_OPERATION_STATE_SUCCEEDED Operasi unit telah berhasil diselesaikan.
UNIT_OPERATION_STATE_FAILED Operasi unit gagal.
UNIT_OPERATION_STATE_CANCELLED Operasi unit dibatalkan.

UnitOperationCondition

UnitOperationCondition menjelaskan status Operasi Unit. UnitOperationCondition adalah komponen individual yang berkontribusi pada status keseluruhan.

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_SCHEDULED Jenis kondisi dijadwalkan.
TYPE_RUNNING Jenis kondisi sedang berjalan.
TYPE_SUCCEEDED Jenis kondisi berhasil.
TYPE_CANCELLED Jenis kondisi dibatalkan.
TYPE_APP_CREATED Menunjukkan apakah aplikasi AppHub telah dibuat.
TYPE_APP_COMPONENTS_REGISTERED Menunjukkan apakah layanan dan beban kerja telah didaftarkan dengan AppHub.

Jadwal

Spesifikasi waktu untuk menjadwalkan pemeliharaan.

Representasi JSON 
{
  "startTime": string
}
Kolom
startTime

string (Timestamp format)

Opsional. Awal operasi. Jika tidak disetel, akan disetel ke awal jendela berikutnya. (opsional)

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

UnitOperationErrorCategory

UnitOperationErrorCategory menjelaskan kategori error operasi unit.

Enum
UNIT_OPERATION_ERROR_CATEGORY_UNSPECIFIED Kategori error operasi unit tidak ditentukan
NOT_APPLICABLE Kategori error operasi unit tidak berlaku, atau bukan merupakan error
FATAL Kategori error operasi unit bersifat fatal
RETRIABLE Kategori error operasi unit dapat dicoba lagi
IGNORABLE Kategori error operasi unit dapat diabaikan
STANDARD Kategori error operasi unit adalah standar, dihitung dalam anggaran error Peluncuran

Metode

create

 Buat operasi unit baru.

delete

 Menghapus operasi unit tunggal.

get

 Mengambil satu operasi unit.

list

 Mengambil kumpulan operasi unit.

patch

 Memperbarui operasi unit tunggal.