Set properti Blob

  • Artikel
  • 8 menit untuk membaca

Operasi Set Blob Properties mengatur properti sistem pada blob.

Minta

Permintaan Set Blob Properties dapat dibuat sebagai berikut. HTTPS disarankan. Ganti myaccount dengan nama akun penyimpanan Anda:

URI Permintaan Metode PUT Versi HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=properties HTTP/1.1

URI Layanan Storage 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 PUT Versi HTTP
http://127.0.0.1:10000/ devstoreaccount1/mycontainer/myblob?comp=properties 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
timeout Opsional. Parameter timeout dinyatakan dalam hitung detik. Untuk informasi selengkapnya, lihat Mengatur Batas Waktu untuk Operasi Blob Service.

Header Permintaan (Semua Jenis Blob)

Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional untuk semua jenis blob.

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 yang diotorisasi. Menentukan versi operasi yang akan digunakan untuk permintaan ini. Untuk informasi selengkapnya, lihat Penerapan versi untuk layanan Azure Storage.
x-ms-blob-cache-control Opsional. Memodifikasi string kontrol cache untuk blob.

Jika properti ini tidak ditentukan pada permintaan, maka properti akan dihapus untuk blob. Panggilan berikutnya ke Dapatkan Properti Blob tidak akan mengembalikan properti ini, kecuali jika secara eksplisit diatur pada blob lagi.
x-ms-blob-content-type Opsional. Mengatur jenis konten blob.

Jika properti ini tidak ditentukan pada permintaan, maka properti akan dihapus untuk blob. Panggilan berikutnya ke Dapatkan Properti Blob tidak akan mengembalikan properti ini, kecuali jika secara eksplisit diatur pada blob lagi.
x-ms-blob-content-md5 Opsional. Mengatur hash MD5 blob.

Jika properti ini tidak ditentukan pada permintaan, maka properti akan dihapus untuk blob. Panggilan berikutnya ke Dapatkan Properti Blob tidak akan mengembalikan properti ini, kecuali jika secara eksplisit diatur pada blob lagi.
x-ms-blob-content-encoding Opsional. Mengatur pengodean konten blob.

Jika properti ini tidak ditentukan pada permintaan, maka properti akan dihapus untuk blob. Panggilan berikutnya ke Dapatkan Properti Blob tidak akan mengembalikan properti ini, kecuali jika secara eksplisit diatur pada blob lagi.
x-ms-blob-content-language Opsional. Mengatur bahasa konten blob.

Jika properti ini tidak ditentukan pada permintaan, maka properti akan dihapus untuk blob. Panggilan berikutnya ke Dapatkan Properti Blob tidak akan mengembalikan properti ini, kecuali jika secara eksplisit diatur pada blob lagi.
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-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.
x-ms-blob-content-disposition Opsional. 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 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.

Respons dari operasi Dapatkan Properti Blob dan Dapatkan Blob menyertakan content-disposition header .
Origin Opsional. Menentukan asal dari mana permintaan dikeluarkan. Kehadiran header ini menghasilkan header berbagi sumber daya lintas asal pada respons. Lihat Dukungan CORS untuk Layanan Storage untuk detailnya.

Operasi ini juga mendukung penggunaan header kondisional untuk mengatur properti blob hanya jika kondisi tertentu terpenuhi. Untuk informasi selengkapnya, lihat Menentukan Header Kondisional untuk Operasi Blob Service.

Header Permintaan (Hanya Blob Halaman)

Tabel berikut ini menjelaskan header permintaan yang hanya berlaku untuk operasi pada blob halaman.

Header permintaan Deskripsi
x-ms-blob-content-length: byte value Opsional. Mengubah ukuran blob halaman ke ukuran yang ditentukan. Jika nilai yang ditentukan kurang dari ukuran blob saat ini, semua halaman di atas nilai yang ditentukan akan dihapus.

Properti ini tidak dapat digunakan untuk mengubah ukuran blob blok atau blob penambahan. Mengatur properti ini untuk blob blok atau blob penambahan mengembalikan kode status 400 (Permintaan Buruk).
x-ms-sequence-number-action: {max, update, increment} Opsional, tetapi diperlukan jika x-ms-blob-sequence-number header diatur untuk permintaan. Properti ini hanya berlaku untuk blob halaman.

Properti ini menunjukkan bagaimana layanan harus memodifikasi nomor urutan blob. Tentukan salah satu opsi berikut untuk properti ini:

- max: Mengatur nomor urut menjadi lebih tinggi dari nilai yang disertakan dengan permintaan dan nilai yang saat ini disimpan untuk blob.
- update: Mengatur nomor urut ke nilai yang disertakan dengan permintaan.
- increment: Menaikkan nilai nomor urut sebesar 1. Jika menentukan opsi ini, jangan sertakan x-ms-blob-sequence-number header; melakukannya akan mengembalikan kode status 400 (Permintaan Buruk).
x-ms-blob-sequence-number: <num> Opsional, tetapi diperlukan jika x-ms-sequence-number-action properti diatur ke max atau update. Properti ini hanya berlaku untuk blob halaman.

