Ange blobnivå
Åtgärden Set Blob Tier anger åtkomstnivån för en blob. Åtgärden tillåts på en sidblob i ett Premium Storage-konto och på en blockblob i en bloblagring eller ett v2-konto för generell användning. Premium-sidblobens nivå avgör vilken storlek, IOPS och bandbredd som tillåts för bloben. En blockblobs nivå avgör Hot / Cool / Archive lagringstyp. Den här åtgärden uppdaterar inte blobens ETag.
Detaljerad information om blockblobnivåindelade finns i Lagringsnivåer för Hot, Cool och Arkiv.
Förfrågan
Begäran Set Blob Tier kan konstrueras på följande sätt. HTTPS rekommenderas. Ersätt myaccount med namnet på ditt lagringskonto och myblob med det blobnamn som nivån ska ändras för.
| Metod | URI för förfrågan | HTTP-version |
|---|---|---|
PUT |
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tier |
HTTP/1.1 |
URI-parametrar
Följande ytterligare parametrar kan anges på begärans-URI:en.
| Parameter | Beskrivning |
|---|---|
snapshot |
Valfritt. Parametern för ögonblicksbilden är ett täckande DateTime värde som anger vilken blobögonblicksbild som ska anges på nivån när den finns. Mer information om hur du arbetar med blobögonblicksbilder finns i Skapa en ögonblicksbild av en blob |
versionid |
Valfritt för versionerna 2019-12-12 och senare. Parametern versionid är ett täckande värde som, när det finns, anger vilken version av DateTime bloben som nivå ska anges för. |
timeout |
Valfritt. Tidsgränsparametern uttrycks i sekunder. Mer information finns i Ange tidsgränser för Blob Service-åtgärder. |
Rubriker för begäran
I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.
| Begärandehuvud | Description |
|---|---|
Authorization |
Krävs. Anger auktoriseringsschema, lagringskontonamn och signatur. Mer information finns i Authorize requests to Azure Storage. |
Date eller x-ms-date |
Krävs. Anger Coordinated Universal Time (UTC) för begäran. Mer information finns i Authorize requests to Azure Storage. |
x-ms-access-tier |
Krävs. Anger vilken nivå som ska anges för bloben. En lista över tillåtna blobnivåer för Premium-sidor finns i Högpresterande Premium Storage och hanterade diskar för virtuella datorer. För bloblagring eller v2-konto för generell användning är giltiga värden Hot / Cool / Archive . Detaljerad information om blobnivåindelade standardblobnivåer finns i Lagringsnivåer för hot, lågnivå och arkivlagring. |
x-ms-version |
Krävs för alla auktoriserade begäranden. Anger vilken version av åtgärden som ska användas för den här begäran. Mer information finns i Versionshantering för Azure Storage Services. |
x-ms-client-request-id |
Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kB som registreras i analysloggarna när lagringsanalysloggning är aktiverat. Användning av det här huvudet rekommenderas starkt för korrelering av aktiviteter på klientsidan med begäranden som tas emot av servern. Mer information finns i About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests (Om Storage Analytics-loggning och Azure Logging: Använda loggar för att spåra Storage begäranden. |
x-ms-rehydrate-priority |
Valfritt. Anger med vilken prioritet en arkiverad blob ska rehydreras. Stöds i version 2019-02-02 och senare för blockblobar. Giltiga värden är High / Standard . Prioriteten kan bara anges för en blob en gång för versioner före 2020-06-12. det här huvudet ignoreras vid efterföljande begäranden. Standardinställningen för prioritet är Standard .Från och med version 2020-06-12 kan återfuktningsprioritet uppdateras efter att den tidigare har angetts. Prioritetsinställningen kan ändras från till genom att anropa Set Blob Tier (Ange blobnivå) med det här huvudet inställt på och Standard ange till samma värde som High High x-ms-access-tier tidigare. Prioritetsinställningen kan inte sänkas från High till Standard . |
Den här åtgärden stöder också användning av villkorsstyrda huvuden för att nivåindela bloben endast om ett angivet villkor uppfylls. Mer information finns i Ange villkorsstyrda huvuden för Blob Service-åtgärder.
Begärandetext
Inga.
Svarsåtgärder
Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.
Statuskod
En lyckad åtgärd returnerar statuskod 200 (OK) om den nya nivån börjar gälla omedelbart, eller statuskod 202 (accepterad) om övergången till den nya nivån väntar. För sidblobåtgärden på premiumkontot returneras statuskod 200 (OK). För blockblobar beskriver tabellen nedan de HTTP-statuskoder som returneras baserat på aktuell nivå och den begärda nivån för bloben:
| Ange till hot-nivå | Ställ in på den coola nivån | Ställ in på arkivnivå | |
|---|---|---|---|
| Blob i hot-nivå | 200 | 200 | 200 |
| Blob på den coola nivån | 200 | 200 | 200 |
| Blob på arkivnivå | 202 | 202 | 200 |
| Blob på arkivnivå, rehydrat till hot | 202 | 409 | 409 |
| Blob på arkivnivå, rehydrat till cool | 409 | 202 | 409 |
Information om statuskoder finns i Status och Felkoder.
Svarsrubriker
Svaret för den här åtgärden innehåller huvudena nedan. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden följer protokollspecifikationen HTTP/1.1.
| Svarshuvud | Description |
|---|---|
x-ms-request-id |
Det här huvudet identifierar unikt begäran som har gjorts och kan användas för felsökning av begäran. Mer information finns i Felsöka API-åtgärder. |
x-ms-version |
Anger vilken version av blobtjänsten som används för att köra begäran. Det här huvudet returneras för begäranden som görs mot version 2009-09-19 och senare. |
x-ms-client-request-id |
Det här huvudet kan användas för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet för -huvudet om det finns i begäran och värdet är högst x-ms-client-request-id 1 024 synliga ASCII-tecken. Om x-ms-client-request-id -huvudet inte finns i begäran finns det här huvudet inte i svaret. |
Auktorisering
Den här åtgärden kan bara anropas av lagringskontots ägare och av vem som helst med en signatur för delad åtkomst som har behörighet att skriva till bloben eller dess container.
Kommentarer
Att ange en blobbnivå för sidblobar i Premium-konton har följande begränsningar:
- Den nya blobnivån kanske inte är lägre än den befintliga.
- Den nya blobnivån ska kunna hantera blobens innehållslängd. En lista över nivåer och tillåten innehållslängd finns i Högpresterande Premium Storage och hanterade diskar för virtuella datorer.
Att ange blockblobens nivå på ett bloblagringskonto eller ett v2-konto för generell användning har följande begränsningar:
- Inställningsnivå för en ögonblicksbild tillåts från REST-version 2019-12-12.
- Ögonblicksbilder som nivåindelats till arkivet kan inte återhydreras till ögonblicksbilden. dvs. ögonblicksbilden kan inte tas tillbaka till nivån Hot/Cool. Det enda sättet att hämta data från en arkiverad ögonblicksbild eller version är att kopiera dem till en ny blob.
- Om versionen är en rotblob kan den återhydreras till Hot eller Cool.
- Ögonblicksbilder eller versioner i arkiverat tillstånd kan inte befordras till rot.
- När versionshantering är aktiverat resulterar borttagning av rotblob i väntande rehydrering i att rehydreringen avbryts och versionen är i tillståndet Arkiverad.
- Om en blob skrivs över i väntande och mjukt bortdöppet tillstånd, resulterar det i annullering av rehydrate och versionen eller mjukt bortdögonblicksbild är i tillståndet Arkiverad.
Listan över nivåer som stöds begränsas inte av begärandeversionen och nya nivåer kan läggas till i framtiden.
Anteckning
Detaljerad information om nivåindelad blockblob finns i Lagringsnivåer för hot, låg lågnivå och arkiv.
Se även
Auktorisera begäranden till Azure Storage
Status och felkoder
Felkoder för Blob Service
Ange tidsgränser för Blob Service-åtgärder