Share via

URL'den Blob Yerleştir

  • Makale

İşlem, Put Blob From URL blobun içeriğinin belirtilen URL'den okunduğu yeni bir blok blobu oluşturur. Bu API, 2020-04-08 sürümünden itibaren kullanılabilir.

Kısmi güncelleştirmeler ile Put Blob From URLdesteklenmez. Mevcut blobun içeriğinin üzerine yeni blobun içeriği yazılır. Kaynak URL kullanarak blok blobunun içeriğinde kısmi güncelleştirmeler gerçekleştirmek için ile birlikte Put Block ListURL'den Blob Koyma API'sini kullanın.

Kaynak blobun boyutu en fazla 5.000 mebibayt (MiB) uzunluğunda olabilir.

İstek

öğesini Put Blob From URL aşağıdaki gibi oluşturabilirsiniz. HTTPS kullanmanızı öneririz. myaccount değerini depolama hesabınızın adıyla değiştirin:

PUT yöntemi istek URI'si HTTP sürümü
https://myaccount.blob.core.windows.net/mycontainer/myblob HTTP/1.1

Öykünülmüş depolama hizmeti isteği

Öykünülen depolama hizmetine karşı istekte bulunulduğunda öykünücü ana bilgisayar adını ve Blob hizmeti bağlantı noktasını olarak 127.0.0.1:10000ve ardından öykünülen depolama hesabı adını belirtin:

PUT yöntemi istek URI'si HTTP sürümü
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.1

Depolama öykünücüsü yalnızca 2 gibibayta (GiB) kadar blob boyutlarını destekler.

Daha fazla bilgi için bkz . Yerel Azure Depolama geliştirmesi için Azurite öykünücüsü kullanma.

URI parametreleri

İstek URI'sinde aşağıdaki ek parametreler belirtilebilir:

Parametre Açıklama
timeout İsteğe bağlı. timeout parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz. Blob hizmeti işlemleri için zaman aşımlarını ayarlama.

İstek üst bilgileri

Gerekli ve isteğe bağlı istek üst bilgileri aşağıdaki tabloda açıklanmıştır:

İstek üst bilgisi Açıklama
Authorization Gereklidir. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme.
Date veya x-ms-date Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) biçimini belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme.
x-ms-version Tüm yetkili istekler için gereklidir. Bu istek için kullanılacak işlemin sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
Content-Length Gereklidir. İstek gövdesinde iletilen bayt sayısını belirtir. Bu üst bilginin değeri 0 olarak ayarlanmalıdır. Uzunluk 0 olmadığında işlem 400 (Hatalı İstek) durum koduyla başarısız olur.
x-ms-copy-source:name Gereklidir. Kaynak blobun URL'sini belirtir. Değer, blob belirten 2 kibibayt (KiB) uzunluğunda bir URL olabilir. Değer, istek URI'sinde göründüğü gibi URL ile kodlanmış olmalıdır. Kaynak blob ortak olmalıdır veya paylaşılan erişim imzası aracılığıyla yetkilendirilmelidir. Kaynak blob genel ise, işlemi gerçekleştirmek için yetkilendirme gerekmez. Kaynak blobun boyutu 5000 MiB'den büyükse veya kaynak geçerli Content-Length bir değer döndürmezse istek 409 (Çakışma) durum koduyla başarısız olur. Aşağıda kaynak nesne URL'lerinin bazı örnekleri verilmiştir:

