Bagikan melalui


Masukkan Blob

Operasi membuat Put Blob blok, halaman, atau blob penambahan baru, atau memperbarui konten blob blok yang ada. Operasi akan Put Blob menimpa semua konten blob yang ada dengan nama yang sama.

Saat memperbarui blob blok yang ada, Anda menimpa metadata yang ada pada blob. Konten blob yang ada ditimpa dengan konten blob baru. Pembaruan parsial tidak didukung dengan Put Blob. Untuk melakukan pembaruan parsial konten blob blok, gunakan operasi Put Block List .

Anda hanya dapat membuat blob tambahan dalam versi 2015-02-21 dan yang lebih baru.

Panggilan ke Put Blob untuk membuat blob halaman atau blob tambahan hanya menginisialisasi blob. Jika blob sudah ada, konten akan dihapus. Untuk menambahkan konten ke blob halaman, panggil operasi Letakkan Halaman . Untuk menambahkan konten ke blob penambahan, panggil operasi Tambahkan Blok .

Minta

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

URI permintaan metode PUT Versi HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob HTTP/1.1

Permintaan layanan penyimpanan yang ditimulasikan

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

URI permintaan metode PUT Versi HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.1

Emulator penyimpanan hanya mendukung ukuran blob hingga 2 gibibyte (GiB).

Untuk informasi selengkapnya, lihat Gunakan emulator Azurite untuk pengembangan Microsoft Azure Storage lokal.

Parameter URI

Parameter tambahan berikut dapat ditentukan pada URI permintaan:

Parameter Deskripsi
timeout Opsional. Parameter timeout dinyatakan dalam hitung detik. Untuk informasi selengkapnya, lihat Mengatur waktu habis untuk operasi Blob service.

Header permintaan (semua jenis blob)

Header permintaan yang diperlukan dan opsional untuk semua jenis blob dijelaskan dalam tabel berikut:

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. Menentukan versi operasi yang akan digunakan untuk permintaan ini. Untuk informasi selengkapnya, lihat Penerapan versi untuk layanan Azure Storage.
Content-Length Wajib diisi. Panjang permintaan.

Untuk blob halaman atau blob tambahan, nilai header ini harus diatur ke nol, karena Put Blob hanya digunakan untuk menginisialisasi blob. Untuk menulis konten ke blob halaman yang ada, panggil Letakkan Halaman. Untuk menulis konten ke blob penambahan, panggil Tambahkan Blok.
Content-Type Opsional. Jenis konten MIME dari blob. Jenis defaultnya adalah application/octet-stream.
Content-Encoding Pilihan. Menentukan pengodean konten mana yang telah diterapkan ke blob. Nilai ini dikembalikan ke klien ketika operasi Dapatkan Blob dilakukan pada sumber daya blob. Ketika nilai ini dikembalikan, klien dapat menggunakannya untuk mendekode konten blob.
Content-Language Pilihan. Menentukan bahasa alami yang digunakan oleh sumber daya ini.
Content-MD5 Pilihan. Hash MD5 dari konten blob. Hash ini digunakan untuk memverifikasi integritas blob selama transportasi. Ketika header ini ditentukan, layanan penyimpanan memeriksa hash yang telah tiba terhadap yang dikirim. Jika dua hash tidak cocok, operasi gagal dengan kode kesalahan 400 (Permintaan Buruk).

Saat header dihilangkan dalam versi 2012-02-12 atau yang lebih baru, Blob Storage menghasilkan hash MD5.

Hasil dari Get Blob, Get Blob Properties, dan List Blobs termasuk hash MD5.
x-ms-content-crc64 Pilihan. Hash CRC64 dari konten blob. Hash ini digunakan untuk memverifikasi integritas blob selama transportasi. Ketika header ini ditentukan, layanan penyimpanan memeriksa hash yang telah tiba terhadap yang dikirim. Jika dua hash tidak cocok, operasi gagal dengan kode kesalahan 400 (Permintaan Buruk). Header ini didukung dalam versi 02-02-2019 dan yang lebih baru.

