All Products
Search
Document Center

DataWorks:RunCrawler

Last Updated:Aug 08, 2026

Memicu crawler metadata tertentu untuk dijalankan dan mengembalikan status pengiriman serta informasi instans task terkait.

Deskripsi operasi

Skenario

Mengirim permintaan eksekusi untuk crawler metadata tertentu.

Proses yang Direkomendasikan

  1. Panggil ListCrawlers untuk menanyakan ID crawler yang tersedia.

  2. Panggil operasi ini untuk mengirim permintaan eksekusi.

  3. Panggil ListCrawlerRuns untuk menanyakan status eksekusi akhir.

Persyaratan Edisi

Diperlukan DataWorks Basic Edition atau yang lebih tinggi.

Deskripsi Penagihan

Menjalankan task pengumpulan akan mengonsumsi resource komputasi dan dapat dikenai biaya. Biaya aktual bergantung pada kelompok sumber daya yang digunakan dan aturan penagihan DataWorks.

Jika crawler memiliki fitur deskripsi metadata AI yang diaktifkan (EnableAiComment=true), pengumpulan metadata dan pembuatan deskripsi AI akan mengonsumsi token. Untuk informasi tentang kuota token gratis dan aturan penagihan setelah kuota habis, lihat penagihan Data Agent.

Perhatian

Tanggapan sukses hanya menunjukkan bahwa permintaan eksekusi telah diterima, bukan bahwa task pengumpulan telah selesai.

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 menanyakan ID tersebut.

1234

Anda dapat memanggil ListCrawlers untuk menanyakan parameter Id.

Elemen respons

Element

Type

Description

Example

object

Tanggapan.

RequestId

string

ID permintaan. Digunakan untuk melacak log dan troubleshooting masalah.

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

Success

boolean

Menunjukkan apakah permintaan berhasil.

Id

integer

ID crawler metadata.

1234

RunAccepted

boolean

Menunjukkan apakah permintaan eksekusi diterima. Nilai true berarti permintaan diterima, tetapi tidak berarti task pengumpulan telah selesai.

RunStatus

string

Status eksekusi awal setelah pengiriman. Nilainya adalah WAITING ketika permintaan eksekusi berhasil diterima. Untuk menanyakan status akhir, panggil ListCrawlerRuns.

WAITING

TaskInstanceId

integer

ID instans task DataWorks terkait. Bidang ini mungkin kosong. Untuk menanyakan catatan eksekusi akhir, panggil ListCrawlerRuns.

1234

RunAccepted menunjukkan apakah permintaan eksekusi diterima. Panggil ListCrawlerRuns untuk menanyakan status akhir. TaskInstanceId mungkin kosong.

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.