Nastavit vypršení platnosti objektu blob

Článek
05/15/2024

Operace Set Blob Expiry nastaví datum vypršení platnosti existujícího objektu blob. Tato operace je povolena pouze u účtů s povoleným hierarchickým oborem názvů. Platí pro službu verze 2020-02-10 a novější.

Žádost

Požadavek Set Blob Expiry může být vytvořen následujícím způsobem. Doporučujeme používat protokol HTTPS. Nahraďte myaccount názvem vašeho účtu úložiště:

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

Identifikátor URI služby emulovaného úložiště

Když vytváříte požadavek na službu emulovaného úložiště, zadejte název hostitele emulátoru a port služby Blob Storage a 127.0.0.1:10000pak název emulovaného účtu úložiště:

Identifikátor URI požadavku metody PUT	Verze PROTOKOLU HTTP
`http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=expiry`	HTTP/1.1

Další informace najdete v tématu Použití emulátoru Azurite pro vývoj v místním úložišti Azure Storage.

Parametry identifikátoru URI

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

Parametr	Popis
`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 ověřování, název účtu a podpis. Další informace najdete v tématu Ověřování služeb Azure Storage .
`Date` nebo `x-ms-date`	Povinná hodnota. Určuje formát UTC (Coordinated Universal Time). Další informace najdete v tématu Ověřování pro služby Azure Storage.
`x-ms-version`	Vyžaduje se pro všechny ověřené požadavky. 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-lease-id:<ID>`	Vyžaduje se, pokud má objekt blob aktivní zapůjčení. Pokud chcete tuto operaci provést s objektem blob s aktivním zapůjčením, zadejte platné ID zapůjčení této hlavičky.
`x-ms-expiry-option`	Povinná hodnota. Pokud chcete zadat datum vypršení platnosti žádosti, projděte si téma ExpiryOption.
`x-ms-expiry-time`	Nepovinný parametr. Čas, kdy je nastavena platnost souboru. Formát data vypršení platnosti se liší podle `x-ms-expiry-option`. Další informace najdete v tématu ExpiryOption.
`x-ms-client-request-id`	Nepovinný parametr. Poskytuje klientem vygenerovanou neprůselnou hodnotu s limitem počtu znaků 1 kibibajt (KiB), který je zaznamenán v protokolech při konfiguraci protokolování. 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 Monitorování Azure Blob Storage.

ExpiryOption

Následující hodnoty můžete odeslat jako hlavičku x-ms-expiry-option . V této hlavičce se nerozlišuje velká a malá písmena.

Možnost vypršení platnosti	Description
`RelativeToCreation`	Nastaví datum vypršení platnosti vzhledem k času vytvoření souboru. `x-ms-expiry-time` musí být zadán jako počet milisekund, který má uplynout od okamžiku vytvoření.
`RelativeToNow`	Nastaví datum vypršení platnosti vzhledem k aktuálnímu času. `x-ms-expiry-time` musí být zadán jako počet milisekund, který má uplynout od aktuálního času.
`Absolute`	`x-ms-expiry-time` musí být zadán jako absolutní čas ve formátu RFC 1123.
`NeverExpire`	Nastaví soubor tak, aby nikdy nevyprší platnost, nebo odebere aktuální datum vypršení platnosti. `x-ms-expiry-time` nesmí být zadány.

Text požadavku

Text požadavku pro tuto žádost je prázdný.

Ukázkový požadavek

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=expiry HTTP/1.1  
  
Request Headers:  
x-ms-version: 2020-02-10  
x-ms-date: Sun, 25 Sep 2020 14:37:35 GMT
x-ms-expiry-option: RelativeTonow
x-ms-expiry-time: 30000  
Authorization: SharedKey myaccount:J4ma1VuFnlJ7yfk/Gu1GxzbfdJloYmBPWlfhZ/xn7GI=

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

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
`ETag`	Obsahuje hodnotu, která představuje verzi souboru. Hodnota je uzavřena v uvozovkách.
`Last-Modified`	Vrátí datum a čas poslední změny adresáře. Formát data odpovídá dokumentu RFC 1123. Další informace najdete v tématu Reprezentace hodnot data a času v záhlavích. Všechny operace, které změní adresář nebo jeho vlastnosti, aktualizují čas poslední změny. Operace se soubory nemají vliv na čas poslední změny adresáře.
`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`	Označuje verzi služby Blob Storage, která se použila ke spuštění požadavku.
`Date`	Hodnota data a času UTC vygenerovaná službou, která označuje čas, kdy byla odpověď inicializována.

Ukázková odpověď

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
Date: Sun, 25 Sep 2011 23:47:09 GMT  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

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 Expiry , 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í 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, spravované identity nebo instančního objektu Set Blob Expiry a nejméně privilegované integrované role Azure RBAC, která zahrnuje tuto akci:

Akce Azure RBAC:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
Nejméně privilegovaná předdefinovaná role:Přispěvatel dat v objektech 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ý přístupový podpis (SAS) poskytuje zabezpečený delegovaný přístup k prostředkům v účtu úložiště. V případě SAS 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ůže klient přistupovat, jaká oprávnění k těmto prostředkům má a jak dlouho je sas platný.

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

Jako osvědčený postup zabezpečení doporučujeme používat přihlašovací údaje Microsoft Entra místo klíče účtu úložiště, který může být snadněji ohrožen. Pokud návrh 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 přístup ke sdílenému klíči pro účet úložiště zakázaný, token SAS služby nebo token SAS účtu nebude na žádost do služby Blob Storage povolený. Další informace najdete v tématu Vysvětlení, jak zakázání sdíleného klíče ovlivňuje tokeny SAS.

SAS delegování uživatele

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

Set Blob Expiry Volání operace pomocí tokenu SAS delegovaného na prostředek kontejneru nebo 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 Create 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, jako je úložiště objektů blob.

Set Blob Expiry Volání operace pomocí tokenu SAS delegovaného na prostředek kontejneru nebo 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 Create SAS služby.

Sas účtu

SAS úč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 pro službu nebo delegování uživatele jsou dostupné také prostřednictvím SAS účtu.

Následující tabulka uvádí typ podepsaného prostředku a podepsaná oprávnění, která se mají zadat při delegování přístupu:

Operace	Podepsaná služba	Typ podepsaného prostředku	Podepsané oprávnění
Nastavení vypršení platnosti objektu blob	Objekt blob (b)	Objekt (o)	Zápis (w)

Další informace o SAS účtu najdete v tématu Create SAS účtu.

Poznámky

Sémantika pro nastavení data vypršení platnosti objektu blob je následující:

Set Expiry lze nastavit pouze v souboru, nikoli v adresáři.
Set Expiry s objektem expiryTime v minulosti není povoleno.
ExpiryTime nelze zadat s expiryOption hodnotou Never.

Poznámka

Soubor s vypršenou platností nejde obnovit pomocí funkce obnovitelného odstranění objektů blob. I když jste pro účet povolili obnovitelné odstranění, po vypršení jeho platnosti se soubor s vypršenou platností nestane obnovitelně odstraněným objektem blob. Obnovitelně odstraněné soubory se můžou stát jenom soubory, které jsou odstraněny.

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 Expiry žádosti založené na typu účtu úložiště:

Operace	Typ účtu úložiště	Kategorie fakturace
Nastavení vypršení platnosti objektu blob	Objekt blob bloku úrovně Premium Standard pro obecné účely v2	Další operace
Nastavení vypršení platnosti objektu blob	Standard pro obecné účely v1	Operace zápisu

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

Sdílet prostřednictvím