Method: projects.locations.investigations.create

Membuat Investigasi baru di project dan lokasi tertentu.

Permintaan HTTP

POST https://geminicloudassist.googleapis.com/v1alpha/{parent=projects/*/locations/*}/investigations

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Nilai untuk induk.

Parameter kueri

Parameter
investigationId

string

Opsional. ID yang akan digunakan untuk penyelidikan, yang akan menjadi komponen akhir dari nama resource penyelidikan.

Nilai ini harus terdiri dari 4-63 karakter, dan karakter yang valid adalah /[a-z][0-9]-/.

Jika tidak diberikan, server akan membuat ID unik untuk penyelidikan.

requestId

string

Opsional. ID permintaan opsional untuk mengidentifikasi permintaan. Tentukan ID permintaan unik sehingga jika Anda harus mencoba lagi permintaan, server akan tahu untuk mengabaikan permintaan jika sudah selesai. Server akan menjamin bahwa setidaknya selama 60 menit sejak 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 telah diterima, dan jika ya, akan mengabaikan permintaan kedua. Tindakan ini mencegah klien membuat komitmen duplikat secara tidak sengaja.

ID permintaan harus berupa UUID yang valid, kecuali UUID nol tidak didukung (00000000-0000-0000-0000-000000000000).

Isi permintaan

Isi permintaan memuat instance Investigation.

Isi respons

Jika berhasil, isi respons memuat instance Investigation yang baru dibuat.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

Izin IAM

Memerlukan izin IAM berikut pada resource parent:

  • geminicloudassist.investigations.create

Untuk mengetahui informasi selengkapnya, lihat dokumentasi IAM.