Bekerja dengan kontainer akar
Kontainer root berfungsi sebagai kontainer default untuk akun penyimpanan Anda. Akun penyimpanan mungkin memiliki satu kontainer akar. Kontainer akar harus dibuat secara eksplisit dan harus diberi nama $root.
Blob yang disimpan dalam kontainer akar dapat diatasi tanpa merujuk nama kontainer akar, sehingga blob dapat diatasi di tingkat atas hierarki akun penyimpanan. Misalnya, Anda dapat mereferensikan blob yang berada di kontainer akar dengan cara berikut:
https://myaccount.blob.core.windows.net/mywebpage.html
Mengelola Kontainer Akar
Untuk menggunakan kontainer root dengan akun penyimpanan Anda, buat kontainer baru bernama $root. Contoh permintaan berikut menunjukkan cara membuat kontainer akar:
Request Syntax:
PUT https://myaccount.blob.core.windows.net/$root?restype=container HTTP/1.1
Request Headers:
x-ms-version: 2011-08-18
x-ms-date: Sun, 25 Sep 2011 22:50:32 GMT
x-ms-meta-Name: StorageSample
x-ms-blob-public-access: container
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
Anda juga dapat menghapus kontainer root jika Anda tidak lagi membutuhkannya.
Seperti kontainer lain, kontainer akar dapat disediakan untuk akses publik anonim. Anda dapat membuat kontainer menjadi publik dengan mengatur x-ms-blob-public-access header saat kontainer dibuat, atau dengan memanggil Set Container ACL setelah sudah ada. Lihat Membatasi Akses ke Kontainer dan Blob untuk informasi selengkapnya.
Jika kontainer akar ada, kontainer akan muncul saat Anda melakukan operasi Daftar Kontainer terhadap akun penyimpanan.
Saat Anda melakukan operasi Daftar Blob terhadap kontainer akar, kontainer akar tidak muncul di URL sumber daya untuk blob yang dikembalikan. Sintaks permintaan berikut menunjukkan cara memanggil List Blobs terhadap kontainer akar:
GET https://myaccount.blob.core.windows.net/$root?restype=container&comp=list HTTP/1.1
Penting
Blob dalam kontainer akar tidak dapat menyertakan garis miring (/) dalam namanya.
Contoh
Contoh berikut menunjukkan cara bekerja dengan sumber daya kontainer dan blob, termasuk kontainer root:
Operasi GET
Untuk mencantumkan kontainer di akun penyimpanan:
GET https://myaccount.blob.core.windows.net/?comp=list
Untuk mendapatkan properti kontainer:
GET/HEAD https://myaccount.blob.core.windows.net/mycontainer?restype=container
Untuk mencantumkan blob dalam kontainer bernama mycontainer:
GET https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list
Untuk mencantumkan blob dalam kontainer akar:
GET https://myaccount.blob.core.windows.net/$root?restype=container&comp=list
Untuk membaca blob bernama myfile dari kontainer bernama mycontainer:
GET https://myaccount.blob.core.windows.net/mycontainer/myfile
Untuk membaca blob bernama myphoto dari kontainer akar:
GET https://myaccount.blob.core.windows.net/myphoto
Anda juga dapat secara eksplisit mereferensikan kontainer akar:
GET https://myaccount.blob.core.windows.net/$root/myphoto
Untuk membaca metadata blob pada blob di kontainer akar:
GET https://myaccount.blob.core.windows.net/myphoto?comp=metadata
Anda juga dapat secara eksplisit mereferensikan kontainer akar:
GET https://myaccount.blob.core.windows.net/$root/myphoto?comp=metadata
Catatan
Berhati-hatilah untuk menghindari termasuk garis miring ke depan (/) saat mereferensikan blob di bawah kontainer akar. Misalnya, URL seperti berikut ini sekarang menghasilkan kode status 400 (Permintaan Buruk):
https://myaccount.blob.core.windows.net/myblob/
Dalam contoh di atas, blob service membaca nama kontainer sebagai myblob dan mengharapkan untuk melihat nama blob setelah garis miring berikutnya. Permintaan salah format karena nama blob yang hilang.
URL berikut berlaku untuk operasi pada blob di kontainer akar:
https://myaccount.blob.core.windows.net/myblob
Operasi PUT
Untuk membuat kontainer bernama mycontainer:
PUT https://myaccount.blob.core.windows.net/mycontainer?restype=container
Untuk membuat blob bernama myblob dalam kontainer akar:
PUT https://myaccount.blob.core.windows.net/myblob
Anda juga dapat secara eksplisit menentukan kontainer akar:
PUT https://myaccount.blob.core.windows.net/$root/myblob
Untuk membuat blob bernama myblob dalam kontainer bernama mycontainer:
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob
Untuk membuat blob bernama photos/myphoto dalam kontainer bernama mycontainer:
PUT https://myaccount.blob.core.windows.net/mycontainer/photos/myphoto
Untuk mengatur metadata pada blob bernama myblob dalam kontainer akar:
PUT https://myaccount.blob.core.windows.net/myblob?comp=metadata
Operasi DELETE
Untuk menghapus kontainer bernama mycontainer:
DELETE https://myaccount.blob.core.windows.net/mycontainer?restype=container
Untuk menghapus kontainer akar:
DELETE https://myaccount.blob.core.windows.net/$root?restype=container
Untuk menghapus blob myblob dari kontainer akar:
DELETE https://myaccount.blob.core.windows.net/myblob
Anda juga dapat secara eksplisit menentukan kontainer akar:
DELETE https://myaccount.blob.core.windows.net/$root/myblob
Lihat juga
Operasi HTTP pada Sumber Daya Blob Service
Penamaan dan Referensi Kontainer, Blob, dan Metadata
Penerapan versi untuk Azure Storage Services