- 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> İsteğe bağlı. Kopyalama kaynağı için yetkilendirme düzenini ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme.
Microsoft Entra için yalnızca şema taşıyıcı desteklenir.
Bu üst bilgi 2020-10-02 ve sonraki sürümlerde desteklenir.
x-ms-blob-type: BlockBlob Gereklidir. Oluşturulacak blobun türünü belirtir ve bu türün olması BlockBlobgerekir. Blob türü değilse BlockBlob, işlem 400 (Hatalı İstek) durum koduyla başarısız olur.
Content-Type İsteğe bağlı. Blobun MIME içerik türü. Varsayılan tür şeklindedir application/octet-stream.
Content-Encoding İsteğe bağlı. Bloba hangi içerik kodlamalarının uygulandığını belirtir. Blob kaynağında Blob Al işlemi gerçekleştirildiğinde bu değer istemciye döndürülür. Bu değer döndürülürse, istemci blob içeriğinin kodunu çözmek için bunu kullanabilir.
Content-Language İsteğe bağlı. Bu kaynak tarafından kullanılan doğal dilleri belirtir.
Cache-Control İsteğe bağlı. Blob Depolama bu değeri depolar ancak kullanmaz veya değiştirmez.
x-ms-source-content-md5 İsteğe bağlı. URI'den blob içeriğinin MD5 karması. Bu karma, verilerin URI'den taşınması sırasında blobun bütünlüğünü doğrulamak için kullanılır. Bu üst bilgi belirtildiğinde, depolama hizmeti kopyalama kaynağından gelen içeriğin karması ile bu üst bilgi değerini karşılaştırır. Bu üst bilgi atlanırsa, Blob Depolama bir MD5 karması oluşturur.

İki karma eşleşmezse işlem 400 (Hatalı İstek) hata koduyla başarısız olur.
x-ms-content-crc64 İsteğe bağlı. Blob içeriğinin CRC64 karması. Bu karma, taşıma sırasında blobun bütünlüğünü doğrulamak için kullanılır. Bu üst bilgi belirtildiğinde, depolama hizmeti gönderilen karmaya göre gelen karmayı denetler. İki karma eşleşmezse işlem 400 (Hatalı İstek) hata koduyla başarısız olur. Bu üst bilgi 02-02-2019 ve sonraki sürümlerde desteklenir.

Hem Content-MD5 hem de x-ms-content-crc64 üst bilgileri varsa, istek 400 (Hatalı İstek) ile başarısız olur.
x-ms-blob-content-type İsteğe bağlı. Blob'un içerik türünü ayarlar.
x-ms-blob-content-encoding İsteğe bağlı. Blob'un içerik kodlamasını ayarlar.
x-ms-blob-content-language İsteğe bağlı. Blob'un içerik dilini ayarlar.
x-ms-blob-content-md5 İsteğe bağlı. Blob'un MD5 karması olarak ayarlar.
x-ms-blob-cache-control İsteğe bağlı. Blob'un önbellek denetimini ayarlar.
x-ms-meta-name:value İsteğe bağlı. Blob ile meta veri olarak ilişkili ad-değer çiftleri.

Not: 2009-09-19 sürümünden itibaren meta veri adları C# tanımlayıcıları için adlandırma kurallarına uymalıdır.
x-ms-encryption-scope İsteğe bağlı. İstek içeriğini şifrelemek için kullanılacak şifreleme kapsamı. Bu üst bilgi 2019-02-02 ve sonraki sürümlerde desteklenir.
x-ms-tags İsteğe bağlı. Blob üzerinde belirtilen sorgu dizesi kodlanmış etiketlerini ayarlar. Daha fazla bilgi için Açıklamalar bölümüne gidin. 2019-12-12 ve sonraki sürümlerde desteklenir.
x-ms-copy-source-tag-option İsteğe bağlı. Olası değerler DEĞİşTİr veya KOPYALA 'dır (büyük/küçük harfe duyarlı). Varsayılan değer DEĞİşTİr'dir.

COPY belirtilirse, kaynak blobdaki etiketler hedef bloba kopyalanır. Kaynak blob özel olmalı ve isteğin kaynak blobda Blob Etiketlerini Alma ve Hedef blobda Blob Etiketlerini Ayarlama izni olmalıdır. Bu, kaynak hesaptaki Blob Etiketlerini Al işlemine ek bir çağrıya neden olur.

DEĞİşTİr, hedef blobdaki x-ms-tags üst bilgi tarafından belirtilen etiketleri ayarlar. DEĞİşTİr kullanılırsa ve tarafından x-ms-tagshiçbir etiket belirtilmezse, hedef blobda hiçbir etiket ayarlanmadı. COPY değerini ve x-ms-tags sonuçları 409 (Çakışma) olarak belirtme.

