Aracılığıyla paylaş

Blob Katmanını Ayarla

  • Makale

Set Blob Tier işlemi, bir blob üzerindeki erişim katmanını ayarlar. İşleme premium depolama hesabındaki bir sayfa blobunda ve blob depolama veya genel amaçlı v2 hesabındaki bir blok blobunda izin verilir. Premium sayfa blobunun katmanı (P4/P6/P10/P15/P20/P30/P40/P50/P60), blobun izin verilen boyutunu, IOPS'sini ve bant genişliğini belirler. Blok blobu katmanı Hot/Cool/Cold/Archive depolama türünü belirler. Bu işlem blob'un ETag'ini güncelleştirmez.

Blok blob düzeyi katmanlama hakkında ayrıntılı bilgi için bkz. Sık erişimli, seyrek erişimli ve arşiv depolama katmanları.

İstek

Set Blob Tier isteğini aşağıdaki gibi oluşturabilirsiniz. HTTPS kullanmanızı öneririz. myaccount depolama hesabınızın adıyla değiştirin ve myblob katmanın değiştirileceği blob adıyla değiştirin.

Yöntem İstek URI'si HTTP sürümü
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tier HTTP/1.1

URI parametreleri

İstek URI'sinde aşağıdaki ek parametreleri belirtebilirsiniz:

Parametre Açıklama
snapshot Opsiyonel. Snapshot parametresi, mevcut olduğunda katman ayarlanacağı blob anlık görüntüsünü belirten opak bir DateTime değeridir. Blob anlık görüntüleriyle çalışma hakkında daha fazla bilgi için bkz. Blob anlık görüntüsü oluşturma
versionid Sürüm 2019-12-12 ve üzeri için isteğe bağlıdır. versionid parametresi, mevcut olduğunda katman ayarlanacağı blob sürümünü belirten opak bir DateTime değeridir.
timeout Opsiyonel. timeout parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz. Blob Depolama 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, depolama hesabı 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-access-tier Gerekli. Blobda ayarlanacak katmanı gösterir. İzin verilen premium sayfa blob katmanlarının listesi için bkz. Yüksek performanslı Premium Depolama ve VM'ler için yönetilen diskler. Blob depolama veya genel amaçlı v2 hesabı için geçerli değerler Hot, Cool, Coldve Archive. Not:Cold katmanı sürüm 2021-12-02 ve üzeri için desteklenir. Standart blob hesabı blob düzeyi katmanlama hakkında ayrıntılı bilgi için bkz. Sık erişimli, seyrek erişimli ve arşiv depolama katmanları.
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 Hizmetleriiçin Sürüm Oluşturma.
x-ms-client-request-id Opsiyonel. Depolama analizi günlüğü etkinleştirildiğinde analiz günlüklerine kaydedilen 1 kB karakter sınırıyla istemci tarafından oluşturulan, opak bir değer sağlar. Bu üst bilginin kullanılması, istemci tarafı etkinliklerinin sunucu tarafından alınan isteklerle bağıntılı olması için kesinlikle önerilir. Daha fazla bilgi için bkz. Depolama Analizi Günlüğü hakkındahakkında .
x-ms-rehydrate-priority Opsiyonel. Arşivlenmiş blobu yeniden doldurma önceliğini gösterir. Blok blobları için sürüm 2019-02-02 ve daha yeni sürümlerde desteklenir. Geçerli değerler High/Standard. Öncelik, 2020-06-12 öncesi sürümler için blob üzerinde yalnızca bir kez ayarlanabilir; sonraki isteklerde bu üst bilgi yoksayılır. Varsayılan öncelik ayarı Standard.

2020-06-12 sürümünden başlayarak, yeniden doldurma önceliği daha önce ayarlandıktan sonra güncelleştirilebilir. Öncelik ayarı, bu üst bilgi High olarak ayarlanmış Blob Katmanı Ayarla çağrılarak ve x-ms-access-tier daha önce ayarlandığı gibi aynı değere ayarlanarak StandardHigh olarak değiştirilebilir. Öncelik ayarı High'den Standard'e düşürülemez.

Bu işlem, yalnızca belirtilen bir koşul karşılandığında blobu katmana almak 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 gövdesi

Hiç kimse.

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, yeni katman hemen etkinleşirse durum kodu 200 (Tamam) veya yeni katmana geçiş bekleniyorsa durum kodu 202 (Kabul Edildi) döndürür.

Premium depolama hesapları için sayfa blobu işlemi 200 (Tamam) durum kodunu döndürür.

Blok blobları için, blobun geçerli ve istenen katmanları temelinde döndürülen HTTP durum kodları aşağıdaki tabloda açıklanmıştır:

