Aktualisieren einer Nachricht

Der Update Message Vorgang aktualisiert das Sichtbarkeitstimeout einer Nachricht. Sie können diesen Vorgang auch verwenden, um den Inhalt einer Nachricht zu aktualisieren. Eine Nachricht muss in einem Format vorliegen, das in eine XML-Anforderung mit UTF-8-Codierung aufgenommen werden kann, und die codierte Nachricht kann bis zu 64 KB groß sein. Dieser Vorgang wurde mit Version 2011-08-18 der Azure Queue Storage-API eingeführt.

Anfrage

Sie können die Update Message Anforderung wie folgt erstellen. HTTPS wird empfohlen. Ersetzen Sie myaccount durch den Namen Ihres Speicherkontos und myqueue durch den Namen Ihrer Warteschlange.

Emulierter Speicherdienst

Dieser Vorgang wird für SDK 1.6 und höhere Versionen unterstützt.

Wenn Sie eine Anforderung an den emulierten Speicherdienst senden, geben Sie den Hostnamen des Emulators und den Queue Storage-Port als 127.0.0.1:10001an, gefolgt vom Namen des emulierten Speicherkontos.

URI-Parameter

Sie können die folgenden Parameter für den Anforderungs-URI angeben.

Anforderungsheader

In der folgenden Tabelle werden die erforderlichen und optionalen Anforderungsheader beschrieben.

Anfragekörper

Der Text der Anforderung enthält die Nachrichtendaten im folgenden XML-Format. Beachten Sie, dass der Nachrichteninhalt in einem Format vorliegen muss, das mit UTF-8 codiert werden kann.

<QueueMessage>  
    <MessageText>message-content</MessageText>  
</QueueMessage>  

Antwort

Die Antwort enthält einen HTTP-Statuscode und eine Reihe von Antwortheadern.

Statuscode

Ein erfolgreicher Vorgang gibt den Statuscode 204 (Kein Inhalt) zurück. Weitere Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes.

Antwortkopfzeilen

Die Antwort für diesen Vorgang enthält die folgenden Header. Die Antwort kann auch zusätzliche, standardmäßige HTTP-Header enthalten. Alle Standard-Header entsprechen der HTTP/1.1-Protokollspezifikation.

Antwortkörper

Keiner.

Autorisierung

Der Kontoinhaber kann diesen Vorgang ausführen. Darüber hinaus kann jeder Benutzer mit einer Shared Access Signature, der über die Berechtigung zum Ausführen dieses Vorgangs verfügt, dies tun.

Beispielanforderung und -antwort

Die folgende Anforderung erweitert die Sichtbarkeit einer Warteschlangennachricht um 30 Sekunden und aktualisiert ihren Inhalt.

PUT https://myaccount.queue.core.windows.net/myqueue/messages/663d89aa-d1d9-42a2-9a6a-fcf822a97d2c?popreceipt=AgAAAAEAAAApAAAAGIw6Q29bzAE%3d&visibilitytimeout=30&timeout=30 HTTP/1.1  
  

Die Anforderung wird mit den folgenden Headern gesendet:

x-ms-version: 2011-08-18  
x-ms-date: Mon, 29 Aug 2011 17:17:21 GMT  
Authorization: SharedKey myaccount:batcrWZ35InGCZeTUFWMdIQiOZPCW7UEyeGdDOg7WW4=  
Content-Length: 75  

Die Anforderung wird mit dem folgenden XML-Text gesendet:

<QueueMessage>  
    <MessageText>new-message-content</MessageText>  
</QueueMessage>  

Nachdem die Anforderung gesendet wurde, wird die folgende Antwort zurückgegeben:

HTTP/1.1 204 No Content  
Content-Length: 0  
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: df34a7dd-3cbe-4206-a586-d6de3cf225a7  
x-ms-version: 2011-08-18  
x-ms-popreceipt: AwAAAAIAAAApAAAAINtMQ29bzAEBAAAA  
x-ms-time-next-visible: Mon, 29 Aug 2011 17:17:51 GMT  
Date: Mon, 29 Aug 2011 17:17:21 GMT  

Bemerkungen

Ein Update Message Vorgang schlägt fehl, wenn die angegebene Nachricht nicht in der Warteschlange vorhanden ist oder wenn die angegebene Pop-Bestätigung nicht mit der Nachricht übereinstimmt.

Ein POP-Beleg wird von der Get Messages Operation oder der Update Message Operation zurückgegeben. Pop-Belege bleiben gültig, bis eines der folgenden Ereignisse eintritt:

• Die Nachricht ist abgelaufen.

• Die Nachricht wurde mit der zuletzt empfangenen Pop-Bestätigung (von Get Messages oder Update Message) gelöscht.

• Die Unsichtbarkeitszeit ist abgelaufen und die Nachricht wurde durch eine Get Messages Anforderung aus der Warteschlange entfernt. Nach Ablauf der Unsichtbarkeitszeit wird die Nachricht wieder sichtbar. Wenn sie von einer anderen Get Messages Anforderung abgerufen wird, kann die zurückgegebene Pop-Bestätigung verwendet werden, um die Nachricht zu löschen oder zu aktualisieren.

• Die Nachricht wurde mit einem neuen Sichtbarkeits-Timeout aktualisiert. Wenn die Nachricht aktualisiert wird, wird eine neue Pop-Bestätigung zurückgegeben.

Sie können den Update Message Vorgang verwenden, um die Unsichtbarkeit einer Warteschlangennachricht kontinuierlich zu erweitern. Diese Funktion kann nützlich sein, wenn Sie eine Workerrolle zum Leasen einer Warteschlangennachricht verwenden möchten. Wenn z. B. eine Workerrolle Get Messages aufruft und erkennt, dass sie mehr Zeit benötigt, um eine Nachricht zu verarbeiten, kann sie die Unsichtbarkeit der Nachricht kontinuierlich verlängern, bis sie verarbeitet wird. Wenn die Workerrolle während der Verarbeitung fehlschlägt, wird die Nachricht schließlich wieder sichtbar, und eine andere Workerrolle kann sie verarbeiten.

Eine Nachricht muss in einem Format vorliegen, das in eine XML-Anforderung mit UTF-8-Codierung aufgenommen werden kann. Um Markup in die Nachricht einzuschließen, muss der Inhalt der Nachricht Base64-codiert sein. Jedes XML-Markup in der Nachricht, das nicht codiert ist, führt dazu, dass die Nachricht ungültig ist. Wenn ein ungültiges Zeichen (z. B 0x1F. ) in der Nachricht enthalten ist, auch wenn es mit XML-Escapezeichen versehen ist, sind nachfolgende Lesevorgänge der Nachricht nicht erfolgreich.

Wenn die Nachricht zu groß ist, gibt der Dienst den Statuscode 400 (Ungültige Anforderung) zurück.

Siehe auch

Autorisieren von Anforderungen an Azure Storage
Status- und Fehlercodes
Fehlercodes für Queue Storage