// This file is auto-generated by io.strimzi.crdgenerator.DocGenerator.
// To change this documentation you need to edit the Java sources.

[id='type-Kafka-{context}']
### `Kafka` schema reference


[options="header"]
|====
|Property       |Description
|spec    1.2+<.<|The specification of the Kafka and ZooKeeper clusters, and Topic Operator.
|xref:type-KafkaSpec-{context}[`KafkaSpec`]
|status  1.2+<.<|The status of the Kafka and ZooKeeper clusters, and Topic Operator.
|xref:type-KafkaStatus-{context}[`KafkaStatus`]
|====

[id='type-KafkaSpec-{context}']
### `KafkaSpec` schema reference

Used in: xref:type-Kafka-{context}[`Kafka`]


[options="header"]
|====
|Property                       |Description
|kafka                   1.2+<.<|Configuration of the Kafka cluster.
|xref:type-KafkaClusterSpec-{context}[`KafkaClusterSpec`]
|zookeeper               1.2+<.<|Configuration of the ZooKeeper cluster.
|xref:type-ZookeeperClusterSpec-{context}[`ZookeeperClusterSpec`]
|topicOperator           1.2+<.<|*The property `topicOperator` has been deprecated. This feature should now be configured at path `spec.entityOperator.topicOperator`.* Configuration of the Topic Operator.
|xref:type-TopicOperatorSpec-{context}[`TopicOperatorSpec`]
|entityOperator          1.2+<.<|Configuration of the Entity Operator.
|xref:type-EntityOperatorSpec-{context}[`EntityOperatorSpec`]
|clusterCa               1.2+<.<|Configuration of the cluster certificate authority.
|xref:type-CertificateAuthority-{context}[`CertificateAuthority`]
|clientsCa               1.2+<.<|Configuration of the clients certificate authority.
|xref:type-CertificateAuthority-{context}[`CertificateAuthority`]
|cruiseControl           1.2+<.<|Configuration for Cruise Control deployment. Deploys a Cruise Control instance when specified.
|xref:type-CruiseControlSpec-{context}[`CruiseControlSpec`]
|jmxTrans                1.2+<.<|Configuration for JmxTrans. When the property is present a JmxTrans deployment is created for gathering JMX metrics from each Kafka broker. For more information see https://github.com/jmxtrans/jmxtrans[JmxTrans GitHub].
|xref:type-JmxTransSpec-{context}[`JmxTransSpec`]
|kafkaExporter           1.2+<.<|Configuration of the Kafka Exporter. Kafka Exporter can provide additional metrics, for example lag of consumer group at topic/partition.
|xref:type-KafkaExporterSpec-{context}[`KafkaExporterSpec`]
|maintenanceTimeWindows  1.2+<.<|A list of time windows for maintenance tasks (that is, certificates renewal). Each time window is defined by a cron expression.
|string array
|====

[id='type-KafkaClusterSpec-{context}']
### `KafkaClusterSpec` schema reference

Used in: xref:type-KafkaSpec-{context}[`KafkaSpec`]

include::../api/io.strimzi.api.kafka.model.KafkaClusterSpec.adoc[leveloffset=+1]

[options="header"]
|====
|Property                    |Description
|replicas             1.2+<.<|The number of pods in the cluster.
|integer
|image                1.2+<.<|The docker image for the pods. The default value depends on the configured `Kafka.spec.kafka.version`.
|string
|storage              1.2+<.<|Storage configuration (disk). Cannot be updated. The type depends on the value of the `storage.type` property within the given object, which must be one of [ephemeral, persistent-claim, jbod].
|xref:type-EphemeralStorage-{context}[`EphemeralStorage`], xref:type-PersistentClaimStorage-{context}[`PersistentClaimStorage`], xref:type-JbodStorage-{context}[`JbodStorage`]
|listeners            1.2+<.<|Configures listeners of Kafka brokers.
|xref:type-GenericKafkaListener-{context}[`GenericKafkaListener`] array or xref:type-KafkaListeners-{context}[`KafkaListeners`]
|authorization        1.2+<.<|Authorization configuration for Kafka brokers. The type depends on the value of the `authorization.type` property within the given object, which must be one of [simple, opa, keycloak].
|xref:type-KafkaAuthorizationSimple-{context}[`KafkaAuthorizationSimple`], xref:type-KafkaAuthorizationOpa-{context}[`KafkaAuthorizationOpa`], xref:type-KafkaAuthorizationKeycloak-{context}[`KafkaAuthorizationKeycloak`]
|config               1.2+<.<|Kafka broker config properties with the following prefixes cannot be set: listeners, advertised., broker., listener., host.name, port, inter.broker.listener.name, sasl., ssl., security., password., principal.builder.class, log.dir, zookeeper.connect, zookeeper.set.acl, zookeeper.ssl, zookeeper.clientCnxnSocket, authorizer., super.user, cruise.control.metrics.topic, cruise.control.metrics.reporter.bootstrap.servers (with the exception of: zookeeper.connection.timeout.ms, ssl.cipher.suites, ssl.protocol, ssl.enabled.protocols,cruise.control.metrics.topic.num.partitions, cruise.control.metrics.topic.replication.factor, cruise.control.metrics.topic.retention.ms,cruise.control.metrics.topic.auto.create.retries, cruise.control.metrics.topic.auto.create.timeout.ms).
|map
|rack                 1.2+<.<|Configuration of the `broker.rack` broker config.
|xref:type-Rack-{context}[`Rack`]
|brokerRackInitImage  1.2+<.<|The image of the init container used for initializing the `broker.rack`.
|string
|affinity             1.2+<.<|*The property `affinity` has been deprecated. This feature should now be configured at path `spec.kafka.template.pod.affinity`.* The pod's affinity rules. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#affinity-v1-core[core/v1 affinity].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#affinity-v1-core[Affinity]
|tolerations          1.2+<.<|*The property `tolerations` has been deprecated. This feature should now be configured at path `spec.kafka.template.pod.tolerations`.* The pod's tolerations. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#toleration-v1-core[core/v1 toleration].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#toleration-v1-core[Toleration] array
|livenessProbe        1.2+<.<|Pod liveness checking.
|xref:type-Probe-{context}[`Probe`]
|readinessProbe       1.2+<.<|Pod readiness checking.
|xref:type-Probe-{context}[`Probe`]
|jvmOptions           1.2+<.<|JVM Options for pods.
|xref:type-JvmOptions-{context}[`JvmOptions`]
|jmxOptions           1.2+<.<|JMX Options for Kafka brokers.
|xref:type-KafkaJmxOptions-{context}[`KafkaJmxOptions`]
|resources            1.2+<.<|CPU and memory resources to reserve. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[core/v1 resourcerequirements].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[ResourceRequirements]
|metrics              1.2+<.<|The Prometheus JMX Exporter configuration. See https://github.com/prometheus/jmx_exporter for details of the structure of this configuration.
|map
|logging              1.2+<.<|Logging configuration for Kafka. The type depends on the value of the `logging.type` property within the given object, which must be one of [inline, external].
|xref:type-InlineLogging-{context}[`InlineLogging`], xref:type-ExternalLogging-{context}[`ExternalLogging`]
|tlsSidecar           1.2+<.<|*The property `tlsSidecar` has been deprecated.* TLS sidecar configuration.
|xref:type-TlsSidecar-{context}[`TlsSidecar`]
|template             1.2+<.<|Template for Kafka cluster resources. The template allows users to specify how are the `StatefulSet`, `Pods` and `Services` generated.
|xref:type-KafkaClusterTemplate-{context}[`KafkaClusterTemplate`]
|version              1.2+<.<|The kafka broker version. Defaults to {DefaultKafkaVersion}. Consult the user documentation to understand the process required to upgrade or downgrade the version.
|string
|====

[id='type-EphemeralStorage-{context}']
### `EphemeralStorage` schema reference

Used in: xref:type-JbodStorage-{context}[`JbodStorage`], xref:type-KafkaClusterSpec-{context}[`KafkaClusterSpec`], xref:type-ZookeeperClusterSpec-{context}[`ZookeeperClusterSpec`]


The `type` property is a discriminator that distinguishes the use of the type `EphemeralStorage` from xref:type-PersistentClaimStorage-{context}[`PersistentClaimStorage`].
It must have the value `ephemeral` for the type `EphemeralStorage`.
[options="header"]
|====
|Property          |Description
|id         1.2+<.<|Storage identification number. It is mandatory only for storage volumes defined in a storage of type 'jbod'.
|integer
|sizeLimit  1.2+<.<|When type=ephemeral, defines the total amount of local storage required for this EmptyDir volume (for example 1Gi).
|string
|type       1.2+<.<|Must be `ephemeral`.
|string
|====

[id='type-PersistentClaimStorage-{context}']
### `PersistentClaimStorage` schema reference

Used in: xref:type-JbodStorage-{context}[`JbodStorage`], xref:type-KafkaClusterSpec-{context}[`KafkaClusterSpec`], xref:type-ZookeeperClusterSpec-{context}[`ZookeeperClusterSpec`]


The `type` property is a discriminator that distinguishes the use of the type `PersistentClaimStorage` from xref:type-EphemeralStorage-{context}[`EphemeralStorage`].
It must have the value `persistent-claim` for the type `PersistentClaimStorage`.
[options="header"]
|====
|Property            |Description
|type         1.2+<.<|Must be `persistent-claim`.
|string
|size         1.2+<.<|When type=persistent-claim, defines the size of the persistent volume claim (i.e 1Gi). Mandatory when type=persistent-claim.
|string
|selector     1.2+<.<|Specifies a specific persistent volume to use. It contains key:value pairs representing labels for selecting such a volume.
|map
|deleteClaim  1.2+<.<|Specifies if the persistent volume claim has to be deleted when the cluster is un-deployed.
|boolean
|class        1.2+<.<|The storage class to use for dynamic volume allocation.
|string
|id           1.2+<.<|Storage identification number. It is mandatory only for storage volumes defined in a storage of type 'jbod'.
|integer
|overrides    1.2+<.<|Overrides for individual brokers. The `overrides` field allows to specify a different configuration for different brokers.
|xref:type-PersistentClaimStorageOverride-{context}[`PersistentClaimStorageOverride`] array
|====

[id='type-PersistentClaimStorageOverride-{context}']
### `PersistentClaimStorageOverride` schema reference

Used in: xref:type-PersistentClaimStorage-{context}[`PersistentClaimStorage`]


[options="header"]
|====
|Property       |Description
|class   1.2+<.<|The storage class to use for dynamic volume allocation for this broker.
|string
|broker  1.2+<.<|Id of the kafka broker (broker identifier).
|integer
|====

[id='type-JbodStorage-{context}']
### `JbodStorage` schema reference

Used in: xref:type-KafkaClusterSpec-{context}[`KafkaClusterSpec`]


The `type` property is a discriminator that distinguishes the use of the type `JbodStorage` from xref:type-EphemeralStorage-{context}[`EphemeralStorage`], xref:type-PersistentClaimStorage-{context}[`PersistentClaimStorage`].
It must have the value `jbod` for the type `JbodStorage`.
[options="header"]
|====
|Property        |Description
|type     1.2+<.<|Must be `jbod`.
|string
|volumes  1.2+<.<|List of volumes as Storage objects representing the JBOD disks array.
|xref:type-EphemeralStorage-{context}[`EphemeralStorage`], xref:type-PersistentClaimStorage-{context}[`PersistentClaimStorage`] array
|====

[id='type-GenericKafkaListener-{context}']
### `GenericKafkaListener` schema reference

Used in: xref:type-KafkaClusterSpec-{context}[`KafkaClusterSpec`]

include::../api/io.strimzi.api.kafka.model.listener.arraylistener.GenericKafkaListener.adoc[leveloffset=+1]

[options="header"]
|====
|Property                   |Description
|name                1.2+<.<|Name of the listener. The name will be used to identify the listener and the related Kubernetes objects. The name has to be unique within given a Kafka cluster. The name can consist of lowercase characters and numbers and be up to 11 characters long.
|string
|port                1.2+<.<|Port number used by the listener inside Kafka. The port number has to be unique within a given Kafka cluster. Allowed port numbers are 9092 and higher with the exception of ports 9404 and 9999, which are already used for Prometheus and JMX. Depending on the listener type, the port number might not be the same as the port number that connects Kafka clients.
|integer
|type                1.2+<.<|Type of the listener. Currently the supported types are `internal`, `route`, `loadbalancer`, `nodeport` and `ingress`. 

* `internal` type exposes Kafka internally only within the Kubernetes cluster.
* `route` type uses OpenShift Routes to expose Kafka.
* `loadbalancer` type uses LoadBalancer type services to expose Kafka.
* `nodeport` type uses NodePort type services to expose Kafka.
* `ingress` type uses Kubernetes Nginx Ingress to expose Kafka.
.
|string (one of [ingress, internal, route, loadbalancer, nodeport])
|tls                 1.2+<.<|Enables TLS encryption on the listener. This is a required property.
|boolean
|authentication      1.2+<.<|Authentication configuration for this listener. The type depends on the value of the `authentication.type` property within the given object, which must be one of [tls, scram-sha-512, oauth].
|xref:type-KafkaListenerAuthenticationTls-{context}[`KafkaListenerAuthenticationTls`], xref:type-KafkaListenerAuthenticationScramSha512-{context}[`KafkaListenerAuthenticationScramSha512`], xref:type-KafkaListenerAuthenticationOAuth-{context}[`KafkaListenerAuthenticationOAuth`]
|configuration       1.2+<.<|Additional listener configuration.
|xref:type-GenericKafkaListenerConfiguration-{context}[`GenericKafkaListenerConfiguration`]
|networkPolicyPeers  1.2+<.<|List of peers which should be able to connect to this listener. Peers in this list are combined using a logical OR operation. If this field is empty or missing, all connections will be allowed for this listener. If this field is present and contains at least one item, the listener only allows the traffic which matches at least one item in this list. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#networkpolicypeer-v1-networking-k8s-io[networking.k8s.io/v1 networkpolicypeer].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#networkpolicypeer-v1-networking-k8s-io[NetworkPolicyPeer] array
|====

[id='type-KafkaListenerAuthenticationTls-{context}']
### `KafkaListenerAuthenticationTls` schema reference

Used in: xref:type-GenericKafkaListener-{context}[`GenericKafkaListener`], xref:type-KafkaListenerExternalIngress-{context}[`KafkaListenerExternalIngress`], xref:type-KafkaListenerExternalLoadBalancer-{context}[`KafkaListenerExternalLoadBalancer`], xref:type-KafkaListenerExternalNodePort-{context}[`KafkaListenerExternalNodePort`], xref:type-KafkaListenerExternalRoute-{context}[`KafkaListenerExternalRoute`], xref:type-KafkaListenerPlain-{context}[`KafkaListenerPlain`], xref:type-KafkaListenerTls-{context}[`KafkaListenerTls`]


The `type` property is a discriminator that distinguishes the use of the type `KafkaListenerAuthenticationTls` from xref:type-KafkaListenerAuthenticationScramSha512-{context}[`KafkaListenerAuthenticationScramSha512`], xref:type-KafkaListenerAuthenticationOAuth-{context}[`KafkaListenerAuthenticationOAuth`].
It must have the value `tls` for the type `KafkaListenerAuthenticationTls`.
[options="header"]
|====
|Property     |Description
|type  1.2+<.<|Must be `tls`.
|string
|====

[id='type-KafkaListenerAuthenticationScramSha512-{context}']
### `KafkaListenerAuthenticationScramSha512` schema reference

Used in: xref:type-GenericKafkaListener-{context}[`GenericKafkaListener`], xref:type-KafkaListenerExternalIngress-{context}[`KafkaListenerExternalIngress`], xref:type-KafkaListenerExternalLoadBalancer-{context}[`KafkaListenerExternalLoadBalancer`], xref:type-KafkaListenerExternalNodePort-{context}[`KafkaListenerExternalNodePort`], xref:type-KafkaListenerExternalRoute-{context}[`KafkaListenerExternalRoute`], xref:type-KafkaListenerPlain-{context}[`KafkaListenerPlain`], xref:type-KafkaListenerTls-{context}[`KafkaListenerTls`]


The `type` property is a discriminator that distinguishes the use of the type `KafkaListenerAuthenticationScramSha512` from xref:type-KafkaListenerAuthenticationTls-{context}[`KafkaListenerAuthenticationTls`], xref:type-KafkaListenerAuthenticationOAuth-{context}[`KafkaListenerAuthenticationOAuth`].
It must have the value `scram-sha-512` for the type `KafkaListenerAuthenticationScramSha512`.
[options="header"]
|====
|Property     |Description
|type  1.2+<.<|Must be `scram-sha-512`.
|string
|====

[id='type-KafkaListenerAuthenticationOAuth-{context}']
### `KafkaListenerAuthenticationOAuth` schema reference

Used in: xref:type-GenericKafkaListener-{context}[`GenericKafkaListener`], xref:type-KafkaListenerExternalIngress-{context}[`KafkaListenerExternalIngress`], xref:type-KafkaListenerExternalLoadBalancer-{context}[`KafkaListenerExternalLoadBalancer`], xref:type-KafkaListenerExternalNodePort-{context}[`KafkaListenerExternalNodePort`], xref:type-KafkaListenerExternalRoute-{context}[`KafkaListenerExternalRoute`], xref:type-KafkaListenerPlain-{context}[`KafkaListenerPlain`], xref:type-KafkaListenerTls-{context}[`KafkaListenerTls`]


The `type` property is a discriminator that distinguishes the use of the type `KafkaListenerAuthenticationOAuth` from xref:type-KafkaListenerAuthenticationTls-{context}[`KafkaListenerAuthenticationTls`], xref:type-KafkaListenerAuthenticationScramSha512-{context}[`KafkaListenerAuthenticationScramSha512`].
It must have the value `oauth` for the type `KafkaListenerAuthenticationOAuth`.
[options="header"]
|====
|Property                                  |Description
|accessTokenIsJwt                   1.2+<.<|Configure whether the access token is treated as JWT. This must be set to `false` if the authorization server returns opaque tokens. Defaults to `true`.
|boolean
|checkAccessTokenType               1.2+<.<|Configure whether the access token type check is performed or not. This should be set to `false` if the authorization server does not include 'typ' claim in JWT token. Defaults to `true`.
|boolean
|checkIssuer                        1.2+<.<|Enable or disable issuer checking. By default issuer is checked using the value configured by `validIssuerUri`. Default value is `true`.
|boolean
|clientId                           1.2+<.<|OAuth Client ID which the Kafka broker can use to authenticate against the authorization server and use the introspect endpoint URI.
|string
|clientSecret                       1.2+<.<|Link to Kubernetes Secret containing the OAuth client secret which the Kafka broker can use to authenticate against the authorization server and use the introspect endpoint URI.
|xref:type-GenericSecretSource-{context}[`GenericSecretSource`]
|disableTlsHostnameVerification     1.2+<.<|Enable or disable TLS hostname verification. Default value is `false`.
|boolean
|enableECDSA                        1.2+<.<|Enable or disable ECDSA support by installing BouncyCastle crypto provider. Default value is `false`.
|boolean
|fallbackUserNameClaim              1.2+<.<|The fallback username claim to be used for the user id if the claim specified by `userNameClaim` is not present. This is useful when `client_credentials` authentication only results in the client id being provided in another claim. It only takes effect if `userNameClaim` is set.
|string
|fallbackUserNamePrefix             1.2+<.<|The prefix to use with the value of `fallbackUserNameClaim` to construct the user id. This only takes effect if `fallbackUserNameClaim` is true, and the value is present for the claim. Mapping usernames and client ids into the same user id space is useful in preventing name collisions.
|string
|introspectionEndpointUri           1.2+<.<|URI of the token introspection endpoint which can be used to validate opaque non-JWT tokens.
|string
|jwksEndpointUri                    1.2+<.<|URI of the JWKS certificate endpoint, which can be used for local JWT validation.
|string
|jwksExpirySeconds                  1.2+<.<|Configures how often are the JWKS certificates considered valid. The expiry interval has to be at least 60 seconds longer then the refresh interval specified in `jwksRefreshSeconds`. Defaults to 360 seconds.
|integer
|jwksMinRefreshPauseSeconds         1.2+<.<|The minimum pause between two consecutive refreshes. When an unknown signing key is encountered the refresh is scheduled immediately, but will always wait for this minimum pause. Defaults to 1 second.
|integer
|jwksRefreshSeconds                 1.2+<.<|Configures how often are the JWKS certificates refreshed. The refresh interval has to be at least 60 seconds shorter then the expiry interval specified in `jwksExpirySeconds`. Defaults to 300 seconds.
|integer
|maxSecondsWithoutReauthentication  1.2+<.<|Maximum number of seconds the authenticated session remains valid without re-authentication. This enables Apache Kafka re-authentication feature, and causes sessions to expire when the access token expires. If the access token expires before max time or if max time is reached, the client has to re-authenticate, otherwise the server will drop the connection. Not set by default - the authenticated session does not expire when the access token expires.
|integer
|tlsTrustedCertificates             1.2+<.<|Trusted certificates for TLS connection to the OAuth server.
|xref:type-CertSecretSource-{context}[`CertSecretSource`] array
|type                               1.2+<.<|Must be `oauth`.
|string
|userInfoEndpointUri                1.2+<.<|URI of the User Info Endpoint to use as a fallback to obtaining the user id when the Introspection Endpoint does not return information that can be used for the user id. 
|string
|userNameClaim                      1.2+<.<|Name of the claim from the JWT authentication token, Introspection Endpoint response or User Info Endpoint response which will be used to extract the user id. Defaults to `sub`.
|string
|validIssuerUri                     1.2+<.<|URI of the token issuer used for authentication.
|string
|validTokenType                     1.2+<.<|Valid value for the `token_type` attribute returned by the Introspection Endpoint. No default value, and not checked by default.
|string
|====

[id='type-GenericSecretSource-{context}']
### `GenericSecretSource` schema reference

Used in: xref:type-KafkaClientAuthenticationOAuth-{context}[`KafkaClientAuthenticationOAuth`], xref:type-KafkaListenerAuthenticationOAuth-{context}[`KafkaListenerAuthenticationOAuth`]


[options="header"]
|====
|Property           |Description
|key         1.2+<.<|The key under which the secret value is stored in the Kubernetes Secret.
|string
|secretName  1.2+<.<|The name of the Kubernetes Secret containing the secret value.
|string
|====

[id='type-CertSecretSource-{context}']
### `CertSecretSource` schema reference

