Method: projects.locations.setDedicatedCrawlRate

Menetapkan kecepatan crawl khusus untuk crawlRateScope. Jika kecepatan crawl khusus tidak ditetapkan, tindakan ini akan memungkinkan bot crawl Vertex AI menggunakan kecepatan crawl khusus baru untuk crawling. Jika kecepatan crawl khusus ditetapkan, bot crawl Vertex AI akan mencoba memperbarui kecepatan ke nilai baru. Jika nilai baru terlalu tinggi, bot crawl mungkin melakukan crawling dengan kecepatan yang lebih rendah untuk menghindari kelebihan beban pada situs pengguna.

Permintaan HTTP

POST https://discoveryengine.googleapis.com/v1beta/{location=projects/*/locations/*}:setDedicatedCrawlRate

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
location

string

Wajib. Resource lokasi tempat pengelolaan kecepatan crawl akan dilakukan. Format: projects/{project}/locations/{location}

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "crawlRateScope": string,
  "crawlRate": integer,
  "crawlType": enum (CrawlType),
  "mode": enum (Mode)
}
Kolom
crawlRateScope

string

Wajib. Cakupan kecepatan crawl yang ingin dikonfigurasi pengguna. Saat ini, hanya nama domain dan host yang didukung. Contoh nama domain: example.com. Contoh nama host: www.example.com. Jangan sertakan / dalam nama domain atau host.
crawlRate

integer

Opsional. QPS crawl yang ditetapkan oleh pengguna. Tidak ada jaminan bahwa bot crawl Vertex akan melakukan crawling pada QPS ini. Jika kecepatan crawl terlalu tinggi, QPS sebenarnya mungkin lebih rendah dari nilai yang ditetapkan oleh pengguna untuk menghindari kelebihan beban pada situs pengguna.
crawlType

enum (CrawlType)

Opsional. Apakah kecepatan crawl yang dipicu pengguna atau pemuatan ulang otomatis.
mode

enum (Mode)

Opsional. Apakah kecepatan ditetapkan secara eksplisit oleh pengguna, atau ditetapkan oleh Vertex AI.

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/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

CrawlType

Jenis crawl digunakan untuk membedakan antara yang dipicu pengguna dan pemuatan ulang otomatis. Kecepatan crawl yang dipicu pengguna adalah untuk kasus penggunaan deterministik seperti crawling URL atau peta situs yang ditentukan oleh pengguna. Kecepatan crawl pemuatan ulang otomatis adalah untuk kasus penggunaan upaya terbaik seperti memuat ulang URL secara berkala.

Enum
CRAWL_TYPE_UNSPECIFIED Jenis crawl tidak ditentukan.
USER_TRIGGERED Jenis crawl dipicu pengguna.
AUTO_REFRESH Jenis crawl adalah pemuatan ulang otomatis.

Mode

Apakah kecepatan ditetapkan secara eksplisit oleh pengguna, atau ditetapkan oleh Vertex AI.

Enum
MODE_UNSPECIFIED Mode tidak ditentukan. Jika pengguna tidak menentukan mode, tetapkan ke AUTOMATIC secara default.
AUTOMATIC Vertex AI secara otomatis membagi crawlRate menjadi yang dipicu pengguna dan pemuatan ulang otomatis. Pengguna tidak perlu menentukan SetDedicatedCrawlRateRequest.CrawlType jika modenya adalah AUTOMATIC.
EXPLICIT Pengguna menetapkan kecepatan crawl yang dipicu pengguna atau pemuatan ulang otomatis secara eksplisit.