Sdílet prostřednictvím

Nastavení úrovně objektu blob

  • Článek

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ň premium objektu blob stránky (P4/P15//P30P40/P50///P60P6P10/P20) určuje povolenou velikost, IOPS a šířku pásma objektu blob. Úroveň objektu blob bloku určuje HotColdArchive/Cool//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í 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 Create 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 se timeout 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é Premium Storage a spravované disky pro virtuální počítače. Pro úložiště objektů blob nebo účet pro obecné účely verze 2 jsou Hotplatné hodnoty , Cool, Colda Archive. Poznámka:Cold úroveň se podporuje pro 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ůsložnou hodnotu s limitem 1 kB znaků, která se zaznamenává v protokolech analýzy, 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, 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/Standard. Pro verze před 12. 6. 2020 je možné nastavit prioritu objektu blob pouze jednou. tato hlavička bude při dalších požadavcích ignorována. Výchozí nastavení priority je Standard.

Od verze 2020-06-12 je možné prioritu dosazování po předchozím nastavení aktualizovat. 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 nastavíte 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á ú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 Description
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

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

Důležité

Microsoft doporučuje používat Microsoft Entra ID se spravovanými identitami k autorizaci požadavků do služby Azure Storage. Microsoft Entra ID poskytuje v porovnání s autorizací pomocí sdíleného klíče vynikající zabezpečení a snadné použití.

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í ověří 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 nezbytné k volání Set Blob Tier operace Microsoft Entra uživatelem, skupinou, spravovanou identitou nebo instančním objektem a předdefinovanou rolí 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í úrovně pro snímek je povolené od rest verze 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 v budoucnu mohou být přidány 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

Požadavky na ceny můžou pocházet od klientů, kteří používají rozhraní API služby Blob Storage, 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