Címtár törlése
A Delete Directory művelet eltávolítja a megadott üres könyvtárat. Vegye figyelembe, hogy a könyvtárnak üresnek kell lennie ahhoz, hogy törölhető legyen.
Protokoll rendelkezésre állása
| Engedélyezett fájlmegosztási protokoll | Elérhető |
|---|---|
| SMB |
|
| NFS |
|
Kérés
A kérést az Delete Directory alábbiak szerint 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/myparentdirectorypath/mydirectory?restype=directory |
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ő | Leírás |
|---|---|
myaccount |
A tárfiók neve. |
myshare |
A fájlmegosztás neve. |
myparentdirectorypath |
Választható. A szülőkönyvtár elérési útja. |
mydirectory |
A könyvtár neve. |
Az elérési utak elnevezési korlátozásával kapcsolatos részletekért lásd: Megosztások, könyvtárak, fájlok és metaadatok elnevezése és hivatkozása.
URI-paraméterek
A kérelem URI-ján a következő további paramétert adhatja meg.
| Paraméter | Leírás |
|---|---|
timeout |
Választható. Az időtúllépési 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érelmek 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érelmek engedélyezése az Azure Storage-ba |
x-ms-version |
Minden engedélyezett 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-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 Files figyelése. |
x-ms-file-request-intent |
Kötelező, ha Authorization a fejléc OAuth-jogkivonatot ad meg. Elfogadható érték: backup. Ez a fejléc határozza meg, hogy a Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action vagy Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action értéket kell megadni, ha szerepelnek a fejléc használatával Authorization engedélyezett identitáshoz rendelt RBAC-szabályzatban. A 2022-11-02-es és újabb verziókhoz érhető el. |
x-ms-allow-trailing-dot: { <Boolean> } |
Választható. 2022-11-02-es és újabb verzió. A logikai érték azt határozza meg, hogy a kérelem URL-címében található záró pont legyen-e levágva vagy sem. További információ: Megosztások, könyvtárak, fájlok és metaadatok elnevezése és hivatkozása. |
A kérés törzse
Nincsenek.
Mintakérés
Request Syntax:
DELETE https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory 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=
Reagálás
A válasz egy HTTP-állapotkódot és válaszfejléceket tartalmaz.
Á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 | Leírás |
|---|---|
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 |
UTC dátum/idő érték, amely a válasz indításának időpontját jelzi. Ezt az értéket a szolgáltatás hozza létre. |
x-ms-client-request-id |
Ezzel a fejléccel elháríthatja a kéréseket és a megfelelő válaszokat. Ennek a fejlécnek az értéke megegyezik a x-ms-client-request-id fejléc értékével, 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.
Mintaválasz
Response Status:
HTTP/1.1 202 Accepted
Response Headers:
Transfer-Encoding: chunked
Content-Type: application/xml
Date: Mon, 27 Jan 2014 21:45:00 GMT
x-ms-version: 2014-02-14
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Engedélyezés
Ezt a műveletet csak a fióktulajdonos hívhatja meg.
Megjegyzések
Ha olyan címtárakat próbál törölni, amelyek nem üresek, a szolgáltatás a 409-et (a címtárat nem üres) adja vissza.
Miután az ügyfél megkapta a 202-re (Elfogadva) állapotkódot, a címtárat eltávolították a rendszerből, és újra létrehozható. A címtártulajdonságok lekérésére irányuló további hívások a 404-et (nem találhatók) eredményezik.
Delete Directory A megosztás pillanatképe nem támogatott, amely egy megosztás írásvédett másolata. Ha megosztási pillanatképen kísérli meg végrehajtani ezt a műveletet, a szolgáltatás a 400-ás hibát adja vissza (érvénytelen lekérdezési paraméterérték).