Get Properti Blob

Operasi mengembalikan Get Blob Properties semua metadata yang ditentukan pengguna, properti HTTP standar, dan properti sistem untuk blob. Ini tidak mengembalikan konten blob.

Minta

Anda dapat membuat Get Blob Properties permintaan sebagai berikut. Kami menyarankan agar Anda menggunakan HTTPS. Ganti myaccount dengan nama akun penyimpanan Anda.

URI permintaan metode HEAD	Versi HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime> https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>	HTTP/1.1

URI layanan penyimpanan yang ditimulasikan

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

URI permintaan metode HEAD	Versi HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob	HTTP/1.1

Untuk informasi selengkapnya, lihat Menggunakan Azure Storage Emulator untuk pengembangan dan pengujian.

Parameter URI

Anda dapat menentukan parameter tambahan berikut pada URI permintaan:

Parameter	Deskripsi
snapshot	Opsional. Parameter rekam jepret adalah nilai buram DateTime yang, ketika ada, menentukan rekam jepret blob untuk diambil. Untuk informasi selengkapnya tentang bekerja dengan rekam jepret blob, lihat Create rekam jepret blob.
versionid	Pilihan. Versi 2019-12-12 dan yang lebih baru. Parameter versionid adalah nilai buram DateTime yang, ketika ada, menentukan versi blob yang akan diambil.
timeout	Opsional. Parameter timeout dinyatakan dalam hitung detik. Untuk informasi selengkapnya, lihat Mengatur batas waktu untuk operasi Blob Storage.

Header permintaan

Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional.

Meminta kop	Deskripsi
Authorization	Wajib diisi. Menentukan skema otorisasi, nama akun, dan tanda tangan. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage.
Date atau x-ms-date	Wajib diisi. Menentukan Waktu Universal Terkoordinasi (UTC) untuk permintaan tersebut. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage.
x-ms-version	Diperlukan untuk semua permintaan yang diotorisasi. Opsional untuk permintaan anonim. Menentukan versi operasi yang akan digunakan untuk permintaan ini. Untuk informasi selengkapnya, lihat Penerapan versi untuk layanan Azure Storage.
x-ms-lease-id: <ID>	Opsional. Jika header ini ditentukan, Get Blob Properties operasi dilakukan hanya jika kedua kondisi berikut terpenuhi: - Sewa blob saat ini aktif. - ID sewa yang ditentukan dalam permintaan cocok dengan ID sewa blob. Jika salah satu kondisi ini tidak terpenuhi, permintaan gagal, dan Get Blob Properties operasi gagal dengan kode status 412 (Prasyarat Gagal).
x-ms-upn	Pilihan. Versi 2020-06-12 dan yang lebih baru. Valid untuk akun dengan namespace hierarki diaktifkan. Jika true, nilai identitas pengguna yang dikembalikan di x-ms-ownerheader , x-ms-group dan x-ms-acl respons akan diubah dari ID objek Microsoft Entra menjadi Nama Utama Pengguna. Jika nilainya false, nilai dikembalikan sebagai ID objek Microsoft Entra. Nilai defaultnya adalah salah. Perhatikan bahwa ID objek grup dan aplikasi tidak diterjemahkan, karena tidak memiliki nama ramah yang unik.
x-ms-client-request-id	Pilihan. Menyediakan nilai buram yang dihasilkan klien dengan batas karakter 1 kibibyte (KiB), yang dicatat dalam log analitik saat pengelogan analitik penyimpanan diaktifkan. Kami sangat menyarankan Anda menggunakan header ini saat Anda menghubungkan aktivitas sisi klien dengan permintaan yang diterima oleh server. Untuk informasi selengkapnya, lihat Tentang pengelogan Azure Storage Analytics.

Operasi ini juga mendukung penggunaan header kondisional untuk mengembalikan properti blob dan metadata hanya jika kondisi tertentu terpenuhi. Untuk informasi selengkapnya, lihat Menentukan header kondisional untuk operasi Blob Storage.

