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//P30P40/P50///P60P6P10/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 HotColdArchive/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: 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 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 Highx-ms-access-tier van állítva. A prioritási beállítást nem lehet a értékről a értékre HighStandardcsö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 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 lesz visszaadva a 2009-09-19-es és újabb verzióval kapcsolatos kérésekhez.
x-ms-client-request-id A kérések és a megfelelő válaszok hibaelhárítására használható. A fejléc értéke megegyezik a x-ms-client-request-id kérelemben szereplő fejléc értékével, é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, akkor az nem jelenik meg a válaszban.

Engedélyezés

Az azure storage-beli adathozzáférési műveletek meghívásakor engedélyezés szükséges. A műveletet az Set Blob Tier alábbiak szerint engedélyezheti.

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 azure-beli szerepköralapú hozzáférés-vezérléssel (Azure RBAC) adhat engedélyeket egy rendszerbiztonsági tagnak. A rendszerbiztonsági tag lehet felhasználó, csoport, alkalmazás-szolgáltatásnév vagy Azure-beli felügyelt identitás. A rendszerbiztonsági tag hitelesítését a Microsoft Entra ID végzi egy OAuth 2.0-jogkivonat visszaadásához. A jogkivonat ezután a Blob szolgáltatásra irányuló 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: Blobokhoz való hozzáférés engedélyezése Microsoft Entra ID használatával.

Engedélyek

Az alábbiakban azokat az RBAC-műveletet soroljuk fel, amelyek szükségesek ahhoz, hogy egy Microsoft Entra felhasználó, csoport vagy szolgáltatásnév meghívja a Set Blob Tier műveletet, valamint a legkevésbé emelt szintű beépített Azure RBAC-szerepkört, amely tartalmazza ezt a műveletet:

A szerepkörök Azure RBAC-vel való hozzárendelésével kapcsolatos további információkért lásd: Azure-szerepkör hozzárendelése blobadatokhoz való hozzáféréshez.

Megjegyzések

A prémium szintű fiókokban lévő lapblobok rétegének beállítása a következő korlátozásokkal jár:

A blokkblob rétegének blobtárolóban vagy általános célú v2-fiókban való beállítására a következő korlátozások vonatkoznak:

  • A réteg beállítása pillanatképen 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 egy hot vagy cool több szintre. Az adatok pillanatképből vagy verzióból archive való lekérésének egyetlen módja az, ha átmásolja azokat egy új blobba.
  • Ha a verzió egy gyökérblob, akkor a vagy a fájlba hotcoolrehidratálható.
  • 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 rehidratálásra váró és helyreállíthatóan törölt állapotban van felülírva, 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 blokkblobszintek 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.

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 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ával kapcsolatos további információkért lásd: Azure Blob Storage Díjszabás.

Lásd még

Kérések engedélyezése az Azure Storage-ba
Állapot- és hibakódok
Blob Storage-hibakódok
Időtúllépések beállítása a Blob Storage-műveletekhez