ServiceBusMessage interface
Décrit le message à envoyer à Service Bus.
Propriétés
application |
Propriétés spécifiques à l’application qui peuvent être utilisées pour les métadonnées de message personnalisées. |
body | Corps du message qui doit être envoyé ou reçu. Si l’application qui reçoit le message n’utilise pas ce Kit de développement logiciel (SDK), convertissez votre charge utile du corps en tableau d’octets ou mémoire tampon pour une meilleure compatibilité entre les langues. |
content |
Type de contenu du message. Décrit éventuellement la charge utile du message, avec un descripteur suivant le format RFC2045, Section 5, par exemple « application/json ». |
correlation |
Identificateur de corrélation qui permet à une application de spécifier un contexte pour le message à des fins de corrélation, par exemple en reflétant l’Id de message d’un message auquel est répondu. Consultez Routage et corrélation des messages. |
message |
L’identificateur de message est une valeur définie par l’application qui identifie de manière unique le message et sa charge utile. Remarque : Les nombres qui ne sont pas des entiers entiers ne sont pas autorisés. |
partition |
Clé de partition pour l’envoi d’un message à une entité partitionnée. La longueur maximale est de 128 caractères. Dans le cas des entités partitionnées, la définition de cette valeur permet d’attribuer des messages associés à la même partition interne, afin que l’ordre de séquence d’envoi soit correctement enregistré. La partition est choisie par une fonction de hachage prioritaire sur cette valeur et ne peut pas être sélectionnée directement.
|
reply |
Adresse d’une entité à laquelle envoyer des réponses. Cette valeur facultative et définie par l’application est un moyen standard d’exprimer un chemin d’accès de réponse à l’intention du destinataire du message. Lorsqu’un expéditeur attend une réponse, cette propriété définit cette valeur sur le chemin d’accès absolu ou relatif de la file d’attente ou de la rubrique auxquelles la réponse doit être envoyée. Consultez Routage et corrélation des messages. |
reply |
Identificateur de session qui augmente l’adresse |
scheduled |
Date et heure UTC auxquelles le message sera mis en file d’attente. Cette propriété retourne l’heure utc ; lors de la définition de la propriété, la valeur DateTime fournie doit également être utc. Cette valeur correspond à l’envoi de messages différés. Il est utilisé pour retarder l’envoi des messages à une heure spécifique à l’avenir. L’heure de mise en file d’attente de message ne signifie pas que le message sera envoyé en même temps. Il sera mis en file d’attente, mais le temps d’envoi réel dépend de la charge de travail de la file d’attente et de son état. |
session |
Identificateur de session pour une entité prenant en charge la session. La longueur maximale est de 128 caractères. Dans le cas des entités prenant en charge la session, cette valeur définie par l’application spécifie l’affiliation de session du message. Les messages dotés du même identificateur de session sont soumis à un verrouillage du résumé et permettent un traitement et un démultiplexage chronologiques. Dans le cas des entités ne prenant pas en charge la session, cette valeur est ignorée. Sessions de message. |
subject | L’étiquette spécifique de l’application. Cette propriété permet à l’application d’indiquer l’objectif du message au destinataire dans un standard. fashion, similaire à une ligne d’objet de courrier électronique. La propriété AMQP mappée est « subject ». |
time |
Valeur de durée de vie du message. Cette valeur est la durée relative après laquelle le message expire, à partir de l’instant où le message a été accepté et stocké par le répartiteur, comme capturé dans |
to | Adresse « à ». Cette propriété est réservée pour une utilisation ultérieure dans les scénarios de routage et est actuellement ignorée par le répartiteur proprement dit. Les applications peuvent utiliser cette valeur dans les scénarios de chaînage automatique pilotés par des règles pour indiquer la destination logique prévue du message. |
Détails de la propriété
applicationProperties
Propriétés spécifiques à l’application qui peuvent être utilisées pour les métadonnées de message personnalisées.
applicationProperties?: {[key: string]: number | boolean | string | Date | null}
Valeur de propriété
{[key: string]: number | boolean | string | Date | null}
body
Corps du message qui doit être envoyé ou reçu. Si l’application qui reçoit le message n’utilise pas ce Kit de développement logiciel (SDK), convertissez votre charge utile du corps en tableau d’octets ou mémoire tampon pour une meilleure compatibilité entre les langues.
body: any
Valeur de propriété
any
contentType
Type de contenu du message. Décrit éventuellement la charge utile du message, avec un descripteur suivant le format RFC2045, Section 5, par exemple « application/json ».
contentType?: string
Valeur de propriété
string
correlationId
Identificateur de corrélation qui permet à une application de spécifier un contexte pour le message à des fins de corrélation, par exemple en reflétant l’Id de message d’un message auquel est répondu. Consultez Routage et corrélation des messages.
correlationId?: string | number | Buffer
Valeur de propriété
string | number | Buffer
messageId
L’identificateur de message est une valeur définie par l’application qui identifie de manière unique le message et sa charge utile.
Remarque : Les nombres qui ne sont pas des entiers entiers ne sont pas autorisés.
messageId?: string | number | Buffer
Valeur de propriété
string | number | Buffer
partitionKey
Clé de partition pour l’envoi d’un message à une entité partitionnée. La longueur maximale est de 128 caractères. Dans le cas des entités partitionnées, la définition de cette valeur permet d’attribuer des messages associés à la même partition interne, afin que l’ordre de séquence d’envoi soit correctement enregistré. La partition est choisie par une fonction de hachage prioritaire sur cette valeur et ne peut pas être sélectionnée directement.
- Pour les entités prenant en charge la session, la
sessionId
propriété remplace cette valeur. - Pour les entités non partitionnée, la clé de partition est ignorée
partitionKey?: string
Valeur de propriété
string
replyTo
Adresse d’une entité à laquelle envoyer des réponses. Cette valeur facultative et définie par l’application est un moyen standard d’exprimer un chemin d’accès de réponse à l’intention du destinataire du message. Lorsqu’un expéditeur attend une réponse, cette propriété définit cette valeur sur le chemin d’accès absolu ou relatif de la file d’attente ou de la rubrique auxquelles la réponse doit être envoyée. Consultez Routage et corrélation des messages.
replyTo?: string
Valeur de propriété
string
replyToSessionId
Identificateur de session qui augmente l’adresse replyTo
.
La longueur maximale est de 128 caractères. Cette valeur incrémente l’information ReplyTo et spécifie la valeur SessionId qui doit être définie pour la réponse lors de son envoi à l’entité de réponse.
Consultez Routage et corrélation des messages.
replyToSessionId?: string
Valeur de propriété
string
scheduledEnqueueTimeUtc
Date et heure UTC auxquelles le message sera mis en file d’attente. Cette propriété retourne l’heure utc ; lors de la définition de la propriété, la valeur DateTime fournie doit également être utc. Cette valeur correspond à l’envoi de messages différés. Il est utilisé pour retarder l’envoi des messages à une heure spécifique à l’avenir. L’heure de mise en file d’attente de message ne signifie pas que le message sera envoyé en même temps. Il sera mis en file d’attente, mais le temps d’envoi réel dépend de la charge de travail de la file d’attente et de son état.
scheduledEnqueueTimeUtc?: Date
Valeur de propriété
Date
sessionId
Identificateur de session pour une entité prenant en charge la session. La longueur maximale est de 128 caractères. Dans le cas des entités prenant en charge la session, cette valeur définie par l’application spécifie l’affiliation de session du message. Les messages dotés du même identificateur de session sont soumis à un verrouillage du résumé et permettent un traitement et un démultiplexage chronologiques. Dans le cas des entités ne prenant pas en charge la session, cette valeur est ignorée. Sessions de message.
sessionId?: string
Valeur de propriété
string
subject
L’étiquette spécifique de l’application. Cette propriété permet à l’application d’indiquer l’objectif du message au destinataire dans un standard. fashion, similaire à une ligne d’objet de courrier électronique. La propriété AMQP mappée est « subject ».
subject?: string
Valeur de propriété
string
timeToLive
Valeur de durée de vie du message. Cette valeur est la durée relative après laquelle le message expire, à partir de l’instant où le message a été accepté et stocké par le répartiteur, comme capturé dans enqueuedTimeUtc
. Lorsque cette valeur n’est pas définie explicitement, la valeur prise en compte est celle du paramètre DefaultTimeToLive pour la file d’attente ou la rubrique concernées. Une valeur au niveau timeToLive
du message ne peut pas être plus longue que le paramètre DefaultTimeToLive de l’entité et elle est ajustée en mode silencieux si c’est le cas. Consultez Expiration.
timeToLive?: number
Valeur de propriété
number
to
Adresse « à ». Cette propriété est réservée pour une utilisation ultérieure dans les scénarios de routage et est actuellement ignorée par le répartiteur proprement dit. Les applications peuvent utiliser cette valeur dans les scénarios de chaînage automatique pilotés par des règles pour indiquer la destination logique prévue du message.
to?: string
Valeur de propriété
string