Used in: xref:type-KafkaAuthorizationKeycloak-{context}[`KafkaAuthorizationKeycloak`], xref:type-KafkaBridgeTls-{context}[`KafkaBridgeTls`], xref:type-KafkaClientAuthenticationOAuth-{context}[`KafkaClientAuthenticationOAuth`], xref:type-KafkaConnectTls-{context}[`KafkaConnectTls`], xref:type-KafkaListenerAuthenticationOAuth-{context}[`KafkaListenerAuthenticationOAuth`], xref:type-KafkaMirrorMaker2Tls-{context}[`KafkaMirrorMaker2Tls`], xref:type-KafkaMirrorMakerTls-{context}[`KafkaMirrorMakerTls`]


[options="header"]
|====
|Property            |Description
|certificate  1.2+<.<|The name of the file certificate in the Secret.
|string
|secretName   1.2+<.<|The name of the Secret containing the certificate.
|string
|====

[id='type-GenericKafkaListenerConfiguration-{context}']
### `GenericKafkaListenerConfiguration` schema reference

Used in: xref:type-GenericKafkaListener-{context}[`GenericKafkaListener`]

include::../api/io.strimzi.api.kafka.model.listener.arraylistener.GenericKafkaListenerConfiguration.adoc[leveloffset=+1]

[options="header"]
|====
|Property                             |Description
|brokerCertChainAndKey         1.2+<.<|Reference to the `Secret` which holds the certificate and private key pair which will be used for this listener. The certificate can optionally contain the whole chain. This field can be used only with listeners with enabled TLS encryption.
|xref:type-CertAndKeySecretSource-{context}[`CertAndKeySecretSource`]
|externalTrafficPolicy         1.2+<.<|Specifies whether the service routes external traffic to node-local or cluster-wide endpoints. `Cluster` may cause a second hop to another node and obscures the client source IP. `Local` avoids a second hop for LoadBalancer and Nodeport type services and preserves the client source IP (when supported by the infrastructure). If unspecified, Kubernetes will use `Cluster` as the default.This field can be used only with `loadbalancer` or `nodeport` type listener.
|string (one of [Local, Cluster])
|loadBalancerSourceRanges      1.2+<.<|A list of CIDR ranges (for example `10.0.0.0/8` or `130.211.204.1/32`) from which clients can connect to load balancer type listeners. If supported by the platform, traffic through the loadbalancer is restricted to the specified CIDR ranges. This field is applicable only for loadbalancer type services and is ignored if the cloud provider does not support the feature. For more information, see https://v1-17.docs.kubernetes.io/docs/tasks/access-application-cluster/configure-cloud-provider-firewall/. This field can be used only with `loadbalancer` type listener.
|string array
|bootstrap                     1.2+<.<|Bootstrap configuration.
|xref:type-GenericKafkaListenerConfigurationBootstrap-{context}[`GenericKafkaListenerConfigurationBootstrap`]
|brokers                       1.2+<.<|Per-broker configurations.
|xref:type-GenericKafkaListenerConfigurationBroker-{context}[`GenericKafkaListenerConfigurationBroker`] array
|class                         1.2+<.<|Configures the `Ingress` class that defines which `Ingress` controller will be used. If not set, the `Ingress` class is set to `nginx`. This field can be used only with `ingress` type listener.
|string
|preferredNodePortAddressType  1.2+<.<|Defines which address type should be used as the node address. Available types are: `ExternalDNS`, `ExternalIP`, `InternalDNS`, `InternalIP` and `Hostname`. By default, the addresses will be used in the following order (the first one found will be used):
* `ExternalDNS`
* `ExternalIP`
* `InternalDNS`
* `InternalIP`
* `Hostname`

This field can be used to select the address type which will be used as the preferred type and checked first. In case no address will be found for this address type, the other types will be used in the default order.This field can be used only with `nodeport` type listener..
|string (one of [ExternalDNS, ExternalIP, Hostname, InternalIP, InternalDNS])
|useServiceDnsDomain           1.2+<.<|Configures whether the Kubernetes service DNS domain should be used or not. If set to `true`, the generated addresses with contain the service DNS domain suffix (by default `.cluster.local`, can be configured using environment variable `KUBERNETES_SERVICE_DNS_DOMAIN`). Defaults to `false`.This field can be used only with `internal` type listener.
|boolean
|====

[id='type-CertAndKeySecretSource-{context}']
### `CertAndKeySecretSource` schema reference

Used in: xref:type-GenericKafkaListenerConfiguration-{context}[`GenericKafkaListenerConfiguration`], xref:type-IngressListenerConfiguration-{context}[`IngressListenerConfiguration`], xref:type-KafkaClientAuthenticationTls-{context}[`KafkaClientAuthenticationTls`], xref:type-KafkaListenerExternalConfiguration-{context}[`KafkaListenerExternalConfiguration`], xref:type-NodePortListenerConfiguration-{context}[`NodePortListenerConfiguration`], xref:type-TlsListenerConfiguration-{context}[`TlsListenerConfiguration`]


[options="header"]
|====
|Property            |Description
|certificate  1.2+<.<|The name of the file certificate in the Secret.
|string
|key          1.2+<.<|The name of the private key in the Secret.
|string
|secretName   1.2+<.<|The name of the Secret containing the certificate.
|string
|====

[id='type-GenericKafkaListenerConfigurationBootstrap-{context}']
### `GenericKafkaListenerConfigurationBootstrap` schema reference

Used in: xref:type-GenericKafkaListenerConfiguration-{context}[`GenericKafkaListenerConfiguration`]

include::../api/io.strimzi.api.kafka.model.listener.arraylistener.GenericKafkaListenerConfigurationBootstrap.adoc[leveloffset=+1]

[options="header"]
|====
|Property                 |Description
|alternativeNames  1.2+<.<|Additional alternative names for the bootstrap service. The alternative names will be added to the list of subject alternative names of the TLS certificates.
|string array
|host              1.2+<.<|The bootstrap host. This field will be used in the Ingress resource or in the Route resource to specify the desired hostname. This field can be used only with `route` (optional) or `ingress` (required) type listeners.
|string
|nodePort          1.2+<.<|Node port for the bootstrap service. This field can be used only with `nodeport` type listener.
|integer
|loadBalancerIP    1.2+<.<|The loadbalancer is requested with the IP address specified in this field. This feature depends on whether the underlying cloud provider supports specifying the `loadBalancerIP` when a load balancer is created. This field is ignored if the cloud provider does not support the feature.This field can be used only with `loadbalancer` type listener.
|string
|annotations       1.2+<.<|Annotations that will be added to the `Ingress` or `Service` resource. You can use this field to configure DNS providers such as External DNS. This field can be used only with `loadbalancer`, `nodeport`, or `ingress` type listeners.
|map
|====

[id='type-GenericKafkaListenerConfigurationBroker-{context}']
### `GenericKafkaListenerConfigurationBroker` schema reference

Used in: xref:type-GenericKafkaListenerConfiguration-{context}[`GenericKafkaListenerConfiguration`]

include::../api/io.strimzi.api.kafka.model.listener.arraylistener.GenericKafkaListenerConfigurationBroker.adoc[leveloffset=+1]

[options="header"]
|====
|Property               |Description
|broker          1.2+<.<|ID of the kafka broker (broker identifier). Broker IDs start from 0 and correspond to the number of broker replicas.
|integer
|advertisedHost  1.2+<.<|The host name which will be used in the brokers' `advertised.brokers`.
|string
|advertisedPort  1.2+<.<|The port number which will be used in the brokers' `advertised.brokers`.
|integer
|host            1.2+<.<|The broker host. This field will be used in the Ingress resource or in the Route resource to specify the desired hostname. This field can be used only with `route` (optional) or `ingress` (required) type listeners.
|string
|nodePort        1.2+<.<|Node port for the per-broker service. This field can be used only with `nodeport` type listener.
|integer
|loadBalancerIP  1.2+<.<|The loadbalancer is requested with the IP address specified in this field. This feature depends on whether the underlying cloud provider supports specifying the `loadBalancerIP` when a load balancer is created. This field is ignored if the cloud provider does not support the feature.This field can be used only with `loadbalancer` type listener.
|string
|annotations     1.2+<.<|Annotations that will be added to the `Ingress` or `Service` resource. You can use this field to configure DNS providers such as External DNS. This field can be used only with `loadbalancer`, `nodeport`, or `ingress` type listeners.
|map
|====

[id='type-KafkaListeners-{context}']
### `KafkaListeners` schema reference

*The type `KafkaListeners` has been deprecated.*
Please use xref:type-GenericKafkaListener-{context}[`GenericKafkaListener`] instead.

Used in: xref:type-KafkaClusterSpec-{context}[`KafkaClusterSpec`]

Refer to link:{BookURLUsingPrevious}[previous documentation] for example configuration.

[options="header"]
|====
|Property         |Description
|plain     1.2+<.<|Configures plain listener on port 9092.
|xref:type-KafkaListenerPlain-{context}[`KafkaListenerPlain`]
|tls       1.2+<.<|Configures TLS listener on port 9093.
|xref:type-KafkaListenerTls-{context}[`KafkaListenerTls`]
|external  1.2+<.<|Configures external listener on port 9094. The type depends on the value of the `external.type` property within the given object, which must be one of [route, loadbalancer, nodeport, ingress].
|xref:type-KafkaListenerExternalRoute-{context}[`KafkaListenerExternalRoute`], xref:type-KafkaListenerExternalLoadBalancer-{context}[`KafkaListenerExternalLoadBalancer`], xref:type-KafkaListenerExternalNodePort-{context}[`KafkaListenerExternalNodePort`], xref:type-KafkaListenerExternalIngress-{context}[`KafkaListenerExternalIngress`]
|====

[id='type-KafkaListenerPlain-{context}']
### `KafkaListenerPlain` schema reference

Used in: xref:type-KafkaListeners-{context}[`KafkaListeners`]


[options="header"]
|====
|Property                   |Description
|authentication      1.2+<.<|Authentication configuration for this listener. Since this listener does not use TLS transport you cannot configure an authentication with `type: tls`. The type depends on the value of the `authentication.type` property within the given object, which must be one of [tls, scram-sha-512, oauth].
|xref:type-KafkaListenerAuthenticationTls-{context}[`KafkaListenerAuthenticationTls`], xref:type-KafkaListenerAuthenticationScramSha512-{context}[`KafkaListenerAuthenticationScramSha512`], xref:type-KafkaListenerAuthenticationOAuth-{context}[`KafkaListenerAuthenticationOAuth`]
|networkPolicyPeers  1.2+<.<|List of peers which should be able to connect to this listener. Peers in this list are combined using a logical OR operation. If this field is empty or missing, all connections will be allowed for this listener. If this field is present and contains at least one item, the listener only allows the traffic which matches at least one item in this list. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#networkpolicypeer-v1-networking-k8s-io[networking.k8s.io/v1 networkpolicypeer].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#networkpolicypeer-v1-networking-k8s-io[NetworkPolicyPeer] array
|====

[id='type-KafkaListenerTls-{context}']
### `KafkaListenerTls` schema reference

Used in: xref:type-KafkaListeners-{context}[`KafkaListeners`]


[options="header"]
|====
|Property                   |Description
|authentication      1.2+<.<|Authentication configuration for this listener. The type depends on the value of the `authentication.type` property within the given object, which must be one of [tls, scram-sha-512, oauth].
|xref:type-KafkaListenerAuthenticationTls-{context}[`KafkaListenerAuthenticationTls`], xref:type-KafkaListenerAuthenticationScramSha512-{context}[`KafkaListenerAuthenticationScramSha512`], xref:type-KafkaListenerAuthenticationOAuth-{context}[`KafkaListenerAuthenticationOAuth`]
|configuration       1.2+<.<|Configuration of TLS listener.
|xref:type-TlsListenerConfiguration-{context}[`TlsListenerConfiguration`]
|networkPolicyPeers  1.2+<.<|List of peers which should be able to connect to this listener. Peers in this list are combined using a logical OR operation. If this field is empty or missing, all connections will be allowed for this listener. If this field is present and contains at least one item, the listener only allows the traffic which matches at least one item in this list. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#networkpolicypeer-v1-networking-k8s-io[networking.k8s.io/v1 networkpolicypeer].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#networkpolicypeer-v1-networking-k8s-io[NetworkPolicyPeer] array
|====

[id='type-TlsListenerConfiguration-{context}']
### `TlsListenerConfiguration` schema reference

Used in: xref:type-KafkaListenerTls-{context}[`KafkaListenerTls`]


[options="header"]
|====
|Property                      |Description
|brokerCertChainAndKey  1.2+<.<|Reference to the `Secret` which holds the certificate and private key pair. The certificate can optionally contain the whole chain.
|xref:type-CertAndKeySecretSource-{context}[`CertAndKeySecretSource`]
|====

[id='type-KafkaListenerExternalRoute-{context}']
### `KafkaListenerExternalRoute` schema reference

Used in: xref:type-KafkaListeners-{context}[`KafkaListeners`]


The `type` property is a discriminator that distinguishes the use of the type `KafkaListenerExternalRoute` from xref:type-KafkaListenerExternalLoadBalancer-{context}[`KafkaListenerExternalLoadBalancer`], xref:type-KafkaListenerExternalNodePort-{context}[`KafkaListenerExternalNodePort`], xref:type-KafkaListenerExternalIngress-{context}[`KafkaListenerExternalIngress`].
It must have the value `route` for the type `KafkaListenerExternalRoute`.
[options="header"]
|====
|Property                   |Description
|type                1.2+<.<|Must be `route`.
|string
|authentication      1.2+<.<|Authentication configuration for Kafka brokers. The type depends on the value of the `authentication.type` property within the given object, which must be one of [tls, scram-sha-512, oauth].
|xref:type-KafkaListenerAuthenticationTls-{context}[`KafkaListenerAuthenticationTls`], xref:type-KafkaListenerAuthenticationScramSha512-{context}[`KafkaListenerAuthenticationScramSha512`], xref:type-KafkaListenerAuthenticationOAuth-{context}[`KafkaListenerAuthenticationOAuth`]
|overrides           1.2+<.<|Overrides for external bootstrap and broker services and externally advertised addresses.
|xref:type-RouteListenerOverride-{context}[`RouteListenerOverride`]
|configuration       1.2+<.<|External listener configuration.
|xref:type-KafkaListenerExternalConfiguration-{context}[`KafkaListenerExternalConfiguration`]
|networkPolicyPeers  1.2+<.<|List of peers which should be able to connect to this listener. Peers in this list are combined using a logical OR operation. If this field is empty or missing, all connections will be allowed for this listener. If this field is present and contains at least one item, the listener only allows the traffic which matches at least one item in this list. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#networkpolicypeer-v1-networking-k8s-io[networking.k8s.io/v1 networkpolicypeer].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#networkpolicypeer-v1-networking-k8s-io[NetworkPolicyPeer] array
|====

[id='type-RouteListenerOverride-{context}']
### `RouteListenerOverride` schema reference

Used in: xref:type-KafkaListenerExternalRoute-{context}[`KafkaListenerExternalRoute`]


[options="header"]
|====
|Property          |Description
|bootstrap  1.2+<.<|External bootstrap service configuration.
|xref:type-RouteListenerBootstrapOverride-{context}[`RouteListenerBootstrapOverride`]
|brokers    1.2+<.<|External broker services configuration.
|xref:type-RouteListenerBrokerOverride-{context}[`RouteListenerBrokerOverride`] array
|====

[id='type-RouteListenerBootstrapOverride-{context}']
### `RouteListenerBootstrapOverride` schema reference

Used in: xref:type-RouteListenerOverride-{context}[`RouteListenerOverride`]


[options="header"]
|====
|Property        |Description
|address  1.2+<.<|Additional address name for the bootstrap service. The address will be added to the list of subject alternative names of the TLS certificates.
|string
|host     1.2+<.<|Host for the bootstrap route. This field will be used in the `spec.host` field of the OpenShift Route.
|string
|====

[id='type-RouteListenerBrokerOverride-{context}']
### `RouteListenerBrokerOverride` schema reference

Used in: xref:type-RouteListenerOverride-{context}[`RouteListenerOverride`]


[options="header"]
|====
|Property               |Description
|broker          1.2+<.<|Id of the kafka broker (broker identifier).
|integer
|advertisedHost  1.2+<.<|The host name which will be used in the brokers' `advertised.brokers`.
|string
|advertisedPort  1.2+<.<|The port number which will be used in the brokers' `advertised.brokers`.
|integer
|host            1.2+<.<|Host for the broker route. This field will be used in the `spec.host` field of the OpenShift Route.
|string
|====

[id='type-KafkaListenerExternalConfiguration-{context}']
### `KafkaListenerExternalConfiguration` schema reference

Used in: xref:type-KafkaListenerExternalLoadBalancer-{context}[`KafkaListenerExternalLoadBalancer`], xref:type-KafkaListenerExternalRoute-{context}[`KafkaListenerExternalRoute`]


[options="header"]
|====
|Property                      |Description
|brokerCertChainAndKey  1.2+<.<|Reference to the `Secret` which holds the certificate and private key pair. The certificate can optionally contain the whole chain.
|xref:type-CertAndKeySecretSource-{context}[`CertAndKeySecretSource`]
|====

[id='type-KafkaListenerExternalLoadBalancer-{context}']
### `KafkaListenerExternalLoadBalancer` schema reference

Used in: xref:type-KafkaListeners-{context}[`KafkaListeners`]


The `type` property is a discriminator that distinguishes the use of the type `KafkaListenerExternalLoadBalancer` from xref:type-KafkaListenerExternalRoute-{context}[`KafkaListenerExternalRoute`], xref:type-KafkaListenerExternalNodePort-{context}[`KafkaListenerExternalNodePort`], xref:type-KafkaListenerExternalIngress-{context}[`KafkaListenerExternalIngress`].
It must have the value `loadbalancer` for the type `KafkaListenerExternalLoadBalancer`.
[options="header"]
|====
|Property                   |Description
|type                1.2+<.<|Must be `loadbalancer`.
|string
|authentication      1.2+<.<|Authentication configuration for Kafka brokers. The type depends on the value of the `authentication.type` property within the given object, which must be one of [tls, scram-sha-512, oauth].
|xref:type-KafkaListenerAuthenticationTls-{context}[`KafkaListenerAuthenticationTls`], xref:type-KafkaListenerAuthenticationScramSha512-{context}[`KafkaListenerAuthenticationScramSha512`], xref:type-KafkaListenerAuthenticationOAuth-{context}[`KafkaListenerAuthenticationOAuth`]
|overrides           1.2+<.<|Overrides for external bootstrap and broker services and externally advertised addresses.
|xref:type-LoadBalancerListenerOverride-{context}[`LoadBalancerListenerOverride`]
|configuration       1.2+<.<|External listener configuration.
|xref:type-KafkaListenerExternalConfiguration-{context}[`KafkaListenerExternalConfiguration`]
|networkPolicyPeers  1.2+<.<|List of peers which should be able to connect to this listener. Peers in this list are combined using a logical OR operation. If this field is empty or missing, all connections will be allowed for this listener. If this field is present and contains at least one item, the listener only allows the traffic which matches at least one item in this list. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#networkpolicypeer-v1-networking-k8s-io[networking.k8s.io/v1 networkpolicypeer].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#networkpolicypeer-v1-networking-k8s-io[NetworkPolicyPeer] array
|tls                 1.2+<.<|Enables TLS encryption on the listener. By default set to `true` for enabled TLS encryption.
|boolean
|====

[id='type-LoadBalancerListenerOverride-{context}']
### `LoadBalancerListenerOverride` schema reference

Used in: xref:type-KafkaListenerExternalLoadBalancer-{context}[`KafkaListenerExternalLoadBalancer`]


[options="header"]
|====
|Property          |Description
|bootstrap  1.2+<.<|External bootstrap service configuration.
|xref:type-LoadBalancerListenerBootstrapOverride-{context}[`LoadBalancerListenerBootstrapOverride`]
|brokers    1.2+<.<|External broker services configuration.
|xref:type-LoadBalancerListenerBrokerOverride-{context}[`LoadBalancerListenerBrokerOverride`] array
|====

[id='type-LoadBalancerListenerBootstrapOverride-{context}']
### `LoadBalancerListenerBootstrapOverride` schema reference

Used in: xref:type-LoadBalancerListenerOverride-{context}[`LoadBalancerListenerOverride`]


[options="header"]
|====
|Property               |Description
|address         1.2+<.<|Additional address name for the bootstrap service. The address will be added to the list of subject alternative names of the TLS certificates.
|string
|dnsAnnotations  1.2+<.<|Annotations that will be added to the `Service` resource. You can use this field to configure DNS providers such as External DNS.
|map
|loadBalancerIP  1.2+<.<|The loadbalancer is requested with the IP address specified in this field. This feature depends on whether the underlying cloud provider supports specifying the `loadBalancerIP` when a load balancer is created. This field is ignored if the cloud provider does not support the feature.
|string
|====

[id='type-LoadBalancerListenerBrokerOverride-{context}']
### `LoadBalancerListenerBrokerOverride` schema reference

Used in: xref:type-LoadBalancerListenerOverride-{context}[`LoadBalancerListenerOverride`]


[options="header"]
|====
|Property               |Description
|broker          1.2+<.<|Id of the kafka broker (broker identifier).
|integer
|advertisedHost  1.2+<.<|The host name which will be used in the brokers' `advertised.brokers`.
|string
|advertisedPort  1.2+<.<|The port number which will be used in the brokers' `advertised.brokers`.
|integer
|dnsAnnotations  1.2+<.<|Annotations that will be added to the `Service` resources for individual brokers. You can use this field to configure DNS providers such as External DNS.
|map
|loadBalancerIP  1.2+<.<|The loadbalancer is requested with the IP address specified in this field. This feature depends on whether the underlying cloud provider supports specifying the `loadBalancerIP` when a load balancer is created. This field is ignored if the cloud provider does not support the feature.
|string
|====

[id='type-KafkaListenerExternalNodePort-{context}']
### `KafkaListenerExternalNodePort` schema reference

Used in: xref:type-KafkaListeners-{context}[`KafkaListeners`]


