Blob Katmanını Ayarla
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
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 , Cold ve 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 |
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 Standard High 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 bilgiler
İ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.
- Microsoft Entra Id (önerilen)
-
paylaşılan erişim imzaları (SAS)
-
paylaşılan anahtar
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ü birhot
veyacool
katmanına geri getirilemiyor. Verileriarchive
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
veyacool
olarak 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