Jika header Content-MD5 dan x-ms-content-crc64 ada, permintaan gagal dengan 400 (Permintaan Buruk).
Cache-Control Pilihan. Blob Storage menyimpan nilai ini tetapi tidak menggunakan atau memodifikasinya.
x-ms-blob-content-type Pilihan. Atur jenis konten blob.
x-ms-blob-content-encoding Pilihan. Atur pengodean konten blob.
x-ms-blob-content-language Pilihan. Atur bahasa konten blob.
x-ms-blob-content-md5 Pilihan. Atur hash MD5 blob. Untuk BlockBlob, header ini lebih diutamakan Content-MD5 ketika memverifikasi integritas blob selama transportasi. Untuk PageBlob dan AppendBlob, header ini secara langsung mengatur hash MD5 dari blob.
x-ms-blob-cache-control Pilihan. Mengatur kontrol cache blob.
x-ms-blob-type: <BlockBlob ¦ PageBlob ¦ AppendBlob> Wajib diisi. Menentukan jenis blob yang akan dibuat: blob blok, blob halaman, atau blob penambahan. Dukungan untuk membuat blob tambahan hanya tersedia di versi 2015-02-21 dan yang lebih baru.
x-ms-meta-name:value Opsional. Pasangan nama-nilai yang terkait dengan blob sebagai metadata.

Catatan: Pada versi 2009-09-19, nama metadata harus mematuhi aturan penamaan untuk pengidentifikasi C#.
x-ms-encryption-scope Pilihan. Menunjukkan cakupan enkripsi yang akan digunakan untuk mengenkripsi konten permintaan. Header ini didukung dalam versi 2019-02-02 dan yang lebih baru.
x-ms-encryption-context Pilihan. Defaultnya adalah "Kosong". Jika nilai diatur, nilai akan mengatur metadata sistem blob. Panjang maksimum-1024. Hanya berlaku saat Namespace Hierarki diaktifkan untuk akun tersebut. Header ini didukung dalam versi 2021-08-06 dan yang lebih baru.
x-ms-tags Pilihan. Mengatur tag yang dikodekan string kueri yang diberikan pada blob. Lihat Keterangan untuk informasi tambahan. Didukung dalam versi 2019-12-12 dan yang lebih baru.
x-ms-lease-id:<ID> Diperlukan jika blob memiliki sewa aktif. Untuk melakukan operasi ini pada blob dengan sewa aktif, tentukan ID sewa yang valid untuk header ini.
x-ms-blob-content-disposition Pilihan. Mengatur header blob Content-Disposition . Tersedia untuk versi 2013-08-15 dan yang lebih baru.

Bidang Content-Disposition header respons menyampaikan informasi tambahan tentang cara memproses payload respons, dan Anda dapat menggunakannya untuk melampirkan metadata tambahan. Misalnya, jika header diatur ke attachment, itu menunjukkan bahwa agen pengguna tidak boleh menampilkan respons. Sebaliknya, ini harus menampilkan dialog Simpan Sebagai dengan nama file selain nama blob yang ditentukan.

