Blob Katmanını Ayarla

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

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

İstek

İsteği aşağıdaki gibi oluşturabilirsiniz Set Blob Tier . HTTPS kullanmanızı öneririz. myaccount değerini depolama hesabınızın adıyla, myblob değerini ise 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 İsteğe bağlı. snapshot parametresi, mevcut olduğunda katman ayarlanacağı blob anlık görüntüsünü belirten opak DateTime bir değerdir. Blob anlık görüntüleriyle çalışma hakkında daha fazla bilgi için bkz. Blobun anlık görüntüsünü İçerik Oluşturucu
versionid Sürüm 2019-12-12 ve üzeri için isteğe bağlı. versionid parametresi, mevcut olduğunda katman ayarlanacağı blobun sürümünü belirten opak DateTime bir değerdir.
timeout İsteğe bağlı. 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 Gereklidir. Yetkilendirme düzenini, depolama hesabı adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama'ya istekleri 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'ya istekleri yetkilendirme.
x-ms-access-tier Gereklidir. Blobda ayarlanacak katmanı gösterir. İzin verilen premium sayfa blob katmanlarının listesi için bkz. Vm'ler için yüksek performanslı Premium Depolama ve yönetilen diskler. Blob depolama veya genel amaçlı v2 hesabı için geçerli değerler , Cool, Coldve ArchivedeğerleridirHot. 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 Hizmetleri için sürüm oluşturma.
x-ms-client-request-id İsteğe bağlı. 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. İstemci tarafı etkinlikleriyle sunucu tarafından alınan istekler arasında bağıntı sağlamak için bu üst bilginin kullanılması kesinlikle önerilir. Daha fazla bilgi için bkz. Depolama Analizi Günlüğü Hakkında.
x-ms-rehydrate-priority İsteğe bağlı. 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 şunlardır: High/Standard. Öncelik bir blobda 2020-06-12 öncesi sürümler için yalnızca bir kez ayarlanabilir; sonraki isteklerde bu üst bilgi yoksayılır. Varsayılan öncelik ayarı şeklindedir 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 olarak ayarlanmış ve daha önce ayarlanmış olan aynı değere ayarlı Highx-ms-access-tierOlarak Blob Katmanı Ayarla çağrılarak olarak değiştirilebilir StandardHigh. Öncelik ayarı olarak HighStandarddüşü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

Yok.

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 geçerlilik kazanırsa 200 durum kodunu (Tamam) veya yeni katmana geçiş bekliyorsa durum kodu 202'yi (Kabul Edildi) döndürür.

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

Blok blobları için, blobun geçerli ve istenen katmanlarına göre 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 ayarlayın Soğuk katmana ayarla Arşiv katmanına ayarla
Sık erişim katmanındaki blob 200 200 200 200
Seyrek erişim katmanında blob 200 200 200 200
Soğuk katmanda 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ında blob, seyrek erişim için yeniden doldurma 409 202 409 409
Arşiv katmanındaki blob, soğuğa 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 bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt üst bilgisi Description
x-ms-request-id Yapılan isteği benzersiz olarak tanımlar ve istekle ilgili sorunları gidermek için kullanılabilir. 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ü. 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 İsteklerin ve karşılık gelen yanıtların sorunlarını 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 üst bilginin değerine x-ms-client-request-id eşittir. x-ms-client-request-id Üst bilgi istekte yoksa yanıtta bulunmaz.

Yetkilendirme

Azure Depolama'da herhangi bir veri erişimi işlemi çağrılırken yetkilendirme gereklidir. İşlemi aşağıda açıklandığı gibi yetki Set Blob Tier verebilirsiniz.

Ö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 güvenlik sorumlusuna izinler verilmektedir. Güvenlik sorumlusu bir kullanıcı, grup, uygulama hizmet sorumlusu veya Azure yönetilen kimliği olabilir. Güvenlik sorumlusunun kimliği, OAuth 2.0 belirtecini döndürmek için 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ı Set Blob Tier 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

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

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.
  • için katmanlı archive anlık görüntüler anlık görüntüye yeniden doldurulamaz. Başka bir ifadeyle anlık görüntü bir hot veya cool katmanına geri getirilemiyor. Verileri anlık archive görüntüden veya sürümden almanın tek yolu, verileri yeni bir bloba kopyalamaktır.
  • Sürüm bir kök blob ise veya cool'ye hot yeniden doldurulabilir.
  • Bir durumdaki archive anlık görüntülerin veya sürümlerin köke yükseltilmesine izin verilmez.
  • Sürüm oluşturma etkinleştirildiğinde, bir kök blobun yeniden doldurma bekleme durumundayken silinmesi, yeniden doldurmanın iptal edilmesine neden olur ve sürüm bir archive durumda olur.
  • Yeniden doldurma beklemede ve geçici olarak silinmiş durumdayken bir blobun üzerine yazılırsa, yeniden doldurma iptal edilir ve geçici olarak silinen anlık görüntünün sürümü bir archive durumda olur.

Desteklenen katmanların listesi istek sürümüyle sınırlı değildir ve gelecekte yeni katmanlar eklenebilir.

Not

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

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 Set Blob Tier 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. fiyatlandırma Azure Blob Depolama.

Ayrıca bkz.

Azure Depolama'ya yönelik istekleri yetkilendirme
Durum ve hata kodları
Blob Depolama hata kodları
Blob Depolama işlemleri için zaman aşımlarını ayarlama