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

Description de la file d'attente

 

La file d'attente est un document XML AtomPub document qui définit les sémantiques souhaitées pour une file d'attente. La file d'attente contient les propriétés suivantes.Pour plus d'informations, consultez le QueueDescription propriétés rubrique.

MaxSizeInMegaBytes: Number

Spécifie la taille maximale de la file d'attente en mégaoctets. Toute tentative de placement d'un message dans la file d'attente qui entraînera le dépassement de cette valeur dans la file d'attente échouera. Vous pouvez uniquement définir ce paramètre au moment de la création de la file d'attente à l'aide des valeurs suivantes :

  • Plage : 1 – 1024 (les valeurs valides sont 1024, 2048, 3072, 4096, 5120)

  • Par défaut : 1*1024 (les valeurs valides sont 1024, 2048, 3072, 4096, 5120)

SizeinBytes: Number

Représente le nombre d'octets réel que les messages de la file d'attente occupent actuellement dans le quota de la file d'attente.

MessageCount: Number

Affiche le nombre de messages actuellement dans la file d'attente.

DefaultMessageTimeToLive: XML datetime

Selon que DeadLettering est activé, un message est déplacé automatiquement vers la DeadLetterQueue ou supprimé s'il a été stocké dans la file d'attente plus longtemps que le délai imparti. Cette valeur est remplacée par une durée de vie spécifiée sur le message si et seulement si la durée de vie du message est inférieure à la durée de vie définie sur la file d'attente. Cette valeur est immuable après la création de la file dattente :

  • Plage : 1 seconde – TimeSpan.MaxValue

  • Par défaut : TimeSpan.MaxValue

LockDuration: XML datetime

Détermine la durée en secondes durant laquelle un message doit être verrouillé pour traitement par un récepteur. Après cette période, le message est déverrouillé et disponible pour la consommation par le récepteur suivant :

  • Plage : 0 – 5 minutes. 0 signifie que le message n'est pas verrouillé

  • Par défaut : 30 secondes

RequiresSession: True, False

Valeur pouvant être définie uniquement au moment de la création de la file d'attente. Si la valeur true, la file d'attente sera compatible avec la session et seul SessionReceiver est pris en charge. Les files d'attente prenant en charge la session ne sont pas prises en charge dans REST.

  • La valeur par défaut pour la file d'attente durable : false

RequiresDuplicateDetection: True, False

Valeur pouvant être définie uniquement au moment de la création de la file d'attente.

  • La valeur par défaut pour la file d'attente durable : false

EnableDeadLetteringOnMessageExpiration: True, False

Ce champ détermine comment la Service Bus gère un message avec une durée de vie a expiré. S'il est activé et un message expire, Service Bus déplace le message de la file d'attente dans lettres mortes sous-file d'attente de la file d'attente de. S'il est désactivé, le message est définitivement supprimé de la file d'attente. Valeur pouvant être définie uniquement au moment de la création de la file d'attente.

  • Par défaut : false

DuplicateDetectionHistoryTimeWindow

Spécifie l'intervalle de temps pendant lequel Service Bus détecte la duplication des messages :

  • Plage : 1 seconde – 7 jours

  • Par défaut : 10 minutes

EnableBatchedOperations

Active ou désactive le comportement de traitement par lot côté service lors de la réalisation d'opérations pour la file d'attente spécifique. Lorsque activé, Service Bus collecte/traite par lots plusieurs opérations sur le serveur principal afin d'être plus efficace avec la connexion. Si vous souhaitez une latence d'opération inférieure, vous pouvez désactiver cette fonctionnalité.

ForwardTo

Chemin d'accès au destinataire du message transféré.

MaxDeliveryCount

Le nombre maximal de fois Service Bus tente de remettre un message avant d'être placement mortes ou rejetée.

IsAnonymousAccessible

Obtient si l'accès anonyme est autorisé.

AuthorizationRules

Obtient les règles d'autorisation pour la description.

État

Obtient ou définit l'état actuel de la file d'attente (activée ou désactivée). Lorsqu'une file d'attente est désactivée, elle ne peut pas envoyer ni recevoir de messages.

SupportOrdering

Obtient ou définit la prise en charge du classement par la file d'attente.

Il est important de noter que la validation du schéma de la description durant la création de la file d'attente est sensible à l'ordre de ses éléments enfants. Par exemple, la description suivante n'est pas acceptée en tant que description de file d'attente valide.

<QueueDescription xmlns=\"http://schemas.microsoft.com/netservices/2010/10/servicebus/connect\"> <MaxSizeInMegaBytes>10000</MaxSizeInMegaBytes> <DefaultMessageTimeToLive>PT5M</DefaultMessageTimeToLive> <LockDuration>PT2M</LockDuration> <RequiresGroupedReceives>False</RequiresGroupedReceives> <SupportsDuplicateDetection>False</SupportsDuplicateDetection> </QueueDescription>

Cependant, si les éléments apparaissent comme ci-dessous, elle est acceptée en tant que description de file d'attente valide :

<QueueDescription xmlns=\"http://schemas.microsoft.com/netservices/2010/10/servicebus/connect\"> <LockDuration>PT2M</LockDuration> <MaxSizeInMegaBytes>1024</MaxSizeInMegaBytes> <SupportsDuplicateDetection>false</SupportsDuplicateDetection> <RequiresGroupedReceives>false</RequiresGroupedReceives> <DefaultMessageTimeToLive>PT5M</DefaultMessageTimeToLive> </QueueDescription>

  • Répertorier toutes les files d'attente sous un chemin d'accès donné :

    http://<serviceBusAddress>/$Resources/Queues?$filter=startswith(path, ‘/my/test’)
    
  • Répertorier toutes les files d'attente mises à jour au cours des 5 dernières minutes :

    http://<serviceBusAddress>/$Resources/Queues?$filter=lastModifiedTime Gt  2011-08-09T21:44:36.2481552Z
    
  • Répertorier toutes les files d'attente incluant au moins un message :

    http://<serviceBusAddress>/$Resources/Queues?$filter=MessageCount Gt 0
    
Afficher: