Dapatkan Blob

Operasi membaca Get Blob atau mengunduh blob dari sistem, termasuk metadata dan propertinya. Anda juga dapat menelepon Get Blob untuk membaca snapshot.

Permohonan

Anda dapat membuat permintaan Get Blob sebagai berikut. Kami menyarankan agar Anda menggunakan HTTPS. Ganti akun saya 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 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 GET Versi HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.0

HTTP/1.1

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

URI Parameter

Parameter tambahan berikut dapat ditentukan pada URI permintaan:

Pengaturan 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 Opsional, versi 12-12-2019 dan yang lebih baru. Parameter adalah versionid nilai buram DateTime yang, ketika ada, menentukan versi blob yang akan diambil.
timeout Optional. Parameter dinyatakan timeout dalam detik. Untuk informasi selengkapnya, lihat Mengatur batas waktu untuk operasi Blob Storage.

Tajuk permintaan

Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional.

Tajuk permintaan Description
Authorization Dibutuhkan. Menentukan skema otorisasi, nama akun, dan tanda tangan. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage.
Date atau x-ms-date Dibutuhkan. Menentukan Waktu Universal Terkoordinasi (UTC) untuk permintaan tersebut. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage.
x-ms-version Diperlukan untuk semua permintaan resmi. Opsional untuk permintaan anonim. Menentukan versi operasi yang akan digunakan untuk permintaan ini. Jika header ini dihilangkan untuk permintaan anonim, maka layanan mengeksekusi permintaan dengan versi 2009-09-19. Untuk informasi selengkapnya, lihat Penerapan versi untuk layanan Azure Storage.
Range Optional. Mengembalikan byte blob hanya dalam rentang yang ditentukan.
x-ms-range Optional. Mengembalikan byte blob hanya dalam rentang yang ditentukan. Jika keduanya Range dan x-ms-range ditentukan, layanan menggunakan nilai x-ms-range. Jika tidak ada rentang yang ditentukan, seluruh konten blob akan ditampilkan. Untuk informasi selengkapnya, lihat Menentukan header rentang untuk operasi Blob Storage.
x-ms-lease-id: <ID> Optional. Jika header ini ditentukan, 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 header ini ditentukan tetapi salah satu dari kondisi ini tidak terpenuhi, permintaan gagal dan Get Blob operasi gagal dengan kode status 412 (Prasyarat Gagal).
x-ms-range-get-content-md5: true Optional. Ketika header ini diatur ke true dan ditentukan bersama dengan Range header, layanan mengembalikan hash MD5 untuk rentang, selama rentang kurang dari atau sama dengan ukuran 4 mebibyte (MiB).

Jika header ditentukan tanpa Range header, layanan akan 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 Optional. Ketika header ini diatur ke true dan ditentukan bersama dengan Range header, layanan mengembalikan hash CRC64 untuk rentang, selama rentang kurang dari atau sama dengan ukuran 4 MiB.

Jika header ditentukan tanpa Range header, layanan akan mengembalikan kode status 400 (Permintaan Buruk).

Jika header diatur ke true saat rentang melebihi 4 MiB, layanan mengembalikan kode status 400 (Permintaan Buruk).

Jika x-ms-range-get-content-md5 header 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 Optional. Menentukan asal dari mana permintaan dikeluarkan. Kehadiran header ini menghasilkan header berbagi sumber daya lintas asal (CORS) pada respons.
x-ms-upn Optional. Versi 2023-11-03 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.
x-ms-structured-body Optional. Versi 2025-01-05 dan yang lebih baru. Jika ditentukan, layanan akan mengembalikan konten blob yang dikodekan dalam format isi terstruktur. Nilai header ini berisi versi dan properti skema pesan.

Saat ini, satu-satunya nilai yang didukung adalah XSM/1.0; properties=crc64, yang menunjukkan respons akan menggunakan segmen checksum crc64 dalam pesan yang dikodekan. Jika nilainya tidak cocok dengan ini, operasi gagal dengan kode kesalahan 400 (Permintaan Buruk).

Operasi ini juga mendukung penggunaan header bersyarat untuk membaca blob hanya jika kondisi tertentu terpenuhi. Untuk informasi selengkapnya, lihat Menentukan header bersyarat 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 dienangkan dengan kunci yang disediakan pelanggan, Anda harus menyertakan header ini pada permintaan untuk menyelesaikan operasi baca dengan sukses.

Tajuk permintaan Description
x-ms-encryption-key Dibutuhkan. 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 Dibutuhkan. Menentukan algoritme yang akan digunakan untuk enkripsi. Nilai header ini harus .AES256

Isi dari permintaan

Tidak ada.

Jawaban

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 untuk membaca rentang tertentu mengembalikan kode status 206 (Konten Parsial).

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

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