2021-04-10 ve sonraki sürümlerde desteklenir.
x-ms-copy-source-blob-properties İsteğe bağlı. Kaynak blob özelliklerini kopyalama davranışını belirtir. olarak ayarlanırsa True, kaynak blobun özellikleri yeni bloba kopyalanır. True varsayılan değerdir.
x-ms-source-if-modified-since İsteğe bağlı. Bir DateTime değer. Blobu koymak için bu koşullu üst bilgiyi yalnızca kaynak blob belirtilen tarih/saatten sonra değiştirilmişse belirtin. Kaynak blob değiştirilmediyse Blob Depolama 412 (Önkoşul Başarısız) durum kodunu döndürür. Kaynak bir Azure Dosyalar paylaşımıysa bu üst bilgi belirtilemiyor.
x-ms-source-if-unmodified-since İsteğe bağlı. Bir DateTime değer. Blobu koymak için bu koşullu üst bilgiyi yalnızca kaynak blob belirtilen tarih/saatten sonra değiştirilmediyse belirtin. Kaynak blob değiştirildiyse, Blob Depolama 412 durum kodunu döndürür (Önkoşul Başarısız oldu). Kaynak bir Azure Dosyalar paylaşımıysa bu üst bilgi belirtilemiyor.
x-ms-source-if-match İsteğe bağlı. ETag değeri. Kaynak blobu yalnızca ETag'i belirtilen değerle eşleştiğinde yerleştirmek için bu koşullu üst bilgiyi belirtin. ETag değerleri eşleşmiyorsa Blob Depolama 412 (Önkoşul Başarısız) durum kodunu döndürür. Kaynak bir Azure Dosyalar paylaşımıysa bu üst bilgi belirtilemiyor.
x-ms-source-if-none-match İsteğe bağlı. ETag değeri. Blobu yalnızca ETag'i belirtilen değerle eşleşmiyorsa yerleştirmek için bu koşullu üst bilgiyi belirtin. Değerler aynıysa, Blob Depolama 412 (Önkoşul Başarısız) durum kodunu döndürür. Kaynak bir Azure Dosyalar paylaşımıysa bu üst bilgi belirtilemiyor.
If-Modified-Since İsteğe bağlı. Bir DateTime değer. Blobu koymak için bu koşullu üst bilgiyi belirtin; yalnızca hedef blob belirtilen tarih/saatten sonra değiştirilmişse. Hedef blob değiştirilmediyse, Blob Depolama 412 durum kodunu döndürür (Önkoşul Başarısız oldu).
If-Unmodified-Since İsteğe bağlı. Bir DateTime değer. Yalnızca hedef blob belirtilen tarih/saatten sonra değiştirilmediyse blobu yerleştirmek için bu koşullu üst bilgiyi belirtin. Hedef blob değiştirildiyse, Blob Depolama 412 durum kodunu döndürür (Önkoşul Başarısız oldu).
If-Match İsteğe bağlı. ETag değeri. Blobu koymak için bu koşullu üst bilgi için bir ETag değeri belirtin; yalnızca belirtilen ETag değeri mevcut hedef blob için değerle ETag eşleşiyorsa. Hedef blob için ETag, için If-Matchbelirtilen ETag ile eşleşmiyorsa Blob Depolama 412 (Önkoşul Başarısız) durum kodunu döndürür.
If-None-Match İsteğe bağlı. ETag değeri veya joker karakter (*).

Yalnızca belirtilen ETag değeri hedef blob için ETag değeriyle eşleşmiyorsa blobu yerleştirmek üzere bu koşullu üst bilgi için bir ETag değeri belirtin.

İşlemi yalnızca hedef blob yoksa gerçekleştirmek için joker karakteri (*) belirtin.