Header permintaan (kunci enkripsi yang disediakan pelanggan)

Pada versi 2019-02-02, Anda dapat menentukan header berikut pada permintaan untuk membaca blob yang dienkripsi dengan kunci yang disediakan pelanggan. Enkripsi dengan kunci yang disediakan pelanggan (dan set header yang sesuai) bersifat opsional. Jika blob sebelumnya telah dienkripsi dengan kunci yang disediakan pelanggan, Anda harus menyertakan header ini pada permintaan sehingga operasi baca dapat berhasil diselesaikan.

Meminta kop	Deskripsi
x-ms-encryption-key	Wajib diisi. Kunci enkripsi AES-256 yang dikodekan Base64.
x-ms-encryption-key-sha256	Opsional. Hash SHA256 yang dikodekan Base64 dari kunci enkripsi.
x-ms-encryption-algorithm: AES256	Wajib diisi. Menentukan algoritma yang akan digunakan untuk enkripsi. Nilai header ini harus AES256.

Isi permintaan

Tidak ada.

Respons

Respons mencakup kode status HTTP dan sekumpulan header respons.

Kode status

Operasi yang berhasil mengembalikan kode status 200 (OK).

Untuk informasi selengkapnya tentang kode status, lihat Kode status dan kesalahan.

Header respons

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

