Nastavení úrovně objektu blob

Operace Set Blob Tier nastaví úroveň přístupu v objektu blob. Operace je povolená na objektu blob stránky v účtu služby Premium Storage a v objektu blob bloku v účtu blob nebo účtu pro obecné účely v2. Úroveň objektu blob stránky premium (P1P3P4/P2//atd.) určuje povolenou velikost, IOPS a šířku pásma objektu blob. Úroveň objektu blob bloku určuje Hot//CoolArchive typ úložiště. Tato operace neaktualizuje značky ETag objektu blob.

Podrobné informace o vrstvení na úrovni objektů blob bloku najdete v tématu Horká, studená a archivní úroveň úložiště.

Žádost

Požadavek Set Blob Tier lze vytvořit následujícím způsobem. Doporučuje se https. Nahraďte myaccount názvem vašeho účtu úložiště a myblob názvem objektu blob, pro který se má úroveň změnit.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tier HTTP/1.1

Parametry identifikátoru URI

V identifikátoru URI požadavku je možné zadat následující další parametry.

Parametr Popis
snapshot Nepovinný parametr. Parametr snapshot je neprůhlé DateTime hodnota, která při přítomnosti určuje snímek objektu blob, na který se má nastavit úroveň. Další informace o práci se snímky objektů blob najdete v tématu Vytvoření snímku objektu blob.
versionid Volitelné pro verze 2019-12-12 a novější. Parametr versionid je neprůhlé DateTime hodnota, která při přítomnosti určuje verzi objektu blob, na které se má nastavit úroveň.
timeout Nepovinný parametr. Parametr časového limitu se vyjadřuje v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace služby Blob Service.

Hlavičky požadavku

Následující tabulka popisuje povinné a volitelné hlavičky požadavku.

Hlavička požadavku Popis
Authorization Povinná hodnota. Určuje schéma autorizace, název účtu úložiště a podpis. Další informace najdete v tématu Autorizace požadavků na Azure Storage.
Date nebo x-ms-date Povinná hodnota. Určuje formát UTC (Coordinated Universal Time). Další informace najdete v tématu Autorizace požadavků na Azure Storage.
x-ms-access-tier Povinná hodnota. Označuje úroveň, která se má nastavit v objektu blob. Seznam povolených úrovní objektů blob stránky úrovně Premium najdete v tématu Vysoce výkonné Premium Storage a spravované disky pro virtuální počítače. Pro účet blob Storage nebo pro obecné účely verze 2 jsou Hot//CoolArchiveplatné hodnoty . Podrobné informace o vrstvení úrovně objektů blob úrovně standardního účtu objektů blob najdete v tématu Horká, studená a archivní úroveň úložiště.
x-ms-version Vyžaduje se pro všechny autorizované žádosti. Určuje verzi operace, která se má pro tento požadavek použít. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
x-ms-client-request-id Nepovinný parametr. Poskytuje hodnotu vygenerovanou klientem s neprůhlé hodnotou s limitem znaků 1 kB, který je zaznamenán v analytických protokolech při povolení protokolování analýzy úložiště. Použití této hlavičky se důrazně doporučuje pro korelaci aktivit na straně klienta s požadavky přijatými serverem. Další informace najdete v tématu o protokolování Analýza úložiště a protokolování Azure: Sledování požadavků úložiště pomocí protokolů.
x-ms-rehydrate-priority Nepovinný parametr. Určuje prioritu, se kterou se má dosazovat archivovaný objekt blob. Podporováno ve verzi 2019-02-02 a novějších pro objekty blob bloku. Platné hodnoty jsou High/Standard. Prioritu lze nastavit pro objekt blob pouze jednou pro verze starší než 2020-06-12; tato hlavička bude ignorována u následných požadavků. Výchozí nastavení priority je Standard.

Od verze 2020-06-12 je možné prioritu dosazování aktualizovat po nastavení. Nastavení priority se dá změnit tak StandardHigh , že zavoláte Nastavit úroveň objektu blob s touto hlavičkou nastavenou na High stejnou hodnotu a nastavíte x-ms-access-tier ji na stejnou hodnotu jako dříve nastavená. Nastavení priority nelze snížit z High hodnoty Standardna .

Tato operace také podporuje použití podmíněných hlaviček k vrstvení objektu blob pouze v případě, že je splněna zadaná podmínka. Další informace naleznete v tématu Určení podmíněných hlaviček pro operace služby Blob Service.

Text požadavku

Žádné

Odpověď

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK), pokud se nová úroveň projeví okamžitě, nebo stavový kód 202 (přijato), pokud přechod na novou úroveň čeká na vyřízení. V případě operace objektu blob stránky účtu Premium vrátí stavový kód 200 (OK). V případě objektů blob bloku popisuje následující tabulka stavové kódy HTTP vrácené na základě aktuální úrovně a požadované úrovně objektu blob:

