Denetim Öncesi Dosya İsteği
İşlem, Preflight File Request
isteği göndermeden önce Azure Dosyalar için Çıkış Noktaları Arası Kaynak Paylaşımı (CORS) kurallarını sorgular.
Web tarayıcısı veya başka bir kullanıcı aracısı, aracının yapmak istediği istek için kaynak etki alanını, yöntemi ve üst bilgileri içeren bir denetim öncesi isteği gönderir. CORS Azure Dosyalar için etkinleştirildiyse, Azure Dosyalar denetim öncesi isteğini hesap sahibinin Dosya Hizmeti Özelliklerini Ayarla aracılığıyla yapılandırdığı CORS kurallarına göre değerlendirir. Azure Dosyalar sonra isteği kabul eder veya reddeder.
CORS ve denetim öncesi isteği hakkında daha fazla bilgi için bkz. Azure Depolama için CORS belirtimi ve CORS desteği.
Protokol kullanılabilirliği
Etkin dosya paylaşımı protokolü | Kullanılabilir |
---|---|
SMB | |
NFS |
İstek
Aşağıdaki gibi belirtebilirsiniz Preflight File Request
.
<account-name>
değerini depolama hesabınızın adıyla değiştirin. değerini isteğin hedefi olacak paylaşım, dizin veya dosya kaynağıyla değiştirin <file-resource>
.
HTTP fiili | İstek URI'si | HTTP sürümü |
---|---|---|
OPTIONS |
http://<account-name>.file.core.windows.net/<file-resource> http://<account-name>.file.core.windows.net/<file-resource>?restype=share http://<account-name>.file.core.windows.net/<file-resource>?restype=directory |
HTTP/1.1 |
Ana bilgisayar adını URI'nin yolundan ve sorgu bölümlerinden ayırmak için URI her zaman eğik çizgiyi (/) içermelidir. Bu işlem söz konusu olduğunda, URI'nin yol kısmı boş olabilir veya herhangi bir Azure Dosyalar kaynağına işaret edebilir. Azure Dosyalar kaynağı bir paylaşım veya dizinse sorgu restype
parametresi gereklidir.
Kaynak, denetim öncesi isteğinin yapıldığı sırada mevcut olabilir veya olmayabilir. Denetim öncesi isteği hizmet düzeyinde hizmetin CORS kurallarına göre değerlendirilir, bu nedenle kaynak adının varlığı veya olmaması işlemin başarısını veya başarısızlığını etkilemez.
URI parametreleri
Yok.
İstek üst bilgileri
Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadır:
İstek üst bilgisi | Açıklama |
---|---|
Origin |
Gereklidir. İsteğin yayımlandığı kaynağı belirtir. Çıkış noktası, denetim öncesi isteğinin başarısını veya başarısızlığını belirlemek için hizmetin CORS kurallarına göre denetlenır. |
Access-Control-Request-Method |
Gereklidir. İstek için yöntemini (veya HTTP fiilini) belirtir. Yöntemi, denetim öncesi isteğinin başarısızlığını veya başarısını belirlemek için hizmetin CORS kurallarına göre denetlenmektedir. |
Access-Control-Request-Headers |
İsteğe bağlı. Gönderilecek istek üst bilgilerini belirtir. Hizmet yoksa, isteğin üst bilgileri içermediğini varsayar. |
x-ms-allow-trailing-dot: { <Boolean> } |
İsteğe bağlı. Sürüm 2022-11-02 ve üzeri. Boole değeri, istek URL'sinde sondaki bir noktanın kırpılıp kırpılmaması gerektiğini belirtir. Daha fazla bilgi için bkz . Paylaşımları, dizinleri, dosyaları ve meta verileri adlandırma ve buna başvurma. |
İstek gövdesi
Yok.
Yanıt
Yanıt bir HTTP durum kodu ve bir dizi yanıt üst bilgisi içerir.
Durum kodu
Başarılı bir işlem 200 (Tamam) durum kodunu döndürür.
Yanıt üst bilgileri
Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.
Denetim öncesi istek üst bilgileri hakkında ayrıntılı bilgi için CORS belirtimine bakın.
Yanıt üst bilgisi | Description |
---|---|
Access-Control-Allow-Origin |
Denetim öncesi isteği başarılı olursa istekteki kaynak üst bilgisi ile eşleşen izin verilen kaynağı gösterir. |
Access-Control-Allow-Methods |
Denetim öncesi isteği başarılı olursa, bu üst bilgi istek üst bilgisi Access-Control-Request-Method için belirtilen değere veya değerlere ayarlanır. |
Access-Control-Allow-Headers |
Denetim öncesi isteği başarılı olursa, bu üst bilgi istek üst bilgisi Access-Control-Request-Headers için belirtilen değere veya değerlere ayarlanır. |
Access-Control-Max-Age |
Kullanıcı aracısının gelecekteki istekler için denetim öncesi isteğini önbelleğe almasına izin verilen süreyi belirtir. |
Access-Control-Allow-Credentials |
İsteğin kimlik bilgileri aracılığıyla yapılıp yapılamayacağını gösterir. Bu üst bilgi her zaman olarak true ayarlanır. |
Yanıt gövdesi
Yok.
Yetkilendirme
İşlem Preflight File Request
her zaman anonim olarak yürütülür. Yetkilendirme gerektirmez ve kimlik bilgileri sağlandıysa yoksayar.
Not
Azure Depolama analizini etkinleştirdiyseniz ve ölçümleri günlüğe kaydederseniz, işleme yönelik Preflight File Request
bir çağrı olarak AnonymousSuccess
günlüğe kaydedilir. Bu nedenle, ölçümleri Azure portal görüntülerseniz için Preflight File Request
günlüğe kaydedilen öğesini görürsünüzAnonymousSuccess
. Bu ölçüm, özel verilerinizin gizliliğinin ihlal edildiğini göstermez, yalnızca işlemin 200 durum koduyla başarılı olduğunu Preflight File Request
gösterir (Tamam).
Örnek istek ve yanıt
Aşağıdaki örnek, kaynağı www.contoso.com
için bir denetim öncesi isteği gönderir. İstek yöntemi olarakPUT
, istek üst bilgileri ise ve accept
olarak content-type
ayarlanır.
OPTIONS http://myaccount.file.core.windows.net/myshare/myfile
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
Yanıt, HIZMET için CORS'nin etkinleştirildiğini ve bir CORS kuralının denetim öncesi isteğiyle eşleşdiğini gösterir:
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
Açıklamalar
Hizmet için CORS etkinleştirildiyse ve cors kuralı denetim öncesi isteğiyle eşleşiyorsa, hizmet denetim öncesi isteğine 200 durum koduyla yanıt verir (Tamam). Yanıt gerekli Access-Control
üst bilgileri içerir. Bu durumda istek faturalandırılır.
CORS etkin değilse veya hiçbir CORS kuralı denetim öncesi isteğiyle eşleşmiyorsa, hizmet 403 (Yasak) durum koduyla yanıt verir. Bu durumda istek faturalandırılmaz.
OPTIONS
İstek yanlış biçimlendirilmişse, hizmet durum kodu 400 (Hatalı İstek) ile yanıt verir ve istek faturalanmaz. Hatalı biçimlendirilmiş isteklere örnek olarak gerekli Origin
ve Access-Control-Request-Method
üst bilgileri içermeyen istekler örnek olarak gösterilir.
Denetim öncesi isteği, belirli bir depolama hesabıyla ilişkili bir depolama hizmetinin CORS özelliğini sorgulamaya yönelik bir mekanizmadır. Denetim öncesi isteği belirli bir kaynağı hedeflemiyor.