Understand MSK Provisioned cluster states
The following table shows the possible states of a MSK Provisioned cluster and describes what they mean.
Unless otherwise specified, MSK Provisioned cluster states apply to both Standard and Express broker types.
This table also describes what actions you can and cannot perform when an MSK Provisioned cluster is in one
of these states. To find out the state of a cluster, you can visit the Amazon Web Services Management Console. You can
also use the describe-cluster-v2
MSK Provisioned cluster state | Meaning and possible actions |
---|---|
ACTIVE |
You can produce and consume data. You can also perform Amazon MSK API and Amazon CLI operations on the cluster. |
CREATING |
Amazon MSK is setting up the Provisioned cluster. You must wait for the cluster to reach the ACTIVE state before you can use it to produce or consume data or to perform Amazon MSK API or Amazon CLI operations on it. |
DELETING | The Provisioned cluster is being deleted. You cannot use it to produce or consume data. You also cannot perform Amazon MSK API or Amazon CLI operations on it. |
FAILED | The Provisioned cluster creation or deletion process failed. You cannot use the cluster to produce or consume data. You can delete the cluster but cannot perform Amazon MSK API or Amazon CLI update operations on it. |
HEALING |
Amazon MSK is running an internal operation, like replacing an unhealthy broker. For example, the broker might be unresponsive. You can still use the Provisioned cluster to produce and consume data. However, you cannot perform Amazon MSK API or Amazon CLI update operations on the cluster until it returns to the ACTIVE state. |
MAINTENANCE | (Standard brokers only) Amazon MSK is performing routine maintenance operations on the cluster. Such maintenance operations include security patching. You can still use the cluster to produce and consume data. However, you cannot perform Amazon MSK API or Amazon CLI update operations on the cluster until it returns to the ACTIVE state. The cluster State remains ACTIVE during maintenance on Express brokers. See Patching. |
REBOOTING_BROKER | Amazon MSK is rebooting a broker. You can still use the Provisioned cluster to produce and consume data. However, you cannot perform Amazon MSK API or Amazon CLI update operations on the cluster until it returns to the ACTIVE state. |
UPDATING | A user-initiated Amazon MSK API or Amazon CLI operation is updating the Provisioned cluster. You can still use the Provisioned cluster to produce and consume data. However, you cannot perform any additional Amazon MSK API or Amazon CLI update operations on the cluster until it returns to the ACTIVE state. |