Header respons	Deskripsi
Last-Modified	Tanggal/waktu blob terakhir diubah. Format tanggal mengikuti RFC 1123. Untuk informasi selengkapnya, lihat Mewakili nilai tanggal/waktu di header. Setiap operasi yang memodifikasi blob, termasuk pembaruan metadata atau properti blob, mengubah waktu terakhir blob yang dimodifikasi.
x-ms-creation-time	Versi 2017-11-09 dan yang lebih baru. Tanggal/waktu saat blob dibuat. Format tanggal mengikuti RFC 1123. Untuk informasi selengkapnya, lihat Mewakili nilai tanggal/waktu di header.
x-ms-meta-name:value	Sekumpulan pasangan nama-nilai yang sesuai dengan metadata yang ditentukan pengguna yang terkait dengan blob ini.
x-ms-tag-count	Versi 2019-12-12 dan yang lebih baru. Jika blob memiliki tag, mengembalikan jumlah tag yang disimpan pada blob. Header ini tidak dikembalikan jika tidak ada tag pada blob.
x-ms-blob-type:<BlockBlob\|PageBlob\|AppendBlob>	Jenis blob.
x-ms-copy-completion-time:<datetime>	Versi 2012-02-12 dan yang lebih baru. Waktu kesimpulan dari operasi terakhir yang dicoba Copy Blob di mana blob ini adalah blob tujuan. Nilai ini dapat menentukan waktu upaya penyalinan yang selesai, dibatalkan, atau gagal. Header ini tidak muncul jika salinan tertunda, jika blob ini belum pernah menjadi Copy Blob tujuan dalam operasi, atau jika blob ini telah dimodifikasi setelah operasi yang disimpulkan Copy Blob yang menggunakan Set Blob Properties, , Put Blobatau Put Block List.
x-ms-copy-status-description: <error string>	Versi 2012-02-12 dan yang lebih baru. Hanya muncul saat x-ms-copy-status adalah failed atau pending. Menjelaskan penyebab kegagalan operasi penyalinan yang fatal atau tidak fatal. Header ini tidak muncul jika blob ini belum pernah menjadi tujuan dalam Copy Blob operasi, atau jika blob ini telah dimodifikasi setelah operasi yang disimpulkan Copy Blob yang menggunakan Set Blob Properties, , Put Blobatau Put Block List.
x-ms-copy-id: <id>	Versi 2012-02-12 dan yang lebih baru. Pengidentifikasi string untuk operasi terakhir yang dicoba Copy Blob , di mana blob ini adalah blob tujuan. Header ini tidak muncul jika blob ini belum pernah menjadi tujuan dalam Copy Blob operasi, atau jika blob ini telah dimodifikasi setelah operasi yang disimpulkan Copy Blob yang menggunakan Set Blob Properties, , Put Blobatau Put Block List.
x-ms-copy-progress: <bytes copied/bytes total>	Versi 2012-02-12 dan yang lebih baru. Berisi jumlah byte yang disalin dan total byte dalam sumber dalam operasi terakhir yang dicoba Copy Blob , di mana blob ini adalah blob tujuan. Dapat menampilkan dari 0 hingga Content-Length byte yang disalin. Header ini tidak muncul jika blob ini belum pernah menjadi tujuan dalam Copy Blob operasi, atau jika blob ini telah dimodifikasi setelah operasi yang disimpulkan Copy Blob yang menggunakan Set Blob Properties, , Put Blobatau Put Block List.
x-ms-copy-source: url	Versi 2012-02-12 dan yang lebih baru. PANJANG URL hingga 2 KiB yang menentukan blob sumber yang digunakan dalam operasi terakhir yang dicoba Copy Blob , di mana blob ini adalah blob tujuan. Header ini tidak muncul jika blob ini belum pernah menjadi tujuan dalam Copy Blob operasi, atau jika blob ini telah dimodifikasi setelah operasi yang disimpulkan Copy Blob yang menggunakan Set Blob Properties, , Put Blobatau Put Block List.
x-ms-copy-status: <pending \| success \| aborted \| failed>	Versi 2012-02-12 dan yang lebih baru. Status operasi salin yang diidentifikasi oleh x-ms-copy-id, dengan nilai-nilai ini: - success: Penyalinan berhasil diselesaikan. - pending: Penyalinan sedang berlangsung. Periksa apakah x-ms-copy-status-description kesalahan yang terputus-terputus dan tidak fatal menghambat kemajuan penyalinan tetapi tidak menyebabkan kegagalan. - aborted: Penyalinan diakhir oleh Abort Copy Blob. - failed: Penyalinan gagal. Lihat x-ms-copy-status-description untuk detail kegagalan. Header ini tidak muncul jika blob ini belum pernah menjadi tujuan dalam Copy Blob operasi, atau jika blob ini telah dimodifikasi setelah operasi selesai Copy Blob yang menggunakan Set Blob Properties, , Put Blobatau Put Block List.
x-ms-incremental-copy: true	Versi 2016-05-31 dan yang lebih baru. Disertakan jika blob adalah blob salinan inkremental.
x-ms-copy-destination-snapshot:<datetime>	Versi 2016-05-31 dan yang lebih baru. Disertakan jika blob adalah blob salinan bertahap atau salinan rekam jepret inkremental, jika x-ms-copy-status berhasil. Waktu rekam jepret salinan inkremental terakhir yang berhasil untuk blob ini.
x-ms-lease-duration: <infinite \| fixed>	Ketika blob disewakan, menentukan apakah sewa memiliki durasi tak terbatas atau tetap. Disertakan untuk permintaan yang menggunakan versi 2012-02-12 dan yang lebih baru.
x-ms-lease-state: <available \| leased \| expired \| breaking \| broken>	Status sewa blob. Disertakan untuk permintaan yang menggunakan versi 2012-02-12 dan yang lebih baru.
x-ms-lease-status:<locked\| unlocked>	Status sewa blob.
Content-Length	Ukuran blob dalam byte. Untuk blob halaman, header ini mengembalikan nilai x-ms-blob-content-length header yang disimpan dengan blob.
Content-Type	Jenis konten yang ditentukan untuk blob. Jika tidak ada tipe konten yang ditentukan, jenis konten defaultnya adalah application/octet-stream.
Etag	ETag berisi nilai yang dapat Anda gunakan untuk melakukan operasi secara kondisional. Untuk informasi selengkapnya, lihat Menentukan header kondisional untuk operasi Blob Storage. Jika versi permintaan adalah 2011-08-18 atau yang lebih baru, nilai ETag diapit dalam tanda kutip.
Content-MD5	Content-MD5 Jika header telah diatur untuk blob, header respons ini dikembalikan sehingga klien dapat memeriksa integritas konten pesan. Dalam versi 2012-02-12 dan yang lebih baru, Put Blob menetapkan nilai MD5 blob blok bahkan ketika Put Blob permintaan tidak menyertakan header MD5.
Content-Encoding	Content-Encoding Jika header permintaan sebelumnya telah diatur untuk blob, nilai tersebut dikembalikan di header ini.
Content-Language	Content-Language Jika header permintaan sebelumnya telah diatur untuk blob, nilai tersebut dikembalikan di header ini.
Content-Disposition	Content-Disposition Jika header permintaan sebelumnya telah ditetapkan untuk blob, nilai tersebut dikembalikan di header ini, untuk permintaan terhadap versi 2013-08-15 dan yang lebih baru. Bidang Content-Disposition header respons menyampaikan informasi tambahan tentang cara memproses payload respons, dan juga dapat digunakan untuk melampirkan metadata tambahan. Misalnya, jika header diatur ke attachment, itu menunjukkan bahwa agen pengguna tidak boleh menampilkan respons, tetapi sebaliknya menampilkan dialog Simpan Sebagai.
Cache-Control	Cache-Control Jika header permintaan sebelumnya telah diatur untuk blob, nilai tersebut dikembalikan di header ini.
x-ms-blob-sequence-number	Nomor urut saat ini untuk blob halaman. Header ini tidak dikembalikan untuk blob blok atau blob penambahan. Header ini tidak dikembalikan untuk blob blok.
x-ms-request-id	Header ini secara unik mengidentifikasi permintaan yang dibuat, dan Anda dapat menggunakannya untuk memecahkan masalah permintaan. Untuk informasi selengkapnya, lihat Memecahkan 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. Header ini juga dikembalikan untuk permintaan anonim tanpa versi tertentu jika kontainer ditandai untuk akses publik dengan menggunakan Blob Storage versi 2009-09-19.
Date	Nilai tanggal/waktu UTC yang dihasilkan oleh layanan yang menunjukkan waktu ketika respons dimulai.
Accept-Ranges: bytes	Menunjukkan bahwa layanan mendukung permintaan untuk konten blob parsial. Disertakan untuk permintaan yang dibuat menggunakan versi 2013-08-15 dan yang lebih baru.
x-ms-blob-committed-block-count	Jumlah blok yang diterapkan yang ada dalam blob. Header ini hanya dikembalikan untuk blob tambahan.
x-ms-server-encrypted: true/false	Versi 2015-12-11 dan yang lebih baru. Nilai header ini diatur ke true jika data blob dan metadata aplikasi sepenuhnya dienkripsi menggunakan algoritma yang ditentukan. Jika tidak, nilai diatur ke false (ketika blob tidak terenkripsi, atau jika hanya bagian dari metadata blob/aplikasi yang dienkripsi).
x-ms-encryption-key-sha256	Versi 2019-02-02 dan yang lebih baru. Header ini dikembalikan jika blob dienkripsi dengan kunci yang disediakan pelanggan.
x-ms-encryption-context	Versi 2021-08-06 dan yang lebih baru. Jika nilai properti konteks enkripsi diatur, nilai akan mengembalikan nilai yang ditetapkan. Hanya berlaku saat Namespace Hierarki diaktifkan untuk akun tersebut.
x-ms-encryption-scope	Versi 2019-02-02 dan yang lebih baru. Header ini dikembalikan jika blob dienkripsi dengan cakupan enkripsi.
x-ms-access-tier	Versi 2017-04-17 dan yang lebih baru. Tingkat blob halaman pada akun Penyimpanan Premium atau tingkat blob blok di Blob Storage atau akun v2 tujuan umum. Untuk daftar tingkat blob halaman premium yang diizinkan, lihat Penyimpanan Premium berkinerja tinggi dan disk terkelola untuk VM. Untuk penyimpanan blob atau akun tujuan umum v2, nilai yang valid adalah Hot, , CoolCold, dan Archive. Catatan:Cold tingkat didukung untuk versi 2021-12-02 dan yang lebih baru. Untuk informasi terperinci tentang tingkat blob blok akun blob standar, lihat Tingkat penyimpanan panas, dingin, dan arsip.
x-ms-access-tier-inferred: true	Versi 2017-04-17 dan yang lebih baru. Untuk blob halaman pada akun Penyimpanan Premium saja. Jika tingkat akses tidak diatur secara eksplisit pada blob, tingkatan disimpulkan berdasarkan panjang kontennya, dan header ini dikembalikan dengan nilai true. Untuk blob blok pada Blob Storage atau akun v2 tujuan umum, jika blob tidak memiliki set tingkat akses, Anda dapat menyimpulkan tingkat dari properti akun penyimpanan. Header ini diatur hanya jika tingkat blob blok disimpulkan.
x-ms-archive-status	Versi 2017-04-17 dan yang lebih baru. Untuk penyimpanan blob atau akun tujuan umum v2, nilai yang valid adalah rehydrate-pending-to-hot, rehydrate-pending-to-cool, dan rehydrate-pending-to-cold. Jika blob sedang direhidrasi dan tidak lengkap, header ini dikembalikan, yang keduanya menunjukkan bahwa rehidrasi tertunda dan menampilkan tingkat tujuan. Untuk informasi terperinci tentang tingkatan blob blok akun blob standar, lihat Tingkat penyimpanan panas, dingin, dan arsip.
x-ms-access-tier-change-time	Versi 2017-04-17 dan yang lebih baru. Menunjukkan terakhir kali tingkat diubah pada objek. Header ini dikembalikan hanya jika tingkat pada blob blok pernah diatur. Format tanggal mengikuti RFC 1123. Untuk informasi selengkapnya, lihat Mewakili nilai tanggal/waktu di header. Untuk informasi selengkapnya tentang tingkatan blob blok akun blob standar, lihat Tingkat penyimpanan panas, dingin, dan arsip.
x-ms-client-request-id	Dapat digunakan untuk memecahkan masalah permintaan dan respons yang sesuai. Nilai header ini sama dengan nilai x-ms-client-request-id header, jika ada dalam permintaan, dan nilainya paling banyak 1.024 karakter ASCII yang terlihat. x-ms-client-request-id Jika header tidak ada dalam permintaan, header ini tidak ada dalam respons.
x-ms-rehydrate-priority	Versi 2019-12-12 dan yang lebih baru. Jika objek dalam status tertunda rehidrasi, header ini dikembalikan dengan prioritas rehidrasi. Nilai yang valid adalah High/Standard. Untuk informasi terperinci tentang tingkat blob blok akun blob standar, lihat Tingkat penyimpanan panas, dingin, dan arsip.
x-ms-or-{policy-id}_{rule-id}	Versi 2019-12-12 dan yang lebih baru, hanya dikembalikan untuk blob blok. policy-id adalah nilai GUID yang mewakili pengidentifikasi kebijakan replikasi objek pada akun penyimpanan. rule-id adalah nilai GUID yang mewakili pengidentifikasi aturan kebijakan pada kontainer blob. Jika akun ObjectReplicationdiaktifkan, nilai header ini mewakili status replikasi blob dengan kebijakan dan pengidentifikasi aturan yang diberikan, baik complete atau failed.
x-ms-or-policy-id	Versi 2019-12-12 dan yang lebih baru, hanya dikembalikan untuk blob blok. Jika akun ObjectReplicationdiaktifkan, nilai header ini mewakili kebijakan yang mengatur replikasi.
x-ms-last-access-time	Versi 2020-02-10 dan yang lebih baru. Menunjukkan kapan terakhir kali data blob diakses berdasarkan kebijakan pelacakan waktu akses terakhir akun penyimpanan. Header tidak dikembalikan jika akun penyimpanan tidak memiliki kebijakan pelacakan waktu akses terakhir, atau kebijakan dinonaktifkan. Untuk informasi tentang mengatur kebijakan pelacakan waktu akses terakhir akun penyimpanan, lihat BLob Storage API.
x-ms-blob-sealed	Versi 2019-12-12 dan yang lebih baru, hanya dikembalikan untuk blob tambahan. Jika blob tambahan telah disegel, nilainya akan benar. Untuk informasi selengkapnya, lihat Menambahkan Blob Seal
x-ms-immutability-policy-until-date	Versi 2020-06-12 dan yang lebih baru. Menentukan tanggal 'retensi hingga' yang ditetapkan pada blob. Ini adalah tanggal hingga blob dapat dilindungi agar tidak dimodifikasi atau dihapus. Dikembalikan hanya jika kebijakan imutabilitas diatur pada blob. Nilai header ini RFC1123 format.
x-ms-immutability-policy-mode: unlocked/locked	Versi 2020-06-12 dan yang lebih baru. Mode kebijakan imutabilitas, dikembalikan jika kebijakan imutabilitas diatur pada blob. Nilainya adalah unlocked/locked. unlocked menunjukkan pengguna dapat mengubah kebijakan dengan meningkatkan atau mengurangi tanggal retensi hingga. locked menunjukkan bahwa tindakan ini dilarang.
x-ms-legal-hold: true/false	Versi 2020-06-12 dan yang lebih baru. Header ini tidak dikembalikan jika tidak ada penahanan legal pada blob. Nilai header ini diatur ke true jika blob berisi penahanan legal dan nilainya benar. Jika tidak, nilai diatur ke false jika blob berisi penahanan legal dan nilainya false.
x-ms-owner	Versi 2020-06-12 dan yang lebih baru. Hanya untuk akun dengan namespace hierarki diaktifkan. Mengembalikan pengguna pemilik file atau direktori.
x-ms-group	Versi 2020-06-12 dan yang lebih baru. Hanya untuk akun dengan namespace hierarki diaktifkan. Mengembalikan grup pemilik file atau direktori.
x-ms-permissions	Versi 2020-06-12 dan yang lebih baru. Hanya untuk akun dengan namespace hierarki diaktifkan. Mengembalikan izin yang diatur untuk pengguna, grup, dan lainnya pada file atau direktori. Setiap izin individu dalam [r,w,x,-]{3} format.
x-ms-acl	Versi 2023-11-03 dan yang lebih baru. Hanya untuk akun dengan namespace hierarki diaktifkan. Mengembalikan daftar gabungan akses dan daftar kontrol akses default yang diatur untuk pengguna, grup , dan lainnya pada file atau direktori. Setiap entri kontrol akses (ACE) terdiri dari cakupan, jenis, pengidentifikasi pengguna atau grup, dan izin dalam format [scope]:[type]:[id]:[permissions]. Cakupan default menunjukkan bahwa ACE milik ACL default untuk direktori; jika tidak, cakupannya implisit dan ACE milik ACL akses. Setiap izin individu dalam [r,w,x,-]{3} format.
x-ms-resource-type	Versi 2020-10-02 dan yang lebih baru. Hanya untuk akun dengan namespace hierarki diaktifkan. Mengembalikan jenis sumber daya untuk jalur, yang dapat berupa file atau directory.
x-ms-expiry-time	Versi 2020-02-10 dan yang lebih baru. Hanya untuk akun dengan namespace hierarki diaktifkan. Mengembalikan waktu kedaluwarsa yang diatur pada blob. Dikembalikan hanya untuk file yang memiliki waktu kedaluwarsa yang ditetapkan.

