Deployments: patch

Melakukan patch pada deployment dan semua resource yang dijelaskan oleh manifes deployment. Metode ini mendukung semantik patch. Coba sekarang.

Permintaan

Permintaan HTTP

PATCH https://www.googleapis.com/deploymentmanager/v2/projects/project/global/deployments/deployment

Parameter

Nama parameter Nilai Deskripsi
Parameter jalur
deployment string Nama deployment untuk permintaan ini.
project string Project ID untuk permintaan ini
Parameter kueri opsional
createPolicy string Menetapkan kebijakan yang akan digunakan untuk membuat resource baru.

Nilai yang dapat diterima adalah:
  • "ACQUIRE": Memperoleh resource yang ada. Jika resource tidak ada, deployment akan gagal.
  • "CREATE_OR_ACQUIRE": Dapatkan resource jika ada, buat resource jika tidak ada. (default)
deletePolicy string Menetapkan kebijakan yang akan digunakan untuk menghapus resource.

Nilai yang dapat diterima adalah:
  • "ABANDON": Menghapus resource dari Deployment Manager, tetapi tidak menghapus resource yang mendasarinya.
  • "DELETE": Menghapus resource dari Pengelola Deployment dan menghapus resource yang mendasarinya. (default)
preview boolean Jika ditetapkan ke true, akan memperbarui deployment serta membuat dan memperbarui resource "shell", tetapi tidak benar-benar mengubah atau membuat instance resource ini. Hal ini memungkinkan Anda melihat pratinjau tampilan deployment. Anda dapat menggunakan intent ini untuk melihat pratinjau pengaruh update terhadap deployment Anda. Anda harus memberikan target.config dengan konfigurasi jika ditetapkan ke true. Setelah melihat pratinjau deployment, Anda dapat men-deploy resource dengan membuat permintaan dengan update() atau Anda dapat cancelPreview() untuk menghapus pratinjau sepenuhnya. Perhatikan bahwa deployment akan tetap ada setelah Anda membatalkan pratinjau dan Anda harus menghapus deployment ini secara terpisah jika ingin menghapusnya. (Default: false)

Isi permintaan

Dalam isi permintaan, berikan bagian yang relevan dari resource Deployments, sesuai dengan aturan semantik patch.

Respons

Jika berhasil, metode ini akan menampilkan isi respons dengan struktur berikut:

