Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

List of protocol-level errors returned in API responses:

Error CodeNameContextUsed By
Context
3UNKNOWN_TOPIC_OR_PARTITION
MirrorMetadataManagerSource topic metadata has errors during sync
The topic does not exist on the target clusterRemoveTopicsFromMirror, PauseMirrorTopics, ResumeMirrorTopics
15COORDINATOR_NOT_AVAILABLE
MirrorCoordinatorMirror
The mirror coordinator is not activeWriteMirrorStates, ReadMirrorStates, LastMirroredOffsets
31CLUSTER_AUTHORIZATION_FAILED
KafkaApis, ControllerApisMissing authorization for mirror operations
The client is not authorized to perform the mirror operation

CreateMirror, AddTopicsToMirror, RemoveTopicsFromMirror, PauseMirrorTopics, ResumeMirrorTopics,

ListMirrors, DescribeMirrors, WriteMirrorStates, ReadMirrorStates, LastMirroredOffsets

35UNSUPPORTED_VERSION
KafkaApis, ControllerApis
Cluster mirroring is disabled (mirror.version=0)

CreateMirror, AddTopicsToMirror, RemoveTopicsFromMirror, PauseMirrorTopics, ResumeMirrorTopics,

ListMirrors, DescribeMirrors, WriteMirrorStates, ReadMirrorStates, LastMirroredOffsets

38INVALID_REPLICATION_FACTOR
ReplicationControlManager
Insufficient brokers
for
available to replicate the mirror topic
replication
CreateMirror
39INVALID_REPLICA_ASSIGNMENT
ReplicationControlManager
Brokers in the partition assignment are fenced or in controlled shutdown
42INVALID_REQUESTKafkaApis, ConfigurationControlManagerValidation failures (direct mirror.name modification, mirror disabled, invalid config)
CreateMirror
TBDREAD_ONLY_TOPICThe topic is read-only because it is a mirror topic on the target clusterProduce
TBDINVALID_MIRROR_NAMEThe mirror name does not meet the naming rulesCreateMirror
TBDUNKNOWN_MIRRORThe topic is not assigned to any mirrorRemoveTopicsFromMirror, PauseMirrorTopics, ResumeMirrorTopics
TBDTOPIC_ALREADY_IN_MIRRORThe topic is already assigned to a mirrorAddTopicsToMirror
TBDTOPIC_NOT_IN_MIRRORThe topic does not belong to the specified mirrorRemoveTopicsFromMirror, PauseMirrorTopics, ResumeMirrorTopics
TBDMIRROR_TOPIC_ALREADY_PAUSEDThe mirror topic is already pausedPauseMirrorTopics
TBDMIRROR_TOPIC_NOT_PAUSEDThe mirror topic is not pausedResumeMirrorTopics
TBDMIRROR_TOPIC_BEING_REMOVEDThe mirror topic is being removedResumeMirrorTopics

Compatibility, Deprecation, and Migration Plan

...