Isi Respons

Tidak ada.

Respons sampel

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-meta-Name: myblob.txt  
x-ms-meta-DateUploaded: <date>  
x-ms-blob-type: AppendBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CAE97120C1FF22"  
Accept-Ranges: bytes  
x-ms-blob-committed–block-count: 1  
x-ms-version: 2015-02-21  
Last-Modified: <date>  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6  
x-ms-copy-source: <url>  
x-ms-copy-status: success  
x-ms-copy-progress: 11/11  
x-ms-copy-completion-time: <date>  
  

Authorization

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

Penting

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

Microsoft Entra ID (disarankan)

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

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

Izin

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

• Tindakan Azure RBAC:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read
• Peran bawaan dengan hak istimewa paling sedikit:Pembaca 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)

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 Get Blob Properties mendukung tiga jenis tanda tangan akses bersama: SAS delegasi pengguna, SAS layanan, dan SAS akun.

Sebagai praktik terbaik keamanan, kami sarankan Anda menggunakan kredensial Microsoft Entra daripada kunci akun penyimpanan, yang dapat lebih mudah disusupi. Jika desain aplikasi Anda memerlukan tanda tangan akses bersama, gunakan kredensial Microsoft Entra untuk membuat SAS delegasi pengguna, jika memungkinkan.

