預檢佇列要求

發行項
06/27/2023

作業會在 Preflight Queue Request 傳送要求之前，先查詢 Azure 佇列儲存體的跨原始來源資源分享 (CORS) 規則。

網頁瀏覽器或其他使用者代理程式會傳送預檢要求，其中包含代理程式想要提出之要求的源網域、方法和標頭。如果已啟用佇列儲存體的 CORS，則佇列儲存體會根據帳戶擁有者透過設定佇列服務屬性所設定的 CORS 規則評估預檢要求。佇列儲存體接著會接受或拒絕要求。

如需 CORS 和預檢要求的詳細資訊，請參閱Azure 儲存體的 CORS 規格和 CORS 支援。

要求

您可以指定 Preflight Queue Request 如下。使用您的儲存體帳戶名稱取代 <account-name>。將取代 <queue-resource> 為將做為要求目標的佇列資源名稱。

HTTP 指令動詞	要求 URI	HTTP 版本
`OPTIONS`	`http://<account-name> .queue.core.windows.net/<queue-resource>`	HTTP/1.1

URI 必須一律包含正斜線 (/) ，以分隔主機名稱與 URI 的路徑和查詢部分。在此作業的情況下，URI 的路徑部分可以是空的，也可以指向任何佇列資源。

資源在提出預檢要求時可能或可能不存在。預檢要求會根據服務的 CORS 規則，在服務層級進行評估，因此存在或缺少資源名稱不會影響作業的成功或失敗。

URI 參數

無。

要求標頭

下表描述必要和選擇性的要求標頭：

要求標頭	描述
`Origin`	必要。指定發出要求的來源。系統會根據服務的 CORS 規則檢查此來源以判斷預檢要求成功或失敗。
`Access-Control-Request-Method`	必要。指定要求的方法 (或 HTTP 動詞) 。系統會根據服務的 CORS 規則檢查此方法以判斷預檢要求失敗或成功。
`Access-Control-Request-Headers`	選擇性。指定將傳送的要求標頭。如果不存在，服務會假設要求不包含標頭。

要求本文

無。

回應

回應包括 HTTP 狀態碼和一組回應標頭。

狀態碼

成功的作業會傳回狀態碼 200 (OK)。

如需狀態碼的相關資訊，請參閱狀態和錯誤碼。

回應標頭

這項作業的回應包括下列標頭。回應也可能包含其他標準 HTTP 標頭。所有標準標頭都符合 HTTP/1.1 通訊協定規格。

如需預檢要求標頭的詳細資訊，請參閱 CORS 規格。

回應標頭	描述
`Access-Control-Allow-Origin`	指出允許的原點，如果預檢要求成功，則符合要求中的源標頭。
`Access-Control-Allow-Methods`	如果預檢要求成功，此標頭會設定為為要求標頭 `Access-Control-Request-Method` 所指定的值或值。
`Access-Control-Allow-Headers`	如果預檢要求成功，此標頭會設定為為要求標頭 `Access-Control-Request-Headers` 所指定的值或值。
`Access-Control-Max-Age`	指定允許使用者代理程式快取未來要求的預檢要求的時間長度。
`Access-Control-Allow-Credentials`	指出是否可以透過認證提出要求。此標頭一律設定為 `true`。

回應本文

無。

授權

作業 Preflight Queue Request 一律會匿名執行。它不需要授權，而且會在提供認證時忽略認證。

注意

如果您已啟用 Azure 儲存體分析並記錄計量，則會將作業的呼叫 Preflight Queue Request 記錄為 AnonymousSuccess 。基於這個理由，如果您在Azure 入口網站中檢視計量，您會看到 AnonymousSuccess 記錄的 Preflight Queue Request 。此計量不會指出您的私人資料已遭入侵，但只有 Preflight Queue Request 作業成功，狀態碼為 200 (OK) 。

範例要求與回應

下列範例會傳送來源 www.contoso.com 的預檢要求。要求方法會設定為 PUT ，而要求標頭會設定為 content-type 和 accept 。

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

回應指出服務已啟用 CORS，且 CORS 規則符合預檢要求：

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

備註

如果已啟用服務的 CORS，且 CORS 規則符合預檢要求，服務會回應狀態碼為 200 (OK) 的預檢要求。回應包含所需的 Access-Control 標頭。在此情況下，要求會計費。

如果未啟用 CORS 或 CORS 規則不符合預檢要求，服務會以狀態碼 403 (禁止) 回應。在此情況下，要求不會計費。

OPTIONS如果要求格式不正確，服務會以狀態碼 400 (不正確的要求) 回應，且不會收取要求的費用。格式錯誤的要求範例是不包含必要 Origin 和 Access-Control-Request-Method 標頭的要求。

預檢要求是一種機制，可查詢與特定儲存體帳戶相關聯的儲存體服務 CORS 功能。預檢要求不會針對特定資源。

另請參閱

帳戶上的作業 (佇列儲存體)
Azure 儲存體的 CORS 支援

共用方式為