Adressage des ressources du service de file d’attenteAddressing Queue Service Resources

Le service de File d'attente expose les ressources suivantes via l'API REST :The Queue service exposes the following resources via the REST API:

  • Compte.Account. Le compte de stockage est une entité identifiée de façon unique au sein du système de stockage.The storage account is a uniquely identified entity within the storage system. Le compte est l'espace de noms parent pour le service de File d'attente.The account is the parent namespace for the Queue service. Toutes les files d'attente sont associées à un compte.All queues are associated with an account.

  • Mis.Queue. Une file d'attente stocke les messages qui peuvent être récupérés par une application cliente ou un service.A queue stores messages that may be retrieved by a client application or service.

  • Messages.Messages. Les messages sont du texte encodé en UTF-8 qui peut être la valeur d'un élément XML.Messages are UTF-8 encoded text that can be the value of an XML element. Un message peut avoir une taille de 64 Kio.A message can be 64 KiB in size.

Syntaxe d'URI de ressourceResource URI Syntax

À chaque ressource correspond un URI de base, qui fait référence à la ressource elle-même.Each resource has a corresponding base URI, which refers to the resource itself.

Pour le compte de stockage, l'URI de base pour les opérations de file d'attente comprend uniquement le nom du compte :For the storage account, the base URI for queue operations includes the name of the account only:

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 :For a queue, the base URI includes the name of the account and the name of the queue:

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 :For messages in a queue, the base URI includes the name of the account, the name of the queue, and the set of messages in that queue:

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.An individual message may be updated or deleted by referring to the message ID. Notez que cette syntaxe est disponible uniquement pour l’opération mettre à jour le message et supprimer le message et nécessite un popreceipt paramètre pour la vérification :Note that this syntax is available only to the Update Message and Delete Message operation and requires a popreceipt parameter for verification:

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.Each resource may also have components, which are expressed as part of the query string on the base URI. La syntaxe de la chaîne de requête est ?comp=<component_name>.The syntax for the query string is ?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.Currently, the following resource components are available for queue resources, as parameters on the URI.

ComposantComponent Ressources prises en chargeSupported resources DescriptionDescription
list CompteAccount Énumère les entités sous cette ressource.Enumerates the entities beneath this resource. Dans le compte, renvoie la liste des files d'attente.On the account, returns the list of queues.
metadata File d'attenteQueue Définit ou renvoie les propriétés de file d'attente, notamment les métadonnées définies par l'utilisateur.Sets or returns queue properties, including user-defined metadata.

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.Note that all values for query parameters must be URL encoded before they are sent to the Azure storage services.

Opérations HTTP prises en chargeSupported HTTP Operations

Chaque ressource prend en charge les opérations basées sur les verbes HTTP GET, PUT, HEAD et DELETE.Each resource supports operations based on the HTTP verbs GET, PUT, HEAD, and 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.The verb, syntax, and supported HTTP version(s) for each operation appears on the reference page for each operation. Pour obtenir la liste complète des pages de référence des opérations, consultez API REST du service de file d’attente.For a complete list of operation reference pages, see Queue Service REST API.

Voir aussiSee also

Nommage des files d’attente et des métadonnées Naming Queues and Metadata
Opérations sur les files d’attente Operations on Queues
Opérations sur les messages Operations on Messages
API REST du service de File d’attenteQueue Service REST API