Hapus Kontainer

Operasi menghapus Delete Container kontainer yang ditentukan.

Permintaan

Anda dapat membuat permintaan Delete Container sebagai berikut. HTTPS direkomendasikan. Ganti myaccount dengan nama akun penyimpanan Anda.

Metode	Memohon URI	Versi HTTP
DELETE	https://myaccount.blob.core.windows.net/mycontainer?restype=container	HTTP/1.1

URI layanan penyimpanan yang ditimulasi

Saat Anda membuat permintaan terhadap layanan penyimpanan yang diemulasi, tentukan nama host emulator dan port Azure Blob Storage sebagai 127.0.0.1:10000, diikuti dengan nama akun penyimpanan yang diemulasi.

Metode	Memohon URI	Versi HTTP
DELETE	http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container	HTTP/1.1

Untuk informasi selengkapnya, lihat Menggunakan emulator Azurite untuk pengembangan Azure Storage lokal.

URI Parameter

Anda dapat menentukan parameter tambahan berikut pada URI permintaan.

Parameter	Deskripsi
timeout	Optional. Parameter timeout dinyatakan dalam hitung detik. Untuk informasi selengkapnya, lihat Mengatur batas waktu untuk operasi Blob Storage.

Tajuk permintaan

Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional.

Tajuk permintaan	Deskripsi
Authorization	Required. Menentukan skema otorisasi, nama akun, dan tanda tangan. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage.
Date atau x-ms-date	Required. Menentukan Waktu Universal Terkoordinasi (UTC) untuk permintaan tersebut. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage.
x-ms-lease-id: <ID>	Diperlukan untuk versi 2012-02-12 dan yang lebih baru jika kontainer memiliki sewa aktif. Untuk memanggil Delete Container kontainer yang memiliki sewa aktif, tentukan ID sewa di header ini. Jika header ini tidak ditentukan saat ada sewa aktif, Delete Container mengembalikan kesalahan 409 (Konflik). Jika Anda menentukan ID sewa yang salah, atau ID sewa pada kontainer yang tidak memiliki sewa aktif, Delete Container akan menampilkan kesalahan 412 (Prasyarat gagal).
x-ms-version	Diperlukan untuk semua permintaan resmi. Menentukan versi operasi yang akan digunakan untuk permintaan ini. Untuk informasi selengkapnya, lihat Pengelolaan versi untuk layanan Azure Storage.
x-ms-client-request-id	Optional. Menyediakan nilai buram yang dihasilkan klien dengan batas karakter 1 kibibyte (KiB) yang dicatat dalam log saat pengelogan dikonfigurasi. Kami sangat menyarankan Anda menggunakan header ini untuk menghubungkan aktivitas sisi klien dengan permintaan yang diterima server. Untuk informasi selengkapnya, lihat Memantau Azure Blob Storage.

Operasi ini juga mendukung penggunaan header bersyarat untuk menghapus kontainer hanya jika kondisi tertentu terpenuhi. Untuk informasi selengkapnya, lihat Menentukan header bersyarat untuk operasi Blob Storage.

Badan permintaan

None.

Permohonan sampel

Request Syntax:  
DELETE https://myaccount.blob.core.windows.net/mycontainer?restype=container HTTP/1.1  
  
Request Headers:  
x-ms-version: 2011-08-18  
x-ms-date: Sun, 25 Sep 2011 21:44:34 GMT  
Authorization: SharedKey devstoreaccount1:t7mf5htNuwLFX9g0S2LDdRtRn1FQzMAluBvHy1QPpnM=  

Jawaban

Respons mencakup kode status HTTP dan sekumpulan header respons.

Kode status

Operasi yang berhasil mengembalikan kode status 202 (Diterima). Untuk informasi tentang kode status, lihat Status dan kode kesalahan.

Tajuk respons

Respons untuk operasi ini mencakup header berikut. Respons juga dapat mencakup header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1 .

Respons Header	Deskripsi
x-ms-request-id	Header ini secara unik mengidentifikasi permintaan yang dibuat, dan dapat digunakan untuk memecahkan masalah permintaan. Untuk informasi selengkapnya, lihat Pemecahan Masalah operasi API.
x-ms-version	Menunjukkan versi Blob Storage yang digunakan untuk menjalankan permintaan. Header ini dikembalikan untuk permintaan yang dibuat terhadap versi 2009-09-19 dan yang lebih baru.
Date	Nilai tanggal/waktu UTC yang menunjukkan waktu di mana respons dimulai. Layanan menghasilkan nilai ini.
x-ms-client-request-id	Anda dapat menggunakan header ini untuk memecahkan masalah permintaan dan respons terkait. Nilai header ini sama dengan nilai x-ms-client-request-id header, jika ada dalam permintaan. Nilainya paling banyak 1.024 karakter ASCII yang terlihat. Jika header x-ms-client-request-id tidak ada dalam permintaan, header ini tidak akan ada dalam respons.

Isi respons

None.

Contoh tanggapan

Response Status:  
HTTP/1.1 202 Accepted  
  
