Megosztás törlése
A Delete Share művelet törli a megadott megosztási vagy megosztási pillanatképet. Ez az API teljes mértékben támogatott, de vegye figyelembe, hogy ez egy örökölt felügyeleti API.
Érdemes inkább a Fájlmegosztások – Törlés parancsot használni. Ezt a tárerőforrás-szolgáltató (Microsoft.Storage) biztosítja. Ha többet szeretne megtudni arról, hogyan használhatja FileShare programozott módon az erőforrásokat a tárerőforrás-szolgáltató használatával, tekintse meg a FileShares-műveletek című témakört.
Protokoll rendelkezésre állása
| Engedélyezett fájlmegosztási protokoll | Elérhető |
|---|---|
| SMB |
|
| NFS |
|
Kérés
A kérést a Delete Share következőképpen hozhatja létre. A HTTPS használata ajánlott.
| Metódus | Kérés URI-ja | HTTP-verzió |
|---|---|---|
DELETE |
https://myaccount.file.core.windows.net/myshare?restype=share |
HTTP/1.1 |
DELETE |
https://myaccount.file.core.windows.net/myshare?sharesnapshot=<DateTime>&restype=share |
HTTP/1.1 |
Cserélje le a kérelem URI-jában látható elérésiút-összetevőket a sajátjára az alábbiak szerint:
| Elérésiút-összetevő | Description |
|---|---|
myaccount |
A tárfiók neve. |
myshare |
A fájlmegosztás neve. |
Az elérésiút-elnevezési korlátozások részleteiért lásd: Megosztások, könyvtárak, fájlok és metaadatok elnevezése és hivatkozása.
URI-paraméterek
A következő további paramétereket a kérelem URI-jában adhatja meg.
| Paraméter | Leírás |
|---|---|
sharesnapshot |
Választható. 2017-04-17-es és újabb verzió. A sharesnapshot paraméter egy átlátszatlan DateTime érték, amely jelen esetben megadja a törölni kívánt megosztási pillanatképet. |
timeout |
Választható. A timeout paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása Azure Files műveletekhez. |
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. A kérelemhez használni kívánt művelet verzióját adja meg. További információ: Az Azure Storage-szolgáltatások verziószámozása. |
x-ms-delete-snapshots: { include, include-leased } |
Nem kötelező, ha a megosztáshoz társított pillanatképek tartoznak. Adja meg az alábbi lehetőségek egyikét:
|
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 Files. |
x-ms-lease-id: <ID> |
Kötelező, ha a célfájlmegosztás aktív bérletet kapott. A 2020-02-10-es és újabb verziókhoz érhető el. Ha a kérelem nem tartalmazza a bérletazonosítót, vagy nem érvényes, a művelet a 412-s állapotkóddal meghiúsul (az előfeltétel sikertelen). Ha ez a fejléc meg van adva, és a célfájlmegosztás jelenleg nem rendelkezik aktív bérlettel, a művelet a 412-s állapotkóddal is meghiúsul (az előfeltétel sikertelen). |
A kérés törzse
Nincsenek.
Mintakérés
DELETE https://myaccount.file.core.windows.net/myshare?restype=share HTTP/1.1
Request Headers:
x-ms-version: 2014-02-14
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ= TBD
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 kérés futtatásához használt Azure Files verzióját jelzi. |
Date vagy x-ms-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. |
Választörzs
Nincsenek.
Engedélyezés
Ezt a műveletet csak a fióktulajdonos hívhatja meg.
Megjegyzések
Ha töröl egy megosztást, legalább 30 másodpercig nem hozhat létre ugyanazzal a névvel rendelkező megosztást. A megosztás törlése közben az azonos nevű megosztás újbóli létrehozására tett kísérletek sikertelenek lesznek a 409-ben (Ütközés) állapotkóddal. A szolgáltatás további hibainformációkat ad vissza, amelyek azt jelzik, hogy a megosztás törölve van. Minden más művelet, beleértve a megosztás alatti fájlokon végzett műveleteket is, a megosztás törlése közben a 404-es (Nem található) állapotkóddal hiúsul meg.
Jelenleg nem lehet törölni egy pillanatképekkel rendelkező megosztást. A megosztás pillanatképei egyenként törölhetők, vagy a megosztással együtt törölhetők a x-ms-delete-snapshots=include fejléc használatával.
Csak az alapmegosztási erőforrásra vonatkozó kérést kell megadnia x-ms-delete-snapshots . Ha ezt a fejlécet egy egyedi pillanatkép törlésére irányuló kérelemben adja meg, Azure Files a 400-ás állapotkódot adja vissza (érvénytelen lekérdezési paraméterérték). Ha ez a fejléc nincs megadva a törlési kérelemben, és a megosztáshoz társított pillanatképek tartoznak, a Azure Files a 409-es állapotkódot adja vissza (megosztási pillanatképekkel rendelkezik).