Get Blob

Artikel
03/16/2023

Operasi membaca Get Blob atau mengunduh blob dari sistem, termasuk metadata dan propertinya. Anda juga dapat memanggil Get Blob untuk membaca rekam jepret.

Minta

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

URI permintaan metode GET	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.0 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 GET	Versi HTTP
`http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob`	HTTP/1.0 HTTP/1.1

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

Parameter URI

Parameter tambahan berikut dapat ditentukan pada URI permintaan:

Parameter	Deskripsi
`snapshot`	Opsional. 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`	Opsional, versi 2019-12-12 dan yang lebih baru. Parameter `versionid` adalah nilai buram `DateTime` yang, ketika ada, menentukan versi blob yang akan diambil.
`timeout`	Pilihan. 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. Jika header ini dihilangkan untuk permintaan anonim, maka layanan menjalankan permintaan dengan versi 2009-09-19. Untuk informasi selengkapnya, lihat Penerapan versi untuk layanan Azure Storage.
`Range`	Opsional. Mengembalikan byte blob hanya dalam rentang yang ditentukan.
`x-ms-range`	Pilihan. Mengembalikan byte blob hanya dalam rentang yang ditentukan. Jika dan `Rangex-ms-range` ditentukan, layanan menggunakan nilai `x-ms-range`. Jika tidak ada rentang yang ditentukan, seluruh konten blob akan dikembalikan. Untuk informasi selengkapnya, lihat Menentukan header rentang untuk operasi Blob Storage.
`x-ms-lease-id: <ID>`	Pilihan. Jika header ini ditentukan, 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 header ini ditentukan tetapi salah satu kondisi ini tidak terpenuhi, permintaan gagal dan `Get Blob` operasi gagal dengan kode status 412 (Prasyarat Gagal).
`x-ms-range-get-content-md5: true`	Pilihan. Ketika header ini diatur ke `true` dan ditentukan bersama dengan `Range` header, layanan mengembalikan hash MD5 untuk rentang, selama rentangnya berukuran kurang dari atau sama dengan 4 mebibyte (MiB). Jika header ditentukan tanpa `Range` header, layanan mengembalikan kode status 400 (Permintaan Buruk). Jika header diatur ke `true` saat rentang melebihi 4 MiB, layanan mengembalikan kode status 400 (Permintaan Buruk).
`x-ms-range-get-content-crc64: true`	Pilihan. Ketika header ini diatur ke `true` dan ditentukan bersama dengan `Range` header, layanan mengembalikan hash CRC64 untuk rentang, selama rentangnya berukuran kurang dari atau sama dengan 4 MiB. Jika header ditentukan tanpa `Range` header, layanan mengembalikan kode status 400 (Permintaan Buruk). Jika header diatur ke `true` saat rentang melebihi 4 MiB, layanan mengembalikan kode status 400 (Permintaan Buruk). Jika header `x-ms-range-get-content-md5` dan `x-ms-range-get-content-crc64` ada, permintaan gagal dengan 400 (Permintaan Buruk). Header ini didukung dalam versi 2019-02-02 dan yang lebih baru.
`Origin`	Pilihan. Menentukan asal dari mana permintaan dikeluarkan. Kehadiran header ini menghasilkan header berbagi sumber daya lintas asal (CORS) pada respons.
`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 membaca blob 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 untuk menyelesaikan operasi baca dengan sukses.

Meminta kop	Deskripsi
`x-ms-encryption-key`	Wajib diisi. Kunci enkripsi AES-256 yang dikodekan Base64.
`x-ms-encryption-key-sha256`	Pilihan. 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, sekumpulan header respons, dan isi respons, yang berisi konten blob.

Kode status

Operasi yang berhasil untuk membaca blob lengkap mengembalikan kode status 200 (OK).

Operasi yang berhasil membaca rentang tertentu mengembalikan kode status 206 (Konten Parsial).

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

Header respons

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

