Publication de messages sur un canal

Publier des messages sur un canal spécifique dans une file d'attente.

Les canaux sont des destinations éphémères dans une file d'attente. La publication de messages sur un canal dans une file d'attente ne nécessite qu'un paramètre supplémentaire. Les canaux ne nécessitent pas de création ou de suppression explicite. Les messages publiés sur un canal peuvent être consommés à partir de la file d'attente ou du niveau du canal. Pour plus d'informations, voir Canaux.

La publication de messages nécessite des autorisations pour la file d'attente et l'accès à son point d'extrémité pour les messages.

Un message contient des données utiles sous la forme d'une chaîne. Lorsque vous publiez des messages à l'aide d'une demande PutMessages, vous pouvez inclure un ID canal.

Note

Vous pouvez spécifier des ID canal différents pour différents messages dans la même demande. Toutefois, la publication de messages sur plusieurs canaux dans une demande peut entraîner des échecs partiels. Certains messages peuvent être publiés et d'autres dans la même demande risquent d'échouer. Les réponses à une demande PutMessages qui spécifie les canaux incluent des informations sur l'échec.

Bien que vous puissiez utiliser la console pour publier des messages de test sur un canal, vous utilisez l'interface de ligne de commande, l'API ou une trousse SDK pour alimenter une file d'attente et ses canaux. Pour plus d'informations, voir Méthodes d'accès au service de file d'attente.
1. Dans la page de liste Files d'attente, sélectionnez la file d'attente avec laquelle vous voulez travailler. Si vous avez besoin d'aide pour trouver la page de liste ou la file d'attente, voir Liste des files d'attente.
2. Dans la page des détails de la file d'attente, sélectionnez Envoyer un message.
3. Si nécessaire, entrez une valeur pour ID canal. Si vous ne fournissez pas d'ID canal, le message est publié au niveau de la file d'attente.
4. Entrez un message, puis sélectionnez Envoyer le message.
  Les détails du message envoyé s'affichent.
5. Sélectionnez Envoyer un autre message pour envoyer un autre message. Pour fermer le panneau et retourner à la page Détails de la file d'attente, sélectionnez Annuler.
Utilisez la commande oci queue messages put-messages et les paramètres requis pour publier des messages dans une file d'attente :
```
oci queue messages put-messages --messages file://messages.json --queue-id <queue_OCID>
```
Le canal est spécifié en tant que métadonnées associées au message. Par exemple :
```
{
  "messages": [
    {
      "content": "1",
      "metadata" : {"channelId" : "ch1"}
    },
    {
      "content": "2",
      "metadata" : {"channelId" : "ch2"}
    },
  ]
}
```
Pour la liste complète des paramètres et valeurs des commandes de l'interface de ligne de commande, voir Informations de référence sur les commandes de l'interface.
Utilisez l'opération PutMessages pour publier des messages sur un canal. Une demande PutMessages contient une liste de messages avec channelId spécifié en tant que métadonnées. Par exemple :
```
{
  "messages": [
    {
      "content": "1",
      "metadata" : {"channelId" : "ch1"}
    },
    {
      "content": "2",
      "metadata" : {"channelId" : "ch2"}
    },
  ]
}
```
L'API retourne la valeur id pour chaque message.

Pour plus d'informations sur l'utilisation de l'API et sur les demandes de signature, voir la documentation de l'API REST et Données d'identification de sécurité. Pour plus d'informations sur les trousses SDK, voir Trousses SDK et interface de ligne de commande.

Documentation sur Oracle Cloud Infrastructure

Publication de messages sur un canal