Blob lejáratának beállítása
A Set Blob Expiry
művelet egy meglévő blob lejárati dátumát állítja be. Ez a művelet csak hierarchikus névtér-kompatibilis fiókokon engedélyezett. A szolgáltatás 2020-02-10-es és újabb verzióira vonatkozik.
Kérés
A Set Blob Expiry
kérelem az alábbiak szerint hozható létre. Javasoljuk, hogy HTTPS-t használjon. Cserélje le a myaccount kifejezést a tárfiók nevére:
PUT metóduskérés URI-ja | HTTP-verzió |
---|---|
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=expiry |
HTTP/1.1 |
Emulált tárolási szolgáltatás URI-ja
Amikor kérést küld az emulált tárolási szolgáltatásra, adja meg az emulátor gazdanevét és a Blob Storage-portot , 127.0.0.1:10000
majd az emulált tárfiók nevét:
PUT metóduskérés URI-ja | HTTP-verzió |
---|---|
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=expiry |
HTTP/1.1 |
További információ: Az Azurite emulátor használata helyi Azure Storage-fejlesztéshez.
URI-paraméterek
A kérelem URI-ján a következő további paramétereket adhatja meg:
Paraméter | Leírás |
---|---|
timeout |
Választható. A timeout paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása Blob Storage-műveletekhez. |
Kérésfejlécek
A szükséges és nem kötelező kérésfejléceket az alábbi táblázat ismerteti:
Kérelem fejléce | Leírás |
---|---|
Authorization |
Kötelező. Megadja a hitelesítési sémát, a fióknevet és az aláírást. További információ : Hitelesítés az Azure Storage-szolgáltatásokhoz . |
Date vagy x-ms-date |
Kötelező. Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját. További információ: Hitelesítés az Azure Storage-szolgáltatásokhoz. |
x-ms-version |
Minden hitelesített kéréshez szükséges. A kérelemhez használandó művelet verzióját adja meg. További információ: Az Azure Storage-szolgáltatások verziószámozása. |
x-ms-lease-id:<ID> |
Akkor szükséges, ha a blob rendelkezik aktív bérlettal. Ha ezt a műveletet aktív bérlettel rendelkező blobon szeretné végrehajtani, adja meg a fejléc érvényes bérletazonosítóját. |
x-ms-expiry-option |
Kötelező. A kérelem lejárati dátumbeállításának megadásához lásd: ExpiryOption. |
x-ms-expiry-time |
Választható. Az az idő, amikor a fájl lejár. A lejárati dátum formátuma a következő szerint változik: x-ms-expiry-option . További információ: ExpiryOption. |
x-ms-client-request-id |
Választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kibibyte (KiB) karakterkorláttal, amelyet a naplózás konfigurálásakor rögzít a naplókban. Javasoljuk, hogy ezt a fejlécet használva korrelálja az ügyféloldali tevékenységeket a kiszolgáló által kapott kérésekkel. További információ: Azure Blob Storage figyelése. |
ExpiryOption
Az alábbi értékeket elküldheti fejlécként x-ms-expiry-option
. Ez a fejléc nem különbözteti meg a kis- és nagybetűt.
Lejárati beállítás | Description |
---|---|
RelativeToCreation |
Beállítja a lejárati dátumot a fájllétrehozás időpontjához viszonyítva. x-ms-expiry-time meg kell adni a létrehozás időpontjától eltelt ezredmásodpercek számát. |
RelativeToNow |
Beállítja a lejárati dátumot az aktuális időponthoz viszonyítva. x-ms-expiry-time A jelenlegi időponttól eltelt ezredmásodpercek számaként kell megadni. |
Absolute |
x-ms-expiry-time abszolút időként kell megadni, RFC 1123 formátumban. |
NeverExpire |
Beállítja, hogy a fájl soha ne járjon le, vagy eltávolítja az aktuális lejárati dátumot. x-ms-expiry-time nem szabad megadni. |
A kérés törzse
A kérelem törzse üres.
Mintakérés
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=
Reagálás
A válasz egy HTTP-állapotkódot és válaszfejléceket tartalmaz.
Állapotkód
A sikeres művelet a 200 -os állapotkódot adja vissza (OK).
További információ az állapotkódokról: Állapot- és hibakódok.
Válaszfejlécek
A műveletre adott válasz a következő fejléceket tartalmazza. A válasz további szabványos HTTP-fejléceket is tartalmazhat. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.
Válaszfejléc | Description |
---|---|
ETag |
A fájl verzióját képviselő értéket tartalmaz. Az érték idézőjelek közé van zárva. |
Last-Modified |
A könyvtár utolsó módosításának dátumát és időpontját adja vissza. A dátumformátum az RFC 1123-at követi. További információ: Dátum-/időértékek ábrázolása fejlécekben. Minden olyan művelet, amely módosítja a könyvtárat vagy annak tulajdonságait, frissíti az utolsó módosítás időpontját. A fájlokon végzett műveletek nincsenek hatással a könyvtár utolsó módosításának időpontjára. |
x-ms-request-id |
Egyedileg azonosítja a kérést, amely a kérés hibaelhárításához használható. További információ: API-műveletek hibaelhárítása. |
x-ms-version |
A kérés végrehajtásához használt Blob Storage-verziót jelzi. |
Date |
A szolgáltatás által létrehozott UTC dátum/idő érték, amely a válasz indításának időpontját jelzi. |
Mintaválasz
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
Engedélyezés
Az azure storage-beli adathozzáférési műveletek meghívásakor engedélyezés szükséges. A műveletet az Set Blob Expiry
alábbiak szerint engedélyezheti.
Az Azure Storage támogatja a Microsoft Entra ID használatát a blobadatokra irányuló kérések engedélyezéséhez. A Microsoft Entra ID azure-beli szerepköralapú hozzáférés-vezérléssel (Azure RBAC) adhat engedélyeket egy rendszerbiztonsági tagnak. A rendszerbiztonsági tag lehet felhasználó, csoport, alkalmazás-szolgáltatásnév vagy Azure-beli felügyelt identitás. A rendszerbiztonsági tagot a Microsoft Entra ID hitelesíti egy OAuth 2.0-jogkivonat visszaadásához. A jogkivonat ezután a Blob szolgáltatással szembeni kérések engedélyezésére használható.
További információ a Microsoft Entra ID használatával történő engedélyezésről: Blobok hozzáférésének engedélyezése Microsoft Entra ID használatával.
Engedélyek
Az alábbiakban azokat az RBAC-műveletet soroljuk fel, amelyek szükségesek ahhoz, hogy egy Microsoft Entra felhasználó, csoport vagy szolgáltatásnév meghívja a Set Blob Expiry
műveletet, valamint a legkevésbé kiemelt beépített Azure RBAC-szerepkört, amely tartalmazza ezt a műveletet:
- Azure RBAC-művelet:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
- Legkevésbé emelt szintű beépített szerepkör:Storage-blobadatok közreműködője
A szerepkörök Azure RBAC-vel való hozzárendeléséről további információt az Azure-szerepkör hozzárendelése a blobadatokhoz való hozzáféréshez című témakörben talál.
Megjegyzések
A lejárati dátum blobokra való beállításának szemantikája a következő:
Set Expiry
csak egy fájlon állítható be, könyvtárban nem.Set Expiry
expiryTime
a múltban nem engedélyezett.ExpiryTime
értéke nem adható megexpiryOption
Never
.
Megjegyzés
A lejárt fájlok nem állíthatók vissza a blob helyreállítható törlési funkciójával. Még ha engedélyezte is a fiók helyreállítható törlését, a lejárt fájlok nem lesznek helyreállíthatóan törölt blobok a lejáratukkor. Csak a törölt fájlok válhatnak helyreállíthatóan törölt fájlokká.
Számlázás
A díjszabási kérések a Blob Storage API-kat használó ügyfelektől, közvetlenül a Blob Storage REST API-ból vagy egy Azure Storage-ügyfélkódtárból származhatnak. Ezek a kérések tranzakciónkénti díjakat halmoznak fel. A tranzakció típusa befolyásolja a fiók terhelését. Az olvasási tranzakciók például más számlázási kategóriába tartoznak, mint az írási tranzakciók. Az alábbi táblázat a tárfiók típusa alapján a kérelmek számlázási kategóriáját Set Blob Expiry
mutatja be:
Művelet | Tárfiók típusa | Számlázási kategória |
---|---|---|
Blob lejáratának beállítása | Prémium szintű blokkblob Standard általános célú v2 |
Egyéb műveletek |
Blob lejáratának beállítása | Standard általános célú v1 | Írási műveletek |
A megadott számlázási kategória díjszabásával kapcsolatos további információkért lásd: Azure Blob Storage Díjszabás.