Set properti Blob

  • Artikel

Operasi Set Blob Properties menetapkan properti sistem pada blob.

Minta

Permintaan Set Blob Properties dapat dibuat 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?comp=properties HTTP/1.1

URI Layanan Penyimpanan Yang Ditimulasi

Saat Anda membuat permintaan terhadap layanan penyimpanan yang ditimulasi, tentukan nama host emulator dan port Blob Storage 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 Gunakan emulator Azurite untuk pengembangan Microsoft Azure Storage lokal.

Parameter URI

Anda dapat menentukan parameter tambahan berikut pada URI permintaan:

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

Header permintaan (semua jenis blob)

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

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.
x-ms-blob-cache-control Opsional. Memodifikasi string kontrol cache untuk blob.

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

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

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

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

Jika properti ini tidak ditentukan pada permintaan, properti akan dihapus untuk blob. Panggilan berikutnya ke Dapatkan Properti Blob tidak 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 Pilihan. Menyediakan nilai buram yang dihasilkan klien dengan batas karakter 1 kibibyte (KiB) yang dicatat dalam log saat pengelogan dikonfigurasi. Kami sangat menyarankan Anda menggunakan header ini untuk menghubungkan aktivitas sisi klien dengan permintaan yang diterima server. Untuk informasi selengkapnya, lihat Memantau Azure Blob Storage.
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 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 Pilihan. Menentukan asal dari mana permintaan dikeluarkan. Kehadiran header ini menghasilkan header berbagi sumber daya lintas asal pada respons. Untuk informasi selengkapnya, lihat dukungan CORS (berbagi sumber daya lintas asal) untuk layanan Azure Storage.

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

Header permintaan (hanya blob halaman)

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

Meminta kop 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 blob halaman dengan nilai yang lebih besar dari 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 urut 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 angka urutan sebesar 1. Jika Anda menentukan opsi ini, jangan sertakan x-ms-blob-sequence-number header. Melakukannya 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 mengatur 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 urut blob ke nilai yang ditentukan atau nilai yang lebih tinggi yang ditentukan dengan permintaan atau yang 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 menambah 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.

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

Sintaks Deskripsi
ETag Berisi nilai yang dapat Anda gunakan untuk melakukan operasi secara kondisional. Lihat Menentukan header kondisional untuk operasi Blob Storage untuk informasi selengkapnya. Jika versi permintaan adalah 2011-08-18 atau yang lebih baru, nilai ETag diapit dalam tanda kutip.
Last-Modified Tanggal/waktu 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.
x-ms-blob-sequence-number Jika blob adalah blob halaman, nomor urutan blob saat ini dikembalikan dengan header ini.
x-ms-request-id Secara unik mengidentifikasi permintaan yang dibuat dan dapat digunakan untuk memecahkan masalah permintaan. Untuk informasi selengkapnya, lihat Memecahkan masalah operasi API.
x-ms-version Menunjukkan versi Blob Storage yang digunakan untuk 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 saat respons dimulai.
Access-Control-Allow-Origin Dikembalikan jika permintaan menyertakan Origin header dan CORS diaktifkan dengan aturan yang cocok. Jika ada kecocokan, header ini mengembalikan nilai header permintaan asal.
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 akan diatur ke true.
x-ms-client-request-id 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 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.

Isi Respons

Tidak ada.

Authorization

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

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 Set Blob Properties 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

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 menentukan nilai untuk x-ms-blob-sequence-number header .

    • Permintaan mengatur ke x-ms-sequence-number-actionincrement, yang menunjukkan bahwa layanan harus menambah nomor urut 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. Atur Tingkat Blob panggilan sebelum Anda mengubah ukuran blob. Untuk daftar tingkatan dan panjang konten yang diizinkan, lihat Penyimpanan premium berkinerja tinggi dan disk terkelola untuk VM.

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

  • Jika satu atau beberapa properti berikut diatur dalam permintaan, semua properti diatur bersama-sama. Jika nilai tidak disediakan untuk properti ketika setidaknya salah satunya diatur, properti tersebut akan dihapus 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

Untuk tanda tangan akses bersama (SAS), 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.

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

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

Untuk mempelajari tentang harga untuk kategori penagihan yang ditentukan, lihat harga Azure Blob Storage.

Lihat juga