Belirtilen koşul karşılanmazsa, Blob Depolama 412 durum kodunu döndürür (Önkoşul Başarısız oldu).
x-ms-lease-id:<ID> Blob etkin bir kiraya sahipse gereklidir. Etkin kiralaması olan bir blobda bu işlemi gerçekleştirmek için bu üst bilgi için geçerli kira kimliğini belirtin.
x-ms-blob-content-disposition İsteğe bağlı. Blob Content-Disposition üst bilgisini ayarlar. Sürüm 2013-08-15 ve üzeri için kullanılabilir.

Yanıt Content-Disposition üst bilgisi alanı, yanıt yükünün nasıl işlendiği hakkında ek bilgiler sağlar ve ek meta veriler eklemek için kullanılabilir. Örneğin, üst bilgi olarak ayarlanırsa attachment, kullanıcı aracısının yanıtı görüntülememesi gerektiğini gösterir. Bunun yerine, belirtilen blob adından farklı bir dosya adıyla Farklı Kaydet iletişim kutusunu görüntülemesi gerekir.

Blob Al ve BlobÖzelliklerini Al işlemlerinden gelen yanıt üst bilgisini içerircontent-disposition.
Origin İsteğe bağlı. İsteğin verildiği kaynağı belirtir. Bu üst bilginin varlığı, yanıtta çıkış noktaları arası kaynak paylaşımı (CORS) üst bilgileriyle sonuçlanır. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için CORS desteği.
x-ms-client-request-id İsteğe bağlı. Depolama analizi günlüğü etkinleştirildiğinde analiz günlüklerine kaydedilen 1 kibibaytlık (KiB) karakter sınırına sahip istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucunun aldığı istekler arasında bağıntı sağlamak için bu üst bilgiyi kullanmanızı kesinlikle öneririz.
x-ms-access-tier İsteğe bağlı. Blobda ayarlanacak katmanı gösterir. Blok blobu katmanları için geçerli değerler : Hot, Cool, Coldve Archive. Not: Cold katman, sürüm 2021-12-02 ve üzeri için desteklenir. Hot, Coolve Archive 2018-11-09 ve sonraki sürümler için desteklenir. Blok blobu katmanlama hakkında daha fazla bilgi için bkz . Sık erişimli, seyrek erişimli ve arşiv depolama katmanları.
x-ms-expiry-option İsteğe bağlı. Sürüm 2023-08-03 ve üzeri. İstek için sona erme tarihi seçeneğini belirtir. Daha fazla bilgi için bkz . ExpiryOption. Bu üst bilgi hiyerarşik ad alanı etkinleştirilmiş hesaplar için geçerlidir.
x-ms-expiry-time İsteğe bağlı. Sürüm 2023-08-03 ve üzeri. Blob süresinin dolmak üzere ayarlandığı zamanı belirtir. Süre sonu tarihi biçimi'ne x-ms-expiry-optiongöre değişir. Daha fazla bilgi için bkz . ExpiryOption. Bu üst bilgi hiyerarşik ad alanı etkinleştirilmiş hesaplar için geçerlidir.

Bu işlem, yalnızca belirli bir koşul karşılandığında blob yazmak için koşullu üst bilgilerin kullanımını da destekler. Daha fazla bilgi için bkz. Blob Depolama işlemleri için koşullu üst bilgileri belirtme.

İstek üst bilgileri (müşteri tarafından sağlanan şifreleme anahtarları)

Bir blobu müşteri tarafından sağlanan bir anahtarla şifreleme isteğinde aşağıdaki üst bilgiler belirtilebilir. Müşteri tarafından sağlanan anahtarla (ve ilgili üst bilgi kümesiyle) şifreleme isteğe bağlıdır.

İstek üst bilgisi Açıklama
x-ms-encryption-key Gereklidir. Base64 kodlamalı AES-256 şifreleme anahtarı.
x-ms-encryption-key-sha256 Gereklidir. Şifreleme anahtarının Base64 kodlamalı SHA256 karması.
x-ms-encryption-algorithm: AES256 Gereklidir. Şifreleme için kullanılacak algoritmayı belirtir. Bu üst bilginin değeri olmalıdır AES256.

İstek gövdesi

