Nastavení vypršení platnosti objektu blob
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žít 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 jako 127.0.0.1:10000
a pak 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 místní vývoj služby 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 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 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 |
Povinné pro všechny ověřené požadavky. 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-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í pro tuto hlavičku. |
x-ms-expiry-option |
Povinná hodnota. Pokud chcete zadat možnost data vypršení platnosti žádosti, přečtěte si téma Vypršení platnostiOption. |
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 x-ms-expiry-option
záhlaví. 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 současného času. |
Absolute |
x-ms-expiry-time musí být zadán jako absolutní čas ve formátu RFC 1123. |
NeverExpire |
Nastaví soubor na nikdy nevyprší platnost nebo odebere aktuální datum vypršení platnosti. x-ms-expiry-time nesmí být zadán. |
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 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 |
---|---|
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 se řídí dokumentem RFC 1123. Další informace najdete v tématu Reprezentace hodnot data a času v záhlavích. Každá operace, která upraví adresář nebo jeho vlastnosti, aktualizuje čas poslední změny. Operace se soubory nemají vliv na čas poslední změny adresáře. |
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 |
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
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 Expiry
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í 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 Expiry
operace Microsoft Entra uživatele, skupiny nebo instančního objektu a předdefinované role Azure RBAC s nejnižšími oprávněními, která tuto akci zahrnuje:
- Akce Azure RBAC:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
- Předdefinovaná role s nejnižšími oprávněními: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.
Poznámky
Sémantika pro nastavení data vypršení platnosti objektu blob je následující:
Set Expiry
lze nastavit pouze pro soubor, a ne pro adresář.Set Expiry
s objektemexpiryTime
v minulosti není povolená.ExpiryTime
nelze zadat sexpiryOption
hodnotouNever
.
Poznámka
Soubor, jehož platnost vypršela, nejde obnovit pomocí funkce obnovitelného odstranění objektů blob. I když jste pro účet povolili obnovitelné odstranění, soubor s vypršenou platností se po vypršení jeho platnosti nestane obnovitelně odstraněným objektem blob. Obnovitelně odstraněné soubory se můžou stát jenom soubory, které jsou odstraněné.
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. Za tyto žádosti se účtují poplatky za každou transakci. Typ transakce ovlivňuje způsob účtování za účet. Například transakce čtení se načítají do jiné kategorie fakturace než transakce zápisu. Následující tabulka uvádí kategorii fakturace pro Set Blob Expiry
žádosti založené na typu účtu úložiště:
Operace | Typ účtu úložiště | Kategorie fakturace |
---|---|---|
Nastavit vypršení platnosti objektu blob | Objekt blob bloku úrovně Premium Standard pro obecné účely v2 |
Další operace |
Nastavit 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.