Buat tugas dekompresi file dengan CreateFileUncompressionTask - Intelligent Media Management

Deskripsi operasi

Catatan

API ini berada dalam pratinjau publik. Jika Anda memiliki pertanyaan, bergabunglah dengan grup DingTalk kami untuk memberikan masukan. Untuk nomor grup, lihat Hubungi kami.

Sebelum menggunakan API ini, tinjau metode penagihan dan harga untuk Intelligent Media Management.
Penting Ketepatan waktu tidak dijamin untuk tugas asinkron.
Batas jumlah file: Satu paket terkompresi dapat berisi maksimal 80.000 file.
Batas ukuran file: 200 GB untuk format Zip dan RAR, serta 50 GB untuk format 7z.
Tugas dekompresi file menggunakan stream decompression, yang menghasilkan file secara bertahap selama proses dekompresi berlangsung. Jika operasi dihentikan karena kerusakan file, file yang telah berhasil didekompresi tidak akan dihapus.
Ini adalah API asinkron. Informasi tugas hanya disimpan selama 7 hari dan tidak dapat diambil setelah periode tersebut. Untuk melihat informasi tugas, Anda dapat memanggil operasi GetTask atau ListTasks dengan TaskId yang dikembalikan. Alternatifnya, Anda dapat mengatur parameter Notification untuk menerima informasi tugas melalui pesan notifikasi asinkron.

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

imm:CreateFileUncompressionTask

create

*Project

acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ProjectName	string	Yes	Nama proyek. Untuk informasi selengkapnya, lihat Buat proyek.	test-project
CredentialConfig	CredentialConfig	No	Biarkan parameter ini kosong kecuali Anda memiliki persyaratan khusus. Konfigurasi otorisasi berantai. Parameter ini bersifat opsional. Untuk informasi selengkapnya, lihat Gunakan otorisasi berantai untuk mengakses sumber daya entitas lain.
Password	string	No	Password untuk paket terkompresi yang dienkripsi.	123456
UserData	string	No	Informasi pengguna kustom. Nilai ini dikembalikan dalam pesan notifikasi asinkron untuk membantu Anda mengaitkan notifikasi tersebut dengan sistem Anda. Panjang maksimum adalah 2.048 byte.	test-data
SelectedFiles	array	No	Daftar file yang akan didekompresi. Jika parameter ini kosong, seluruh paket terkompresi akan didekompresi. Nilai default-nya kosong.
	string	No	Nama file yang akan didekompresi. Ini adalah path relatif terhadap direktori root dari paket terkompresi.	test-dir/test.jpg
SourceURI	string	Yes	Alamat Object Storage Service (OSS) tempat file terkompresi disimpan. Alamat OSS harus dalam format `oss://${Bucket}/${Object}`. `${Bucket}` adalah nama bucket OSS di wilayah yang sama dengan proyek saat ini. `${Object}` adalah path lengkap file, termasuk ekstensi nama file.	oss://test-bucket/test-object.zip
Notification	Notification	No	Konfigurasi notifikasi pesan. Untuk detailnya, klik Notification. Mengenai format pesan notifikasi asinkron, lihat Format pesan notifikasi asinkron. Catatan Callback API Intelligent Media Management tidak mendukung alamat webhook kustom. Gunakan MNS sebagai gantinya.
TargetURI	string	No	Alamat OSS tujuan untuk file yang didekompresi. File yang dipilih atau seluruh paket terkompresi akan didekompresi ke alamat ini. Alamat OSS harus dalam format `oss://${Bucket}/${Object}`. `${Bucket}` adalah nama bucket OSS di wilayah yang sama dengan proyek saat ini. `${Object}` adalah path lengkap file, termasuk ekstensi nama file.	oss://test-bucket/test-dir/

Untuk memperoleh informasi dekompresi detail saat membuat tugas dekompresi, atur parameter `ExtendedMessageURI` dalam `Notification`. File tersebut berisi informasi dengan struktur berikut:

{
  "Password" : "Password dari paket terkompresi",
  "IsEncryption": "true/false, menentukan apakah paket terkompresi dienkripsi",
  "ArchiveFiles": [
    {
      "URI": "Alamat file yang didekompresi. Contoh: oss://test-bucket/test-dir/test.txt",
      "PathName": "Path file relatif terhadap paket terkompresi. Contoh: ./test.txt",
      "Reason": "Jika pratinjau gagal, parameter ini menunjukkan alasan kegagalannya.",
      "IsFolder": "true/false, menentukan apakah file tersebut merupakan folder",
      "PackedSize": "Ukuran file dalam paket terkompresi",
      "UnPackedSize": "Ukuran file setelah dekompresi",
      "FileAccessTime": "Informasi waktu file",
    },
    {
      "URI": "oss://test-bucket/test-dir/text.doc",
      "PathName": "./text.doc",
      "Reason": "",
      "IsFolder": "true",
      "PackedSize": "102",
      "UnPackedSize": "150",
      "FileAccessTime": "2023-07-21T09:46:35Z",
    },
  ]
}

Elemen respons

Element	Type	Description	Example
	object	Respons struct
RequestId	string	ID permintaan.	EC564A9A-BA5C-4499-A087-D9B9E76E*****
EventId	string	ID event.	0ED-1Bz8z71k5TtsUejT4UJ16Es*****
TaskId	string	ID tugas.	FileUncompression-16ab5dd6-af02-480e-9ed7-a8d51b1*****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "EC564A9A-BA5C-4499-A087-D9B9E76E*****",
  "EventId": "0ED-1Bz8z71k5TtsUejT4UJ16Es*****",
  "TaskId": "FileUncompression-16ab5dd6-af02-480e-9ed7-a8d51b1*****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.