Nastavení úrovně objektu blob

  • Článek
  • 5 min ke čtení

Operace Set Blob Tier nastaví úroveň přístupu pro objekt blob. Operace je povolená pro objekt blob stránky v účtu služby Premium Storage a pro objekt blob bloku v úložišti objektů blob nebo pro účet pro obecné účely v2. Úroveň objektu blob stránky Úrovně Premium určuje povolenou velikost, IOPS a šířku pásma objektu blob. Úroveň objektu blob bloku určuje Hot / Cool / Archive typ úložiště. Tato operace ne aktualizují 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 zkonstruovat následujícím způsobem. Doporučuje se protokol HTTPS. Nahraďte myaccount názvem vašeho účtu úložiště a myblob názvem objektu blob, pro který se má vrstva 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ůhledná hodnota, která v případě přítomnosti určuje snímek objektu blob, pro DateTime 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 z 12. 12. 2019 a novější. Parametr versionid je neprůhledná hodnota, která určuje verzi objektu blob, pro kterou DateTime se má nastavit úroveň.
timeout Nepovinný parametr. Parametr časového limitu je vyjádřen 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 pro objekt blob. Seznam povolených úrovní objektů blob stránky Premium najdete v tématu Vysoce výkonné Premium Storage a spravované disky pro virtuální počítače. Platné hodnoty pro úložiště objektů blob nebo účet pro obecné účely v2 jsou Hot / Cool / Archive . Podrobné informace o vrstvení na úrovni objektů blob účtu objektů blob úrovně Standard najdete v tématu Horká, studená a archivní úroveň úložiště.
x-ms-version Vyžaduje se pro všechny autorizované požadavky. Určuje verzi operace, která se má použít pro tento požadavek. Další informace najdete v tématu o verzích pro Azure Storage Services.
x-ms-client-request-id Nepovinný parametr. Poskytuje neprůhlednou hodnotu vygenerovanou klientem s limitem 1 kB znaků, který se zaznamená do analytických protokolů, když je 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 Informace o protokolování Storage Analytics a Protokolování Azure: Použití protokolů ke sledování Storage požadavků.
x-ms-rehydrate-priority Nepovinný parametr. Určuje prioritu, se kterou se má archivovaný objekt blob dosažovat. Podporováno ve verzi 2019-02-02 a novější pro objekty blob bloku. Platné hodnoty jsou High / Standard . Prioritu lze u objektu blob nastavit pouze jednou pro verze starší než 12. 6. 2020. Tato hlavička bude u následných požadavků ignorována. Výchozí nastavení priority je Standard .

Počínaje verzí 2020-06-12 je možné prioritu dosárání aktualizovat po nastavení. Nastavení priority se může změnit z na voláním set blob tier s touto hlavičkou nastavenou na a na stejnou Standard High hodnotu jako High x-ms-access-tier předtím. Nastavení priority nelze snížit z High na Standard .

Tato operace také podporuje použití podmíněných hlaviček k vrstvování 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 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í. 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:

Nastavte na horkou úroveň. Nastavte na studenou úroveň. Nastavte na archivní úroveň.
Objekt blob v horké úrovni 200 200 200
Objekt blob ve studené úrovni 200 200 200
Objekt blob v archivní úrovni 202 202 200
Objekt blob v archivní úrovni, dosádání na horkou úroveň 202 409 409
Objekt blob v archivní úrovni, dosázení do studené úrovně 409 202 409

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

Hlavičky odpovědi

Odpověď pro tuto operaci zahrnuje následující hlavičky. Odpověď může obsahovat také další standardní hlavičky PROTOKOLU 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ý se provedl, a dá se použít k řešení potíží s žádostí. Další informace najdete v tématu řešení potíží s operacemi rozhraní API.
x-ms-version Určuje verzi Blob service, která se používá ke spuštění žádosti. Tato hlavička se vrátí pro požadavky vytvořené proti 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 tohoto záhlaví je rovna hodnotě x-ms-client-request-id záhlaví, pokud se nachází v požadavku a hodnota je nejvýše 1024 viditelných znaků ASCII. Pokud x-ms-client-request-id Hlavička v požadavku není, tato hlavička nebude v odpovědi přítomna.

Autorizace

Tuto operaci může volat jenom 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 na účtu BLOB Storage nebo účtu pro obecné účely v2 mají následující omezení:

  • Úroveň nastavení snímku je povolená od verze REST 2019-12-12.
  • Snímky navrstvené do archivu nelze znovu dehydratované zpět do snímku. tj. snímek se nedá vrátit na horkou nebo studenou úroveň. Jenom způsob, jak načíst data z archivovaného snímku nebo verze, je zkopírovat ho do nového objektu BLOB.
  • Pokud je tato verze kořenovým objektem blob, pak je možné ho znovu vypravit na horkou nebo studenou.
  • Snímky nebo verze v archivovaném stavu se nemůžou zvýšit na kořen.
  • Pokud je povolená Správa verzí, odstranění kořenového objektu BLOB v případě nedokončené přípravy bude mít za následek zrušení deaktivace a verze bude v archivovaném stavu.
  • Pokud je objekt BLOB přepsaný v okamžiku, kdy se stav čeká na vyřízení a softdeleted, bude výsledkem zrušení dehydratovaného a verze nebo snímek softdeleted bude v archivovaném stavu.

Seznam podporovaných vrstev není omezen verzí požadavku a nové úrovně mohou být v budoucnu přidány.

Poznámka

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

Viz také

Autorizovat požadavky na Azure Storage
Stavové a chybové kódy
Kódy chyb služby BLOB Service
Nastavení časových limitů pro operace služby BLOB Service