Delete Blob

Cikk
07/10/2024

A Delete Blob művelet törli a megadott blobot vagy pillanatképet.

Vegye figyelembe, hogy egy blob törléséhez törölnie kell az összes pillanatképét. A művelettel Delete Blob egyidejűleg mindkettő törölhető.

Kérés

A kérést a Delete Blob következőképpen hozhatja létre. A HTTPS használata ajánlott. Cserélje le a myaccount nevet a tárfiók nevére.

DELETE metódus kérésének URI-ja	HTTP-verzió
`https://myaccount.blob.core.windows.net/mycontainer/myblob` `https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>` `https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>`	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 gazdagépnevét és Azure Blob Storage portot 127.0.0.1:10000, majd az emulált tárfiók nevét.

DELETE metódus kérésének URI-ja	HTTP-verzió
`http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob`	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
`snapshot`	Választható. A pillanatkép paraméter egy átlátszatlan `DateTime` érték, amely jelen esetben megadja a törölni kívánt blob-pillanatképet. A blob-pillanatképek használatával kapcsolatos további információkért lásd: Blob pillanatképének létrehozása.
`versionid`	Nem kötelező, 2019-12-12-es és újabb verzió. A `versionid` paraméter egy átlátszatlan `DateTime` érték, amely jelen esetben meghatározza a törölni kívánt blob verzióját.
`timeout`	Választható. A `timeout` paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása a Blob Storage-műveletekhez.
`deletetype`	Nem kötelező, 2020-02-10-es vagy újabb verzió. A értéke `deletetype` csak a lehet `permanent`.

Kérésfejlécek

Az alábbi táblázat a szükséges és nem kötelező kérelemfejléceket ismerteti.

