Üzenet törlése (Azure Storage)

  • Cikk

A Delete Message művelet törli a megadott üzenetet az üzenetsorból.

Kérés

A kérést az Delete Message alábbiak szerint hozhatja létre. A HTTPS használata ajánlott.

Metódus Kérés URI-ja HTTP-verzió
DELETE https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value HTTP/1.1

Cserélje le myaccount a elemet a tárfiók nevére, myqueue az üzenetsor nevére, valamint string-value az üzenet törléséhez kapott pop nyugta értékére.

Emulált tárolási szolgáltatás URI-ja

Amikor kérést küld az emulált tárolási szolgáltatásra, adja meg az emulátor gazdagépnevét és az Azure Queue Storage-portot 127.0.0.1:10001, majd az emulált tárfiók nevét.

Metódus Kérés URI-ja HTTP-verzió
DELETE http://127.0.0.1:10001/devstoreaccount1/myqueue/messages/messageid?popreceipt=string-value HTTP/1.1

URI-paraméterek

A kérelem URI-ja a következő paramétereket támogatja.

Paraméter Leírás
popreceipt Kötelező. Az Üzenetek lekérése vagy az Üzenet frissítése művelet korábbi hívása által visszaadott érvényes pop-nyugtaérték.
timeout Választható. A timeout paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása a Queue Storage-műveletekhez.

Kérésfejlécek

Az alábbi táblázat a szükséges és nem kötelező kérelemfejléceket ismerteti.

Kérelem fejléce Leírás
Authorization Kötelező. Megadja az engedélyezési sémát, a fióknevet és az aláírást. További információ: Kérelmek engedélyezése az Azure Storage-ba.
Date vagy x-ms-date Kötelező. Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját. További információ: Kérelmek engedélyezése az Azure Storage-ba.
x-ms-version Választható. A kérelemhez használandó művelet verzióját adja meg. További információ: Az Azure Storage-szolgáltatások verziószámozása.
x-ms-client-request-id Választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kibibyte (KiB) karakterkorláttal, amelyet a naplózás konfigurálásakor rögzít a naplókban. Javasoljuk, hogy ezt a fejlécet használva korrelálja az ügyféloldali tevékenységeket a kiszolgáló által kapott kérésekkel. További információ: Az Azure Queue Storage monitorozása.

A kérés törzse

Nincsenek.

Reagálás

A válasz egy HTTP-állapotkódot és válaszfejléceket tartalmaz.

Állapotkód

A sikeres művelet a 204-et (nincs tartalom) állapotkódot adja vissza. Az állapotkódokkal kapcsolatos információkért lásd: Állapot- és hibakódok.

Válaszfejlécek

A műveletre adott válasz a következő fejléceket tartalmazza. A válasz további szabványos HTTP-fejléceket is tartalmaz. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.

Kérelem fejléce Description
x-ms-request-id Ez a fejléc egyedileg azonosítja a végrehajtott kérést, és a kérés hibaelhárításához használható. További információ: API-műveletek hibaelhárítása.
x-ms-version A Kérés futtatásához használt Queue Storage-verziót jelzi. Ez a fejléc lesz visszaadva a 2009-09-19-es és újabb verzióval kapcsolatos kérésekhez.
Date UTC dátum/idő érték, amely a válasz indításának időpontját jelzi. Ezt az értéket a szolgáltatás hozza létre.
x-ms-client-request-id Ez a fejléc a kérések és a megfelelő válaszok hibaelhárítására használható. Ennek a fejlécnek az értéke megegyezik a x-ms-client-request-id fejléc értékével, ha az szerepel a kérelemben. Az érték legfeljebb 1024 látható ASCII-karakter lehet. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, akkor ez a fejléc nem jelenik meg a válaszban.

Választörzs

Nincsenek.

Engedélyezés

A fióktulajdonos végrehajthatja ezt a műveletet. Emellett bárki, aki rendelkezik közös hozzáférésű jogosultságkóddal, aki rendelkezik engedéllyel a művelet végrehajtásához, végrehajthatja azt.

Megjegyzések

Ha sikeresen töröl egy üzenetet, az azonnal törlésre lesz megjelölve, és már nem érhető el az ügyfelek számára. Az üzenet később eltávolításra kerül az üzenetsorból a szemétgyűjtés során.

Miután egy ügyfél lekért egy üzenetet az Üzenetek lekérése művelettel, az ügyfélnek fel kell dolgoznia és törölnie kell az üzenetet. Az üzenet törléséhez két adatelemet kell visszaadnia a művelet választörzsében Get Messages :

  • Az üzenetazonosító, egy átlátszatlan GUID-érték, amely azonosítja az üzenetet az üzenetsorban.

  • Érvényes előugró nyugta, egy átlátszatlan érték, amely azt jelzi, hogy az üzenet le lett kérve.

Az üzenetazonosítót az előző Get Messages művelet adja vissza. A rendszer a legutóbbi Get Messages vagy Update Message művelet által visszaadott pop nyugtát adja vissza. Delete Message A művelet sikerességéhez a kérelemben megadott előugró nyugtának meg kell egyeznie a vagy Update Message művelet által Get Messages visszaadott pop nyugtával.

Az előugró nyugták mindaddig érvényesek maradnak, amíg az alábbi események valamelyike nem következik be:

  • Az üzenet lejár.

  • Az üzenet a legutóbbi fogadott pop-nyugtával törlődik, vagy a következőtől: Get MessagesUpdate Message.

  • A láthatatlanság időtúllépése lejár, és az üzenetet egy Get Messages kérés törli. Amikor a láthatatlanság időtúllépése lejár, az üzenet ismét láthatóvá válik. Ha egy másik Get Messages kérés kéri le, a visszaadott pop nyugta felhasználható az üzenet törlésére vagy frissítésére.

  • Az üzenet új láthatósági időtúllépéssel frissül. Az üzenet frissítésekor a rendszer új nyugtát ad vissza.

Ha nem található egyező előugró nyugtával rendelkező üzenet, a szolgáltatás a 404-ben (Nem található) hibakódot adja vissza. Ez a hiba a korábban felsorolt esetekben fordul elő, amikor a pop nyugta már nem érvényes.

Lásd még

Kérések engedélyezése az Azure Storage-nak
Állapot- és hibakódok
Queue Storage-hibakódok