Ketika akses Kunci Bersama tidak diizinkan untuk akun penyimpanan, token SAS layanan atau token SAS akun tidak akan diizinkan berdasarkan permintaan ke Blob Storage. Untuk mempelajari selengkapnya, lihat Memahami bagaimana melarang Kunci Bersama memengaruhi token SAS.

Delegasi pengguna SAS

DELEGASI pengguna SAS diamankan dengan kredensial Microsoft Entra dan juga oleh izin yang ditentukan untuk SAS.

Memanggil Get Blob Properties operasi menggunakan token SAS yang didelegasikan ke kontainer atau sumber daya blob memerlukan izin Baca (r) sebagai bagian dari token SAS delegasi pengguna.

Untuk mempelajari selengkapnya tentang delegasi pengguna SAS, lihat Create delegasi pengguna SAS.

Layanan SAS

Layanan SAS diamankan dengan kunci akun penyimpanan. SAS layanan mendelegasikan akses ke sumber daya dalam satu layanan Azure Storage, seperti penyimpanan blob.

Memanggil Get Blob Properties operasi menggunakan token SAS yang didelegasikan ke kontainer atau sumber daya blob memerlukan izin Baca (r) sebagai bagian dari token SAS layanan.

Untuk mempelajari selengkapnya tentang layanan SAS, lihat Create LAYANAN SAS.

