Blobszint beállítása

Cikk
02/02/2023
5 perc alatt elolvasható

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, valamint egy blobtárolóban vagy általános célú v2-fiókban található blokkblobon. A prémium szintű lapblobok szintje (P1, P2, P3, P4 stb.) meghatározza a blob megengedett méretét, bemeneti/kimeneti műveleteit másodpercenként (IOPS) és sávszélességét. A blokkblobok szintje határozza meg a Hot, Cool, Coldvagy Archive tárolótípust. Ez a művelet nem frissíti a blob ETagjét.

Megjegyzés

A Cold szint jelenleg előzetes verzióban érhető el.

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ű prémium szintű tárolás és felügyelt lemezek virtuális gépekhez (VM-ek) . Blob Storage- vagy általános célú v2-fiók esetén az érvényes értékek a következők `Hot`: , `Cool`, `Cold`vagy `archive`. Megjegyzés: A `Cold` szint jelenleg előzetes verzióban érhető el, és 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 kibibyte (KiB) karakterkorláttal, amelyet a naplózás engedélyezésekor rögzít a naplókban. Javasoljuk, hogy ezt a fejlécet használva korrelálja az ügyféloldali tevékenységeket a kiszolgáló által kapott kérésekkel. 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 blokkblobok esetében a 2019-02-02-es és újabb verziókban támogatott. Az érvényes értékek a vagy `Standard`.`High` A prioritás csak egyszer állítható be a blobokon a 2020-06-12-nél korábbi 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 2020-06-12-es verziótól a beállítás után frissítheti a rehidratálási prioritást. A prioritási beállítást `StandardHigh` a Set Blob Tier (Blobszint beállítása) meghívásával módosíthatja, a fejléc pedig értékre van állítva `High` , és `x-ms-access-tier` úgy, hogy ugyanazt az értéket állítja be, amelyre korábban beállította. A prioritási beállítás nem csökkenthető a értékről `High` a értékre `Standard`.

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	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 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

Ezt a műveletet csak a tárfiók tulajdonosa és bárki hívhatja meg, aki rendelkezik közös hozzáférésű jogosultságkóddal, és rendelkezik engedéllyel a blobba vagy annak tárolójába való íráshoz.

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:

Az új blobszint nem lehet alacsonyabb, mint a meglévő.
Az új blobszintnek képesnek kell lennie a blob tartalmának hosszára. A szintek 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ó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.