Création de file d'attente
Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Création de file d'attente

 

Le Create Queue opération crée une file d'attente sous le compte donné.

Le Create Queue demande peut être construite comme suit. HTTPS est recommandé. Remplacez myaccount avec 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

Lorsque vous élaborez une demande auprès du service de stockage émulé, spécifiez le nom d'hôte de l'émulateur et le port de service de file d'attente en tant que 127.0.0.1:10001, suivie du nom de compte de stockage émulé :

Méthode

URI de demande

Version HTTP

PUT

http://127.0.0.1:10001/devstoreaccount1/myqueue

HTTP/1.1

Les paramètres supplémentaires suivants peuvent être spécifiés dans l'URI de la demande.

Paramètre

Description

timeout

Facultatif. Le timeout paramètre est exprimé en secondes. Pour plus d'informations, consultez Définition de délais d'expiration pour les opérations du service de File d'attente.

Le tableau suivant décrit les en-têtes de demande obligatoires ou facultatifs.

En-tête de demande

Description

Authorization

Obligatoire. Spécifie le schéma d'authentification, le nom du compte et la signature. Pour plus d'informations, consultez Authentification pour les services Azure Storage.

Masquer ou restaurer les mises à jour

Obligatoire. Spécifie le temps universel coordonné (UTC) pour la demande. Pour plus d'informations, consultez Authentification pour les services Azure Storage.

x-ms-version

Facultatif. Spécifie la version de l'opération à utiliser pour cette demande. Pour plus d'informations, consultez Contrôle de version des services BLOB, de File d'attente et de Table dans Windows Azure.

x-ms-meta-name:value

Facultatif. Une paire nom-valeur à associer à la file d'attente en tant que métadonnées.

Notez que depuis la version 2009-09-19, les noms de métadonnées doivent respecter les règles d'affectation de noms identificateurs c#.

x-ms-client-request-id

Facultatif. Fournit une valeur opaque générée par le client avec une limite de caractère de 1 Ko enregistrée dans les journaux d'analyse lorsque la journalisation de l'analyse de stockage est activée. L'utilisation de cet en-tête est fortement recommandée pour une corrélation des activités du côté client avec les requêtes reçues par le serveur. Pour plus d'informations, consultez À propos de la journalisation Storage Analytics et journalisation Azure : à l'aide de journaux pour suivre les demandes de stockage.

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

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

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

La réponse de l'opération inclut les en-têtes suivants. La réponse peut aussi 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

Cet en-tête identifie de façon unique la demande qui a été effectuée et peut être utilisé pour résoudre les problèmes de la demande. Pour plus d'informations, consultez Dépannage des opérations de l'API.

x-ms-version

Indique la version du service de File d'attente utilisé 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

Une valeur de date/heure UTC générée par le service qui indique le moment auquel la réponse a été initiée.

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

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

Vous pouvez spécifier des métadonnées définies par l'utilisateur comme paires nom-valeur dans la file d'attente au moment de sa création.

Lorsqu'une file d'attente avec le nom spécifié existe déjà, le service de File d'attente 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 sur la Create Queue demande, le code d'état 204 (aucun contenu) est retournée. Si les métadonnées existantes ne correspond pas aux métadonnées fournies avec le Create Queue demande, l'opération échoue et le code d'état 409 (conflit) est retournée. Les clients peuvent tirer parti de ce comportement pour éviter un appel supplémentaire afin de vérifier si une file d'attente nommée existe déjà.

Pour obtenir des conseils sur les noms de file d'attente valides, consultez Affectation de noms pour les files d'attente et les métadonnées. Si le nom de la file d'attente spécifiée n'est pas un nom valide, le Create Queue opération retourne le code d'état 400 (demande 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>
Afficher:
© 2016 Microsoft