Partager via


Adressage des ressources du service de file d’attente

Le service de File d'attente expose les ressources suivantes via l'API REST :

  • Compte. Le compte de stockage est une entité identifiée de façon unique au sein du système de stockage. Le compte est l'espace de noms parent pour le service de File d'attente. Toutes les files d'attente sont associées à un compte.

  • File d'attente. Une file d'attente stocke les messages qui peuvent être récupérés par une application cliente ou un service.

  • Messages. Les messages sont du texte encodé en UTF-8 qui peut être la valeur d'un élément XML. Un message peut avoir une taille de 64 Kio.

Syntaxe d'URI de ressource

À chaque ressource correspond un URI de base, qui fait référence à la ressource elle-même.

Pour le compte de stockage, l'URI de base pour les opérations de file d'attente comprend uniquement le nom du compte :

https://myaccount.queue.core.windows.net  

Pour une file d'attente, l'URI de base comprend le nom du compte et le nom de la file d'attente :

https://myaccount.queue.core.windows.net/myqueue  

Pour les messages d'une file d'attente, l'URI de base comprend le nom du compte, le nom de la file d'attente et l'ensemble des messages dans cette file d'attente :

https://myaccount.queue.core.windows.net/myqueue/messages  

Un message individuel peut être mis à jour ou supprimé en faisant référence à l'ID du message. Notez que cette syntaxe est disponible uniquement pour les opérations Mettre à jour le message et Supprimer le message et nécessite un popreceipt paramètre pour la vérification :

https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value  

Chaque ressource peut également avoir des composants, qui sont exprimés dans le cadre de la chaîne de requête de l'URI de base. La syntaxe de la chaîne de requête est ?comp=<component_name>. Actuellement, les composants de ressource suivants sont disponibles pour les ressources de file d'attente, en tant que paramètres de l'URI.

Composant Ressources prises en charge Description
list Compte Énumère les entités sous cette ressource. Dans le compte, renvoie la liste des files d'attente.
metadata File d'attente Définit ou renvoie les propriétés de file d'attente, notamment les métadonnées définies par l'utilisateur.

Notez que toutes les valeurs pour les paramètres de requête doivent être encodées avec une URL avant d'être envoyées aux services de stockage Azure.

Opérations HTTP prises en charge

Chaque ressource prend en charge les opérations basées sur les verbes HTTP GET, PUT, HEAD et DELETE. Le verbe, la syntaxe et les versions HTTP prises en charge pour chaque opération s'affichent dans la page de référence pour chaque opération. Pour obtenir la liste complète des pages de référence d’opération, consultez API REST du service de file d’attente.

Voir aussi

Affectation de noms pour les files d’attente et les métadonnées
Opérations sur les files d'attente
Opérations sur les messages
API REST du service File d’attente