Respons dari operasi Dapatkan Properti Blob dan Dapatkan Blob menyertakan content-disposition header .
Origin Pilihan. Menentukan asal dari mana permintaan dikeluarkan. Kehadiran header ini menghasilkan header berbagi sumber daya lintas asal (CORS) pada respons. Untuk informasi selengkapnya, lihat Dukungan CORS untuk layanan Azure Storage.
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 dikonfigurasi. Kami sangat menyarankan Anda menggunakan header ini untuk menghubungkan aktivitas sisi klien dengan permintaan yang diterima server. Untuk informasi selengkapnya, lihat Tentang pengelogan analitik Penyimpanan.
x-ms-access-tier Pilihan. Tingkat yang akan diatur pada blob. Untuk blob halaman pada akun Penyimpanan Premium hanya dengan versi 2017-04-17 dan yang lebih baru. Untuk daftar lengkap tingkat yang didukung blob halaman, lihat Penyimpanan premium berkinerja tinggi dan disk terkelola untuk komputer virtual (VM). Untuk blob blok, didukung pada penyimpanan blob atau akun v2 tujuan umum hanya dengan versi 2018-11-09 dan yang lebih baru. Nilai yang valid untuk tingkat blob blok adalah Hot, , ColdCool, dan Archive. Catatan: Cold tingkat didukung untuk versi 2021-12-02 dan yang lebih baru. Untuk informasi terperinci tentang tingkatan blob blok, lihat Tingkat penyimpanan panas, dingin, dan arsip.
x-ms-immutability-policy-until-date Versi 2020-06-12 dan yang lebih baru. Menentukan tanggal retensi-hingga yang akan diatur pada blob. Ini adalah tanggal hingga blob dapat dilindungi agar tidak dimodifikasi atau dihapus. Mengikuti format RFC1123.
x-ms-immutability-policy-mode Versi 2020-06-12 dan yang lebih baru. Menentukan mode kebijakan imutabilitas yang akan diatur pada blob. Nilai yang berlaku adalah unlocked atau locked. Dengan unlocked, pengguna dapat mengubah kebijakan dengan meningkatkan atau mengurangi tanggal retensi hingga. Dengan locked, tindakan ini dilarang.
x-ms-legal-hold Versi 2020-06-12 dan yang lebih baru. Menentukan penahanan legal yang akan ditetapkan pada blob. Nilai yang berlaku adalah true atau false.
x-ms-expiry-option Pilihan. Versi 2023-08-03 dan yang lebih baru. Menentukan opsi tanggal kedaluwarsa untuk permintaan. Untuk informasi selengkapnya, lihat ExpiryOption. Header ini valid untuk akun dengan namespace hierarki diaktifkan.
x-ms-expiry-time Pilihan. Versi 2023-08-03 dan yang lebih baru. Menentukan waktu ketika blob diatur untuk kedaluwarsa. Format untuk tanggal kedaluwarsa bervariasi menurut x-ms-expiry-option. Untuk informasi selengkapnya, lihat ExpiryOption. Header ini valid untuk akun dengan namespace hierarki diaktifkan.

Operasi ini juga mendukung penggunaan header kondisional untuk menulis blob hanya jika kondisi tertentu terpenuhi. Untuk informasi selengkapnya, lihat Menentukan header kondisional untuk operasi Blob Storage.

Header permintaan (hanya blob halaman)

Header permintaan yang hanya berlaku untuk operasi pada blob halaman dijelaskan dalam tabel berikut:

Meminta kop Deskripsi
x-ms-blob-content-length: bytes Diperlukan untuk blob halaman. Header ini menentukan ukuran maksimum untuk blob halaman, hingga 8 tebibyte (TiB). Ukuran blob halaman harus diratakan ke batas 512 byte.

Jika header ini ditentukan untuk blob blok atau blob penambahan, Blob Storage mengembalikan kode status 400 (Permintaan Buruk).
x-ms-blob-sequence-number: <num> Pilihan. Atur untuk blob halaman saja. Nomor urut adalah nilai yang dikontrol pengguna yang dapat Anda gunakan untuk melacak permintaan. Nilai nomor urut harus dari 0 hingga 2^63 - 1. Nilai default adalah 0.
x-ms-access-tier Versi 2017-04-17 dan yang lebih baru. Untuk blob halaman pada akun penyimpanan premium saja. Menentukan tingkat yang akan diatur pada blob. Untuk daftar lengkap tingkatan yang didukung, lihat Penyimpanan premium berkinerja tinggi dan disk terkelola untuk VM.
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 nilai berisi tidak lebih dari 1.024 karakter ASCII yang terlihat. x-ms-client-request-id Jika header tidak ada dalam permintaan, header tidak akan ada dalam respons.

Header permintaan (kunci enkripsi yang disediakan pelanggan)

Pada versi 2019-02-02, header berikut dapat ditentukan pada permintaan untuk mengenkripsi blob dengan kunci yang disediakan pelanggan. Enkripsi dengan kunci yang disediakan pelanggan (dan set header yang sesuai) bersifat opsional.

Meminta kop Deskripsi
x-ms-encryption-key Wajib diisi. Kunci enkripsi AES-256 yang dikodekan Base64.
x-ms-encryption-key-sha256 Wajib diisi. 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

Untuk blob blok, isi permintaan berisi konten blob.

Untuk blob halaman atau blob tambahan, isi permintaan kosong.

Permintaan sampel

