Bekerja dengan kontainer akar

Artikel
06/27/2023

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