Share verwijderen

Met Delete Share de bewerking wordt de opgegeven share- of share-momentopname verwijderd. Hoewel deze API volledig wordt ondersteund, is dit een verouderde beheer-API. U wordt aangeraden bestands shares - Verwijderen te gebruiken die zijn geleverd door de opslagresourceprovider (Microsoft.Storage). Zie Bewerkingen op Bestandsshares voor meer informatie over het programmatisch communiceren met resources met behulp van de FileShare opslagresourceprovider.

Beschikbaarheid van protocollen

Protocol voor bestands delen ingeschakeld Beschikbaar
SMB Ja
NFS Ja

Aanvraag

De Delete Share aanvraag kan als volgt worden samengesteld. HTTPS wordt aanbevolen.

Methode Aanvraag-URI HTTP-versie
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

Vervang de padonderdelen in de aanvraag-URI als volgt door uw eigen padonderdelen:

Padonderdeel Beschrijving
myaccount De naam van uw opslagaccount.
myshare De naam van uw bestands share.

Zie Naming and Referencing Shares, Directories, Files, and Metadata (Shares, mappen, bestandenen metagegevens een naam geven en hier naar verwijzen) voor meer informatie over naamgevingsbeperkingen voor paden.

URI-parameters

De volgende aanvullende parameters kunnen worden opgegeven in de aanvraag-URI.

Parameter Beschrijving
sharesnapshot Optioneel. Versie 2017-04-17 en hoger. De parameter sharesnapshot is een ondoorzichtige datum/tijd-waarde die, indien aanwezig, aangeeft welke momentopname van de share moet worden verwijderd
timeout Optioneel. De time-outparameter wordt uitgedrukt in seconden. Zie Time-outs instellen voor bestandsservicebewerkingen voor meer informatie.

Aanvraagheaders

In de volgende tabel worden de vereiste en optionele aanvraagheaders beschreven.

Aanvraagheader Beschrijving
Authorization Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening op. Zie Aanvragen voor toegang tot Azure Storage voor meer Azure Storage.
Date of x-ms-date Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen voor toegang tot Azure Storage voor meer Azure Storage.
x-ms-version Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking moet worden gebruikt voor deze aanvraag. Zie Versioning for the Azure Storage Services (Versie Azure Storage Services) voor meer informatie.
x-ms-delete-snapshots: { include, include-leased } Optioneel als de share momentopnamen heeft gekoppeld. Geef een van de volgende opties op:
  • include: Verwijder de basis share en alle momentopnamen.
  • include-leased: Verwijder de basis share en alle momentopnamen ervan, zelfs als een of meer van de momentopnamen actieve share-leases hebben.
x-ms-client-request-id Optioneel. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet van 1 KiB die wordt vastgelegd in de analyselogboeken wanneer logboekregistratie van opslaganalyse is ingeschakeld. Het gebruik van deze header wordt ten zeerste aanbevolen voor het correleren van activiteiten aan clientzijde met aanvragen die door de server worden ontvangen. Zie Azure Blob Storage bewaken voor meer informatie.
x-ms-lease-id: <ID> Vereist als de doelbestands share een actieve lease heeft. Beschikbaar voor versies 2020-02-10 en hoger. Als de aanvraag de lease-id niet bevat of niet geldig is, mislukt de bewerking met statuscode 412 (Voorwaarde mislukt).

Als deze header is opgegeven en de doelbestands share momenteel geen actieve lease heeft, mislukt de bewerking ook met statuscode 412 (Hoofdvoorwaarde mislukt).

Aanvraagbody

Geen.

Voorbeeldaanvraag

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  

Antwoord

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Statuscode

Een geslaagde bewerking retourneert statuscode 202 (Geaccepteerd).

Zie Status- en foutcodes voor meer informatie over statuscodes.

Antwoordheaders

Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook aanvullende standaard HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.

Antwoordheader Beschrijving
x-ms-request-id Deze header identificeert op unieke manier de aanvraag die is gemaakt en kan worden gebruikt voor het oplossen van problemen met de aanvraag. Zie Troubleshooting API Operations (Problemen met API-bewerkingen oplossen) voor meer informatie.
x-ms-version Geeft de versie aan van de bestandsservice die wordt gebruikt om de aanvraag uit te voeren.
Date of x-ms-date Een UTC-datum/tijd-waarde die wordt gegenereerd door de service die het tijdstip aangeeft waarop het antwoord is gestart.
x-ms-client-request-id Deze header kan worden gebruikt voor het oplossen van problemen met aanvragen en bijbehorende antwoorden. De waarde van deze header is gelijk aan de waarde van de header als deze aanwezig is in de aanvraag en de waarde uit x-ms-client-request-id 1024 zichtbare ASCII-tekens bestaat. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze header niet aanwezig in het antwoord.

Hoofdtekst van de reactie

Geen.

Autorisatie

Alleen de accounteigenaar kan deze bewerking aanroepen.

Opmerkingen

Wanneer een share wordt verwijderd, kan een share met dezelfde naam niet ten minste 30 seconden opnieuw worden gemaakt. Terwijl de share wordt verwijderd, mislukken pogingen om een share met dezelfde naam opnieuw te maken met statuscode 409 (Conflict), waarbij de service aanvullende foutinformatie retourneert die aangeeft dat de share wordt verwijderd. Alle andere bewerkingen, inclusief bewerkingen op bestanden onder de share, mislukken met statuscode 404 (Niet gevonden) terwijl de share wordt verwijderd.

Het verwijderen van een share met momentopnamen is momenteel niet toegestaan. De momentopnamen van de share kunnen afzonderlijk worden verwijderd of samen met de share worden verwijderd met behulp van de x-ms-delete-snapshots=include header zoals hierboven wordt vermeld.

Deze header x-ms-delete-snapshots moet alleen worden opgegeven voor een aanvraag voor de basis share-resource. Als deze header is opgegeven bij een aanvraag voor het verwijderen van een afzonderlijke momentopname, retourneert de bestandsservice statuscode 400 (InvalidQueryParameterValue). Als deze header niet is opgegeven in de aanvraag voor verwijderen en de share momentopnamen heeft gekoppeld, retourneert de bestandsservice statuscode 409 (ShareHasSnapshots).

Zie ook

Bewerkingen op shares (bestandsservice)