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
//P30
P40
/P50
///P60
P6
P10
/P20
), blobun izin verilen boyutunu, IOPS'sini ve bant genişliğini belirler. Blok blobu katmanı, depolama türünü belirlerHot
Archive
//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 , Cold ve Archive değ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ı High x-ms-access-tier Olarak Blob Katmanı Ayarla çağrılarak olarak değiştirilebilir Standard High . Öncelik ayarı olarak High Standard 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
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 eylemi: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
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 barındırabilmelidir. Katmanların ve izin verilen içerik uzunlukları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ı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ü birhot
veyacool
katmanına geri getirilemiyor. Verileri anlıkarchive
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
'yehot
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