Odstranit sdílenou složku
Operace Delete Share odstraní zadanou sdílenou složku nebo snímek sdílené složky. Toto rozhraní API je plně podporované, ale mějte na paměti, že se jedná o starší verzi rozhraní API pro správu.
Místo toho je vhodné použít sdílené složky – Odstranit . Poskytuje ho poskytovatel prostředků úložiště (Microsoft.Storage). Další informace o programové interakci s prostředky pomocí poskytovatele prostředků úložiště najdete v tématu Operace se sdílenýmiFileShare složkami.
| Povolený protokol sdílené složky | K dispozici. |
|---|---|
| SMB |
|
| NFS |
|
Požadavek můžete sestavit Delete Share následujícím způsobem. Doporučuje se https.
| Metoda | Identifikátor URI žádosti | Verze PROTOKOLU HTTP |
|---|---|---|
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 |
Následujícím způsobem nahraďte komponenty cesty uvedené v identifikátoru URI požadavku vlastními:
| Komponenta cesty | Description |
|---|---|
myaccount |
Název vašeho účtu úložiště. |
myshare |
Název sdílené složky. |
Podrobnosti o omezeních pojmenování cest najdete v tématu Pojmenování sdílených složek, adresářů, souborů a metadat a odkazování na nich.
V identifikátoru URI požadavku můžete zadat následující další parametry.
| Parametr | Popis |
|---|---|
sharesnapshot |
Nepovinný parametr. Verze 2017-04-17 a novější. Parametr sharesnapshot je neprůsažná DateTime hodnota, která pokud je k dispozici, určuje snímek sdílené složky, který se má odstranit. |
timeout |
Nepovinný parametr. Parametr se timeout vyjadřuje v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace Azure Files. |
Následující tabulka popisuje požadované a volitelné hlavičky požadavků.
| Hlavička požadavku | Popis |
|---|---|
Authorization |
Povinná hodnota. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage. |
Date nebo x-ms-date |
Povinná hodnota. Určuje formát UTC (Coordinated Universal Time). Další informace najdete v tématu Autorizace požadavků do služby Azure Storage. |
x-ms-version |
Vyžaduje se pro všechny autorizované žádosti. Určuje verzi operace, která se má pro tento požadavek použít. Další informace najdete v tématu Správa verzí pro služby Azure Storage. |
x-ms-delete-snapshots: { include, include-leased } |
Volitelné, pokud má sdílená složka přidružené snímky. Zadejte jednu z následujících možností:
|
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 Files. |
x-ms-lease-id: <ID> |
Vyžaduje se, pokud má cílová sdílená složka aktivní zapůjčení. K dispozici pro verzi 2020-02-10 a novější. Pokud požadavek neobsahuje ID zapůjčení nebo není platný, operace selže se stavovým kódem 412 (Předběžná podmínka selhala). Pokud je tato hlavička zadaná a cílová sdílená složka aktuálně nemá aktivní zapůjčení, operace selže se stavovým kódem 412 (Předběžná podmínka se nezdařila). |
Žádné
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
Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.
Úspěšná operace vrátí stavový kód 202 (přijato). Informace o stavových kódech najdete v tématu Stavové kódy a kódy chyb.
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 |
|---|---|
x-ms-request-id |
Tato hlavička jednoznačně identifikuje požadavek, který byl proveden, a lze ji 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 Azure Files použité ke spuštění požadavku. |
Date nebo x-ms-date |
Hodnota data a času UTC, která označuje čas, kdy byla odpověď zahájena. Tato služba vygeneruje tuto hodnotu. |
x-ms-client-request-id |
Tuto hlavičku můžete použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě x-ms-client-request-id hlavičky, pokud se nachází v požadavku. Hodnota je maximálně 1 024 viditelných znaků ASCII. Pokud se hlavička x-ms-client-request-id v požadavku nenachází, nebude tato hlavička v odpovědi. |
Žádné
Tuto operaci může volat pouze vlastník účtu.
Když odstraníte sdílenou složku, nemůžete vytvořit sdílenou složku se stejným názvem alespoň po dobu 30 sekund. Když se sdílená složka odstraňuje, pokusy o opětovné vytvoření sdílené složky se stejným názvem selžou se stavovým kódem 409 (konflikt). Služba vrátí další informace o chybě, které označují, že se sdílená složka odstraňuje. Všechny ostatní operace, včetně operací se všemi soubory ve sdílené složce, se během odstranění sdílené složky nezdaří se stavovým kódem 404 (Nenalezena).
V současné době není možné odstranit sdílenou složku, která obsahuje snímky. Snímky sdílené složky je možné odstranit jednotlivě nebo je můžete odstranit společně se sdílenou složkou pomocí hlavičky x-ms-delete-snapshots=include .
Měli byste zadat x-ms-delete-snapshots pouze pro požadavek na prostředek základní sdílené složky. Pokud tuto hlavičku zadáte u požadavku na odstranění jednotlivého snímku, vrátí Azure Files stavový kód 400 (neplatná hodnota parametru dotazu). Pokud tato hlavička není v požadavku na odstranění zadána a sdílená složka má přidružené snímky, vrátí Azure Files stavový kód 409 (Sdílená složka má snímky).