ApsaraVideo VOD memungkinkan Anda menghapus file media untuk mengelola biaya penyimpanan atau menghapus konten yang kedaluwarsa maupun tidak sesuai. Topik ini menjelaskan berbagai jenis operasi penghapusan beserta dampaknya, serta memberikan panduan cara menghapus file media secara aman dan efisien menggunakan Konsol, API, atau kit pengembangan perangkat lunak (SDK).
Cara kerja
Sebelum menghapus file, pahami cara kerja operasi tersebut dan risiko potensialnya untuk mencegah kehilangan data yang tidak dapat dipulihkan.
Semua operasi penghapusan bersifat fisik. File dan informasi Aset media terkait akan dihapus secara permanen dan tidak dapat dipulihkan. Untuk mencadangkan file Anda, lihat Migrasi sumber daya ApsaraVideo VOD.
Jenis penghapusan | Konten yang dihapus | Dampak terhadap pemutaran |
Audio atau video lengkap | File sumber, semua aliran yang telah dikodekan ulang, Gambar mini, dan Sprite. | Video atau audio tidak dapat diputar. |
Aliran audio dan video | File hasil transkoding dengan Definisi tertentu. | Definisi tertentu tidak dapat diputar. Hal ini dapat menyebabkan error pada player. |
File sumber | File asli yang diunggah. | Versi kualitas asli tidak dapat diputar. |
Gambar | File gambar. | Video tidak dapat ditampilkan sebagai Gambar mini. |
Setelah menghapus file media dari ApsaraVideo VOD, cache pada point of presence (POP) CDN tidak otomatis di-purge. Gunakan fitur purge di Konsol ApsaraVideo VOD untuk membersihkan data usang dari POP CDN. Untuk informasi selengkapnya, lihat Refresh dan pra-ambil.
Secara default, Anda tidak dapat menghapus file sumber audio atau video yang diunggah untuk distribusi tanpa transkoding karena file tersebut digunakan untuk pemutaran kualitas asli. Untuk menghapus file tersebut, panggil Operasi API DeleteMezzanines dan tentukan parameter
Force.
Skenario 1: Menghapus file menggunakan Konsol
Menghapus sejumlah kecil file secara manual
Konsol menyediakan antarmuka yang intuitif dan sesuai untuk menghapus sejumlah kecil file.
Masuk ke Konsol ApsaraVideo VOD.
Pada panel navigasi kiri, pilih Media Assets, lalu klik Audio/Video, Image, atau Short Video Material.
Pada halaman manajemen, temukan file yang ingin dihapus, lalu klik Delete di kolom Actions.
Menghapus file secara Batch melalui Kebijakan Aset media
Kebijakan penyimpanan dan penghapusan hanya berlaku untuk Aset media di bucket ApsaraVideo VOD, serta hanya mendukung file audio dan video dengan Jenis Penyimpanan Standar. Kebijakan penghapusan tidak berlaku untuk Aset media yang telah disimpan kurang dari tujuh hari.
Kebijakan berjalan setiap hari dari pukul 00.00 hingga 24.00 (UTC+8) berdasarkan waktu unggah. Setiap kebijakan memproses hingga 50.000 Aset media per hari. Aset yang melebihi batas akan diproses pada hari berikutnya.
Maksimal lima Kebijakan penghapusan Aset media dapat dikonfigurasikan. Jika sebuah Aset media cocok dengan beberapa Kebijakan, hanya Kebijakan dengan prioritas tertinggi yang akan dijalankan.
Setelah Kebijakan diaktifkan, audio dan video akan dihapus secara otomatis sesuai kondisi dan tidak dapat dipulihkan setelah penghapusan. Pastikan untuk mengonfirmasi kondisi waktu, kondisi Klasifikasi, dan konfigurasi penghapusan Kebijakan sebelum mengaktifkannya.
Masuk ke Konsol ApsaraVideo VOD.
Pada panel navigasi kiri, pilih Configuration Management > Media Management > Policy Management.
Pada tab Policy Management, klik Create Policy dan konfigurasikan parameter.
Parameter
Deskripsi
Waktu Unggah atau Durasi Penyimpanan
Waktu Unggah: Menghapus Aset media yang diunggah dalam rentang waktu yang ditentukan.
Durasi Penyimpanan: Menghapus Aset media yang telah disimpan lebih lama dari durasi yang ditentukan.
Kategori
Kategori Aset media tempat berlakunya kebijakan penghapusan. Pilih hingga tiga kategori. Kategori Aset media.
CatatanKebijakan hanya dapat diterapkan pada kategori tingkat pertama. Menghapus kategori tingkat pertama tidak akan menghapus Aset media di subkategorinya.
Kelas Penyimpanan
Nilai bersifat tetap. Hanya Aset media dengan kelas penyimpanan Standar yang didukung.
Bucket
Tetap. Hanya bucket ApsaraVideo VOD yang didukung.
Konfigurasi Penghapusan
Semua Sumber Daya Media: File sumber dan file hasil transkoding-nya.
Hanya file hasil transkoding: Hanya file output hasil transkoding.
Hanya File Sumber: Hanya file sumber yang diunggah.
Tanggal Mulai
Waktu ketika kebijakan penghapusan mulai berlaku.
Prioritas
Nilai yang lebih tinggi menunjukkan prioritas yang lebih tinggi. Untuk Kebijakan dengan prioritas yang sama, Kebijakan yang dibuat paling awal akan didahulukan.
Skenario 2: Menghapus file menggunakan API atau SDK
Menghapus file media menggunakan API atau SDK memberikan fleksibilitas dan otomatisasi yang lebih besar. Ini merupakan Solusi yang disarankan untuk mengelola banyak Aset media di lingkungan produksi.
Pastikan Anda telah menginstal SDK untuk bahasa yang diinginkan dan melakukan inisialisasi client. Untuk informasi selengkapnya, lihat SDK sisi server.
Saat memanggil Operasi API untuk menghapus file media, perhatikan batas permintaan per detik (QPS). Jika batas QPS terlampaui, panggilan API akan gagal. Untuk informasi selengkapnya, lihat Throttling.
Menghapus satu atau beberapa video lengkap
Anda dapat menghapus hingga 20 video sekaligus.
Anda dapat menerima Notifikasi penyelesaian tugas melalui DeleteMediaComplete.
Ini adalah skenario yang paling umum. Panggil Operasi API DeleteVideo untuk menghapus semua sumber daya yang terkait dengan video, seperti file sumber, aliran yang telah dikodekan ulang, dan Snapshot. Kode berikut memberikan contoh.
from aliyunsdkvod.request.v20170321 import DeleteVideoRequest
from aliyunsdkcore.client import AcsClient
import json
def delete_video_safely(video_ids: str, access_key: str, secret_key: str, region='cn-shanghai'):
"""
Menghapus satu atau beberapa video secara aman.
Args:
video_ids: ID video. Pisahkan multiple ID dengan koma.
access_key: ID AccessKey.
secret_key: Rahasia AccessKey.
region: Wilayah.
Returns:
dict: Kamus yang menunjukkan apakah panggilan berhasil dan menyertakan pesan error apa pun.
"""
try:
# 1. Inisialisasi client.
client = AcsClient(access_key, secret_key, region)
# 2. Buat permintaan penghapusan.
request = DeleteVideoRequest.DeleteVideoRequest()
request.set_VideoIds(video_ids)
# 3. Jalankan penghapusan.
response = client.do_action_with_exception(request)
result = json.loads(response)
print(f"Permintaan hapus untuk video {video_ids} dikirim. RequestID: {result.get('RequestId')}")
return {"success": True, "data": result}
except Exception as e:
error_msg = str(e)
print(f"Penghapusan gagal: {error_msg}")
# Penanganan error umum
if "InvalidVideo.NotFound" in error_msg:
return {"success": False, "error": "Video tidak ada atau telah dihapus."}
elif "Forbidden.IllegalStatus" in error_msg:
return {"success": False, "error": "Video tidak dapat dihapus karena statusnya saat ini. Mungkin sedang dalam proses transkoding."}
elif "Throttling" in error_msg:
return {"success": False, "error": "Permintaan terlalu sering. Silakan coba lagi nanti."}
else:
return {"success": False, "error": f"Error tidak dikenal: {error_msg}"}
# Contoh penggunaan
# result = delete_video_safely(
# video_ids="your-video-id-1,your-video-id-2",
# access_key="your-access-key",
# secret_key="your-secret-key"
# )Menghapus aliran video dengan Definisi tertentu
Panggil Operasi API DeleteStream. Gunakan fitur ini jika Anda hanya perlu menghapus Definisi tertentu tetapi ingin mempertahankan definisi lainnya. Kode berikut memberikan contoh.
from aliyunsdkvod.request.v20170321 import DeleteStreamRequest
# ... (Gunakan kembali inisialisasi AcsClient dari contoh sebelumnya)
def delete_specific_stream(video_id: str, job_ids: str, access_key: str, secret_key: str):
"""
Menghapus aliran yang telah dikodekan ulang dengan Definisi tertentu.
Args:
video_id: ID video.
job_ids: Daftar ID Pekerjaan transkoding. Pisahkan multiple ID dengan koma.
"""
try:
client = AcsClient(access_key, secret_key, 'cn-shanghai')
request = DeleteStreamRequest.DeleteStreamRequest()
request.set_VideoId(video_id)
request.set_JobIds(job_ids)
response = client.do_action_with_exception(request)
print(f"Aliran definisi tertentu untuk video {video_id} telah dihapus.")
return json.loads(response)
except Exception as e:
print(f"Gagal menghapus aliran: {e}")
raise
# Contoh: Anggaplah Anda telah memperoleh JobId 'job-id-for-4k' untuk definisi '4K' dengan memanggil GetPlayInfo.
# delete_specific_stream(
# video_id="your-video-id",
# job_ids="job-id-for-4k",
# access_key="your-access-key",
# secret_key="your-secret-key"
# )Memaksa penghapusan file sumber
Panggil Operasi API DeleteMezzanines. Perilaku penghapusan bervariasi tergantung pada mode unggah:
Dengan transkoding diaktifkan: File sumber (mezzanine) dan aliran yang telah dikodekan ulang disimpan secara terpisah. Menghapus file sumber akan mempertahankan aliran hasil transkoding yang telah dibuat, sehingga masih dapat diputar secara normal.
Tanpa transkoding: Mezzanine adalah file sumber itu sendiri. Menghapus file sumber sama dengan menghapus mezzanine, yang menyebabkan aliran pemutaran terhapus dan tidak dapat dipulihkan.
Kode berikut memberikan contoh.
Dengan transkoding diaktifkan: Setelah menghapus file sumber, pemutaran kualitas asli menjadi tidak tersedia, namun aliran yang telah dikodekan ulang tidak terpengaruh. Anda tidak dapat melakukan transkoding ulang video setelah penghapusan.
Tanpa transkoding: Setelah menghapus file sumber, mezzanine (yaitu file sumber) akan dihapus secara permanen. Semua aliran pemutaran akan dihapus dan tidak dapat dipulihkan. Gunakan operasi ini hanya jika Anda yakin bahwa file sumber tidak lagi diperlukan.
from aliyunsdkvod.request.v20170321 import DeleteMezzaninesRequest
# ... (Gunakan kembali inisialisasi AcsClient dari contoh sebelumnya)
def force_delete_source_file(video_ids: str, access_key: str, secret_key: str):
"""
Memaksa penghapusan file sumber.
Args:
video_ids: Daftar ID video. Pisahkan multiple ID dengan koma.
"""
try:
client = AcsClient(access_key, secret_key, 'cn-shanghai')
request = DeleteMezzaninesRequest.DeleteMezzaninesRequest()
request.set_VideoIds(video_ids)
request.set_Force(True) # Flag paksa hapus
response = client.do_action_with_exception(request)
print("File sumber berhasil dihapus secara paksa.")
print("Lakukan purge cache CDN segera untuk mencegah error 404 selama pemutaran kualitas asli.")
return json.loads(response)
except Exception as e:
print(f"Penghapusan paksa gagal: {e}")
raise
# force_delete_source_file(
# video_ids="your-video-id",
# access_key="your-access-key",
# secret_key="your-secret-key"
# )Operasi API DeleteMezzanines hanya menghapus Sumber video (file mezzanine). Setelah panggilan berhasil, API mengembalikan respons sukses, tetapi placeholder video tetap ada di daftar audio/video pustaka media. Respons API yang sukses tidak berarti video telah dihapus dari daftar. Untuk menghapus entri video sepenuhnya dari pustaka media, panggil Operasi API DeleteVideo sebagai gantinya, yang akan menghapus seluruh video, termasuk file sumber, file aliran hasil transkoding, dan Snapshot.
Menghapus file gambar
Untuk menghapus gambar yang diunggah atau tangkapan video, panggil Operasi API DeleteImage.