Üzenetek törlése

  • Cikk

A Clear Messages művelet törli az összes üzenetet a megadott üzenetsorból.

Kérés

A kérést a Clear Messages következőképpen hozhatja létre. A HTTPS használatát javasoljuk. Cserélje le a myaccount nevet a tárfiók nevére, és cserélje le a myqueue elemet az üzenetsor nevére.

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

URI az emulált tárolási szolgáltatáshoz

Amikor kérést küld az emulált tárolási szolgáltatásra, adja meg az emulátor gazdagépének nevé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 HTTP/1.1

URI-paraméterek

A kérelem URI-ján a következő további paramétereket adhatja meg:

Paraméter Leírás
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érésfejlé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érések 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érések engedélyezése az Azure Storage-ba.
x-ms-version Választható. A kérelemhez használni kívánt 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 kib-os (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.

A kérés törzse

Nincsenek.

Reagálás

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

Állapotkód

A sikeres művelet a 204-ben (tartalom nélkül) visszaadott á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 Leírás
x-ms-request-id Egyedileg azonosítja a végrehajtott kérést. Ezzel a fejlécmel háríthatja el a kérést. További információ: API-műveletek hibaelhárítása.
x-ms-version A Queue Storage kérés végrehajtásához használt verzióját jelzi. A rendszer ezt a fejlécet adja vissza a 2009-09-19-es és újabb verzióval kapcsolatos kérésekhez.
Date Utc dátum/idő érték, amely azt jelzi, hogy a szolgáltatás mikor küldte el a választ.
x-ms-client-request-id A kérések és a kapcsolódó válaszok hibaelhárítására használható. A fejléc értéke megegyezik a x-ms-client-request-id fejléc értékével, ha az szerepel a kérelemben, és az érték legfeljebb 1024 látható ASCII-karakter. 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

Ezt a műveletet csak a fióktulajdonos hívhatja meg.

Megjegyzések

Ha egy üzenetsor sok üzenetet tartalmaz, előfordulhat, Clear Messages hogy az összes üzenet törlése előtt időtúllépés történik. Ebben az esetben a Queue Storage az 500-os állapotkódot (belső kiszolgálóhiba) adja vissza, a további hibakód pedig OperationTimedOut. Ha ezt a hibakódot kapja, előfordulhat, hogy a művelet sikeres volt a kiszolgáló oldalán, és a művelet újrapróbálkozása előtt le kell kérdeznie a kiszolgáló állapotát. Ha a művelet túllépi az időkorlátot, és úgy véli, hogy sikertelen a kiszolgálóoldalon, az ügyfélnek mindaddig újra kell próbálkoznia Clear Messages , amíg meg nem győződik arról, hogy az összes üzenet törölve lett.

Lásd még

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