The `type` property is a discriminator that distinguishes the use of the type `KafkaListenerExternalNodePort` from xref:type-KafkaListenerExternalRoute-{context}[`KafkaListenerExternalRoute`], xref:type-KafkaListenerExternalLoadBalancer-{context}[`KafkaListenerExternalLoadBalancer`], xref:type-KafkaListenerExternalIngress-{context}[`KafkaListenerExternalIngress`].
It must have the value `nodeport` for the type `KafkaListenerExternalNodePort`.
[options="header"]
|====
|Property                   |Description
|type                1.2+<.<|Must be `nodeport`.
|string
|authentication      1.2+<.<|Authentication configuration for Kafka brokers. The type depends on the value of the `authentication.type` property within the given object, which must be one of [tls, scram-sha-512, oauth].
|xref:type-KafkaListenerAuthenticationTls-{context}[`KafkaListenerAuthenticationTls`], xref:type-KafkaListenerAuthenticationScramSha512-{context}[`KafkaListenerAuthenticationScramSha512`], xref:type-KafkaListenerAuthenticationOAuth-{context}[`KafkaListenerAuthenticationOAuth`]
|overrides           1.2+<.<|Overrides for external bootstrap and broker services and externally advertised addresses.
|xref:type-NodePortListenerOverride-{context}[`NodePortListenerOverride`]
|configuration       1.2+<.<|External listener configuration.
|xref:type-NodePortListenerConfiguration-{context}[`NodePortListenerConfiguration`]
|networkPolicyPeers  1.2+<.<|List of peers which should be able to connect to this listener. Peers in this list are combined using a logical OR operation. If this field is empty or missing, all connections will be allowed for this listener. If this field is present and contains at least one item, the listener only allows the traffic which matches at least one item in this list. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#networkpolicypeer-v1-networking-k8s-io[networking.k8s.io/v1 networkpolicypeer].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#networkpolicypeer-v1-networking-k8s-io[NetworkPolicyPeer] array
|tls                 1.2+<.<|Enables TLS encryption on the listener. By default set to `true` for enabled TLS encryption.
|boolean
|====

[id='type-NodePortListenerOverride-{context}']
### `NodePortListenerOverride` schema reference

Used in: xref:type-KafkaListenerExternalNodePort-{context}[`KafkaListenerExternalNodePort`]


[options="header"]
|====
|Property          |Description
|bootstrap  1.2+<.<|External bootstrap service configuration.
|xref:type-NodePortListenerBootstrapOverride-{context}[`NodePortListenerBootstrapOverride`]
|brokers    1.2+<.<|External broker services configuration.
|xref:type-NodePortListenerBrokerOverride-{context}[`NodePortListenerBrokerOverride`] array
|====

[id='type-NodePortListenerBootstrapOverride-{context}']
### `NodePortListenerBootstrapOverride` schema reference

Used in: xref:type-NodePortListenerOverride-{context}[`NodePortListenerOverride`]


[options="header"]
|====
|Property               |Description
|address         1.2+<.<|Additional address name for the bootstrap service. The address will be added to the list of subject alternative names of the TLS certificates.
|string
|dnsAnnotations  1.2+<.<|Annotations that will be added to the `Service` resource. You can use this field to configure DNS providers such as External DNS.
|map
|nodePort        1.2+<.<|Node port for the bootstrap service.
|integer
|====

[id='type-NodePortListenerBrokerOverride-{context}']
### `NodePortListenerBrokerOverride` schema reference

Used in: xref:type-NodePortListenerOverride-{context}[`NodePortListenerOverride`]


[options="header"]
|====
|Property               |Description
|broker          1.2+<.<|Id of the kafka broker (broker identifier).
|integer
|advertisedHost  1.2+<.<|The host name which will be used in the brokers' `advertised.brokers`.
|string
|advertisedPort  1.2+<.<|The port number which will be used in the brokers' `advertised.brokers`.
|integer
|nodePort        1.2+<.<|Node port for the broker service.
|integer
|dnsAnnotations  1.2+<.<|Annotations that will be added to the `Service` resources for individual brokers. You can use this field to configure DNS providers such as External DNS.
|map
|====

[id='type-NodePortListenerConfiguration-{context}']
### `NodePortListenerConfiguration` schema reference

Used in: xref:type-KafkaListenerExternalNodePort-{context}[`KafkaListenerExternalNodePort`]


[options="header"]
|====
|Property                      |Description
|brokerCertChainAndKey  1.2+<.<|Reference to the `Secret` which holds the certificate and private key pair. The certificate can optionally contain the whole chain.
|xref:type-CertAndKeySecretSource-{context}[`CertAndKeySecretSource`]
|preferredAddressType   1.2+<.<|Defines which address type should be used as the node address. Available types are: `ExternalDNS`, `ExternalIP`, `InternalDNS`, `InternalIP` and `Hostname`. By default, the addresses will be used in the following order (the first one found will be used):
* `ExternalDNS`
* `ExternalIP`
* `InternalDNS`
* `InternalIP`
* `Hostname`

This field can be used to select the address type which will be used as the preferred type and checked first. In case no address will be found for this address type, the other types will be used in the default order..
|string (one of [ExternalDNS, ExternalIP, Hostname, InternalIP, InternalDNS])
|====

[id='type-KafkaListenerExternalIngress-{context}']
### `KafkaListenerExternalIngress` schema reference

Used in: xref:type-KafkaListeners-{context}[`KafkaListeners`]


The `type` property is a discriminator that distinguishes the use of the type `KafkaListenerExternalIngress` from xref:type-KafkaListenerExternalRoute-{context}[`KafkaListenerExternalRoute`], xref:type-KafkaListenerExternalLoadBalancer-{context}[`KafkaListenerExternalLoadBalancer`], xref:type-KafkaListenerExternalNodePort-{context}[`KafkaListenerExternalNodePort`].
It must have the value `ingress` for the type `KafkaListenerExternalIngress`.
[options="header"]
|====
|Property                   |Description
|type                1.2+<.<|Must be `ingress`.
|string
|authentication      1.2+<.<|Authentication configuration for Kafka brokers. The type depends on the value of the `authentication.type` property within the given object, which must be one of [tls, scram-sha-512, oauth].
|xref:type-KafkaListenerAuthenticationTls-{context}[`KafkaListenerAuthenticationTls`], xref:type-KafkaListenerAuthenticationScramSha512-{context}[`KafkaListenerAuthenticationScramSha512`], xref:type-KafkaListenerAuthenticationOAuth-{context}[`KafkaListenerAuthenticationOAuth`]
|class               1.2+<.<|Configures the `Ingress` class that defines which `Ingress` controller will be used. If not set, the `Ingress` class is set to `nginx`.
|string
|configuration       1.2+<.<|External listener configuration.
|xref:type-IngressListenerConfiguration-{context}[`IngressListenerConfiguration`]
|networkPolicyPeers  1.2+<.<|List of peers which should be able to connect to this listener. Peers in this list are combined using a logical OR operation. If this field is empty or missing, all connections will be allowed for this listener. If this field is present and contains at least one item, the listener only allows the traffic which matches at least one item in this list. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#networkpolicypeer-v1-networking-k8s-io[networking.k8s.io/v1 networkpolicypeer].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#networkpolicypeer-v1-networking-k8s-io[NetworkPolicyPeer] array
|====

[id='type-IngressListenerConfiguration-{context}']
### `IngressListenerConfiguration` schema reference

Used in: xref:type-KafkaListenerExternalIngress-{context}[`KafkaListenerExternalIngress`]


[options="header"]
|====
|Property                      |Description
|bootstrap              1.2+<.<|External bootstrap ingress configuration.
|xref:type-IngressListenerBootstrapConfiguration-{context}[`IngressListenerBootstrapConfiguration`]
|brokers                1.2+<.<|External broker ingress configuration.
|xref:type-IngressListenerBrokerConfiguration-{context}[`IngressListenerBrokerConfiguration`] array
|brokerCertChainAndKey  1.2+<.<|Reference to the `Secret` which holds the certificate and private key pair. The certificate can optionally contain the whole chain.
|xref:type-CertAndKeySecretSource-{context}[`CertAndKeySecretSource`]
|====

[id='type-IngressListenerBootstrapConfiguration-{context}']
### `IngressListenerBootstrapConfiguration` schema reference

Used in: xref:type-IngressListenerConfiguration-{context}[`IngressListenerConfiguration`]


[options="header"]
|====
|Property               |Description
|address         1.2+<.<|Additional address name for the bootstrap service. The address will be added to the list of subject alternative names of the TLS certificates.
|string
|dnsAnnotations  1.2+<.<|Annotations that will be added to the `Ingress` resource. You can use this field to configure DNS providers such as External DNS.
|map
|host            1.2+<.<|Host for the bootstrap route. This field will be used in the Ingress resource.
|string
|====

[id='type-IngressListenerBrokerConfiguration-{context}']
### `IngressListenerBrokerConfiguration` schema reference

Used in: xref:type-IngressListenerConfiguration-{context}[`IngressListenerConfiguration`]


[options="header"]
|====
|Property               |Description
|broker          1.2+<.<|Id of the kafka broker (broker identifier).
|integer
|advertisedHost  1.2+<.<|The host name which will be used in the brokers' `advertised.brokers`.
|string
|advertisedPort  1.2+<.<|The port number which will be used in the brokers' `advertised.brokers`.
|integer
|host            1.2+<.<|Host for the broker ingress. This field will be used in the Ingress resource.
|string
|dnsAnnotations  1.2+<.<|Annotations that will be added to the `Ingress` resources for individual brokers. You can use this field to configure DNS providers such as External DNS.
|map
|====

[id='type-KafkaAuthorizationSimple-{context}']
### `KafkaAuthorizationSimple` schema reference

Used in: xref:type-KafkaClusterSpec-{context}[`KafkaClusterSpec`]

include::../api/io.strimzi.api.kafka.model.KafkaAuthorizationSimple.adoc[leveloffset=+1]

The `type` property is a discriminator that distinguishes the use of the type `KafkaAuthorizationSimple` from xref:type-KafkaAuthorizationOpa-{context}[`KafkaAuthorizationOpa`], xref:type-KafkaAuthorizationKeycloak-{context}[`KafkaAuthorizationKeycloak`].
It must have the value `simple` for the type `KafkaAuthorizationSimple`.
[options="header"]
|====
|Property           |Description
|type        1.2+<.<|Must be `simple`.
|string
|superUsers  1.2+<.<|List of super users. Should contain list of user principals which should get unlimited access rights.
|string array
|====

[id='type-KafkaAuthorizationOpa-{context}']
### `KafkaAuthorizationOpa` schema reference

Used in: xref:type-KafkaClusterSpec-{context}[`KafkaClusterSpec`]

include::../api/io.strimzi.api.kafka.model.KafkaAuthorizationOpa.adoc[leveloffset=+1]

The `type` property is a discriminator that distinguishes the use of the type `KafkaAuthorizationOpa` from xref:type-KafkaAuthorizationSimple-{context}[`KafkaAuthorizationSimple`], xref:type-KafkaAuthorizationKeycloak-{context}[`KafkaAuthorizationKeycloak`].
It must have the value `opa` for the type `KafkaAuthorizationOpa`.
[options="header"]
|====
|Property                     |Description
|type                  1.2+<.<|Must be `opa`.
|string
|url                   1.2+<.<|The URL used to connect to the Open Policy Agent server. The URL has to include the policy which will be queried by the authorizer. This option is required.
|string
|allowOnError          1.2+<.<|Defines whether a Kafka client should be allowed or denied by default when the authorizer fails to query the Open Policy Agent, for example, when it is temporarily unavailable). Defaults to `false` - all actions will be denied.
|boolean
|initialCacheCapacity  1.2+<.<|Initial capacity of the local cache used by the authorizer to avoid querying the Open Policy Agent for every request Defaults to `5000`.
|integer
|maximumCacheSize      1.2+<.<|Maximum capacity of the local cache used by the authorizer to avoid querying the Open Policy Agent for every request. Defaults to `50000`.
|integer
|expireAfterMs         1.2+<.<|The expiration of the records kept in the local cache to avoid querying the Open Policy Agent for every request. Defines how often the cached authorization decisions are reloaded from the Open Policy Agent server. In milliseconds. Defaults to `3600000`.
|integer
|superUsers            1.2+<.<|List of super users, which is specifically a list of user principals that have unlimited access rights.
|string array
|====

[id='type-KafkaAuthorizationKeycloak-{context}']
### `KafkaAuthorizationKeycloak` schema reference

Used in: xref:type-KafkaClusterSpec-{context}[`KafkaClusterSpec`]


The `type` property is a discriminator that distinguishes the use of the type `KafkaAuthorizationKeycloak` from xref:type-KafkaAuthorizationSimple-{context}[`KafkaAuthorizationSimple`], xref:type-KafkaAuthorizationOpa-{context}[`KafkaAuthorizationOpa`].
It must have the value `keycloak` for the type `KafkaAuthorizationKeycloak`.
[options="header"]
|====
|Property                               |Description
|type                            1.2+<.<|Must be `keycloak`.
|string
|clientId                        1.2+<.<|OAuth Client ID which the Kafka client can use to authenticate against the OAuth server and use the token endpoint URI.
|string
|tokenEndpointUri                1.2+<.<|Authorization server token endpoint URI.
|string
|tlsTrustedCertificates          1.2+<.<|Trusted certificates for TLS connection to the OAuth server.
|xref:type-CertSecretSource-{context}[`CertSecretSource`] array
|disableTlsHostnameVerification  1.2+<.<|Enable or disable TLS hostname verification. Default value is `false`.
|boolean
|delegateToKafkaAcls             1.2+<.<|Whether authorization decision should be delegated to the 'Simple' authorizer if DENIED by Keycloak Authorization Services policies. Default value is `false`.
|boolean
|grantsRefreshPeriodSeconds      1.2+<.<|The time between two consecutive grants refresh runs in seconds. The default value is 60.
|integer
|grantsRefreshPoolSize           1.2+<.<|The number of threads to use to refresh grants for active sessions. The more threads, the more parallelism, so the sooner the job completes. However, using more threads places a heavier load on the authorization server. The default value is 5.
|integer
|superUsers                      1.2+<.<|List of super users. Should contain list of user principals which should get unlimited access rights.
|string array
|====

[id='type-Rack-{context}']
### `Rack` schema reference

Used in: xref:type-KafkaClusterSpec-{context}[`KafkaClusterSpec`], xref:type-KafkaConnectS2ISpec-{context}[`KafkaConnectS2ISpec`], xref:type-KafkaConnectSpec-{context}[`KafkaConnectSpec`]


[options="header"]
|====
|Property            |Description
|topologyKey  1.2+<.<|A key that matches labels assigned to the Kubernetes cluster nodes. The value of the label is used to set the broker's `broker.rack` config.
|string
|====

[id='type-Probe-{context}']
### `Probe` schema reference

Used in: xref:type-CruiseControlSpec-{context}[`CruiseControlSpec`], xref:type-EntityTopicOperatorSpec-{context}[`EntityTopicOperatorSpec`], xref:type-EntityUserOperatorSpec-{context}[`EntityUserOperatorSpec`], xref:type-KafkaBridgeSpec-{context}[`KafkaBridgeSpec`], xref:type-KafkaClusterSpec-{context}[`KafkaClusterSpec`], xref:type-KafkaConnectS2ISpec-{context}[`KafkaConnectS2ISpec`], xref:type-KafkaConnectSpec-{context}[`KafkaConnectSpec`], xref:type-KafkaExporterSpec-{context}[`KafkaExporterSpec`], xref:type-KafkaMirrorMaker2Spec-{context}[`KafkaMirrorMaker2Spec`], xref:type-KafkaMirrorMakerSpec-{context}[`KafkaMirrorMakerSpec`], xref:type-TlsSidecar-{context}[`TlsSidecar`], xref:type-TopicOperatorSpec-{context}[`TopicOperatorSpec`], xref:type-ZookeeperClusterSpec-{context}[`ZookeeperClusterSpec`]


[options="header"]
|====
|Property                    |Description
|failureThreshold     1.2+<.<|Minimum consecutive failures for the probe to be considered failed after having succeeded. Defaults to 3. Minimum value is 1.
|integer
|initialDelaySeconds  1.2+<.<|The initial delay before first the health is first checked.
|integer
|periodSeconds        1.2+<.<|How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1.
|integer
|successThreshold     1.2+<.<|Minimum consecutive successes for the probe to be considered successful after having failed. Defaults to 1. Must be 1 for liveness. Minimum value is 1.
|integer
|timeoutSeconds       1.2+<.<|The timeout for each attempted health check.
|integer
|====

[id='type-JvmOptions-{context}']
### `JvmOptions` schema reference

Used in: xref:type-CruiseControlSpec-{context}[`CruiseControlSpec`], xref:type-EntityTopicOperatorSpec-{context}[`EntityTopicOperatorSpec`], xref:type-EntityUserOperatorSpec-{context}[`EntityUserOperatorSpec`], xref:type-KafkaBridgeSpec-{context}[`KafkaBridgeSpec`], xref:type-KafkaClusterSpec-{context}[`KafkaClusterSpec`], xref:type-KafkaConnectS2ISpec-{context}[`KafkaConnectS2ISpec`], xref:type-KafkaConnectSpec-{context}[`KafkaConnectSpec`], xref:type-KafkaMirrorMaker2Spec-{context}[`KafkaMirrorMaker2Spec`], xref:type-KafkaMirrorMakerSpec-{context}[`KafkaMirrorMakerSpec`], xref:type-TopicOperatorSpec-{context}[`TopicOperatorSpec`], xref:type-ZookeeperClusterSpec-{context}[`ZookeeperClusterSpec`]


[options="header"]
|====
|Property                     |Description
|-XX                   1.2+<.<|A map of -XX options to the JVM.
|map
|-Xms                  1.2+<.<|-Xms option to to the JVM.
|string
|-Xmx                  1.2+<.<|-Xmx option to to the JVM.
|string
|gcLoggingEnabled      1.2+<.<|Specifies whether the Garbage Collection logging is enabled. The default is false.
|boolean
|javaSystemProperties  1.2+<.<|A map of additional system properties which will be passed using the `-D` option to the JVM.
|xref:type-SystemProperty-{context}[`SystemProperty`] array
|====

[id='type-SystemProperty-{context}']
### `SystemProperty` schema reference

Used in: xref:type-JvmOptions-{context}[`JvmOptions`]


[options="header"]
|====
|Property      |Description
|name   1.2+<.<|The system property name.
|string
|value  1.2+<.<|The system property value.
|string
|====

[id='type-KafkaJmxOptions-{context}']
### `KafkaJmxOptions` schema reference

Used in: xref:type-KafkaClusterSpec-{context}[`KafkaClusterSpec`]


[options="header"]
|====
|Property               |Description
|authentication  1.2+<.<|Authentication configuration for connecting to the Kafka JMX port. The type depends on the value of the `authentication.type` property within the given object, which must be one of [password].
|xref:type-KafkaJmxAuthenticationPassword-{context}[`KafkaJmxAuthenticationPassword`]
|====

[id='type-KafkaJmxAuthenticationPassword-{context}']
### `KafkaJmxAuthenticationPassword` schema reference

Used in: xref:type-KafkaJmxOptions-{context}[`KafkaJmxOptions`]


The `type` property is a discriminator that distinguishes the use of the type `KafkaJmxAuthenticationPassword` from other subtypes which may be added in the future.
It must have the value `password` for the type `KafkaJmxAuthenticationPassword`.
[options="header"]
|====
|Property     |Description
|type  1.2+<.<|Must be `password`.
|string
|====

[id='type-InlineLogging-{context}']
### `InlineLogging` schema reference

Used in: xref:type-CruiseControlSpec-{context}[`CruiseControlSpec`], xref:type-EntityTopicOperatorSpec-{context}[`EntityTopicOperatorSpec`], xref:type-EntityUserOperatorSpec-{context}[`EntityUserOperatorSpec`], xref:type-KafkaBridgeSpec-{context}[`KafkaBridgeSpec`], xref:type-KafkaClusterSpec-{context}[`KafkaClusterSpec`], xref:type-KafkaConnectS2ISpec-{context}[`KafkaConnectS2ISpec`], xref:type-KafkaConnectSpec-{context}[`KafkaConnectSpec`], xref:type-KafkaMirrorMaker2Spec-{context}[`KafkaMirrorMaker2Spec`], xref:type-KafkaMirrorMakerSpec-{context}[`KafkaMirrorMakerSpec`], xref:type-TopicOperatorSpec-{context}[`TopicOperatorSpec`], xref:type-ZookeeperClusterSpec-{context}[`ZookeeperClusterSpec`]


The `type` property is a discriminator that distinguishes the use of the type `InlineLogging` from xref:type-ExternalLogging-{context}[`ExternalLogging`].
It must have the value `inline` for the type `InlineLogging`.
[options="header"]
|====
|Property        |Description
|type     1.2+<.<|Must be `inline`.
|string
|loggers  1.2+<.<|A Map from logger name to logger level.
|map
|====

[id='type-ExternalLogging-{context}']
### `ExternalLogging` schema reference

Used in: xref:type-CruiseControlSpec-{context}[`CruiseControlSpec`], xref:type-EntityTopicOperatorSpec-{context}[`EntityTopicOperatorSpec`], xref:type-EntityUserOperatorSpec-{context}[`EntityUserOperatorSpec`], xref:type-KafkaBridgeSpec-{context}[`KafkaBridgeSpec`], xref:type-KafkaClusterSpec-{context}[`KafkaClusterSpec`], xref:type-KafkaConnectS2ISpec-{context}[`KafkaConnectS2ISpec`], xref:type-KafkaConnectSpec-{context}[`KafkaConnectSpec`], xref:type-KafkaMirrorMaker2Spec-{context}[`KafkaMirrorMaker2Spec`], xref:type-KafkaMirrorMakerSpec-{context}[`KafkaMirrorMakerSpec`], xref:type-TopicOperatorSpec-{context}[`TopicOperatorSpec`], xref:type-ZookeeperClusterSpec-{context}[`ZookeeperClusterSpec`]


The `type` property is a discriminator that distinguishes the use of the type `ExternalLogging` from xref:type-InlineLogging-{context}[`InlineLogging`].
It must have the value `external` for the type `ExternalLogging`.
[options="header"]
|====
|Property     |Description
|type  1.2+<.<|Must be `external`.
|string
|name  1.2+<.<|The name of the `ConfigMap` from which to get the logging configuration.
|string
|====

[id='type-TlsSidecar-{context}']
### `TlsSidecar` schema reference

Used in: xref:type-CruiseControlSpec-{context}[`CruiseControlSpec`], xref:type-EntityOperatorSpec-{context}[`EntityOperatorSpec`], xref:type-KafkaClusterSpec-{context}[`KafkaClusterSpec`], xref:type-TopicOperatorSpec-{context}[`TopicOperatorSpec`], xref:type-ZookeeperClusterSpec-{context}[`ZookeeperClusterSpec`]


[options="header"]
|====
|Property               |Description
|image           1.2+<.<|The docker image for the container.
|string
|livenessProbe   1.2+<.<|Pod liveness checking.
|xref:type-Probe-{context}[`Probe`]
|logLevel        1.2+<.<|The log level for the TLS sidecar. Default value is `notice`.
|string (one of [emerg, debug, crit, err, alert, warning, notice, info])
|readinessProbe  1.2+<.<|Pod readiness checking.
|xref:type-Probe-{context}[`Probe`]
|resources       1.2+<.<|CPU and memory resources to reserve. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[core/v1 resourcerequirements].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[ResourceRequirements]
|====

