All Products
Search
Document Center

DataWorks:UpdateCrawler

Last Updated:Aug 08, 2026

Memperbarui kelompok sumber daya, cakupan pengumpulan, penjadwalan, dan konfigurasi ekstensi dari crawler metadata tertentu.

Deskripsi operasi

Skema Penggunaan

Memperbarui sebagian kelompok sumber daya, cakupan pengumpulan, penjadwalan, deskripsi metadata AI, atau konfigurasi ekstensi dari crawler metadata tertentu.

Alur kerja yang direkomendasikan

  1. Panggil GetCrawler untuk mengkueri konfigurasi saat ini.

  2. Panggil GetCrawlerTypeCapabilities untuk memeriksa kemampuan konfigurasi yang didukung oleh tipe crawler tersebut.

  3. Panggil operasi ini hanya dengan bidang-bidang yang ingin Anda perbarui.

Persyaratan Edisi

Diperlukan DataWorks Basic Edition atau edisi yang lebih advanced.

Perhatian

Setidaknya satu bidang yang dapat diperbarui harus disediakan. Bidang yang tidak disediakan tetap tidak berubah.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Sintaks permintaan

POST  HTTP/1.1

Parameter permintaan

Parameter

Type

Required

Description

Example

Id

integer

Yes

ID crawler metadata. Anda dapat memanggil ListCrawlers untuk mengkueri ID crawler.

1234

ResourceGroupId

string

No

ID kelompok sumber daya Serverless 2.0 yang digunakan untuk menjalankan task pengumpulan. Apakah parameter ini didukung dan apakah wajib tergantung pada kemampuan yang dikembalikan oleh GetCrawlerTypeCapabilities. Jika parameter ini tidak ditentukan, nilai yang ada tetap tidak berubah.

Serverless_res_group_1234567890123456_1234567890

Scope

object

No

Konfigurasi cakupan pengumpulan. Jika parameter ini ditentukan, cakupan pengumpulan diperbarui. Jika parameter ini tidak ditentukan, nilai yang ada tetap tidak berubah.

Unit

string

Yes

Granularitas cakupan pengumpulan. Nilai yang valid ditentukan oleh SupportedScopeUnits yang dikembalikan oleh GetCrawlerTypeCapabilities.

DATABASE

Items

array

No

Daftar nama database. Parameter ini hanya didukung ketika Unit diatur ke DATABASE. Maksimal 1.000 entri diperbolehkan. Nama tidak boleh kosong atau duplikat.

string

No

Satu nama database. Panjang nama maksimal 256 karakter.

example_database

ExcludeRegex

string

No

Ekspresi reguler yang digunakan untuk mengecualikan objek dari cakupan pengumpulan. Parameter ini hanya didukung ketika SupportExcludeRegex yang dikembalikan oleh GetCrawlerTypeCapabilities diatur ke true.

^tmp_.*

ScheduleConfig

object

No

Konfigurasi penjadwalan. Jika parameter ini ditentukan, metode penjadwalan diperbarui. Jika parameter ini tidak ditentukan, nilai yang ada tetap tidak berubah.

Type

string

Yes

Tipe penjadwalan. MANUAL menunjukkan eksekusi manual. NORMAL menunjukkan penjadwalan periodik. Sumber data di lingkungan development hanya mendukung MANUAL. Ketersediaan NORMAL tergantung pada nilai SupportSchedule yang dikembalikan oleh GetCrawlerTypeCapabilities.

NORMAL

CronExpress

string

No

Ekspresi cron enam bidang untuk penjadwalan periodik. Parameter ini wajib ketika Type diatur ke NORMAL. Bidang detik harus bernilai 0, dan frekuensi penjadwalan tidak boleh melebihi sekali per jam.

0 0 2 ? * *

EnableAiComment

boolean

No

Menentukan apakah deskripsi metadata AI diaktifkan. Parameter ini hanya didukung ketika SupportAiComment yang dikembalikan oleh GetCrawlerTypeCapabilities diatur ke true. Jika parameter ini tidak ditentukan, nilai yang ada tetap tidak berubah.

Options

object

No

Konfigurasi ekstensi untuk tipe crawler. Hanya item konfigurasi yang ditentukan yang diperbarui. Item konfigurasi yang tidak ditentukan tetap tidak berubah. Kunci dan nilai yang didukung ditentukan oleh SupportedOptionKeys yang dikembalikan oleh GetCrawlerTypeCapabilities.

string

No

Nilai dari satu item konfigurasi ekstensi crawler. Item konfigurasi yang didukung, tipe nilai, dan rentang nilai ditentukan oleh SupportedOptionKeys yang dikembalikan oleh GetCrawlerTypeCapabilities.

v1

Setidaknya salah satu parameter berikut harus disediakan: ResourceGroupId, Scope, ScheduleConfig, EnableAiComment, atau Options. Bidang yang tidak disediakan tetap tidak berubah.

Elemen respons

Element

Type

Description

Example

object

Tanggapan.

RequestId

string

ID permintaan. Anda dapat menggunakan ID ini untuk mencari log dan memecahkan masalah.

9252F32F-D855-549E-8898-61CF5A733050

Success

boolean

Menunjukkan apakah permintaan berhasil.

Id

integer

ID crawler metadata yang diperbarui.

1234

Id adalah ID crawler metadata yang diperbarui.

Contoh

Respons sukses

JSONformat

{
  "RequestId": "9252F32F-D855-549E-8898-61CF5A733050",
  "Success": false,
  "Id": 1234
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.