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 premium storage a v objektu blob bloku v účtu blob nebo účtu pro obecné účely v2. Úroveň objektu blob stránky úrovně Premium (P4/P6/P10/P15/P20/P30/P40/P50/P60) určuje povolenou velikost, IOPS a šířku pásma objektu blob. Úroveň objektu blob bloku určuje typ úložiště Hot/Cool/Cold/Archive. Tato operace neaktualizuje značku ETag objektu blob.

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

Prosba

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

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

Parametry identifikátoru URI

Pro identifikátor URI požadavku můžete zadat následující další parametry:

Parametr	Popis
snapshot	Volitelný. Parametr snapshot je neprůhlená 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 verzi 2019-12-12 a novější. Parametr versionid je neprůhlenou DateTime hodnotou, která při přítomnosti určuje verzi objektu blob, na které se má nastavit úroveň.
timeout	Volitelný. 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

Povinná a volitelná hlavička požadavku jsou popsána v následující tabulce:

Hlavička požadavku	Popis
Authorization	Požadovaný. Určuje schéma autorizace, název účtu úložiště a podpis. Další informace najdete v tématu Autorizace požadavků na službu Azure Storage.
Date nebo x-ms-date	Požadovaný. Určuje standard UTC (Coordinated Universal Time) pro požadavek. Další informace najdete v tématu Autorizace požadavků na službu Azure Storage.
x-ms-access-tier	Požadovaný. Urč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é služby 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 platné hodnoty Hot, Cool, Colda Archive. Poznámka: úroveňCold se podporuje pro verzi 2021–12.02 a novější. Podrobné informace o vrstvení na úrovni 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í služby Azure Storage.
x-ms-client-request-id	Volitelný. Poskytuje hodnotu vygenerovanou klientem s neprůhlenou hodnotou s limitem znaků 1 kB, který se zaznamenává 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ýzy úložiště.
x-ms-rehydrate-priority	Volitelný. Určuje prioritu, se kterou se má dosadit 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 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í aktualizovat po nastavení. Nastavení priority je možné změnit z Standard na High zavoláním Nastavit vrstvy objektů blob s touto hlavičkou nastavenou na High a nastavením x-ms-access-tier na stejnou hodnotu jako dříve nastavená. 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í.

V případě účtů premium storage vrátí operace objektu blob stránky stavový kód 200 (OK).

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

Úroveň	Nastavit na horkou úroveň	Nastavit na studenou úroveň	Nastavení na studenou úroveň	Nastavit na archivní úroveň
Objekt blob v horké vrstvě	200	200	200	200
Objekt blob ve studené úrovni	200	200	200	200
Objekt blob v 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 úroveň	409	202	409	409
Objekt blob v archivní úrovni, dosazování na studenou	409	409	202	409

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

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	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á byla použita 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	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ě hlavičky x-ms-client-request-id, pokud se nachází v požadavku a hodnota neobsahuje více než 1 024 viditelných znaků ASCII. Pokud v požadavku není hlavička x-ms-client-request-id, nezobrazí se v odpovědi.

Oprávnění

Autorizace se vyžaduje při volání jakékoli operace přístupu k datům ve službě Azure Storage. Operaci Set Blob Tier můžete autorizovat, 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 vynikající zabezpečení a snadné použití v porovnání s autorizací sdíleného klíče.

Microsoft Entra ID (doporučeno)

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

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

Dovolení

Níže je uvedena akce RBAC potřebná pro uživatele, skupinu, spravovanou identitu nebo instanční objekt Microsoftu pro volání operace Set Blob Tier a nejméně privilegované předdefinované role Azure RBAC, která zahrnuje tuto akci:

• akce Azure RBAC:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
• předdefinovaná role s nejnižšími oprávněními: přispěvatel datPřispěvatel dat objektů blob služby Storage

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.

sdílených přístupových podpisů (SAS)

Sdílený přístupový podpis (SAS) poskytuje zabezpečený delegovaný přístup k prostředkům v účtu úložiště. Pomocí sdíleného přístupového podpisu máte podrobnou kontrolu nad tím, jak může klient přistupovat k datům. Můžete určit, k jakému prostředku má klient přístup, jaká oprávnění k těmto prostředkům má a jak dlouho je SAS platný.

Operace podporuje tři typy sdílených přístupových podpisů: SAS delegování uživatele, sas službya SAS účtu .

Osvědčeným postupem zabezpečení doporučujeme místo klíče účtu úložiště používat přihlašovací údaje Microsoft Entra, což může být snadněji ohroženo. Pokud návrh vaší aplikace vyžaduje sdílené přístupové podpisy, použijte přihlašovací údaje Microsoft Entra k vytvoření SAS delegování uživatele, pokud je to možné.

