Demande de file d'attente préliminairePreflight Queue Request

L'opération Preflight Queue Request interroge les règles de partage de ressources cross-origine (CORS) du service de File d'attente avant d'envoyer la demande réelle.The Preflight Queue Request operation queries the Cross-Origin Resource Sharing (CORS) rules for the Queue service prior to sending the actual request. Un navigateur Web ou un agent utilisateur différent envoie une demande préliminaire qui comprend le domaine d'origine, la méthode et les en-têtes de la demande réelle que l'agent souhaite élaborer.A web browser or another user agent sends a preflight request that includes the origin domain, method, and headers for the actual request that the agent wishes to make. Si CORS est activé pour le service De file d’attente, le service Queue évalue la demande de prévol par rapport aux règles corS que le propriétaire du compte a configurées via Set Queue Service Properties, et accepte ou rejette la demande.If CORS is enabled for the Queue service, then the Queue service evaluates the preflight request against the CORS rules that the account owner has configured via Set Queue Service Properties, and accepts or rejects the request.

Pour plus d’informations sur le CORS et la demande de prévol, consultez les spécifications corS et le support CORS pour les services de stockageFor more information about CORS and the preflight request, see the CORS specification and CORS Support for the Storage Services

RequêteRequest

La demande Preflight Queue Request peut être spécifiée comme suit.The Preflight Queue Request may be specified as follows. Remplacez <account-name> par le nom de votre compte de stockage.Replace <account-name> with the name of your storage account. Remplacez <queue-resource> par le nom de la ressource de file d'attente qui doit être la cible de la demande réelle :Replace <queue-resource> with the name of the queue resource that is to be the target of the actual request:

Verbe HTTPHTTP Verb URI de demandeRequest URI Version HTTPHTTP Version
OPTIONSOPTIONS http://<account-name> .queue.core.windows.net/<queue-resource> HTTP/1.1HTTP/1.1

Notez que l'URI doit toujours inclure la barre oblique (/) pour séparer le nom d'hôte du chemin d'accès et les portions de requête de l'URI.Note that the URI must always include the forward slash (/) to separate the host name from the path and query portions of the URI. Dans le cadre de cette opération, la partie chemin d'accès de l'URI peut être vide, ou peut pointer vers n'importe quelle ressource de file d'attente.In the case of this operation, the path portion of the URI can be empty, or can point to any queue resource. La ressource peut ne pas exister lors de l'élaboration de la demande préliminaire ; la demande préliminaire est évaluée au niveau du service par rapport aux règles CORS du service, de façon à ce que la présence ou l'absence du nom de ressource n'affecte pas le succès ou l'échec de l'opération.The resource may or may not exist at the time the preflight request is made; the preflight request is evaluated at the service level against the service's CORS rules, so the presence or absence of the resource name does not affect the success or failure of the operation.

Paramètres URIURI Parameters

Aucun.None.

En-têtes de requêteRequest Headers

Le tableau suivant décrit les en-têtes de demande obligatoires ou facultatifs.The following table describes required and optional request headers.

En-tête de requêteRequest Header DescriptionDescription
Origin Obligatoire.Required. Spécifie l'origine à partir de laquelle la demande actuelle sera émise.Specifies the origin from which the actual request will be issued. L'origine est comparée aux règles CORS du service afin de déterminer le succès ou l'échec de la demande préliminaire.The origin is checked against the service's CORS rules to determine the success or failure of the preflight request.
Access-Control-Request-Method Obligatoire.Required. Spécifie la méthode (ou le verbe HTTP) de la demande réelle.Specifies the method (or HTTP verb) for the actual request. La méthode est comparée aux règles CORS du service afin de déterminer le succès ou l'échec de la demande préliminaire.The method is checked against the service's CORS rules to determine the failure or success of the preflight request.
Access-Control-Request-Headers facultatif.Optional. Spécifie les en-têtes de la demande réelle qui seront envoyés, puis le service suppose qu'aucun en-tête n'est envoyé avec la demande réelle.Specifies the headers for the actual request headers that will be sent, then the service assumes no headers are sent with the actual request.

Corps de la requêteRequest Body

Aucun.None.

responseResponse

La réponse inclut un code d'état HTTP et un ensemble d'en-têtes de réponse.The response includes an HTTP status code and a set of response headers.

Code d’étatStatus Code

Une opération réussie envoie le code d'état 200 (OK).A successful operation returns status code 200 (OK).

Pour plus d’informations sur les codes de statut, consultez les codes de statut et d’erreur.For information about status codes, see Status and Error Codes.

En-têtes de réponseResponse Headers

La réponse de l'opération inclut les en-têtes suivants.The response for this operation includes the following headers. La réponse peut aussi inclure des en-têtes HTTP standard supplémentaires.The response may also include additional standard HTTP headers. Tous les en-têtes standard sont conformes à la spécification du protocole HTTP/1.1.All standard headers conform to the HTTP/1.1 protocol specification.

Consultez les spécifications corS pour plus de détails sur les en-têtes de demande de prévol.See the CORS specification for details about preflight request headers.

