Method: projects.locations.targets.create

Membuat Target baru di project dan lokasi tertentu.

Permintaan HTTP

POST https://clouddeploy.googleapis.com/v1/{parent=projects/*/locations/*}/targets

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Koleksi induk tempat Target harus dibuat. Format harus projects/{projectId}/locations/{location_name}.

Parameter kueri

Parameter
targetId

string

Wajib. ID Target.

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

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 memuat instance Operation yang baru dibuat.

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 parent:

  • clouddeploy.targets.create

Untuk informasi lebih lanjut, lihat dokumentasi IAM.