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.
Dostupnost protokolu
| Povolený protokol sdílené složky | K dispozici. |
|---|---|
| SMB |
|
| NFS |
|
Žádost
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.
Parametry identifikátoru URI
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. |
Hlavičky požadavku
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). |
Text požadavku
Žádné
Ukázkový požadavek
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ěď
Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.
Stavový kód
Ú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.
Hlavičky odpovědi
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. |
Text odpovědi
Žádné
Autorizace
Tuto operaci může volat pouze vlastník účtu.
Poznámky
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).