Blobszint beállítása
A Set Blob Tier
művelet beállítja a hozzáférési szintet egy blobon. A művelet engedélyezett egy prémium szintű tárfiók lapblobján és egy blobtárolóban vagy általános célú v2-fiókban található blokkblobon. A prémium szintű lapblob szintje (P4
/P15
//P30
P40
/P50
///P60
P6
P10
/P20
) határozza meg a blob engedélyezett méretét, IOPS-ját és sávszélességét. A blokkblobok szintje határozza meg a Hot
Cold
Archive
/Cool
//tároló típusát. Ez a művelet nem frissíti a blob ETagjét.
A blokkblobszintű rétegzésével kapcsolatos részletes információkért lásd: Gyakori elérésű, ritka elérésű és archív tárolási szintek.
Kérés
A kérést az Set Blob Tier
alábbiak szerint hozhatja létre. Javasoljuk, hogy HTTPS-t használjon. Cserélje le a myaccount kifejezést a tárfiók nevére, a myblob helyett pedig arra a blobnévre, amelynek a szintjét módosítani szeretné.
Metódus | Kérés URI-ja | HTTP-verzió |
---|---|---|
PUT |
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tier |
HTTP/1.1 |
URI-paraméterek
A kérelem URI-ján a következő további paramétereket adhatja meg:
Paraméter | Leírás |
---|---|
snapshot |
Választható. A pillanatkép-paraméter egy átlátszatlan DateTime érték, amely jelen esetben megadja a blobpillanatképet a szint beállításához. A blobpillanatképek használatával kapcsolatos további információkért lásd: Létrehozás egy blob pillanatképét |
versionid |
Nem kötelező a 2019-12-12-es és újabb verziókhoz. A versionid paraméter egy átlátszatlan DateTime érték, amely jelen esetben a blob verzióját adja meg a réteg beállításához. |
timeout |
Választható. A timeout paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása Blob Storage-műveletekhez. |
Kérésfejlécek
A szükséges és nem kötelező kérésfejléceket az alábbi táblázat ismerteti:
Kérelem fejléce | Leírás |
---|---|
Authorization |
Kötelező. Megadja az engedélyezési sémát, a tárfiók nevét és az aláírást. További információ: Kérelmek engedélyezése az Azure Storage-ba. |
Date vagy x-ms-date |
Kötelező. Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját. További információ: Kérelmek engedélyezése az Azure Storage-ba. |
x-ms-access-tier |
Kötelező. A blobon beállítandó szintet jelzi. Az engedélyezett prémium szintű lapblobszintek listáját lásd: Nagy teljesítményű Premium Storage és felügyelt lemezek virtuális gépekhez. Blob Storage- vagy általános célú v2-fiók esetén az érvényes értékek a következők Hot : , Cool , Cold és Archive .
Megjegyzés:Cold A szint a 2021-12-02-es és újabb verziókban támogatott. A standard blobfiókok blobszintű rétegzésével kapcsolatos részletes információkért lásd: Gyakori elérésű, ritka elérésű és archív tárolási szintek. |
x-ms-version |
Minden engedélyezett kéréshez szükséges. A kérelemhez használandó művelet verzióját adja meg. További információ: Az Azure Storage-szolgáltatások verziószámozása. |
x-ms-client-request-id |
Választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kB-os karakterkorláttal, amely akkor lesz rögzítve az elemzési naplókban, ha engedélyezve van a storage analytics naplózása. A fejléc használata erősen ajánlott az ügyféloldali tevékenységek és a kiszolgáló által kapott kérések összevetéséhez. További információ: Tudnivalók Storage Analytics naplózásról. |
x-ms-rehydrate-priority |
Választható. Azt a prioritást jelzi, amellyel egy archivált blobot rehidratálhat. A 2019-02-02-es és újabb verzióban támogatott a blokkblobok esetében. Az érvényes értékek a következők: High /Standard . A prioritás csak egyszer állítható be a blobokon a 2020-06-12 előtti verziók esetében; ezt a fejlécet a rendszer figyelmen kívül hagyja a későbbi kérések során. Az alapértelmezett prioritási beállítás a következő: Standard .A rehidratálási prioritás a 2020-06-12-es verziótól kezdve frissíthető a korábbi beállítás után. A prioritási beállítás a Blobszint beállítása beállítás meghívásával módosítható Standard úgy, High hogy ez a fejléc a korábban beállított értékre High x-ms-access-tier van állítva. A prioritási beállítást nem lehet a értékről a értékre High Standard csökkenteni. |
Ez a művelet feltételes fejlécek használatát is támogatja a blob rétegzéséhez, ha egy adott feltétel teljesül. További információ: Feltételes fejlécek megadása Blob Storage-műveletekhez.
A kérés törzse
Nincsenek.
Reagálás
A válasz egy HTTP-állapotkódot és válaszfejléceket tartalmaz.
Állapotkód
A sikeres művelet 200-ra (OK) adja vissza az állapotkódot, ha az új szint azonnal érvénybe lép, vagy ha az új szintre való áttérés függőben van, a 202-s állapotkódot (elfogadva) adja vissza.
Prémium szintű tárfiókok esetén a lapblob művelet a 200 -os állapotkódot (OK) adja vissza.
Blokkblobok esetén a visszaadott HTTP-állapotkódokat a blob aktuális és kért szintjei alapján a következő táblázat ismerteti:
Szint | Beállítás gyakori elérésű szintre | Beállítás ritka elérésű szintre | Beállítás ritka elérésű szintre | Beállítás archív szintre |
---|---|---|---|---|
Blob a gyakori elérésű szinten | 200 | 200 | 200 | 200 |
Blob ritka elérésű szinten | 200 | 200 | 200 | 200 |
Blob a ritka elérésű rétegben | 200 | 200 | 200 | 200 |
Blob archív szinten | 202 | 202 | 202 | 200 |
Blob archív szinten, rehidratálás gyakori elérésűre | 202 | 409 | 409 | 409 |
Blob archív szinten, rehidratálás ritka elérésűre | 409 | 202 | 409 | 409 |
Blob archív szinten, rehidratálás hidegre | 409 | 409 | 202 | 409 |
További információ az állapotkódokról: Állapot- és hibakódok.
Válaszfejlécek
A műveletre adott válasz a következő fejléceket tartalmazza. A válasz további szabványos HTTP-fejléceket is tartalmazhat. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.
Válaszfejléc | Description |
---|---|
x-ms-request-id |
Egyedileg azonosítja a végrehajtott kérést, és a kérés hibaelhárításához használható. További információ: API-műveletek hibaelhárítása. |
x-ms-version |
A kérés végrehajtásához használt Blob Storage-verzió. A rendszer ezt a fejlécet adja vissza a 2009-09-19-es és újabb verzióval kapcsolatos kérésekhez. |
x-ms-client-request-id |
A kérések és a kapcsolódó válaszok hibaelhárítására használható. A fejléc értéke megegyezik a x-ms-client-request-id fejléc értékével, ha az szerepel a kérelemben, és az érték legfeljebb 1024 látható ASCII-karaktert tartalmaz. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, az nem jelenik meg a válaszban. |
Engedélyezés
Az Azure Storage-ban bármilyen adathozzáférési művelet meghívásához engedélyezésre van szükség. A műveletet az Set Blob Tier
alábbiak szerint engedélyezheti.
Fontos
A Microsoft azt javasolja, hogy Microsoft Entra ID felügyelt identitásokkal engedélyezze az Azure Storage-ra irányuló kéréseket. Microsoft Entra ID a megosztott kulcs engedélyezéséhez képest kiváló biztonságot és könnyű használatot biztosít.
Az Azure Storage támogatja az Microsoft Entra ID használatát a blobadatokra irányuló kérések engedélyezéséhez. A Microsoft Entra ID azure-beli szerepköralapú hozzáférés-vezérléssel (Azure RBAC) adhat engedélyeket egy biztonsági tagnak. A rendszerbiztonsági tag lehet felhasználó, csoport, alkalmazásszolgáltatásnév vagy Azure-beli felügyelt identitás. A rendszerbiztonsági tagot a Microsoft Entra ID hitelesíti egy OAuth 2.0-jogkivonat visszaadásához. A jogkivonat ezután a Blob szolgáltatással szembeni kérések engedélyezésére használható.
További információ a Microsoft Entra ID használatával történő engedélyezésről: Blobok hozzáférésének engedélyezése Microsoft Entra ID használatával.
Engedélyek
Az alábbiakban felsoroljuk azt az RBAC-műveletet, amely a művelet meghívásához Set Blob Tier
szükséges Microsoft Entra felhasználóhoz, csoporthoz, felügyelt identitáshoz vagy szolgáltatásnévhez, valamint a legkevésbé emelt szintű beépített Azure RBAC-szerepkörhöz, amely tartalmazza ezt a műveletet:
- Azure RBAC-művelet:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
- Legkevésbé emelt szintű beépített szerepkör:Storage-blobadatok közreműködője
A szerepkörök Azure RBAC-vel való hozzárendeléséről további információt az Azure-szerepkör hozzárendelése a blobadatokhoz való hozzáféréshez című témakörben talál.
Megjegyzések
A prémium szintű fiókokban lévő lapblobok blobszintjének beállítása a következő korlátozásokkal rendelkezik:
- Az új blobszint nem lehet alacsonyabb a meglévőnél.
- Az új blobszintnek képesnek kell lennie alkalmazkodni a blob tartalomhosszához. A rétegek listáját és az engedélyezett tartalomhosszukat lásd: Nagy teljesítményű prémium szintű tárolás és felügyelt lemezek virtuális gépekhez.
A blokkblob rétegének blobtárolóra vagy általános célú v2-fiókra való beállítása a következő korlátozásokkal rendelkezik:
- A szint pillanatképre való beállítása a REST 2019-12-12-es verziójától engedélyezett.
- A rétegzett
archive
pillanatképek nem rehidratálhatók vissza a pillanatképbe. Vagyis a pillanatképet nem lehet visszahozni egyhot
vagycool
több szintre. Az adatok pillanatképből vagy verzióbólarchive
való lekérésének egyetlen módja az, ha egy új blobba másolja az adatokat. - Ha a verzió egy gyökérblob, akkor vissza lehet hidratálni a vagy
cool
ahot
-re. - Az állapotban lévő
archive
pillanatképek és verziók nem előléptethetők gyökérszintűre. - Ha a verziószámozás engedélyezve van, a rehidratát állapotban lévő gyökérblob törlése a rehidratálás megszakítását eredményezi, a verzió pedig állapotban
archive
lesz. - Ha egy blob felülíródik rehidratátum függőben lévő és helyreállíthatóan törölt állapotban, az a rehidratálás megszakítását eredményezi, és a helyreállíthatóan törölt pillanatkép verziója állapotban
archive
lesz.
A támogatott szintek listáját a kérelem verziója nem korlátozza, és a jövőben új szintek is hozzáadhatók.
Megjegyzés
A blokkblobszintű rétegzéssel kapcsolatos részletes információkért lásd: Gyakori elérésű, ritka elérésű és archív tárolási szintek.
Számlázás
A díjszabási kérések a Blob Storage API-kat használó ügyfelektől, közvetlenül a Blob Storage REST API-ból vagy egy Azure Storage-ügyfélkódtárból származhatnak. Ezek a kérések tranzakciónkénti díjakat halmoznak fel. A tranzakció típusa befolyásolja a fiók terhelését. Az olvasási tranzakciók például más számlázási kategóriába tartoznak, mint az írási tranzakciók. Az alábbi táblázat a tárfiók típusa alapján a kérelmek számlázási kategóriáját Set Blob Tier
mutatja be:
Művelet | Tárfiók típusa | Számlázási kategória |
---|---|---|
Blobszint beállítása (szinttel lejjebb) | Prémium szintű blokkblob Standard általános célú v2 |
Írási műveletek |
Blobszint beállítása (szinttel feljebb) | Prémium szintű blokkblob Standard általános célú v2 |
Olvasási műveletek |
A megadott számlázási kategória díjszabásáról a Azure Blob Storage Díjszabás című témakörben talál további információt.
Lásd még
Kérések engedélyezése az Azure Storage-nak
Állapot- és hibakódok
Blob Storage-hibakódok
Időtúllépések beállítása a Blob Storage-műveletekhez