URL'den Blob Yerleştir

Makale
10/22/2024

Put Blob From URL işlemi, 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 Put Blob From URLile desteklenmez. Var olan bir 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 Put Block Listile birlikte Put Block From URL API'sini kullanın.

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

İstek

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ünmüş depolama hizmeti isteği

Öykünmüş depolama hizmetine yönelik bir istekte bulunuyorsanız öykünücü ana bilgisayar adını ve Blob hizmeti bağlantı noktasını 127.0.0.1:10000olarak belirtin ve 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ştirmeiçin Azurite öykünücüsü kullanma .

URI parametreleri

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

Parametre	Açıklama
`timeout`	isteğ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`	Gerekli. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. azure depolamaistekleri yetkilendirme .
`Date` veya `x-ms-date`	Gerekli. İstek için Eşgüdümlü Evrensel Saati (UTC) belirtir. Daha fazla bilgi için bkz. azure depolamaistekleri 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`	Gerekli. İ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`	Gerekli. Kaynak blobun URL'sini belirtir. Değer, blob belirten en fazla 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 bir `Content-Length` değeri döndürmezse, istek 409 (Çakışma) durum koduyla başarısız olur. Kaynak nesne URL'lerine bazı örnekler aşağıda 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>`	isteğe bağlı. Kopyalama kaynağı için yetkilendirme düzenini ve imzayı belirtir. Daha fazla bilgi için bkz. azure depolamaistekleri yetkilendirme . Not: Microsoft Entra için yalnızca taşıyıcı düzeni desteklenir. Not: Kaynak nesneniz genel olarak erişilebilirse veya kaynak nesneniz bir depolama hesabındaysa ve `x-ms-copy-source:name`geçirilen bir SAS belirteci kullanıyorsanız, bu üst bilgi gerekli değildir. Bu üst bilgi 2020-10-02 ve sonraki sürümlerde desteklenir.
`x-ms-blob-type: BlockBlob`	Gerekli. Oluşturulacak blob türünü belirtir ve `BlockBlob`olmalıdır. Blob türü `BlockBlob`değilse işlem 400 (Hatalı İstek) durum koduyla başarısız olur.
`Content-Type`	isteğe bağlı. Blobun MIME içerik türü. Varsayılan tür `application/octet-stream`.
`Content-Encoding`	isteğe bağlı. Bloba hangi içerik kodlamalarının uygulandığını belirtir. Blob kaynağında Blob Alma işlemi gerçekleştirildiğinde bu değer istemciye döndürülür. Bu değer döndürülürken istemci blob içeriğinin kodunu çözmek için kullanabilir.
`Content-Language`	isteğe bağlı. Bu kaynak tarafından kullanılan doğal dilleri belirtir.
`Cache-Control`	isteğe bağlı. Blob Depolama bu değeri depolar ancak kullanmaz veya değiştirmez.
`x-ms-source-content-md5`	isteğ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`	isteğe bağlı. Blob içeriğinin CRC64 karması. Bu karma, aktarım 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`	isteğe bağlı. Blob'un içerik türünü ayarlar.
`x-ms-blob-content-encoding`	isteğe bağlı. Blob'un içerik kodlamasını ayarlar.
`x-ms-blob-content-language`	isteğe bağlı. Blob'un içerik dilini ayarlar.
`x-ms-blob-content-md5`	isteğe bağlı. Blob'un MD5 karması ayarlar.
`x-ms-blob-cache-control`	isteğe bağlı. Blob'un önbellek denetimini ayarlar.
`x-ms-meta-name:value`	isteğ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`	isteğ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`	isteğ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`	isteğ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 alma işlemi ek çağrıya neden olur. DEĞİşTİr, hedef blobdaki `x-ms-tags` üst bilgisi tarafından belirtilen etiketleri ayarlar. DEĞİşTİr kullanılırsa ve `x-ms-tags`tarafından hiçbir etiket belirtilmezse, hedef blobda hiçbir etiket ayarlanmadı. COPY ve `x-ms-tags` belirtilmesi 409 (Çakışma) ile sonuçlanacak. 2021-04-10 ve sonraki sürümlerde desteklenir.
`x-ms-copy-source-blob-properties`	isteğe bağlı. Kaynak blob özelliklerini kopyalama davranışını belirtir. `True`olarak ayarlanırsa, kaynak blobun özellikleri yeni bloba kopyalanır. Varsayılan değer şudur: `True`.
`x-ms-source-if-modified-since`	isteğe bağlı. Bir `DateTime` değer. Blobu yerleştirmek 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 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-unmodified-since`	isteğe bağlı. Bir `DateTime` değer. Yalnızca kaynak blob belirtilen tarih/saatten bu yana değiştirilmemişse blobu yerleştirmek için bu koşullu üst bilgiyi belirtin. Kaynak blob değiştirildiyse 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-match`	isteğe bağlı. ETag değeri. Kaynak blobu yalnızca ETag değeri belirtilen değerle eşleşiyorsa 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`	isteğe bağlı. ETag değeri. Blobu yalnızca ETag değeri 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`	isteğe bağlı. Bir `DateTime` değer. Blobu yerleştirmek için bu koşullu üst bilgiyi belirtin, ancak hedef blob belirtilen tarih/saatten sonra değiştirilmişse. Hedef blob değiştirilmediyse, Blob Depolama durum kodu 412'yi döndürür (Önkoşul Başarısız oldu).
`If-Unmodified-Since`	isteğe bağlı. Bir `DateTime` değer. Blobu yerleştirmek için bu koşullu üst bilgiyi belirtin, ancak hedef blob belirtilen tarih/saatten bu yana değiştirilmemişse. Hedef blob değiştirildiyse, Blob Depolama durum kodu 412'yi döndürür (Önkoşul Başarısız oldu).
`If-Match`	isteğe bağlı. ETag değeri. Bu koşullu üst bilgi için, yalnızca belirtilen ETag değeri mevcut hedef blob için `ETag` değeriyle eşleşiyorsa blobu yerleştirmek için bir ETag değeri belirtin. Hedef blob için ETag, `If-Match`için belirtilen ETag ile eşleşmiyorsa Blob Depolama 412 durum kodunu döndürür (Önkoşul Başarısız oldu).
`If-None-Match`	isteğ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 (Önkoşul Başarısız) durum kodunu döndürür.
`x-ms-lease-id:<ID>`	Blob etkin bir kiraya sahipse gereklidir. Etkin kiralaması olan bir blob üzerinde bu işlemi gerçekleştirmek için bu üst bilgi için geçerli kira kimliğini belirtin.
`x-ms-blob-content-disposition`	isteğe bağlı. Blob'un `Content-Disposition` üst bilgisini ayarlar. Sürüm 2013-08-15 ve üzeri için kullanılabilir. `Content-Disposition` yanıt ü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 `attachment`olarak ayarlandıysa, kullanıcı aracısının yanıtı görüntülememesi gerektiğini gösterir. Bunun yerine, belirtilen blob adı dışında bir dosya adıyla Farklı Kaydet iletişim kutusunu görüntülemelidir. Blob Alma ve Blob Özelliklerini Al işlemlerinden gelen yanıt, `content-disposition` üst bilgisini içerir.
`Origin`	isteğ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`	isteğe bağlı. Depolama analizi günlüğü etkinleştirildiğinde analiz günlüklerine kaydedilen 1 kibibayt (KiB) karakter sınırıyla 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`	isteğe bağlı. Blobda ayarlanacak katmanı gösterir. Blok blobu katmanları için geçerli değerler `Hot`, `Cool`, `Cold`ve `Archive`'dır. Not: `Cold` katmanı 2021-12-02 ve sonraki sürümler için desteklenir. `Hot`, `Cool`ve `Archive` 2018-11-09 ve sonraki sürümlerde desteklenir. Blok blobu katmanlama hakkında daha fazla bilgi için bkz.sık erişimli, seyrek erişimli ve arşiv depolama katmanlarını .
`x-ms-expiry-option`	isteğ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`	isteğe bağlı. Sürüm 2023-08-03 ve üzeri. Blob süresinin dolmak üzere ayarlandığı zamanı belirtir. Son kullanma tarihi biçimi `x-ms-expiry-option`gö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`	Gerekli. Base64 kodlu AES-256 şifreleme anahtarı.
`x-ms-encryption-key-sha256`	Gerekli. Şifreleme anahtarının Base64 ile kodlanmış SHA256 karması.
`x-ms-encryption-algorithm: AES256`	Gerekli. Şifreleme için kullanılacak algoritmayı belirtir. Bu üst bilginin değeri `AES256`olmalıdır.

Request body

Yok.

Örnek isteği

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

Response

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 bilgilerHTTP/1.1 protokol belirtimine uygundur.

Yanıt üst bilgisi	Açıklama
`ETag`	ETag, istemcinin `If-Match` istek üst bilgisini kullanarak koşullu `PUT` işlemleri 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 uyar. 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ğeri Blob Depolama tarafından hesaplanır. İstek `Content-MD5` veya `x-ms-blob-content-md5` üst bilgileri içermediğinde 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ğeri 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 isteği gidermek için kullanabilirsiniz. Daha fazla bilgi için bkz. API işlem sorunlarını 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 bilgisi 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 bilgisi 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 bilgisi 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 `true`olarak ayarlanı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 `true` olarak ayarlanır. Aksi takdirde, değeri `false`olarak ayarlanı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, isteğin içeriğinin sağlanan anahtar kullanılarak 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 bir `DateTime` değeri 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. aşağıda açıklandığı gibi Put Blob From URL işlemini yetkileyebilirsiniz.

bir istek istek üst bilgisine sahip etiketleri belirtirse, çağıranın blob etiketlerini ayarlama 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.

Microsoft Entra Id (önerilen)
paylaşılan erişim imzaları (SAS)
paylaşılan anahtar

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. Daha sonra belirteç, 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 bir Microsoft Entra kullanıcısı, grubu, yönetilen kimliği veya hizmet sorumlusunun Put Blob From URL işlemini çağırması için gereken RBAC eylemi ve bu eylemi içeren en az ayrıcalıklı yerleşik Azure RBAC rolü verilmiştir:

Azure RBAC eylemini :
- Yeni blok blobu oluşturma: Microsoft.Storage/storageAccounts/blobServices/containers/blobs/add/action
- Var olan blok blobu oluşturma veya üzerine yazma: Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
En az ayrıcalıklı yerleşik rol: depolama blobu veri katkıda bulunanı

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

Paylaşılan erişim imzası (SAS), depolama hesabındaki kaynaklara güvenli temsilci erişimi sağlar. SAS ile, istemcinin verilere nasıl erişebileceği üzerinde ayrıntılı denetime sahipsiniz. İstemcinin hangi kaynağa erişebileceğini, bu kaynaklara hangi izinlere sahip olduğunu ve SAS'nin ne kadar süre geçerli olduğunu belirtebilirsiniz.

Put Blob From URL işlemi üç tür paylaşılan erişim imzasını destekler: kullanıcı temsilcisi SAS, hizmet SASve hesabı SAS.

En iyi güvenlik uygulaması olarak, daha kolay ele geçirilebilen depolama hesabı anahtarı yerine Microsoft Entra kimlik bilgilerini kullanmanızı öneririz. Uygulama tasarımınız paylaşılan erişim imzaları gerektiriyorsa, mümkün olduğunda bir kullanıcı temsilcisi SAS'ı oluşturmak için Microsoft Entra kimlik bilgilerini kullanın.

Depolama hesabı için Paylaşılan Anahtar erişimine izin verilmediğinde, Blob Depolama isteğinde hizmet SAS belirteci veya hesap SAS belirtecine izin verilmez. Daha fazla bilgi edinmek için bkz. Paylaşılan Anahtar'a izin vermeninSAS belirteçlerini nasıl etkilediğini anlama.

Kullanıcı temsilcisi SAS

Kullanıcı temsilcisi SAS'sinin güvenliği Microsoft Entra kimlik bilgileriyle ve SAS için belirtilen izinlerle sağlanır.

Kapsayıcı veya blob kaynağına temsilci olarak atanan SAS belirtecini kullanarak Put Blob From URL işlemini çağırmak için kullanıcı temsilcisi SAS belirtecinin bir parçası olarak aşağıdaki izin gerekir:

İşlem	İmzalı izin
URL'den Blob Koyma (yeni blok blobu oluşturma)	Oluşturma (c) veya Yazma (w)
URL'den Blob Yerleştir (var olan blok blobu üzerine yaz)	Yazma (w)

Kullanıcı temsilcisi SAS'i hakkında daha fazla bilgi edinmek için bkz. kullanıcı temsilcisi SASoluşturma .

Hizmet SAS'i

Hizmet SAS'sinin güvenliği depolama hesabı anahtarıyla sağlanır. Hizmet SAS'i blob depolama gibi tek bir Azure Depolama hizmetindeki bir kaynağa erişim yetkisi verir.

Put Blob From URL işlemini bir kapsayıcı veya blob kaynağına temsilci olarak atanan sas belirteci kullanarak çağırmak, hizmet SAS belirtecinin bir parçası olarak aşağıdaki izni gerektirir.

İşlem	İmzalı izin
URL'den Blob Koyma (yeni blok blobu oluşturma)	Oluşturma (c) veya Yazma (w)
URL'den Blob Yerleştir (var olan blok blobu üzerine yaz)	Yazma (w)

Hizmet SAS'i hakkında daha fazla bilgi edinmek için bkz. hizmet SASoluşturma .

Hesap SAS'i

Bir hesap SAS'sinin güvenliği depolama hesabı anahtarıyla sağlanır. Hesap SAS'i, depolama hizmetlerinden bir veya daha fazlasında kaynaklara erişim yetkisi verir. Bir hizmet veya kullanıcı temsilcisi SAS'i aracılığıyla kullanılabilen tüm işlemler, hesap SAS'i aracılığıyla da kullanılabilir.

Aşağıdaki tabloda, erişim yetkisi verildiğinde belirtilmesi gereken imzalı kaynak türü ve imzalı izinler gösterilir:

İşlem	İmzalı hizmet	İmzalı kaynak türü	İmzalı izin
URL'den Blob Koyma (yeni blok blobu oluşturma)	Blob (b)	Nesne (o)	Oluşturma (c) veya Yazma (w)
URL'den Blob Yerleştir (var olan blok blobu üzerine yaz)	Blob (b)	Nesne (o)	Yazma (w)

Hesap SAS'i hakkında daha fazla bilgi edinmek için bkz. Hesap SAS'i oluşturma.

Açıklamalar

Put Blob From URL işlemi 2020-04-08 sürümünde desteklenir.

2020-10-02 ve sonraki sürümlerde, kopyalama işleminin kaynağı için Microsoft Entra yetkilendirmesi 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.

Put Blob From URL işlemi her zaman kaynak blobunun tamamını kopyalar. Bayt aralığının veya blok kümesinin kopyalanması desteklenmez. Kısmi güncelleştirmeler gerçekleştirmek için Url'den Blok Koybölümüne bakın. Hedef blob mevcut bir blok blobu veya işlem tarafından oluşturulan yeni bir blob olabilir.

Kaynak nesne olarak 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

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. Content-Length üst bilgisi Put Blob From URL isteğinde 0 olmalıdır (istek gövdesi olmadığından) ve hedef blobun içerik uzunluğu özelliği kaynağın boyutundan çıkarılır.

Blobu URL'den Yerleştir özel özellikleri

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

blob dizin etiketlerini

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

etiketler x-ms-tags üst bilgisinde sağlanmamışsa, bunlar kaynak blobdan kopyalanmamıştır.

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

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

x-ms-copy-source üst bilgisi, istek URI'sindeki hedef blobla aynı kaynak bloba başvuruyorsa, Put Blob From URL işlemi blobun zaman uyumlu 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 ücretlendirilma şeklini 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 Put Blob From URL istekleri için faturalama kategorisi gösterilmektedir:

İşlem	Storage account type	Faturalama kategorisi
URL'den Blob Yerleştir (hedef hesap¹)	Premium blok blobu Standart genel amaçlı v2 Standart genel amaçlı v1	Yazma işlemleri
URL'den Blob Yerleştir (kaynak hesap²)	Premium blok blobu Standart genel amaçlı v2 Standart genel amaçlı v1	Okuma işlemleri

¹Hedef hesap, yazma işlemini başlatmak için bir işlem için ücretlendirilir.
²Kaynak 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ında farklı bir ada sahip yeni bir blob oluşturmak ek depolama kaynakları kullandığından işlem, söz konusu ek kaynaklar için depolama hesabının kapasite kullanımından ücretlendirilir.

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

Ayrıca bkz.

Blob hizmeti hata kodlarıAzure DepolamaDurumu ve hata kodları için istekleri yetkilendirmeBlob hizmeti işlemleri için zaman aşımları ayarlama

Aracılığıyla paylaş