Blob Katmanını Ayarla

  • Makale

İşlem, Set Blob Tier bir 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 bir 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ü belirlerHotCold/ArchiveCool//. 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ı. Anlık görüntü 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ü oluşturma
versionid 2019-12-12 ve üzeri sürümler 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 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-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ına sahip 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, 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ı ş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 önceden ayarlanmış olan aynı değere ayarlı Highx-ms-access-tierBlob Katmanı Ayarla çağrılarak olarak değiştirilebilir StandardHigh. Öncelik ayarı'ndan ' High a Standarddüşürülemez.

Bu işlem, yalnızca belirtilen bir koşul karşılandığında blobu katmana almak için koşullu üst bilgi 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 yanıt üst bilgileri kümesi içerir.

Durum kodu

Başarılı bir işlem, yeni katman hemen geçerlilik kazanırsa 200 (Tamam) durum kodunu veya yeni katmana geçiş bekleniyorsa 202 (Kabul Edildi) durum kodunu 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ına göre döndürülen HTTP durum kodları aşağıdaki tabloda açıklanmıştır:

Katman Sık erişimli katmana ayarla Seyrek erişim katmanı olarak ayarla Soğuk katmana ayarla Arşiv katmanına ayarla
Sık erişimli katmandaki 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ındaki 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 isteğin sorunlarını 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 İsteklerde ve karşılık gelen yanıtlarda sorun gidermek için kullanılabilir. Bu üst bilginin değeri, istekte varsa 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. İstekte x-ms-client-request-id üst bilgi yoksa yanıtta bulunmaz.

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

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, bir Microsoft Entra kullanıcı, grup 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.
  • katmanına alınan 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 yeni bir bloba kopyalamaktır.
  • Sürüm bir kök blob ise veya'ya hotcoolgeri yüklenebilir.
  • 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, yeniden doldurma bekleme durumundayken kök blobun 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