チャネルへのメッセージのパブリッシュ

キュー内の特定のチャネルにメッセージをパブリッシュします。

チャネルはキュー内の一時的な宛先です。キュー内のチャネルにメッセージを公開するには、追加のパラメータのみが必要です。チャネルを明示的に作成または削除する必要はありません。チャネルに公開されたメッセージは、キュー・レベルまたはチャネル・レベルの両方から消費できます。詳細は、チャネルを参照してください。

メッセージの公開には、キューに対する権限と、そのメッセージ・エンドポイントへのアクセスが必要です。

メッセージには、文字列の形式のペイロードが含まれます。PutMessagesリクエストを使用してメッセージをパブリッシュする場合、チャネルIDを含めることができます。

ノート

同じリクエストのメッセージごとに異なるチャネルIDを指定できます。ただし、1つのリクエストで複数のチャネルにメッセージを公開すると、部分的な障害が発生する可能性があります。一部のメッセージは正常に公開され、同じリクエスト内の他のメッセージは失敗する可能性があります。チャネルを指定するPutMessagesリクエストへのレスポンスには、障害情報が含まれます。

コンソールを使用してテスト・メッセージをチャネルに公開できますが、キューとそのチャネルに移入するにはCLI、APIまたはSDKを使用します。詳細は、キューにアクセスする方法を参照してください。
1. 「キュー」リスト・ページで、操作するキューを選択します。リスト・ページまたはキューの検索に関するヘルプが必要な場合は、キューのリストを参照してください。
2. キューの詳細ページで、「メッセージの送信」を選択します。
3. 必要に応じて、「チャネルID」の値を入力します。チャネルIDを指定しない場合、メッセージはキュー・レベルで公開されます。
4. メッセージを入力し、「メッセージの送信」を選択します。
  送信されたメッセージに関する詳細が表示されます。
5. 別のメッセージを送信するには、「別のメッセージの送信」を選択します。パネルを閉じて「キューの詳細」ページに戻るには、「取消」を選択します。
oci queue messages put-messagesコマンドおよび必須パラメータを使用して、メッセージをキューに公開します:
```
oci queue messages put-messages --messages file://messages.json --queue-id <queue_OCID>
```
チャネルは、メッセージに関連付けられたメタデータとして指定されます。たとえば、次のとおりです。
```
{
  "messages": [
    {
      "content": "1",
      "metadata" : {"channelId" : "ch1"}
    },
    {
      "content": "2",
      "metadata" : {"channelId" : "ch2"}
    },
  ]
}
```
CLIコマンドのパラメータおよび値のリストは、CLIコマンド・リファレンスを参照してください。
PutMessages操作を使用して、メッセージをチャネルに公開します。PutMessagesリクエストには、メタデータとしてchannelIdが指定されているメッセージのリストが含まれます。たとえば:
```
{
  "messages": [
    {
      "content": "1",
      "metadata" : {"channelId" : "ch1"}
    },
    {
      "content": "2",
      "metadata" : {"channelId" : "ch2"}
    },
  ]
}
```
APIは、各メッセージのidを返します。

APIの使用およびリクエストの署名の詳細は、REST APIのドキュメントおよびセキュリティ資格証明を参照してください。SDKの詳細は、SDKおよびCLIを参照してください。

Oracle Cloud Infrastructureドキュメント

チャネルへのメッセージのパブリッシュ