Get Blob

Artikel
07/26/2022
16 menit untuk membaca

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

Minta

Permintaan Get Blob dapat dibuat sebagai berikut. HTTPS disarankan. 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 ditimulasi

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

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.

Parameter URI

Parameter tambahan berikut dapat ditentukan pada URI permintaan.

Parameter	Deskripsi
`snapshot`	Opsional. Parameter rekam jepret adalah nilai buram `DateTime` yang, saat 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, saat 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 Service.

Judul Permintaan

Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional.

Header Permintaan	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 resmi, opsional untuk permintaan anonim. Menentukan versi operasi yang akan digunakan untuk permintaan ini. Untuk informasi selengkapnya, lihat Penerapan versi untuk layanan Azure Storage.
`Range`	Opsional. Mengembalikan hanya byte blob dalam rentang yang ditentukan.
`x-ms-range`	Opsional. Mengembalikan hanya byte blob dalam rentang yang ditentukan. Jika dan `Rangex-ms-range` ditentukan, layanan menggunakan nilai `x-ms-range`. Jika tidak ditentukan, seluruh konten blob akan dikembalikan. Lihat Menentukan Header Rentang untuk Operasi Blob Service untuk informasi selengkapnya.
`x-ms-lease-id: <ID>`	Opsional. Jika header ini ditentukan, operasi akan dilakukan hanya jika kedua kondisi berikut terpenuhi: - Sewa blob saat ini aktif. - ID sewa yang ditentukan dalam permintaan cocok dengan blob. Jika header ini ditentukan dan kedua kondisi ini tidak terpenuhi, permintaan akan gagal dan `Get Blob` operasi akan gagal dengan kode status 412 (Prasyarat Gagal).
`x-ms-range-get-content-md5: true`	Opsional. Ketika header ini diatur ke `true` dan ditentukan bersama dengan header , layanan mengembalikan hash MD5 untuk rentang, selama rentang kurang dari atau sama dengan `Range` ukuran 4 MiB. Jika header ini ditentukan tanpa `Range` header , layanan mengembalikan kode status 400 (Permintaan Buruk). Jika header ini diatur ke `true` ketika rentang melebihi ukuran 4 MiB, layanan mengembalikan kode status 400 (Permintaan Buruk).
`x-ms-range-get-content-crc64: true`	Opsional. Ketika header ini diatur ke `true` dan ditentukan bersama dengan header , layanan mengembalikan hash CRC64 untuk rentang, selama rentangnya kurang dari atau sama dengan `Range` ukuran 4 MiB. Jika header ini ditentukan tanpa `Range` header , layanan mengembalikan kode status 400 (Permintaan Buruk). Jika header ini diatur ke `true` ketika rentang melebihi ukuran 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 akan gagal dengan 400 (Permintaan Buruk). Header ini didukung dalam versi 2019-02-02 atau yang lebih baru.
`Origin`	Opsional. Menentukan asal dari mana permintaan dikeluarkan. Kehadiran header ini menghasilkan header berbagi sumber daya lintas asal (CORS) pada respons.
`x-ms-client-request-id`	Opsional. Menyediakan nilai buram yang dihasilkan klien dengan batas karakter 1 KiB yang dicatat dalam log analitik saat pengelogan analitik penyimpanan diaktifkan. Menggunakan header ini sangat direkomendasikan untuk mengkorelasi aktivitas sisi klien dengan permintaan yang diterima oleh server. Untuk informasi selengkapnya, lihat Tentang Pengelogan Storage Analytics dan Pengelogan Azure: Menggunakan Log untuk Melacak Permintaan Storage.

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

Header Permintaan (Kunci enkripsi yang disediakan pelanggan)

Dimulai dengan versi 2019-02-02, header berikut dapat ditentukan pada permintaan untuk membaca blob yang dienkripsi dengan kunci yang disediakan pelanggan. Enkripsi dengan kunci yang disediakan pelanggan (dan sekumpulan header yang sesuai) bersifat opsional. Jika blob sebelumnya telah dienkripsi dengan kunci yang disediakan pelanggan, header ini harus disertakan pada permintaan untuk menyelesaikan operasi baca dengan sukses.

