Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A Set Blob Tier művelet beállítja a hozzáférési szintet egy blobon. A művelet egy prémium szintű tárfiók lapblobján és blobtárolóban vagy általános célú v2-fiókban található blokkblobon engedélyezett. A prémium szintű lapblobok szintje (P4/P6/P10/P15/P20/P30/P40/P50/P60) határozza meg a blob megengedett méretét, IOPS-ját és sávszélességét. Egy blokk tömbös szintje határozza HotCold//ArchiveCool/Smart/meg a tárolótípust. Ez a művelet nem frissíti a blob ETagjét.
A blokk blob-szintű rétegezésről részletes információkért lásd: Blob tárolási szintek.
Kérés
A Set Blob Tier kérést az alábbiak szerint hozhatja létre. Javasoljuk, hogy HTTPS-t használjon. Cserélje le myaccount a tárfiók nevére, és cserélje le myblob arra a blobnévre, amelynek a szintjét módosítani szeretné.
| Módszer | URI kérése | 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 |
Szabadon választható. A pillanatkép paraméter egy átlátszatlan DateTime érték, amely jelen esetben megadja a blob pillanatképét, hogy beállítson egy réteget. A blob-pillanatképek használatával kapcsolatos további információkért lásd: Blob- pillanatképének létrehozása |
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 meghatározza a blob azon verzióját, amelyen a réteget beállítja. |
timeout |
Szabadon választható. A timeout paraméter másodpercben van kifejezve. További információ: A Blob Storage-műveletek időkorlátjának beállítása. |
Kérelemfejlécek
A szükséges és nem kötelező kérelemfejléceket az alábbi táblázat ismerteti:
| Kérelem fejléce | Leírás |
|---|---|
Authorization |
Szükséges. 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-. |
Date vagy x-ms-date |
Szükséges. A kérelem koordinált egyetemes idejét (UTC) adja meg. További információ: Kérelmek engedélyezése az Azure Storage-. |
x-ms-access-tier |
Szükséges. A blobon beállítani kívánt szintet jelzi. Az engedélyezett prémium szintű lapblobszintek listáját a nagy teljesítményű Premium Storage és a virtuális gépek felügyelt lemezeicímű témakörben találja. Blob tárolás vagy általános célú v2 fiók esetén érvényes értékek Hot, Cool, Cold, Smart és Archive.Megjegyzés: Cold szint támogatott a 2021-12-02-es és újabb verziókhoz.
Smart A tier támogatott a 2026-02-06-os verzióban és annál idősebb, jelenleg nyilvános előnézetben van.A blokk tömbös rétegezésről részletes információért lásd: Blob tároló szintek. |
x-ms-version |
Minden engedélyezett kéréshez szükséges. A kérelemhez használni kívánt művelet verzióját adja meg. További információ: Verziószámozás az Azure Storage Services. |
x-ms-client-request-id |
Szabadon 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 tárolási elemzések naplózása. Ennek a fejlécnek a használata erősen ajánlott az ügyféloldali tevékenységek és a kiszolgáló által fogadott kérések korrelálásához. További információ: A Storage Analytics naplózási. |
x-ms-rehydrate-priority |
Szabadon választható. Azt a prioritást jelzi, amellyel egy archivált blobot rehidratálhat. A 2019-02-02-es verzió és a blokkblobok újabb verziója támogatott. Az érvényes értékek 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 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 Standard-ról High-ra módosítható, ha meghívja Blobszint beállítása ezzel a fejléckészlettel High, és a x-ms-access-tier a korábban beállított értékre állítja. A prioritási beállítást nem lehet High-ról Standard-ra csökkenteni. |
Ez a művelet a 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 a Blob Storage-műveletekhez.
Kérelem törzse
Egyik sem.
Válasz
A válasz tartalmaz egy HTTP-állapotkódot és válaszfejléceket.
Állapotkód
A sikeres művelet a 200-ra (OK) vonatkozó állapotkódot adja vissza, 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ód (elfogadva).
Prémium szintű tárfiókok esetén a lapblob művelet a 200-ra (OK) vonatkozó állapotkódot 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:
| Kötő | Beállítás a gyakori elérésű szintre | Állítsa be a ritka elérésű szintre | Beállítás hideg rétegre | Beállítás archív szintre |
|---|---|---|---|---|
| Blob a gyakori elérésű rétegben | 200 | 200 | 200 | 200 |
| Blob ritka elérésű szinten | 200 | 200 | 200 | 200 |
| Blob hideg rétegben | 200 | 200 | 200 | 200 |
| Blob az 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űvelet válasza 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 | Leírás |
|---|---|
x-ms-request-id |
Egyedileg azonosítja a kérést, amely 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ó. Ez a fejléc a 2009-09-19-es és újabb verzióval kapcsolatos kérelmek esetén lesz visszaadva. |
x-ms-client-request-id |
A kérések és a megfelelő válaszok hibaelhárítására használható. Ennek az élőfejnek az é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. |
Felhatalmazás
Az Azure Storage-beli adathozzáférési műveletek meghívásához engedélyezésre van szükség. Az alábbi módon engedélyezheti a Set Blob Tier műveletet.
Fontos
A Microsoft azt javasolja, hogy felügyelt identitásokkal használja a Microsoft Entra ID-t az Azure Storage-kérelmek engedélyezéséhez. A Microsoft Entra ID kiváló biztonságot és egyszerű használatot biztosít a megosztott kulcsok engedélyezéséhez képest.
Az Azure Storage támogatja a Microsoft Entra ID használatát a blobadatokra irányuló kérések engedélyezéséhez. A Microsoft Entra ID-val azure-beli szerepköralapú hozzáférés-vezérléssel (Azure RBAC) adhat engedélyeket egy biztonsági tagnak. A biztonsági tag lehet felhasználó, csoport, alkalmazásszolgáltatásnév vagy Azure-beli felügyelt identitás. A biztonsá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 kapcsolatos kérések engedélyezésére használható.
A Microsoft Entra ID használatával történő engedélyezésről további információt A blobok hozzáférésének engedélyezése a Microsoft Entra-azonosítóvalcímű témakörben talál.
Engedélyek
Az alábbiakban azokat az RBAC-műveletet soroljuk fel, amelyek szükségesek ahhoz, hogy egy Microsoft Entra-felhasználó, csoport, felügyelt identitás vagy szolgáltatásnév meghívja a Set Blob Tier műveletet, valamint a legkevésbé kiemelt, beépített Azure RBAC-szerepkört, amely tartalmazza ezt a műveletet:
- Azure RBAC-művelet:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
- Legkevésbé kiemelt beépített szerepkör:Storage Blob Data Közreműködő
A szerepkörök Azure RBAC-vel való hozzárendeléséről további információt Azure-szerepkör hozzárendelése a blobadatokhoz való hozzáféréshezcímű témakörben talál.
Megjegyzések
A prémium szintű fiókokban a lapblobok szintjének beállítása a következő korlátozásokkal jár:
- Az új blobszint nem lehet alacsonyabb, mint a meglévő.
- Az új blobszintnek képesnek kell lennie a blob tartalomhosszának elhelyezésére. A rétegek és az engedélyezett tartalomhosszuk listáját A virtuális gépekhez készült nagy teljesítményű prémium szintű tárolók és felügyelt lemezekcímű témakörben találja.
A blokkblob szintjének blobtárolón vagy általános célú v2-fiókon való beállítása a következő korlátozásokkal jár:
- A réteg beállítása a 2019-12-12-es REST-verziótól engedélyezett.
- A
archiverétegzett pillanatképek nem rehidratálhatók vissza a pillanatképbe. Vagyis a pillanatképet nem lehet visszahozni egy online (hotcoldsmart/cool//) szintre. Az adatok egyarchivepillanatképből vagy verzióból való lekérésének egyetlen módja az, ha egy új blobba másolja azokat. - Ha a verzió gyökérfolb, visszahidratálható online (
hotcoldsmart/cool//) szintre. - Az
archiveállapotban lévő pillanatképek vagy verziók nem előléptethetők gyökérként. - Ha engedélyezve van a verziószámozás, a rehidratát állapotban lévő gyökérblob törlése a rehidratálás törlését eredményezi, a verzió pedig
archiveállapotban lesz. - Ha egy blob rehidratátum függőben lévő és helyreállíthatóan törölt állapotban van, az a rehidratálás törlését eredményezi, és a helyreállíthatóan törölt pillanatkép verziója
archiveállapotban 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.
Az ügyfél által biztosított titkosítást használó blobok esetében a Set Blob Tier a 2023-08-03-s és újabb verziók támogatják. A 2023-08-03 előtti verziók esetében Set Blob Tier az ügyfél által megadott titkosítást használó blobok állapotkódját adja vissza 409.
Jegyzet
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 szinteket.
Számlázás
A díjszabási kérések olyan ügyfelektől származhatnak, amelyek Blob Storage API-kat használnak közvetlenül a Blob Storage REST API-ból vagy egy Azure Storage-ügyfélkódtárból. Ezek a kérések tranzakciónkénti díjakat halmoznak fel. A tranzakció típusa hatással van a fiók díjának módjára. 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 Set Blob Tier kérelmek számlázási kategóriáját 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 az Azure Blob Storage díjszabási című témakörben olvashat.
Lásd még:
Kérések engedélyezése az Azure Storage-
Állapot- és hibakódok
Blob Storage hibakódjai
Időtúllépések beállítása a Blob Storage-műveletekhez