Dapatkan Properti Blob

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

Request

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

URI permintaan metode HEAD	HTTP version
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 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:

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

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

URI parameters

Anda dapat menentukan parameter tambahan berikut pada URI permintaan:

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

Request headers

Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional.

Request header	Description
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-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>	Optional. Jika header ini ditentukan, Get Blob Properties operasi hanya dilakukan 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	Optional. Versi 2020-06-12 dan yang lebih baru. Valid untuk akun dengan namespace hierarkis diaktifkan. Jika true, nilai identitas pengguna yang dikembalikan dalam x-ms-ownerheader respons dan respons akan x-ms-groupx-ms-acl diubah dari ID objek Microsoft Entra menjadi Nama Utama Pengguna. Jika nilainya salah, mereka dikembalikan sebagai ID objek Microsoft Entra. Nilai default-nya adalah salah. Perhatikan bahwa ID objek grup dan aplikasi tidak diterjemahkan, karena tidak memiliki nama ramah yang unik.
x-ms-client-request-id	Optional. 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 bersyarat 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 kumpulan 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.

Request header	Description
x-ms-encryption-key	Required. Kunci enkripsi AES-256 yang dikodekan Base64.
x-ms-encryption-key-sha256	Optional. Hash SHA256 yang dikodekan Base64 dari kunci enkripsi.
x-ms-encryption-algorithm: AES256	Required. Menentukan algoritma yang akan digunakan untuk enkripsi. Nilai header ini harus AES256.

Request body

None.

Response

Respons mencakup kode status HTTP dan sekumpulan header respons.

Status code

Operasi yang berhasil mengembalikan kode status 200 (OK).

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

Response headers

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 .