{
  "kind": "deploymentmanager#operation",
  "id": unsigned long,
  "creationTimestamp": string,
  "name": string,
  "zone": string,
  "clientOperationId": string,
  "operationType": string,
  "targetLink": string,
  "targetId": unsigned long,
  "status": string,
  "statusMessage": string,
  "user": string,
  "progress": integer,
  "insertTime": string,
  "startTime": string,
  "endTime": string,
  "error": {
    "errors": [
      {
        "code": string,
        "location": string,
        "message": string
      }
    ]
  },
  "warnings": [
    {
      "code": string,
      "message": string,
      "data": [
        {
          "key": string,
          "value": string
        }
      ]
    }
  ],
  "httpErrorStatusCode": integer,
  "httpErrorMessage": string,
  "selfLink": string,
  "region": string,
  "description": string
}
Nama properti Nilai Deskripsi Catatan
kind string [Output Only] Jenis resource. Selalu compute#operation untuk resource Operasi.
id unsigned long [Output Only] ID unik untuk resource. ID ini ditentukan oleh server.
creationTimestamp string [Tidak digunakan lagi] Kolom ini tidak digunakan lagi.
name string [Output Only] Nama resource.
zone string [Output Only] URL zona tempat operasi berada. Hanya tersedia saat melakukan operasi per zona. Anda harus menentukan kolom ini sebagai bagian dari URL permintaan HTTP. Kolom ini tidak dapat ditetapkan sebagai kolom dalam isi permintaan.
clientOperationId string [Khusus Output] Nilai `requestId` jika Anda memberikannya dalam permintaan. Tidak ada jika sebaliknya.
operationType string [Output Only] Jenis operasi, seperti insert, update, atau delete, dan sebagainya.
targetId unsigned long [Output Only] ID target unik, yang mengidentifikasi inkarnasi tertentu dari resource target.
status string [Output Only] Status operasi, yang dapat berupa salah satu dari berikut: PENDING, RUNNING, atau DONE.
statusMessage string [Output Only] Deskripsi tekstual opsional tentang status operasi saat ini.
user string [Output Only] Pengguna yang meminta operasi, misalnya: user@example.com.
progress integer [Output Only] Indikator progres opsional yang berkisar antara 0 hingga 100. Tidak ada persyaratan bahwa hal ini harus bersifat linear atau mendukung tingkat perincian operasi apa pun. Ini tidak boleh digunakan untuk menebak kapan operasi akan selesai. Jumlah ini akan meningkat secara monoton seiring operasi berlangsung.
insertTime string [Output Only] Waktu operasi ini diminta. Nilai ini dalam format teks RFC3339.
startTime string [Output Only] Waktu operasi ini dimulai oleh server. Nilai ini dalam format teks RFC3339.
endTime string [Output Only] Waktu operasi ini selesai. Nilai ini dalam format teks RFC3339.
error object [Output Only] Jika error terjadi selama pemrosesan operasi, kolom ini akan diisi.
error.errors[] list [Output Only] Array error yang ditemukan saat memproses operasi ini.
error.errors[].code string [Output Only] ID jenis error untuk error ini.
error.errors[].location string [Output Only] Menunjukkan kolom dalam permintaan yang menyebabkan error. Properti ini bersifat opsional.
error.errors[].message string [Output Only] Pesan error opsional yang dapat dibaca manusia.
warnings[] list [Output Only] Jika pesan peringatan dihasilkan selama pemrosesan operasi, kolom ini akan diisi.
warnings[].code string [Output Only] Kode peringatan, jika ada. Misalnya, Compute Engine menampilkan NO_RESULTS_ON_PAGE jika tidak ada hasil dalam respons.
warnings[].message string [Output Only] Deskripsi kode peringatan yang dapat dibaca manusia.
warnings[].data[] list [Output Only] Metadata tentang peringatan ini dalam format key: value. Contoh: 
"data": [ { "key": "scope", "value": "zones/us-east1-d" }
warnings[].data[].key string [Khusus Output] Kunci yang memberikan detail selengkapnya tentang peringatan yang ditampilkan. Misalnya, untuk peringatan saat tidak ada hasil dalam permintaan daftar untuk zona tertentu, kunci ini mungkin scope dan nilai kuncinya mungkin nama zona. Contoh lainnya mungkin berupa kunci yang menunjukkan resource yang tidak digunakan lagi dan penggantian yang disarankan, atau peringatan tentang setelan jaringan yang tidak valid (misalnya, jika instance mencoba melakukan penerusan IP, tetapi tidak diaktifkan untuk penerusan IP).
warnings[].data[].value string [Khusus Output] Nilai data peringatan yang sesuai dengan kunci.
httpErrorStatusCode integer [Output Only] Jika operasi gagal, kolom ini berisi kode status error HTTP yang ditampilkan. Misalnya, 404 berarti resource tidak ditemukan.
httpErrorMessage string [Output Only] Jika operasi gagal, kolom ini berisi pesan error HTTP yang ditampilkan, seperti NOT FOUND.
region string [Output Only] URL region tempat operasi berada. Hanya tersedia saat melakukan operasi regional. Anda harus menentukan kolom ini sebagai bagian dari URL permintaan HTTP. Kolom ini tidak dapat ditetapkan sebagai kolom dalam isi permintaan.
description string [Output Only] Deskripsi tekstual operasi, yang ditetapkan saat operasi dibuat.

Cobalah!

Gunakan API Explorer di bawah untuk memanggil metode ini pada data langsung dan melihat responsnya. Atau, coba Explorer mandiri.