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, 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
, Cold
vagy 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 Standard High 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 egyhot
vagycool
több szintre. Az adatok pillanatképből vagy verzióbólarchive
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
hot
cool
rehidratá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.
Lásd még
Kérelmek 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