Publicando Mensagens em um Canal

Publique mensagens em um canal específico dentro de uma fila.

Os canais são destinos efêmeros dentro de uma fila. A publicação de mensagens em um canal dentro de uma fila requer apenas um parâmetro extra. Os canais não exigem criação ou exclusão explícita. As mensagens publicadas em um canal estão disponíveis para consumo no nível da fila ou do canal. Para obter mais informações, consulte Canais.

A publicação de mensagens exige permissões para a fila e acesso ao Ponto final de mensagens.

Uma mensagem contém um payload na forma de string. Ao publicar mensagens usando uma solicitação PutMessages, você pode incluir um ID de canal.

Observação

Você pode especificar diferentes IDs de canal para diferentes mensagens na mesma solicitação. No entanto, a publicação de mensagens em vários canais em uma solicitação pode resultar em falhas parciais. Algumas mensagens podem ser publicadas com sucesso e outras mensagens na mesma solicitação podem falhar. Respostas a uma solicitação PutMessages que especifica canais incluem informações de falha.
  • Embora possa usar a Console para publicar mensagens de teste em um canal, use a CLI, a API ou um SDK para preencher uma fila e seus canais. Consulte Maneiras de Acessar o Serviço Queue para obter mais informações.

    1. Na página da lista Filas, selecione a fila com a qual deseja trabalhar. Se precisar de ajuda para localizar a página da lista ou a fila, consulte Listando Filas.
    2. Na página de detalhes da fila, selecione Enviar mensagem.
    3. Se necessário, informe um valor para ID do Canal. Se você não fornecer um ID do Canal, a mensagem será publicada no nível da fila.
    4. Informe uma mensagem e selecione Enviar mensagem.

      Os detalhes sobre a mensagem enviada são exibidos.

    5. Selecione Enviar outra mensagem para enviar outra mensagem. Para fechar o painel e retornar à página Detalhes da fila, selecione Cancelar.
  • Use o comando oci queue messages put-messages e os parâmetros necessários para publicar mensagens em uma fila:

    oci queue messages put-messages --messages file://messages.json --queue-id <queue_OCID>

    O canal é especificado como metadados associados à mensagem. Por exemplo:

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

    Para obter uma lista completa dos parâmetros e valores dos comandos da CLI, consulte a Referência de Comandos da CLI.

  • Use a operação PutMessages para publicar mensagens em um canal. Uma solicitação PutMessages contém uma lista de mensagens com channelId especificado como metadados. Por exemplo:

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

    A API retorna o id de cada mensagem.

    Para obter informações sobre como usar a API e assinar solicitações, consulte a documentação da API REST e Credenciais de Segurança. Para obter informações sobre SDKs, consulte SDKs e a CLI.