All Products
Search

This Product

    DataWorks:CreateWorkflowInstances

    Document Center

    DataWorks:CreateWorkflowInstances

    Last Updated:Aug 21, 2026

    Membuat instans alur kerja berdasarkan konfigurasi, seperti instans alur kerja pengisian ulang data.

    Deskripsi operasi

    Diperlukan DataWorks Edisi Dasar atau edisi yang lebih tinggi.

    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

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    dataworks:CreateWorkflowInstances

    create

    *Semua Sumber daya.

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ProjectId

    integer

    Yes

    ID proyek.

    100
    EnvType

    string

    No

    Lingkungan proyek. Nilai valid:

    Valid values:

    • Prod :

      Produksi.

    • Dev :

      Pengembangan.

    Prod
    WorkflowId

    integer

    Yes

    ID alur kerja tempat instans berada. WorkflowId untuk node periode adalah 1.

    1
    Name

    string

    Yes

    Nama.

    WorkflowInstance1
    Periods

    object

    No

    Pengaturan periode pengisian ulang data.

    BizDates

    array<object>

    Yes

    Daftar tanggal bisnis. Anda dapat menentukan hingga 7 rentang tanggal bisnis.

    object

    No

    StartBizDate

    string

    Yes

    Tanggal bisnis mulai. Format: yyyy-mm-dd.

    2024-11-20
    EndBizDate

    string

    Yes

    Tanggal bisnis akhir. Format: yyyy-mm-dd.

    2024-11-24
    StartTime

    string

    No

    Waktu mulai periode. Format: hh:mm:ss dalam format 24 jam. Nilai default: 00:00:00.

    00:00:00
    EndTime

    string

    No

    Waktu akhir periode. Format: hh:mm:ss dalam format 24 jam. Nilai default: 23:59:59.

    23:59:59
    Type

    string

    Yes

    Tipe instans alur kerja. Nilai valid:

    Valid values:

    • SmokeTest :

      Uji coba. Hanya RootTaskIds yang diperlukan, yang menentukan daftar node uji yang akan dijalankan.

    • TriggerWorkflow :

      Alur kerja berbasis pemicu. Atur WorkflowId ke ID alur kerja berbasis pemicu. IncludeTaskIds bersifat opsional. Jika Anda tidak menentukan IncludeTaskIds, seluruh alur kerja akan dijalankan.

    • Manual :

      Node manual. Hanya RootTaskIds yang diperlukan, yang menentukan daftar node manual yang akan dijalankan.

    • SupplementData :

      Pengisian ulang data. Metode untuk menentukan RootTaskIds dan IncludeTaskIds bervariasi berdasarkan pola pengisian ulang data. Untuk informasi selengkapnya, lihat deskripsi parameter DefaultRunProperties.Mode.

    • ManualWorkflow :

      Alur kerja manual. Atur WorkflowId ke ID alur kerja manual. RootTaskIds bersifat opsional. Jika Anda tidak menentukan RootTaskIds, daftar node root default dari alur kerja manual akan digunakan.

    SupplementData
    WorkflowParameters

    string

    No

    Parameter alur kerja. Parameter ini berlaku ketika alur kerja unik ditentukan (WorkflowId != 1). Untuk alur kerja periode dan alur kerja berbasis pemicu, formatnya adalah kunci=nilai, dan prioritasnya lebih rendah daripada parameter node. Untuk alur kerja manual, formatnya adalah JSON, dan prioritasnya lebih tinggi daripada parameter node.

    Format "kunci=nilai":
    TaskParameters

    string

    No

    Parameter node yang digunakan untuk mengatur parameter untuk node tertentu. Nilainya dalam format JSON. Kuncinya adalah ID node, dan format nilai mengacu pada parameter skrip node (bidang Task.Script.Parameter dalam tanggapan GetTask).

    {
    AutoStartEnabled

    boolean

    No

    Apakah akan menjalankan instans alur kerja segera setelah pembuatan. Nilai default: true.

    true
    DefaultRunProperties

    object

    No

    Konfigurasi waktu proses.

    RootTaskIds

    array

    No

    Daftar ID node root.

    integer

    No

    ID node.

    1234
    IncludeTaskIds

    array

    No

    Daftar ID node yang akan dijalankan.

    integer

    No

    ID node.

    1234
    ExcludeTaskIds

    array

    No

    Daftar ID node yang dikecualikan dari Berjalan.

    integer

    No

    ID node.

    4321
    IncludeProjectIds

    array

    No

    Daftar ID proyek yang akan disertakan.

    integer

    No

    ID proyek.

    100
    ExcludeProjectIds

    array

    No

    Daftar ID proyek yang akan dikecualikan.

    integer

    No

    ID proyek.

    200
    Mode

    string

    No

    Mode pengisian ulang data. Nilai default: ManualSelection. Parameter ini diperlukan ketika Type diatur ke SupplementData. Nilai valid:

    ManualSelection
    Analysis

    object

    No

    Konfigurasi analisis. Parameter ini diperlukan ketika Type diatur ke SupplementData.

    Enabled

    boolean

    No

    Apakah akan mengaktifkan analisis. Parameter ini diperlukan ketika Type diatur ke SupplementData.

    true
    Blocked

    boolean

    No

    Apakah akan memblokir Berjalan ketika analisis tidak lulus. Parameter ini diperlukan ketika Type diatur ke SupplementData.

    true
    RunPolicy

    object

    No

    Kebijakan eksekusi. Jika bidang ini kosong, konfigurasi node akan digunakan.

    StartTime

    string

    No

    Waktu mulai eksekusi. Format: hh:mm:ss dalam format 24 jam. Bidang ini diperlukan jika Anda mengatur kebijakan eksekusi.

    00:00:00
    EndTime

    string

    No

    Waktu akhir eksekusi. Format: hh:mm:ss dalam format 24 jam. Bidang ini diperlukan jika Anda mengatur kebijakan eksekusi.

    23:59:59
    Type

    string

    No

    Tipe periode. Bidang ini diperlukan jika Anda mengatur kebijakan eksekusi. Nilai valid:

    Valid values:

    • Daily :

      setiap hari.

    • Weekend :

      hanya akhir pekan.

    Daily
    Immediately

    boolean

    No

    Apakah instans dapat mulai Berjalan segera jika waktu eksekusi ada di masa depan. Nilai default: false.

    false
    Alert

    object

    No

    Konfigurasi peringatan.

    Type

    string

    No

    Kebijakan peringatan. Nilai valid:

    Valid values:

    • SuccessFailure :

      peringatan saat berhasil dan gagal.

    • Failure :

      peringatan saat gagal.

    • Success :

      peringatan saat berhasil.

    Succes
    NoticeType

    string

    No

    Metode notifikasi. Nilai valid:

    Valid values:

    • Mail :

      hanya email.

    • Sms :

      hanya SMS.

    • SmsMail :

      SMS dan email.

    Sms
    Parallelism

    integer

    No

    Jumlah node paralel. Nilai dari 2 hingga 10 menentukan paralelisme. Nilai 1 menentukan eksekusi serial. Parameter ini diperlukan ketika Type diatur ke SupplementData.

    2
    Order

    string

    No

    Urutan Pesanan. Nilai default: Asc. Nilai valid:

    Valid values:

    • Asc :

      urutan naik berdasarkan tanggal bisnis.

    • Desc :

      urutan turun berdasarkan tanggal bisnis.

    Asc
    RuntimeResource

    string

    No

    Pengidentifikasi kelompok sumber daya penjadwalan kustom. Jika bidang ini kosong, konfigurasi node akan digunakan.

    S_res_group_524258031846018_1684XXXXXXXXX
    Priority

    integer

    No

    Prioritas eksekusi. Nilai valid: 1 hingga 11. Nilai yang lebih besar menunjukkan prioritas yang lebih tinggi. Pengaturan parameter ini hanya mendukung alur kerja manual dan alur kerja berbasis pemicu.

    1
    PriorityWeightStrategy

    string

    No

    Kebijakan bobot prioritas. Pengaturan parameter ini hanya mendukung alur kerja manual dan alur kerja berbasis pemicu. Nilai valid:

    Upstream
    Comment

    string

    No

    Alasan membuat instans alur kerja.

    create for test
    Tags

    array<object>

    No

    Daftar label node.

    object

    No

    Value

    string

    No

    Nilai label.

    tagValue
    Key

    string

    No

    Kunci label.

    tagKey
    TagCreationPolicy

    string

    No

    Kebijakan pembuatan tag. Nilai valid:

    Valid values:

    • Overwrite :

      mode timpa. Tag existing dari alur kerja manual tidak diwarisi. Tag dibuat langsung.

    • Append :

      mode tambah. Tag baru ditambahkan ke tag existing yang diwarisi dari alur kerja manual.

    Append

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan, yang digunakan untuk melacak log dan memecahkan masalah.

    22C97E95-F023-56B5-8852-B1A77A17XXXX
    OperationId

    string

    ID operasi. Anda dapat menggunakan nilai ini untuk memanggil operasi GetCreateWorkflowInstancesResult guna mengkueri hasil operasi pembuatan.

    e15ad21c-b0e9-4792-8f55-b037xxxxxxxx

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "22C97E95-F023-56B5-8852-B1A77A17XXXX",
  "OperationId": "e15ad21c-b0e9-4792-8f55-b037xxxxxxxx"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.