Path - Delete
Hapus File | Hapus Direktori
Hapus file atau direktori. Operasi ini mendukung permintaan HTTP kondisional. Untuk informasi selengkapnya, lihat Menentukan Header Kondisional untuk Operasi Blob Service.
DELETE https://{accountName}.{dnsSuffix}/{filesystem}/{path}
DELETE https://{accountName}.{dnsSuffix}/{filesystem}/{path}?recursive={recursive}&continuation={continuation}&paginated={paginated}&timeout={timeout}
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
account
|
path | True |
string |
Nama akun Azure Storage. |
dns
|
path | True |
string |
Akhiran DNS untuk titik akhir Azure Data Lake Storage. |
filesystem
|
path | True |
string |
Pengidentifikasi sistem file. Pola regex: |
path
|
path | True |
string |
Jalur file atau direktori. |
continuation
|
query |
string |
Pilihan. Saat menghapus direktori, jumlah jalur yang dihapus dengan setiap pemanggilan dibatasi. Jika jumlah jalur yang akan dihapus melebihi batas ini, token kelanjutan dikembalikan di header respons ini. Ketika token kelanjutan dikembalikan dalam respons, token tersebut harus ditentukan dalam pemanggilan operasi penghapusan berikutnya untuk terus menghapus direktori. |
|
paginated
|
query |
boolean |
Opsional dan valid hanya jika Namespace Hierarki diaktifkan untuk akun dan sumber daya adalah direktori dengan parameter kueri "rekursif" yang diatur ke "true". Untuk penghapusan direktori rekursif, jumlah jalur yang dapat dihapus dengan setiap pemanggilan dibatasi ketika mekanisme otorisasi yang digunakan adalah ACL dan pemanggil adalah pengguna non-super, karena batas waktu default adalah 30 detik. Ketika parameter kueri "paginated" diatur ke "true", header respons mungkin berisi "x-ms-continuation" jika batas di atas terpenuhi. Saat mengirim "x-ms-continuation" dalam permintaan subsequnt, parameter kueri "paginated" dan "recursive" harus diatur ke "true". Ketika respons tidak berisi "x-ms-continuation", penghapusan direktori rekursif berhasil. Penghapusan direktori aktual hanya terjadi pada pemanggilan terakhir, yang sebelumnya melibatkan pemeriksaan ACL di server file dan direktori di bawah direktori untuk dihapus secara rekursif. |
|
recursive
|
query |
boolean |
Diperlukan dan hanya valid saat sumber daya adalah direktori. Jika "true", semua jalur di bawah direktori akan dihapus. Jika "false" dan direktori tidak kosong, kesalahan terjadi. |
|
timeout
|
query |
integer int32 |
Nilai batas waktu operasi opsional dalam detik. Periode dimulai ketika permintaan diterima oleh layanan. Jika nilai batas waktu berlalu sebelum operasi selesai, operasi gagal. |
Header Permintaan
Nama | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
x-ms-lease-id |
string |
ID sewa harus ditentukan jika ada sewa aktif. Pola regex: |
|
If-Match |
string |
Pilihan. Nilai ETag. Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan. ETag harus ditentukan dalam tanda kutip. |
|
If-None-Match |
string |
Pilihan. Nilai ETag atau nilai wildcard khusus ("*"). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. ETag harus ditentukan dalam tanda kutip. |
|
If-Modified-Since |
string |
Pilihan. Nilai tanggal dan waktu. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak tanggal dan waktu yang ditentukan. |
|
If-Unmodified-Since |
string |
Pilihan. Nilai tanggal dan waktu. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal dan waktu yang ditentukan. |
|
x-ms-client-request-id |
string |
UUID yang dicatat dalam log analitik untuk pemecahan masalah dan korelasi. Pola regex: |
|
x-ms-date |
string |
Menentukan Waktu Universal Terkoordinasi (UTC) untuk permintaan tersebut. Ini diperlukan saat menggunakan otorisasi kunci bersama. |
|
x-ms-version |
string |
Menentukan versi protokol REST yang digunakan untuk memproses permintaan. Ini diperlukan saat menggunakan otorisasi kunci bersama. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
File telah dihapus. Header
|
|
202 Accepted |
Permintaan penghapusan diterima, hanya berlaku saat Namespace Hierarki diaktifkan untuk akun tersebut. Header
|
|
Other Status Codes |
Terjadi kesalahan. Kemungkinan status HTTP, kode, dan string pesan tercantum di bawah ini:
Header
|
Definisi
Nama | Deskripsi |
---|---|
Data |
|
Error |
Objek respons kesalahan layanan. |
DataLakeStorageError
Nama | Jenis | Deskripsi |
---|---|---|
error |
Objek respons kesalahan layanan. |
Error
Objek respons kesalahan layanan.
Nama | Jenis | Deskripsi |
---|---|---|
code |
string |
Kode kesalahan layanan. |
message |
string |
Pesan kesalahan layanan. |