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 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. A blokkblobok szintje határozza meg Hot
/Cool
/Cold
/Archive
tárolási típust. Ez a művelet nem frissíti a blob ETagjét.
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.
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 Storage vagy általános célú v2-fiók esetén az érvényes értékek Hot , Cool , Cold és Archive .
Megjegyzés:Cold szint támogatott a 2021-12-02-es és újabb verziókhoz. 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 szinteket. |
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
archive
rétegzett pillanatképek nem rehidratálhatók vissza a pillanatképbe. Vagyis a pillanatkép nem állítható visszahot
vagycool
szintre. Az adatok egyarchive
pillanatké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érblob, vissza lehet hidratálni
hot
vagycool
. - 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