Get Properti Blob

Artikel
02/03/2024

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 ditimulasi

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 permintaan URI:

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 Membuat 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 nilai identitas pengguna yang dikembalikan dalam `x-ms-owner` adalah true, nilai tersebut diubah dari ID objek Microsoft Entra menjadi nama utama pengguna. Jika nilainya salah, nilai dikembalikan sebagai ID objek Microsoft Entra. Nilai defaultnya adalah salah. Perhatikan bahwa ID objek grup dan aplikasi tidak diterjemahkan, karena tidak memiliki nama bersahabat 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 Status dan kode 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 Blob`atau `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 Blob`atau `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 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 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 Blob`atau `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 Blob`atau `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 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 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 `ObjectReplication`diaktifkan, 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`diaktifkan, 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 format [r,w,x,-]{3} .
`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.

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, atau perwakilan layanan yang 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) 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 SAS delegasi pengguna, lihat Membuat SAS delegasi pengguna.

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 Membuat 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 Membuat akun SAS.

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 Leaseoperasi , , Put Pagedan Put Block menghapus semua x-ms-copy-* properti dari 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
Pengguna membatalkan operasi salin 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 saat membaca dari blob sumber operasi salin.	gagal	404 ResourceNotFound "Salin gagal saat membaca sumber." Catatan: Ketika 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 salin gagal terlalu sering ketika membaca dari sumber, dan tidak memenuhi rasio minimum upaya untuk berhasil. (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 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 langsung melalui Blob Storage REST API, atau dari pustaka klien Azure Storage. Permintaan ini mengumpulkan biaya per transaksi. Jenis transaksi memengaruhi cara akun ditagih. Misalnya, transaksi baca 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