Üzenetsor törlése (Azure Storage)

A Delete Queue művelet véglegesen törli a megadott üzenetsort.

Kérés

A kérést az Delete Queue alábbiak szerint hozhatja létre. A HTTPS használata ajánlott. Cserélje le a myaccount kifejezést a tárfiók nevére.

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

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 gazdanevé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	HTTP/1.1

URI-paraméterek

A kérelem URI-ján a következő további paramétert 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érelemfejléceket ismerteti.

Kérelem fejléce	Description
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 tartalmazhat. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.

Válaszfejléc	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	Ezzel a fejléccel elháríthatja a kéréseket és a megfelelő válaszokat. 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

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

Megjegyzések

Ha töröl egy üzenetsort, legalább 30 másodpercig nem hozhat létre azonos nevű üzenetsort. Előfordulhat, hogy az üzenetsor 30 másodpercnél tovább nem érhető el, ha a szolgáltatás továbbra is feldolgozta a kérést.

Az üzenetsor törlése közben az azonos nevű üzenetsor létrehozására tett kísérletek meghiúsulnak a 409-ben (Ütközés) állapotkóddal. A szolgáltatás további hibainformációkat ad vissza, amelyek azt jelzik, hogy az üzenetsor törölve van. Minden más művelet, beleértve az üzenetsor bármely üzenetére vonatkozó műveleteket is, a 404-es (Nem található) állapotkóddal meghiúsul az üzenetsor törlése közben.

Lásd még

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