Response header	Description
Last-Modified	Tanggal/waktu gumpalan 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 modifikasi terakhir blob. Perhatikan bahwa Last-Modified tidak akan dikembalikan untuk disk terkelola dan rekam jepret disk terkelola yang lebih besar dari 4 TiB.
x-ms-creation-time	Versi 2017-11-09 dan yang lebih baru. Tanggal/waktu ketika 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 apa pun, 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 percobaan Copy Blob terakhir 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 tidak 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 Blob, atau Put Block List.
x-ms-copy-status-description: <error string>	Versi 2012-02-12 dan yang lebih baru. Muncul hanya 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 tidak 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 Blob, atau Put Block List.
x-ms-copy-id: <id>	Versi 2012-02-12 dan yang lebih baru. Pengidentifikasi string untuk operasi percobaan Copy Blob terakhir, di mana blob ini adalah blob tujuan. Header ini tidak muncul jika blob ini tidak 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 Blob, atau 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 percobaan Copy Blob terakhir, di mana blob ini adalah blob tujuan. Dapat menampilkan dari 0 hingga Content-Length byte yang disalin. Header ini tidak muncul jika blob ini tidak 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 Blob, atau Put Block List.
x-ms-copy-source: url	Versi 2012-02-12 dan yang lebih baru. URL dengan panjang hingga 2 KiB yang menentukan blob sumber yang digunakan dalam operasi percobaan Copy Blob terakhir, di mana blob ini adalah blob tujuan. Header ini tidak muncul jika blob ini tidak 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 Blob, atau Put Block List.
x-ms-copy-status: <pending \| success \| aborted \| failed>	Versi 2012-02-12 dan yang lebih baru. Status operasi penyalinan yang diidentifikasi oleh x-ms-copy-id, dengan nilai-nilai berikut: - success: Salinan berhasil selesai. - pending: Penyalinan sedang berlangsung. Periksa x-ms-copy-status-description apakah error intermiten dan non-fatal menghalangi kemajuan penyalinan tetapi tidak menyebabkan kegagalan. - aborted: Salinan diakhiri dengan Abort Copy Blob. - failed: Penyalinan gagal. Lihat x-ms-copy-status-description untuk detail kegagalan. Header ini tidak muncul jika blob ini tidak pernah menjadi tujuan dalam Copy Blob operasi, atau jika blob ini telah dimodifikasi setelah operasi selesai Copy Blob yang menggunakan Set Blob Properties, Put Blob, atau 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 inkremental atau rekam jepret salinan 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 tidak terbatas atau durasi 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 gumpalan. Disertakan untuk permintaan yang menggunakan versi 2012-02-12 dan yang lebih baru.
x-ms-lease-status:<locked\| unlocked>	Status sewa gumpalan.
Content-Length	Ukuran blob dalam satuan 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, tipe konten default 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	Jika Content-MD5 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 atur nilai MD5 blob blok bahkan ketika Put Blob permintaan tidak menyertakan header MD5.
Content-Encoding	Jika Content-Encoding header permintaan sebelumnya telah diatur untuk blob, nilai tersebut dikembalikan dalam header ini.
Content-Language	Jika Content-Language header permintaan sebelumnya telah diatur untuk blob, nilai tersebut dikembalikan dalam header ini.
Content-Disposition	Jika Content-Disposition header permintaan sebelumnya telah diatur untuk blob, nilai tersebut dikembalikan di header ini, untuk permintaan terhadap versi 2013-08-15 dan yang lebih baru. Content-Disposition Bidang header respons menyampaikan informasi tambahan tentang cara memproses payload respons, dan juga dapat digunakan untuk melampirkan metadata tambahan. Misalnya, jika header diatur ke attachment, ini menunjukkan bahwa agen pengguna tidak boleh menampilkan respons, melainkan menampilkan dialog Simpan Sebagai.
Cache-Control	Jika Cache-Control header permintaan sebelumnya telah diatur untuk blob, nilai tersebut dikembalikan dalam 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. Termasuk 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 dikembalikan hanya 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 algoritme yang ditentukan. Jika tidak, nilainya diatur ke false (saat blob tidak dienkripsi, 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 valid 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 Premium Storage 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, Cool, Cold, dan Archive. Catatan: tingkatCold didukung untuk versi 2021-12-02 dan yang lebih baru. Untuk informasi terperinci tentang tingkatan 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 hanya pada akun Premium Storage. Jika tingkat akses tidak diatur secara eksplisit pada blob, tingkat disimpulkan berdasarkan panjang kontennya, dan header ini dikembalikan dengan nilai true. Untuk blob blok di Blob Storage atau akun v2 tujuan umum, jika blob tidak memiliki tingkat akses yang ditetapkan, 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 v2 tujuan umum, 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 tingkat 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 tingkat 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. Jika header x-ms-client-request-id 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 High/Standard. Untuk informasi terperinci tentang tingkatan 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 - ObjectReplicationenabled, 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 ObjectReplication-enabled, nilai header ini mewakili kebijakan yang mengatur replikasi.
x-ms-last-access-time	Versi 2020-02-10 dan yang lebih baru. Menunjukkan 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 API Penyimpanan Blob.
x-ms-blob-sealed	Versi 2019-12-12 dan yang lebih baru, hanya dikembalikan untuk blob penambahan. Jika blob penambahan telah disegel, nilainya akan benar. Untuk informasi selengkapnya, lihat Menambahkan Segel Blob
x-ms-immutability-policy-until-date	Versi 2020-06-12 dan yang lebih baru. Menentukan tanggal 'retensi sampai' yang ditetapkan pada blob. Ini adalah tanggal hingga blob dapat dilindungi agar tidak dimodifikasi atau dihapus. Dikembalikan hanya jika kebijakan kekekalan diatur pada blob. Nilai header ini adalah format RFC1123.
x-ms-immutability-policy-mode: unlocked/locked	Versi 2020-06-12 dan yang lebih baru. Mode kebijakan kekebalan, dikembalikan jika kebijakan kekekalan diatur pada blob. Nilainya adalah unlocked/locked. unlocked Menunjukkan pengguna dapat mengubah kebijakan dengan menambah atau mengurangi tanggal retensi-to. 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 penangguhan hukum pada blob. Nilai header ini diatur ke true jika blob berisi penahanan hukum dan nilainya true. Jika tidak, nilai diatur ke false jika blob berisi pembekuan hukum dan nilainya false.
x-ms-owner	Versi 2020-06-12 dan yang lebih baru. Hanya untuk akun dengan namespace hierarkis diaktifkan. Mengembalikan pengguna pemilik file atau direktori.
x-ms-group	Versi 2020-06-12 dan yang lebih baru. Hanya untuk akun dengan namespace hierarkis diaktifkan. Mengembalikan grup pemilik file atau direktori.
x-ms-permissions	Versi 2020-06-12 dan yang lebih baru. Hanya untuk akun dengan namespace hierarkis diaktifkan. Mengembalikan izin yang diatur untuk pengguna, grup, dan lainnya pada file atau direktori. Setiap izin individual dalam [r,w,x,-]{3} format.
x-ms-acl	Versi 2023-11-03 dan yang lebih baru. Hanya untuk akun dengan namespace hierarkis 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 menunjukkan default bahwa ACE termasuk dalam ACL default untuk direktori; jika tidak, cakupan bersifat implisit dan ACE milik ACL akses. Setiap izin individual dalam [r,w,x,-]{3} format.
x-ms-resource-type	Versi 2020-10-02 dan yang lebih baru. Hanya untuk akun dengan namespace hierarkis yang 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 hierarkis yang diaktifkan. Mengembalikan waktu kedaluwarsa yang diatur pada blob. Hanya dikembalikan untuk file yang memiliki waktu kedaluwarsa yang ditetapkan.

Response body

None.

Sample response

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 Get Blob Properties 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 kontrol akses berbasis peran Azure (Azure RBAC) untuk memberikan izin kepada prinsip 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 Get Blob Properties, 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 rendah: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) 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 Get Blob Properties mendukung tiga jenis tanda tangan akses bersama: delegasi pengguna SAS, layanan SAS, dan akun SAS.

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 lebih lanjut, lihat Memahami bagaimana melarang Kunci Bersama memengaruhi token SAS.