Header permintaan	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, 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 tentang kode status, lihat Status dan Kode 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 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 pembuatan blob. 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 atau yang lebih baru. Jika blob memiliki tag, mengembalikan jumlah tag yang disimpan pada blob. Header ini tidak dikembalikan jika tidak ada tag pada blob.
`Content-Length`	Jumlah byte yang ada dalam isi respons.
`Content-Type`	Tipe 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`	ETag berisi nilai yang dapat Anda gunakan untuk melakukan operasi secara kondisional. Lihat Menentukan Header Kondisional untuk Operasi Blob Service untuk informasi selengkapnya. Jika versi permintaan adalah 2011-08-18 atau yang lebih baru, nilai ETag akan berada 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`, maka permintaan mengembalikan hash MD5 untuk rentang, selama ukuran rentang kurang dari atau sama dengan 4 MiB. Jika tidak satu pun dari kumpulan kondisi ini benar, maka 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 ukuran 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`, maka permintaan mengembalikan hash CRC64 untuk rentang tersebut, 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 ukuran 4 MiB, layanan mengembalikan kode status 400 (Permintaan Buruk).
`Content-Encoding`	Header ini mengembalikan nilai yang ditentukan untuk `Content-Encoding` header permintaan.
`Content-Language`	Header ini mengembalikan nilai yang ditentukan untuk `Content-Language` header permintaan.
`Cache-Control`	Header ini dikembalikan jika 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 juga dapat digunakan untuk melampirkan metadata tambahan. Misalnya, jika diatur ke `attachment`, itu menunjukkan bahwa agen pengguna tidak boleh menampilkan respons, tetapi sebaliknya 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 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 tujuan dalam `Copy Blob` operasi, atau jika blob ini telah dimodifikasi setelah operasi yang disimpulkan `Copy Blob` 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 ketika `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 belum pernah menjadi tujuan dalam `Copy Blob` operasi, atau jika blob ini telah dimodifikasi setelah operasi yang disimpulkan `Copy Blob` 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` 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 antara 0 dan `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` 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 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 yang disimpulkan `Copy Blob` 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 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`: Salinan sedang berlangsung. Periksa apakah `x-ms-copy-status-description` kesalahan 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` 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`	Header ini secara unik mengidentifikasi permintaan yang dibuat dan dapat digunakan untuk memecahkan masalah permintaan. Untuk informasi selengkapnya, lihat Pemecahan Masalah Operasi API.
`x-ms-version`	Menunjukkan versi layanan Blob yang digunakan untuk menjalankan permintaan. Disertakan untuk permintaan yang dibuat menggunakan versi 2009-09-19 dan yang lebih baru. Header ini juga dikembalikan untuk permintaan anonim tanpa versi yang ditentukan jika kontainer ditandai untuk akses publik menggunakan blob service versi 2009-09-19.
`Accept-Ranges: bytes`	Menunjukkan bahwa layanan mendukung permintaan untuk konten blob parsial. Disertakan untuk permintaan yang dibuat menggunakan versi 2011-08-18 dan yang lebih baru, dan untuk layanan penyimpanan lokal di SDK versi 1.6 atau yang lebih baru.
`Date`	Nilai tanggal/waktu UTC yang dihasilkan oleh layanan yang menunjukkan waktu di mana 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 ada 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 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 penampingan.
`x-ms-server-encrypted: true/false`	Versi 2015-12-11 atau 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 atau yang lebih baru. Header ini dikembalikan jika blob dienkripsi dengan kunci yang disediakan pelanggan.
`x-ms-encryption-scope`	Versi 2019-02-02 atau yang lebih baru. Header ini dikembalikan jika blob dienkripsi dengan cakupan enkripsi.
`x-ms-blob-content-md5`	Mulai dari versi 2016-05-31, jika blob memiliki hash MD5, dan jika permintaan berisi header rentang (Rentang atau x-ms-range), 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`	Header ini 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 1024 karakter ASCII yang terlihat. `x-ms-client-request-id` Jika header tidak ada dalam permintaan, header ini tidak akan ada dalam respons.
`x-ms-last-access-time`	Versi 2020-02-10 atau yang lebih baru. Menunjukkan kapan terakhir kali data blob diakses berdasarkan kebijakan pelacakan waktu akses terakhir akun penyimpanan. Header tidak akan 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 Service API.
`x-ms-blob-sealed`	Versi 2019-12-12 atau yang lebih baru, hanya dikembalikan untuk blob tambahan. Jika blob tambahan telah disegel, nilainya akan benar, lihat Seal Append Blobs
`x-ms-immutability-policy-until-date`	Versi 2020-06-12 atau 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 adalah format RFC1123.
`x-ms-immutability-policy-mode: unlocked/locked`	Versi 2020-06-12 atau 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 atau 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 atau yang lebih baru hanya untuk akun dengan namespace hierarki diaktifkan. Mengembalikan pengguna pemilik file atau direktori.
`x-ms-group`	Versi 2020-06-12 atau yang lebih baru hanya untuk akun dengan namespace hierarki diaktifkan. Mengembalikan grup pemilik file atau direktori.
`x-ms-permissions`	Versi 2020-06-12 atau 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 atau yang lebih baru hanya untuk akun dengan namespace hierarki diaktifkan. Mengembalikan jenis sumber daya untuk jalur, yang dapat berupa `file`/`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

