Créer une file d’attente (Stockage Azure)

  • Article

L’opération Create Queue crée une file d’attente dans un compte de stockage.

Requête

Vous pouvez construire la Create Queue requête comme indiqué ici. Nous vous recommandons d’utiliser HTTPS. Remplacez myaccount par le nom de votre compte de stockage.

Méthode URI de demande Version HTTP
PUT https://myaccount.queue.core.windows.net/myqueue HTTP/1.1

Demande de service de stockage émulée

Lorsque vous effectuez une demande auprès du service de stockage émulé, spécifiez le nom d’hôte de l’émulateur et le port de stockage File d’attente Azure en tant que 127.0.0.1:10001, suivis du nom du compte de stockage émulé :

Méthode URI de demande Version HTTP
PUT http://127.0.0.1:10001/devstoreaccount1/myqueue HTTP/1.1

Pour plus d’informations, consultez Utiliser l’émulateur Azurite à des fins de développement local pour Stockage Azure.

Paramètres URI

Vous pouvez spécifier des paramètres supplémentaires sur l’URI de la demande, comme indiqué ici.

Paramètre Description
timeout facultatif. Le paramètre timeout est exprimé en secondes. Pour plus d’informations, consultez Définir des délais d’attente pour les opérations de service de file d’attente.

En-têtes de requête

Les en-têtes de requête obligatoires et facultatifs sont décrits dans le tableau suivant :

En-tête de requête Description
Authorization Obligatoire. Spécifie le schéma d’autorisation, le nom du compte et la signature. Pour plus d’informations, consultez Autoriser les requêtes auprès du Stockage Azure.
Date ou x-ms-date Obligatoire. Spécifie la date/heure en temps universel coordonné (UTC) pour la requête. Pour plus d’informations, consultez Autoriser les requêtes auprès du Stockage Azure.
x-ms-version Optionnel. Spécifie la version de l'opération à utiliser pour cette demande. Pour plus d’informations, consultez Contrôle de version pour les services de stockage Azure.
x-ms-meta-name:value Optionnel. Une paire nom-valeur à associer à la file d'attente en tant que métadonnées.

Remarque : À compter de la version 2009-09-19, les noms de métadonnées doivent respecter les règles de nommage des identificateurs C#.
x-ms-client-request-id Optionnel. Fournit une valeur opaque générée par le client avec une limite de caractères de 1 kibioctet (Kio) enregistrée dans les journaux lors de la configuration de la journalisation. Nous vous recommandons vivement d’utiliser cet en-tête pour mettre en corrélation les activités côté client avec les demandes que le serveur reçoit. Pour plus d’informations, consultez Surveiller le stockage File d’attente Azure.

Corps de la requête

Aucun.

response

La réponse inclut un code d'état HTTP et un ensemble d'en-têtes de réponse.

Code d’état

Une opération réussie renvoie le code d'état 201 (Créé).

Pour plus d’informations sur les codes status, consultez Codes d’état et d’erreur.

En-têtes de réponse

La réponse à cette opération inclut les en-têtes décrits dans le tableau suivant. La réponse peut également inclure des en-têtes HTTP standard supplémentaires. Tous les en-têtes standard sont conformes à la spécification du protocole HTTP/1.1.

En-tête de réponse Description
ms-request-id Identifie de manière unique la demande qui a été effectuée et vous pouvez l’utiliser pour résoudre la demande. Pour plus d’informations, consultez Résoudre les problèmes liés aux opérations d’API.
x-ms-version Indique la version de Stockage File d’attente Azure utilisée pour exécuter la demande. Cet en-tête est renvoyé pour les demandes effectuées avec la version 2009-09-19 ou une version ultérieure.
Date Valeur de date/heure UTC générée par le service et qui indique l’heure à laquelle la réponse a été lancée.
x-ms-client-request-id Peut être utilisé pour résoudre les problèmes liés aux demandes et aux réponses correspondantes. La valeur de cet en-tête est égale à la valeur de l’en-tête x-ms-client-request-id s’il est présent dans la requête et que la valeur ne contient pas plus de 1 024 caractères ASCII visibles. Si l’en-tête x-ms-client-request-id n’est pas présent dans la demande, il ne sera pas présent dans la réponse.

Exemple de réponse

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Transfer-Encoding: chunked  
Date: Fri, 16 Sep 2011 01:20:22 GMT  
x-ms-version: 2011-08-18  
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0

Autorisation

Seul le propriétaire du compte peut appeler cette opération.

Notes

Vous pouvez spécifier des métadonnées définies par l’utilisateur en tant que paires nom-valeur dans la file d’attente lorsque vous la créez.

Si une file d’attente portant le nom spécifié existe déjà, le Stockage File d’attente Azure vérifie les métadonnées associées à la file d’attente existante. Si les métadonnées existantes sont identiques aux métadonnées spécifiées dans la Create Queue demande, status code 204 (Aucun contenu) est retourné. Si les métadonnées existantes ne correspondent pas aux métadonnées fournies avec la Create Queue demande, l’opération échoue et status code 409 (Conflit) est retourné. Les clients peuvent tirer parti de ce comportement pour éviter un appel supplémentaire à case activée pour voir si une file d’attente nommée existe déjà.

Pour obtenir des conseils sur les noms de file d’attente valides, consultez Files d’attente de noms et métadonnées. Si le nom de file d’attente spécifié n’est pas un nom valide, l’opération Create Queue retourne status code 400 (requête incorrecte), ainsi que des informations d’erreur supplémentaires, comme illustré dans l’exemple suivant :

HTTP/1.1 400 One of the request inputs is out of range.  
Connection: Keep-Alive  
Content-Length: 226  
Via: 1.1 TK5-PRXY-22  
Date: Wed, 02 May 2012 17:47:54 GMT  
Content-Type: application/xml  
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: fda2babe-ffbb-4f0e-a11b-2bfbd871ba9f  
x-ms-version: 2011-08-18  
  
<?xml version="1.0" encoding="utf-8"?>  
<Error>  
   <Code>OutOfRangeInput</Code>  
   <Message>One of the request inputs is out of range.  
   RequestId:fda2babe-ffbb-4f0e-a11b-2bfbd871ba9f  
   Time:2012-05-02T17:47:55.4334169Z</Message>  
</Error>

Voir aussi

Codes d’erreur de file d’attente Azure
Autoriser les demandes dans le Stockage Azure
Codes d’état et d’erreur