Voorbereidende tabelaanvraag

Tijdens de Preflight Table Request bewerking worden de CORS-regels (Cross-Origin Resource Sharing) voor Azure Table Storage opgevraagd voordat de aanvraag wordt verzonden.

Een webbrowser of een andere gebruikersagent verzendt een voorbereidende aanvraag met het oorspronkelijke domein, de methode en headers voor de aanvraag die de agent wil maken. Als CORS is ingeschakeld voor Table Storage, evalueert Table Storage de voorbereidende aanvraag op basis van de CORS-regels die de accounteigenaar heeft geconfigureerd via Eigenschappen van tabelservice instellen. Table Storage accepteert of weigert de aanvraag.

Zie de CORS-specificatie en CORS-ondersteuning voor Azure Storage voor meer informatie over CORS en de voorbereidende aanvraag.

Aanvraag

U kunt het volgende opgeven Preflight Table Request . Vervang <account-name> door de naam van uw opslagaccount. Vervang <table-resource> door de naam van de tabelresource die het doel van de aanvraag is.

HTTP-woord	Aanvraag-URI	HTTP-versie
OPTIONS	http://<account-name> .table.core.windows.net/<table-resource>	HTTP/1.1

De URI moet altijd de slash (/) bevatten om de hostnaam van het pad en de querygedeelten van de URI te scheiden. In het geval van deze bewerking kan het padgedeelte van de URI leeg zijn of kan deze verwijzen naar een tabelresource.

De resource bestaat al dan niet op het moment dat de voorbereidende aanvraag wordt ingediend. De voorbereidende aanvraag wordt op serviceniveau geëvalueerd op basis van de CORS-regels van de service, dus de aanwezigheid of afwezigheid van de resourcenaam heeft geen invloed op het slagen of mislukken van de bewerking.

URI-parameters

Geen.

Aanvraagheaders

In de volgende tabel worden de vereiste en optionele aanvraagheaders beschreven:

Aanvraagheader	Beschrijving
Origin	Vereist. Hiermee geeft u de oorsprong 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-woord) voor de aanvraag op. De methode wordt gecontroleerd op basis van de CORS-regels van de service om de fout of het 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, wordt ervan uitgegaan dat de aanvraag geen headers bevat.

Aanvraagbody

Geen.

Antwoord

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Statuscode

Een geslaagde bewerking retourneert statuscode 200 (OK).

Zie Status en foutcodes voor meer informatie over statuscodes.

Antwoordheaders

Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord bevat mogelijk ook extra standaard HTTP-headers. Alle standaardheaders voldoen aan de http/1.1-protocolspecificatie.

Zie de CORS-specificatie voor meer informatie over headers voor voorbereidende aanvragen.

Antwoordheader	Description
Access-Control-Allow-Origin	Geeft de toegestane oorsprong aan, die overeenkomt met de oorspronkelijke 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 de tijdsduur op waarop 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 Table Request bewerking wordt altijd anoniem uitgevoerd. Er is geen autorisatie vereist en referenties worden genegeerd als ze worden opgegeven.

Notitie

Als u Azure Storage-analyses hebt ingeschakeld en metrische gegevens voor logboekregistratie gebruikt, wordt een aanroep naar de Preflight Table Request bewerking geregistreerd als AnonymousSuccess. Als u daarom metrische gegevens bekijkt in de Azure Portal, ziet AnonymousSuccess u geregistreerd voor Preflight Table Request. Deze metrische waarde geeft niet aan dat uw persoonlijke gegevens zijn aangetast, maar alleen dat de Preflight Table Request bewerking is geslaagd met een statuscode van 200 (OK).

Voorbeeldaanvraag 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.table.core.windows.net/mytable  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 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 onjuist is ingedeeld, reageert de service met statuscode 400 (Ongeldige aanvraag) en wordt de aanvraag niet gefactureerd. Een voorbeeld van een onjuist gevormde aanvraag is een aanvraag die niet de vereiste Origin en Access-Control-Request-Method headers 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.

Zie ook

Bewerkingen voor het account (Table Storage)
CORS-ondersteuning voor Azure Storage