Skip to main content

tctl version-next task-queue command reference

The tctl task-queue commands enable Task QueueLink preview iconWhat is a Task Queue?

A Task Queue is a first-in, first-out queue that a Worker Process polls for Tasks.

Learn more operations.

Alias: tq

describe

The tctl task-queue describe command describes the poller information of a Task QueueLink preview iconWhat is a Task Queue?

A Task Queue is a first-in, first-out queue that a Worker Process polls for Tasks.

Learn more.

tctl task-queue describe <modifiers>

The Server records the last time a Worker sent a poll request. Poll requests can last up to a minute, so a LastAccessTime less than a minute ago is normal. If it's over a minute ago, then likely either the Worker is at capacity (all Workflow and Activity slots are full) or it has shut down. Once it has been 5 minutes since the last poll request, the Worker will no longer appear on the list.

The following modifiers are supported and control the behavior of the command. --task-queue is required.

list-partition

The tctl task-queue list-partition command lists the partitions of a Task QueueLink preview iconWhat is a Task Queue?

A Task Queue is a first-in, first-out queue that a Worker Process polls for Tasks.

Learn more and the hostname for the partitions.

tctl task-queue list-partition --task-queue <value>

The following modifiers are supported and control the behavior of the command. Always include required modifiers when executing this command.