Yok.

Örnek istek

Aşağıdaki örnekte blok blobu oluşturma isteği gösterilmektedir:

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

Yanıt

Yanıt bir HTTP durum kodu ve bir dizi yanıt üst bilgisi içerir.

Durum kodu

Başarılı bir işlem 201 (Oluşturuldu) durum kodunu döndürür.

Durum kodları hakkında daha fazla bilgi için bkz. Durum ve hata kodları.

Yanıt üst bilgileri

Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt üst bilgisi Description
ETag ETag, istemcinin istek üst bilgisini kullanarak If-Match koşullu PUT işlemler gerçekleştirmek için kullanabileceği bir değer içerir. ETag değeri tırnak içine alınır.
Last-Modified Blob'un en son değiştirildiği tarih/saat. Tarih biçimi RFC 1123'e göredir. Daha fazla bilgi için bkz. Üst bilgilerde tarih/saat değerlerini temsil edin.

Blob üzerindeki herhangi bir yazma işlemi (blobun meta verileri veya özelliklerindeki güncelleştirmeler dahil) blobun son değiştirme zamanını değiştirir.
Content-MD5 İstemcinin ileti içeriğinin bütünlüğünü denetleyebilmesi için blok blobu için döndürülür. Döndürülen Content-MD5 değer Blob Depolama tarafından hesaplanır. İstek veya x-ms-blob-content-md5 üst bilgileri içermediğinde Content-MD5 bile bu üst bilgi döndürülür.
x-ms-content-crc64 İstemcinin ileti içeriğinin bütünlüğünü denetleyebilmesi için blok blobu için döndürülür. Döndürülen x-ms-content-crc64 değer Blob Depolama tarafından hesaplanır. Bu üst bilgi her zaman döndürülür.
x-ms-request-id Yapılan isteği benzersiz olarak tanımlar ve istekle ilgili sorunları gidermek için bunu kullanabilirsiniz. Daha fazla bilgi için bkz . API işlemleriyle ilgili sorunları giderme.
x-ms-version İsteği yürütmek için kullanılan Blob Depolama sürümü.
Date Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri.
Access-Control-Allow-Origin İstek bir Origin üst bilgi içeriyorsa ve CORS eşleşen bir kuralla etkinleştirildiyse döndürülür. Bu üst bilgi, eşleşme varsa kaynak isteği üst bilgisinin değerini döndürür.
Access-Control-Expose-Headers İstek bir Origin üst bilgi içeriyorsa ve CORS eşleşen bir kuralla etkinleştirildiyse döndürülür. İsteğin istemcisine veya verene sunulacak yanıt üst bilgilerinin listesini döndürür.
Access-Control-Allow-Credentials İstek bir Origin üst bilgi içeriyorsa ve CORS tüm çıkış noktalarına izin vermeyecek bir eşleştirme kuralıyla etkinleştirildiyse döndürülür. Bu üst bilgi olarak trueayarlanır.
x-ms-request-server-encrypted: true/false İsteğin içeriği belirtilen algoritma kullanılarak başarıyla şifrelenirse bu üst bilginin değeri olarak ayarlanır true . Aksi takdirde, değer olarak falseayarlanır.
x-ms-encryption-key-sha256 İstek şifreleme için müşteri tarafından sağlanan bir anahtar kullandıysa döndürülür; böylece istemci, sağlanan anahtarı kullanarak isteğin içeriğinin başarıyla şifrelenmesini sağlayabilir.
x-ms-encryption-scope İstek bir şifreleme kapsamı kullandıysa döndürülür; böylece istemci, isteğin içeriğinin şifreleme kapsamı kullanılarak başarıyla şifrelenmesini sağlayabilir.
x-ms-version-id: <DateTime> Blobu benzersiz olarak tanımlayan opak DateTime bir değer döndürür. Bu üst bilginin değeri blobun sürümünü gösterir ve bloba erişmek için sonraki isteklerde kullanılabilir.

Yanıt gövdesi

Yok.

Örnek yanıt

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>

Yetkilendirme

