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, 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, Coldvagy 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:

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.

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