Syntax Description
Last-Modified Tanggal/waktu ketika 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 ketika blob dibuat. Format tanggal mengikuti RFC 1123.
x-ms-meta-name:value Sekumpulan pasangan nama-nilai yang dikaitkan dengan blob ini sebagai metadata yang ditentukan pengguna.
x-ms-tag-count Versi 2019-12-12 dan yang lebih baru. Jika blob memiliki tag apa pun, header ini mengembalikan jumlah tag yang disimpan pada blob. Header tidak dikembalikan jika tidak ada tag pada blob.
Content-Length Jumlah byte yang ada di badan 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 bersyarat 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 untuk 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 mengatur nilai hash MD5 blob blok bahkan ketika Put Blob permintaan tidak menyertakan header MD5.

Jika permintaan adalah untuk 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 saat rentang melebihi 4 MiB, layanan mengembalikan kode status 400 (Permintaan Buruk).
x-ms-content-crc64 Jika permintaan adalah untuk 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 saat rentang melebihi 4 MiB, layanan mengembalikan kode status 400 (Permintaan Buruk).
Content-Encoding Mengembalikan nilai yang ditentukan untuk header permintaan Content-Encoding .
Content-Language Mengembalikan nilai yang ditentukan untuk header permintaan Content-Language .
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, ini menunjukkan bahwa agen pengguna tidak boleh menampilkan respons. Sebagai gantinya, ini menampilkan 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 upaya operasi terakhir 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 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 terakhir 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 upaya Copy Blob operasi terakhir di mana blob ini adalah blob tujuan. Itu dapat menunjukkan 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 atau file 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.

URL yang dikembalikan dalam header ini berisi parameter permintaan apa pun yang digunakan dalam operasi penyalinan pada blob sumber. Jika URL berisi token Tanda Tangan Akses Bersama (SAS), tanda tangan (sig parameter) tidak akan disertakan.
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 berikut:

