CreateDataFlowSubTask - Cloud Parallel File Storage - Alibaba Cloud Documentation Center

Membuat subtugas untuk tugas streaming alur data.

Deskripsi operasi

Sebelum Anda memulai

Sebelum memanggil operasi ini, buat Sumber daya dalam urutan Pesanan berikut dan pastikan bahwa Sumber daya di setiap tingkat berada dalam status yang diperlukan:

Buat sistem file: Buat sistem file CPFS for Lingjun di Konsol.
- Persyaratan status: Sistem file berada dalam status Berjalan.
Buat alur data: Panggil CreateDataFlow untuk membuat alur data.
- Persyaratan status: Alur data berada dalam status Berjalan.
Buat Tugas alur kerja: Panggil CreateDataFlowTask untuk membuat tugas impor streaming (StreamImport) atau ekspor streaming (StreamExport).
- Persyaratan status: Tugas alur kerja berada dalam status Executing.

Deskripsi operasi

Hanya CPFS for Lingjun versi 2.6.0 dan lebih baru yang mendukung operasi ini. Anda dapat melihat informasi versi pada halaman detail sistem file di Konsol.
Anda hanya dapat membuat subtugas untuk Tugas alur kerja streaming yang berada dalam status Executing.
Tugas alur kerja streaming dijalankan secara asinkron. Anda dapat memanggil DescribeDataFlowSubTasks untuk mengkueri status eksekusi tugas streaming.
Ketika jenis tugas alur data adalah tugas streaming, status Executing hanya menunjukkan bahwa Anda dapat membuat tugas impor streaming atau ekspor streaming. Status ini tidak menunjukkan bahwa tugas impor atau ekspor sedang berjalan.

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:CreateDataFlowSubTask

create

*DataFlow

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
FileSystemId	string	Yes	ID sistem file.	bmcpfs-370lx1ev9ss27o0****
DataFlowId	string	Yes	ID alur data.	df-194433a5be31****
DataFlowTaskId	string	Yes	ID Tugas alur kerja. Catatan Hanya ID Tugas alur kerja streaming yang didukung.	task-38aa8e890f45****
DryRun	boolean	No	Apakah akan menjalankan dry run untuk permintaan ini. Dry run memeriksa validitas parameter dan ketersediaan Sumber daya tanpa benar-benar membuat instans atau menimbulkan biaya. Nilai valid: true: Mengirim permintaan pemeriksaan tanpa membuat alur data. Item pemeriksaan mencakup apakah parameter wajib telah ditentukan, format permintaan, dan dependensi batas bisnis. Jika pemeriksaan gagal, error yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode status HTTP 200 dikembalikan, tetapi DataFlowSubTaskId kosong. false (default): Mengirim permintaan normal. Setelah pemeriksaan berhasil, instans langsung dibuat.	false
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi pastikan bahwa token tersebut unik di antara berbagai permintaan. Token hanya dapat berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat Cara memastikan idempotensi. Catatan Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId dapat berbeda untuk setiap permintaan API.	123e4567-e89b-12d3-a456-42665544****
SrcFilePath	string	Yes	Jalur file sumber. Batasan: Panjang jalur harus 1 hingga 1.023 karakter. Jalur harus dienkode dalam UTF-8. Jalur harus dimulai dengan garis miring (/). Jalur harus diakhiri dengan nama file.	/test/file.png
DstFilePath	string	Yes	Jalur file tujuan. Batasan: Panjang jalur harus 1 hingga 1.023 karakter. Jalur harus dienkode dalam UTF-8. Jalur harus dimulai dengan garis miring (/). Jalur harus diakhiri dengan nama file.	/mnt/file.png
Condition	object	No	Kondisi verifikasi. Kondisi yang ditentukan harus lulus verifikasi.
ModifyTime	integer	No	Pengatur waktu modifikasi sebagai stempel waktu UNIX. Unit: ns.	1725897600000000000
Size	integer	No	Ukuran file. Unit: byte.	68

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	A70BEE5D-76D3-49FB-B58F-1F398211A5C3
DataFlowSubTaskId	string	ID tugas streaming alur data.	subTaskId-370kyfmyknxcyzw****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "A70BEE5D-76D3-49FB-B58F-1F398211A5C3",
  "DataFlowSubTaskId": "subTaskId-370kyfmyknxcyzw****"
}

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	MissingDataFlowId	DataFlowId is mandatory for this action.	Parameter DataFlowId tidak ditentukan.
400	InvalidFilesystemVersion.NotSupport	This Api does not support this fileSystem version.	Operasi saat ini tidak mendukung versi sistem file ini.
403	OperationDenied.InvalidState	The operation is not permitted when the status is processing.	Status sistem file saat ini tidak mendukung operasi ini.
403	OperationDenied.DependencyViolation	The operation is denied due to dependancy violation.	Kondisi untuk operasi ini tidak terpenuhi.
403	OperationDenied.DataFlowNotSupported	The operation is not supported.	Sistem file tidak mendukung aliran data.
404	InvalidParameter.InvalidFormat	The EntryList format is invalid.	Format EntryList yang ditentukan tidak memenuhi persyaratan.
404	InvalidParameter.SizeTooLarge	The specified EntryList size exceeds 64 KB.	Ukuran EntryList yang ditentukan melebihi 64 KB.
404	InvalidDataFlow.NotFound	The specified data flow does not exist.	Alur data yang ditentukan tidak ada.
404	InvalidTaskAction.NotSupported	The task action is not supported.	Jenis tugas yang ditentukan tidak didukung.
404	InvalidTaskAction.PermissionDenied	The task action is not allowed.	Jenis tugas yang ditentukan tidak diizinkan, seperti replikasi sistem.
404	InvalidSrcTaskId.NotFound	The SrcTaskId is not found.	SrcTaskId yang ditentukan tidak ada.
404	InvalidDataType.NotSupported	The data type is not supported.	Tipe data yang ditentukan tidak didukung.
404	InvalidSrcTaskId.TaskIdInvalid	Source task ID is invalid.	ID tugas yang akan disalin tidak valid.
404	InvalidSrcTaskId.TaskIdNotFound	Source task ID is not found.	ID tugas yang akan disalin tidak ada.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.