Documentação do Oracle Cloud Infrastructure

Consumindo Mensagens de um Canal

Saiba como consumir mensagens de um canal ou canais específicos em uma fila.

O consumo de mensagens exige permissões para a fila e acesso ao ponto final de Mensagens. Para obter mais informações, consulte Consumindo Mensagens e Canais.

Você pode especificar um canal específico do qual consumir mensagens. Para obter mais informações sobre como filtrar, consulte Seleção de Mensagem.

Observação

Se as mensagens forem publicadas em um canal, mas uma solicitação de consumo não incluir um canal, as mensagens serão retornadas de um canal aleatório com mensagens disponíveis da fila especificada.

  • Não é possível usar a Console para consumir mensagens, mas você pode usar a Console para sondar mensagens. A sondagem de mensagens serve como uma view rápida da fila ou do canal. As mensagens sondadas pela Console ficam indisponíveis para outros consumidores até que o timeout de visibilidade ocorra.

    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 Canais.
    3. (Opcional) Selecione Gerenciar definições de sondagem. Forneça as seguintes informações e clique em Salvar alterações:
      • Timeout de sondagem (segundos): O tempo de espera para que as mensagens sejam consumidas.
      • Número de mensagens em uma solicitação: O número máximo de mensagens a serem consumidas durante a sondagem.
    4. Selecione Perfil de canal aleatório ou selecione o menu Ações (Menu Ações) de um canal específico e selecione Perfil de mensagem.
    5. Selecione Continuar.

      Se as mensagens estiverem disponíveis para consumo, elas serão exibidas no painel Colocar mensagens do canal junto com o nome da fila e o ID do canal.

    6. Selecione uma mensagem para obter mais detalhes sobre uma mensagem.

  • Use o comando oci queue messages get-messages e os parâmetros necessários para consumir mensagens de um canal. Para consumir mensagens de um canal específico, inclua channel-filter. Por exemplo:

    oci queue messages get-messages --queue-id <queue_OCID> --channel-filter <channel_ID>

    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 GetMessages para consumir mensagens de um canal. Uma solicitação GetMessages contém um limit opcional, um visibilityInSeconds opcional e um parâmetro timeoutInSeconds opcional.

    Para consumir mensagens de canais específicos, inclua o parâmetro channelFilter.

    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.