[id='type-KafkaClusterTemplate-{context}']
### `KafkaClusterTemplate` schema reference

Used in: xref:type-KafkaClusterSpec-{context}[`KafkaClusterSpec`]


[options="header"]
|====
|Property                         |Description
|statefulset               1.2+<.<|Template for Kafka `StatefulSet`.
|xref:type-StatefulSetTemplate-{context}[`StatefulSetTemplate`]
|pod                       1.2+<.<|Template for Kafka `Pods`.
|xref:type-PodTemplate-{context}[`PodTemplate`]
|bootstrapService          1.2+<.<|Template for Kafka bootstrap `Service`.
|xref:type-ResourceTemplate-{context}[`ResourceTemplate`]
|brokersService            1.2+<.<|Template for Kafka broker `Service`.
|xref:type-ResourceTemplate-{context}[`ResourceTemplate`]
|externalBootstrapService  1.2+<.<|Template for Kafka external bootstrap `Service`.
|xref:type-ExternalServiceTemplate-{context}[`ExternalServiceTemplate`]
|perPodService             1.2+<.<|Template for Kafka per-pod `Services` used for access from outside of Kubernetes.
|xref:type-ExternalServiceTemplate-{context}[`ExternalServiceTemplate`]
|externalBootstrapRoute    1.2+<.<|Template for Kafka external bootstrap `Route`.
|xref:type-ResourceTemplate-{context}[`ResourceTemplate`]
|perPodRoute               1.2+<.<|Template for Kafka per-pod `Routes` used for access from outside of OpenShift.
|xref:type-ResourceTemplate-{context}[`ResourceTemplate`]
|externalBootstrapIngress  1.2+<.<|Template for Kafka external bootstrap `Ingress`.
|xref:type-ResourceTemplate-{context}[`ResourceTemplate`]
|perPodIngress             1.2+<.<|Template for Kafka per-pod `Ingress` used for access from outside of Kubernetes.
|xref:type-ResourceTemplate-{context}[`ResourceTemplate`]
|persistentVolumeClaim     1.2+<.<|Template for all Kafka `PersistentVolumeClaims`.
|xref:type-ResourceTemplate-{context}[`ResourceTemplate`]
|podDisruptionBudget       1.2+<.<|Template for Kafka `PodDisruptionBudget`.
|xref:type-PodDisruptionBudgetTemplate-{context}[`PodDisruptionBudgetTemplate`]
|kafkaContainer            1.2+<.<|Template for the Kafka broker container.
|xref:type-ContainerTemplate-{context}[`ContainerTemplate`]
|tlsSidecarContainer       1.2+<.<|*The property `tlsSidecarContainer` has been deprecated.* Template for the Kafka broker TLS sidecar container.
|xref:type-ContainerTemplate-{context}[`ContainerTemplate`]
|initContainer             1.2+<.<|Template for the Kafka init container.
|xref:type-ContainerTemplate-{context}[`ContainerTemplate`]
|====

[id='type-StatefulSetTemplate-{context}']
### `StatefulSetTemplate` schema reference

Used in: xref:type-KafkaClusterTemplate-{context}[`KafkaClusterTemplate`], xref:type-ZookeeperClusterTemplate-{context}[`ZookeeperClusterTemplate`]


[options="header"]
|====
|Property                    |Description
|metadata             1.2+<.<|Metadata applied to the resource.
|xref:type-MetadataTemplate-{context}[`MetadataTemplate`]
|podManagementPolicy  1.2+<.<|PodManagementPolicy which will be used for this StatefulSet. Valid values are `Parallel` and `OrderedReady`. Defaults to `Parallel`.
|string (one of [OrderedReady, Parallel])
|====

[id='type-MetadataTemplate-{context}']
### `MetadataTemplate` schema reference

Used in: xref:type-ExternalServiceTemplate-{context}[`ExternalServiceTemplate`], xref:type-PodDisruptionBudgetTemplate-{context}[`PodDisruptionBudgetTemplate`], xref:type-PodTemplate-{context}[`PodTemplate`], xref:type-ResourceTemplate-{context}[`ResourceTemplate`], xref:type-StatefulSetTemplate-{context}[`StatefulSetTemplate`]

include::../api/io.strimzi.api.kafka.model.template.MetadataTemplate.adoc[leveloffset=+1]

[options="header"]
|====
|Property            |Description
|labels       1.2+<.<|Labels added to the resource template. Can be applied to different resources such as `StatefulSets`, `Deployments`, `Pods`, and `Services`.
|map
|annotations  1.2+<.<|Annotations added to the resource template. Can be applied to different resources such as `StatefulSets`, `Deployments`, `Pods`, and `Services`.
|map
|====

[id='type-PodTemplate-{context}']
### `PodTemplate` schema reference

Used in: xref:type-CruiseControlTemplate-{context}[`CruiseControlTemplate`], xref:type-EntityOperatorTemplate-{context}[`EntityOperatorTemplate`], xref:type-JmxTransTemplate-{context}[`JmxTransTemplate`], xref:type-KafkaBridgeTemplate-{context}[`KafkaBridgeTemplate`], xref:type-KafkaClusterTemplate-{context}[`KafkaClusterTemplate`], xref:type-KafkaConnectTemplate-{context}[`KafkaConnectTemplate`], xref:type-KafkaExporterTemplate-{context}[`KafkaExporterTemplate`], xref:type-KafkaMirrorMakerTemplate-{context}[`KafkaMirrorMakerTemplate`], xref:type-ZookeeperClusterTemplate-{context}[`ZookeeperClusterTemplate`]

include::../api/io.strimzi.api.kafka.model.template.PodTemplate.adoc[leveloffset=+1]

[options="header"]
|====
|Property                              |Description
|metadata                       1.2+<.<|Metadata applied to the resource.
|xref:type-MetadataTemplate-{context}[`MetadataTemplate`]
|imagePullSecrets               1.2+<.<|List of references to secrets in the same namespace to use for pulling any of the images used by this Pod. When the `STRIMZI_IMAGE_PULL_SECRETS` environment variable in Cluster Operator and the `imagePullSecrets` option are specified, only the `imagePullSecrets` variable is used and the `STRIMZI_IMAGE_PULL_SECRETS` variable is ignored. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#localobjectreference-v1-core[core/v1 localobjectreference].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#localobjectreference-v1-core[LocalObjectReference] array
|securityContext                1.2+<.<|Configures pod-level security attributes and common container settings. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#podsecuritycontext-v1-core[core/v1 podsecuritycontext].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#podsecuritycontext-v1-core[PodSecurityContext]
|terminationGracePeriodSeconds  1.2+<.<|The grace period is the duration in seconds after the processes running in the pod are sent a termination signal, and the time when the processes are forcibly halted with a kill signal. Set this value to longer than the expected cleanup time for your process. Value must be a non-negative integer. A zero value indicates delete immediately. You might need to increase the grace period for very large Kafka clusters, so that the Kafka brokers have enough time to transfer their work to another broker before they are terminated. Defaults to 30 seconds.
|integer
|affinity                       1.2+<.<|The pod's affinity rules. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#affinity-v1-core[core/v1 affinity].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#affinity-v1-core[Affinity]
|tolerations                    1.2+<.<|The pod's tolerations. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#toleration-v1-core[core/v1 toleration].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#toleration-v1-core[Toleration] array
|priorityClassName              1.2+<.<|The name of the priority class used to assign priority to the pods. For more information about priority classes, see {K8sPriorityClass}.
|string
|schedulerName                  1.2+<.<|The name of the scheduler used to dispatch this `Pod`. If not specified, the default scheduler will be used.
|string
|hostAliases                    1.2+<.<|The pod's HostAliases. HostAliases is an optional list of hosts and IPs that will be injected into the pod's hosts file if specified. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#HostAlias-v1-core[core/v1 HostAlias].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#HostAlias-v1-core[HostAlias] array
|====

[id='type-ResourceTemplate-{context}']
### `ResourceTemplate` schema reference

Used in: xref:type-CruiseControlTemplate-{context}[`CruiseControlTemplate`], xref:type-EntityOperatorTemplate-{context}[`EntityOperatorTemplate`], xref:type-JmxTransTemplate-{context}[`JmxTransTemplate`], xref:type-KafkaBridgeTemplate-{context}[`KafkaBridgeTemplate`], xref:type-KafkaClusterTemplate-{context}[`KafkaClusterTemplate`], xref:type-KafkaConnectTemplate-{context}[`KafkaConnectTemplate`], xref:type-KafkaExporterTemplate-{context}[`KafkaExporterTemplate`], xref:type-KafkaMirrorMakerTemplate-{context}[`KafkaMirrorMakerTemplate`], xref:type-KafkaUserTemplate-{context}[`KafkaUserTemplate`], xref:type-ZookeeperClusterTemplate-{context}[`ZookeeperClusterTemplate`]


[options="header"]
|====
|Property         |Description
|metadata  1.2+<.<|Metadata applied to the resource.
|xref:type-MetadataTemplate-{context}[`MetadataTemplate`]
|====

[id='type-ExternalServiceTemplate-{context}']
### `ExternalServiceTemplate` schema reference

Used in: xref:type-KafkaClusterTemplate-{context}[`KafkaClusterTemplate`]

include::../api/io.strimzi.api.kafka.model.template.ExternalServiceTemplate.adoc[leveloffset=+1]

[options="header"]
|====
|Property                         |Description
|metadata                  1.2+<.<|Metadata applied to the resource.
|xref:type-MetadataTemplate-{context}[`MetadataTemplate`]
|externalTrafficPolicy     1.2+<.<|*The property `externalTrafficPolicy` has been deprecated.* Specifies whether the service routes external traffic to node-local or cluster-wide endpoints. `Cluster` may cause a second hop to another node and obscures the client source IP. `Local` avoids a second hop for LoadBalancer and Nodeport type services and preserves the client source IP (when supported by the infrastructure). If unspecified, Kubernetes will use `Cluster` as the default.
|string (one of [Local, Cluster])
|loadBalancerSourceRanges  1.2+<.<|*The property `loadBalancerSourceRanges` has been deprecated.* A list of CIDR ranges (for example `10.0.0.0/8` or `130.211.204.1/32`) from which clients can connect to load balancer type listeners. If supported by the platform, traffic through the loadbalancer is restricted to the specified CIDR ranges. This field is applicable only for loadbalancer type services and is ignored if the cloud provider does not support the feature. For more information, see https://v1-17.docs.kubernetes.io/docs/tasks/access-application-cluster/configure-cloud-provider-firewall/. 
|string array
|====

[id='type-PodDisruptionBudgetTemplate-{context}']
### `PodDisruptionBudgetTemplate` schema reference

Used in: xref:type-CruiseControlTemplate-{context}[`CruiseControlTemplate`], xref:type-KafkaBridgeTemplate-{context}[`KafkaBridgeTemplate`], xref:type-KafkaClusterTemplate-{context}[`KafkaClusterTemplate`], xref:type-KafkaConnectTemplate-{context}[`KafkaConnectTemplate`], xref:type-KafkaMirrorMakerTemplate-{context}[`KafkaMirrorMakerTemplate`], xref:type-ZookeeperClusterTemplate-{context}[`ZookeeperClusterTemplate`]

include::../api/io.strimzi.api.kafka.model.template.PodDisruptionBudgetTemplate.adoc[leveloffset=+1]

[options="header"]
|====
|Property               |Description
|metadata        1.2+<.<|Metadata to apply to the `PodDistruptionBugetTemplate` resource.
|xref:type-MetadataTemplate-{context}[`MetadataTemplate`]
|maxUnavailable  1.2+<.<|Maximum number of unavailable pods to allow automatic Pod eviction. A Pod eviction is allowed when the `maxUnavailable` number of pods or fewer are unavailable after the eviction. Setting this value to 0 prevents all voluntary evictions, so the pods must be evicted manually. Defaults to 1.
|integer
|====

[id='type-ContainerTemplate-{context}']
### `ContainerTemplate` schema reference

Used in: xref:type-CruiseControlTemplate-{context}[`CruiseControlTemplate`], xref:type-EntityOperatorTemplate-{context}[`EntityOperatorTemplate`], xref:type-JmxTransTemplate-{context}[`JmxTransTemplate`], xref:type-KafkaBridgeTemplate-{context}[`KafkaBridgeTemplate`], xref:type-KafkaClusterTemplate-{context}[`KafkaClusterTemplate`], xref:type-KafkaConnectTemplate-{context}[`KafkaConnectTemplate`], xref:type-KafkaExporterTemplate-{context}[`KafkaExporterTemplate`], xref:type-KafkaMirrorMakerTemplate-{context}[`KafkaMirrorMakerTemplate`], xref:type-ZookeeperClusterTemplate-{context}[`ZookeeperClusterTemplate`]

include::../api/io.strimzi.api.kafka.model.template.ContainerTemplate.adoc[leveloffset=+1]

[options="header"]
|====
|Property                |Description
|env              1.2+<.<|Environment variables which should be applied to the container.
|xref:type-ContainerEnvVar-{context}[`ContainerEnvVar`] array
|securityContext  1.2+<.<|Security context for the container. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#securitycontext-v1-core[core/v1 securitycontext].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#securitycontext-v1-core[SecurityContext]
|====

[id='type-ContainerEnvVar-{context}']
### `ContainerEnvVar` schema reference

Used in: xref:type-ContainerTemplate-{context}[`ContainerTemplate`]


[options="header"]
|====
|Property      |Description
|name   1.2+<.<|The environment variable key.
|string
|value  1.2+<.<|The environment variable value.
|string
|====

[id='type-ZookeeperClusterSpec-{context}']
### `ZookeeperClusterSpec` schema reference

Used in: xref:type-KafkaSpec-{context}[`KafkaSpec`]


[options="header"]
|====
|Property               |Description
|replicas        1.2+<.<|The number of pods in the cluster.
|integer
|image           1.2+<.<|The docker image for the pods.
|string
|storage         1.2+<.<|Storage configuration (disk). Cannot be updated. The type depends on the value of the `storage.type` property within the given object, which must be one of [ephemeral, persistent-claim].
|xref:type-EphemeralStorage-{context}[`EphemeralStorage`], xref:type-PersistentClaimStorage-{context}[`PersistentClaimStorage`]
|config          1.2+<.<|The ZooKeeper broker config. Properties with the following prefixes cannot be set: server., dataDir, dataLogDir, clientPort, authProvider, quorum.auth, requireClientAuthScheme, snapshot.trust.empty, standaloneEnabled, reconfigEnabled, 4lw.commands.whitelist, secureClientPort, ssl., serverCnxnFactory, sslQuorum (with the exception of: ssl.protocol, ssl.quorum.protocol, ssl.enabledProtocols, ssl.quorum.enabledProtocols, ssl.ciphersuites, ssl.quorum.ciphersuites, ssl.hostnameVerification, ssl.quorum.hostnameVerification).
|map
|affinity        1.2+<.<|*The property `affinity` has been deprecated. This feature should now be configured at path `spec.zookeeper.template.pod.affinity`.* The pod's affinity rules. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#affinity-v1-core[core/v1 affinity].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#affinity-v1-core[Affinity]
|tolerations     1.2+<.<|*The property `tolerations` has been deprecated. This feature should now be configured at path `spec.zookeeper.template.pod.tolerations`.* The pod's tolerations. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#toleration-v1-core[core/v1 toleration].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#toleration-v1-core[Toleration] array
|livenessProbe   1.2+<.<|Pod liveness checking.
|xref:type-Probe-{context}[`Probe`]
|readinessProbe  1.2+<.<|Pod readiness checking.
|xref:type-Probe-{context}[`Probe`]
|jvmOptions      1.2+<.<|JVM Options for pods.
|xref:type-JvmOptions-{context}[`JvmOptions`]
|resources       1.2+<.<|CPU and memory resources to reserve. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[core/v1 resourcerequirements].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[ResourceRequirements]
|metrics         1.2+<.<|The Prometheus JMX Exporter configuration. See https://github.com/prometheus/jmx_exporter for details of the structure of this configuration.
|map
|logging         1.2+<.<|Logging configuration for ZooKeeper. The type depends on the value of the `logging.type` property within the given object, which must be one of [inline, external].
|xref:type-InlineLogging-{context}[`InlineLogging`], xref:type-ExternalLogging-{context}[`ExternalLogging`]
|template        1.2+<.<|Template for ZooKeeper cluster resources. The template allows users to specify how are the `StatefulSet`, `Pods` and `Services` generated.
|xref:type-ZookeeperClusterTemplate-{context}[`ZookeeperClusterTemplate`]
|tlsSidecar      1.2+<.<|*The property `tlsSidecar` has been deprecated.* TLS sidecar configuration. The TLS sidecar is not used anymore and this option will be ignored.
|xref:type-TlsSidecar-{context}[`TlsSidecar`]
|====

[id='type-ZookeeperClusterTemplate-{context}']
### `ZookeeperClusterTemplate` schema reference

Used in: xref:type-ZookeeperClusterSpec-{context}[`ZookeeperClusterSpec`]


[options="header"]
|====
|Property                      |Description
|statefulset            1.2+<.<|Template for ZooKeeper `StatefulSet`.
|xref:type-StatefulSetTemplate-{context}[`StatefulSetTemplate`]
|pod                    1.2+<.<|Template for ZooKeeper `Pods`.
|xref:type-PodTemplate-{context}[`PodTemplate`]
|clientService          1.2+<.<|Template for ZooKeeper client `Service`.
|xref:type-ResourceTemplate-{context}[`ResourceTemplate`]
|nodesService           1.2+<.<|Template for ZooKeeper nodes `Service`.
|xref:type-ResourceTemplate-{context}[`ResourceTemplate`]
|persistentVolumeClaim  1.2+<.<|Template for all ZooKeeper `PersistentVolumeClaims`.
|xref:type-ResourceTemplate-{context}[`ResourceTemplate`]
|podDisruptionBudget    1.2+<.<|Template for ZooKeeper `PodDisruptionBudget`.
|xref:type-PodDisruptionBudgetTemplate-{context}[`PodDisruptionBudgetTemplate`]
|zookeeperContainer     1.2+<.<|Template for the ZooKeeper container.
|xref:type-ContainerTemplate-{context}[`ContainerTemplate`]
|tlsSidecarContainer    1.2+<.<|*The property `tlsSidecarContainer` has been deprecated.* Template for the Zookeeper server TLS sidecar container. The TLS sidecar is not used anymore and this option will be ignored.
|xref:type-ContainerTemplate-{context}[`ContainerTemplate`]
|====

[id='type-TopicOperatorSpec-{context}']
### `TopicOperatorSpec` schema reference

*The type `TopicOperatorSpec` has been deprecated.*
Please use xref:type-EntityTopicOperatorSpec-{context}[`EntityTopicOperatorSpec`] instead.

Used in: xref:type-KafkaSpec-{context}[`KafkaSpec`]


[options="header"]
|====
|Property                               |Description
|watchedNamespace                1.2+<.<|The namespace the Topic Operator should watch.
|string
|image                           1.2+<.<|The image to use for the Topic Operator.
|string
|reconciliationIntervalSeconds   1.2+<.<|Interval between periodic reconciliations.
|integer
|zookeeperSessionTimeoutSeconds  1.2+<.<|Timeout for the ZooKeeper session.
|integer
|affinity                        1.2+<.<|Pod affinity rules. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#affinity-v1-core[core/v1 affinity].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#affinity-v1-core[Affinity]
|resources                       1.2+<.<|CPU and memory resources to reserve. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[core/v1 resourcerequirements].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[ResourceRequirements]
|topicMetadataMaxAttempts        1.2+<.<|The number of attempts at getting topic metadata.
|integer
|tlsSidecar                      1.2+<.<|TLS sidecar configuration.
|xref:type-TlsSidecar-{context}[`TlsSidecar`]
|logging                         1.2+<.<|Logging configuration. The type depends on the value of the `logging.type` property within the given object, which must be one of [inline, external].
|xref:type-InlineLogging-{context}[`InlineLogging`], xref:type-ExternalLogging-{context}[`ExternalLogging`]
|jvmOptions                      1.2+<.<|JVM Options for pods.
|xref:type-JvmOptions-{context}[`JvmOptions`]
|livenessProbe                   1.2+<.<|Pod liveness checking.
|xref:type-Probe-{context}[`Probe`]
|readinessProbe                  1.2+<.<|Pod readiness checking.
|xref:type-Probe-{context}[`Probe`]
|====

[id='type-EntityOperatorSpec-{context}']
### `EntityOperatorSpec` schema reference

Used in: xref:type-KafkaSpec-{context}[`KafkaSpec`]


[options="header"]
|====
|Property              |Description
|topicOperator  1.2+<.<|Configuration of the Topic Operator.
|xref:type-EntityTopicOperatorSpec-{context}[`EntityTopicOperatorSpec`]
|userOperator   1.2+<.<|Configuration of the User Operator.
|xref:type-EntityUserOperatorSpec-{context}[`EntityUserOperatorSpec`]
|affinity       1.2+<.<|*The property `affinity` has been deprecated. This feature should now be configured at path `spec.template.pod.affinity`.* The pod's affinity rules. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#affinity-v1-core[core/v1 affinity].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#affinity-v1-core[Affinity]
|tolerations    1.2+<.<|*The property `tolerations` has been deprecated. This feature should now be configured at path `spec.template.pod.tolerations`.* The pod's tolerations. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#toleration-v1-core[core/v1 toleration].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#toleration-v1-core[Toleration] array
|tlsSidecar     1.2+<.<|TLS sidecar configuration.
|xref:type-TlsSidecar-{context}[`TlsSidecar`]
|template       1.2+<.<|Template for Entity Operator resources. The template allows users to specify how is the `Deployment` and `Pods` generated.
|xref:type-EntityOperatorTemplate-{context}[`EntityOperatorTemplate`]
|====

[id='type-EntityTopicOperatorSpec-{context}']
### `EntityTopicOperatorSpec` schema reference

Used in: xref:type-EntityOperatorSpec-{context}[`EntityOperatorSpec`]


