Masukkan Blob

Artikel
02/03/2024

Operasi ini Put Blob membuat blok, halaman, atau blob penambahan baru, atau memperbarui konten blob blok yang ada. Operasi ini Put Blob akan 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 ditimulasi

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

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

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 sudah ada, panggil Letakkan Halaman. Untuk menulis konten ke blob penambahan, panggil Tambahkan Blok.
`Content-Type`	Pilihan. 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.
`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 dalam 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 .

Azure Storage mendukung penggunaan Microsoft Entra ID untuk mengotorisasi permintaan ke data blob. Dengan Microsoft Entra ID, Anda dapat menggunakan kontrol akses berbasis peran Azure (Azure RBAC) untuk memberikan izin kepada prinsip keamanan. Perwakilan keamanan mungkin pengguna, grup, perwakilan layanan aplikasi, atau identitas terkelola Azure. Perwakilan keamanan diautentikasi oleh Microsoft Entra ID untuk mengembalikan token OAuth 2.0. Token kemudian dapat digunakan untuk mengotorisasi permintaan terhadap Blob service.

Untuk mempelajari selengkapnya tentang otorisasi menggunakan Microsoft Entra ID, lihat Mengotorisasi akses ke blob menggunakan Microsoft Entra ID.

Izin

Tercantum di bawah ini adalah tindakan RBAC yang diperlukan untuk pengguna, grup, atau perwakilan layanan yang Microsoft Entra untuk memanggil Put Blob operasi, dan peran Azure RBAC bawaan yang paling tidak istimewa yang mencakup tindakan ini:

Tindakan Azure RBAC:
- Membuat blob blok baru: Microsoft.Storage/storageAccounts/blobServices/containers/blobs/add/action
- Membuat blob blok baru atau menimpa blob yang ada: Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
Peran bawaan dengan hak istimewa paling sedikit:Kontributor Data Blob Penyimpanan

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

Tanda tangan akses bersama (SAS) menyediakan akses yang didelegasikan dengan aman ke sumber daya di akun penyimpanan. Dengan SAS, Anda memiliki kontrol terperinci atas bagaimana klien dapat mengakses data. Anda dapat menentukan sumber daya apa yang dapat diakses klien, izin apa yang mereka miliki ke sumber daya tersebut, dan berapa lama SAS valid.

Operasi ini Put 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 selengkapnya, lihat Memahami bagaimana melarang Kunci Bersama memengaruhi token SAS.

Delegasi pengguna SAS

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

Memanggil Put Blob operasi menggunakan token SAS yang didelegasikan ke kontainer atau sumber daya blob memerlukan izin berikut sebagai bagian dari token SAS delegasi pengguna:

Operasi	Izin yang ditandatangani
Letakkan Blob (buat blob blok baru)	Buat (c) atau Tulis (w)
Letakkan Blob (timpa blob blok yang ada)	Tulis (w)

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 Put Blob operasi menggunakan token SAS yang didelegasikan ke kontainer atau sumber daya blob memerlukan izin berikut sebagai bagian dari token SAS layanan.

Operasi	Izin yang ditandatangani
Letakkan Blob (buat blob blok baru)	Buat (c) atau Tulis (w)
Letakkan Blob (timpa blob blok yang ada)	Tulis (w)

Untuk mempelajari selengkapnya tentang layanan SAS, lihat Membuat LAYANAN SAS.

Akun SAS

Akun SAS diamankan dengan kunci akun penyimpanan. Akun SAS delegasikan akses ke sumber daya di satu atau beberapa layanan penyimpanan. Semua operasi yang tersedia melalui layanan atau delegasi pengguna SAS juga tersedia melalui akun SAS.

Tabel berikut menunjukkan jenis sumber daya yang ditandatangani dan izin yang ditandatangani untuk ditentukan saat mendelegasikan akses:

Operasi	Layanan yang ditandatangani	Jenis sumber daya yang ditandatangani	Izin yang ditandatangani
Letakkan Blob (buat blob blok baru)	Blob (b)	Objek (o)	Buat (c) atau Tulis (w)
Letakkan Blob (timpa blob blok yang ada)	Blob (b)	Objek (o)	Tulis (w)

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

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 Letakkan Halaman untuk menambahkan konten ke blob atau untuk mengubahnya.

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.

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 kemudian 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 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 sampai kedaluwarsa atau dirilis.

Put Blob Operasi diizinkan 10 menit per MiB untuk diselesaikan. Jika operasi membutuhkan waktu rata-rata lebih dari 10 menit per MiB, 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 saat ini.
`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 ExpiryexpiryTime 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 bagaimana akun ditagih. Misalnya, membaca transaksi 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