Properti ini menetapkan nomor urut blob. Nomor urut adalah properti yang dikontrol pengguna yang dapat Anda gunakan untuk melacak permintaan dan mengelola masalah konkurensi. Untuk informasi selengkapnya, lihat operasi Letakkan Halaman .

Gunakan properti ini bersama-sama dengan x-ms-sequence-number-action untuk memperbarui nomor urutan blob, baik ke nilai yang ditentukan atau ke nilai yang lebih tinggi yang ditentukan dengan permintaan atau saat ini disimpan dengan blob. Header ini tidak boleh ditentukan jika x-ms-sequence-number-action diatur ke increment; dalam hal ini layanan secara otomatis menaikkan nomor urut satu.

Untuk mengatur nomor urut ke nilai yang Anda pilih, properti ini harus ditentukan pada permintaan bersama dengan x-ms-sequence-number-action.

Header Permintaan (Kunci enkripsi yang disediakan pelanggan)

Dimulai dengan 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 sekumpulan header yang sesuai) bersifat opsional. Jika blob sebelumnya telah dienkripsi dengan kunci yang disediakan pelanggan, maka header ini harus disertakan pada permintaan untuk menyelesaikan operasi tulis dengan sukses.

Header permintaan 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

Tidak ada.

Respons

Respons mencakup kode status HTTP dan sekumpulan header respons.

Kode Status

Operasi yang berhasil mengembalikan kode status 200 (OK).

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
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.
Last-Modified Tanggal/waktu blob terakhir diubah. Format tanggal mengikuti RFC 1123. Untuk informasi selengkapnya, lihat Representasi Nilai Date-Time di Header.

Setiap operasi tulis pada blob (termasuk pembaruan pada metadata atau properti blob) mengubah waktu terakhir blob yang dimodifikasi.
x-ms-blob-sequence-number Jika blob adalah blob halaman, nomor urutan blob saat ini dikembalikan dengan header 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. Header ini 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 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.
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-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.

Isi Respons

Tidak ada.

Authorization

Operasi ini hanya dapat dipanggil oleh pemilik akun dan oleh siapa pun dengan Tanda Tangan Akses Bersama yang memiliki izin untuk menulis ke blob ini atau kontainernya.

Keterangan

Semantik untuk memperbarui properti blob adalah sebagai berikut:

  • Nomor urut blob halaman diperbarui hanya jika permintaan memenuhi salah satu kondisi berikut:

    • Permintaan mengatur ke x-ms-sequence-number-actionmax atau update, dan juga menentukan nilai untuk x-ms-blob-sequence-number header .

    • Permintaan menetapkan x-ms-sequence-number-action ke increment, yang menunjukkan bahwa layanan harus menaikkan nomor urut satu per satu.

  • Ukuran blob halaman dimodifikasi hanya jika permintaan menentukan nilai untuk x-ms-content-length header.

  • Untuk mengubah ukuran blob halaman di akun penyimpanan premium, ukuran baru tidak boleh melebihi panjang konten yang diizinkan oleh tingkat yang ada. Panggil Atur Tingkat Blob sebelum mengubah ukuran blob. Untuk daftar tingkatan dan panjang konten yang diizinkan, lihat Premium Storage berkinerja tinggi dan disk terkelola untuk VM.

  • Jika permintaan hanya x-ms-blob-sequence-number menetapkan dan/atau x-ms-content-length, dan tidak ada properti lain, maka tidak ada properti lain blob yang dimodifikasi.

  • Jika salah satu atau beberapa properti berikut diatur dalam permintaan, maka semua properti ini diatur bersama-sama. Jika nilai tidak disediakan untuk properti tertentu ketika setidaknya salah satu properti yang tercantum di bawah ini diatur, maka properti tersebut akan dibersihkan untuk blob.

    • x-ms-blob-cache-control

    • x-ms-blob-content-type

    • x-ms-blob-content-md5

    • x-ms-blob-content-encoding

    • x-ms-blob-content-language

    • x-ms-blob-content-disposition

Catatan

Perhatikan bahwa untuk tanda tangan akses bersama, Anda dapat mengambil alih properti tertentu yang disimpan untuk blob dengan menentukan parameter kueri sebagai bagian dari tanda tangan akses bersama. Properti ini termasuk cache-controlproperti , content-type, content-encoding, content-language, dan content-disposition . Untuk informasi selengkapnya, lihat Membuat layanan SAS.

Lihat juga

Mengotorisasi permintaan ke Azure Storage
Status dan Kode Kesalahan