All Products
Search

This Product

    Cloud Parallel File Storage:DescribeDataFlowSubTasks

    Document Center

    Cloud Parallel File Storage:DescribeDataFlowSubTasks

    Last Updated:Oct 12, 2026

    Mengkueri subtugas Batch dari alur data.

    Deskripsi operasi

    Hanya didukung oleh CPFS for Lingjun 2.6.0 dan versi yang lebih baru. Anda dapat melihat informasi versi pada halaman detail sistem file di Konsol.

    Sebelum memulai

    Sebelum memanggil operasi ini untuk mengkueri subtugas alur data, Anda harus membuat resource dan memulai Tugas dalam Pesanan berikut:

    1. Membuat sistem file bmcpfs: Anda harus membuat sistem file CPFS for Lingjun di Konsol dan menunggu hingga statusnya berubah menjadi Running.

    2. Membuat aturan alur data: Panggil operasi CreateDataFlow pada sistem file untuk membuat saluran alur data.

    3. Memulai Tugas alur kerja: Panggil operasi CreateDataFlowTask untuk membuat dan memulai Tugas alur kerja. Status Tugas harus Berjalan.

    4. Mengkueri daftar subtugas: Subtugas secara otomatis dibuat selama eksekusi Tugas alur kerja. Panggil operasi DescribeDataFlowSubTasks untuk mengkueri daftar subtugas ini.

    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

    nas:DescribeDataFlowSubTasks

    list

    *DataFlow.

    acs:nas:{#regionId}:{#accountId}:filesystem/{#filesystemId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    FileSystemId

    string

    Yes

    ID sistem file. Hanya sistem file CPFS for Lingjun yang didukung. ID harus diawali dengan bmcpfs-.

    bmcpfs-370lx1ev9ss27o0****

    Filters

    array<object>

    No

    Kunci filter yang digunakan untuk mengkueri tugas streaming dari alur data.

    object

    No

    Key

    string

    No

    Nama kunci filter.

    Nilai valid:

    • DataFlowIds: memfilter berdasarkan ID alur data.

    • DataFlowTaskIds: memfilter berdasarkan ID Tugas alur kerja.

    • DataFlowSubTaskIds: memfilter berdasarkan ID subtugas streaming alur data.

    • Status: memfilter berdasarkan status alur data.

    • SrcFilePath: memfilter berdasarkan jalur file sumber.

    • DstFilePath: memfilter berdasarkan jalur file tujuan.

    Valid values:

    • Status :

      Memfilter berdasarkan status alur data.

    • DstFilePath :

      Memfilter berdasarkan jalur file tujuan.

    • DataFlowSubTaskIds :

      Memfilter berdasarkan ID tugas streaming alur data.

    • SrcFilePath :

      Memfilter berdasarkan jalur file sumber.

    • DataFlowIds :

      Memfilter berdasarkan ID alur data.

    • DataFlowTaskIds :

      Memfilter berdasarkan ID Tugas alur kerja.

    DataFlowSubTaskIds
    Value

    string

    No

    Nilai kunci filter. Parameter ini tidak mendukung wildcard.

    • Jika Key diatur ke DataFlowIds, Value diatur ke ID alur data atau sebagian dari ID alur data. Anda dapat menentukan satu atau beberapa ID alur data. Maksimal 10 ID alur data dapat ditentukan. Contoh: df-194433a5be31**** atau df-194433a512a2****,df-234533a5be31****.

    • Jika Key diatur ke DataFlowTaskIds, Value diatur ke ID Tugas alur kerja atau sebagian dari ID Tugas alur kerja. Anda dapat menentukan satu atau beberapa ID Tugas alur kerja. Maksimal 10 ID Tugas alur kerja dapat ditentukan. Contoh: task-29ee8e890f45**** atau task-29ee8e890f45****,task-38ae8e890f45****.

    • Jika Key diatur ke DataFlowSubTaskIds, Value diatur ke ID subtugas streaming alur data atau sebagian dari ID subtugas streaming alur data. Anda dapat menentukan satu atau beberapa ID subtugas streaming alur data. Maksimal 10 ID subtugas streaming alur data dapat ditentukan. Contoh: subTaskId-370kyfmyknxcyzw**** atau subTaskId-247kyfmyknxcyzw****,subTaskId-256kyfmyknxcyzw****.

    • Jika Key diatur ke Status, Value diatur ke status Tugas alur kerja. Nilai valid: EXPIRED, CREATED, RUNNING, COMPLETE, CANCELING, FAILED, dan CANCELED. Kueri gabungan didukung.

    • Jika Key diatur ke SrcFilePath, Value diatur ke jalur file sumber. Panjang jalur dapat mencapai 1.023 karakter.

    • Jika Key diatur ke DstFilePath, Value diatur ke jalur file tujuan. Panjang jalur dapat mencapai 1.023 karakter.

    subTaskId-370kyfmyknxcyzw****

    NextToken

    string

    No

    Token yang digunakan untuk mengambil halaman hasil berikutnya ketika hasil yang dikembalikan terpotong. Anda dapat menggunakan NextToken untuk memulai permintaan lain guna mengambil hasil setelah titik pemotongan saat ini.

    iWk0AQAAAAAvY2FzZS8=
    MaxResults

    integer

    No

    Jumlah maksimum entri yang dikembalikan untuk satu permintaan.

    Nilai valid: 20 hingga 100.

    Nilai default: 20.

    20

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    98696EF0-1607-4E9D-B01D-F20930B6****
    NextToken

    string

    Token yang digunakan untuk mengambil halaman hasil berikutnya ketika hasil yang dikembalikan terpotong. Anda dapat menggunakan NextToken untuk memulai permintaan lain guna mengambil hasil setelah titik pemotongan saat ini.

    pUJaUwAAAABhdGUyNTk1MQ==
    DataFlowSubTask

    object

    DataFlowSubTask

    array<object>

    Kumpulan informasi tugas streaming alur data.

    array<object>

    FileSystemId

    string

    ID sistem file.

    bmcpfs-370lx1ev9ss27o0****

    DataFlowId

    string

    ID alur data.

    df-194433a5be31****

    DataFlowTaskId

    string

    ID Tugas alur kerja.

    task-38aa8e890f45****
    DataFlowSubTaskId

    string

    ID tugas streaming alur data.

    subTaskId-370kyfmyknxcyzw****

    SrcFilePath

    string

    Jalur file sumber. Batasan:

    • Panjang jalur harus 1 hingga 1.023 karakter.

    • Jalur harus dienkode dalam UTF-8.

    • Jalur harus diawali dengan garis miring (/).

    • Jalur harus diakhiri dengan nama file.

    /test/file.png

    DstFilePath

    string

    Jalur file tujuan. Batasan:

    • Panjang jalur harus 1 hingga 1.023 karakter.

    • Jalur harus dienkode dalam UTF-8.

    • Jalur harus diawali dengan garis miring (/).

    • Jalur harus diakhiri dengan nama file.

    /mnt/file.png

    Status

    string

    Status saat ini dari tugas streaming alur data. Nilai valid:

    • EXPIRED: Tugas dihentikan.

    • CREATED: Tugas dibuat.

    • RUNNING: Tugas sedang berjalan.

    • COMPLETE: Tugas selesai.

    • CANCELING: Tugas sedang dibatalkan.

    • FAILED: Tugas gagal.

    • CANCELED: Tugas dibatalkan.

    FAILED
    Progress

    integer

    Progres eksekusi tugas streaming alur data. Nilai valid: 0 hingga 10000.

    10000
    CreateTime

    string

    Waktu saat subtugas streaming dibuat. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-dd HH:mm:ss.

    2024-07-01 19:59:29
    StartTime

    string

    Waktu saat subtugas streaming mulai berjalan. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-dd HH:mm:ss.

    2024-07-03 10:43:16
    EndTime

    string

    Waktu saat subtugas streaming berakhir. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-dd HH:mm:ss.

    2024-07-04 11:14:22
    ErrorMsg

    string

    Pesan error yang dikembalikan ketika Tugas gagal.

    Catatan

    Jika bidang ini tidak dikembalikan atau kosong, tidak ada pesan error yang tersedia.

    file does not exist
    ProgressStats

    object

    Statistik progres tugas streaming alur data.

    BytesTotal

    integer

    Jumlah data yang dipindai di sumber. Unit: bytes.

    68
    BytesDone

    integer

    Jumlah data yang alur datanya telah selesai, termasuk data yang dilewati. Unit: bytes.

    68
    ActualBytes

    integer

    Jumlah data aktual yang ditransfer. Unit: bytes.

    68
    AverageSpeed

    integer

    Kecepatan transfer data rata-rata. Unit: bytes/s.

    34
    FileDetail

    object

    Detail file.

    ModifyTime

    integer

    Waktu saat file terakhir dimodifikasi. Nilainya adalah Stempel waktu UNIX dalam nanodetik.

    1725897600000000000
    Size

    integer

    Ukuran file. Unit: bytes.

    68
    Checksum

    string

    Checksum file. Contoh format: crc64:123456.

    crc64:850309505450944****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
  "NextToken": "pUJaUwAAAABhdGUyNTk1MQ==",
  "DataFlowSubTask": {
    "DataFlowSubTask": [
      {
        "FileSystemId": "bmcpfs-370lx1ev9ss27o0****\n",
        "DataFlowId": "df-194433a5be31****\n",
        "DataFlowTaskId": "task-38aa8e890f45****",
        "DataFlowSubTaskId": "subTaskId-370kyfmyknxcyzw****\n",
        "SrcFilePath": "/test/file.png\n",
        "DstFilePath": "/mnt/file.png\n",
        "Status": "FAILED",
        "Progress": 10000,
        "CreateTime": "2024-07-01 19:59:29",
        "StartTime": "2024-07-03 10:43:16",
        "EndTime": "2024-07-04 11:14:22",
        "ErrorMsg": "file does not exist",
        "ProgressStats": {
          "BytesTotal": 68,
          "BytesDone": 68,
          "ActualBytes": 68,
          "AverageSpeed": 34
        },
        "FileDetail": {
          "ModifyTime": 1725897600000000000,
          "Size": 68,
          "Checksum": "crc64:850309505450944****"
        }
      }
    ]
  }
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 IllegalCharacters The parameter contains illegal characters. Parameter tidak valid.
    400 MissingFileSystemId FileSystemId is mandatory for this action. Parameter FileSystemId tidak ditentukan.
    400 InvalidFilesystemVersion.NotSupport This Api does not support this fileSystem version. Operasi saat ini tidak mendukung versi sistem file ini.
    403 OperationDenied.DataFlowNotSupported The operation is not supported. Sistem file tidak mendukung dataflow.
    404 InvalidParameter.InvalidNextToken The specified NextToken is invaild.
    404 InvalidFileSystem.NotFound The specified file system does not exist. Sistem file yang ditentukan tidak ada.
    404 InvalidDataFlow.NotFound The specified data flow does not exist. Alur data yang ditentukan tidak ada.
    404 InvalidParameter.InvalidMaxResults The specified MaxResults is invalid. Nilai MaxResults yang ditentukan tidak valid.
    404 InvalidFilterParam The specified Filter.N.Key is invalid. Parameter Filter.N.Key yang ditentukan tidak valid.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.