Akun SAS

Akun SAS 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:

Operasi	Layanan yang ditandatangani	Jenis sumber daya yang ditandatangani	Izin yang ditandatangani
Get Properti Blob	Blob (b)	Objek (o)	Baca (r)

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

Kunci Bersama

Operasi ini Get Blob Properties 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.

Keterangan

Untuk menentukan apakah Copy Blob operasi telah selesai, pertama-tama periksa untuk memastikan bahwa x-ms-copy-id nilai header cocok dengan ID salinan yang disediakan oleh panggilan asli ke Copy Blob. Kecocokan memastikan bahwa aplikasi lain tidak membatalkan salinan dan memulai operasi baru Copy Blob . Selanjutnya, periksa x-ms-copy-status: success header. Tetapi ketahuilah bahwa semua operasi tulis pada blob kecuali Lease, , dan Put Block operasi menghapus semua x-ms-copy-* properti Put Pagedari blob. Properti ini juga tidak disalin oleh Copy Blob operasi yang menggunakan versi yang lebih lama dari 2012-02-12.

x-ms-copy-status-description berisi informasi lebih lanjut tentang kegagalan tersebut Copy Blob . Nilai x-ms-copy-status-description dijelaskan dalam tabel berikut ini:

Komponen	Deskripsi
Kode status HTTP	Bilangan bulat 3 digit standar yang menentukan kegagalan.
Kode kesalahan	Kata kunci yang menjelaskan kesalahan yang disediakan oleh Azure dalam <elemen ErrorCode> . Jika tidak ada <elemen ErrorCode> yang muncul, kata kunci dengan teks kesalahan standar yang terkait dengan kode status HTTP 3 digit dalam spesifikasi HTTP digunakan. Untuk informasi selengkapnya, lihat Kode kesalahan REST API umum.
Informasi	Deskripsi terperinci tentang kegagalan, diapit dalam tanda kutip.

