Esta página foi traduzida pela API Cloud Translation.

Escolher o método de criação da tarefa

É possível criar tarefas HTTP usando o método BufferTask ou o CreateTask. Esta página oferece orientações sobre como escolher entre os dois métodos para criar tarefas HTTP.

O método BufferTask permite criar uma tarefa enviando uma solicitação HTTP para o fila. O método CreateTask permite criar uma tarefa construindo o objeto de tarefa. Na maioria dos casos de uso, a construção explícita do objeto de tarefa é desnecessária. O melhor método para criar tarefas depende se a fila tem roteamento no nível da fila.

Antes de começar

Verifique a lista de casos de uso a seguir para saber se algum se aplica a você:

Você deseja criar tarefas usando a API RPC ou as bibliotecas de cliente (em vez de a API REST)
Você quer criar tarefas como objetos de tarefa do App Engine, em vez de objetos de tarefa mais típicos para destinos HTTP genéricos que podem ou não ser destinos do App Engine.

Se algum desses casos se aplicar a você, não será necessário escolher o método de criação da tarefa. porque apenas um método (o CreateTask) é compatível. Acesse diretamente a documentação de CreateTask para seu tipo de tarefa:

Verificar se a fila tem roteamento no nível da fila

Execute o seguinte comando da CLI gcloud no terminal:
```
gcloud tasks queues describe QUEUE_NAME
```
Substitua QUEUE_NAME pelo nome da fila.
Na saída, procure o campo httpTarget e verifique se o uriOverride foi definido.
- Se a saída incluir uma linha para uriOverride com um host especificado, a fila tem roteamento no nível da fila. Para escolher o método de criação da tarefa, consulte a seção Filas com roteamento no nível de fila.
- Se a saída não incluir uma linha para uriOverride ou se a descrição de uriOverride não mostrar um host especificado, a fila não terá roteamento no nível da fila. Para escolher o método de criação de tarefas, consulte a seção Filas sem roteamento no nível da fila (ou configure o roteamento no nível da fila).

Filas com roteamento no nível da fila

Para filas com roteamento no nível da fila, o método de criação de tarefas depende dos requisitos de roteamento da tarefa:

A tarefa tem os mesmos requisitos de roteamento especificados no nível da fila: Use BufferTask. Saiba como criar tarefas com o método BufferTask.
A tarefa tem requisitos de roteamento diferentes daqueles especificados no nível da fila: Defina a propriedade UriOverrideEnforceMode para IF_NOT_EXISTS para garantir que o roteamento no nível da fila se aplique às tarefas de qual roteamento não existe (por exemplo, tarefas BufferTask), mas respeita o roteamento de tarefas com especificações próprias. Em seguida, use CreateTask: Esse método permite especificar um roteamento individual para a tarefa. Saiba como criar tarefas com o CreateTask .

Filas sem roteamento no nível da fila

Para filas sem roteamento no nível da fila, crie tarefas usando o método CreateTask (ou configure o roteamento no nível da fila). O método CreateTask inclui o roteamento especificado para a tarefa, que é necessário para filas que ainda não têm informações de roteamento no nível da fila. Saiba como criar tarefas com o método CreateTask.

Entender o roteamento no nível da fila

O roteamento no nível da fila permite especificar informações de roteamento padrão para tarefas com base na fila em que elas estão. É possível especificar se o roteamento padrão se aplica apenas a tarefas que não têm informações de roteamento próprias ou a todas as tarefas.

Escolha o roteamento no nível da fila se quiser:

Criar tarefas com solicitações HTTP padrão (em vez de construir a tarefa objeto)
Usar uma fila como um buffer na frente de um serviço de destino

Abordagem por segmentação

O roteamento no nível da fila funciona melhor com arquiteturas que usam uma fila para cada serviço de destino. Com esse modelo, você pode:

Gerenciar tarefas com base no destino (por exemplo, redirecionar um grupo de tarefas se o serviço de destino estiver inativo)
Enviar todas as tarefas em uma fila para o mesmo destino
Criar tarefas sem construir explicitamente o objeto da tarefa usando o Método BufferTask

Ativar e desativar o comportamento de substituição no nível da fila

Depois de configurar o roteamento no nível da fila, você pode decidir quando ele é aplicado pela definindo a propriedade UriOverrideEnforceMode.

IF_NOT_EXISTS: o roteamento no nível da fila é aplicado apenas quando uma tarefa não contém as próprias informações de roteamento. Use essa configuração se quiser que a fila envia tarefas para destinos diferentes.
ALWAYS: o roteamento no nível da fila sempre é aplicado, mesmo quando uma tarefa contém o informações de roteamento. Todas as informações de roteamento definidas no nível da tarefa são substituídos pelo roteamento no nível da fila. Use essa configuração se quiser exigem que as tarefas em uma determinada fila usem as mesmas informações de roteamento.