Üzenetsor metaadatainak beállítása
A Set Queue Metadata
művelet felhasználó által definiált metaadatokat állít be a megadott üzenetsoron. A metaadatok név-érték párokként lesznek társítva az üzenetsorhoz.
Kérés
A kérést a Set Queue Metadata
következőképpen hozhatja létre. Javasoljuk, hogy HTTPS-t használjon.
Metódus | Kérés URI-ja | HTTP-verzió |
---|---|---|
PUT |
https://myaccount.queue.core.windows.net/myqueue?comp=metadata |
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 a Queue szolgáltatás portját 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?comp=metadata |
HTTP/1.1 |
További információ: Az Azurite emulátor használata helyi Azure Storage-fejlesztéshez.
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 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ó: Az Azure Storage-szolgáltatások verziószámozása. |
x-ms-meta-name:string-value |
Választható. Egy név-érték pár, amely metaadatként társítja az üzenetsort. A művelet minden hívása lecseréli az üzenetsorhoz csatolt összes meglévő metaadatot. Ha az összes metaadatot el szeretné távolítani az üzenetsorból, hívja meg ezt a műveletet metaadatfejlécek nélkül. 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. |
A kérés törzse
Nincsenek.
Mintakérés
Request Syntax:
PUT https://myaccount.queue.core.windows.net/myqueue?comp=metadata HTTP/1.1
Request Headers:
x-ms-version: 2011-08-18
x-ms-date: Fri, 16 Sep 2011 01:47:14 GMT
x-ms-meta-meta-sample1: sample1
x-ms-meta-meta-sample2: sample2
Authorization: SharedKey myaccount:u6PSIebDltGW5xHpO77epRpiUhcsTkWMvcM4GTmfqqA=
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.
További információ az állapotkódokról: Á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 |
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 végrehajtásához használt Queue service-verziót jelzi. Ez a fejléc a 2009-09-19-es és újabb verzióval kapcsolatos kérések esetén jelenik meg. |
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 |
Ez a fejléc 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. |
Választörzs
Nincsenek.
Engedélyezés
Ezt a műveletet csak a fióktulajdonos hívhatja meg.
Megjegyzések
Az üzenetsor metaadatainak törléséhez a metaadat-fejlécek megadása nélkül hívjon Set Queue Metadata
.
Lásd még
Üzenetsor-szolgáltatás hibakódjai
Kérések engedélyezése az Azure Storage-ba
Állapot- és hibakódok