Esporta (0) Stampa
Espandi tutto

Richiesta coda preliminare

Aggiornamento: novembre 2014

L'operazione Preflight Queue Request consente di eseguire una query sulle regole CORS per il servizio di accodamento prima dell'invio della richiesta effettiva. Attraverso un Web browser o un altro agente utente viene inviata una richiesta preliminare che include il dominio, il metodo e le intestazioni di origine per la richiesta effettiva che l'agente desidera effettuare. Se è abilitata la condivisione CORS per il servizio di accodamento, la richiesta preliminare viene confrontata con le regole CORS configurate dal proprietario dell'account tramite la procedura Set Queue Service Properties e viene accettata o negata.

Per ulteriori informazioni sulla condivisione CORS e la richiesta preliminare, vedere la specifica CORS e Supporto della condivisione delle risorse tra le origini (CORS) per i servizi di archiviazione Azure

La richiesta Preflight Queue Request può essere specificata come indicato di seguito. Sostituire <account-name> con il nome dell'account di archiviazione. Sostituire <queue-resource> con il nome della risorsa coda che deve costituire la destinazione della richiesta effettiva:

 

Verbo HTTP URI richiesta Versione HTTP

OPTIONS

http://<account-name> .queue.core.windows.net/<queue-resource>

HTTP/1.1

Si noti che l'URI deve sempre includere la barra (/) per separare il nome host dal percorso e dalle parti di una query dell'URI. Nel caso di questa operazione, la parte del percorso dell'URI può essere vuota oppure può puntare a qualsiasi risorsa coda. La risorsa può esistere o meno all'atto della richiesta preliminare; quest'ultima viene valutata a livello del servizio in base alle regole CORS del servizio, pertanto la presenza o meno del nome della risorsa non influisce sull'esito positivo o negativo dell'operazione.

Nessuno.

Nella tabella seguente vengono descritte le intestazioni di richiesta obbligatorie e facoltative.

 

Intestazione della richiesta Descrizione

Origin

Obbligatorio. Specifica l'origine da cui proviene la richiesta effettiva. L'origine viene confrontata con le regole CORS del servizio per determinare l'esito positivo o negativo della richiesta preliminare.

Access-Control-Request-Method

Obbligatorio. Specifica il metodo (o verbo HTTP) per la richiesta effettiva. Il metodo viene confrontato con le regole CORS del servizio per determinare l'esito positivo o negativo della richiesta preliminare.

Access-Control-Request-Headers

Facoltativo. Specifica le intestazioni per le intestazioni della richiesta effettiva che saranno inviate. Il servizio presuppone quindi che non venga inviata alcuna intestazione con la richiesta effettiva.

Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.

Un'operazione completata correttamente restituisce il codice di stato 200 (OK).

Per informazioni sui codici di stato, vedere Codici ed errori di stato.

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; inoltre, possono essere incluse intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.

Per informazioni dettagliate sulle intestazioni della richiesta preliminare, vedere la specifica CORS.

 

Intestazione della risposta Descrizione

Controllo-di-accesso-Consenti-origine

Origine concessa, che corrisponde all'intestazione di origine nella richiesta se la richiesta preliminare ha avuto esito positivo.

Controllo-di-accesso-Consenti-metodi

Se le richieste preliminari hanno esito positivo, questa intestazione è impostata sul valore o sui valori specificati per l'intestazione Controllo-di-accesso-Consenti-metodo.

Controllo-di-accesso-Consenti-intestazioni

Se la richiesta preliminare ha esito positivo, questa intestazione è impostata sul valore o sui valori specificati per l'intestazione Controllo-di-accesso-Consenti-intestazioni.

Controllo-di-accesso-Durata-massima

Specifica il tempo consentito all'agente utente per memorizzare nella cache la richiesta preliminare per future richieste.

Controllo-di-accesso-Consenti-credenziali

Indica se è possibile effettuare la richiesta utilizzando delle credenziali. Questa intestazione è sempre impostata su true.

Con l'operazione Preflight Queue Request è possibile autenticare qualsiasi richiesta che include intestazioni di autenticazione adeguate o una firma di accesso condiviso (SAS).

Le richieste non autenticate anonime saranno elaborate indipendentemente dall'esistenza o meno della risorsa, poiché le richieste preliminari OPTIONS vengono valutate rispetto alle impostazioni del servizio account.

Nell'esempio seguente viene inviata una richiesta preliminare per l'origine www.contoso.com, con il metodo di richiesta impostato su PUT e le intestazioni della richiesta impostate su content-type e 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 

La risposta indica che la condivisione CORS è abilitata per il servizio e che la regola CORS corrisponde alla richiesta preliminare.

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 

Se la condivisione CORS è abilitata per il servizio ed è presente una regola CORS che corrisponde alla richiesta preliminare, il servizio risponde alla richiesta preliminare con il codice di stato 200 (OK). Nella richiesta sono incluse le intestazioni Access-Control obbligatorie. In questo caso, la richiesta verrà addebitata.

Se la condivisione CORS non è abilitata o non è presente alcuna regola CORS corrispondente alla richiesta preliminare, il servizio risponde con il codice di stato 403 (Forbidden). In questo caso, la richiesta non verrà addebitata.

Se la richiesta OPTIONS è in un formato non valido, il servizio risponde con il codice di stato 400 (Bad Request) e la richiesta non viene addebitata. Un esempio di richiesta in formato non valido è quella priva delle intestazioni Origin e Access-Control-Request-Method obbligatorie.

La richiesta preliminare è un meccanismo per indagare sulla capacità di condivisione CORS di un servizio di archiviazione associato a un determinato account di archiviazione. La richiesta preliminare non è indirizzata a una risorsa specifica.

Vedere anche

Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di MSDN. Se si sceglie di partecipare, quando si lascia il sito Web di MSDN verrà visualizzato il sondaggio in linea.

Si desidera partecipare?
Mostra:
© 2015 Microsoft