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 de 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 selecione Atualizar:
      • 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 Polar canal aleatório ou selecione o menu Ações (três pontos) para um canal específico e, em seguida, selecione Polar mensagem.
    5. Selecione Continuar.

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

    6. Para obter mais detalhes sobre uma mensagem, selecione o menu Ações (três pontos) e selecione Exibir detalhes da 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 de parâmetros e valores para 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.