Letakkan Blob Dari URL

Artikel
10/22/2024

Operasi Put Blob From URL membuat blob blok baru tempat konten blob dibaca dari URL tertentu. API ini tersedia pada versi 2020-04-08.

Pembaruan parsial tidak didukung dengan Put Blob From URL. Konten blob yang ada ditimpa dengan konten blob baru. Untuk melakukan pembaruan parsial pada konten blob blok dengan menggunakan URL sumber, gunakan API Put Block From URL bersama dengan Put Block List.

Ukuran blob sumber bisa hingga panjang maksimum 5.000 mebibyte (MiB).

Minta

Anda dapat membuat Put Blob From URL 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 layanan Blob 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 Menggunakan emulator Azurite untuk pengembangan Azure Storage lokal.

Parameter URI

Parameter tambahan berikut dapat ditentukan pada URI permintaan:

Parameter	Deskripsi
`timeout`	Fakultatif. Parameter `timeout` dinyatakan dalam hitung detik. Untuk informasi selengkapnya, lihat Mengatur batas waktu untuk operasi blob service.

Header permintaan

Header permintaan yang diperlukan dan opsional dijelaskan dalam tabel berikut:

Header permintaan	Deskripsi
`Authorization`	Diperlukan. Menentukan skema otorisasi, nama akun, dan tanda tangan. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage.
`Date` atau `x-ms-date`	Diperlukan. 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`	Diperlukan. Menentukan jumlah byte yang ditransmisikan dalam isi permintaan. Nilai header ini harus diatur ke 0. Ketika panjangnya bukan 0, operasi gagal dengan kode status 400 (Permintaan Buruk).
`x-ms-copy-source:name`	Diperlukan. Menentukan URL blob sumber. Nilainya mungkin url dengan panjang hingga 2 kibibyte (KiB) yang menentukan blob. Nilai harus dikodekan URL karena akan muncul dalam URI permintaan. Blob sumber harus publik atau diotorisasi melalui tanda tangan akses bersama. Jika blob sumber bersifat publik, tidak ada otorisasi yang diperlukan untuk melakukan operasi. Jika ukuran blob sumber lebih besar dari 5000 MiB, atau jika sumber tidak mengembalikan nilai `Content-Length` yang valid, permintaan gagal dengan kode status 409 (Konflik). Berikut adalah beberapa contoh URL objek sumber: - `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>`
`x-ms-copy-source-authorization: <scheme> <signature>`	Fakultatif. Menentukan skema otorisasi dan tanda tangan untuk sumber salinan. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage. Catatan: Hanya skema pembawa yang didukung untuk Microsoft Entra. Catatan: Jika objek sumber Anda dapat diakses secara publik atau objek sumber Anda berada di akun penyimpanan dan Anda menggunakan token SAS yang sedang diteruskan `x-ms-copy-source:name`, header ini tidak diperlukan. Header ini didukung dalam versi 2020-10-02 dan yang lebih baru.
`x-ms-blob-type: BlockBlob`	Diperlukan. Menentukan jenis blob yang akan dibuat, yang harus `BlockBlob`. Jika jenis blob tidak `BlockBlob`, operasi gagal dengan kode status 400 (Permintaan Buruk).
`Content-Type`	Fakultatif. Jenis konten MIME dari blob. Jenis defaultnya adalah `application/octet-stream`.
`Content-Encoding`	Fakultatif. Menentukan pengodean konten mana yang telah diterapkan ke blob. Nilai ini dikembalikan ke klien ketika operasi Get Blob dilakukan pada sumber daya blob. Ketika nilai ini dikembalikan, klien dapat menggunakannya untuk mendekode konten blob.
`Content-Language`	Fakultatif. Menentukan bahasa alami yang digunakan oleh sumber daya ini.
`Cache-Control`	Fakultatif. Blob Storage menyimpan nilai ini tetapi tidak menggunakan atau memodifikasinya.
`x-ms-source-content-md5`	Fakultatif. Hash MD5 dari konten blob dari URI. Hash ini digunakan untuk memverifikasi integritas blob selama pengangkutan data dari URI. Ketika header ini ditentukan, layanan penyimpanan membandingkan hash konten yang telah tiba dari sumber salin dengan nilai header ini. Jika header ini dihilangkan, Blob Storage menghasilkan hash MD5. Jika dua hash tidak cocok, operasi gagal dengan kode kesalahan 400 (Permintaan Buruk).
`x-ms-content-crc64`	Fakultatif. 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 di versi 02-02-2019 dan yang lebih baru. Jika header Content-MD5 dan x-ms-content-crc64 ada, permintaan gagal dengan 400 (Permintaan Buruk).
`x-ms-blob-content-type`	Fakultatif. Mengatur tipe konten blob.
`x-ms-blob-content-encoding`	Fakultatif. Mengatur pengodean konten blob.
`x-ms-blob-content-language`	Fakultatif. Mengatur bahasa konten blob.
`x-ms-blob-content-md5`	Fakultatif. Mengatur hash MD5 blob.
`x-ms-blob-cache-control`	Fakultatif. Mengatur kontrol cache blob.
`x-ms-meta-name:value`	Fakultatif. Pasangan nama-nilai yang terkait dengan blob sebagai metadata. Catatan: Mulai versi 2009-09-19, nama metadata harus mematuhi aturan penamaan untuk pengidentifikasi C# .
`x-ms-encryption-scope`	Fakultatif. Cakupan enkripsi yang digunakan untuk mengenkripsi konten permintaan. Header ini didukung dalam versi 2019-02-02 dan yang lebih baru.
`x-ms-tags`	Fakultatif. Mengatur tag yang dikodekan string kueri yang ditentukan pada blob. Untuk informasi selengkapnya, buka bagian Komentar . Didukung dalam versi 2019-12-12 dan yang lebih baru.
`x-ms-copy-source-tag-option`	Fakultatif. Nilai yang mungkin adalah REPLACE atau COPY (peka huruf besar/kecil). Nilai defaultnya adalah REPLACE. Jika COPY ditentukan, tag dari blob sumber disalin ke blob tujuan. Blob sumber harus privat, dan permintaan harus memiliki izin untuk Mendapatkan Tag Blob pada blob sumber dan Mengatur Tag Blob pada blob tujuan. Ini menimbulkan panggilan tambahan ke operasi Dapatkan Tag Blob pada akun sumber. REPLACE menetapkan tag yang ditentukan oleh header `x-ms-tags` pada blob tujuan. Jika REPLACE digunakan dan tidak ada tag yang ditentukan oleh `x-ms-tags`, tidak ada tag yang diatur pada blob tujuan. Menentukan SALINAN dan `x-ms-tags` menghasilkan 409 (Konflik). Didukung dalam versi 2021-04-10 dan yang lebih baru.
`x-ms-copy-source-blob-properties`	Fakultatif. Menentukan perilaku properti blob sumber salin. Jika diatur ke `True`, properti blob sumber akan disalin ke blob baru. Nilai defaultnya adalah `True`.
`x-ms-source-if-modified-since`	Fakultatif. Nilai `DateTime`. Tentukan header kondisional ini untuk meletakkan blob hanya jika blob sumber telah dimodifikasi sejak tanggal/waktu yang ditentukan. Jika blob sumber belum dimodifikasi, Blob Storage mengembalikan kode status 412 (Prasyarat Gagal). Header ini tidak dapat ditentukan jika sumbernya adalah berbagi Azure Files.
`x-ms-source-if-unmodified-since`	Fakultatif. Nilai `DateTime`. Tentukan header kondisional ini untuk meletakkan blob hanya jika blob sumber belum dimodifikasi sejak tanggal/waktu yang ditentukan. Jika blob sumber telah dimodifikasi, Blob Storage mengembalikan kode status 412 (Prasyarat Gagal). Header ini tidak dapat ditentukan jika sumbernya adalah berbagi Azure Files.
`x-ms-source-if-match`	Fakultatif. Nilai ETag. Tentukan header kondisional ini untuk menempatkan blob sumber hanya jika ETag-nya cocok dengan nilai yang ditentukan. Jika nilai ETag tidak cocok, Blob Storage mengembalikan kode status 412 (Prasyarat Gagal). Header ini tidak dapat ditentukan jika sumbernya adalah berbagi Azure Files.
`x-ms-source-if-none-match`	Fakultatif. Nilai ETag. Tentukan header kondisional ini untuk menempatkan blob hanya jika ETag-nya tidak cocok dengan nilai yang ditentukan. Jika nilainya identik, Blob Storage mengembalikan kode status 412 (Prasyarat Gagal). Header ini tidak dapat ditentukan jika sumbernya adalah berbagi Azure Files.
`If-Modified-Since`	Fakultatif. Nilai `DateTime`. Tentukan header kondisional ini untuk meletakkan blob hanya jika blob tujuan telah dimodifikasi sejak tanggal/waktu yang ditentukan. Jika blob tujuan belum dimodifikasi, Blob Storage mengembalikan kode status 412 (Prasyarat Gagal).
`If-Unmodified-Since`	Fakultatif. Nilai `DateTime`. Tentukan header kondisional ini untuk meletakkan blob hanya jika blob tujuan belum dimodifikasi sejak tanggal/waktu yang ditentukan. Jika blob tujuan telah dimodifikasi, Blob Storage mengembalikan kode status 412 (Prasyarat Gagal).
`If-Match`	Fakultatif. Nilai ETag. Tentukan nilai ETag untuk header kondisional ini untuk menempatkan blob hanya jika nilai ETag yang ditentukan cocok dengan nilai `ETag` untuk blob tujuan yang ada. Jika ETag untuk blob tujuan tidak cocok dengan ETag yang ditentukan untuk `If-Match`, Blob Storage mengembalikan kode status 412 (Prasyarat Gagal).
`If-None-Match`	Fakultatif. Nilai ETag, atau karakter kartubebas (). Tentukan nilai ETag untuk header kondisional ini untuk menempatkan blob hanya jika nilai ETag yang ditentukan tidak cocok dengan nilai ETag untuk blob tujuan. Tentukan karakter kartubebas () untuk melakukan operasi hanya jika blob tujuan tidak ada. Jika kondisi yang ditentukan tidak terpenuhi, Blob Storage mengembalikan kode status 412 (Prasyarat Gagal).
`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`	Fakultatif. Mengatur header `Content-Disposition` blob. Tersedia untuk versi 2013-08-15 dan yang lebih baru. Bidang header respons `Content-Disposition` menyampaikan informasi tambahan tentang cara memproses payload respons, dan dapat digunakan untuk melampirkan metadata tambahan. Misalnya, jika header diatur ke `attachment`, itu menunjukkan bahwa agen pengguna tidak boleh menampilkan respons. Sebagai gantinya, dialog Simpan Sebagai akan ditampilkan dengan nama file selain nama blob yang ditentukan. Respons dari operasi Get Blob dan Get Blob Properties menyertakan header .
`Origin`	Fakultatif. 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`	Fakultatif. Menyediakan nilai buram yang dihasilkan klien dengan batas karakter 1 kibibyte (KiB) yang dicatat dalam log analitik saat pengelogan analitik penyimpanan diaktifkan. Kami sangat menyarankan Anda menggunakan header ini untuk menghubungkan aktivitas sisi klien dengan permintaan yang diterima server.
`x-ms-access-tier`	Fakultatif. Menunjukkan tingkat yang akan diatur pada blob. Nilai yang valid untuk tingkat blob blok adalah `Hot`, `Cool`, `Cold`, dan `Archive`. Catatan: tingkat `Cold` didukung untuk versi 2021-12-02 dan yang lebih baru. `Hot`, `Cool`, dan `Archive` didukung untuk versi 2018-11-09 dan yang lebih baru. Untuk informasi selengkapnya tentang tingkatan blob blok, lihat tingkat penyimpanan Panas, dingin, dan arsip.
`x-ms-expiry-option`	Fakultatif. Versi 2023-08-03 dan yang lebih baru. Menentukan opsi tanggal kedaluwarsa untuk permintaan. Untuk informasi selengkapnya, lihatExpiryOption . Header ini valid untuk akun dengan namespace hierarki diaktifkan.
`x-ms-expiry-time`	Fakultatif. Versi 2023-08-03 dan yang lebih baru. Menentukan waktu ketika blob diatur kedaluwarsa. Format untuk tanggal kedaluwarsa bervariasi sesuai dengan `x-ms-expiry-option`. Untuk informasi selengkapnya, lihatExpiryOption . 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 (kunci enkripsi yang disediakan pelanggan)

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.