- success: Salinan berhasil selesai.
- pending: Salinan sedang berlangsung. Periksa x-ms-copy-status-description apakah kesalahan intermiten dan non-fatal memperlambat kemajuan penyalinan tetapi tidak menyebabkan kegagalan.
- aborted: Salinan diakhiri dengan Abort Copy Blob.
- failed: Salinan 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-lease-duration: <infinite | fixed> Versi 2012-02-12 dan yang lebih baru. Ketika blob disewakan, menentukan apakah sewa tidak terbatas atau durasi tetap.
x-ms-lease-state: <available | leased | expired | breaking | broken> Versi 2012-02-12 dan yang lebih baru. Status sewa gumpalan.
x-ms-lease-status:<locked | unlocked> Status sewa blob saat ini.
x-ms-request-id Mengidentifikasi permintaan yang dibuat secara unik, 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 mengeksekusi 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 ketika 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 pencocokan 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 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 dengan menggunakan algoritme yang ditentukan. Jika tidak, nilainya diatur ke false (ketika blob tidak dienkripsi, atau jika hanya bagian dari blob atau metadata 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 v2 tujuan umum, nilai yang valid adalah Hot, Cool, Cold dan Smart.
Catatan: tingkatCold didukung untuk versi 2021-12-02 dan yang lebih baru. Smart Tier didukung untuk versi 2026-02-06 dan yang lebih baru, dan saat ini dalam pratinjau publik.
Untuk informasi terperinci tentang tingkatan tingkat blob blok akun blob standar, lihat Tingkat penyimpanan blob.
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-smart-access-tier Header ini hanya dikembalikan untuk permintaan yang dibuat dengan versi 2026-02-06 dan yang lebih baru terhadap blob dalam Smart tingkat. Nilai yang valid adalah Hot, Cool, dan Cold. Untuk informasi terperinci tentang tingkatan tingkat blob blok akun blob standar, lihat Tingkat penyimpanan blob.
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 blob.
x-ms-blob-content-md5 Versi 2016-05-31 dan yang lebih baru. Jika blob memiliki hash MD5, dan jika permintaan berisi header rentang (Range atau x-ms-range), header respons ini dikembalikan dengan nilai nilai MD5 seluruh blob. Nilai ini mungkin atau mungkin tidak sama dengan nilai yang dikembalikan dalam 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 header x-ms-client-request-id jika ada dalam permintaan dan nilai berisi tidak lebih dari 1.024 karakter ASCII yang terlihat. Jika x-ms-client-request-id 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 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 Layanan Blob.
x-ms-blob-sealed Versi 2019-12-12 dan yang lebih baru. Hanya dikembalikan untuk gumpalan penambahan. Jika gumpalan tambahan telah disegel, nilainya adalah true. Untuk informasi selengkapnya, lihat Menambahkan Segel Blob
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 kekekalan 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 kekekalan diatur pada blob. Nilainya adalah unlocked dan locked. unlocked Menunjukkan bahwa pengguna dapat mengubah kebijakan dengan menambah 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 pembekuan hukum dan nilainya adalah true. Jika tidak, nilainya diatur ke false jika blob berisi pembekuan hukum dan nilainya adalah false.
x-ms-owner Versi 2020-06-12 dan yang lebih baru, hanya untuk akun dengan namespace hierarkis diaktifkan. Mengembalikan pemilik-pengguna 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 ditetapkan 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 diaktifkan. Mengembalikan jenis sumber daya untuk jalur, yang dapat berupa file atau directory.

Header respons (isi terstruktur)

Pada versi 05-01-2025, header berikut akan dikembalikan jika permintaan mengirimkan header yang valid x-ms-structured-body .

Respons Header Description
Content-Length Akan menjadi panjang respons yang dikodekan (tidak hanya panjang konten blob yang dikembalikan).
x-ms-structured-body Nilai header ini sama dengan nilai yang dikirim dalam permintaan, yang saat ini harus .XSM/1.0; properties=crc64
x-ms-structured-content-length Nilai header ini adalah panjang konten blob yang dikembalikan dan akan selalu lebih kecil dari Content-Length nilai header karena pengodean pesan.

Badan respons

Isi respons berisi konten gumpalan.

Contoh tanggapan

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 Get Blob seperti yang dijelaskan di bawah ini.

Penting

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.

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, dan peran Azure RBAC bawaan yang paling tidak istimewa yang mencakup tindakan ini:

Untuk mempelajari selengkapnya tentang menetapkan peran menggunakan Azure RBAC, lihat Menetapkan peran Azure untuk akses ke data blob.

Komentar

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

Jika Anda memanggil Get Blob 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 penambahan, operasi mengembalikan Get Blobx-ms-blob-committed-block-count header. Header ini menunjukkan jumlah blok yang diterapkan dalam blob. x-ms-blob-committed-block-count Header tidak dikembalikan untuk blob blok atau blob halaman.

Operasi Get Blob diperbolehkan dua menit per MiB untuk diselesaikan. Jika operasi rata-rata memakan waktu lebih dari dua menit per MiB, waktu operasi akan habis.

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

Operasi Get Blob pada blob blok yang diarsipkan akan gagal.

Operasi penyalinan

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 headernya x-ms-copy-status: success . Namun, ketahuilah bahwa semua operasi tulis pada blob kecuali Lease, , dan Put Page operasi menghapus semua Put Block properti x-ms-copy-*dari blob. Properti ini juga tidak disalin oleh Copy Blob operasi yang menggunakan versi Blob Storage lebih awal dari 2012-02-12.

Nota

URL yang dikembalikan di x-ms-copy-source header berisi parameter permintaan apa pun yang digunakan dalam operasi penyalinan pada blob sumber. Jika token Tanda Tangan Akses Bersama (SAS) digunakan untuk mengakses blob sumber, token SAS akan muncul di x-ms-copy-source header saat Get Blob dipanggil pada blob tujuan, kecuali tanda tangan (sig parameter kueri) akan dihapus.

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

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

Komponen Description
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 akan digunakan. Lihat Kode kesalahan REST API umum.
Informasi 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:

Penting

Deskripsi error dalam tabel ini dapat berubah tanpa peringatan, bahkan tanpa perubahan versi, sehingga mungkin tidak cocok dengan teks Anda.

Scenario x-ms-copy-status nilai x-ms-copy-status-description nilai
Operasi salin berhasil diselesaikan. keberhasilan empty
Pengguna membatalkan operasi penyalinan sebelum selesai. Dibatalkan empty
Kegagalan terjadi saat membaca dari blob sumber selama operasi penyalinan, tetapi operasi akan dicoba ulang. 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 salinan, tetapi operasi akan dicoba ulang. 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 "Salinan gagal saat membaca sumber."

Catatan: Saat layanan melaporkan kesalahan yang mendasari ini, layanan akan kembali ResourceNotFound ke 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 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). 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 REST API Blob Storage, atau dari pustaka klien Azure Storage. Permintaan ini menimbulkan biaya per transaksi. Jenis transaksi memengaruhi bagaimana akun ditagih. Misalnya, transaksi baca bertambah ke kategori penagihan yang berbeda dari transaksi tulis. Tabel berikut menunjukkan kategori penagihan untuk Get Blob permintaan berdasarkan jenis akun penyimpanan:

Operasi Jenis akun penyimpanan Kategori penagihan
Dapatkan Blob Objek besar biner blok premium
Standar tujuan umum versi 2
Tujuan umum standar v1		 Operasi pembacaan

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

  • Terakhir diperbarui pada