Odstranit zprávu

Tato operace dokončí zpracování uzamčené zprávy a odstraní ji z fronty nebo odběru. Tato operace by měla být volána pouze po úspěšném zpracování dříve uzamčené zprávy, aby se zachovaly záruky doručení alespoň jednou .

Prosba

Metoda Identifikátor URI požadavku Verze PROTOKOLU HTTP
VYMAZAT http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/{messageId|sequenceNumber}/{lockToken}

nebo

http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/{messageId|sequenceNumber}/{lockToken}|HTTP/1.1

Parametry identifikátoru URI

Identifikátor URI je uvedený v záhlaví umístění náhledové zprávy nebo ho můžete sestavit z částí popsaných v následující tabulce.

Parametr Popis
messageId ID zprávy, která se má odstranit, jak se vrátí v BrokerProperties{MessageId} operací Náhled zprávy.
sequence-number Pořadové číslo zprávy, která se má odstranit, jak je vráceno v BrokerProperties{SequenceNumber} operací Náhled zprávy.
lockToken Token zámku zprávy, který se má odstranit, jak vrátí operace Náhled zprávy v BrokerProperties{LockToken}.

Hlavičky požadavku

Následující tabulka popisuje povinné a volitelné hlavičky požadavků. Kromě uvedenýchvlastnostích Podívejte se na příklad.

Hlavička požadavku Popis
Oprávnění Zadejte jednu z následujících hodnot tokenu:

Text požadavku

Žádný.

Odpověď

Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědí a text odpovědi.

Kódy odpovědí

Kód Popis
200 Zpráva byla úspěšně odstraněna.
401 Chyba autorizace.
404 Nebyla nalezena žádná zpráva se zadanými MessageId nebo LockToken.
410 Zadaná fronta nebo předplatné neexistuje.
500 Vnitřní chyba.

Informace o stavových kódech naleznete v tématu Stav a Kódy chyb.

Hlavičky odpovědi

Hlavička odpovědi Popis
Typ obsahu Nastavit na application/atom+xml;type=entry; charset=utf-8.

Text odpovědi

Žádný.

Příklad

Následující požadavek HTTP odstraní zprávu z fronty:

DELETE https://your-namespace.servicebus.windows.net/HttpClientSampleQueue/messages/31907572-1647-43c3-8741-631acd554d6f/7da9cfd5-40d5-4bb1-8d64-ec5a52e1c547?timeout=60 HTTP/1.1  
Authorization: SharedAccessSignature sr=rukochbay&sig=rg9iGsK0ZyYlvhIqyH5IS5tqmeb08h8FstjHLPj3%2f8g%3d&se=1404265946&skn=RootManageSharedAccessKey  
Host: your-namespace.servicebus.windows.net  
Content-Length: 0

Service Bus vrátí následující odpověď:

HTTP/1.1 200 OK  
Transfer-Encoding: chunked  
Content-Type: application/xml; charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Tue, 01 Jul 2014 23:00:35 GMT  
  
0

Viz také

  • Last updated on