Bericht verwijderen (Azure Storage)

  • Artikel

Met Delete Message de bewerking wordt het opgegeven bericht uit de wachtrij verwijderd.

Aanvraag

U kunt de Delete Message aanvraag als volgt samenstellen. HTTPS wordt aanbevolen.

Methode Aanvraag-URI HTTP-versie
DELETE https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value HTTP/1.1

Vervang door myaccount de naam van uw opslagaccount, myqueue door de naam van uw wachtrij en string-value door de waarde van het pop-ontvangstbewijs dat is verkregen voor het bericht dat moet worden verwijderd.

Geëmuleerde opslagservice-URI

Wanneer u een aanvraag doet voor de geëmuleerde opslagservice, geeft u de hostnaam van de emulator en de Azure Queue Storage-poort op als 127.0.0.1:10001, gevolgd door de naam van het geëmuleerde opslagaccount.

Methode Aanvraag-URI HTTP-versie
DELETE http://127.0.0.1:10001/devstoreaccount1/myqueue/messages/messageid?popreceipt=string-value HTTP/1.1

URI-parameters

De aanvraag-URI ondersteunt de volgende parameters.

Parameter Beschrijving
popreceipt Vereist. Een geldige pop-ontvangstbevestiging die is geretourneerd na een eerdere aanroep naar de bewerking Berichten ophalen of Bericht bijwerken .
timeout Optioneel. De timeout parameter wordt uitgedrukt in seconden. Zie Time-outs instellen voor Queue Storage-bewerkingen voor meer informatie.

Aanvraagheaders

In de volgende tabel worden vereiste en optionele aanvraagheaders beschreven.

Aanvraagheader Beschrijving
Authorization Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening op. Zie Aanvragen autoriseren voor Azure Storage voor meer informatie.
Date of x-ms-date Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storage voor meer informatie.
x-ms-version Optioneel. Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag. Zie Versiebeheer voor de Azure Storage-services voor meer informatie.
x-ms-client-request-id Optioneel. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet van 1 kibibyte (KiB) die wordt vastgelegd in de logboeken wanneer logboekregistratie is geconfigureerd. We raden u ten zeerste aan deze header te gebruiken om activiteiten aan de clientzijde te correleren met aanvragen die de server ontvangt. Zie Azure Queue Storage bewaken voor meer informatie.

Aanvraagbody

Geen.

Antwoord

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

Statuscode

Een geslaagde bewerking retourneert statuscode 204 (Geen inhoud). Zie Status- en foutcodes voor meer informatie over statuscodes.

Antwoordheaders

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

Aanvraagkoptekst Beschrijving
x-ms-request-id Deze header identificeert op unieke wijze de aanvraag die is gedaan en kan worden gebruikt voor het oplossen van problemen met de aanvraag. Zie Problemen met API-bewerkingen oplossen voor meer informatie.
x-ms-version Geeft de versie van Queue Storage aan die wordt gebruikt om de aanvraag uit te voeren. Deze header wordt geretourneerd voor aanvragen die zijn gedaan in versie 2009-09-19 en hoger.
Date Een UTC-datum/tijd-waarde die de tijd aangeeft waarop het antwoord is gestart. De service genereert deze waarde.
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 x-ms-client-request-id header, als deze aanwezig is in de aanvraag. De waarde is maximaal 1024 zichtbare ASCII-tekens. 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

De accounteigenaar kan deze bewerking uitvoeren. Bovendien kan iedereen met een Shared Access Signature die gemachtigd is om deze bewerking uit te voeren, deze uitvoeren.

Opmerkingen

Wanneer u een bericht hebt verwijderd, wordt het onmiddellijk gemarkeerd voor verwijdering en is het niet meer toegankelijk voor clients. Het bericht wordt later tijdens de garbagecollection uit de wachtrij verwijderd.

Nadat een client een bericht met de bewerking Berichten ophalen heeft opgehaald, wordt verwacht dat de client het bericht verwerkt en verwijdert. Als u het bericht wilt verwijderen, moet u twee gegevensitems hebben geretourneerd in de antwoordtekst van de Get Messages bewerking:

  • De bericht-id, een ondoorzichtige GUID-waarde die het bericht in de wachtrij identificeert.

  • Een geldig pop-ontvangstbewijs, een ondoorzichtige waarde die aangeeft dat het bericht is opgehaald.

De bericht-id wordt geretourneerd uit de vorige Get Messages bewerking. De pop-ontvangstbevestiging wordt geretourneerd van de meest recente Get Messages of Update Message bewerking. Delete Message De bewerking slaagt alleen als de pop-ontvangstbevestiging die in de aanvraag is opgegeven, overeenkomt met de pop-ontvangstbevestiging die is geretourneerd door de Get Messages bewerking ofUpdate Message.

Pop-ontvangstbevestigingen blijven geldig totdat een van de volgende gebeurtenissen plaatsvindt:

  • Het bericht verloopt.

  • Het bericht wordt verwijderd met behulp van de laatste pop-ontvangstbevestiging die is ontvangen van Get Messages of Update Message.

  • De time-out voor onzichtbaarheid verloopt en het bericht wordt verwijderd door een Get Messages aanvraag. Wanneer de time-out voor onzichtbaarheid verloopt, wordt het bericht weer zichtbaar. Als het wordt opgehaald door een andere Get Messages aanvraag, kan het geretourneerde pop-ontvangstbewijs worden gebruikt om het bericht te verwijderen of bij te werken.

  • Het bericht wordt bijgewerkt met een nieuwe zichtbaarheidstime-out. Wanneer het bericht wordt bijgewerkt, wordt er een nieuw pop-ontvangstbewijs geretourneerd.

Als een bericht met een overeenkomend pop-ontvangstbewijs niet wordt gevonden, retourneert de service foutcode 404 (Niet gevonden). Deze fout treedt op in de eerder vermelde gevallen waarin de pop-ontvangstbevestiging niet meer geldig is.

Zie ook

Aanvragen autoriseren voor Azure Storage
Status en foutcodes
Queue Storage-foutcodes