Voorbereidende bestandsaanvraag
De Preflight File Request bewerking voert een query uit op de CORS-regels (Cross-Origin Resource Sharing) voor Azure Files voordat de aanvraag wordt verzonden.
Een webbrowser of een andere gebruikersagent verzendt een voorbereidende aanvraag die het oorspronkelijke domein, de methode en de headers bevat voor de aanvraag die de agent wil maken. Als CORS is ingeschakeld voor Azure Files, evalueert Azure Files de voorbereidende aanvraag op basis van de CORS-regels die de accounteigenaar heeft geconfigureerd via Eigenschappen van bestandsservice instellen. Azure Files accepteert of weigert vervolgens de aanvraag.
Zie de CORS-specificatie en CORS-ondersteuning voor Azure Storage voor meer informatie over CORS en de voorbereidende aanvraag.
Protocol beschikbaarheid
| Bestandsshareprotocol ingeschakeld | Beschikbaar |
|---|---|
| SMB |  |
| NFS | |
Aanvraag
U kunt als volgt opgeven Preflight File Request . Vervang <account-name> door de naam van uw opslagaccount. Vervang door <file-resource> de share, map of bestandsresource die het doel van de aanvraag is.
| HTTP-woord | Aanvraag-URI | HTTP-versie |
|---|---|---|
OPTIONS |
http://<account-name>.file.core.windows.net/<file-resource>http://<account-name>.file.core.windows.net/<file-resource>?restype=sharehttp://<account-name>.file.core.windows.net/<file-resource>?restype=directory |
HTTP/1.1 |
De URI moet altijd de slash (/) bevatten om de hostnaam te scheiden van de pad- en querygedeelten van de URI. In het geval van deze bewerking kan het padgedeelte van de URI leeg zijn of verwijzen naar een Azure Files resource. Als de Azure Files resource een share of een map is, is de restype queryparameter vereist.
De resource bestaat mogelijk niet op het moment dat de voorbereidende aanvraag wordt gedaan. De voorbereidende aanvraag wordt op serviceniveau geëvalueerd op basis van de CORS-regels van de service, zodat de aanwezigheid of afwezigheid van de resourcenaam geen invloed heeft op het slagen of mislukken van de bewerking.
URI-parameters
Geen.
Aanvraagheaders
In de volgende tabel worden vereiste en optionele aanvraagheaders beschreven:
| Aanvraagheader | Beschrijving |
|---|---|
Origin |
Vereist. Hiermee geeft u de oorsprong op van waaruit de aanvraag wordt uitgegeven. De oorsprong wordt gecontroleerd op basis van de CORS-regels van de service om het slagen of mislukken van de voorbereidende aanvraag te bepalen. |
Access-Control-Request-Method |
Vereist. Hiermee geeft u de methode (of HTTP-werkwoord) voor de aanvraag op. De methode wordt gecontroleerd op basis van de CORS-regels van de service om het mislukken of slagen van de voorbereidende aanvraag te bepalen. |
Access-Control-Request-Headers |
Optioneel. Hiermee geeft u de aanvraagheaders op die worden verzonden. Als deze niet aanwezig is, gaat de service ervan uit dat de aanvraag geen headers bevat. |
x-ms-allow-trailing-dot: { <Boolean> } |
Optioneel. Versie 2022-11-02 en hoger. De Booleaanse waarde geeft aan of een afsluitende punt die aanwezig is in de aanvraag-URL moet worden ingekort of niet. Zie Naamgeving en verwijzingen naar shares, mappen, bestanden en metagegevens voor meer informatie. |
Aanvraagbody
Geen.
Antwoord
Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.
Statuscode
Een geslaagde bewerking retourneert statuscode 200 (OK).
Antwoordheaders
Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook extra standaard-HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.
Zie de CORS-specificatie voor meer informatie over preflight-aanvraagheaders.
| Antwoordheader | Description |
|---|---|
Access-Control-Allow-Origin |
Geeft de toegestane oorsprong aan, die overeenkomt met de origin-header in de aanvraag als de voorbereidende aanvraag slaagt. |
Access-Control-Allow-Methods |
Als de voorbereidende aanvraag slaagt, wordt deze header ingesteld op de waarde of waarden die zijn opgegeven voor de aanvraagheader Access-Control-Request-Method. |
Access-Control-Allow-Headers |
Als de voorbereidende aanvraag slaagt, wordt deze header ingesteld op de waarde of waarden die zijn opgegeven voor de aanvraagheader Access-Control-Request-Headers. |
Access-Control-Max-Age |
Hiermee geeft u op hoe lang de gebruikersagent de voorbereidende aanvraag mag opslaan in de cache voor toekomstige aanvragen. |
Access-Control-Allow-Credentials |
Hiermee wordt aangegeven of de aanvraag kan worden gedaan via referenties. Deze header is altijd ingesteld op true. |
Hoofdtekst van de reactie
Geen.
Autorisatie
De Preflight File Request bewerking wordt altijd anoniem uitgevoerd. Er is geen autorisatie vereist en referenties worden genegeerd als deze worden opgegeven.
Notitie
Als u Azure Storage Analytics hebt ingeschakeld en metrische gegevens wilt vastleggen, wordt een aanroep naar de Preflight File Request bewerking geregistreerd als AnonymousSuccess. Als u daarom metrische gegevens bekijkt in de Azure Portal, ziet AnonymousSuccess u geregistreerd voor Preflight File Request. Deze metrische waarde geeft niet aan dat uw persoonlijke gegevens zijn aangetast, maar alleen dat de Preflight File Request bewerking is geslaagd met de statuscode 200 (OK).
Voorbeeld van aanvraag en antwoord
In het volgende voorbeeld wordt een voorbereidende aanvraag voor de oorsprong www.contoso.comverzonden. De aanvraagmethode is ingesteld op PUTen de aanvraagheaders zijn ingesteld op content-type en accept.
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
Het antwoord geeft aan dat CORS is ingeschakeld voor de service en dat een CORS-regel overeenkomt met de voorbereidende aanvraag:
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
Opmerkingen
Als CORS is ingeschakeld voor de service en een CORS-regel overeenkomt met de voorbereidende aanvraag, reageert de service op de voorbereidende aanvraag met statuscode 200 (OK). Het antwoord bevat de vereiste Access-Control headers. In dit geval wordt de aanvraag gefactureerd.
Als CORS niet is ingeschakeld of als er geen CORS-regel overeenkomt met de voorbereidende aanvraag, reageert de service met statuscode 403 (Verboden). In dit geval wordt de aanvraag niet gefactureerd.
Als de OPTIONS aanvraag een onjuiste indeling heeft, reageert de service met statuscode 400 (Ongeldige aanvraag) en wordt de aanvraag niet gefactureerd. Een voorbeeld van een ongeldige aanvraag is een aanvraag die niet de vereiste Origin headers en Access-Control-Request-Method bevat.
De voorbereidende aanvraag is een mechanisme om een query uit te voeren op de CORS-mogelijkheid van een opslagservice die is gekoppeld aan een bepaald opslagaccount. De voorbereidende aanvraag is niet gericht op een specifieke resource.