Publication de messages sur un canal

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

Les canaux sont des destinations éphémères dans une file d'attente. La publication de messages sur un canal d'une file d'attente ne nécessite qu'un paramètre supplémentaire. Les canaux ne nécessitent ni création ni suppression explicites. 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, reportez-vous à Canaux.

La publication de messages requiert des droits d'accès à la file d'attente et un accès à son adresse de messages.

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

Remarque

Vous pouvez spécifier différents ID de canal pour différents messages dans la même demande. Toutefois, la publication de messages sur plusieurs canaux dans une même demande peut entraîner des échecs partiels. Certains messages peuvent être publiés avec succès et d'autres dans la même demande peuvent échouer. Les réponses à une demande PutMessages qui spécifie les canaux incluent des informations d'échec.
  • Bien que vous puissiez utiliser la console afin de publier des messages de test sur un canal, vous pouvez utiliser l'interface de ligne de commande, l'API ou un kit SDK pour remplir une file d'attente et ses canaux. Pour plus d'informations, reportez-vous à Méthodes d'accès à Queue.

    1. Sur la page de liste Files d'attente, sélectionnez la file d'attente à utiliser. Si vous avez besoin d'aide pour rechercher la page de liste ou la file d'attente, reportez-vous à la rubrique Liste des files d'attente.
    2. Sur la page de détails de la file d'attente, sélectionnez Envoyer un message.
    3. Si nécessaire, entrez une valeur pour ID de canal. Si vous ne fournissez pas d'ID de canal, le message est publié au niveau de la file d'attente.
    4. Entrez un message, puis sélectionnez Envoyer un message.

      Les détails relatifs au message envoyé sont affichés.

    5. Sélectionnez Envoyer un autre message pour envoyer un autre message. Pour fermer le panneau et revenir à 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 indiqué en tant que métadonnées associées au message. Exemples :

    {
      "messages": [
        {
          "content": "1",
          "metadata" : {"channelId" : "ch1"}
        },
        {
          "content": "2",
          "metadata" : {"channelId" : "ch2"}
        },
      ]
    }

    Pour obtenir la liste complète des paramètres et des valeurs des commandes d'interface de ligne de commande, reportez-vous à Référence de commande d'interface de ligne de commande.

  • Utilisez l'opération PutMessages pour publier des messages sur un canal. Une demande PutMessages contient la liste des messages dont channelId est indiqué en tant que métadonnées. Exemples :

    {
      "messages": [
        {
          "content": "1",
          "metadata" : {"channelId" : "ch1"}
        },
        {
          "content": "2",
          "metadata" : {"channelId" : "ch2"}
        },
      ]
    }

    L'API renvoie l'ID (id) de chaque message.

    Pour plus d'informations sur l'utilisation de l'API et la signature des demandes, reportez-vous à la documentation relative à l'API REST et à Informations d'identification de sécurité. Pour plus d'informations sur les kits SDK, reportez-vous à Kits SDK et interface de ligne de commande.