Delegasi pengguna SAS

SAS delegasi pengguna diamankan oleh kredensial Microsoft Entra serta 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 SAS delegasi pengguna, lihat Membuat delegasi pengguna SAS.

Service SAS

SAS layanan diamankan menggunakan 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 Membuat layanan SAS.

Account 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:

Operation	Signed service	Jenis sumber daya yang ditandatangani	Signed permission
Dapatkan Properti Blob	Blob (b)	Object (o)	Read (r)

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

Shared key

Operasi 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.

Remarks

Untuk menentukan apakah Copy Blob operasi telah selesai, periksa terlebih dahulu 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 headernya x-ms-copy-status: success . Namun perlu diketahui 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 sebelumnya dari 2012-02-12.

x-ms-copy-status-description Berisi informasi selengkapnya tentang Copy Blob kegagalan. Nilainya x-ms-copy-status-description dijelaskan dalam tabel berikut:

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

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

Important

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

Scenario	x-ms-copy-status value	x-ms-copy-status-description value
Operasi salin berhasil diselesaikan.	success	empty
Pengguna membatalkan operasi penyalinan sebelum selesai.	aborted	empty
Kegagalan terjadi saat membaca dari blob sumber selama operasi penyalinan, tetapi operasi akan dicoba ulang.	pending	502 BadGateway "Mengalami kesalahan yang dapat diulang saat membaca sumbernya. Will retry. Waktu kegagalan: <waktu>"
Kegagalan terjadi saat menulis ke blob tujuan operasi salinan, tetapi operasi akan dicoba ulang.	pending	500 InternalServerError "Mengalami kesalahan yang dapat diulang. Will retry. Waktu kegagalan: <waktu>"
Kegagalan yang tidak dapat dipulihkan terjadi ketika membaca dari blob sumber operasi salin.	failed	404 ResourceNotFound "Salinan gagal saat membaca sumber." Catatan: Saat layanan melaporkan kesalahan yang mendasarinya ini, layanan akan kembali ResourceNotFound ke <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.)	failed	500 OperationCancelled "Salinan melebihi waktu maksimum yang diizinkan."
Operasi penyalinan terlalu sering gagal saat membaca dari sumber, dan tidak memenuhi rasio minimum upaya terhadap keberhasilan. (Batas waktu ini mencegah mencoba kembali sumber yang sangat buruk selama dua minggu sebelum gagal).	failed	500 OperationCancelled "Salinan gagal saat membaca sumber."

x-ms-last-access-time melacak waktu ketika 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 secara 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, transaksi baca bertambah ke kategori penagihan yang berbeda dari transaksi tulis. Tabel berikut ini memperlihatkan kategori penagihan untuk permintaan Get Blob Properties berdasarkan jenis akun penyimpanan:

Operation	Jenis akun penyimpanan	Billing category
Dapatkan Properti Blob	Objek besar biner blok premium Standar tujuan umum versi 2	Other operations
Dapatkan Properti Blob	Standar tujuan umum v1	Read operations

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

See also

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