Masukkan Blob Dari URL

Operasi membuat Put Blob From URL blob blok baru di mana 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 Blob From URL bersama dengan Put Block List.

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

Minta

Anda dapat membangun 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 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

Header permintaan yang diperlukan dan opsional 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. Menentukan jumlah byte yang dikirimkan 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	Wajib diisi. Menentukan URL blob sumber. Nilainya mungkin url dengan panjang hingga 2 kibibyte (KiB) yang menentukan blob. Nilai harus dikodekan URL seperti yang 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 yang valid Content-Length , 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>	Opsional. Menentukan skema otorisasi dan tanda tangan untuk sumber salinan. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage. Hanya pembawa skema yang didukung untuk Azure Active Directory. Header ini didukung dalam versi 2020-10-02 dan yang lebih baru.
x-ms-blob-type: BlockBlob	Wajib diisi. Menentukan jenis blob yang akan dibuat, yang harus BlockBlob. Jika jenis blob tidak BlockBlob, operasi gagal dengan kode status 400 (Permintaan Buruk).
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.
Cache-Control	Pilihan. Blob Storage menyimpan nilai ini tetapi tidak menggunakan atau memodifikasinya.
x-ms-source-content-md5	Pilihan. 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	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 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	Pilihan. Mengatur jenis konten blob.
x-ms-blob-content-encoding	Pilihan. Mengatur pengodean konten blob.
x-ms-blob-content-language	Pilihan. Mengatur bahasa konten blob.
x-ms-blob-content-md5	Pilihan. Mengatur hash MD5 blob.
x-ms-blob-cache-control	Pilihan. Mengatur kontrol cache blob.
x-ms-meta-name:value	Pilihan. 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. Cakupan enkripsi yang digunakan untuk mengenkripsi konten permintaan. Header ini didukung dalam versi 2019-02-02 dan yang lebih baru.
x-ms-tags	Pilihan. Mengatur tag yang dikodekan string kueri yang ditentukan pada blob. Untuk informasi selengkapnya, buka bagian Keterangan . Didukung dalam versi 2019-12-12 dan yang lebih baru.
x-ms-copy-source-tag-option	Pilihan. 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 bersifat 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 di akun sumber. REPLACE mengatur tag yang ditentukan oleh x-ms-tags header 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 COPY dan x-ms-tags menghasilkan 409 (Konflik). Didukung dalam versi 2021-04-10 dan yang lebih baru.
x-ms-copy-source-blob-properties	Pilihan. 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	Opsional. 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	Pilihan. 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	Pilihan. 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	Pilihan. 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	Pilihan. 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	Pilihan. 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	Pilihan. Nilai ETag. Tentukan nilai ETag untuk header kondisional ini untuk menempatkan blob hanya jika nilai ETag yang ditentukan cocok dengan ETag nilai 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	Pilihan. 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	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 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 analitik penyimpanan diaktifkan. Kami sangat menyarankan Anda menggunakan header ini untuk menghubungkan aktivitas sisi klien dengan permintaan yang diterima server.
x-ms-access-tier	Pilihan. Menunjukkan tingkat yang akan diatur pada blob. 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. 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	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 (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.

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

Tidak ada.

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

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	ETag berisi nilai yang dapat digunakan klien untuk melakukan operasi kondisional PUT dengan menggunakan If-Match header permintaan. 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. 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.
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	Versi Blob Storage yang digunakan untuk menjalankan permintaan.
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	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 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 From URL dijelaskan di bawah ini.

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

Microsoft Entra ID

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 From URL operasi, dan peran Azure RBAC bawaan yang paling tidak istimewa yang mencakup tindakan ini:

• Tindakan Azure RBAC:
  • Create blob blok baru: Microsoft.Storage/storageAccounts/blobServices/containers/blobs/add/action
  • Create baru atau timpa blob blok 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)

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 From URL 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 From URL 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 Dari URL (buat blob blok baru)	Create (c) atau Tulis (w)
Letakkan Blob Dari URL (timpa blob blok yang ada)	Tulis (w)

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

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 From URL 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 Dari URL (buat blob blok baru)	Create (c) atau Tulis (w)
Letakkan Blob Dari URL (timpa blob blok yang ada)	Tulis (w)

Untuk mempelajari selengkapnya tentang layanan SAS, lihat Create 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 menentukan saat mendelegasikan akses:

Operasi	Layanan yang ditandatangani	Jenis sumber daya yang ditandatangani	Izin yang ditandatangani
Letakkan Blob Dari URL (buat blob blok baru)	Blob (b)	Objek (o)	Create (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 Create akun SAS.

Kunci Bersama

Operasi ini Put Blob From URL mendukung otorisasi Kunci Bersama. Otorisasi dengan kunci akun tidak disarankan untuk sebagian besar skenario, karena kurang aman.

Microsoft merekomendasikan untuk melarang otorisasi Kunci Bersama untuk akun penyimpanan jika memungkinkan. Untuk informasi selengkapnya, lihat Mencegah otorisasi dengan Kunci Bersama.

Keterangan

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

Dalam versi 2020-10-02 dan yang lebih baru, otorisasi Azure Active Directory 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 dapat 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 dan metadata Blob

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 Put Blob From URL permintaan (karena tidak ada isi permintaan), dan properti panjang konten untuk blob tujuan disimpulkan dari ukuran sumber.

Letakkan properti kustom Blob Dari URL

Put Blob From Url mengikuti semantik yang sama seperti 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 x-ms-tags header , tag tersebut 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 2 KiB tag. Jika diperlukan lebih banyak tag, gunakan Set Blob Tags operasi .

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

Cakupan enkripsi dan kunci yang disediakan pelanggan

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

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

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 From URL permintaan berdasarkan jenis akun penyimpanan:

Operasi	Jenis akun penyimpanan	Kategori penagihan
Letakkan Blob Dari URL (akun tujuan1)	Objek besar biner blok premium Tujuan umum standar v2 Tujuan umum standar v1	Operasi tulis
Letakkan Blob Dari URL (akun sumber2)	Objek besar biner blok premium Tujuan umum standar v2 Tujuan umum standar v1	Membacakan operasi

¹Akun tujuan dibebankan 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, AS Utara dan AS Selatan), bandwidth yang digunakan untuk mentransfer permintaan dibebankan ke akun penyimpanan sumber sebagai keluar. Keluar antar 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 Storagedan kode kesalahanKode kesalahan blob serviceMengatur waktu habis untuk operasi blob service