Bagikan melalui

Mengatur dan mengambil properti dan metadata untuk sumber daya Blob service

  • Artikel

Kontainer dan blob mendukung metadata kustom, yang diwakili sebagai header HTTP. Header metadata dapat diatur pada permintaan yang membuat kontainer atau sumber daya blob baru, atau atas permintaan yang secara eksplisit membuat properti pada sumber daya yang ada.

Topik ini berisi subtopik berikut:

Metadata Header Format

Operasi pada Metadata

Properti HTTP Standar untuk Kontainer dan Blob

Blob juga mendukung tag, jenis khusus metadata kustom yang secara otomatis diindeks oleh blob service. Untuk informasi selengkapnya, lihat Mengelola dan menemukan data di Azure Blob Storage dengan Indeks Blob.

Metadata Header Format

Header metadata adalah pasangan nama/nilai. Format untuk header adalah:

x-ms-meta-name:string-value

Dimulai dengan versi 2009-09-19, nama metadata harus mematuhi aturan penamaan untuk pengidentifikasi C#.

Nama tidak peka huruf besar/kecil. Perhatikan bahwa nama metadata mempertahankan huruf besar/kecil seperti saat dibuat, tetapi tidak peka huruf besar/kecil saat diatur atau dibaca. Jika dua atau beberapa header metadata dengan nama yang sama dikirimkan untuk sumber daya, layanan Blob mengembalikan kode status 400 (Permintaan Buruk).

Metadata terdiri dari pasangan nama/nilai. Ukuran total semua pasangan metadata bisa mencapai 8 KB.

Nama metadata/pasangan nilai adalah header HTTP yang valid, sehingga mematuhi semua pembatasan yang mengatur header HTTP.

Operasi pada Metadata

Metadata pada blob atau sumber daya kontainer dapat diambil atau diatur secara langsung, tanpa menampilkan atau mengubah konten sumber daya.

Perhatikan bahwa nilai metadata hanya dapat dibaca atau ditulis secara lengkap; pembaruan sebagian tidak didukung. Mengatur metadata pada sumber daya menimpa nilai metadata yang ada untuk sumber daya tersebut.

Mengambil Properti dan Metadata

Operasi GET dan HEAD mengambil header metadata untuk kontainer atau blob yang ditentukan. Operasi HEAD hanya mengembalikan header; ini tidak mengembalikan isi respons.

Sintaksis URI untuk mengambil header metadata pada kontainer adalah sebagai berikut:

GET/HEAD https://myaccount.blob.core.windows.net/mycontainer?restype=container

Sintaksis URI untuk mengambil header metadata pada blob adalah sebagai berikut:

GET/HEAD https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata

Menyetel Header Metadata

Operasi PUT menetapkan header metadata pada kontainer atau blob yang ditentukan, menimpa metadata yang ada pada sumber daya. Memanggil PUT tanpa header pada permintaan menghapus semua metadata yang ada pada sumber daya.

Sintaksis URI untuk mengatur header metadata pada kontainer adalah sebagai berikut:

PUT https://myaccount.blob.core.windows.net/mycontainer?comp=metadata?restype=container

Sintaksis URI untuk mengatur header metadata pada blob adalah sebagai berikut:

PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata

Properti HTTP Standar untuk Kontainer dan Blob

Kontainer dan blob juga mendukung properti HTTP standar tertentu. Properti dan metadata direpresentasikan sebagai header HTTP standar; perbedaannya adalah dalam penamaan header. Header metadata diberi nama dengan awalan header x-ms-meta- dan nama kustom. Header properti menggunakan nama header HTTP standar, seperti yang ditentukan di bagian Definisi Bidang Header 14 dari spesifikasi protokol HTTP/1.1.

Header HTTP standar yang didukung pada kontainer mencakup:

  • ETag

  • Last-Modified

Header HTTP standar yang didukung pada blob mencakup:

  • ETag

  • Last-Modified

  • Content-Length

  • Content-Type

  • Content-MD5

  • Content-Encoding

  • Content-Language

  • Cache-Control

  • Origin

  • Range

Lihat juga

Buat Kontainer
Mendapatkan Properti Kontainer
Mengatur Metadata Kontainer
Masukkan Blob
Copy Blob
Get Properti Blob
Get Metadata Blob
Set Metadata Blob
Konsep Blob Service
Mengelola dan menemukan data di Azure Blob Storage dengan Indeks Blob