Contoh berikut menunjukkan permintaan untuk membuat blob blok:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblockblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-content-disposition: attachment; filename="fname.ext"  
x-ms-blob-type: BlockBlob  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
x-ms-expiry-option: RelativeToNow
x-ms-expiry-time: 30000
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Content-Length: 11  
  
Request Body:  
hello world

Permintaan sampel ini membuat blob halaman dan menentukan ukuran maksimumnya sebagai 1.024 byte. Untuk menambahkan konten ke blob halaman, Anda harus memanggil Letakkan Halaman:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/mypageblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-type: PageBlob  
x-ms-blob-content-length: 1024  
x-ms-blob-sequence-number: 0  
Authorization: SharedKey   
Origin: http://contoso.com  
Vary: Origin  
myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Content-Length: 0  

Permintaan sampel ini membuat blob tambahan. Untuk menambahkan konten ke blob penambahan, Anda harus memanggil Tambahkan Blok:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myappendblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-type: AppendBlob  
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Origin: http://contoso.com  
Vary: Origin  
Content-Length: 0  

Respons

Respons mencakup kode status HTTP dan sekumpulan header respons.

Kode status

Operasi yang berhasil mengembalikan kode status 201 (Dibuat).

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.

Header respons Deskripsi
ETag Berisi nilai yang dapat digunakan klien untuk melakukan operasi kondisional PUT dengan menggunakan If-Match header permintaan. Jika versi permintaan adalah 2011-08-18 atau yang lebih baru, nilai ETag diapit dalam tanda kutip.
Last-Modified Tanggal/waktu saat blob terakhir diubah. Format tanggal mengikuti RFC 1123. Untuk informasi selengkapnya, lihat Mewakili nilai tanggal/waktu di header.

Setiap operasi tulis pada blob (termasuk pembaruan pada metadata atau properti blob) mengubah waktu terakhir blob yang dimodifikasi.
Content-MD5 Dikembalikan untuk blob blok sehingga klien dapat memeriksa integritas konten pesan. Nilai Content-MD5 yang dikembalikan dihitung oleh Blob Storage. Dalam versi 2012-02-12 dan yang lebih baru, header ini dikembalikan bahkan ketika permintaan tidak menyertakan Content-MD5 atau x-ms-blob-content-md5 header.
x-ms-content-crc64 Dikembalikan untuk blob blok sehingga klien dapat memeriksa integritas konten pesan. Nilai x-ms-content-crc64 yang dikembalikan dihitung oleh Blob Storage. Header ini selalu dikembalikan pada versi 2019-02-02.
x-ms-request-id 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. Dikembalikan untuk permintaan yang dibuat terhadap versi 2009-09-19 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 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.
Access-Control-Allow-Credentials Dikembalikan jika permintaan menyertakan Origin header dan CORS diaktifkan dengan aturan yang cocok yang tidak mengizinkan semua asal. Header ini diatur ke true.
x-ms-request-server-encrypted: true/false Versi 2015-12-11 dan yang lebih baru. Nilai header ini diatur ke true jika konten permintaan berhasil dienkripsi dengan menggunakan algoritma yang ditentukan. Jika tidak, nilainya adalah false.
x-ms-encryption-key-sha256 Versi 2019-02-02 dan yang lebih baru. Dikembalikan jika permintaan menggunakan kunci yang disediakan pelanggan untuk enkripsi, sehingga klien dapat memastikan bahwa konten permintaan berhasil dienkripsi dengan menggunakan kunci yang disediakan.
x-ms-encryption-scope Versi 2019-02-02 dan yang lebih baru. Dikembalikan jika permintaan menggunakan cakupan enkripsi, sehingga klien dapat memastikan konten permintaan berhasil dienkripsi dengan menggunakan cakupan enkripsi.
x-ms-version-id: <DateTime> Versi 2019-12-12 dan yang lebih baru. Header ini mengembalikan nilai buram DateTime yang secara unik mengidentifikasi blob. Nilai header ini menunjukkan versi blob, dan dapat digunakan dalam permintaan berikutnya untuk mengakses blob.

Isi Respons

Tidak ada.

