Üzenetsor létrehozása (Azure Storage)
A Create Queue művelet létrehoz egy üzenetsort egy tárfiókban.
Kérés
A kérést az Create Queue itt látható módon hozhatja létre. Javasoljuk, hogy HTTPS-t használjon. Cserélje le a myaccount nevet a tárfiók nevére.
| Metódus | Kérés URI-ja | HTTP-verzió |
|---|---|---|
PUT |
https://myaccount.queue.core.windows.net/myqueue |
HTTP/1.1 |
Emulált tárolási szolgáltatás kérése
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ó |
|---|---|---|
PUT |
http://127.0.0.1:10001/devstoreaccount1/myqueue |
HTTP/1.1 |
További információ: Az Azurite emulátor használata helyi Azure Storage-fejlesztéshez.
URI-paraméterek
Az itt látható módon további paramétereket is megadhat a kérelem URI-ján.
| 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 szolgáltatás műveleteihez. |
Kérésfejlécek
A szükséges és nem kötelező kérésfejléceket az alábbi táblázatban ismertetjük:
| 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ó: Verziószámozás az Azure Storage-szolgáltatásokhoz. |
x-ms-meta-name:value |
Választható. Egy név-érték pár, amely metaadatként társítja az üzenetsort. Megjegyzés: A 2009-09-19-es verziótól a metaadatok nevének meg kell felelnie a C#-azonosítók elnevezési szabályainak. |
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. További információ: Az Azure Queue Storage monitorozása. |
Kérelem 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 201-ben létrehozott á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 tartalmazza az alábbi táblázatban ismertetett fejléceket. 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 |
|---|---|
ms-request-id |
Egyedileg azonosítja a végrehajtott kérést, és a használatával elháríthatja a kérést. További információ: API-műveletek hibaelhárítása. |
x-ms-version |
A kérés végrehajtásához használt Azure Queue Storage-verziót jelzi. A rendszer ezt a fejlécet adja vissza a 2009-09-19-es és újabb verzióval kapcsolatos kérésekhez. |
Date |
A szolgáltatás által létrehozott UTC dátum/idő érték, amely a válasz indításának időpontját jelzi. |
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-karaktert tartalmaz. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, az nem jelenik meg a válaszban. |
Mintaválasz
Response Status:
HTTP/1.1 201 Created
Response Headers:
Transfer-Encoding: chunked
Date: Fri, 16 Sep 2011 01:20:22 GMT
x-ms-version: 2011-08-18
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0
Engedélyezés
Ezt a műveletet csak a fióktulajdonos hívhatja meg.
Megjegyzések
A felhasználó által definiált metaadatokat név-érték párokként adhatja meg az üzenetsoron a létrehozáskor.
Ha már létezik egy megadott nevű üzenetsor, az Azure Queue Storage ellenőrzi a meglévő üzenetsorhoz társított metaadatokat. Ha a meglévő metaadatok megegyeznek a kérelemben megadott metaadatokkal, a Create Queue rendszer a 204-ben megadott állapotkódot (Tartalom nélkül) adja vissza. Ha a meglévő metaadatok nem egyeznek meg a kérésben megadott metaadatokkal Create Queue , a művelet meghiúsul, és a rendszer a 409-ben megadott állapotkódot (Ütközés) adja vissza. Az ügyfelek kihasználhatják ezt a viselkedést, így elkerülhetik a további hívásokat, így ellenőrizhetik, hogy létezik-e már elnevezett üzenetsor.
Az érvényes üzenetsornevekkel kapcsolatos útmutatásért lásd: Névsorok és metaadatok. Ha a megadott üzenetsornév nem érvényes név, a művelet a Create Queue 400-as állapotkódot (Hibás kérelem) adja vissza a további hibainformációkkal együtt, ahogyan az alábbi példában látható:
HTTP/1.1 400 One of the request inputs is out of range.
Connection: Keep-Alive
Content-Length: 226
Via: 1.1 TK5-PRXY-22
Date: Wed, 02 May 2012 17:47:54 GMT
Content-Type: application/xml
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: fda2babe-ffbb-4f0e-a11b-2bfbd871ba9f
x-ms-version: 2011-08-18
<?xml version="1.0" encoding="utf-8"?>
<Error>
<Code>OutOfRangeInput</Code>
<Message>One of the request inputs is out of range.
RequestId:fda2babe-ffbb-4f0e-a11b-2bfbd871ba9f
Time:2012-05-02T17:47:55.4334169Z</Message>
</Error>
Lásd még
Azure Queue-hibakódok
Kérések engedélyezése az Azure Storage-ba
Állapot- és hibakódok