[options="header"]
|====
|Property                               |Description
|watchedNamespace                1.2+<.<|The namespace the Topic Operator should watch.
|string
|image                           1.2+<.<|The image to use for the Topic Operator.
|string
|reconciliationIntervalSeconds   1.2+<.<|Interval between periodic reconciliations.
|integer
|zookeeperSessionTimeoutSeconds  1.2+<.<|Timeout for the ZooKeeper session.
|integer
|livenessProbe                   1.2+<.<|Pod liveness checking.
|xref:type-Probe-{context}[`Probe`]
|readinessProbe                  1.2+<.<|Pod readiness checking.
|xref:type-Probe-{context}[`Probe`]
|resources                       1.2+<.<|CPU and memory resources to reserve. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[core/v1 resourcerequirements].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[ResourceRequirements]
|topicMetadataMaxAttempts        1.2+<.<|The number of attempts at getting topic metadata.
|integer
|logging                         1.2+<.<|Logging configuration. The type depends on the value of the `logging.type` property within the given object, which must be one of [inline, external].
|xref:type-InlineLogging-{context}[`InlineLogging`], xref:type-ExternalLogging-{context}[`ExternalLogging`]
|jvmOptions                      1.2+<.<|JVM Options for pods.
|xref:type-JvmOptions-{context}[`JvmOptions`]
|====

[id='type-EntityUserOperatorSpec-{context}']
### `EntityUserOperatorSpec` schema reference

Used in: xref:type-EntityOperatorSpec-{context}[`EntityOperatorSpec`]


[options="header"]
|====
|Property                               |Description
|watchedNamespace                1.2+<.<|The namespace the User Operator should watch.
|string
|image                           1.2+<.<|The image to use for the User Operator.
|string
|reconciliationIntervalSeconds   1.2+<.<|Interval between periodic reconciliations.
|integer
|zookeeperSessionTimeoutSeconds  1.2+<.<|Timeout for the ZooKeeper session.
|integer
|livenessProbe                   1.2+<.<|Pod liveness checking.
|xref:type-Probe-{context}[`Probe`]
|readinessProbe                  1.2+<.<|Pod readiness checking.
|xref:type-Probe-{context}[`Probe`]
|resources                       1.2+<.<|CPU and memory resources to reserve. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[core/v1 resourcerequirements].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[ResourceRequirements]
|logging                         1.2+<.<|Logging configuration. The type depends on the value of the `logging.type` property within the given object, which must be one of [inline, external].
|xref:type-InlineLogging-{context}[`InlineLogging`], xref:type-ExternalLogging-{context}[`ExternalLogging`]
|jvmOptions                      1.2+<.<|JVM Options for pods.
|xref:type-JvmOptions-{context}[`JvmOptions`]
|====

[id='type-EntityOperatorTemplate-{context}']
### `EntityOperatorTemplate` schema reference

Used in: xref:type-EntityOperatorSpec-{context}[`EntityOperatorSpec`]


[options="header"]
|====
|Property                       |Description
|deployment              1.2+<.<|Template for Entity Operator `Deployment`.
|xref:type-ResourceTemplate-{context}[`ResourceTemplate`]
|pod                     1.2+<.<|Template for Entity Operator `Pods`.
|xref:type-PodTemplate-{context}[`PodTemplate`]
|tlsSidecarContainer     1.2+<.<|Template for the Entity Operator TLS sidecar container.
|xref:type-ContainerTemplate-{context}[`ContainerTemplate`]
|topicOperatorContainer  1.2+<.<|Template for the Entity Topic Operator container.
|xref:type-ContainerTemplate-{context}[`ContainerTemplate`]
|userOperatorContainer   1.2+<.<|Template for the Entity User Operator container.
|xref:type-ContainerTemplate-{context}[`ContainerTemplate`]
|====

[id='type-CertificateAuthority-{context}']
### `CertificateAuthority` schema reference

Used in: xref:type-KafkaSpec-{context}[`KafkaSpec`]

Configuration of how TLS certificates are used within the cluster. This applies to certificates used for both internal communication within the cluster and to certificates used for client access via `Kafka.spec.kafka.listeners.tls`.

[options="header"]
|====
|Property                             |Description
|generateCertificateAuthority  1.2+<.<|If true then Certificate Authority certificates will be generated automatically. Otherwise the user will need to provide a Secret with the CA certificate. Default is true.
|boolean
|validityDays                  1.2+<.<|The number of days generated certificates should be valid for. The default is 365.
|integer
|renewalDays                   1.2+<.<|The number of days in the certificate renewal period. This is the number of days before the a certificate expires during which renewal actions may be performed. When `generateCertificateAuthority` is true, this will cause the generation of a new certificate. When `generateCertificateAuthority` is true, this will cause extra logging at WARN level about the pending certificate expiry. Default is 30.
|integer
|certificateExpirationPolicy   1.2+<.<|How should CA certificate expiration be handled when `generateCertificateAuthority=true`. The default is for a new CA certificate to be generated reusing the existing private key.
|string (one of [replace-key, renew-certificate])
|====

[id='type-CruiseControlSpec-{context}']
### `CruiseControlSpec` schema reference

Used in: xref:type-KafkaSpec-{context}[`KafkaSpec`]


[options="header"]
|====
|Property               |Description
|image           1.2+<.<|The docker image for the pods.
|string
|tlsSidecar      1.2+<.<|TLS sidecar configuration.
|xref:type-TlsSidecar-{context}[`TlsSidecar`]
|resources       1.2+<.<|CPU and memory resources to reserve for the Cruise Control container. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[core/v1 resourcerequirements].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[ResourceRequirements]
|livenessProbe   1.2+<.<|Pod liveness checking for the Cruise Control container.
|xref:type-Probe-{context}[`Probe`]
|readinessProbe  1.2+<.<|Pod readiness checking for the Cruise Control container.
|xref:type-Probe-{context}[`Probe`]
|jvmOptions      1.2+<.<|JVM Options for the Cruise Control container.
|xref:type-JvmOptions-{context}[`JvmOptions`]
|logging         1.2+<.<|Logging configuration (log4j1) for Cruise Control. The type depends on the value of the `logging.type` property within the given object, which must be one of [inline, external].
|xref:type-InlineLogging-{context}[`InlineLogging`], xref:type-ExternalLogging-{context}[`ExternalLogging`]
|template        1.2+<.<|Template to specify how Cruise Control resources, `Deployments` and `Pods`, are generated.
|xref:type-CruiseControlTemplate-{context}[`CruiseControlTemplate`]
|brokerCapacity  1.2+<.<|The Cruise Control `brokerCapacity` configuration.
|xref:type-BrokerCapacity-{context}[`BrokerCapacity`]
|config          1.2+<.<|The Cruise Control configuration. For a full list of configuration options refer to https://github.com/linkedin/cruise-control/wiki/Configurations. Note that properties with the following prefixes cannot be set: bootstrap.servers, client.id, zookeeper., network., security., failed.brokers.zk.path,webserver.http., webserver.api.urlprefix, webserver.session.path, webserver.accesslog., two.step., request.reason.required,metric.reporter.sampler.bootstrap.servers, metric.reporter.topic, partition.metric.sample.store.topic, broker.metric.sample.store.topic,capacity.config.file, self.healing., anomaly.detection., ssl.
|map
|metrics         1.2+<.<|The Prometheus JMX Exporter configuration. See https://github.com/prometheus/jmx_exporter for details of the structure of this configuration.
|map
|====

[id='type-CruiseControlTemplate-{context}']
### `CruiseControlTemplate` schema reference

Used in: xref:type-CruiseControlSpec-{context}[`CruiseControlSpec`]


[options="header"]
|====
|Property                       |Description
|deployment              1.2+<.<|Template for Cruise Control `Deployment`.
|xref:type-ResourceTemplate-{context}[`ResourceTemplate`]
|pod                     1.2+<.<|Template for Cruise Control `Pods`.
|xref:type-PodTemplate-{context}[`PodTemplate`]
|apiService              1.2+<.<|Template for Cruise Control API `Service`.
|xref:type-ResourceTemplate-{context}[`ResourceTemplate`]
|podDisruptionBudget     1.2+<.<|Template for Cruise Control `PodDisruptionBudget`.
|xref:type-PodDisruptionBudgetTemplate-{context}[`PodDisruptionBudgetTemplate`]
|cruiseControlContainer  1.2+<.<|Template for the Cruise Control container.
|xref:type-ContainerTemplate-{context}[`ContainerTemplate`]
|tlsSidecarContainer     1.2+<.<|Template for the Cruise Control TLS sidecar container.
|xref:type-ContainerTemplate-{context}[`ContainerTemplate`]
|====

[id='type-BrokerCapacity-{context}']
### `BrokerCapacity` schema reference

Used in: xref:type-CruiseControlSpec-{context}[`CruiseControlSpec`]


[options="header"]
|====
|Property                |Description
|disk             1.2+<.<|Broker capacity for disk in bytes, for example, 100Gi.
|string
|cpuUtilization   1.2+<.<|Broker capacity for CPU resource utilization as a percentage (0 - 100).
|integer
|inboundNetwork   1.2+<.<|Broker capacity for inbound network throughput in bytes per second, for example, 10000KB/s.
|string
|outboundNetwork  1.2+<.<|Broker capacity for outbound network throughput in bytes per second, for example 10000KB/s.
|string
|====

[id='type-JmxTransSpec-{context}']
### `JmxTransSpec` schema reference

Used in: xref:type-KafkaSpec-{context}[`KafkaSpec`]


[options="header"]
|====
|Property                  |Description
|image              1.2+<.<|The image to use for the JmxTrans.
|string
|outputDefinitions  1.2+<.<|Defines the output hosts that will be referenced later on. For more information on these properties see, xref:type-JmxTransOutputDefinitionTemplate-reference[`JmxTransOutputDefinitionTemplate` schema reference].
|xref:type-JmxTransOutputDefinitionTemplate-{context}[`JmxTransOutputDefinitionTemplate`] array
|logLevel           1.2+<.<|Sets the logging level of the JmxTrans deployment.For more information see, https://github.com/jmxtrans/jmxtrans-agent/wiki/Troubleshooting[JmxTrans Logging Level].
|string
|kafkaQueries       1.2+<.<|Queries to send to the Kafka brokers to define what data should be read from each broker. For more information on these properties see, xref:type-JmxTransQueryTemplate-reference[`JmxTransQueryTemplate` schema reference].
|xref:type-JmxTransQueryTemplate-{context}[`JmxTransQueryTemplate`] array
|resources          1.2+<.<|CPU and memory resources to reserve. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[core/v1 resourcerequirements].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[ResourceRequirements]
|template           1.2+<.<|Template for JmxTrans resources.
|xref:type-JmxTransTemplate-{context}[`JmxTransTemplate`]
|====

[id='type-JmxTransOutputDefinitionTemplate-{context}']
### `JmxTransOutputDefinitionTemplate` schema reference

Used in: xref:type-JmxTransSpec-{context}[`JmxTransSpec`]


[options="header"]
|====
|Property                    |Description
|outputType           1.2+<.<|Template for setting the format of the data that will be pushed.For more information see https://github.com/jmxtrans/jmxtrans/wiki/OutputWriters[JmxTrans OutputWriters].
|string
|host                 1.2+<.<|The DNS/hostname of the remote host that the data is pushed to.
|string
|port                 1.2+<.<|The port of the remote host that the data is pushed to.
|integer
|flushDelayInSeconds  1.2+<.<|How many seconds the JmxTrans waits before pushing a new set of data out.
|integer
|typeNames            1.2+<.<|Template for filtering data to be included in response to a wildcard query. For more information see https://github.com/jmxtrans/jmxtrans/wiki/Queries[JmxTrans queries].
|string array
|name                 1.2+<.<|Template for setting the name of the output definition. This is used to identify where to send the results of queries should be sent.
|string
|====

[id='type-JmxTransQueryTemplate-{context}']
### `JmxTransQueryTemplate` schema reference

Used in: xref:type-JmxTransSpec-{context}[`JmxTransSpec`]


[options="header"]
|====
|Property            |Description
|targetMBean  1.2+<.<|If using wildcards instead of a specific MBean then the data is gathered from multiple MBeans. Otherwise if specifying an MBean then data is gathered from that specified MBean.
|string
|attributes   1.2+<.<|Determine which attributes of the targeted MBean should be included.
|string array
|outputs      1.2+<.<|List of the names of output definitions specified in the spec.kafka.jmxTrans.outputDefinitions that have defined where JMX metrics are pushed to, and in which data format.
|string array
|====

[id='type-JmxTransTemplate-{context}']
### `JmxTransTemplate` schema reference

Used in: xref:type-JmxTransSpec-{context}[`JmxTransSpec`]


[options="header"]
|====
|Property           |Description
|deployment  1.2+<.<|Template for JmxTrans `Deployment`.
|xref:type-ResourceTemplate-{context}[`ResourceTemplate`]
|pod         1.2+<.<|Template for JmxTrans `Pods`.
|xref:type-PodTemplate-{context}[`PodTemplate`]
|container   1.2+<.<|Template for JmxTrans container.
|xref:type-ContainerTemplate-{context}[`ContainerTemplate`]
|====

[id='type-KafkaExporterSpec-{context}']
### `KafkaExporterSpec` schema reference

Used in: xref:type-KafkaSpec-{context}[`KafkaSpec`]


[options="header"]
|====
|Property                    |Description
|image                1.2+<.<|The docker image for the pods.
|string
|groupRegex           1.2+<.<|Regular expression to specify which consumer groups to collect. Default value is `.*`.
|string
|topicRegex           1.2+<.<|Regular expression to specify which topics to collect. Default value is `.*`.
|string
|resources            1.2+<.<|CPU and memory resources to reserve. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[core/v1 resourcerequirements].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[ResourceRequirements]
|logging              1.2+<.<|Only log messages with the given severity or above. Valid levels: [`debug`, `info`, `warn`, `error`, `fatal`]. Default log level is `info`.
|string
|enableSaramaLogging  1.2+<.<|Enable Sarama logging, a Go client library used by the Kafka Exporter.
|boolean
|template             1.2+<.<|Customization of deployment templates and pods.
|xref:type-KafkaExporterTemplate-{context}[`KafkaExporterTemplate`]
|livenessProbe        1.2+<.<|Pod liveness check.
|xref:type-Probe-{context}[`Probe`]
|readinessProbe       1.2+<.<|Pod readiness check.
|xref:type-Probe-{context}[`Probe`]
|====

[id='type-KafkaExporterTemplate-{context}']
### `KafkaExporterTemplate` schema reference

Used in: xref:type-KafkaExporterSpec-{context}[`KafkaExporterSpec`]


[options="header"]
|====
|Property           |Description
|deployment  1.2+<.<|Template for Kafka Exporter `Deployment`.
|xref:type-ResourceTemplate-{context}[`ResourceTemplate`]
|pod         1.2+<.<|Template for Kafka Exporter `Pods`.
|xref:type-PodTemplate-{context}[`PodTemplate`]
|service     1.2+<.<|Template for Kafka Exporter `Service`.
|xref:type-ResourceTemplate-{context}[`ResourceTemplate`]
|container   1.2+<.<|Template for the Kafka Exporter container.
|xref:type-ContainerTemplate-{context}[`ContainerTemplate`]
|====

[id='type-KafkaStatus-{context}']
### `KafkaStatus` schema reference

Used in: xref:type-Kafka-{context}[`Kafka`]


[options="header"]
|====
|Property                   |Description
|conditions          1.2+<.<|List of status conditions.
|xref:type-Condition-{context}[`Condition`] array
|observedGeneration  1.2+<.<|The generation of the CRD that was last reconciled by the operator.
|integer
|listeners           1.2+<.<|Addresses of the internal and external listeners.
|xref:type-ListenerStatus-{context}[`ListenerStatus`] array
|====

[id='type-Condition-{context}']
### `Condition` schema reference

Used in: xref:type-KafkaBridgeStatus-{context}[`KafkaBridgeStatus`], xref:type-KafkaConnectorStatus-{context}[`KafkaConnectorStatus`], xref:type-KafkaConnectS2IStatus-{context}[`KafkaConnectS2IStatus`], xref:type-KafkaConnectStatus-{context}[`KafkaConnectStatus`], xref:type-KafkaMirrorMaker2Status-{context}[`KafkaMirrorMaker2Status`], xref:type-KafkaMirrorMakerStatus-{context}[`KafkaMirrorMakerStatus`], xref:type-KafkaRebalanceStatus-{context}[`KafkaRebalanceStatus`], xref:type-KafkaStatus-{context}[`KafkaStatus`], xref:type-KafkaTopicStatus-{context}[`KafkaTopicStatus`], xref:type-KafkaUserStatus-{context}[`KafkaUserStatus`]


[options="header"]
|====
|Property                   |Description
|type                1.2+<.<|The unique identifier of a condition, used to distinguish between other conditions in the resource.
|string
|status              1.2+<.<|The status of the condition, either True, False or Unknown.
|string
|lastTransitionTime  1.2+<.<|Last time the condition of a type changed from one status to another. The required format is 'yyyy-MM-ddTHH:mm:ssZ', in the UTC time zone.
|string
|reason              1.2+<.<|The reason for the condition's last transition (a single word in CamelCase).
|string
|message             1.2+<.<|Human-readable message indicating details about the condition's last transition.
|string
|====

[id='type-ListenerStatus-{context}']
### `ListenerStatus` schema reference

Used in: xref:type-KafkaStatus-{context}[`KafkaStatus`]


[options="header"]
|====
|Property                 |Description
|type              1.2+<.<|The type of the listener. Can be one of the following three types: `plain`, `tls`, and `external`.
|string
|addresses         1.2+<.<|A list of the addresses for this listener.
|xref:type-ListenerAddress-{context}[`ListenerAddress`] array
|bootstrapServers  1.2+<.<|A comma-separated list of `host:port` pairs for connecting to the Kafka cluster using this listener.
|string
|certificates      1.2+<.<|A list of TLS certificates which can be used to verify the identity of the server when connecting to the given listener. Set only for `tls` and `external` listeners.
|string array
|====

[id='type-ListenerAddress-{context}']
### `ListenerAddress` schema reference

Used in: xref:type-ListenerStatus-{context}[`ListenerStatus`]


[options="header"]
|====
|Property     |Description
|host  1.2+<.<|The DNS name or IP address of the Kafka bootstrap service.
|string
|port  1.2+<.<|The port of the Kafka bootstrap service.
|integer
|====

[id='type-KafkaConnect-{context}']
### `KafkaConnect` schema reference


[options="header"]
|====
|Property       |Description
|spec    1.2+<.<|The specification of the Kafka Connect cluster.
|xref:type-KafkaConnectSpec-{context}[`KafkaConnectSpec`]
|status  1.2+<.<|The status of the Kafka Connect cluster.
|xref:type-KafkaConnectStatus-{context}[`KafkaConnectStatus`]
|====

[id='type-KafkaConnectSpec-{context}']
### `KafkaConnectSpec` schema reference

Used in: xref:type-KafkaConnect-{context}[`KafkaConnect`]

include::../api/io.strimzi.api.kafka.model.KafkaConnectSpec.adoc[leveloffset=+1]

[options="header"]
|====
|Property                      |Description
|replicas               1.2+<.<|The number of pods in the Kafka Connect group.
|integer
|version                1.2+<.<|The Kafka Connect version. Defaults to {DefaultKafkaVersion}. Consult the user documentation to understand the process required to upgrade or downgrade the version.
|string
|image                  1.2+<.<|The docker image for the pods.
|string
|bootstrapServers       1.2+<.<|Bootstrap servers to connect to. This should be given as a comma separated list of _<hostname>_:‍_<port>_ pairs.
|string
|tls                    1.2+<.<|TLS configuration.
|xref:type-KafkaConnectTls-{context}[`KafkaConnectTls`]
|authentication         1.2+<.<|Authentication configuration for Kafka Connect. The type depends on the value of the `authentication.type` property within the given object, which must be one of [tls, scram-sha-512, plain, oauth].
|xref:type-KafkaClientAuthenticationTls-{context}[`KafkaClientAuthenticationTls`], xref:type-KafkaClientAuthenticationScramSha512-{context}[`KafkaClientAuthenticationScramSha512`], xref:type-KafkaClientAuthenticationPlain-{context}[`KafkaClientAuthenticationPlain`], xref:type-KafkaClientAuthenticationOAuth-{context}[`KafkaClientAuthenticationOAuth`]
|config                 1.2+<.<|The Kafka Connect configuration. Properties with the following prefixes cannot be set: ssl., sasl., security., listeners, plugin.path, rest., bootstrap.servers, consumer.interceptor.classes, producer.interceptor.classes (with the exception of: ssl.endpoint.identification.algorithm, ssl.cipher.suites, ssl.protocol, ssl.enabled.protocols).
|map
|resources              1.2+<.<|The maximum limits for CPU and memory resources and the requested initial resources. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[core/v1 resourcerequirements].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[ResourceRequirements]
|livenessProbe          1.2+<.<|Pod liveness checking.
|xref:type-Probe-{context}[`Probe`]
|readinessProbe         1.2+<.<|Pod readiness checking.
|xref:type-Probe-{context}[`Probe`]
|jvmOptions             1.2+<.<|JVM Options for pods.
|xref:type-JvmOptions-{context}[`JvmOptions`]
|affinity               1.2+<.<|*The property `affinity` has been deprecated. This feature should now be configured at path `spec.template.pod.affinity`.* The pod's affinity rules. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#affinity-v1-core[core/v1 affinity].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#affinity-v1-core[Affinity]
|tolerations            1.2+<.<|*The property `tolerations` has been deprecated. This feature should now be configured at path `spec.template.pod.tolerations`.* The pod's tolerations. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#toleration-v1-core[core/v1 toleration].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#toleration-v1-core[Toleration] array
|logging                1.2+<.<|Logging configuration for Kafka Connect. The type depends on the value of the `logging.type` property within the given object, which must be one of [inline, external].
|xref:type-InlineLogging-{context}[`InlineLogging`], xref:type-ExternalLogging-{context}[`ExternalLogging`]
|metrics                1.2+<.<|The Prometheus JMX Exporter configuration. See https://github.com/prometheus/jmx_exporter for details of the structure of this configuration.
|map
|tracing                1.2+<.<|The configuration of tracing in Kafka Connect. The type depends on the value of the `tracing.type` property within the given object, which must be one of [jaeger].
|xref:type-JaegerTracing-{context}[`JaegerTracing`]
|template               1.2+<.<|Template for Kafka Connect and Kafka Connect S2I resources. The template allows users to specify how the `Deployment`, `Pods` and `Service` are generated.
|xref:type-KafkaConnectTemplate-{context}[`KafkaConnectTemplate`]
|externalConfiguration  1.2+<.<|Pass data from Secrets or ConfigMaps to the Kafka Connect pods and use them to configure connectors.
|xref:type-ExternalConfiguration-{context}[`ExternalConfiguration`]
|clientRackInitImage    1.2+<.<|The image of the init container used for initializing the `client.rack`.
|string
|rack                   1.2+<.<|Configuration of the node label which will be used as the client.rack consumer configuration.
|xref:type-Rack-{context}[`Rack`]
|====

[id='type-KafkaConnectTls-{context}']
### `KafkaConnectTls` schema reference

