Nastavení úrovně objektu blob

Článek
02/02/2023
6 min ke čtení

Operace Set Blob Tier nastaví úroveň přístupu v objektu blob. Operace je povolená u objektu blob stránky v účtu služby Premium Storage a u objektu blob bloku v úložišti objektů blob nebo účtu pro obecné účely v2. Úroveň prémiového objektu blob stránky (P1, P2, P3, P4 atd.) určuje povolenou velikost, vstupně-výstupní operace za sekundu (IOPS) a šířku pásma objektu blob. Úroveň objektu blob bloku určuje Hottyp úložiště , Cool, Coldnebo Archive . Tato operace neaktualizuje značku ETag objektu blob.

Poznámka

Úroveň Cold je aktuálně ve verzi Preview.

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

Žádost

Požadavek můžete sestavit Set Blob Tier následujícím způsobem. Doporučujeme používat protokol HTTPS. Nahraďte myaccount názvem vašeho účtu úložiště a myblob nahraďte názvem objektu blob, pro který se má změnit úroveň.

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 můžete zadat následující další parametry:

Parametr	Popis
`snapshot`	Nepovinný parametr. Parametr snapshot je neprůzvrná `DateTime` hodnota, která pokud je k dispozici, 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 verzi 2019-12-12 a novější. Parametr `versionid` je neprůžná `DateTime` hodnota, která pokud je k dispozici, určuje verzi objektu blob, na kterou se má nastavit úroveň.
`timeout`	Nepovinný parametr. Parametr `timeout` se vyjadřuje v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace služby Blob Storage.

Hlavičky požadavku

Požadované a volitelné hlavičky požadavků jsou popsané v následující tabulce:

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ů do služby 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ů do služby 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é úložiště premium a spravované disky pro virtuální počítače. Pro úložiště objektů blob nebo účet pro obecné účely verze 2 jsou `Hot`platné hodnoty , `Cool`, `Cold`nebo `archive`. Poznámka: Úroveň `Cold` je aktuálně ve verzi Preview a podporuje se ve verzi 2021-12-02 a novější. Podrobné informace o vrstvení na úrovni objektů blob účtu objektů blob úrovně Standard najdete v tématu Horká, studená a archivní vrstva ú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 klientem vygenerovanou neprůselnou hodnotu s limitem počtu znaků 1 kibibajt (KiB), který se zaznamená v protokolech, když je protokolování povolené. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá. Další informace najdete v tématu Informace o protokolování Analýza úložiště.
`x-ms-rehydrate-priority`	Nepovinný parametr. Určuje prioritu, se kterou se má dosadovat archivovaný objekt blob. Podporováno ve verzi 2019-02-02 a novější pro objekty blob bloku. Platné hodnoty jsou `High` nebo `Standard`. Pro verze starší než 2020-06-12 je možné nastavit prioritu objektu blob pouze jednou. tato hlavička se v následných požadavcích ignoruje. Výchozí nastavení priority je `Standard`. Od verze 2020-06-12 můžete po nastavení priority dosazování aktualizovat. Nastavení priority můžete změnit z `Standard` na `High` tak, že zavoláte Nastavit úroveň objektu blob s touto hlavičkou nastavenou `x-ms-access-tier` na `High` hodnotu a na stejnou hodnotu, na kterou byla nastavená dříve. Nastavení priority nelze snížit z `High` hodnoty na `Standard`.

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 najdete v tématu Určení podmíněných hlaviček pro operace služby Blob Storage.

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

Pro účty premium Storage vrátí operace objektu blob stránky stavový kód 200 (OK).

V případě objektů blob bloku jsou vrácené stavové kódy HTTP na základě aktuální a požadované úrovně objektu blob popsané v následující tabulce:

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

Další informace o stavových kódech najdete v tématu Kódy stavu a chyb.

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď může také obsahovat 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`	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`	Verze služby Blob Storage, která se použila ke spuštění požadavku. Tato hlavička se vrátí pro požadavky provedené proti verzi 2009-09-19 a novější.
`x-ms-client-request-id`	Dá se použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě `x-ms-client-request-id` hlavičky, pokud se nachází v požadavku, a hodnota obsahuje maximálně 1 024 viditelných znaků ASCII. Pokud se hlavička `x-ms-client-request-id` v požadavku nenachází, v odpovědi se nezobrazí.

Autorizace

Tuto operaci může volat pouze vlastník účtu úložiště a kdokoli se sdíleným přístupovým podpisem s oprávněním 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í:

Nová úroveň objektu blob nemůže být nižší než ta stávající.
Nová úroveň objektu blob by měla být schopná přizpůsobit délku obsahu objektu blob. Seznam úrovní a jejich povolené délky obsahu najdete v tématu Vysoce výkonné úložiště Premium a spravované disky pro virtuální počítače.

Nastavení úrovně objektu blob bloku ve službě Blob Storage nebo účtu pro obecné účely verze 2 má následující omezení:

Nastavení úrovně pro snímek je povolené od verze REST 2019-12-12-2012.
Snímky, které jsou vrstvené na archive , není možné dosadovat zpět do snímku. To znamená, že snímek nelze přenést zpět na hot úroveň nebo cool . Jediným způsobem, jak načíst data ze archive snímku nebo verze, je zkopírovat je do nového objektu blob.
Pokud se jedná o verzi kořenového objektu blob, je možné ho rehydrovat zpět na hot nebo cool.
Snímky nebo verze ve archive stavu není možné povýšit na kořenovou úroveň.
Pokud je povolená správa verzí, odstranění kořenového objektu blob ve stavu čekání na rehydrataci způsobí zrušení dosazování a verze bude ve archive stavu .
Pokud se objekt blob ve stavu čekání na rehydraci a obnovitelného odstranění přepíše, dojde ke zrušení dosazování a verze obnovitelně odstraněného snímku bude ve archive stavu .

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