Response Headers:  
Transfer-Encoding: chunked  
Content-Type: application/xml  
Date: Sun, 25 Sep 2011 21:45:00 GMT  
x-ms-version: 2011-08-18  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  

Authorization

Otorisasi diperlukan saat memanggil operasi akses data apa pun di Azure Storage. Anda dapat mengotorisasi operasi Delete Container seperti yang dijelaskan di bawah ini.

Important

Microsoft merekomendasikan penggunaan ID Microsoft Entra dengan identitas terkelola untuk mengotorisasi permintaan ke Azure Storage. MICROSOFT Entra ID menyediakan keamanan yang unggul dan kemudahan penggunaan dibandingkan dengan otorisasi Kunci Bersama.

ID Microsoft Entra (disarankan)

Azure Storage mendukung penggunaan ID Microsoft Entra untuk mengotorisasi permintaan ke data blob. Dengan Microsoft Entra ID, Anda dapat menggunakan pengendalian akses berbasis peran Azure (Azure RBAC) untuk memberikan hak akses kepada entitas keamanan. Prinsip keamanan mungkin pengguna, grup, perwakilan layanan aplikasi, atau identitas terkelola Azure. Prinsip keamanan diautentikasi oleh MICROSOFT Entra ID untuk mengembalikan token OAuth 2.0. Token kemudian dapat digunakan untuk mengotorisasi permintaan terhadap layanan Blob.

Untuk mempelajari selengkapnya tentang otorisasi menggunakan ID Microsoft Entra, lihat Mengotorisasi akses ke blob menggunakan ID Microsoft Entra.

Permissions

Tercantum di bawah ini adalah tindakan RBAC yang diperlukan untuk pengguna, grup, identitas terkelola, atau perwakilan layanan Microsoft Entra untuk memanggil operasi Delete Container, dan peran Azure RBAC bawaan yang paling tidak istimewa yang mencakup tindakan ini:

• Tindakan RBAC Azure:Microsoft. Storage/storageAccounts/blobServices/containers/delete
• Peran bawaan dengan hak istimewa paling rendah:Kontributor Data Blob Penyimpanan

Untuk mempelajari selengkapnya tentang menetapkan peran menggunakan Azure RBAC, lihat Menetapkan peran Azure untuk akses ke data blob.

Tanda tangan akses bersama (SAS) menyediakan akses yang didelegasikan dengan aman ke sumber daya di akun penyimpanan. Dengan SAS, Anda memiliki kontrol terperinci atas bagaimana klien dapat mengakses data. Anda dapat menentukan sumber daya apa yang dapat diakses klien, izin apa yang mereka miliki ke sumber daya tersebut, dan berapa lama SAS valid.

Operasi ini Delete Container mendukung otorisasi menggunakan SAS akun.

Ketika akses Kunci Bersama tidak diizinkan untuk akun penyimpanan, token SAS akun tidak akan diizinkan pada permintaan ke Blob Storage. Untuk mempelajari lebih lanjut, lihat Memahami bagaimana melarang Kunci Bersama memengaruhi token SAS.

Akun SAS

SAS akun diamankan dengan kunci akun penyimpanan. Akun SAS delegasikan akses ke sumber daya di satu atau beberapa layanan penyimpanan. Semua operasi yang tersedia melalui layanan atau delegasi pengguna SAS juga tersedia melalui akun SAS.

Tabel berikut menunjukkan jenis sumber daya yang ditandatangani dan izin yang ditandatangani untuk ditentukan saat mendelegasikan akses:

Pengoperasian	Layanan yang ditandatangani	Jenis sumber daya yang ditandatangani	Izin bertanda tangan
Hapus Kontainer	Gumpalan (b)	Kontainer (c)	Hapus (d)

Untuk mempelajari selengkapnya tentang akun SAS, lihat Membuat akun SAS.

Operasi Delete Container mendukung otorisasi Kunci Bersama . Otorisasi dengan kunci akun tidak disarankan untuk sebagian besar skenario, karena kurang aman.

Microsoft merekomendasikan untuk melarang otorisasi Kunci Bersama untuk akun penyimpanan jika memungkinkan. Untuk informasi selengkapnya, lihat Mencegah otorisasi dengan Kunci Bersama.

Remarks

Saat kontainer dihapus, kontainer dengan nama yang sama tidak dapat dibuat setidaknya selama 30 detik. Kontainer mungkin tidak tersedia selama lebih dari 30 detik jika layanan masih memproses permintaan. Saat kontainer sedang dihapus, upaya untuk membuat kontainer dengan nama yang sama gagal dengan kode status 409 (Konflik). Layanan menunjukkan bahwa kontainer sedang dihapus. Operasi pada blob dalam kontainer, termasuk pembacaan dan penulisan, dapat terus berhasil hingga 30 detik setelah permintaan penghapusan diterima. Setelah periode ini, semua operasi pada kontainer dan blob-nya gagal dengan kode status 404 (Tidak Ditemukan).

Billing

Akun penyimpanan tidak dikenakan biaya untuk Delete Container permintaan.

Baca juga

Kode status dan kesalahanKodekesalahan Blob StorageMenentukan header bersyarat untuk operasi Blob Storage