Method: projects.locations.targets.patch

Memperbarui parameter satu Target.

Permintaan HTTP

PATCH https://clouddeploy.googleapis.com/v1/{target.name=projects/*/locations/*/targets/*}

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
target.name

string

Opsional. Nama Target. Formatnya adalah projects/{project}/locations/{location}/targets/{target}. Komponen target harus cocok dengan [a-z]([a-z0-9-]{0,61}[a-z0-9])?

Parameter kueri

Parameter
updateMask

string (FieldMask format)

Wajib. Mask kolom digunakan untuk menentukan kolom yang akan ditimpa di resource Target oleh update. Kolom yang ditentukan dalam updateMask relatif terhadap resource, bukan permintaan lengkap. Kolom akan ditimpa jika berada dalam mask. Jika pengguna tidak menyediakan mask, semua kolom akan ditimpa.

Ini adalah daftar yang dipisahkan koma yang berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".
requestId

string

Opsional. ID permintaan untuk mengidentifikasi permintaan. Tetapkan ID permintaan unik sehingga jika Anda harus mencoba lagi permintaan, server akan mengabaikan permintaan tersebut jika sudah diselesaikan. Server menjamin bahwa setidaknya 60 menit setelah permintaan pertama.

Misalnya, pertimbangkan situasi saat Anda membuat permintaan awal dan waktu permintaan habis. Jika Anda membuat permintaan lagi dengan ID permintaan yang sama, server dapat memeriksa apakah operasi asli dengan ID permintaan yang sama diterima, dan jika demikian, akan mengabaikan permintaan kedua. Langkah ini mencegah klien membuat komitmen duplikat secara tidak sengaja.

ID permintaan harus berupa UUID yang valid dengan pengecualian bahwa nol UUID tidak didukung (00000000-0000-0000-0000-000000000000).
allowMissing

boolean

Opsional. Jika disetel ke benar (true), memperbarui Target yang tidak ada akan menyebabkan pembuatan Target baru.
validateOnly

boolean

Opsional. Jika disetel ke benar (true), permintaan divalidasi dan pengguna akan diberikan hasil yang diharapkan, tetapi tidak ada perubahan aktual yang dibuat.

Isi permintaan

Isi permintaan memuat instance Target.

Isi respons

Jika berhasil, isi respons akan berisi instance Operation.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform

Untuk informasi selengkapnya, lihat Ringkasan Autentikasi.

Izin IAM

Memerlukan izin IAM berikut pada resource name:

  • clouddeploy.targets.update

Untuk informasi lebih lanjut, lihat dokumentasi IAM.