All Products
Search
Document Center

DataWorks:ListSemanticJobs

Last Updated:Jul 31, 2026

Mengkueri definisi node semantik penyewa saat ini dengan paginasi. Bidang Name, ProjectId, dan Source dalam item daftar dapat digunakan masing-masing untuk menjalankan/menghapus node, mengkueri detail eksekusi, dan memverifikasi cakupan (dalam OAuth) input.

Deskripsi operasi

Skenario

Mengkueri definisi node semantik yang disimpan dari penyewa saat ini dengan paginasi. Gunakan operasi ini untuk menampilkan daftar node, memilih node untuk dijalankan, atau mendapatkan ruang kerja tempat node berada.

Alur pemanggilan

  1. Gunakan PageNumber dan PageSize untuk membaca Data.SemanticJobs dengan paginasi.

  2. Gunakan bidang Name dari item daftar untuk memanggil RunSemanticJob, DeleteSemanticJob, atau ListSemanticJobRuns.

  3. Gunakan bidang ProjectId dari item daftar bersama dengan ExecutorJobId untuk memanggil operasi detail, log, dan penghentian.

Catatan

Operasi ini mengembalikan definisi node, bukan status eksekusi waktu nyata. Untuk mengkueri status eksekusi, panggil ListSemanticJobRuns.

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.

Parameter permintaan

Parameter

Type

Required

Description

Example

PageNumber

integer

No

Nomor halaman, dimulai dari 1. Jika parameter ini tidak ditentukan atau diatur ke nilai kurang dari atau sama dengan 0, halaman 1 akan dikembalikan.

1

PageSize

integer

No

Jumlah definisi pekerjaan per halaman. Jika parameter ini tidak ditentukan atau diatur ke nilai kurang dari atau sama dengan 0, nilai default 50 akan digunakan. Nilai maksimum: 200.

50

Susun parameter panggilan berdasarkan deskripsi setiap bidang permintaan.

Elemen respons

Element

Type

Description

Example

object

Tanggapan standar untuk kueri paginasi definisi node. Setiap item di Data.SemanticJobs adalah definisi node yang aktif untuk eksekusi atau kueri berikutnya.

RequestId

string

ID permintaan. Digunakan untuk melacak log dan memecahkan masalah.

676271D6-53B4-57BE-89FA-72F7AE1418DF

Success

boolean

Menunjukkan apakah permintaan berhasil.

Data

object

Hasil paginasi dari definisi pekerjaan. Gunakan bidang Name dari item daftar untuk menjalankan, menghapus, mengkueri catatan eksekusi, atau mengunduh hasil. Gunakan bidang ProjectId untuk mengkueri detail eksekusi, log, atau menghentikan eksekusi.

TotalCount

integer

Jumlah total definisi pekerjaan yang memenuhi kondisi dalam penyewa saat ini.

1

PageNumber

integer

Nomor halaman yang dikembalikan, dimulai dari 1.

1

PageSize

integer

Jumlah definisi pekerjaan per halaman yang dikembalikan.

50

SemanticJobs

array<object>

Daftar definisi pekerjaan.

array<object>

Definisi pekerjaan semantik yang disimpan. Bidang-bidang memiliki arti yang sama dengan yang ada di parameter Data dari CreateSemanticJob.

Id

integer

ID unik internal definisi tugas.

1

Name

string

Nama tugas. Digunakan untuk RunSemanticJob, DeleteSemanticJob, ListSemanticJobRuns, dan DownloadSemanticResults.

semantic-job-demo

UserId

string

ID pengguna pembuat tugas semantik.

user-demo

Creator

string

ID pengguna pembuat tugas semantik.

user-demo

ProjectId

integer

ID ruang kerja tempat tugas berada. Digunakan untuk GetSemanticJobDetail, GetSemanticJobLog, dan KillSemanticJob.

100

Type

string

Tipe sumber data Source.type yang disimpan dalam tugas.

maxcompute

Source

object

Konfigurasi sumber data input yang disimpan dalam node. Konfigurasi ini menentukan cakupan (dalam OAuth) analisis pada waktu proses.

ReferenceFileIds

array

Daftar ID file yang diunggah dan terkait dengan tugas.

string

Daftar opsional ID file referensi yang diunggah.

semantic-job-value

ReferenceFileUris

array

Daftar URI file referensi eksternal yang terkait dengan tugas.

string

Daftar opsional URI file referensi yang dapat diakses.

semantic-job-value

GmtCreate

integer

Waktu pembuatan, dinyatakan sebagai stempel waktu UNIX dalam milidetik.

1700000000000

GmtModified

integer

Waktu modifikasi terakhir, dinyatakan sebagai stempel waktu UNIX dalam milidetik.

1700000000000

ResourceGroupId

string

ID kelompok sumber daya yang digunakan untuk menjalankan tugas ini.

rg-demo

Lihat deskripsi bidang untuk memahami arti bidang tanggapan dan hubungannya dengan panggilan berikutnya.

Contoh

Respons sukses

JSONformat

{
  "RequestId": "676271D6-53B4-57BE-89FA-72F7AE1418DF",
  "Success": false,
  "Data": {
    "TotalCount": 1,
    "PageNumber": 1,
    "PageSize": 50,
    "SemanticJobs": [
      {
        "Id": 1,
        "Name": "semantic-job-demo",
        "UserId": "user-demo",
        "Creator": "user-demo",
        "ProjectId": 100,
        "Type": "maxcompute",
        "Source": {
          "test": "test",
          "test2": 1
        },
        "ReferenceFileIds": [
          "semantic-job-value"
        ],
        "ReferenceFileUris": [
          "semantic-job-value"
        ],
        "GmtCreate": 1700000000000,
        "GmtModified": 1700000000000,
        "ResourceGroupId": "rg-demo"
      }
    ]
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.