Sintaks	Deskripsi
`Last-Modified`	Tanggal/waktu saat blob terakhir diubah. Format tanggal mengikuti RFC 1123. Setiap operasi yang memodifikasi blob, termasuk pembaruan metadata atau properti blob, mengubah waktu blob yang terakhir dimodifikasi.
`x-ms-creation-time`	Versi 2017-11-09 dan yang lebih baru. Tanggal/waktu saat blob dibuat. Format tanggal mengikuti RFC 1123.
`x-ms-meta-name:value`	Sekumpulan pasangan nama-nilai yang terkait dengan blob ini sebagai metadata yang ditentukan pengguna.
`x-ms-tag-count`	Versi 2019-12-12 dan yang lebih baru. Jika blob memiliki tag, header ini mengembalikan jumlah tag yang disimpan pada blob. Header tidak dikembalikan jika tidak ada tag pada blob.
`Content-Length`	Jumlah byte yang ada dalam isi respons.
`Content-Type`	Jenis konten yang ditentukan untuk blob. Jenis konten default adalah `application/octet-stream`.
`Content-Range`	Menunjukkan rentang byte yang dikembalikan jika klien meminta subset blob dengan mengatur `Range` header permintaan.
`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 blob memiliki hash MD5 dan operasi ini `Get Blob` adalah membaca blob lengkap, header respons ini dikembalikan sehingga klien dapat memeriksa integritas konten pesan. Dalam versi 2012-02-12 dan yang lebih baru, `Put Blob` menetapkan nilai hash MD5 blob blok bahkan ketika `Put Blob` permintaan tidak menyertakan header MD5. Jika permintaan adalah membaca rentang yang ditentukan dan `x-ms-range-get-content-md5` diatur ke `true`, permintaan mengembalikan hash MD5 untuk rentang, selama ukuran rentang kurang dari atau sama dengan 4 MiB. Jika tidak satu pun dari kumpulan kondisi ini adalah `true`, tidak ada nilai yang dikembalikan untuk `Content-MD5` header . Jika `x-ms-range-get-content-md5` ditentukan tanpa `Range` header, layanan mengembalikan kode status 400 (Permintaan Buruk). Jika `x-ms-range-get-content-md5` diatur ke `true` ketika rentang melebihi 4 MiB, layanan mengembalikan kode status 400 (Permintaan Buruk).
`x-ms-content-crc64`	Jika permintaan adalah membaca rentang yang ditentukan dan `x-ms-range-get-content-crc64` diatur ke `true`, permintaan mengembalikan hash CRC64 untuk rentang, selama ukuran rentang kurang dari atau sama dengan 4 MiB. Jika `x-ms-range-get-content-crc64` ditentukan tanpa `Range` header, layanan mengembalikan kode status 400 (Permintaan Buruk). Jika `x-ms-range-get-content-crc64` diatur ke `true` ketika rentang melebihi 4 MiB, layanan mengembalikan kode status 400 (Permintaan Buruk).
`Content-Encoding`	Mengembalikan nilai yang ditentukan untuk `Content-Encoding` header permintaan.
`Content-Language`	Mengembalikan nilai yang ditentukan untuk `Content-Language` header permintaan.
`Cache-Control`	Dikembalikan jika header sebelumnya ditentukan untuk blob.
`Content-Disposition`	Dikembalikan untuk permintaan terhadap versi 2013-08-15 dan yang lebih baru. Header ini mengembalikan nilai yang ditentukan untuk `x-ms-blob-content-disposition` header . Bidang `Content-Disposition` header respons menyampaikan informasi tambahan tentang cara memproses payload respons, dan dapat digunakan untuk melampirkan metadata tambahan. Misalnya, jika header diatur ke `attachment`, itu menunjukkan bahwa agen pengguna tidak boleh menampilkan respons. Sebaliknya, ini menunjukkan dialog Simpan Sebagai dengan nama file selain nama blob yang ditentukan.
`x-ms-blob-sequence-number`	Nomor urut saat ini untuk blob halaman. Header ini tidak dikembalikan untuk blob blok atau blob penambahan.
`x-ms-blob-type: <BlockBlob \| PageBlob \| AppendBlob>`	Mengembalikan 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 fatal atau non-fatal terakhir. Header ini tidak muncul jika blob ini belum pernah menjadi tujuan dalam `Copy Blob` operasi, atau jika blob ini telah dimodifikasi setelah operasi tersimpul `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 tersimpul `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. Ini dapat menunjukkan 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 tersimpul `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 atau file 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 tersimpul `Copy Blob` yang menggunakan `Set Blob Properties`, , `Put Blob`atau `Put Block List`. URL yang dikembalikan di header ini berisi parameter permintaan apa pun yang digunakan dalam operasi salin pada blob sumber, termasuk token tanda tangan akses bersama (SAS) yang digunakan untuk mengakses blob sumber.
`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 memperlambat 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-lease-duration: <infinite \| fixed>`	Versi 2012-02-12 dan yang lebih baru. Ketika blob disewakan, menentukan apakah sewa memiliki durasi tak terbatas atau tetap.
`x-ms-lease-state: <available \| leased \| expired \| breaking \| broken>`	Versi 2012-02-12 dan yang lebih baru. Status sewa blob.
`x-ms-lease-status:<locked \| unlocked>`	Status sewa blob saat ini.
`x-ms-request-id`	Secara unik mengidentifikasi permintaan yang dibuat, dan dapat digunakan untuk memecahkan masalah permintaan. Untuk informasi selengkapnya, lihat Memecahkan masalah operasi API.
`x-ms-version`	Menunjukkan versi Blob Storage yang digunakan untuk menjalankan permintaan. Disertakan untuk permintaan yang dibuat dengan menggunakan 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.
`Accept-Ranges: bytes`	Menunjukkan bahwa layanan mendukung permintaan untuk konten blob parsial. Disertakan untuk permintaan yang dibuat dengan menggunakan versi 2011-08-18 dan yang lebih baru, dan untuk layanan penyimpanan lokal di SDK versi 1.6 dan yang lebih baru.
`Date`	Nilai tanggal/waktu UTC yang dihasilkan oleh layanan, yang menunjukkan waktu saat respons dimulai.
`Access-Control-Allow-Origin`	Dikembalikan jika permintaan menyertakan `Origin` header dan CORS diaktifkan dengan aturan yang cocok. Header ini mengembalikan nilai header permintaan asal jika terjadi kecocokan.
`Access-Control-Expose-Headers`	Dikembalikan jika permintaan menyertakan `Origin` header dan CORS diaktifkan dengan aturan yang cocok. Mengembalikan daftar header respons yang akan diekspos ke klien atau penerbit permintaan.
`Vary`	Dikembalikan dengan nilai `Origin` header saat aturan CORS ditentukan. Lihat Dukungan CORS untuk layanan Azure Storage untuk detailnya.
`Access-Control-Allow-Credentials`	Dikembalikan jika permintaan menyertakan `Origin` header dan CORS diaktifkan dengan aturan yang cocok yang tidak mengizinkan semua asal. Header ini akan diatur ke `true`.
`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 dengan menggunakan algoritma yang ditentukan. Jika tidak, nilai diatur ke `false` (ketika blob tidak terenkripsi, atau jika hanya bagian dari metadata blob atau 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 tersebut 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-blob-content-md5`	Versi 2016-05-31 dan yang lebih baru. Jika blob memiliki hash MD5, dan jika permintaan berisi header rentang (Rentang atau rentang x-ms), header respons ini dikembalikan dengan nilai seluruh nilai MD5 blob. Nilai ini mungkin atau mungkin tidak sama dengan nilai yang dikembalikan di header Content-MD5, dengan yang terakhir dihitung dari rentang yang diminta.
`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 nilai berisi tidak lebih dari 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-last-access-time`	Versi 2020-02-10 dan yang lebih baru. Menunjukkan terakhir kali ketika 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 jika kebijakan dinonaktifkan. Untuk informasi tentang mengatur kebijakan pelacakan waktu akses terakhir akun penyimpanan, lihat API Blob Service.
`x-ms-blob-sealed`	Versi 2019-12-12 dan yang lebih baru. Dikembalikan hanya untuk blob tambahan. Jika blob tambahan telah disegel, nilainya adalah `true`. Untuk informasi selengkapnya, lihat Menambahkan Blob Seal
`x-ms-immutability-policy-until-date`	Versi 2020-06-12 dan yang lebih baru. Menentukan retensi hingga tanggal 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 dalam format RFC1123.
`x-ms-immutability-policy-mode: unlocked/locked`	Versi 2020-06-12 dan yang lebih baru. Dikembalikan jika kebijakan imutabilitas diatur pada blob. Nilainya adalah `unlocked` dan `locked`. `unlocked` menunjukkan bahwa pengguna dapat mengubah kebijakan dengan meningkatkan atau mengurangi retensi hingga tanggal. `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 adalah `true`. Jika tidak, nilai diatur ke `false` jika blob berisi penahanan legal dan nilainya adalah `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 ditetapkan 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`.

Isi Respons

Isi respons berisi konten blob.

Respons sampel

Status Response:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-blob-type: BlockBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CB171DBEAD6A6B"  
Vary: Origin  
Last-Modified: <date>  
x-ms-version: 2015-02-21  
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 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. Prinsip keamanan dapat berupa 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 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 bagi pengguna, grup, atau perwakilan layanan Microsoft Entra untuk memanggil Get Blob operasi, dan peran Azure RBAC bawaan paling tidak istimewa yang mencakup tindakan ini:

Tindakan Azure RBAC:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read
Peran bawaan yang paling tidak istimewa: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 delegasi yang 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 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 lebih lanjut, lihat Memahami bagaimana melarang Kunci Bersama memengaruhi token SAS.

Delegasi pengguna SAS

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

Memanggil Get Blob operasi menggunakan token SAS yang didelegasikan ke sumber daya kontainer atau 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 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 menentukan saat mendelegasikan akses:

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

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

Keterangan

Untuk blob halaman, Get Blob operasi di atas rentang halaman yang belum memiliki konten atau yang telah dibersihkan mengembalikan nol untuk byte tersebut.

Jika Anda memanggil Get Blob pada blob halaman tanpa rentang yang ditentukan, layanan mengembalikan rentang halaman hingga nilai yang ditentukan untuk x-ms-blob-content-length header. Untuk halaman apa pun yang tidak memiliki konten, layanan mengembalikan nol untuk byte tersebut.

Untuk blob tambahan, Get Blob operasi mengembalikan x-ms-blob-committed-block-count header . Header ini menunjukkan jumlah blok yang diterapkan dalam blob. Header x-ms-blob-committed-block-count tidak dikembalikan untuk blob blok atau blob halaman.

Get Blob Operasi diperbolehkan dua menit per MiB selesai. Jika operasi membutuhkan waktu rata-rata lebih dari dua menit per MiB, operasi akan kehabisan waktu.

Header x-ms-version diperlukan untuk mengambil blob milik kontainer privat. Jika blob milik kontainer yang tersedia untuk akses publik penuh atau parsial, klien mana pun dapat membacanya tanpa menentukan versi; versi layanan tidak diperlukan untuk mengambil blob milik kontainer publik. Untuk informasi selengkapnya, lihat Membatasi akses ke kontainer dan blob.

Get Blob Operasi pada blob blok yang diarsipkan akan gagal.

Operasi salin

Untuk menentukan apakah Copy Blob operasi telah selesai, pertama-tama periksa untuk memastikan bahwa x-ms-copy-id nilai header blob tujuan 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. Namun, ketahuilah bahwa semua operasi tulis pada blob kecuali Lease, , Put Pagedan Put Block operasi menghapus semua x-ms-copy-* properti dari blob. Properti ini juga tidak disalin oleh Copy Blob operasi yang menggunakan versi Blob Storage yang lebih lama dari 2012-02-12.

Peringatan

URL yang dikembalikan di x-ms-copy-source header berisi parameter permintaan apa pun yang digunakan dalam operasi salin pada blob sumber. Jika Anda menggunakan token SAS untuk mengakses blob sumber, token SAS tersebut x-ms-copy-source akan muncul di header saat Get Blob dipanggil pada blob tujuan.

Saat x-ms-copy-status: failed muncul dalam respons, x-ms-copy-status-description berisi informasi selengkapnya tentang kegagalan tersebut Copy Blob .

Tiga bidang dari setiap x-ms-copy-status-description nilai dijelaskan dalam tabel berikut:

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 yang berisi teks kesalahan standar yang terkait dengan kode status HTTP 3 digit dalam spesifikasi HTTP digunakan. 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 dalam tabel ini dapat berubah tanpa peringatan, bahkan tanpa perubahan versi, sehingga mungkin tidak sama persis dengan teks Anda.

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: Ketika layanan melaporkan kesalahan yang mendasar ini, layanan akan kembali `ResourceNotFound` dalam `ErrorCode` elemen . Jika tidak ada `ErrorCode` elemen yang muncul dalam respons, representasi string standar dari status HTTP, seperti `NotFound`, muncul.
Periode batas waktu yang membatasi semua operasi penyalinan berlalu. (Saat ini periode batas waktu adalah 2 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 bagaimana akun ditagih. Misalnya, membaca transaksi bertambah ke kategori penagihan yang berbeda dari transaksi tulis. Tabel berikut ini memperlihatkan kategori penagihan untuk Get Blob permintaan berdasarkan jenis akun penyimpanan:

Operasi	Jenis akun penyimpanan	Kategori penagihan
Get Blob	Objek besar biner blok premium Tujuan umum standar v2 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
Mengatur batas waktu untuk operasi Blob Storage