Katmanı Sık erişim katmanına ayarla Seyrek erişim katmanı olarak ayarla Soğuk katman olarak ayarlayın Arşiv katmanı olarak ayarla
Sık erişim katmanındaki blob 200 200 200 200
Seyrek erişim katmanında blob 200 200 200 200
Soğuk katmandaki blob 200 200 200 200
Arşiv katmanındaki blob 202 202 202 200
Arşiv katmanındaki blob, sık erişimliye yeniden doldurma 202 409 409 409
Arşiv katmanındaki blob, seyrek erişim için yeniden doldurma 409 202 409 409
Arşiv katmanındaki blob, soğukta yeniden doldurma 409 409 202 409

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
x-ms-request-id Yapılan isteği benzersiz olarak tanımlar ve isteğin sorunlarını gidermek için kullanılabilir. 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ü. Bu üst bilgi, 2009-09-19 ve sonraki sürümlerde yapılan istekler için döndürülür.
x-ms-client-request-id İsteklerde ve ilgili yanıtlarda sorun gidermek için kullanılabilir. bu üst bilginin değeri, istekte mevcutsa ve değer 1.024'ten fazla görünür ASCII karakteri içermiyorsa x-ms-client-request-id üst bilgisinin değerine eşittir. İstekte x-ms-client-request-id üst bilgisi yoksa yanıtta bulunmaz.

İzin

Azure Depolama'da herhangi bir veri erişim işlemi çağrılırken yetkilendirme gereklidir. aşağıda açıklandığı gibi Set Blob Tier işlemini yetkileyebilirsiniz.

Ö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. 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 Set Blob Tier 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 : 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.

Açıklamalar

Premium hesaplarda sayfa blobları için blob katmanının ayarlanması aşağıdaki kısıtlamalara sahiptir:

  • Yeni blob katmanı mevcut katmandan daha düşük olamaz.
  • Yeni blob katmanı, blob'un içerik uzunluğunu karşılayabilmelidir. Katmanların listesi ve izin verilen içerik uzunluğu için bkz.VM'ler için yüksek performanslı premium depolama ve yönetilen diskler .

Blob Depolama veya genel amaçlı v2 hesabında blok blobunun katmanını ayarlamak aşağıdaki kısıtlamalara sahiptir:

  • Rest 2019-12-12 sürümünden itibaren anlık görüntüde katman ayarlamaya izin verilir.
  • archive katmanlanmış anlık görüntüler anlık görüntüye yeniden doldurulamaz. Yani anlık görüntü bir hot veya cool katmanına geri getirilemiyor. Verileri archive anlık görüntüden veya sürümden almanın tek yolu yeni bir bloba kopyalamaktır.
  • Sürüm bir kök blob ise, hot veya coololarak yeniden doldurulabilir.
  • archive durumundaki anlık görüntülerin veya sürümlerin köke yükseltilmesine izin verilmez.
  • Sürüm oluşturma etkinleştirildiğinde, yeniden doldurma bekleme durumundayken kök blobun silinmesi yeniden doldurmanın iptal edilmesine neden olur ve sürüm archive durumda olur.
  • Yeniden doldurma beklemede ve geçici olarak silinmiş durumdayken bir blobun üzerine yazılırsa, yeniden doldurmanın iptal edilmesine neden olur ve geçici olarak silinen anlık görüntünün sürümü archive durumda olur.

Desteklenen katmanların listesi istek sürümüyle kısıtlanmaz ve gelecekte yeni katmanlar eklenebilir.

Müşteri tarafından sağlanan şifrelemeyi kullanan bloblar için Set Blob Tier 2023-08-03 ve sonraki sürümler için desteklenir. 2023-08-03 öncesi sürümler için Set Blob Tier, müşterinin sağladığı şifrelemeyi kullanan bloblar için durum kodu 409 döndürür.

Not

Blok blob düzeyi katmanlama hakkında ayrıntılı bilgi için bkz. Sık erişimli, seyrek erişimli ve arşiv depolama katmanları.

Fatura

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 Set Blob Tier istekleri için faturalama kategorisi gösterilmektedir:

İşlem Depolama hesabı türü Faturalama kategorisi
Blob Katmanını Ayarlama (katman aşağı) Premium blok blobu
Standart genel amaçlı v2		 Yazma işlemleri
Blob Katmanını Ayarlama (katman yukarı) Premium blok blobu
Standart genel amaçlı v2		 Okuma işlemleri

Belirtilen faturalama kategorisinin fiyatlandırması hakkında bilgi edinmek için bkz. azure blob depolama fiyatlandırması.

Ayrıca bkz.

azure depolama istekleri yetkilendirmeyi
Durumu ve hata kodları
blob depolama hata kodları
Blob Depolama işlemleri için zaman aşımlarını ayarlama