En-tête de réponseResponse Header DescriptionDescription
Accès-Contrôle-Autoriser-OriginAccess-Control-Allow-Origin Origine autorisée, qui correspond à l'en-tête d'origine dans la demande si la demande préliminaire réussit.The allowed origin, which matches the origin header in the request if the preflight request succeeded.
Accès-Contrôle-Autoriser-MéthodesAccess-Control-Allow-Methods Si les demandes préliminaires réussissent, cet en-tête a la ou les valeurs spécifiées pour l'en-tête Access-Control-Request-Method.If the preflight requests succeeds, this header is set to the value or values specified for the request header Access-Control-Request-Method.
Accès-Contrôle-Autoriser-En-têtesAccess-Control-Allow-Headers Si la demande préliminaire réussit, cet en-tête a la ou les valeurs spécifiées pour l'en-tête Access-Control-Request-Headers.If the preflight request succeeds, this header is set to the value or values specified for the request header Access-Control-Request-Headers.
Accès-Contrôle-Max-AgeAccess-Control-Max-Age Spécifie la durée pendant laquelle l'agent utilisateur est autorisée à mettre en cache la demande préliminaire de futures demandes.Specifies the length of time the user agent is allowed to cache the preflight request for future requests.
Accès-Contrôle-Autoriser-CredentialsAccess-Control-Allow-Credentials Indique si la demande réelle peut être effectuée en utilisant des informations d'identification.Indicates whether the actual request can be made using credentials. Cet en-tête a toujours la valeur true.This header is always set to true.

Corps de la réponseResponse Body

Aucun.None.

AutorisationAuthorization

L’opération Preflight Queue Request s’exécute toujours anonymement.The Preflight Queue Request operation always executes anonymously. Il ne nécessite pas d’autorisation et ignore les titres de compétences s’ils sont fournis.It does not require authorization, and ignores credentials if they are provided.

Notes

Si vous avez activé l’analyse de stockage Azure et que Preflight Queue Request vous stockez des mesures, notez qu’un appel à l’opération est enregistré sous forme d’AnonymousSuccess.If you have enabled Azure Storage analytics and are logging metrics, note that a call to the Preflight Queue Request operation is logged as AnonymousSuccess. Pour cette raison, si vous affichez des mesures dans le portail Azure, vous verrez AnonymousSuccess connecté pour Preflight Queue Request.For this reason, if you view metrics in the Azure portal, you will see AnonymousSuccess logged for Preflight Queue Request. Cette mesure n’indique pas que vos données privées Preflight Queue Request ont été compromises, mais seulement que l’opération a réussi avec un code de statut de 200 (OK).This metric does not indicate that your private data has been compromised, but only that the Preflight Queue Request operation succeeded with a status code of 200 (OK).

Exemple de demande et de réponseSample Request and Response

L’exemple suivant envoie une demande avant le vol pour l’origine PUT www.contoso.com, avec la content-type acceptméthode de demande définie et les en-têtes de demande réglés et .The following example sends a preflight request for the origin www.contoso.com, with the request method set to PUT and the request headers set to content-type and 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 réponse indique que les règles CORS sont activées pour le service, et qu'une règle CORS correspond à la demande préliminaire.The response indicates that CORS is enabled for the service, and that a CORS rule matches the preflight request.

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  
  

Notes Remarks

Si les règles CORS sont activées pour le service et qu'une règle CORS correspond à la demande préliminaire, le service répond à la demande préliminaire avec le code d'état 200 (OK).If CORS is enabled for the service and there is a CORS rule that matches the preflight request, the service responds to the preflight request with status code 200 (OK). Cette réponse comprend les en-têtes Access-Control nécessaires.The response includes the required Access-Control headers. Dans ce cas, la demande est facturée.In this case, the request will be billed.

Si les règles CORS ne sont pas activées ou aucune règle CORS ne correspond à la demande préliminaire, le service répond avec le code d'état 403 (Forbidden).If CORS is not enabled or no CORS rule matches the preflight request, the service responds with status code 403 (Forbidden). Dans ce cas, la demande n'est pas facturée.In this case, the request will not be billed.

Si la demande OPTIONS est incorrecte, le service répond avec le code d'état 400 (Bad Request) et la demande n'est pas facturée.If the OPTIONS request is malformed, the service responds with status code 400 (Bad Request) and the request is not billed. Une demande qui ne contient pas les en-têtes Origin et Access-Control-Request-Method nécessaires constitue un exemple de demande incorrecte.An example of a malformed request is one that doesn’t contain the required Origin and Access-Control-Request-Method headers.

Notez que la demande préliminaire est un mécanisme employé pour interroger la capacité CORS d'un service de stockage associé à un compte de stockage spécifique.Note that the preflight request is a mechanism to query the CORS capability of a storage service associated with a certain storage account. La demande préliminaire n'est pas destinée à une ressource spécifique.The preflight request is not targeted to a specific resource.

 Voir aussiSee Also

Opérations sur le compte (Service de file d’attente) Operations on the Account (Queue Service)
Prise en charge du service Partage des ressources cross-origine pour les services de stockageCORS Support for the Storage Services