Used in: xref:type-KafkaConnectS2ISpec-{context}[`KafkaConnectS2ISpec`], xref:type-KafkaConnectSpec-{context}[`KafkaConnectSpec`]

include::../api/io.strimzi.api.kafka.model.KafkaConnectTls.adoc[leveloffset=+1]

[options="header"]
|====
|Property                    |Description
|trustedCertificates  1.2+<.<|Trusted certificates for TLS connection.
|xref:type-CertSecretSource-{context}[`CertSecretSource`] array
|====

[id='type-KafkaClientAuthenticationTls-{context}']
### `KafkaClientAuthenticationTls` schema reference

Used in: xref:type-KafkaBridgeSpec-{context}[`KafkaBridgeSpec`], xref:type-KafkaConnectS2ISpec-{context}[`KafkaConnectS2ISpec`], xref:type-KafkaConnectSpec-{context}[`KafkaConnectSpec`], xref:type-KafkaMirrorMaker2ClusterSpec-{context}[`KafkaMirrorMaker2ClusterSpec`], xref:type-KafkaMirrorMakerConsumerSpec-{context}[`KafkaMirrorMakerConsumerSpec`], xref:type-KafkaMirrorMakerProducerSpec-{context}[`KafkaMirrorMakerProducerSpec`]

include::../api/io.strimzi.api.kafka.model.authentication.KafkaClientAuthenticationTls.adoc[leveloffset=+1]

The `type` property is a discriminator that distinguishes the use of the type `KafkaClientAuthenticationTls` from xref:type-KafkaClientAuthenticationScramSha512-{context}[`KafkaClientAuthenticationScramSha512`], xref:type-KafkaClientAuthenticationPlain-{context}[`KafkaClientAuthenticationPlain`], xref:type-KafkaClientAuthenticationOAuth-{context}[`KafkaClientAuthenticationOAuth`].
It must have the value `tls` for the type `KafkaClientAuthenticationTls`.
[options="header"]
|====
|Property                  |Description
|certificateAndKey  1.2+<.<|Reference to the `Secret` which holds the certificate and private key pair.
|xref:type-CertAndKeySecretSource-{context}[`CertAndKeySecretSource`]
|type               1.2+<.<|Must be `tls`.
|string
|====

[id='type-KafkaClientAuthenticationScramSha512-{context}']
### `KafkaClientAuthenticationScramSha512` schema reference

Used in: xref:type-KafkaBridgeSpec-{context}[`KafkaBridgeSpec`], xref:type-KafkaConnectS2ISpec-{context}[`KafkaConnectS2ISpec`], xref:type-KafkaConnectSpec-{context}[`KafkaConnectSpec`], xref:type-KafkaMirrorMaker2ClusterSpec-{context}[`KafkaMirrorMaker2ClusterSpec`], xref:type-KafkaMirrorMakerConsumerSpec-{context}[`KafkaMirrorMakerConsumerSpec`], xref:type-KafkaMirrorMakerProducerSpec-{context}[`KafkaMirrorMakerProducerSpec`]

include::../api/io.strimzi.api.kafka.model.authentication.KafkaClientAuthenticationScramSha512.adoc[leveloffset=+1]

The `type` property is a discriminator that distinguishes the use of the type `KafkaClientAuthenticationScramSha512` from xref:type-KafkaClientAuthenticationTls-{context}[`KafkaClientAuthenticationTls`], xref:type-KafkaClientAuthenticationPlain-{context}[`KafkaClientAuthenticationPlain`], xref:type-KafkaClientAuthenticationOAuth-{context}[`KafkaClientAuthenticationOAuth`].
It must have the value `scram-sha-512` for the type `KafkaClientAuthenticationScramSha512`.
[options="header"]
|====
|Property               |Description
|passwordSecret  1.2+<.<|Reference to the `Secret` which holds the password.
|xref:type-PasswordSecretSource-{context}[`PasswordSecretSource`]
|type            1.2+<.<|Must be `scram-sha-512`.
|string
|username        1.2+<.<|Username used for the authentication.
|string
|====

[id='type-PasswordSecretSource-{context}']
### `PasswordSecretSource` schema reference

Used in: xref:type-KafkaClientAuthenticationPlain-{context}[`KafkaClientAuthenticationPlain`], xref:type-KafkaClientAuthenticationScramSha512-{context}[`KafkaClientAuthenticationScramSha512`]


[options="header"]
|====
|Property           |Description
|password    1.2+<.<|The name of the key in the Secret under which the password is stored.
|string
|secretName  1.2+<.<|The name of the Secret containing the password.
|string
|====

[id='type-KafkaClientAuthenticationPlain-{context}']
### `KafkaClientAuthenticationPlain` schema reference

Used in: xref:type-KafkaBridgeSpec-{context}[`KafkaBridgeSpec`], xref:type-KafkaConnectS2ISpec-{context}[`KafkaConnectS2ISpec`], xref:type-KafkaConnectSpec-{context}[`KafkaConnectSpec`], xref:type-KafkaMirrorMaker2ClusterSpec-{context}[`KafkaMirrorMaker2ClusterSpec`], xref:type-KafkaMirrorMakerConsumerSpec-{context}[`KafkaMirrorMakerConsumerSpec`], xref:type-KafkaMirrorMakerProducerSpec-{context}[`KafkaMirrorMakerProducerSpec`]

include::../api/io.strimzi.api.kafka.model.authentication.KafkaClientAuthenticationPlain.adoc[leveloffset=+1]

The `type` property is a discriminator that distinguishes the use of the type `KafkaClientAuthenticationPlain` from xref:type-KafkaClientAuthenticationTls-{context}[`KafkaClientAuthenticationTls`], xref:type-KafkaClientAuthenticationScramSha512-{context}[`KafkaClientAuthenticationScramSha512`], xref:type-KafkaClientAuthenticationOAuth-{context}[`KafkaClientAuthenticationOAuth`].
It must have the value `plain` for the type `KafkaClientAuthenticationPlain`.
[options="header"]
|====
|Property               |Description
|passwordSecret  1.2+<.<|Reference to the `Secret` which holds the password.
|xref:type-PasswordSecretSource-{context}[`PasswordSecretSource`]
|type            1.2+<.<|Must be `plain`.
|string
|username        1.2+<.<|Username used for the authentication.
|string
|====

[id='type-KafkaClientAuthenticationOAuth-{context}']
### `KafkaClientAuthenticationOAuth` schema reference

Used in: xref:type-KafkaBridgeSpec-{context}[`KafkaBridgeSpec`], xref:type-KafkaConnectS2ISpec-{context}[`KafkaConnectS2ISpec`], xref:type-KafkaConnectSpec-{context}[`KafkaConnectSpec`], xref:type-KafkaMirrorMaker2ClusterSpec-{context}[`KafkaMirrorMaker2ClusterSpec`], xref:type-KafkaMirrorMakerConsumerSpec-{context}[`KafkaMirrorMakerConsumerSpec`], xref:type-KafkaMirrorMakerProducerSpec-{context}[`KafkaMirrorMakerProducerSpec`]

include::../api/io.strimzi.api.kafka.model.authentication.KafkaClientAuthenticationOAuth.adoc[leveloffset=+1]

The `type` property is a discriminator that distinguishes the use of the type `KafkaClientAuthenticationOAuth` from xref:type-KafkaClientAuthenticationTls-{context}[`KafkaClientAuthenticationTls`], xref:type-KafkaClientAuthenticationScramSha512-{context}[`KafkaClientAuthenticationScramSha512`], xref:type-KafkaClientAuthenticationPlain-{context}[`KafkaClientAuthenticationPlain`].
It must have the value `oauth` for the type `KafkaClientAuthenticationOAuth`.
[options="header"]
|====
|Property                               |Description
|accessToken                     1.2+<.<|Link to Kubernetes Secret containing the access token which was obtained from the authorization server.
|xref:type-GenericSecretSource-{context}[`GenericSecretSource`]
|accessTokenIsJwt                1.2+<.<|Configure whether access token should be treated as JWT. This should be set to `false` if the authorization server returns opaque tokens. Defaults to `true`.
|boolean
|clientId                        1.2+<.<|OAuth Client ID which the Kafka client can use to authenticate against the OAuth server and use the token endpoint URI.
|string
|clientSecret                    1.2+<.<|Link to Kubernetes Secret containing the OAuth client secret which the Kafka client can use to authenticate against the OAuth server and use the token endpoint URI.
|xref:type-GenericSecretSource-{context}[`GenericSecretSource`]
|disableTlsHostnameVerification  1.2+<.<|Enable or disable TLS hostname verification. Default value is `false`.
|boolean
|maxTokenExpirySeconds           1.2+<.<|Set or limit time-to-live of the access tokens to the specified number of seconds. This should be set if the authorization server returns opaque tokens.
|integer
|refreshToken                    1.2+<.<|Link to Kubernetes Secret containing the refresh token which can be used to obtain access token from the authorization server.
|xref:type-GenericSecretSource-{context}[`GenericSecretSource`]
|scope                           1.2+<.<|OAuth scope to use when authenticating against the authorization server. Some authorization servers require this to be set. The possible values depend on how authorization server is configured. By default `scope` is not specified when doing the token endpoint request.
|string
|tlsTrustedCertificates          1.2+<.<|Trusted certificates for TLS connection to the OAuth server.
|xref:type-CertSecretSource-{context}[`CertSecretSource`] array
|tokenEndpointUri                1.2+<.<|Authorization server token endpoint URI.
|string
|type                            1.2+<.<|Must be `oauth`.
|string
|====

[id='type-JaegerTracing-{context}']
### `JaegerTracing` schema reference

Used in: xref:type-KafkaBridgeSpec-{context}[`KafkaBridgeSpec`], xref:type-KafkaConnectS2ISpec-{context}[`KafkaConnectS2ISpec`], xref:type-KafkaConnectSpec-{context}[`KafkaConnectSpec`], xref:type-KafkaMirrorMaker2Spec-{context}[`KafkaMirrorMaker2Spec`], xref:type-KafkaMirrorMakerSpec-{context}[`KafkaMirrorMakerSpec`]


The `type` property is a discriminator that distinguishes the use of the type `JaegerTracing` from other subtypes which may be added in the future.
It must have the value `jaeger` for the type `JaegerTracing`.
[options="header"]
|====
|Property     |Description
|type  1.2+<.<|Must be `jaeger`.
|string
|====

[id='type-KafkaConnectTemplate-{context}']
### `KafkaConnectTemplate` schema reference

Used in: xref:type-KafkaConnectS2ISpec-{context}[`KafkaConnectS2ISpec`], xref:type-KafkaConnectSpec-{context}[`KafkaConnectSpec`], xref:type-KafkaMirrorMaker2Spec-{context}[`KafkaMirrorMaker2Spec`]


[options="header"]
|====
|Property                    |Description
|deployment           1.2+<.<|Template for Kafka Connect `Deployment`.
|xref:type-ResourceTemplate-{context}[`ResourceTemplate`]
|pod                  1.2+<.<|Template for Kafka Connect `Pods`.
|xref:type-PodTemplate-{context}[`PodTemplate`]
|apiService           1.2+<.<|Template for Kafka Connect API `Service`.
|xref:type-ResourceTemplate-{context}[`ResourceTemplate`]
|connectContainer     1.2+<.<|Template for the Kafka Connect container.
|xref:type-ContainerTemplate-{context}[`ContainerTemplate`]
|initContainer        1.2+<.<|Template for the Kafka init container.
|xref:type-ContainerTemplate-{context}[`ContainerTemplate`]
|podDisruptionBudget  1.2+<.<|Template for Kafka Connect `PodDisruptionBudget`.
|xref:type-PodDisruptionBudgetTemplate-{context}[`PodDisruptionBudgetTemplate`]
|====

[id='type-ExternalConfiguration-{context}']
### `ExternalConfiguration` schema reference

Used in: xref:type-KafkaConnectS2ISpec-{context}[`KafkaConnectS2ISpec`], xref:type-KafkaConnectSpec-{context}[`KafkaConnectSpec`], xref:type-KafkaMirrorMaker2Spec-{context}[`KafkaMirrorMaker2Spec`]

include::../api/io.strimzi.api.kafka.model.connect.ExternalConfiguration.adoc[leveloffset=+1]

[options="header"]
|====
|Property        |Description
|env      1.2+<.<|Allows to pass data from Secret or ConfigMap to the Kafka Connect pods as environment variables.
|xref:type-ExternalConfigurationEnv-{context}[`ExternalConfigurationEnv`] array
|volumes  1.2+<.<|Allows to pass data from Secret or ConfigMap to the Kafka Connect pods as volumes.
|xref:type-ExternalConfigurationVolumeSource-{context}[`ExternalConfigurationVolumeSource`] array
|====

[id='type-ExternalConfigurationEnv-{context}']
### `ExternalConfigurationEnv` schema reference

Used in: xref:type-ExternalConfiguration-{context}[`ExternalConfiguration`]


[options="header"]
|====
|Property          |Description
|name       1.2+<.<|Name of the environment variable which will be passed to the Kafka Connect pods. The name of the environment variable cannot start with `KAFKA_` or `STRIMZI_`.
|string
|valueFrom  1.2+<.<|Value of the environment variable which will be passed to the Kafka Connect pods. It can be passed either as a reference to Secret or ConfigMap field. The field has to specify exactly one Secret or ConfigMap.
|xref:type-ExternalConfigurationEnvVarSource-{context}[`ExternalConfigurationEnvVarSource`]
|====

[id='type-ExternalConfigurationEnvVarSource-{context}']
### `ExternalConfigurationEnvVarSource` schema reference

Used in: xref:type-ExternalConfigurationEnv-{context}[`ExternalConfigurationEnv`]


[options="header"]
|====
|Property                |Description
|configMapKeyRef  1.2+<.<|Refernce to a key in a ConfigMap. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#configmapkeyselector-v1-core[core/v1 configmapkeyselector].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#configmapkeyselector-v1-core[ConfigMapKeySelector]
|secretKeyRef     1.2+<.<|Reference to a key in a Secret. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#secretkeyselector-v1-core[core/v1 secretkeyselector].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#secretkeyselector-v1-core[SecretKeySelector]
|====

[id='type-ExternalConfigurationVolumeSource-{context}']
### `ExternalConfigurationVolumeSource` schema reference

Used in: xref:type-ExternalConfiguration-{context}[`ExternalConfiguration`]


[options="header"]
|====
|Property          |Description
|configMap  1.2+<.<|Reference to a key in a ConfigMap. Exactly one Secret or ConfigMap has to be specified. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#configmapvolumesource-v1-core[core/v1 configmapvolumesource].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#configmapvolumesource-v1-core[ConfigMapVolumeSource]
|name       1.2+<.<|Name of the volume which will be added to the Kafka Connect pods.
|string
|secret     1.2+<.<|Reference to a key in a Secret. Exactly one Secret or ConfigMap has to be specified. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#secretvolumesource-v1-core[core/v1 secretvolumesource].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#secretvolumesource-v1-core[SecretVolumeSource]
|====

[id='type-KafkaConnectStatus-{context}']
### `KafkaConnectStatus` schema reference

Used in: xref:type-KafkaConnect-{context}[`KafkaConnect`]


[options="header"]
|====
|Property                   |Description
|conditions          1.2+<.<|List of status conditions.
|xref:type-Condition-{context}[`Condition`] array
|observedGeneration  1.2+<.<|The generation of the CRD that was last reconciled by the operator.
|integer
|url                 1.2+<.<|The URL of the REST API endpoint for managing and monitoring Kafka Connect connectors.
|string
|connectorPlugins    1.2+<.<|The list of connector plugins available in this Kafka Connect deployment.
|xref:type-ConnectorPlugin-{context}[`ConnectorPlugin`] array
|labelSelector       1.2+<.<|Label selector for pods providing this resource.
|string
|replicas            1.2+<.<|The current number of pods being used to provide this resource.
|integer
|====

[id='type-ConnectorPlugin-{context}']
### `ConnectorPlugin` schema reference

Used in: xref:type-KafkaConnectS2IStatus-{context}[`KafkaConnectS2IStatus`], xref:type-KafkaConnectStatus-{context}[`KafkaConnectStatus`], xref:type-KafkaMirrorMaker2Status-{context}[`KafkaMirrorMaker2Status`]


[options="header"]
|====
|Property        |Description
|type     1.2+<.<|The type of the connector plugin. The available types are `sink` and `source`.
|string
|version  1.2+<.<|The version of the connector plugin.
|string
|class    1.2+<.<|The class of the connector plugin.
|string
|====

[id='type-KafkaConnectS2I-{context}']
### `KafkaConnectS2I` schema reference


[options="header"]
|====
|Property       |Description
|spec    1.2+<.<|The specification of the Kafka Connect Source-to-Image (S2I) cluster.
|xref:type-KafkaConnectS2ISpec-{context}[`KafkaConnectS2ISpec`]
|status  1.2+<.<|The status of the Kafka Connect Source-to-Image (S2I) cluster.
|xref:type-KafkaConnectS2IStatus-{context}[`KafkaConnectS2IStatus`]
|====

[id='type-KafkaConnectS2ISpec-{context}']
### `KafkaConnectS2ISpec` schema reference

Used in: xref:type-KafkaConnectS2I-{context}[`KafkaConnectS2I`]

include::../api/io.strimzi.api.kafka.model.KafkaConnectS2ISpec.adoc[leveloffset=+1]

[options="header"]
|====
|Property                         |Description
|replicas                  1.2+<.<|The number of pods in the Kafka Connect group.
|integer
|image                     1.2+<.<|The docker image for the pods.
|string
|buildResources            1.2+<.<|CPU and memory resources to reserve. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[core/v1 resourcerequirements].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[ResourceRequirements]
|livenessProbe             1.2+<.<|Pod liveness checking.
|xref:type-Probe-{context}[`Probe`]
|readinessProbe            1.2+<.<|Pod readiness checking.
|xref:type-Probe-{context}[`Probe`]
|jvmOptions                1.2+<.<|JVM Options for pods.
|xref:type-JvmOptions-{context}[`JvmOptions`]
|affinity                  1.2+<.<|*The property `affinity` has been deprecated. This feature should now be configured at path `spec.template.pod.affinity`.* The pod's affinity rules. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#affinity-v1-core[core/v1 affinity].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#affinity-v1-core[Affinity]
|logging                   1.2+<.<|Logging configuration for Kafka Connect. The type depends on the value of the `logging.type` property within the given object, which must be one of [inline, external].
|xref:type-InlineLogging-{context}[`InlineLogging`], xref:type-ExternalLogging-{context}[`ExternalLogging`]
|metrics                   1.2+<.<|The Prometheus JMX Exporter configuration. See https://github.com/prometheus/jmx_exporter for details of the structure of this configuration.
|map
|template                  1.2+<.<|Template for Kafka Connect and Kafka Connect S2I resources. The template allows users to specify how the `Deployment`, `Pods` and `Service` are generated.
|xref:type-KafkaConnectTemplate-{context}[`KafkaConnectTemplate`]
|authentication            1.2+<.<|Authentication configuration for Kafka Connect. The type depends on the value of the `authentication.type` property within the given object, which must be one of [tls, scram-sha-512, plain, oauth].
|xref:type-KafkaClientAuthenticationTls-{context}[`KafkaClientAuthenticationTls`], xref:type-KafkaClientAuthenticationScramSha512-{context}[`KafkaClientAuthenticationScramSha512`], xref:type-KafkaClientAuthenticationPlain-{context}[`KafkaClientAuthenticationPlain`], xref:type-KafkaClientAuthenticationOAuth-{context}[`KafkaClientAuthenticationOAuth`]
|bootstrapServers          1.2+<.<|Bootstrap servers to connect to. This should be given as a comma separated list of _<hostname>_:‍_<port>_ pairs.
|string
|clientRackInitImage       1.2+<.<|The image of the init container used for initializing the `client.rack`.
|string
|config                    1.2+<.<|The Kafka Connect configuration. Properties with the following prefixes cannot be set: ssl., sasl., security., listeners, plugin.path, rest., bootstrap.servers, consumer.interceptor.classes, producer.interceptor.classes (with the exception of: ssl.endpoint.identification.algorithm, ssl.cipher.suites, ssl.protocol, ssl.enabled.protocols).
|map
|externalConfiguration     1.2+<.<|Pass data from Secrets or ConfigMaps to the Kafka Connect pods and use them to configure connectors.
|xref:type-ExternalConfiguration-{context}[`ExternalConfiguration`]
|insecureSourceRepository  1.2+<.<|When true this configures the source repository with the 'Local' reference policy and an import policy that accepts insecure source tags.
|boolean
|rack                      1.2+<.<|Configuration of the node label which will be used as the client.rack consumer configuration.
|xref:type-Rack-{context}[`Rack`]
|resources                 1.2+<.<|The maximum limits for CPU and memory resources and the requested initial resources. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[core/v1 resourcerequirements].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[ResourceRequirements]
|tls                       1.2+<.<|TLS configuration.
|xref:type-KafkaConnectTls-{context}[`KafkaConnectTls`]
|tolerations               1.2+<.<|*The property `tolerations` has been deprecated. This feature should now be configured at path `spec.template.pod.tolerations`.* The pod's tolerations. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#toleration-v1-core[core/v1 toleration].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#toleration-v1-core[Toleration] array
|tracing                   1.2+<.<|The configuration of tracing in Kafka Connect. The type depends on the value of the `tracing.type` property within the given object, which must be one of [jaeger].
|xref:type-JaegerTracing-{context}[`JaegerTracing`]
|version                   1.2+<.<|The Kafka Connect version. Defaults to {DefaultKafkaVersion}. Consult the user documentation to understand the process required to upgrade or downgrade the version.
|string
|====

[id='type-KafkaConnectS2IStatus-{context}']
### `KafkaConnectS2IStatus` schema reference

Used in: xref:type-KafkaConnectS2I-{context}[`KafkaConnectS2I`]


[options="header"]
|====
|Property                   |Description
|conditions          1.2+<.<|List of status conditions.
|xref:type-Condition-{context}[`Condition`] array
|observedGeneration  1.2+<.<|The generation of the CRD that was last reconciled by the operator.
|integer
|url                 1.2+<.<|The URL of the REST API endpoint for managing and monitoring Kafka Connect connectors.
|string
|connectorPlugins    1.2+<.<|The list of connector plugins available in this Kafka Connect deployment.
|xref:type-ConnectorPlugin-{context}[`ConnectorPlugin`] array
|buildConfigName     1.2+<.<|The name of the build configuration.
|string
|labelSelector       1.2+<.<|Label selector for pods providing this resource.
|string
|replicas            1.2+<.<|The current number of pods being used to provide this resource.
|integer
|====

