Ta bort resurs
Åtgärden Delete Share tar bort den angivna resursen eller resursögonblicksbilden. Det här API:et stöds fullt ut, men tänk på att det här är ett äldre hanterings-API.
Det är en bra idé att använda filresurser – Ta bort i stället. Den tillhandahålls av lagringsresursprovidern (Microsoft.Storage). Mer information om hur du interagerar programmatiskt med resurser med FileShare hjälp av lagringsresursprovidern finns i Åtgärder på FileShares.
Protokolltillgänglighet
| Aktiverat filresursprotokoll | Tillgängligt |
|---|---|
| SMB |
|
| NFS |
|
Förfrågan
Du kan skapa begäran på Delete Share följande sätt. HTTPS rekommenderas.
| Metod | URI för förfrågan | HTTP-version |
|---|---|---|
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 |
Ersätt sökvägskomponenterna som visas i begärande-URI:n med dina egna, enligt följande:
| Sökvägskomponent | Description |
|---|---|
myaccount |
Namnet på ditt lagringskonto. |
myshare |
Namnet på filresursen. |
Mer information om namngivningsbegränsningar för sökvägar finns i Namnge och referera till resurser, kataloger, filer och metadata.
URI-parametrar
Du kan ange följande ytterligare parametrar i begärande-URI:n.
| Parameter | Beskrivning |
|---|---|
sharesnapshot |
Valfritt. Version 2017-04-17 och senare. Parametern sharesnapshot är ett täckande DateTime värde som när den finns anger resursögonblicksbilden som ska tas bort. |
timeout |
Valfritt. Parametern timeout uttrycks i sekunder. Mer information finns i Ange tidsgränser för Azure Files åtgärder. |
Begärandehuvuden
I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.
| Begärandehuvud | Beskrivning |
|---|---|
Authorization |
Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage. |
Date eller x-ms-date |
Krävs. Anger Coordinated Universal Time (UTC) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage. |
x-ms-version |
Krävs för alla auktoriserade begäranden. Anger vilken version av åtgärden som ska användas för den här begäran. Mer information finns i Versionshantering för Azure Storage-tjänsterna. |
x-ms-delete-snapshots: { include, include-leased } |
Valfritt om resursen har associerade ögonblicksbilder. Ange något av följande alternativ:
|
x-ms-client-request-id |
Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggningen har konfigurerats. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. Mer information finns i Övervaka Azure Files. |
x-ms-lease-id: <ID> |
Krävs om målfilresursen har ett aktivt lån. Tillgänglig för version 2020-02-10 och senare. Om begäran inte innehåller låne-ID:t eller om det inte är giltigt misslyckas åtgärden med statuskoden 412 (villkoret misslyckades). Om det här huvudet anges och målfilresursen för närvarande inte har ett aktivt lån misslyckas även åtgärden med statuskoden 412 (villkoret misslyckades). |
Begärandetext
Inga.
Exempelbegäran
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
Svarsåtgärder
Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.
Statuskod
En lyckad åtgärd returnerar statuskoden 202 (accepterad). Information om statuskoder finns i Status och felkoder.
Svarshuvuden
Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare standard-HTTP-huvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.
| Svarsrubrik | Description |
|---|---|
x-ms-request-id |
Det här huvudet identifierar unikt den begäran som gjordes och kan användas för att felsöka begäran. Mer information finns i Felsöka API-åtgärder. |
x-ms-version |
Anger vilken version av Azure Files som används för att köra begäran. |
Date eller x-ms-date |
Ett UTC-datum/tid-värde som anger den tid då svaret initierades. Tjänsten genererar det här värdet. |
x-ms-client-request-id |
Du kan använda det här huvudet för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet för x-ms-client-request-id huvudet, om det finns i begäran. Värdet är högst 1 024 synliga ASCII-tecken.
x-ms-client-request-id Om rubriken inte finns i begäran visas inte det här huvudet i svaret. |
Själva svaret
Inga.
Auktorisering
Endast kontoägaren kan anropa den här åtgärden.
Kommentarer
När du tar bort en resurs kan du inte skapa en resurs med samma namn på minst 30 sekunder. När resursen tas bort misslyckas försök att återskapa en resurs med samma namn med statuskoden 409 (konflikt). Tjänsten returnerar ytterligare felinformation som anger att resursen tas bort. Alla andra åtgärder, inklusive åtgärder på alla filer under resursen, misslyckas med statuskoden 404 (hittades inte) medan resursen tas bort.
För närvarande är det inte tillåtet att ta bort en resurs som har ögonblicksbilder. Resursögonblicksbilderna kan tas bort individuellt eller tas bort tillsammans med resursen med hjälp x-ms-delete-snapshots=include av rubriken.
Du bör bara ange x-ms-delete-snapshots för en begäran mot basresursresursen. Om du anger det här huvudet på en begäran om att ta bort en enskild ögonblicksbild returnerar Azure Files statuskod 400 (ogiltigt frågeparametervärde). Om det här huvudet inte anges i borttagningsbegäran och resursen har associerade ögonblicksbilder returnerar Azure Files statuskod 409 (Ögonblicksbilder av resurs har).