Azure Depolama'da herhangi bir veri erişim işlemi çağrılırken yetkilendirme gereklidir. İşlemi aşağıda açıklandığı gibi yetki Put Blob From URL verebilirsiniz.

İstek, istek üst bilgisine x-ms-tags sahip etiketleri belirtirse çağıranın Blob Etiketlerini Ayarla işleminin yetkilendirme gereksinimlerini karşılaması gerekir.

Önemli

Microsoft, Azure Depolama'ya yönelik istekleri yetkilendirmek için yönetilen kimliklerle Microsoft Entra ID kullanılmasını önerir. Microsoft Entra ID, Paylaşılan Anahtar yetkilendirmesine kıyasla üstün güvenlik ve kullanım kolaylığı sağlar.

Azure Depolama, blob verilerine yönelik istekleri yetkilendirmek için Microsoft Entra ID kullanılmasını destekler. Microsoft Entra ID ile Azure rol tabanlı erişim denetimini (Azure RBAC) kullanarak bir güvenlik sorumlusuna izin vekleyebilirsiniz. Güvenlik sorumlusu bir kullanıcı, grup, uygulama hizmet sorumlusu veya Azure yönetilen kimliği olabilir. OAuth 2.0 belirtecini döndürmek için güvenlik sorumlusunun kimliği Microsoft Entra ID tarafından doğrulanır. Belirteç daha sonra Blob hizmetine karşı bir isteği yetkilendirmek için kullanılabilir.

Microsoft Entra ID kullanarak yetkilendirme hakkında daha fazla bilgi edinmek için bkz. Microsoft Entra ID kullanarak bloblara erişimi yetkilendirme.

İzinler

Aşağıda, Microsoft Entra kullanıcı, grup, yönetilen kimlik veya hizmet sorumlusunun işlemi çağırması Put Blob From URL için gereken RBAC eylemi ve bu eylemi içeren en az ayrıcalıklı yerleşik Azure RBAC rolü verilmiştir:

Azure RBAC kullanarak rol atama hakkında daha fazla bilgi edinmek için bkz. Blob verilerine erişim için Azure rolü atama.

Açıklamalar

İşlem Put Blob From URL , 2020-04-08 sürümünden itibaren desteklenir.

Sürüm 2020-10-02 ve sonraki sürümlerde, kopyalama işleminin kaynağı için Microsoft Entra yetkilendirme desteklenir.

Kaynak blob blok blobu, ekleme blobu veya sayfa blobu dahil olmak üzere herhangi bir türde olabilir. Ancak hedef blob bir blok blobu olmalıdır.

İşlem Put Blob From URL her zaman kaynak blob'un tamamını kopyalar. Bayt aralığını veya blok kümesini kopyalama desteklenmez. Kısmi güncelleştirmeler gerçekleştirmek için Url'den Blok Koyma bölümüne bakın. Hedef blob mevcut bir blok blobu olabileceği gibi, işlem tarafından oluşturulan yeni bir blob da olabilir.

Kaynak nesne olarak bir blok blobu kullandığınızda, işlenen tüm blob içeriği kopyalanır. Ancak, blok listesi korunmaz ve kaydedilmemiş bloklar kopyalanmamıştır. Hedef blobun içeriği kaynağın içeriğiyle aynıdır, ancak işlenen blok listesi korunmaz.

Blob özelliklerini ve meta verilerini yerleştirme

Bir kopyalama kaynağından blok blobu oluştururken, standart blob özellikleri varsayılan olarak kaynak blobdan kopyalanır. uygulama meta verileri istekte belirtilirse, kaynak blob meta verileri kopyalanmadan depolanır. Herhangi bir HTTP içerik üst bilgisini açıkça ayarlamak için istekte ilgili üst bilgiyi belirtebilirsiniz.

  • Content-Type

  • Content-Encoding

  • Content-Length

  • Cache-Control

  • Content-Disposition