Jika daftar kontrol akses kontainer (ACL) diatur untuk mengizinkan akses anonim ke blob, klien mana pun dapat memanggil operasi ini. Jika kontainer bersifat privat, operasi ini dapat dilakukan oleh pemilik akun dan oleh siapa pun dengan Tanda Tangan Akses Bersama yang memiliki izin untuk membaca blob.

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 2 menit per MiB selesai. Jika operasi membutuhkan waktu rata-rata lebih dari 2 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. Lihat Membatasi Akses ke Kontainer dan Blob untuk informasi selengkapnya.

Get Blob Pada blob blok yang diarsipkan akan gagal.

Operasi salin

Untuk menentukan apakah Copy Blob operasi telah selesai, pertama-tama periksa apakah 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 . Kemudian periksa x-ms-copy-status: success header. Namun, ketahuilah bahwa semua operasi tulis pada blob kecuali Lease, Put Page dan Put Block operasi menghapus semua x-ms-copy-* properti dari blob. Properti ini juga tidak disalin oleh Copy Blob operasi yang menggunakan versi sebelum 2012-02-12.

Peringatan

URL yang x-ms-copy-source dikembalikan di header berisi parameter permintaan apa pun yang digunakan dalam operasi salin pada blob sumber. Jika token SAS digunakan untuk mengakses blob sumber, maka token SAS tersebut akan muncul di x-ms-copy-source header ketika 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 .

Tabel berikut ini menjelaskan tiga bidang dari setiap x-ms-copy-status-description nilai.

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, dalam tanda kutip.

Tabel berikut ini menjelaskan x-ms-copy-status nilai dan x-ms-copy-status-description skenario kegagalan umum.

Penting

Teks deskripsi yang ditampilkan di sini dapat berubah tanpa peringatan, bahkan tanpa perubahan versi, jadi jangan mengandalkan pencocokan teks yang tepat ini.

Skenario	nilai x-ms-copy-status	nilai x-ms-copy-status-description
Operasi salin berhasil diselesaikan.	berhasil	kosong
Operasi penyalinan dibatalkan pengguna sebelum selesai.	Dibatalkan	kosong
Kegagalan terjadi ketika membaca dari blob sumber selama operasi salin, tetapi operasi akan dicoba kembali.	Tertunda	502 BadGateway "Mengalami kesalahan yang dapat diulang saat membaca sumbernya. Akan mencoba lagi. Waktu kegagalan: <waktu>"
Kegagalan terjadi saat menulis ke blob tujuan operasi salin, tetapi operasi akan dicoba kembali.	Tertunda	500 InternalServerError "Mengalami kesalahan yang dapat diulang. Akan mencoba lagi. Waktu kegagalan: <waktu>"
Kegagalan yang tidak dapat dipulihkan terjadi ketika membaca dari blob sumber operasi salin.	gagal	404 ResourceNotFound "Salin gagal saat membaca sumber." Catatan: Saat melaporkan kesalahan yang mendasar `ResourceNotFound` ini, Azure kembali dalam `ErrorCode` elemen . Jika tidak ada `ErrorCode` elemen 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 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 2 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.

Lihat juga

Mengotorisasi permintaan ke Azure Storage
Kode Status dan Kesalahan
Kode Kesalahan Layanan Blob
Mengatur Batas Waktu untuk Operasi Blob Service