URL'den Blob Yerleştir
İş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 URL
desteklenmez. 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 List
URL'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:10000
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ş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ı BlockBlob gerekir. 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-tags hiç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-Match belirtilen 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çerir content-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 , Cold ve Archive .
Not: Cold katman, sürüm 2021-12-02 ve üzeri için desteklenir.
Hot , Cool ve 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-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 |
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 true 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 olarak ayarlanır true . Aksi takdirde, değer olarak false 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, 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 eylemi:
- Yeni blok blobu İçerik Oluşturucu: Microsoft.Storage/storageAccounts/blobServices/containers/blobs/add/action
- Yeni İçerik Oluşturucu veya var olan blok blobu üzerine yazma: Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
- En az ayrıcalıklı yerleşik rol:Depolama Blob Verileri 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.
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-Length
Put 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 Tags
belirtilen 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