[id='type-KafkaTopic-{context}']
### `KafkaTopic` schema reference


[options="header"]
|====
|Property       |Description
|spec    1.2+<.<|The specification of the topic.
|xref:type-KafkaTopicSpec-{context}[`KafkaTopicSpec`]
|status  1.2+<.<|The status of the topic.
|xref:type-KafkaTopicStatus-{context}[`KafkaTopicStatus`]
|====

[id='type-KafkaTopicSpec-{context}']
### `KafkaTopicSpec` schema reference

Used in: xref:type-KafkaTopic-{context}[`KafkaTopic`]


[options="header"]
|====
|Property           |Description
|partitions  1.2+<.<|The number of partitions the topic should have. This cannot be decreased after topic creation. It can be increased after topic creation, but it is important to understand the consequences that has, especially for topics with semantic partitioning.
|integer
|replicas    1.2+<.<|The number of replicas the topic should have.
|integer
|config      1.2+<.<|The topic configuration.
|map
|topicName   1.2+<.<|The name of the topic. When absent this will default to the metadata.name of the topic. It is recommended to not set this unless the topic name is not a valid Kubernetes resource name.
|string
|====

[id='type-KafkaTopicStatus-{context}']
### `KafkaTopicStatus` schema reference

Used in: xref:type-KafkaTopic-{context}[`KafkaTopic`]


[options="header"]
|====
|Property                   |Description
|conditions          1.2+<.<|List of status conditions.
|xref:type-Condition-{context}[`Condition`] array
|observedGeneration  1.2+<.<|The generation of the CRD that was last reconciled by the operator.
|integer
|====

[id='type-KafkaUser-{context}']
### `KafkaUser` schema reference


[options="header"]
|====
|Property       |Description
|spec    1.2+<.<|The specification of the user.
|xref:type-KafkaUserSpec-{context}[`KafkaUserSpec`]
|status  1.2+<.<|The status of the Kafka User.
|xref:type-KafkaUserStatus-{context}[`KafkaUserStatus`]
|====

[id='type-KafkaUserSpec-{context}']
### `KafkaUserSpec` schema reference

Used in: xref:type-KafkaUser-{context}[`KafkaUser`]


[options="header"]
|====
|Property               |Description
|authentication  1.2+<.<|Authentication mechanism enabled for this Kafka user. The type depends on the value of the `authentication.type` property within the given object, which must be one of [tls, scram-sha-512].
|xref:type-KafkaUserTlsClientAuthentication-{context}[`KafkaUserTlsClientAuthentication`], xref:type-KafkaUserScramSha512ClientAuthentication-{context}[`KafkaUserScramSha512ClientAuthentication`]
|authorization   1.2+<.<|Authorization rules for this Kafka user. The type depends on the value of the `authorization.type` property within the given object, which must be one of [simple].
|xref:type-KafkaUserAuthorizationSimple-{context}[`KafkaUserAuthorizationSimple`]
|quotas          1.2+<.<|Quotas on requests to control the broker resources used by clients. Network bandwidth and request rate quotas can be enforced.Kafka documentation for Kafka User quotas can be found at http://kafka.apache.org/documentation/#design_quotas.
|xref:type-KafkaUserQuotas-{context}[`KafkaUserQuotas`]
|template        1.2+<.<|Template to specify how Kafka User `Secrets` are generated.
|xref:type-KafkaUserTemplate-{context}[`KafkaUserTemplate`]
|====

[id='type-KafkaUserTlsClientAuthentication-{context}']
### `KafkaUserTlsClientAuthentication` schema reference

Used in: xref:type-KafkaUserSpec-{context}[`KafkaUserSpec`]


The `type` property is a discriminator that distinguishes the use of the type `KafkaUserTlsClientAuthentication` from xref:type-KafkaUserScramSha512ClientAuthentication-{context}[`KafkaUserScramSha512ClientAuthentication`].
It must have the value `tls` for the type `KafkaUserTlsClientAuthentication`.
[options="header"]
|====
|Property     |Description
|type  1.2+<.<|Must be `tls`.
|string
|====

[id='type-KafkaUserScramSha512ClientAuthentication-{context}']
### `KafkaUserScramSha512ClientAuthentication` schema reference

Used in: xref:type-KafkaUserSpec-{context}[`KafkaUserSpec`]


The `type` property is a discriminator that distinguishes the use of the type `KafkaUserScramSha512ClientAuthentication` from xref:type-KafkaUserTlsClientAuthentication-{context}[`KafkaUserTlsClientAuthentication`].
It must have the value `scram-sha-512` for the type `KafkaUserScramSha512ClientAuthentication`.
[options="header"]
|====
|Property     |Description
|type  1.2+<.<|Must be `scram-sha-512`.
|string
|====

[id='type-KafkaUserAuthorizationSimple-{context}']
### `KafkaUserAuthorizationSimple` schema reference

Used in: xref:type-KafkaUserSpec-{context}[`KafkaUserSpec`]


The `type` property is a discriminator that distinguishes the use of the type `KafkaUserAuthorizationSimple` from other subtypes which may be added in the future.
It must have the value `simple` for the type `KafkaUserAuthorizationSimple`.
[options="header"]
|====
|Property     |Description
|type  1.2+<.<|Must be `simple`.
|string
|acls  1.2+<.<|List of ACL rules which should be applied to this user.
|xref:type-AclRule-{context}[`AclRule`] array
|====

[id='type-AclRule-{context}']
### `AclRule` schema reference

Used in: xref:type-KafkaUserAuthorizationSimple-{context}[`KafkaUserAuthorizationSimple`]

include::../api/io.strimzi.api.kafka.model.AclRule.adoc[leveloffset=+1]

[options="header"]
|====
|Property          |Description
|host       1.2+<.<|The host from which the action described in the ACL rule is allowed or denied.
|string
|operation  1.2+<.<|Operation which will be allowed or denied. Supported operations are: Read, Write, Create, Delete, Alter, Describe, ClusterAction, AlterConfigs, DescribeConfigs, IdempotentWrite and All.
|string (one of [Read, Write, Delete, Alter, Describe, All, IdempotentWrite, ClusterAction, Create, AlterConfigs, DescribeConfigs])
|resource   1.2+<.<|Indicates the resource for which given ACL rule applies. The type depends on the value of the `resource.type` property within the given object, which must be one of [topic, group, cluster, transactionalId].
|xref:type-AclRuleTopicResource-{context}[`AclRuleTopicResource`], xref:type-AclRuleGroupResource-{context}[`AclRuleGroupResource`], xref:type-AclRuleClusterResource-{context}[`AclRuleClusterResource`], xref:type-AclRuleTransactionalIdResource-{context}[`AclRuleTransactionalIdResource`]
|type       1.2+<.<|The type of the rule. Currently the only supported type is `allow`. ACL rules with type `allow` are used to allow user to execute the specified operations. Default value is `allow`.
|string (one of [allow, deny])
|====

[id='type-AclRuleTopicResource-{context}']
### `AclRuleTopicResource` schema reference

Used in: xref:type-AclRule-{context}[`AclRule`]


The `type` property is a discriminator that distinguishes the use of the type `AclRuleTopicResource` from xref:type-AclRuleGroupResource-{context}[`AclRuleGroupResource`], xref:type-AclRuleClusterResource-{context}[`AclRuleClusterResource`], xref:type-AclRuleTransactionalIdResource-{context}[`AclRuleTransactionalIdResource`].
It must have the value `topic` for the type `AclRuleTopicResource`.
[options="header"]
|====
|Property            |Description
|type         1.2+<.<|Must be `topic`.
|string
|name         1.2+<.<|Name of resource for which given ACL rule applies. Can be combined with `patternType` field to use prefix pattern.
|string
|patternType  1.2+<.<|Describes the pattern used in the resource field. The supported types are `literal` and `prefix`. With `literal` pattern type, the resource field will be used as a definition of a full topic name. With `prefix` pattern type, the resource name will be used only as a prefix. Default value is `literal`.
|string (one of [prefix, literal])
|====

[id='type-AclRuleGroupResource-{context}']
### `AclRuleGroupResource` schema reference

Used in: xref:type-AclRule-{context}[`AclRule`]


The `type` property is a discriminator that distinguishes the use of the type `AclRuleGroupResource` from xref:type-AclRuleTopicResource-{context}[`AclRuleTopicResource`], xref:type-AclRuleClusterResource-{context}[`AclRuleClusterResource`], xref:type-AclRuleTransactionalIdResource-{context}[`AclRuleTransactionalIdResource`].
It must have the value `group` for the type `AclRuleGroupResource`.
[options="header"]
|====
|Property            |Description
|type         1.2+<.<|Must be `group`.
|string
|name         1.2+<.<|Name of resource for which given ACL rule applies. Can be combined with `patternType` field to use prefix pattern.
|string
|patternType  1.2+<.<|Describes the pattern used in the resource field. The supported types are `literal` and `prefix`. With `literal` pattern type, the resource field will be used as a definition of a full topic name. With `prefix` pattern type, the resource name will be used only as a prefix. Default value is `literal`.
|string (one of [prefix, literal])
|====

[id='type-AclRuleClusterResource-{context}']
### `AclRuleClusterResource` schema reference

Used in: xref:type-AclRule-{context}[`AclRule`]


The `type` property is a discriminator that distinguishes the use of the type `AclRuleClusterResource` from xref:type-AclRuleTopicResource-{context}[`AclRuleTopicResource`], xref:type-AclRuleGroupResource-{context}[`AclRuleGroupResource`], xref:type-AclRuleTransactionalIdResource-{context}[`AclRuleTransactionalIdResource`].
It must have the value `cluster` for the type `AclRuleClusterResource`.
[options="header"]
|====
|Property     |Description
|type  1.2+<.<|Must be `cluster`.
|string
|====

[id='type-AclRuleTransactionalIdResource-{context}']
### `AclRuleTransactionalIdResource` schema reference

Used in: xref:type-AclRule-{context}[`AclRule`]


The `type` property is a discriminator that distinguishes the use of the type `AclRuleTransactionalIdResource` from xref:type-AclRuleTopicResource-{context}[`AclRuleTopicResource`], xref:type-AclRuleGroupResource-{context}[`AclRuleGroupResource`], xref:type-AclRuleClusterResource-{context}[`AclRuleClusterResource`].
It must have the value `transactionalId` for the type `AclRuleTransactionalIdResource`.
[options="header"]
|====
|Property            |Description
|type         1.2+<.<|Must be `transactionalId`.
|string
|name         1.2+<.<|Name of resource for which given ACL rule applies. Can be combined with `patternType` field to use prefix pattern.
|string
|patternType  1.2+<.<|Describes the pattern used in the resource field. The supported types are `literal` and `prefix`. With `literal` pattern type, the resource field will be used as a definition of a full name. With `prefix` pattern type, the resource name will be used only as a prefix. Default value is `literal`.
|string (one of [prefix, literal])
|====

[id='type-KafkaUserQuotas-{context}']
### `KafkaUserQuotas` schema reference

Used in: xref:type-KafkaUserSpec-{context}[`KafkaUserSpec`]

include::../api/io.strimzi.api.kafka.model.KafkaUserQuotas.adoc[leveloffset=+1]

[options="header"]
|====
|Property                  |Description
|consumerByteRate   1.2+<.<|A quota on the maximum bytes per-second that each client group can fetch from a broker before the clients in the group are throttled. Defined on a per-broker basis.
|integer
|producerByteRate   1.2+<.<|A quota on the maximum bytes per-second that each client group can publish to a broker before the clients in the group are throttled. Defined on a per-broker basis.
|integer
|requestPercentage  1.2+<.<|A quota on the maximum CPU utilization of each client group as a percentage of network and I/O threads.
|integer
|====

[id='type-KafkaUserTemplate-{context}']
### `KafkaUserTemplate` schema reference

Used in: xref:type-KafkaUserSpec-{context}[`KafkaUserSpec`]

include::../api/io.strimzi.api.kafka.model.template.KafkaUserTemplate.adoc[leveloffset=+1]

[options="header"]
|====
|Property       |Description
|secret  1.2+<.<|Template for KafkaUser resources. The template allows users to specify how the `Secret` with password or TLS certificates is generated.
|xref:type-ResourceTemplate-{context}[`ResourceTemplate`]
|====

[id='type-KafkaUserStatus-{context}']
### `KafkaUserStatus` schema reference

Used in: xref:type-KafkaUser-{context}[`KafkaUser`]


[options="header"]
|====
|Property                   |Description
|conditions          1.2+<.<|List of status conditions.
|xref:type-Condition-{context}[`Condition`] array
|observedGeneration  1.2+<.<|The generation of the CRD that was last reconciled by the operator.
|integer
|username            1.2+<.<|Username.
|string
|secret              1.2+<.<|The name of `Secret` where the credentials are stored.
|string
|====

[id='type-KafkaMirrorMaker-{context}']
### `KafkaMirrorMaker` schema reference


[options="header"]
|====
|Property       |Description
|spec    1.2+<.<|The specification of Kafka MirrorMaker.
|xref:type-KafkaMirrorMakerSpec-{context}[`KafkaMirrorMakerSpec`]
|status  1.2+<.<|The status of Kafka MirrorMaker.
|xref:type-KafkaMirrorMakerStatus-{context}[`KafkaMirrorMakerStatus`]
|====

[id='type-KafkaMirrorMakerSpec-{context}']
### `KafkaMirrorMakerSpec` schema reference

Used in: xref:type-KafkaMirrorMaker-{context}[`KafkaMirrorMaker`]

include::../api/io.strimzi.api.kafka.model.KafkaMirrorMakerSpec.adoc[leveloffset=+1]

[options="header"]
|====
|Property               |Description
|replicas        1.2+<.<|The number of pods in the `Deployment`.
|integer
|image           1.2+<.<|The docker image for the pods.
|string
|whitelist       1.2+<.<|List of topics which are included for mirroring. This option allows any regular expression using Java-style regular expressions. Mirroring two topics named A and B is achieved by using the whitelist `'A\|B'`. Or, as a special case, you can mirror all topics using the whitelist '*'. You can also specify multiple regular expressions separated by commas.
|string
|consumer        1.2+<.<|Configuration of source cluster.
|xref:type-KafkaMirrorMakerConsumerSpec-{context}[`KafkaMirrorMakerConsumerSpec`]
|producer        1.2+<.<|Configuration of target cluster.
|xref:type-KafkaMirrorMakerProducerSpec-{context}[`KafkaMirrorMakerProducerSpec`]
|resources       1.2+<.<|CPU and memory resources to reserve. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[core/v1 resourcerequirements].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[ResourceRequirements]
|affinity        1.2+<.<|*The property `affinity` has been deprecated. This feature should now be configured at path `spec.template.pod.affinity`.* The pod's affinity rules. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#affinity-v1-core[core/v1 affinity].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#affinity-v1-core[Affinity]
|tolerations     1.2+<.<|*The property `tolerations` has been deprecated. This feature should now be configured at path `spec.template.pod.tolerations`.* The pod's tolerations. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#toleration-v1-core[core/v1 toleration].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#toleration-v1-core[Toleration] array
|jvmOptions      1.2+<.<|JVM Options for pods.
|xref:type-JvmOptions-{context}[`JvmOptions`]
|logging         1.2+<.<|Logging configuration for MirrorMaker. The type depends on the value of the `logging.type` property within the given object, which must be one of [inline, external].
|xref:type-InlineLogging-{context}[`InlineLogging`], xref:type-ExternalLogging-{context}[`ExternalLogging`]
|metrics         1.2+<.<|The Prometheus JMX Exporter configuration. See {JMXExporter} for details of the structure of this configuration.
|map
|tracing         1.2+<.<|The configuration of tracing in Kafka MirrorMaker. The type depends on the value of the `tracing.type` property within the given object, which must be one of [jaeger].
|xref:type-JaegerTracing-{context}[`JaegerTracing`]
|template        1.2+<.<|Template to specify how Kafka MirrorMaker resources, `Deployments` and `Pods`, are generated.
|xref:type-KafkaMirrorMakerTemplate-{context}[`KafkaMirrorMakerTemplate`]
|livenessProbe   1.2+<.<|Pod liveness checking.
|xref:type-Probe-{context}[`Probe`]
|readinessProbe  1.2+<.<|Pod readiness checking.
|xref:type-Probe-{context}[`Probe`]
|version         1.2+<.<|The Kafka MirrorMaker version. Defaults to {DefaultKafkaVersion}. Consult the documentation to understand the process required to upgrade or downgrade the version.
|string
|====

[id='type-KafkaMirrorMakerConsumerSpec-{context}']
### `KafkaMirrorMakerConsumerSpec` schema reference

Used in: xref:type-KafkaMirrorMakerSpec-{context}[`KafkaMirrorMakerSpec`]

include::../api/io.strimzi.api.kafka.model.KafkaMirrorMakerConsumerSpec.adoc[leveloffset=+1]

[options="header"]
|====
|Property                     |Description
|numStreams            1.2+<.<|Specifies the number of consumer stream threads to create.
|integer
|offsetCommitInterval  1.2+<.<|Specifies the offset auto-commit interval in ms. Default value is 60000.
|integer
|groupId               1.2+<.<|A unique string that identifies the consumer group this consumer belongs to.
|string
|bootstrapServers      1.2+<.<|A list of host:port pairs for establishing the initial connection to the Kafka cluster.
|string
|authentication        1.2+<.<|Authentication configuration for connecting to the cluster. The type depends on the value of the `authentication.type` property within the given object, which must be one of [tls, scram-sha-512, plain, oauth].
|xref:type-KafkaClientAuthenticationTls-{context}[`KafkaClientAuthenticationTls`], xref:type-KafkaClientAuthenticationScramSha512-{context}[`KafkaClientAuthenticationScramSha512`], xref:type-KafkaClientAuthenticationPlain-{context}[`KafkaClientAuthenticationPlain`], xref:type-KafkaClientAuthenticationOAuth-{context}[`KafkaClientAuthenticationOAuth`]
|config                1.2+<.<|The MirrorMaker consumer config. Properties with the following prefixes cannot be set: ssl., bootstrap.servers, group.id, sasl., security., interceptor.classes (with the exception of: ssl.endpoint.identification.algorithm, ssl.cipher.suites, ssl.protocol, ssl.enabled.protocols).
|map
|tls                   1.2+<.<|TLS configuration for connecting MirrorMaker to the cluster.
|xref:type-KafkaMirrorMakerTls-{context}[`KafkaMirrorMakerTls`]
|====

[id='type-KafkaMirrorMakerTls-{context}']
### `KafkaMirrorMakerTls` schema reference

Used in: xref:type-KafkaMirrorMakerConsumerSpec-{context}[`KafkaMirrorMakerConsumerSpec`], xref:type-KafkaMirrorMakerProducerSpec-{context}[`KafkaMirrorMakerProducerSpec`]

include::../api/io.strimzi.api.kafka.model.KafkaMirrorMakerTls.adoc[leveloffset=+1]

[options="header"]
|====
|Property                    |Description
|trustedCertificates  1.2+<.<|Trusted certificates for TLS connection.
|xref:type-CertSecretSource-{context}[`CertSecretSource`] array
|====

[id='type-KafkaMirrorMakerProducerSpec-{context}']
### `KafkaMirrorMakerProducerSpec` schema reference

Used in: xref:type-KafkaMirrorMakerSpec-{context}[`KafkaMirrorMakerSpec`]

include::../api/io.strimzi.api.kafka.model.KafkaMirrorMakerProducerSpec.adoc[leveloffset=+1]

[options="header"]
|====
|Property                   |Description
|bootstrapServers    1.2+<.<|A list of host:port pairs for establishing the initial connection to the Kafka cluster.
|string
|abortOnSendFailure  1.2+<.<|Flag to set the MirrorMaker to exit on a failed send. Default value is `true`.
|boolean
|authentication      1.2+<.<|Authentication configuration for connecting to the cluster. The type depends on the value of the `authentication.type` property within the given object, which must be one of [tls, scram-sha-512, plain, oauth].
|xref:type-KafkaClientAuthenticationTls-{context}[`KafkaClientAuthenticationTls`], xref:type-KafkaClientAuthenticationScramSha512-{context}[`KafkaClientAuthenticationScramSha512`], xref:type-KafkaClientAuthenticationPlain-{context}[`KafkaClientAuthenticationPlain`], xref:type-KafkaClientAuthenticationOAuth-{context}[`KafkaClientAuthenticationOAuth`]
|config              1.2+<.<|The MirrorMaker producer config. Properties with the following prefixes cannot be set: ssl., bootstrap.servers, sasl., security., interceptor.classes (with the exception of: ssl.endpoint.identification.algorithm, ssl.cipher.suites, ssl.protocol, ssl.enabled.protocols).
|map
|tls                 1.2+<.<|TLS configuration for connecting MirrorMaker to the cluster.
|xref:type-KafkaMirrorMakerTls-{context}[`KafkaMirrorMakerTls`]
|====

[id='type-KafkaMirrorMakerTemplate-{context}']
### `KafkaMirrorMakerTemplate` schema reference

Used in: xref:type-KafkaMirrorMakerSpec-{context}[`KafkaMirrorMakerSpec`]


[options="header"]
|====
|Property                     |Description
|deployment            1.2+<.<|Template for Kafka MirrorMaker `Deployment`.
|xref:type-ResourceTemplate-{context}[`ResourceTemplate`]
|pod                   1.2+<.<|Template for Kafka MirrorMaker `Pods`.
|xref:type-PodTemplate-{context}[`PodTemplate`]
|mirrorMakerContainer  1.2+<.<|Template for Kafka MirrorMaker container.
|xref:type-ContainerTemplate-{context}[`ContainerTemplate`]
|podDisruptionBudget   1.2+<.<|Template for Kafka MirrorMaker `PodDisruptionBudget`.
|xref:type-PodDisruptionBudgetTemplate-{context}[`PodDisruptionBudgetTemplate`]
|====

[id='type-KafkaMirrorMakerStatus-{context}']
### `KafkaMirrorMakerStatus` schema reference

Used in: xref:type-KafkaMirrorMaker-{context}[`KafkaMirrorMaker`]


[options="header"]
|====
|Property                   |Description
|conditions          1.2+<.<|List of status conditions.
|xref:type-Condition-{context}[`Condition`] array
|observedGeneration  1.2+<.<|The generation of the CRD that was last reconciled by the operator.
|integer
|labelSelector       1.2+<.<|Label selector for pods providing this resource.
|string
|replicas            1.2+<.<|The current number of pods being used to provide this resource.
|integer
|====

[id='type-KafkaBridge-{context}']
### `KafkaBridge` schema reference


