Track and Filter Instance Tasks in Task Center - Tair

The Task Center records the progress and details of instance lifecycle operations — creating instances, changing configurations, restarting instances, and upgrading versions. Use it to monitor ongoing tasks and control when maintenance switchovers take effect.

View tasks

Open the Task Center and select a region in the top navigation bar.
Filter tasks by start time, keyword, or status.

Supported task types

Cloud-native instances

Task	TaskType (API value)	Description
Create Instance	`CreateIns`	N/A
Clear Data	`FlushData`	Clears all data.
Clear Expired Data	`ClearExpiredData`	Clears expired data from a standard instance.
Primary/Secondary Instance Switchover	`HaSwitch`	Performs a master-replica switchover on a standard instance.
Switch Over Cluster	`ClusterHaSwitch`	Performs a master-replica switchover on a cluster or read/write splitting instance. Note The feature to change the switching time for cluster switching tasks is currently being upgraded and is unavailable. To perform a switchover immediately, submit a ticket.
Restart Instance	`RestartIns`	Restarts an instance or updates the minor version of a cluster instance. Note The feature to change the switching time for restarting instances in a cluster with read/write splitting architecture is currently being upgraded and is unavailable. To restart the instance immediately, submit a ticket.
Restart Proxy	`RestartProxy`	Restarts or rebuilds a proxy node.
Add Shard	`AddInsShards`	Adds data shards to a cluster instance.
Remove Shard	`DeleteInsShards`	Removes data shards from a cluster instance.
Add Node	`AddInsNode`	Adds data nodes to a cluster instance, or adds read replicas to a read/write splitting instance.
Remove Node	`DeleteInsNode`	Removes data nodes from a cluster instance, or removes read replicas from a read/write splitting instance.
Upgrade Minor Version	`KernelVersionUpgrade`	Updates the minor version of an instance.
Change Specifications or Migrate Data	`ModifyInsSpec`	Upgrades instance specifications, changes the instance architecture, adds or removes data nodes or read replicas, migrates an instance across multiple zones, changes a single-zone instance to a dual-zone instance, or upgrades the major version of an instance. Major version upgrades are not supported for standard instances.

Note

Two behaviors can produce unexpected task categorizations on cloud-native instances:

Manual restart of the master node: The high availability system may interpret this as an abnormal event and trigger a master-replica switchover. The resulting task appears as Primary/Secondary Instance Switchover or Switch Over Cluster rather than Restart Instance.
Version upgrade when the original host lacks resources: The instance is migrated to a new host. The resulting task appears as Change Specifications or Migrate Data rather than an upgrade task.

Classic instances

Task	TaskType (API value)	Description
Create Instance	`CreateIns`	N/A
Restart Instance	`RestartIns`	Restarts a standard instance.
Restart Proxy	`RestartProxy`	Restarts or rebuilds a proxy node.
Change Configuration	`ModifyInsConfig`	Switches between the standard architecture, the cluster architecture in proxy mode, and the read/write splitting architecture, or changes configurations across architectures. Configuration changes for Global Distributed Cache instances are not supported.
Change Network	`ModifyNetwork`	Modifies SSL configurations.
Add Shard	`AddInsShards`	Adds data shards to a cluster instance in direct connection mode. Instance specifications cannot be changed separately.
Remove Shard	`DeleteInsShards`	Removes data shards from a cluster instance in direct connection mode. Instance specifications cannot be changed separately.

Schedule a switchover

When a task involves a maintenance switchover — such as configuration changes, version upgrades, or restarts — choose when the switchover takes effect:

Click Switch Now to trigger the switchover as soon as preparation is complete.
Click Switch within Maintenance Window (recommended) to complete preparation first, then switch during the designated maintenance window.

To switch outside the maintenance window or at a specific time, wait until the task status changes to Pending Schedule. Then, on the Task Center page, click Modify switching time in the Actions column and change it to Switch Immediately.

FAQ

Why can't I click Modify switching time?

Two reasons are common. First, some tasks have no impact on the instance and don't require a switching time change — the button is intentionally disabled for those. Second, if the task is still in the preparation phase (creating new instances and migrating data, which can take minutes to hours), the button stays disabled until the task status reaches Pending Schedule.

The task shows as in progress, but my instance is running fine. Why?

After the switchover completes, the instance is accessible again. However, the task system continues running finalization steps in the background — such as cleaning up the old instance — before marking the task as Completed. The "in progress" state reflects these background cleanup operations, not an issue with the instance itself.

Related API operations

API operation	Description
DescribeHistoryTasks	Queries a list of tasks in the task center.