Method: projects.locations.dataStores.patch

Memperbarui parameter satu DataStore.

dataStores.patch, dataStores.importDocuments, dan dataStores.purgeDocuments berjalan satu per satu per DataStore. Saat satu operasi berjalan, satu operasi lagi dapat menunggu; permintaan lebih lanjut akan gagal dengan ABORTED hingga operasi yang berjalan selesai.

Permintaan HTTP

PATCH https://vectorsearch.googleapis.com/v1beta/{dataStore.name}

Parameter jalur

Parameter
dataStore.name

string

ID. Nama resource yang sepenuhnya memenuhi syarat dari DataStore.

Format: projects/{project}/locations/{location}/dataStores/{dataStoreId}

Parameter kueri

Parameter
updateMask

string (FieldMask format)

Opsional. Masker kolom digunakan untuk menentukan kolom yang akan ditimpa di resource DataStore oleh update. Kolom yang ditentukan dalam updateMask bersifat relatif terhadap resource, bukan permintaan lengkap. Kolom akan ditimpa jika ada dalam mask. Jalur yang memberi nama pesan akan menggantikan seluruh pesan: subkolom yang dihilangkan dari permintaan akan dihapus dan, di bagian processingConfig, akan ditetapkan kembali ke defaultnya.

Jika pengguna tidak memberikan mask, setiap kolom yang ditetapkan permintaan ke nilai non-default akan ditimpa. Pesan yang dikirim kosong (misalnya layoutParsingConfig: {}) dan kolom yang ditetapkan ke nilai defaultnya (misalnya false) tidak diterapkan; beri nama di mask.

Kolom berikut mendukung pembaruan: displayName, description, labels, processingConfig, dan documentMetadataSchema. documentMetadataSchema harus diperbarui secara keseluruhan (jalur mask adalah documentMetadataSchema), dan hanya dengan menambahkan properti: properti yang ada tidak dapat dihapus atau diubah.

Jika * diberikan di updateMask, penggantian penuh akan dilakukan.

Ini adalah daftar dipisahkan koma yang berisi nama-nama kolom yang sepenuhnya valid. 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 hal tersebut 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 iya, 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 DataStore.

Isi respons

Jika berhasil, isi respons akan memuat instance Operation.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.