Elővizsgálati várólista-kérelem

A Preflight Queue Request művelet lekérdezi az Azure Queue Storage forrásközi erőforrás-megosztási (CORS) szabályait a kérés elküldése előtt.

Egy webböngésző vagy egy másik felhasználói ügynök előzetes kérést küld, amely tartalmazza az ügynök által elkérni kívánt kérés forrástartományát, metódusát és fejléceit. Ha a CORS engedélyezve van a Queue Storage-hoz, akkor a Queue Storage kiértékeli az elővizsgálati kérelmet a fióktulajdonos által a Queue Service tulajdonságainak beállításával konfigurált CORS-szabályok alapján. A Queue Storage ezután elfogadja vagy elutasítja a kérést.

A CORS-ról és az elővizsgálati kérelemről az Azure Storage CORS-specifikációját és CORS-támogatását ismertető cikkben talál további információt.

Kérés

A következő módon adhatja meg Preflight Queue Request . Cserélje le a <account-name> kifejezést a tárfiókja nevére. Cserélje le <queue-resource> a elemet annak az üzenetsor-erőforrásnak a nevére, amely a kérés célja lesz.

HTTP-parancs	Kérés URI-ja	HTTP-verzió
OPTIONS	http://<account-name> .queue.core.windows.net/<queue-resource>	HTTP/1.1

Az URI-nak mindig tartalmaznia kell a perjelet (/), hogy elkülönítse a gazdagép nevét az URI elérési útjától és lekérdezési részeitől. Ebben a műveletben az URI elérési útja üres lehet, vagy bármely üzenetsor-erőforrásra mutathat.

Előfordulhat, hogy az erőforrás az elővizsgálati kérés időpontjában létezik vagy sem. A rendszer a szolgáltatás szintjén értékeli ki az elővizsgálati kérést a szolgáltatás CORS-szabályai alapján, így az erőforrásnév jelenléte vagy hiánya nem befolyásolja a művelet sikerességét vagy sikertelenségét.

URI-paraméterek

Nincsenek.

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
Origin	Kötelező. Meghatározza, hogy a kérelem melyik forrásból lesz kibocsátva. A rendszer ellenőrzi a forrást a szolgáltatás CORS-szabályaival, hogy megállapítsa az elővizsgálati kérés sikerességét vagy sikertelenségét.
Access-Control-Request-Method	Kötelező. A kérelem metódusát (vagy HTTP-parancsát) adja meg. A rendszer ellenőrzi a metódust a szolgáltatás CORS-szabályaival, hogy megállapítsa az elővizsgálati kérelem hibáját vagy sikerességét.
Access-Control-Request-Headers	Választható. Megadja az elküldendő kérelemfejléceket. Ha nincs jelen, a szolgáltatás feltételezi, hogy a kérés nem tartalmaz fejléceket.

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 200-ra (OK) vonatkozó á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.

Az előzetes kérelemfejlécekkel kapcsolatos részletekért lásd a CORS specifikációját.

Válaszfejléc	Description
Access-Control-Allow-Origin	Az engedélyezett forrást jelzi, amely megfelel a kérelem forrásfejlécének, ha az elővizsgálati kérelem sikeres.
Access-Control-Allow-Methods	Ha az elővizsgálati kérelem sikeres, ez a fejléc a kérelemfejléchez Access-Control-Request-Methodmegadott értékre vagy értékekre van állítva.
Access-Control-Allow-Headers	Ha az elővizsgálati kérelem sikeres, ez a fejléc a kérelemfejléchez Access-Control-Request-Headersmegadott értékre vagy értékekre van állítva.
Access-Control-Max-Age	Megadja, hogy a felhasználói ügynök mennyi ideig gyorsítótárazhatja a jövőbeli kérések elővizsgálati kérését.
Access-Control-Allow-Credentials	Azt jelzi, hogy a kérést hitelesítő adatokkal lehet-e elvégezni. Ez a fejléc mindig a következőre truevan állítva: .

Választörzs

Nincsenek.

Engedélyezés

A Preflight Queue Request művelet mindig névtelenül fut. Nem igényel engedélyezést, és figyelmen kívül hagyja a hitelesítő adatokat, ha meg vannak adva.

Megjegyzés

Ha engedélyezte az Azure Storage-elemzést, és metrikákat naplóz, a rendszer a Preflight Queue Request művelet hívását a következőként AnonymousSuccessnaplózza: . Ezért ha a Azure Portal metrikáit tekinti meg, a naplózott érték jelenik megAnonymousSuccess.Preflight Queue Request Ez a metrika nem azt jelzi, hogy a privát adatok biztonsága sérült, de csak azt, hogy a Preflight Queue Request művelet 200-ra (OK) vonatkozó állapotkóddal sikeres volt.

Mintakérés és válasz

Az alábbi példa egy előzetes kérést küld a forráshoz www.contoso.com. A kérelemmetódus értéke PUT, a kérelemfejlécek pedig a és acceptértékre content-type vannak állítva.

OPTIONS http://myaccount.queue.core.windows.net/myqueue  HTTP/1.1  
Accept: */*  
Origin: www.contoso.com  
Access-Control-Request-Method: PUT  
Access-Control-Request-Headers: content-type, accept  
Accept-Encoding: gzip, deflate  
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.2; WOW64; Trident/6.0)  
Content-Length: 0  
  

A válasz azt jelzi, hogy a CORS engedélyezve van a szolgáltatáshoz, és hogy a CORS-szabály megfelel az elővizsgálati kérésnek:

HTTP/1.1 200 OK  
Connection: Keep-Alive  
Content-Length: 0  
Content-Type: text/html; charset=UTF-8  
Access-Control-Allow-Origin: *  
Access-Control-Max-Age: 60  
Access-Control-Allow-Methods: PUT  
Access-Control-Allow-Headers: accept,content-type  
  

Megjegyzések

Ha a CORS engedélyezve van a szolgáltatáshoz, és egy CORS-szabály megfelel az elővizsgálati kérésnek, a szolgáltatás a 200 -os állapotkóddal (OK) válaszol az elővizsgálati kérelemre. A válasz tartalmazza a szükséges Access-Control fejléceket. Ebben az esetben a kérelem számlázása történik.

Ha a CORS nincs engedélyezve, vagy egyetlen CORS-szabály sem felel meg az elővizsgálati kérésnek, a szolgáltatás a 403-at (Tiltott) állapotkóddal válaszolja meg. Ebben az esetben a kérelem számlázása nem történik meg.

Ha a OPTIONS kérés helytelen, a szolgáltatás a 400-ás állapotkóddal válaszol (hibás kérelem), és a kérés nem lesz számlázva. A hibásan formázott kérelmekre példa az, amely nem tartalmazza a szükséges Origin és Access-Control-Request-Method a fejléceket.

Az elővizsgálati kérelem egy olyan mechanizmus, amely lekérdezi egy adott tárfiókhoz társított tárolási szolgáltatás CORS-képességét. Az elővizsgálati kérés nem egy adott erőforrásra irányul.

Lásd még

A fiók műveletei (Queue Storage)
CORS-támogatás az Azure Storage-hoz