[options="header"]
|====
|Property       |Description
|spec    1.2+<.<|The specification of the Kafka Bridge.
|xref:type-KafkaBridgeSpec-{context}[`KafkaBridgeSpec`]
|status  1.2+<.<|The status of the Kafka Bridge.
|xref:type-KafkaBridgeStatus-{context}[`KafkaBridgeStatus`]
|====

[id='type-KafkaBridgeSpec-{context}']
### `KafkaBridgeSpec` schema reference

Used in: xref:type-KafkaBridge-{context}[`KafkaBridge`]

include::../api/io.strimzi.api.kafka.model.KafkaBridgeSpec.adoc[leveloffset=+1]

[options="header"]
|====
|Property                 |Description
|replicas          1.2+<.<|The number of pods in the `Deployment`.
|integer
|image             1.2+<.<|The docker image for the pods.
|string
|bootstrapServers  1.2+<.<|A list of host:port pairs for establishing the initial connection to the Kafka cluster.
|string
|tls               1.2+<.<|TLS configuration for connecting Kafka Bridge to the cluster.
|xref:type-KafkaBridgeTls-{context}[`KafkaBridgeTls`]
|authentication    1.2+<.<|Authentication configuration for connecting to the cluster. The type depends on the value of the `authentication.type` property within the given object, which must be one of [tls, scram-sha-512, plain, oauth].
|xref:type-KafkaClientAuthenticationTls-{context}[`KafkaClientAuthenticationTls`], xref:type-KafkaClientAuthenticationScramSha512-{context}[`KafkaClientAuthenticationScramSha512`], xref:type-KafkaClientAuthenticationPlain-{context}[`KafkaClientAuthenticationPlain`], xref:type-KafkaClientAuthenticationOAuth-{context}[`KafkaClientAuthenticationOAuth`]
|http              1.2+<.<|The HTTP related configuration.
|xref:type-KafkaBridgeHttpConfig-{context}[`KafkaBridgeHttpConfig`]
|consumer          1.2+<.<|Kafka consumer related configuration.
|xref:type-KafkaBridgeConsumerSpec-{context}[`KafkaBridgeConsumerSpec`]
|producer          1.2+<.<|Kafka producer related configuration.
|xref:type-KafkaBridgeProducerSpec-{context}[`KafkaBridgeProducerSpec`]
|resources         1.2+<.<|CPU and memory resources to reserve. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[core/v1 resourcerequirements].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[ResourceRequirements]
|jvmOptions        1.2+<.<|**Currently not supported** JVM Options for pods.
|xref:type-JvmOptions-{context}[`JvmOptions`]
|logging           1.2+<.<|Logging configuration for Kafka Bridge. The type depends on the value of the `logging.type` property within the given object, which must be one of [inline, external].
|xref:type-InlineLogging-{context}[`InlineLogging`], xref:type-ExternalLogging-{context}[`ExternalLogging`]
|enableMetrics     1.2+<.<|Enable the metrics for the Kafka Bridge. Default is false.
|boolean
|livenessProbe     1.2+<.<|Pod liveness checking.
|xref:type-Probe-{context}[`Probe`]
|readinessProbe    1.2+<.<|Pod readiness checking.
|xref:type-Probe-{context}[`Probe`]
|template          1.2+<.<|Template for Kafka Bridge resources. The template allows users to specify how is the `Deployment` and `Pods` generated.
|xref:type-KafkaBridgeTemplate-{context}[`KafkaBridgeTemplate`]
|tracing           1.2+<.<|The configuration of tracing in Kafka Bridge. The type depends on the value of the `tracing.type` property within the given object, which must be one of [jaeger].
|xref:type-JaegerTracing-{context}[`JaegerTracing`]
|====

[id='type-KafkaBridgeTls-{context}']
### `KafkaBridgeTls` schema reference

Used in: xref:type-KafkaBridgeSpec-{context}[`KafkaBridgeSpec`]


[options="header"]
|====
|Property                    |Description
|trustedCertificates  1.2+<.<|Trusted certificates for TLS connection.
|xref:type-CertSecretSource-{context}[`CertSecretSource`] array
|====

[id='type-KafkaBridgeHttpConfig-{context}']
### `KafkaBridgeHttpConfig` schema reference

Used in: xref:type-KafkaBridgeSpec-{context}[`KafkaBridgeSpec`]

include::../api/io.strimzi.api.kafka.model.KafkaBridgeHttpConfig.adoc[leveloffset=+1]

[options="header"]
|====
|Property     |Description
|port  1.2+<.<|The port which is the server listening on.
|integer
|cors  1.2+<.<|CORS configuration for the HTTP Bridge.
|xref:type-KafkaBridgeHttpCors-{context}[`KafkaBridgeHttpCors`]
|====

[id='type-KafkaBridgeHttpCors-{context}']
### `KafkaBridgeHttpCors` schema reference

Used in: xref:type-KafkaBridgeHttpConfig-{context}[`KafkaBridgeHttpConfig`]


[options="header"]
|====
|Property               |Description
|allowedOrigins  1.2+<.<|List of allowed origins. Java regular expressions can be used.
|string array
|allowedMethods  1.2+<.<|List of allowed HTTP methods.
|string array
|====

[id='type-KafkaBridgeConsumerSpec-{context}']
### `KafkaBridgeConsumerSpec` schema reference

Used in: xref:type-KafkaBridgeSpec-{context}[`KafkaBridgeSpec`]

include::../api/io.strimzi.api.kafka.model.KafkaBridgeConsumerSpec.adoc[leveloffset=+1]

[options="header"]
|====
|Property       |Description
|config  1.2+<.<|The Kafka consumer configuration used for consumer instances created by the bridge. Properties with the following prefixes cannot be set: ssl., bootstrap.servers, group.id, sasl., security. (with the exception of: ssl.endpoint.identification.algorithm, ssl.cipher.suites, ssl.protocol, ssl.enabled.protocols).
|map
|====

[id='type-KafkaBridgeProducerSpec-{context}']
### `KafkaBridgeProducerSpec` schema reference

Used in: xref:type-KafkaBridgeSpec-{context}[`KafkaBridgeSpec`]

include::../api/io.strimzi.api.kafka.model.KafkaBridgeProducerSpec.adoc[leveloffset=+1]

[options="header"]
|====
|Property       |Description
|config  1.2+<.<|The Kafka producer configuration used for producer instances created by the bridge. Properties with the following prefixes cannot be set: ssl., bootstrap.servers, sasl., security. (with the exception of: ssl.endpoint.identification.algorithm, ssl.cipher.suites, ssl.protocol, ssl.enabled.protocols).
|map
|====

[id='type-KafkaBridgeTemplate-{context}']
### `KafkaBridgeTemplate` schema reference

Used in: xref:type-KafkaBridgeSpec-{context}[`KafkaBridgeSpec`]


[options="header"]
|====
|Property                    |Description
|deployment           1.2+<.<|Template for Kafka Bridge `Deployment`.
|xref:type-ResourceTemplate-{context}[`ResourceTemplate`]
|pod                  1.2+<.<|Template for Kafka Bridge `Pods`.
|xref:type-PodTemplate-{context}[`PodTemplate`]
|apiService           1.2+<.<|Template for Kafka Bridge API `Service`.
|xref:type-ResourceTemplate-{context}[`ResourceTemplate`]
|bridgeContainer      1.2+<.<|Template for the Kafka Bridge container.
|xref:type-ContainerTemplate-{context}[`ContainerTemplate`]
|podDisruptionBudget  1.2+<.<|Template for Kafka Bridge `PodDisruptionBudget`.
|xref:type-PodDisruptionBudgetTemplate-{context}[`PodDisruptionBudgetTemplate`]
|====

[id='type-KafkaBridgeStatus-{context}']
### `KafkaBridgeStatus` schema reference

Used in: xref:type-KafkaBridge-{context}[`KafkaBridge`]


[options="header"]
|====
|Property                   |Description
|conditions          1.2+<.<|List of status conditions.
|xref:type-Condition-{context}[`Condition`] array
|observedGeneration  1.2+<.<|The generation of the CRD that was last reconciled by the operator.
|integer
|url                 1.2+<.<|The URL at which external client applications can access the Kafka Bridge.
|string
|labelSelector       1.2+<.<|Label selector for pods providing this resource.
|string
|replicas            1.2+<.<|The current number of pods being used to provide this resource.
|integer
|====

[id='type-KafkaConnector-{context}']
### `KafkaConnector` schema reference


[options="header"]
|====
|Property       |Description
|spec    1.2+<.<|The specification of the Kafka Connector.
|xref:type-KafkaConnectorSpec-{context}[`KafkaConnectorSpec`]
|status  1.2+<.<|The status of the Kafka Connector.
|xref:type-KafkaConnectorStatus-{context}[`KafkaConnectorStatus`]
|====

[id='type-KafkaConnectorSpec-{context}']
### `KafkaConnectorSpec` schema reference

Used in: xref:type-KafkaConnector-{context}[`KafkaConnector`]


[options="header"]
|====
|Property         |Description
|class     1.2+<.<|The Class for the Kafka Connector.
|string
|tasksMax  1.2+<.<|The maximum number of tasks for the Kafka Connector.
|integer
|config    1.2+<.<|The Kafka Connector configuration. The following properties cannot be set: connector.class, tasks.max.
|map
|pause     1.2+<.<|Whether the connector should be paused. Defaults to false.
|boolean
|====

[id='type-KafkaConnectorStatus-{context}']
### `KafkaConnectorStatus` schema reference

Used in: xref:type-KafkaConnector-{context}[`KafkaConnector`]


[options="header"]
|====
|Property                   |Description
|conditions          1.2+<.<|List of status conditions.
|xref:type-Condition-{context}[`Condition`] array
|observedGeneration  1.2+<.<|The generation of the CRD that was last reconciled by the operator.
|integer
|connectorStatus     1.2+<.<|The connector status, as reported by the Kafka Connect REST API.
|map
|tasksMax            1.2+<.<|The maximum number of tasks for the Kafka Connector.
|integer
|====

[id='type-KafkaMirrorMaker2-{context}']
### `KafkaMirrorMaker2` schema reference


[options="header"]
|====
|Property       |Description
|spec    1.2+<.<|The specification of the Kafka MirrorMaker 2.0 cluster.
|xref:type-KafkaMirrorMaker2Spec-{context}[`KafkaMirrorMaker2Spec`]
|status  1.2+<.<|The status of the Kafka MirrorMaker 2.0 cluster.
|xref:type-KafkaMirrorMaker2Status-{context}[`KafkaMirrorMaker2Status`]
|====

[id='type-KafkaMirrorMaker2Spec-{context}']
### `KafkaMirrorMaker2Spec` schema reference

Used in: xref:type-KafkaMirrorMaker2-{context}[`KafkaMirrorMaker2`]


[options="header"]
|====
|Property                      |Description
|replicas               1.2+<.<|The number of pods in the Kafka Connect group.
|integer
|version                1.2+<.<|The Kafka Connect version. Defaults to {DefaultKafkaVersion}. Consult the user documentation to understand the process required to upgrade or downgrade the version.
|string
|image                  1.2+<.<|The docker image for the pods.
|string
|connectCluster         1.2+<.<|The cluster alias used for Kafka Connect. The alias must match a cluster in the list at `spec.clusters`.
|string
|clusters               1.2+<.<|Kafka clusters for mirroring.
|xref:type-KafkaMirrorMaker2ClusterSpec-{context}[`KafkaMirrorMaker2ClusterSpec`] array
|mirrors                1.2+<.<|Configuration of the MirrorMaker 2.0 connectors.
|xref:type-KafkaMirrorMaker2MirrorSpec-{context}[`KafkaMirrorMaker2MirrorSpec`] array
|resources              1.2+<.<|The maximum limits for CPU and memory resources and the requested initial resources. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[core/v1 resourcerequirements].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#resourcerequirements-v1-core[ResourceRequirements]
|livenessProbe          1.2+<.<|Pod liveness checking.
|xref:type-Probe-{context}[`Probe`]
|readinessProbe         1.2+<.<|Pod readiness checking.
|xref:type-Probe-{context}[`Probe`]
|jvmOptions             1.2+<.<|JVM Options for pods.
|xref:type-JvmOptions-{context}[`JvmOptions`]
|affinity               1.2+<.<|*The property `affinity` has been deprecated. This feature should now be configured at path `spec.template.pod.affinity`.* The pod's affinity rules. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#affinity-v1-core[core/v1 affinity].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#affinity-v1-core[Affinity]
|tolerations            1.2+<.<|*The property `tolerations` has been deprecated. This feature should now be configured at path `spec.template.pod.tolerations`.* The pod's tolerations. See external documentation of https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#toleration-v1-core[core/v1 toleration].


|https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.18/#toleration-v1-core[Toleration] array
|logging                1.2+<.<|Logging configuration for Kafka Connect. The type depends on the value of the `logging.type` property within the given object, which must be one of [inline, external].
|xref:type-InlineLogging-{context}[`InlineLogging`], xref:type-ExternalLogging-{context}[`ExternalLogging`]
|metrics                1.2+<.<|The Prometheus JMX Exporter configuration. See https://github.com/prometheus/jmx_exporter for details of the structure of this configuration.
|map
|tracing                1.2+<.<|The configuration of tracing in Kafka Connect. The type depends on the value of the `tracing.type` property within the given object, which must be one of [jaeger].
|xref:type-JaegerTracing-{context}[`JaegerTracing`]
|template               1.2+<.<|Template for Kafka Connect and Kafka Connect S2I resources. The template allows users to specify how the `Deployment`, `Pods` and `Service` are generated.
|xref:type-KafkaConnectTemplate-{context}[`KafkaConnectTemplate`]
|externalConfiguration  1.2+<.<|Pass data from Secrets or ConfigMaps to the Kafka Connect pods and use them to configure connectors.
|xref:type-ExternalConfiguration-{context}[`ExternalConfiguration`]
|====

[id='type-KafkaMirrorMaker2ClusterSpec-{context}']
### `KafkaMirrorMaker2ClusterSpec` schema reference

Used in: xref:type-KafkaMirrorMaker2Spec-{context}[`KafkaMirrorMaker2Spec`]

include::../api/io.strimzi.api.kafka.model.KafkaMirrorMaker2ClusterSpec.adoc[leveloffset=+1]

[options="header"]
|====
|Property                 |Description
|alias             1.2+<.<|Alias used to reference the Kafka cluster.
|string
|bootstrapServers  1.2+<.<|A comma-separated list of `host:port` pairs for establishing the connection to the Kafka cluster.
|string
|config            1.2+<.<|The MirrorMaker 2.0 cluster config. Properties with the following prefixes cannot be set: ssl., sasl., security., listeners, plugin.path, rest., bootstrap.servers, consumer.interceptor.classes, producer.interceptor.classes (with the exception of: ssl.endpoint.identification.algorithm, ssl.cipher.suites, ssl.protocol, ssl.enabled.protocols).
|map
|tls               1.2+<.<|TLS configuration for connecting MirrorMaker 2.0 connectors to a cluster.
|xref:type-KafkaMirrorMaker2Tls-{context}[`KafkaMirrorMaker2Tls`]
|authentication    1.2+<.<|Authentication configuration for connecting to the cluster. The type depends on the value of the `authentication.type` property within the given object, which must be one of [tls, scram-sha-512, plain, oauth].
|xref:type-KafkaClientAuthenticationTls-{context}[`KafkaClientAuthenticationTls`], xref:type-KafkaClientAuthenticationScramSha512-{context}[`KafkaClientAuthenticationScramSha512`], xref:type-KafkaClientAuthenticationPlain-{context}[`KafkaClientAuthenticationPlain`], xref:type-KafkaClientAuthenticationOAuth-{context}[`KafkaClientAuthenticationOAuth`]
|====

[id='type-KafkaMirrorMaker2Tls-{context}']
### `KafkaMirrorMaker2Tls` schema reference

Used in: xref:type-KafkaMirrorMaker2ClusterSpec-{context}[`KafkaMirrorMaker2ClusterSpec`]


[options="header"]
|====
|Property                    |Description
|trustedCertificates  1.2+<.<|Trusted certificates for TLS connection.
|xref:type-CertSecretSource-{context}[`CertSecretSource`] array
|====

[id='type-KafkaMirrorMaker2MirrorSpec-{context}']
### `KafkaMirrorMaker2MirrorSpec` schema reference

Used in: xref:type-KafkaMirrorMaker2Spec-{context}[`KafkaMirrorMaker2Spec`]


[options="header"]
|====
|Property                       |Description
|sourceCluster           1.2+<.<|The alias of the source cluster used by the Kafka MirrorMaker 2.0 connectors. The alias must match a cluster in the list at `spec.clusters`.
|string
|targetCluster           1.2+<.<|The alias of the target cluster used by the Kafka MirrorMaker 2.0 connectors. The alias must match a cluster in the list at `spec.clusters`.
|string
|sourceConnector         1.2+<.<|The specification of the Kafka MirrorMaker 2.0 source connector.
|xref:type-KafkaMirrorMaker2ConnectorSpec-{context}[`KafkaMirrorMaker2ConnectorSpec`]
|checkpointConnector     1.2+<.<|The specification of the Kafka MirrorMaker 2.0 checkpoint connector.
|xref:type-KafkaMirrorMaker2ConnectorSpec-{context}[`KafkaMirrorMaker2ConnectorSpec`]
|heartbeatConnector      1.2+<.<|The specification of the Kafka MirrorMaker 2.0 heartbeat connector.
|xref:type-KafkaMirrorMaker2ConnectorSpec-{context}[`KafkaMirrorMaker2ConnectorSpec`]
|topicsPattern           1.2+<.<|A regular expression matching the topics to be mirrored, for example, "topic1\|topic2\|topic3". Comma-separated lists are also supported.
|string
|topicsBlacklistPattern  1.2+<.<|A regular expression matching the topics to exclude from mirroring. Comma-separated lists are also supported.
|string
|groupsPattern           1.2+<.<|A regular expression matching the consumer groups to be mirrored. Comma-separated lists are also supported.
|string
|groupsBlacklistPattern  1.2+<.<|A regular expression matching the consumer groups to exclude from mirroring. Comma-separated lists are also supported.
|string
|====

[id='type-KafkaMirrorMaker2ConnectorSpec-{context}']
### `KafkaMirrorMaker2ConnectorSpec` schema reference

Used in: xref:type-KafkaMirrorMaker2MirrorSpec-{context}[`KafkaMirrorMaker2MirrorSpec`]


[options="header"]
|====
|Property         |Description
|tasksMax  1.2+<.<|The maximum number of tasks for the Kafka Connector.
|integer
|config    1.2+<.<|The Kafka Connector configuration. The following properties cannot be set: connector.class, tasks.max.
|map
|pause     1.2+<.<|Whether the connector should be paused. Defaults to false.
|boolean
|====

[id='type-KafkaMirrorMaker2Status-{context}']
### `KafkaMirrorMaker2Status` schema reference

Used in: xref:type-KafkaMirrorMaker2-{context}[`KafkaMirrorMaker2`]


[options="header"]
|====
|Property                   |Description
|conditions          1.2+<.<|List of status conditions.
|xref:type-Condition-{context}[`Condition`] array
|observedGeneration  1.2+<.<|The generation of the CRD that was last reconciled by the operator.
|integer
|url                 1.2+<.<|The URL of the REST API endpoint for managing and monitoring Kafka Connect connectors.
|string
|connectorPlugins    1.2+<.<|The list of connector plugins available in this Kafka Connect deployment.
|xref:type-ConnectorPlugin-{context}[`ConnectorPlugin`] array
|connectors          1.2+<.<|List of MirrorMaker 2.0 connector statuses, as reported by the Kafka Connect REST API.
|map array
|labelSelector       1.2+<.<|Label selector for pods providing this resource.
|string
|replicas            1.2+<.<|The current number of pods being used to provide this resource.
|integer
|====

[id='type-KafkaRebalance-{context}']
### `KafkaRebalance` schema reference


[options="header"]
|====
|Property       |Description
|spec    1.2+<.<|The specification of the Kafka rebalance.
|xref:type-KafkaRebalanceSpec-{context}[`KafkaRebalanceSpec`]
|status  1.2+<.<|The status of the Kafka rebalance.
|xref:type-KafkaRebalanceStatus-{context}[`KafkaRebalanceStatus`]
|====

[id='type-KafkaRebalanceSpec-{context}']
### `KafkaRebalanceSpec` schema reference

Used in: xref:type-KafkaRebalance-{context}[`KafkaRebalance`]


[options="header"]
|====
|Property                                        |Description
|goals                                    1.2+<.<|A list of goals, ordered by decreasing priority, to use for generating and executing the rebalance proposal. The supported goals are available at https://github.com/linkedin/cruise-control#goals. If an empty goals list is provided, the goals declared in the default.goals Cruise Control configuration parameter are used.
|string array
|skipHardGoalCheck                        1.2+<.<|Whether to allow the hard goals specified in the Kafka CR to be skipped in optimization proposal generation. This can be useful when some of those hard goals are preventing a balance solution being found. Default is false.
|boolean
|excludedTopics                           1.2+<.<|A regular expression where any matching topics will be excluded from the calculation of optimization proposals. This expression will be parsed by the java.util.regex.Pattern class; for more information on the supported formar consult the documentation for that class.
|string
|concurrentPartitionMovementsPerBroker    1.2+<.<|The upper bound of ongoing partition replica movements going into/out of each broker. Default is 5.
|integer
|concurrentIntraBrokerPartitionMovements  1.2+<.<|The upper bound of ongoing partition replica movements between disks within each broker. Default is 2.
|integer
|concurrentLeaderMovements                1.2+<.<|The upper bound of ongoing partition leadership movements. Default is 1000.
|integer
|replicationThrottle                      1.2+<.<|The upper bound, in bytes per second, on the bandwidth used to move replicas. There is no limit by default.
|integer
|replicaMovementStrategies                1.2+<.<|A list of strategy class names used to determine the execution order for the replica movements in the generated optimization proposal. By default BaseReplicaMovementStrategy is used, which will execute the replica movements in the order that they were generated.
|string array
|====

[id='type-KafkaRebalanceStatus-{context}']
### `KafkaRebalanceStatus` schema reference

Used in: xref:type-KafkaRebalance-{context}[`KafkaRebalance`]


[options="header"]
|====
|Property                   |Description
|conditions          1.2+<.<|List of status conditions.
|xref:type-Condition-{context}[`Condition`] array
|observedGeneration  1.2+<.<|The generation of the CRD that was last reconciled by the operator.
|integer
|sessionId           1.2+<.<|The session identifier for requests to Cruise Control pertaining to this KafkaRebalance resource. This is used by the Kafka Rebalance operator to track the status of ongoing rebalancing operations.
|string
|optimizationResult  1.2+<.<|A JSON object describing the optimization result.
|map
|====