Kérelem fejléce	Leírás
`Authorization`	Kötelező. Megadja az engedélyezési sémát, a fióknevet és az aláírást. További információ: Kérések engedélyezése az Azure Storage-ba.
`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ó: Kérések engedélyezése az Azure Storage-ba.
`x-ms-version`	Minden engedélyezett kéréshez szükséges. 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. Ha nincs megadva érvényes bérletazonosító a kérelemben, a művelet a 403-at (Tiltott) állapotkóddal meghiúsul.
`x-ms-delete-snapshots: {include, only}`	Akkor szükséges, ha a blobhoz társított pillanatképek tartoznak. Adja meg az alábbi lehetőségek egyikét: - `include`: Törölje az alapblobot és annak összes pillanatképét. - `only`: Csak a blob pillanatképeit törölje, magát a blobot nem. Csak az alap bloberőforrásra vonatkozó kéréshez adja meg ezt a fejlécet. Ha ez a fejléc egy egyedi pillanatkép törlésére irányuló kérelemben van megadva, a Blob Storage a 400-ás állapotkódot adja vissza (hibás kérés). Ha ez a fejléc nincs megadva a kérelemben, és a blobhoz társított pillanatképek tartoznak, a Blob Storage a 409- (Ütközés) állapotkódot adja vissza.
`x-ms-client-request-id`	Választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kib-os (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ó: Monitorozási Azure Blob Storage.

Ez a művelet feltételes fejlécek használatát is támogatja a blob törléséhez, ha egy adott feltétel teljesül. További információ: Feltételes fejlécek megadása Blob Storage-műveletekhez.

A kérés törzse

Nincsenek.

Reagálás

A válasz tartalmaz egy HTTP-állapotkódot és egy válaszfejléceket.

Állapotkód

A sikeres művelet a 202-s állapotkódot adja vissza (Elfogadva). Az állapotkódokkal kapcsolatos információkért lásd: Á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
`x-ms-request-id`	Ez a fejléc egyedileg azonosítja a végrehajtott kérést, és 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 Blob Storage kérés futtatásához használt verzióját jelzi. A rendszer ezt a fejlécet adja vissza a 2009-09-19-es és újabb verzióval kapcsolatos kérésekhez.
`x-ms-delete-type-permanent`	A 2017-07-29-es és újabb verziók esetében a Blob Storage visszaadja `true` , ha a blob véglegesen törölve lett, és `false` ha a blob helyreállíthatóan lett törölve.
`Date`	Utc dátum/idő érték, amely a válasz indításának időpontját jelzi. A szolgáltatás létrehozza ezt az értéket.
`x-ms-client-request-id`	Ezzel a fejlécmel elháríthatja a kéréseket és a megfelelő válaszokat. A fejléc értéke megegyezik a fejléc értékével `x-ms-client-request-id` , ha az szerepel a kérelemben. Az érték legfeljebb 1024 látható ASCII-karakter lehet. Ha a `x-ms-client-request-id` fejléc nem szerepel a kérelemben, akkor ez a fejléc nem jelenik meg a válaszban.

Engedélyezés

Az Azure Storage-ban bármilyen adathozzáférési művelet meghívásához engedélyezésre van szükség. A műveletet az Delete Blob alábbiak szerint engedélyezheti.

Fontos

A Microsoft azt javasolja, hogy Microsoft Entra ID felügyelt identitásokkal engedélyezze az Azure Storage-ra irányuló kéréseket. Microsoft Entra ID a megosztott kulcs engedélyezéséhez képest kiváló biztonságot és könnyű használatot biztosít.

Az Azure Storage támogatja az 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 biztonsági tagnak. A rendszerbiztonsági tag lehet felhasználó, csoport, alkalmazásszolgá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 felsoroljuk azt az RBAC-műveletet, amely a művelet meghívásához Delete Blob szükséges Microsoft Entra felhasználóhoz, csoporthoz, felügyelt identitáshoz vagy szolgáltatásnévhez, valamint a legkevésbé emelt szintű beépített Azure RBAC-szerepkörhöz, amely tartalmazza ezt a műveletet:

Azure RBAC-művelet:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/delete
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.

A közös hozzáférésű jogosultságkód (SAS) biztonságos delegált hozzáférést biztosít a tárfiók erőforrásaihoz. Sas esetén részletes vezérléssel rendelkezik arról, hogy az ügyfél hogyan férhet hozzá az adatokhoz. Megadhatja, hogy az ügyfél milyen erőforráshoz férhet hozzá, milyen engedélyekkel rendelkezik ezekhez az erőforrásokhoz, és hogy az SAS mennyi ideig érvényes.

A Delete Blob művelet háromféle közös hozzáférésű jogosultságkódot támogat: a felhasználói delegálási SAS-t, a szolgáltatás SAS-t és a fiók SAS-t.

Ajánlott biztonsági gyakorlatként azt javasoljuk, hogy a tárfiókkulcs helyett Microsoft Entra hitelesítő adatokat használjon, amelyek könnyebben sérülhetnek. Ha az alkalmazás kialakításához közös hozzáférésű jogosultságkódra van szükség, Microsoft Entra hitelesítő adatokkal hozzon létre egy felhasználói delegálási SAS-t, ha lehetséges.

Ha a megosztott kulcs hozzáférése nincs engedélyezve a tárfiókhoz, a Blob Storage-ra irányuló kérések esetén a szolgáltatás SAS-jogkivonata vagy a fiók SAS-jogkivonata nem lesz engedélyezve. További információ: A megosztott kulcs letiltása hogyan befolyásolja az SAS-jogkivonatokat.

Felhasználói delegálási SAS

A felhasználói delegálási SAS-t Microsoft Entra hitelesítő adatokkal és az SAS-hez megadott engedélyekkel védik.

A Delete Blob művelet tárolóba vagy bloberőforrásba delegált SAS-jogkivonat használatával történő meghívásához a Törlés (d) engedély szükséges a felhasználódelegálási SAS-jogkivonat részeként.

A felhasználói delegálási SAS-ről a felhasználói delegálási SAS Létrehozás című témakörben olvashat bővebben.

Szolgáltatás SAS

A szolgáltatás SAS-t a tárfiókkulcs védi. A szolgáltatás sasa egyetlen Azure Storage-szolgáltatásban, például a blobtárolóban delegálja a hozzáférést egy erőforráshoz.

A Delete Blob műveletet tárolóba vagy bloberőforrásba delegált SAS-jogkivonattal történő meghívásához a szolgáltatás SAS-jogkivonatának részeként a Törlés (d) engedély szükséges.

A szolgáltatás SAS-járól további információt a szolgáltatás SAS-Létrehozás című témakörben talál.

Fiók SAS-fiókja

A fiók SAS-jének biztonságát a tárfiókkulcs biztosítja. A fiókalapú SAS egy vagy több tárolószolgáltatás erőforrásaihoz nyújt hozzáférést. A szolgáltatáson vagy a felhasználói delegálási SAS-en keresztül elérhető összes művelet fiók SAS-en keresztül is elérhető.

Az alábbi táblázat az aláírt erőforrástípust és az aláírt engedélyeket jelzi, amelyet a hozzáférés delegálásakor meg kell adni:

Művelet	Aláírt szolgáltatás	Aláírt erőforrástípus	Aláírt engedély
Delete Blob	Blob (b)	Objektum (o)	Törlés (d)

A fiók SAS-járól további információt a fiók SAS-Létrehozás című témakörben talál.

Megjegyzések

Ha a blob rendelkezik aktív bérletmel, az ügyfélnek érvényes bérletazonosítót kell megadnia a kérelemben a törléshez.

Ha egy blobban nagy számú pillanatkép található, előfordulhat, hogy a Delete Blob művelet időtúllépést jelez. Ha ez történik, az ügyfélnek újra meg kell próbálkoznia a kéréssel.

A 2013-08-15-ös és újabb verziók esetében az ügyfél meghívhatja Delete Blob a nem véglegesített blobok törlését. A nem véglegesített blobok olyan blobok , amelyek a Put Block művelet hívásaival lettek létrehozva, de soha nem véglegesítve a Tiltólista elhelyezése művelettel. A korábbi verziók esetében az ügyfélnek előbb véglegesítenie kell a blobot, mielőtt törli.

A helyreállítható törlés funkció le van tiltva

Ha egy blob törlése sikeresen megtörtént, a rendszer azonnal eltávolítja azt a tárfiók indexéből, és az ügyfelek számára már nem érhető el.

Helyreállítható törlés funkció engedélyezve

Ha egy blob sikeresen törölve van, az helyreállíthatóan törlődik, és az ügyfelek számára már nem érhető el. A Blob Storage megőrzi a blobot vagy a pillanatképet a Blob Storage tulajdonságához DeleteRetentionPolicy megadott napok számához. A Blob Storage tulajdonságainak olvasásáról további információt a Blob Storage tulajdonságainak beállítása című témakörben talál.

A megadott számú nap elteltével a blob adatai el lesznek távolítva a szolgáltatásból. A helyreállíthatóan törölt blobokat vagy pillanatképeket a Listablobok művelet meghívásával és a include=deleted beállítás megadásával érheti el.

Helyreállíthatóan törölt blobokat vagy pillanatképeket az Undelete Blob használatával állíthat vissza. A helyreállíthatóan törölt blobokon vagy pillanatképeken végzett bármely más művelet esetén a Blob Storage a 404-s hibát adja vissza (az erőforrás nem található).

Végleges törlés

A 2020-02-10-es és újabb verzióval véglegesen törölheti a helyreállíthatóan törölt pillanatképeket vagy verziót. Ehhez engedélyeznie kell a funkciót. További információ: Blob Storage-tulajdonságok beállítása.

Megjegyzés

A tárfióknak engedélyeznie kell a verziószámozást vagy a pillanatképeket. A helyreállítható törlést a tárfiókon is engedélyezni kell a blobok verzióinak vagy pillanatképeinek helyreállítható törléséhez a fiókban. A végleges törlés csak a helyreállíthatóan törölt pillanatképeket vagy verziókat törli.

Az állandó törlést engedélyező tárfiókok a deletetype=permanent lekérdezési paraméterrel véglegesen törölhetik a helyreállíthatóan törölt pillanatképeket vagy a törölt blobverziókat.

Ha a lekérdezési paraméter az alábbiak bármelyikét mutatja be, a Blob Storage 409-os hibát ad vissza (ütközés):

Az állandó törlési funkció nincs engedélyezve a tárfiókhoz.
Sem a megadott, sem versionidsnapshot a nem biztosított.
A megadott pillanatkép vagy verzió nem törölhető helyreállíthatóan.

Az állandó törlés egy közös hozzáférésű jogosultságkód-engedélyt is tartalmaz a blob pillanatképének vagy blobverzióinak végleges törléséhez. További információ: Létrehozás a szolgáltatás SAS-jának.