Nilai x-ms-copy-status dan x-ms-copy-status-description skenario kegagalan umum dijelaskan dalam tabel berikut:

Penting

Deskripsi kesalahan berikut dapat berubah tanpa peringatan, bahkan tanpa perubahan versi, sehingga teks mungkin tidak sama persis.

Skenario	nilai x-ms-copy-status	nilai x-ms-copy-status-description
Operasi salin berhasil diselesaikan.	berhasil	kosong
Operasi penyalinan dibatalkan pengguna sebelum selesai.	Dibatalkan	kosong
Kegagalan terjadi ketika membaca dari blob sumber selama operasi salin, tetapi operasi akan dicoba kembali.	Tertunda	502 BadGateway "Mengalami kesalahan yang dapat diulang saat membaca sumbernya. Akan mencoba lagi. Waktu kegagalan: <waktu>"
Kegagalan terjadi saat menulis ke blob tujuan operasi salin, tetapi operasi akan dicoba kembali.	Tertunda	500 InternalServerError "Mengalami kesalahan yang dapat diulang. Akan mencoba lagi. Waktu kegagalan: <waktu>"
Kegagalan yang tidak dapat dipulihkan terjadi ketika membaca dari blob sumber operasi salin.	gagal	404 ResourceNotFound "Salin gagal saat membaca sumber." Catatan: Saat layanan melaporkan kesalahan yang mendasar ini, layanan akan kembali ResourceNotFound dalam <elemen ErrorCode> . Jika tidak ada <elemen ErrorCode> yang muncul dalam respons, representasi string standar dari status HTTP, seperti NotFound, akan muncul.
Periode batas waktu yang membatasi semua operasi penyalinan berlalu. (Saat ini, periode batas waktu adalah dua minggu.)	gagal	500 OperationCancelled "Salinan melebihi waktu maksimum yang diizinkan."
Operasi penyalinan gagal terlalu sering ketika membaca dari sumber, dan tidak memenuhi rasio minimum upaya untuk keberhasilan. (Batas waktu ini mencegah mencoba kembali sumber yang sangat buruk selama dua minggu sebelum gagal).	gagal	500 OperationCancelled "Salinan gagal saat membaca sumber."

x-ms-last-access-time melacak waktu saat data blob diakses, berdasarkan kebijakan pelacakan waktu akses terakhir akun penyimpanan. Mengakses metadata blob tidak mengubah waktu akses terakhirnya.

Billing

Permintaan harga dapat berasal dari klien yang menggunakan API Blob Storage, baik langsung melalui BLob Storage REST API, atau dari pustaka klien Azure Storage. Permintaan ini mengumpulkan biaya per transaksi. Jenis transaksi memengaruhi bagaimana akun ditagih. Misalnya, membaca transaksi bertambah ke kategori penagihan yang berbeda dari transaksi tulis. Tabel berikut ini memperlihatkan kategori penagihan untuk Get Blob Properties permintaan berdasarkan jenis akun penyimpanan:

Operasi	Jenis akun penyimpanan	Kategori penagihan
Get Properti Blob	Objek besar biner blok premium Tujuan umum standar v2	Operasi lainnya
Get Properti Blob	Tujuan umum standar v1	Membacakan operasi

Untuk mempelajari tentang harga untuk kategori penagihan yang ditentukan, lihat harga Azure Blob Storage.

Lihat juga

Mengotorisasi permintaan ke Azure Storage
Status dan kode galat
Kode kesalahan Blob Storage