Respons sampel

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Transfer-Encoding: chunked  
Content-MD5: sQqNsWTgdUEFt6mb5y4/5Q==  
x-ms-content-crc64: 77uWZTolTHU
Date: <date>  
ETag: "0x8CB171BA9E94B0B"  
Last-Modified: <date>  
Access-Control-Allow-Origin: http://contoso.com  
Access-Control-Expose-Headers: Content-MD5  
Access-Control-Allow-Credentials: True  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-version-id: <DateTime>  

Authorization

Otorisasi diperlukan saat memanggil operasi akses data apa pun di Azure Storage. Anda dapat mengotorisasi operasi seperti yang Put Blob dijelaskan di bawah ini.

Jika permintaan menentukan tag dengan x-ms-tags header permintaan, pemanggil harus memenuhi persyaratan otorisasi operasi Atur Tag Blob .

Penting

Microsoft merekomendasikan penggunaan Microsoft Entra ID dengan identitas terkelola untuk mengotorisasi permintaan ke Azure Storage. Microsoft Entra ID memberikan keamanan yang unggul dan kemudahan penggunaan dibandingkan dengan otorisasi Kunci Bersama.

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, identitas terkelola, atau perwakilan layanan Microsoft Entra untuk memanggil Put Blob operasi, 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.

Keterangan

Saat membuat blob, Anda harus menentukan apakah blob blok, blob penambahan, atau blob halaman dengan menentukan nilai x-ms-blob-type header. Setelah blob dibuat, jenis blob tidak dapat diubah kecuali dihapus dan dibuat ulang.

Tabel berikut menjelaskan ukuran blok dan blob maksimum yang diizinkan, berdasarkan versi layanan:

Versi layanan. Ukuran blok maksimum (melalui Put Block) Ukuran blob maksimum (melalui Put Block List) Ukuran blob maksimum melalui operasi tulis tunggal (melalui Put Blob)
Versi 12-12-2019 dan yang lebih baru 4.000 mebibyte (MiB) Sekitar 190,7 TiB (4.000 MiB × 50.000 blok) 5.000 MiB
Versi 2016-05-31 hingga 2019-07-07 100 MiB Sekitar 4,75 TiB (100 MiB × 50.000 blok) 256 MiB
Versi yang lebih lama dari 2016-05-31 4 MiB Sekitar 195 GiB (4 MiB × 50.000 blok) 64 MiB

Jika Anda mencoba mengunggah blob blok yang lebih besar dari ukuran maksimum yang diizinkan untuk versi layanan tersebut atau blob halaman yang lebih besar dari 8 TiB, layanan mengembalikan kode status 413 (Entitas Permintaan Terlalu Besar). Blob Storage juga mengembalikan informasi tambahan tentang kesalahan dalam respons, termasuk ukuran blob maksimum yang diizinkan, dalam byte.

Untuk membuat blob halaman baru, pertama-tama inisialisasi blob dengan memanggil Put Blob, lalu tentukan ukuran maksimumnya, hingga 8 TiB. Saat Anda membuat blob halaman, jangan sertakan konten dalam isi permintaan. Setelah blob dibuat, panggil Put Page untuk menambahkan konten ke blob atau untuk memodifikasinya.

Untuk membuat blob tambahan baru, panggil Put Blob untuk membuatnya dengan panjang konten 0 byte. Setelah blob penambahan dibuat, panggil Tambahkan Blok untuk menambahkan konten ke akhir blob tersebut.

Jika Anda memanggil Put Blob untuk menimpa blob yang ada dengan nama yang sama, rekam jepret apa pun yang terkait dengan blob asli akan dipertahankan. Untuk menghapus rekam jepret terkait, pertama-tama panggil Hapus Blob, lalu panggil Put Blob untuk membuat ulang blob.

Properti kustom blob

Blob memiliki properti kustom (diatur melalui header) yang dapat Anda gunakan untuk menyimpan nilai yang terkait dengan header HTTP standar. Anda selanjutnya dapat membaca nilai-nilai ini dengan memanggil Dapatkan Properti Blob, atau mengubahnya dengan memanggil Atur Properti Blob. Header properti kustom dan header HTTP standar terkait tercantum dalam tabel berikut:

Header HTTP Header properti blob kustom
Content-Type x-ms-blob-content-type
Content-Encoding x-ms-blob-content-encoding
Content-Language x-ms-blob-content-language
Content-MD5 x-ms-blob-content-md5
Cache-Control x-ms-blob-cache-control