Pokud je pro účet úložiště zakázaný přístup ke sdílenému klíči, token SAS služby nebo token SAS účtu nebudou u požadavku na službu Blob Storage povoleny. Další informace najdete v tématu Vysvětlení toho, jak zákaz sdíleného klíče ovlivňuje tokeny SAS.

SAS delegování uživatele

SAS delegování uživatele je zabezpečen pomocí přihlašovacích údajů Microsoft Entra a také oprávněními zadanými pro SAS.

Volání operace Set Blob Tier pomocí tokenu SAS delegovaného do kontejneru nebo prostředku objektu blob vyžaduje oprávnění k zápisu (w) v rámci tokenu SAS delegování uživatele.

Další informace o SAS delegování uživatele najdete v tématu Vytvoření SAS delegování uživatele.

SAS služby

Sas služby je zabezpečený pomocí klíče účtu úložiště. SAS služby deleguje přístup k prostředku v jedné službě Azure Storage, například k úložišti objektů blob.

Volání operace pomocí tokenu SAS delegovaného do kontejneru nebo prostředku objektu blob vyžaduje oprávnění k zápisu (w) jako součást tokenu SAS služby.

Další informace o SAS služby najdete v tématu Vytvoření SAS služby.

SAS účtu

Sdílený přístupový podpis účtu je zabezpečený pomocí klíče účtu úložiště. SAS účtu deleguje přístup k prostředkům v jedné nebo více službách úložiště. Všechny operace dostupné prostřednictvím SAS delegování služby nebo uživatele jsou dostupné také prostřednictvím sdíleného přístupového podpisu účtu.

Následující tabulka označuje podepsaný typ prostředku a podepsaná oprávnění k určení při delegování přístupu:

Operace	Podepsaná služba	Podepsaný typ prostředku	Podepsané oprávnění
Nastavení úrovně objektu blob	Objekt blob (b)	Objekt (o)	Zápis (w)

Další informace o SAS účtu najdete v tématu Vytvoření SAS účtu.

Operace podporujeautorizace sdíleného klíče . Pro většinu scénářů se nedoporučuje autorizace pomocí klíčů účtu, protože je méně zabezpečená.

Microsoft doporučuje zakázat autorizaci sdíleného klíče pro účet úložiště, pokud je to možné. Další informace naleznete v tématu Zabránit autorizaci se sdíleným klíčem.

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ž existují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 v účtu Blob Storage nebo pro obecné účely v2 má následující omezení:

• Nastavení vrstvy snímku je povoleno od verze REST 2019-12-12.
• Snímky, které jsou vrstvené na archive se nedají dosadovat zpět do snímku. To znamená, že snímek nejde přenést zpět na úroveň hot ani cool. Jediným způsobem, jak načíst data ze snímku nebo verze archive, je zkopírovat je do nového objektu blob.
• Pokud je verze kořenovým objektem blob, může být rehydrována zpět do hot nebo cool.
• Snímky nebo verze ve stavu archive nesmí být povýšeny na root.
• Pokud je povolená správa verzí, odstranění kořenového objektu blob, když je ve stavu čekajícího na dosazování, způsobí zrušení dosazování a verze bude v archive stavu.
• Pokud se objekt blob přepíše, když je ve stavu čekajícího na dosazování a obnovitelném odstranění, způsobí zrušení dosazování a verze obnovitelného odstraněného snímku bude ve stavu archive.

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

Pro objekty blob, které používají šifrování poskytované zákazníkem, se Set Blob Tier podporuje pro verzi 2023-08-03 a novější. Pro verze starší než 2023-08-03 Set Blob Tier vrátí stavový kód 409 pro objekty blob, které používají šifrování poskytnuté zákazníkem.

Poznámka

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

Fakturování

Žádosti o ceny můžou pocházet z 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 žádosti nabíhají poplatky za transakci. Typ transakce ovlivňuje způsob účtování účtu. Například transakce čtení nabíhají do jiné fakturační kategorie než transakce zápisu. Následující tabulka uvádí kategorii fakturace pro požadavky Set Blob Tier na základě typu účtu úložiště:

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

Další informace o cenách pro zadanou fakturační kategorii najdete v tématu ceny služby Azure Blob Storage.

Viz také

autorizace požadavků na službu Azure Storage
Stav a kódy chyb
kódy chyb Blob Storage
Nastavit časové limity pro operace služby Blob Storage