Header permintaan	Deskripsi
`x-ms-encryption-key`	Diperlukan. Kunci enkripsi AES-256 yang dikodekan Base64.
`x-ms-encryption-key-sha256`	Diperlukan. Hash SHA256 yang dikodekan Base64 dari kunci enkripsi.
`x-ms-encryption-algorithm: AES256`	Diperlukan. Menentukan algoritma yang akan digunakan untuk enkripsi. Nilai header ini harus `AES256`.

Isi permintaan

Tidak.

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: 2020-04-08  
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-copy-source: https://myaccount.blob.core.windows.net/mycontainer/myblob
x-ms-expiry-option: RelativeToNow
x-ms-expiry-time: 30000
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Content-Length: 0

Jawaban

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 Status dan kode kesalahan.

Header respons

Respons untuk operasi ini mencakup header berikut. Respons juga dapat menyertakan header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1 .

Header respons	Deskripsi
`ETag`	ETag berisi nilai yang dapat digunakan klien untuk melakukan operasi `PUT` kondisional dengan menggunakan header permintaan `If-Match`. Nilai ETag diapit dalam tanda kutip.
`Last-Modified`	Tanggal/waktu ketika 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 yang dikembalikan `Content-MD5` dihitung oleh Blob Storage. Header ini dikembalikan bahkan ketika permintaan tidak menyertakan header `Content-MD5` atau `x-ms-blob-content-md5`.
`x-ms-content-crc64`	Dikembalikan untuk blob blok sehingga klien dapat memeriksa integritas konten pesan. Nilai yang dikembalikan `x-ms-content-crc64` dihitung oleh Blob Storage. Header ini selalu dikembalikan.
`x-ms-request-id`	Mengidentifikasi permintaan yang dibuat secara unik, dan Anda dapat menggunakannya untuk memecahkan masalah permintaan. Untuk informasi selengkapnya, lihat Memecahkan masalah operasi API.
`x-ms-version`	Versi Blob Storage yang digunakan untuk menjalankan permintaan.
`Date`	Nilai tanggal/waktu UTC yang dihasilkan oleh layanan, yang menunjukkan waktu ketika respons dimulai.
`Access-Control-Allow-Origin`	Dikembalikan jika permintaan menyertakan header `Origin` 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 header `Origin` 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 header `Origin` dan CORS diaktifkan dengan aturan yang cocok yang tidak mengizinkan semua asal. Header ini diatur ke `true`.
`x-ms-request-server-encrypted: true/false`	Nilai header ini diatur ke `true` jika konten permintaan berhasil dienkripsi dengan menggunakan algoritma yang ditentukan. Jika tidak, nilai diatur ke `false`.
`x-ms-encryption-key-sha256`	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`	Dikembalikan jika permintaan menggunakan cakupan enkripsi, sehingga klien dapat memastikan konten permintaan berhasil dienkripsi dengan menggunakan cakupan enkripsi.
`x-ms-version-id: <DateTime>`	Mengembalikan nilai `DateTime` buram yang secara unik mengidentifikasi blob. Nilai header ini menunjukkan versi blob, dan dapat digunakan dalam permintaan berikutnya untuk mengakses blob.

Isi respons

Tidak.

Sampel respons

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>

Otorisasi

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

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

Penting

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

MICROSOFT Entra ID (disarankan)
tanda tangan akses bersama (SAS)
kunci bersama

Azure Storage mendukung penggunaan ID Microsoft Entra 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. Prinsip keamanan mungkin pengguna, grup, perwakilan layanan aplikasi, atau identitas terkelola Azure. Prinsip keamanan diautentikasi oleh MICROSOFT Entra ID untuk mengembalikan token OAuth 2.0. Token kemudian dapat digunakan untuk mengotorisasi permintaan terhadap layanan Blob.

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

Izin

Tercantum di bawah ini adalah tindakan RBAC yang diperlukan untuk pengguna, grup, identitas terkelola, atau perwakilan layanan Microsoft Entra untuk memanggil operasi Put Blob From URL, 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 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 Put Blob From URL mendukung tiga jenis tanda tangan akses bersama: delegasi pengguna SAS, layanan SAS, dan akun SAS.

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 lebih lanjut, lihat Memahami bagaimana melarang Kunci Bersama memengaruhi token SAS.

Delegasi pengguna SAS

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

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

Operasi	Izin bertanda tangan
Letakkan Blob Dari URL (buat blob blok baru)	Buat (c) atau Tulis (w)
Letakkan Blob Dari URL (timpa blob blok yang ada)	Tulis (w)

Untuk mempelajari selengkapnya tentang SAS delegasi pengguna, lihat Membuat delegasi pengguna SAS.

SAS Layanan

SAS layanan diamankan dengan kunci akun penyimpanan. SAS layanan mendelegasikan akses ke sumber daya dalam satu layanan Azure Storage, seperti penyimpanan blob.

Memanggil operasi Put Blob From URL menggunakan token SAS yang didelegasikan ke sumber daya kontainer atau blob memerlukan izin berikut sebagai bagian dari token SAS layanan.

Operasi	Izin bertanda tangan
Letakkan Blob Dari URL (buat blob blok baru)	Buat (c) atau Tulis (w)
Letakkan Blob Dari URL (timpa blob blok yang ada)	Tulis (w)

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

AKUN SAS

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

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 bertanda tangan
Letakkan Blob Dari URL (buat blob blok baru)	Blob (b)	Objek (o)	Buat (c) atau Tulis (w)
Letakkan Blob Dari URL (timpa blob blok yang ada)	Blob (b)	Objek (o)	Tulis (w)

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

Komentar

Operasi Put Blob From URL didukung pada versi 2020-04-08.

Dalam versi 2020-10-02 dan yang lebih baru, otorisasi Microsoft Entra didukung untuk sumber operasi salin.

Blob sumber mungkin dari jenis apa pun, termasuk blob blok, blob penambahan, atau blob halaman. Namun, blob tujuan harus berupa blob blok.

Operasi Put Blob From URL selalu menyalin seluruh blob sumber. Menyalin rentang byte atau sekumpulan blok tidak didukung. Untuk melakukan pembaruan parsial, lihat Put Block From URL. Blob tujuan dapat menjadi blob blok yang ada, atau bisa menjadi blob baru yang dibuat oleh operasi.

Saat Anda menggunakan blob blok sebagai objek sumber, semua konten blob yang diterapkan akan disalin. Namun, daftar blokir tidak dipertahankan, dan blok yang tidak dikomit tidak disalin. Konten blob tujuan identik dengan sumber, tetapi daftar blok yang diterapkan tidak dipertahankan.

Menempatkan properti Blob dan metadata

Saat Anda membuat blob blok dari sumber salinan, properti blob standar disalin secara default dari blob sumber. Jika metadata aplikasi ditentukan dalam permintaan, metadata blob sumber disimpan tanpa menyalin metadata blob sumber. Untuk secara eksplisit mengatur header konten HTTP apa pun, Anda dapat menentukan header yang sesuai dalam permintaan.

Content-Type
Content-Encoding
Content-Length
Cache-Control
Content-Disposition

Ukuran blob tujuan selalu cocok dengan blob sumber. Header Content-Length harus 0 dalam permintaan Put Blob From URL (karena tidak ada isi permintaan), dan properti panjang konten untuk blob tujuan disimpulkan dari ukuran sumber.

Menempatkan Blob Dari properti kustom URL

Put Blob From Url mengikuti semantik yang sama dengan Put Blob untuk mengatur properti kustom yang terkait dengan header HTTP standar. Untuk informasi selengkapnya, lihat properti kustom Blob

tag indeks Blob

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

Jika tag tidak disediakan di header x-ms-tags, tag tersebut tidak disalin dari blob sumber.

Cakupan Enkripsi dan kunci yang disediakan pelanggan

API Put Blob From URL mendukung cakupan enkripsi dan kunci yang disediakan pelanggan, dengan menggunakan header x-ms-encryption-scope dan x-ms-encryption-key.

Jika header x-ms-copy-source mengacu pada blob sumber yang sama dengan blob tujuan dalam URI permintaan, operasi Put Blob From URL melakukan penulisan ulang blob di tempat yang sinkron. Ini memungkinkan penulisan ulang blob untuk menggunakan kunci enkripsi atau cakupan enkripsi yang berbeda.

Penagihan

Permintaan harga dapat berasal dari klien yang menggunakan API Blob Storage, baik secara 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, transaksi baca bertambah ke kategori penagihan yang berbeda dari transaksi tulis. Tabel berikut ini memperlihatkan kategori penagihan untuk permintaan Put Blob From URL berdasarkan jenis akun penyimpanan:

Operasi	Jenis akun penyimpanan	Kategori penagihan
Letakkan Blob Dari URL (akun tujuan¹)	Blob blok premium Tujuan umum standar v2 Tujuan umum standar v1	Operasi tulis
Letakkan Blob Dari URL (akun sumber²)	Blob blok premium Tujuan umum standar v2 Tujuan umum standar v1	Membaca operasi

¹Akun tujuan dikenakan biaya untuk satu transaksi untuk memulai penulisan.
²Akun sumber menimbulkan satu transaksi untuk setiap permintaan baca ke objek sumber.

Selain itu, jika akun sumber dan tujuan berada di wilayah yang berbeda (misalnya, US Utara dan AS Selatan), bandwidth yang digunakan untuk mentransfer permintaan dibebankan ke akun penyimpanan sumber sebagai keluar. Keluar antara akun dalam wilayah yang sama gratis.

Terakhir, membuat blob baru dengan nama yang berbeda dalam akun penyimpanan yang sama menggunakan sumber daya penyimpanan tambahan, sehingga operasi menghasilkan biaya terhadap penggunaan kapasitas akun penyimpanan untuk sumber daya tambahan tersebut.

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

Lihat juga

Mengotorisasi permintaan ke Status Azure Storage dan kode kesalahan kode kesalahan layanan Blob Mengatur batas waktu untuk operasi layanan Blob

Bagikan melalui