Semantik untuk mengatur atau mempertahankan nilai properti ini dengan blob adalah sebagai berikut:

  • Jika klien menentukan header properti kustom, seperti yang ditunjukkan oleh awalan x-ms-blob , nilai ini disimpan dengan blob.

  • Jika klien menentukan header HTTP standar, tetapi bukan header properti kustom, nilai disimpan di properti kustom terkait yang terkait dengan blob, dan dikembalikan oleh panggilan ke Get Blob Properties. Misalnya, jika klien mengatur Content-Type header pada permintaan, nilai tersebut disimpan di properti blob x-ms-blob-content-type .

  • Jika klien menetapkan header HTTP standar dan header properti yang sesuai pada permintaan yang sama, permintaan PUT menggunakan nilai yang disediakan untuk header HTTP standar, tetapi nilai yang ditentukan untuk header properti kustom dipertahankan dengan blob dan dikembalikan oleh permintaan GET berikutnya.

Jika tag disediakan di x-ms-tags header, tag harus dikodekan dengan string kueri. Kunci dan nilai tag harus sesuai dengan persyaratan penamaan dan panjang seperti yang ditentukan dalam Set Blob Tags. Selanjutnya, x-ms-tags header mungkin berisi hingga 2kb tag. Jika diperlukan lebih banyak tag, gunakan operasi Atur Tag Blob .

Jika blob memiliki sewa aktif, klien harus menentukan ID sewa yang valid pada permintaan untuk menimpa blob. Jika klien tidak menentukan ID sewa atau menentukan ID sewa yang tidak valid, Blob Storage mengembalikan kode status 412 (Prasyarat Gagal). Jika klien menentukan ID sewa tetapi blob tidak memiliki sewa aktif, Blob Storage juga mengembalikan kode status 412 (Prasyarat Gagal). Jika klien menentukan ID sewa pada blob yang belum ada, Blob Storage mengembalikan kode status 412 (Prasyarat Gagal) untuk permintaan yang dibuat terhadap versi 2013-08-15 dan yang lebih baru. Untuk versi yang lebih lama dari 2013-08-15, Blob Storage mengembalikan kode status 201 (Dibuat).

Jika blob yang ada dengan sewa aktif ditimpa oleh Put Blob operasi, sewa tetap ada pada blob yang diperbarui hingga kedaluwarsa atau dirilis.

Put Blob Operasi diizinkan 10 menit per MiB untuk diselesaikan. Jika operasi membutuhkan waktu lebih dari 10 menit per MiB rata-rata, waktu operasi habis.

Menimpa archive blob gagal, dan menimpa hot blob atau cool mewarisi tingkat dari blob lama jika x-ms-access-tier header tidak disediakan.

ExpiryOption

Anda bisa mengirim nilai berikut sebagai x-ms-expiry-option header. Header ini tidak peka huruf besar/kecil.

Opsi kedaluwarsa Deskripsi
RelativeToNow Mengatur tanggal kedaluwarsa relatif terhadap waktu saat ini. x-ms-expiry-time harus ditentukan sebagai jumlah milidetik yang akan berlalu dari waktu sekarang.
Absolute x-ms-expiry-time harus ditentukan sebagai waktu absolut, dalam format RFC 1123.
NeverExpire Mengatur blob agar tidak pernah kedaluwarsa atau menghapus tanggal kedaluwarsa saat ini. x-ms-expiry-time tidak boleh ditentukan.

Semantik untuk mengatur tanggal kedaluwarsa pada blob adalah sebagai berikut:

  • Set Expiry hanya dapat diatur pada blob dan bukan direktori.
  • Set Expiry expiryTime dengan masa lalu tidak diperbolehkan.
  • ExpiryTime tidak dapat ditentukan dengan expiryOption nilai Never.

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 Put Blob permintaan berdasarkan jenis akun penyimpanan:

Operasi Jenis akun penyimpanan Kategori penagihan
Masukkan Blob Objek besar biner blok premium
Tujuan umum standar v2
Tujuan umum standar v1
Operasi tulis

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 service
Mengatur waktu habis untuk operasi Blob service