Üzenet törlése (Azure Storage)

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.

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