DescribeDataFlowSubTasks - Cloud Parallel File Storage - Alibaba Cloud Documentation Center

Menanyakan subtask alur data secara batch.

Deskripsi operasi

Hanya didukung oleh CPFS Intelligent Computing Edition versi 2.6.0 ke atas. Informasi versi dapat dilihat pada halaman detail sistem file di konsol.

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

Parameter permintaan

Parameter	Type	Required	Description	Example
FileSystemId	string	Yes	ID sistem file.	bmcpfs-370lx1ev9ss27o0****
Filters	array<object>	No	Filter yang digunakan untuk menanyakan task streaming data.
	object	No
Key	string	No	Nama filter. Nilai yang valid: DataFlowIds: memfilter subtask alur data berdasarkan ID alur data. DataFlowTaskIds: memfilter subtask alur data berdasarkan ID task alur data. DataFlowSubTaskIds: memfilter subtask alur data berdasarkan ID task streaming data. Status: memfilter subtask alur data berdasarkan status. SrcFilePath: memfilter subtask alur data berdasarkan path file sumber. DstFilePath: memfilter subtask alur data berdasarkan path file tujuan.	DataFlowSubTaskIds
Value	string	No	Nilai filter. Parameter ini tidak mendukung wildcard. Jika Key diatur ke DataFlowIds, atur Value ke ID alur data atau sebagian dari ID alur data. Anda dapat menentukan satu ID alur data atau sekelompok ID alur data. Maksimal 10 ID alur data yang dapat ditentukan. Contoh: `df-194433a5be31**` atau `df-194433a512a2,df-234533a5be31`. Jika Key diatur ke DataFlowTaskIds, atur Value ke ID task alur data atau sebagian dari ID task alur data. Anda dapat menentukan satu ID task alur data atau sekelompok ID task alur data. Maksimal 10 ID task alur data yang dapat ditentukan. Contoh: `task-29ee8e890f45` atau `task-29ee8e890f45,task-38ae8e890f45`. Jika Key diatur ke DataFlowSubTaskIds, atur Value ke ID task streaming data atau sebagian dari ID task streaming data. Anda dapat menentukan satu ID task streaming data atau sekelompok ID task streaming data. Maksimal 10 ID task streaming data yang dapat ditentukan. Contoh: `subTaskId-370kyfmyknxcyzw` atau `subTaskId-247kyfmyknxcyzw,subTaskId-256kyfmyknxcyzw**`. Jika Key diatur ke Status, atur Value ke status task alur data. Status yang tersedia adalah EXPIRED, CREATED, RUNNING, COMPLETE, CANCELING, FAILED, atau CANCELED. Kueri gabungan didukung. Jika Key diatur ke SrcFilePath, atur Value ke path file sumber. Panjang path maksimal 1.023 karakter. Jika Key diatur ke DstFilePath, atur Value ke path file tujuan. Panjang path maksimal 1.023 karakter.	subTaskId-370kyfmyknxcyzw****
NextToken	string	No	Token pagination yang digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru. Anda tidak perlu menentukan parameter ini untuk permintaan pertama. Anda harus menentukan token yang diperoleh dari kueri sebelumnya sebagai nilai NextToken.	iWk0AQAAAAAvY2FzZS8=
MaxResults	integer	No	Jumlah hasil untuk setiap kueri. Nilai yang 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 pagination yang digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru. Anda tidak perlu menentukan parameter ini untuk permintaan pertama. Anda harus menentukan token yang diperoleh dari kueri sebelumnya sebagai nilai NextToken.	pUJaUwAAAABhdGUyNTk1MQ==
DataFlowSubTask	object
DataFlowSubTask	array<object>	Detail tentang task streaming data.
	array<object>
FileSystemId	string	ID sistem file.	bmcpfs-370lx1ev9ss27o0****
DataFlowId	string	ID alur data.	df-194433a5be31****
DataFlowTaskId	string	ID task alur data.	task-38aa8e890f45****
DataFlowSubTaskId	string	ID task streaming data.	subTaskId-370kyfmyknxcyzw****
SrcFilePath	string	Path file sumber. Batasan: Panjang path harus antara 1 hingga 1.023 karakter. Path harus dikodekan dalam UTF-8. Path harus dimulai dengan garis miring (/). Path harus diakhiri dengan nama file.	/test/file.png
DstFilePath	string	Path file tujuan. Batasan: Panjang path harus antara 1 hingga 1.023 karakter. Path harus dikodekan dalam UTF-8. Path harus dimulai dengan garis miring (/). Path harus diakhiri dengan nama file.	/mnt/file.png
Status	string	Status task streaming data. Informasi berikut ditampilkan: EXPIRED: Task dihentikan. CREATED: Task dibuat. RUNNING: Task sedang berjalan. COMPLETE: Task selesai. CANCELING: Task sedang dibatalkan. FAILED: Task gagal dieksekusi. CANCELED: Task dibatalkan.	FAILED
Progress	integer	Kemajuan task streaming data. Nilai yang valid: 0 hingga 10000.	10000
CreateTime	string	Waktu saat task streaming data dibuat.	2024-07-01 19:59:29
StartTime	string	Waktu saat task streaming data dimulai.	2024-07-03 10:43:16
EndTime	string	Waktu saat task streaming data berakhir.	2024-07-04 11:14:22
ErrorMsg	string	Pesan error yang dikembalikan saat task gagal. Catatan Jika parameter ini tidak dikembalikan atau nilai kembali kosong, berarti tidak terjadi error.	file does not exist
ProgressStats	object	Informasi kemajuan tentang task streaming data.
BytesTotal	integer	Jumlah data yang dipindai pada sumber. Satuan: byte.	68
BytesDone	integer	Jumlah data (termasuk data yang dilewati) yang telah selesai diproses oleh task alur data. Satuan: byte.	68
ActualBytes	integer	Jumlah aktual data yang telah selesai diproses oleh task alur data. Satuan: byte.	68
AverageSpeed	integer	Kecepatan aliran rata-rata. Satuan: byte/detik.	34
FileDetail	object	Informasi tentang file.
ModifyTime	integer	Waktu saat file dimodifikasi. Nilainya merupakan stempel waktu UNIX. Satuan: ns.	1725897600000000000
Size	integer	Ukuran file. Satuan: byte.	68
Checksum	string	Checksum. 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
400	IllegalCharacters	The parameter contains illegal characters.
400	MissingFileSystemId	FileSystemId is mandatory for this action.
400	InvalidFilesystemVersion.NotSupport	This Api does not support this fileSystem version.
403	OperationDenied.DataFlowNotSupported	The operation is not supported.
404	InvalidParameter.InvalidNextToken	The specified NextToken is invaild.
404	InvalidFileSystem.NotFound	The specified file system does not exist.
404	InvalidDataFlow.NotFound	The specified data flow does not exist.
404	InvalidParameter.InvalidMaxResults	The specified MaxResults is invalid.
404	InvalidFilterParam	The specified Filter.N.Key is invalid.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.