Blob Katmanını Ayarla

  • Makale
  • Okumak için 5 dakika

Set Blob Tierİşlem bir Blobun erişim katmanını ayarlar. Bir Premium Depolama hesabındaki bir Sayfa Blobu ve bir BLOB depolama veya genel amaçlı v2 hesabındaki Blok Blobu üzerinde işleme izin verilir. Bir Premium sayfa blobunun katmanı, Blobun izin verilen boyut, ıOPS ve bant genişliğini belirler. Blok blobunun katmanı Hot / Cool / Archive depolama türünü belirler. Bu işlem, Blobun ETag öğesini güncelleştirmez.

Blok Blobu 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İstek aşağıdaki şekilde oluşturulabilir. HTTPS önerilir. Myaccount değerini depolama hesabınızın adıyla ve myblob ' un, katmanın değiştirildiğ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 parametreler belirtilebilir.

Parametre Açıklama
snapshot İsteğe bağlı. Anlık görüntü parametresi, varsa, DateTime Katman ayarlamak için blob anlık görüntüsünü belirten donuk bir değerdir. Blob anlık görüntüleri ile çalışma hakkında daha fazla bilgi için bkz. BLOB 'un 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, DateTime varsa, üzerine katman ayarlanacak blob sürümünü belirten donuk bir değerdir.
timeout İsteğe bağlı. Zaman aşımı 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

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üstbilgileri açıklanmaktadır.

İstek Başlığı Açıklama
Authorization Gereklidir. Yetkilendirme şemasını, depolama hesabı adını ve imzayı belirtir. daha fazla bilgi için bkz. istekleri Azure Depolama 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. istekleri Azure Depolama yetkilendirme.
x-ms-access-tier Gereklidir. Blob üzerinde ayarlanacak katmanı gösterir. izin verilen premium sayfa blobu katmanlarının bir 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 şunlardır Hot / Cool / Archive . 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 'Lık karakter sınırı ile istemci tarafından oluşturulan, donuk 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üğe kaydetme ve Azure günlüğe kaydetme: Depolama isteklerini izlemek için günlükleri kullanma.
x-ms-rehydrate-priority İsteğe bağlı. Arşivlenmiş bir Blobun yeniden doldurma önceliğini gösterir. Sürüm 2019-02-02 ' de ve blok Blobları için daha yeni sürümlerde desteklenir. Geçerli değerler şunlardır High / Standard . Öncelik, 2020-06-12 öncesi sürümler için bir Blobun yalnızca bir kez ayarlanabilir; Bu üst bilgi, sonraki isteklerde yok sayılacak. Varsayılan öncelik ayarı Standard .

Sürüm 2020-06-12 ' den başlayarak, yeniden doldurma önceliği daha önce ayarlandıktan sonra güncelleştirilebilen olabilir. Öncelik ayarı, Standard High Bu üst bilgiyle ayarlanan BLOB katmanını çağırarak High ve x-ms-access-tier daha önce ayarlandığı değerle aynı değere ayarlayarak, ' dan ' a değiştirilebilir. Öncelik ayarı ' dan ' a düşürülemez High Standard .

Bu işlem, yalnızca belirtilen bir koşul karşılanırsa blobu katmana eklemek için koşullu üstbilgilerin kullanılmasını da destekler. Daha fazla bilgi için bkz. BLOB hizmeti işlemleri Için koşullu üstbilgiler 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ın hemen geçerli olması durumunda 200 (Tamam) durum kodunu döndürür veya yeni katmana geçiş beklense durum kodu 202 (kabul edildi) olur. Premium hesap sayfasında blob işlemi 200 (Tamam) durum kodunu döndürür. Blok Blobları için aşağıdaki tabloda, geçerli katmana ve BLOB 'un istenen katmanına göre döndürülen http durum kodları açıklanmaktadır:

Etkin katmana ayarla Cool katmanına ayarla Arşiv katmanına ayarla
Etkin katmanda blob 200 200 200
Seyrek Erişimli katmanda blob 200 200 200
Arşiv katmanındaki blob 202 202 200
Arşiv katmanındaki blob, etkin olarak yeniden doldurma 202 409 409
Arşiv katmanındaki blob, seyrek erişimli olarak yeniden doldurma 409 202 409

Durum kodları hakkında bilgi için bkz. durum ve hata kodları.

Yanıt Üst Bilgileri

Bu işlemin yanıtı aşağıdaki üstbilgileri içerir. Yanıt ayrıca ek standart HTTP üstbilgileri içerebilir. Tüm standart üstbilgiler http/1.1 protokol belirtimineuyar.

Yanıt Üst Bilgisi Açıklama
x-ms-request-id Bu üst bilgi, yapılan isteği benzersiz bir şekilde tanımlar ve isteğin sorunlarını gidermek için kullanılabilir. Daha fazla bilgi için bkz. API İşlemleri Sorunlarını Giderme.
x-ms-version İsteği yürütmek için kullanılan Blob hizmetinin sürümünü gösterir. Bu üst bilgi, sürüm 2009-09-19 ve daha yeni sürümlerde yapılan istekler için döndürülür.
x-ms-client-request-id Bu üst bilgi, isteklerde ve ilgili yanıtlarda sorun gidermek için kullanılabilir. bu üst bilginin değeri, istekte mevcutsa üst bilgi değerine eşittir ve değer en fazla x-ms-client-request-id 1024 görünür ASCII karakteridir. üst x-ms-client-request-id bilgisi istekte yoksa, yanıtta bu üst bilgi mevcut olmaz.

Yetkilendirme

Bu işlem yalnızca depolama hesabı sahibi ve Paylaşılan Erişim İmzası olan ve bu bloba veya kapsayıcıya yazma izni olan herkes tarafından çağrılabilir.

Açıklamalar

Premium hesaplarda sayfa blobları için blob katmanını ayarlamanın aşağıdaki kısıtlamaları vardır:

Blob depolamada veya genel amaçlı v2 hesabında blok blobu katmanını ayarlamanın aşağıdaki kısıtlamaları vardır:

  • Anlık görüntüde katman ayarlamaya REST sürüm 2019-12-12'den başlayarak izin verilir.
  • Arşive katmanlı anlık görüntüler anlık görüntüye geri alınamaz. Örneğin, anlık görüntü, Hot/Cool katmanına geri alınamaz. Arşivlenmiş bir anlık görüntüden veya sürümden verileri almanın tek yolu bu verileri yeni bir bloba kopyalamaktır.
  • Sürüm bir kök blobsa, bu yeniden Hot veya Cool olarak yeniden kullanılabilir.
  • Arşivlenmiş durumdaki anlık görüntülerin veya Sürümlerin köke yükseltilenemelerine izin verilmez.
  • Sürüm etkinleştirilmiş olduğunda, yeniden dolum beklemede olduğunda kök blob silinerek yeniden dolum iptali ve sürüm Arşivlenmiş durumda olur.
  • Yenidenhydrate beklemede ve softdeleted durumundayken bir blob üzerine yazılırsa, yeniden dolum iptaline neden olur ve sürüm veya softdeleted anlık görüntü Arşivlenmiş 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. Hot, cool ve archive storage tiers.

Ayrıca Bkz.

Azure Depolama'a istekleri yetkilendirme
Durum ve Hata Kodları
Blob Hizmeti Hata Kodları
Blob Hizmeti İşlemleri için Zaman Aşımı Ayarlama