Úroveň Nastavit na horkou úroveň Nastavit na studenou úroveň Nastavit na archivní úroveň
Objekt blob v horké vrstvě 200 200 200
Objekt blob ve studené vrstvě 200 200 200
Objekt blob v archivní úrovni 202 202 200
Objekt blob v archivní úrovni, dosazování na horkou 202 409 409
Objekt blob v archivní vrstvě, dosazování na studenou úroveň 409 202 409

Informace o stavových kódech naleznete v tématu Stavové a chybové kódy.

Hlavičky odpovědi

Odpověď pro tuto operaci obsahuje následující hlavičky. Odpověď může obsahovat také další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička odpovědi Popis
x-ms-request-id Tato hlavička jednoznačně identifikuje požadavek, který byl proveden, a lze ho použít k řešení potíží s požadavkem. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API.
x-ms-version Označuje verzi služby Blob Service použitou k provedení požadavku. Tato hlavička se vrátí pro požadavky provedené ve verzi 2009-09-19 a novější.
x-ms-client-request-id Tato hlavička se dá použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě hlavičky, pokud se nachází v požadavku a hodnota je maximálně 1024 viditelných x-ms-client-request-id znaků ASCII. Pokud v požadavku není hlavička x-ms-client-request-id , nebude tato hlavička v odpovědi k dispozici.

Autorizace

Tuto operaci může volat pouze vlastník účtu úložiště a kdokoli se sdíleným přístupovým podpisem, který má oprávnění k zápisu do tohoto objektu blob nebo jeho kontejneru.

Poznámky

Nastavení úrovně objektu blob pro objekty blob stránky v účtech Premium má následující omezení:

Nastavení úrovně objektu blob bloku v účtu blob storage nebo pro obecné účely v2 má následující omezení:

  • Nastavení úrovně snímku je povolené od verze REST 2019-12-12.
  • Snímky vrstvené do archivu nelze dosazovat zpět do snímku. Tj. snímek nelze přenést zpět na horkou/studenou úroveň. Pouze způsob, jak načíst data z archivovaného snímku nebo verze, je zkopírovat je do nového objektu blob.
  • Pokud je verze kořenovým objektem blob, můžete ho rehydrovat zpět na horkou nebo studenou.
  • Snímky nebo verze v archivovaném stavu nesmí být povýšeny na kořen.
  • Pokud je povolená správa verzí, odstranění kořenového objektu blob v případě, že čeká na dosazování, způsobí zrušení dosazování a verze bude ve stavu Archivace.
  • Pokud se objekt blob přepíše při čekání na dosazování a obnovitelném stavu, dojde ke zrušení dosazování a verze nebo softdeletovaný snímek bude ve stavu Archivace.

Seznam podporovaných úrovní není omezen verzí žádosti a v budoucnu je možné přidat nové úrovně.

Poznámka

Podrobné informace o vrstvení na úrovni objektů blob bloku najdete v tématu Horká, studená a archivní úroveň úložiště.

Viz také

Autorizace žádostí do služby Azure Storage
Stavové kódy a kódy chyb
Kódy chyb služby Blob Service
Nastavení časových limitů pro operace služby Blob Service