Nastavení úrovně objektu blob

  • Článek

Operace Set Blob Tier nastaví úroveň přístupu v objektu blob. Operace je povolená pro objekt blob stránky v účtu služby Premium Storage a v objektu blob bloku v účtu úložiště objektů blob nebo účtu pro obecné účely v2. Úroveň objektu blob stránky premium (P4/P15//P30P40/P50///P60P6P10/P20) určuje povolenou velikost, IOPS a šířku pásma objektu blob. Typ úložiště určuje HotColdArchive/Cool//úroveň objektu blob bloku. Tato operace neaktualizuje ETag objektu blob.

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 vytvořit Set Blob Tier následujícím způsobem. Doporučujeme použít 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ůselná 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ůselná DateTime hodnota, která při výskytu určuje verzi objektu blob, pro kterou se má nastavit úroveň.
timeout Nepovinný parametr. Parametr timeout je vyjádřen 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é Premium Storage a spravované disky pro virtuální počítače. Pro úložiště objektů blob nebo účet pro obecné účely v2 jsou Hotplatné hodnoty , ColdCool, a Archive. Poznámka:Cold úroveň se podporuje pro verzi 2021-12-02 a novější. Podrobné informace o standardním vrstvení úrovně objektů blob účtu objektu blob najdete v tématu Horká, studená a archivní úroveň úložiště.
x-ms-version Povinné pro všechny autorizované žádosti. Určuje verzi operace, která se má použít pro tento požadavek. 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 kB, který je zaznamenán v analytických protokolech, 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 o protokolování Analýza úložiště.
x-ms-rehydrate-priority Nepovinný parametr. Určuje prioritu, s jakou se má dosadí archivovaný objekt blob. Podporováno ve verzi 2019-02-02 a novější pro objekty blob bloku. Platné hodnoty jsou High/Standard. Prioritu je možné u objektu blob nastavit pouze jednou pro verze starší než 2020-06-12; tato hlavička bude při dalších požadavcích ignorována. Výchozí nastavení priority je Standard.

Počínaje verzí 2020-06-12 je možné po předchozím nastavení aktualizovat prioritu dosazování. Nastavení priority můžete změnit z Standard na High tak, že zavoláte Nastavit úroveň objektu blob s touto hlavičkou nastavenou na High a nastavením x-ms-access-tier na stejnou hodnotu, jakou jste nastavili dříve. Nastavení priority nelze snížit z High 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á vrstva projeví okamžitě, nebo stavový kód 202 (Přijato), pokud přechod na novou úroveň čeká na vyřízení.

U účtů 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é vrstvě 200 200 200 200
Objekt blob ve studené vrstvě 200 200 200 200
Objekt blob v studené vrstvě 200 200 200 200
Objekt blob v archivní vrstvě 202 202 202 200
Objekt blob v archivní úrovni, dosazování na horkou 202 409 409 409
Objekt blob v archivní vrstvě, dosazování na studenou 409 202 409 409
Objekt blob v archivní vrstvě, dosazování na studenou 409 409 202 409

Další informace o stavových kódech najdete v tématu Stavové kódy a kódy 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 Description
x-ms-request-id Jedineč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é ve 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 je v požadavku, a hodnota neobsahuje více než 1 024 viditelných znaků ASCII. Pokud hlavička x-ms-client-request-id v požadavku není, nebude v odpovědi.

Autorizace

Při volání jakékoli operace přístupu k datům ve službě Azure Storage se vyžaduje autorizace. Operaci můžete autorizovat, Set Blob Tier jak je popsáno níže.

Azure Storage podporuje autorizaci požadavků na data objektů blob pomocí Microsoft Entra ID. S Microsoft Entra ID můžete pomocí řízení přístupu na základě role v Azure (Azure RBAC) udělit oprávnění k objektu zabezpečení. Objektem zabezpečení může být uživatel, skupina, instanční objekt aplikace nebo spravovaná identita Azure. Objekt zabezpečení je ověřen Microsoft Entra ID, aby vrátil token OAuth 2.0. Token se pak dá použít k autorizaci požadavku na službu Blob Service.

Další informace o autorizaci pomocí Microsoft Entra ID najdete v tématu Autorizace přístupu k objektům blob pomocí Microsoft Entra ID.

Oprávnění

Níže jsou uvedené akce RBAC potřebné k volání operace Microsoft Entra uživatele, skupiny nebo instančního Set Blob Tier objektu a předdefinované role Azure RBAC s nejnižšími oprávněními, která zahrnuje tuto akci:

Další informace o přiřazování rolí pomocí Azure RBAC najdete v tématu Přiřazení role Azure pro přístup k datům objektů blob.

Poznámky

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

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

  • Nastavení vrstvy na snímku je povolené od rest verze 2019-12-12.2019.
  • Snímky, na které jsou vrstvené archive , se nedají dosadit 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 je verze kořenovým objektem blob, můžete ji znovu dosadit zpět na hot nebo cool.
  • Snímky nebo verze ve archive stavu nesmí být povýšené na root.
  • Pokud je povolená správa verzí, odstranění kořenového objektu blob, když je ve stavu čekání na rehydraci, způsobí zrušení rehydratace a verze bude ve archive stavu.
  • Pokud se objekt blob přepíše, když je ve stavu čekání na dosazování a obnovitelné odstranění, dojde ke zrušení dosazování a verze obnovitelného odstraněného snímku bude ve archive stavu.

Seznam podporovaných vrstev není verzí žádosti omezen 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í vrstva úložiště.

Fakturace

Žádosti o ceny můžou pocházet od klientů, kteří používají rozhraní BLOB Storage API, a to buď přímo prostřednictvím rozhraní REST API služby Blob Storage, nebo z klientské knihovny Služby Azure Storage. Tyto požadavky načítají poplatky za transakci. Typ transakce ovlivňuje způsob účtování poplatku za účet. Například transakce čtení se načítají do jiné kategorie fakturace než transakce zápisu. Následující tabulka ukazuje kategorii fakturace pro Set Blob Tier žádosti založené na typu účtu úložiště:

Operace Typ účtu úložiště Kategorie fakturace
Nastavení úrovně objektu blob (vrstvy dolů) Objekt blob bloku úrovně Premium
Standard pro obecné účely v2		 Operace zápisu
Nastavení úrovně objektu blob (vrstvy nahoru) Objekt blob bloku úrovně Premium
Standard pro obecné účely v2		 Operace čtení

Informace o cenách pro zadanou kategorii fakturace najdete v tématu Azure Blob Storage Ceny.

Viz také

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