Method: projects.locations.dataAgents.patch

Memperbarui parameter satu DataAgent.

Permintaan HTTP

PATCH https://geminidataanalytics.googleapis.com/v1alpha/{dataAgent.name=projects/*/locations/*/dataAgents/*}

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
dataAgent.name

string

Opsional. ID. Nama resource unik DataAgent. Format: projects/{project}/locations/{location}/dataAgents/{dataAgentId} {dataAgent} adalah ID resource dan harus 63 karakter atau kurang serta harus cocok dengan format yang dijelaskan di https://google.aip.dev/122#resource-id-segments

Contoh: projects/1234567890/locations/us-central1/dataAgents/my-agent.

Sebaiknya lewati setelan kolom ini selama pembuatan agen karena kolom ini akan disimpulkan secara otomatis dan diganti dengan {parent}/dataAgents/{dataAgentId}.

Parameter kueri

Parameter
updateMask

string (FieldMask format)

Opsional. Mask kolom digunakan untuk menentukan kolom yang akan diganti di resource DataAgent oleh pembaruan. Kolom yang ditentukan dalam updateMask bersifat relatif terhadap resource, bukan permintaan lengkap. Kolom akan ditimpa jika ada di mask. Jika pengguna tidak memberikan mask, semua kolom dengan nilai non-default yang ada dalam permintaan akan ditimpa. Jika mask karakter pengganti diberikan, semua kolom akan ditimpa.

Ini adalah comma-separated list berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".

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

Isi respons

Jika berhasil, isi respons akan berisi instance Operation.

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

  • geminidataanalytics.dataAgents.update

Untuk mengetahui informasi selengkapnya, lihat dokumentasi IAM.