All Products
Search
Document Center

DataWorks:ListCrawlerRuns

Last Updated:Aug 08, 2026

Menanyakan catatan eksekusi crawler metadata tertentu secara berhalaman, dengan opsi penyaringan berdasarkan rentang waktu dan status eksekusi.

Deskripsi operasi

Skema Penggunaan

Menanyakan catatan eksekusi crawler metadata tertentu dalam 30 hari terakhir secara berhalaman, dengan opsi penyaringan berdasarkan waktu mulai eksekusi dan status.

Alur kerja yang direkomendasikan

  1. Panggil ListCrawlers untuk mendapatkan ID crawler.

  2. Panggil operasi ini untuk menanyakan catatan eksekusi dan ID instans node.

  3. Untuk operasi asinkron seperti menjalankan atau menghentikan, gunakan status akhir yang dikembalikan oleh operasi ini sebagai sumber kebenaran.

Persyaratan Edisi

Diperlukan DataWorks Edisi Dasar atau edisi yang lebih tinggi.

Perhatian

Jika rentang waktu tidak ditentukan, sistem secara default menanyakan catatan dari 30 hari terakhir.

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

1234

StartTimeFrom

integer

No

Batas bawah waktu mulai eksekusi, dalam stempel waktu UNIX tingkat milidetik. Nilainya harus berada dalam 30 hari terakhir. Jika tidak ditentukan, nilai default-nya adalah 30 hari sebelum waktu saat ini.

1710239005403

StartTimeTo

integer

No

Batas atas waktu mulai eksekusi, dalam stempel waktu UNIX tingkat milidetik. Nilainya harus berada dalam 30 hari terakhir. Jika tidak ditentukan, nilai default-nya adalah waktu saat ini.

1710325405403

Status

string

No

Status eksekusi. Nilai yang valid: WAITING, RUNNING, SUCCESS, ERROR, SHUTDOWN.

SUCCESS

PageNumber

integer

No

Nomor halaman. Halaman dimulai dari 1. Nilai default: 1.

1

PageSize

integer

No

Jumlah entri per halaman. Nilai default: 20. Nilai maksimum: 100.

20

StartTimeFrom dan StartTimeTo menggunakan stempel waktu UNIX tingkat milidetik. Keduanya harus berada dalam 30 hari terakhir, dan StartTimeFrom tidak boleh lebih besar daripada StartTimeTo.

Elemen respons

Element

Type

Description

Example

object

Parameter respons.

RequestId

string

ID permintaan. Digunakan untuk melacak log dan troubleshooting masalah.

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

Success

boolean

Menunjukkan apakah permintaan berhasil.

PagingInfo

object

Informasi paginasi.

TotalCount

integer

Jumlah total catatan yang memenuhi kondisi kueri.

1

PageNumber

integer

Nomor halaman saat ini.

1

PageSize

integer

Jumlah entri per halaman.

20

CrawlerRuns

array<object>

Daftar catatan eksekusi crawler metadata.

object

Satu catatan eksekusi crawler metadata.

Status

string

SUCCESS

TaskInstanceId

integer

1234

StartedTime

integer

1710239005403

FinishedTime

integer

1710239065403

Duration

number

60

TotalTableCount

integer

42

CrawlerRuns mengembalikan catatan eksekusi pada halaman saat ini. Anda dapat menggunakan TaskInstanceId untuk mengaitkan eksekusi tertentu.

Contoh

Respons sukses

JSONformat

{
  "RequestId": "9252F32F-D855-549E-8898-61CF5A733050",
  "Success": false,
  "PagingInfo": {
    "TotalCount": 1,
    "PageNumber": 1,
    "PageSize": 20,
    "CrawlerRuns": [
      {
        "Status": "SUCCESS",
        "TaskInstanceId": 1234,
        "StartedTime": 1710239005403,
        "FinishedTime": 1710239065403,
        "Duration": 60,
        "TotalTableCount": 42
      }
    ]
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.