Hedef blobun boyutu her zaman kaynak blobun boyutuyla eşleşir. İstekte Content-LengthPut Blob From URL üst bilgi 0 olmalıdır (istek gövdesi olmadığından) ve hedef blobun içerik uzunluğu özelliği kaynağın boyutundan çıkarılır.

URL'den Blob'un özel özelliklerini yerleştirme

Put Blob From Url , standart HTTP üst bilgileriyle ilişkili özel özellikleri ayarlamayla aynı semantiği Put Blob izler. Daha fazla bilgi için bkz . Blob özel özellikleri

Blob dizin etiketleri

Hedef blob etiketleri üst bilgide x-ms-tags sağlanıyorsa, bunlar sorgu dizesi kodlanmış olmalıdır. Etiket anahtarları ve değerleri, içinde Set Blob Tagsbelirtilen adlandırma ve uzunluk gereksinimlerine uygun olmalıdır. Ayrıca, x-ms-tags üst bilgi en fazla 2 KiB etiket içerebilir. Daha fazla etiket gerekiyorsa işlemini kullanın Set Blob Tags .

Üst bilgide etiketler sağlanmazsa x-ms-tags , bunlar kaynak blobdan kopyalanır.

Şifreleme kapsamları ve müşteri tarafından sağlanan anahtarlar

URL'den Blob Koyma API'si, sırasıyla ve x-ms-encryption-key üst bilgilerini kullanarak x-ms-encryption-scope hem şifreleme kapsamlarını hem de müşteri tarafından sağlanan anahtarları destekler.

x-ms-copy-source Üst bilgi, istek URI'sindeki hedef blobla aynı kaynak bloba başvuruyorsa, Put Blob From URL işlem blobun zaman uyumlu bir yerinde yeniden yazma işlemini gerçekleştirir. Bu, farklı bir şifreleme anahtarı veya şifreleme kapsamı kullanmak için blobu yeniden yazmaya olanak tanır.

Faturalama

Fiyatlandırma istekleri, Blob Depolama API'lerini kullanan istemcilerden, doğrudan Blob Depolama REST API'si aracılığıyla veya bir Azure Depolama istemci kitaplığından kaynaklanabilir. Bu istekler işlem başına ücret tahakkuk eder. İşlem türü, hesabın ücretlendirilmeyi etkiler. Örneğin, okuma işlemleri yazma işlemlerinden farklı bir faturalama kategorisine tahakkuk eder. Aşağıdaki tabloda, depolama hesabı türüne göre istekler için Put Blob From URL faturalama kategorisi gösterilmektedir:

İşlem Depolama hesabı türü Faturalama kategorisi
URL'den Blob Koyma (hedef hesap1) Premium blok blobu
Standart genel amaçlı v2
Standart genel amaçlı v1		 Yazma işlemleri
URL'den Blob Koyma (kaynak hesap2) Premium blok blobu
Standart genel amaçlı v2
Standart genel amaçlı v1		 Okuma işlemleri

1Yazma işlemini başlatmak için hedef hesap bir işlem için ücretlendirilir.
2Kaynak hesap, kaynak nesneye yapılan her okuma isteği için bir işlem oluşturur.

Ayrıca, kaynak ve hedef hesaplar farklı bölgelerde (örneğin, ABD Kuzey ve ABD Güney) bulunuyorsa, isteği aktarmak için kullanılan bant genişliği çıkış olarak kaynak depolama hesabına ücretlendirilir. Aynı bölgedeki hesaplar arasında çıkış ücretsizdir.

Son olarak, aynı depolama hesabı içinde farklı bir ada sahip yeni bir blob oluşturmak ek depolama kaynakları kullanır, bu nedenle işlem bu ek kaynaklar için depolama hesabının kapasite kullanımına karşı ücretlendirilir.

Belirtilen faturalama kategorilerinin fiyatlandırması hakkında bilgi edinmek için bkz. fiyatlandırma Azure Blob Depolama.

Ayrıca bkz.

Azure Depolama Durumu ve hata kodlarınayönelik istekleri yetkilendirmeBlob hizmeti hata kodlarıBlob hizmeti işlemleri için zaman aşımları ayarlama