# API Reference

# Packages

# apps.emqx.io/v1beta2

Package v1beta2 contains API Schema definitions for the apps v1beta2 API group

# Resource Types

# ACL

Appears in:

FieldDescription
permission string
username string
clientid string
ipaddress string
action string
topics Topics

# Certificate

Appears in:

FieldDescription
wss CertificateConf
mqtts CertificateConf

# CertificateConf

Appears in:

FieldDescription
data CertificateData
stringData CertificateStringData

# CertificateData

Appears in:

FieldDescription
ca.crt integer array
tls.crt integer array
tls.key integer array

# CertificateStringData

Appears in:

FieldDescription
ca.crt string
tls.crt string
tls.key string

# Condition

Condition saves the state information of the EMQX cluster

Appears in:

FieldDescription
type ConditionTypeStatus of cluster condition.
lastUpdateTime stringThe last time this condition was updated.
lastTransitionTime stringLast time the condition transitioned from one status to another.
reason stringThe reason for the condition's last transition.
message stringA human readable message indicating details about the transition.

# ConditionType

Underlying type: string

ConditionType defines the condition that the RF can have

Appears in:

# EmqxBroker

EmqxBroker is the Schema for the emqxbrokers API

FieldDescription
apiVersion stringapps.emqx.io/v1beta2
kind stringEmqxBroker
metadata ObjectMeta (opens new window)Refer to Kubernetes API documentation for fields of metadata.
spec EmqxBrokerSpec
status Status

# EmqxBrokerSpec

EmqxBrokerSpec defines the desired state of EmqxBroker

Appears in:

FieldDescription
replicas integerThe fields of Broker. The replicas of emqx broker
image string
imagePullPolicy PullPolicy (opens new window)
imagePullSecrets LocalObjectReference (opens new window) array
serviceAccountName string
resources ResourceRequirements (opens new window)The service account name which is being bind with the service account of the crd instance.
storage PersistentVolumeClaimSpec (opens new window)
labels object (keys:string, values:string)The labels configure must be specified.
annotations object (keys:string, values:string)
affinity Affinity (opens new window)
toleRations Toleration (opens new window) array
nodeName string
nodeSelector object (keys:string, values:string)
extraVolumes Volume (opens new window) array
extraVolumeMounts VolumeMount (opens new window) array
env EnvVar (opens new window) array
securityContext PodSecurityContext (opens new window)
emqxTemplate EmqxBrokerTemplate
telegrafTemplate TelegrafTemplate

# EmqxBrokerTemplate

Appears in:

FieldDescription
listener Listener
acl ACL array
modules EmqxBrokerModule array
plugins Plugin array

# EmqxEnterprise

EmqxEnterprise is the Schema for the emqxenterprises API

FieldDescription
apiVersion stringapps.emqx.io/v1beta2
kind stringEmqxEnterprise
metadata ObjectMeta (opens new window)Refer to Kubernetes API documentation for fields of metadata.
spec EmqxEnterpriseSpec
status Status

# EmqxEnterpriseSpec

EmqxEnterpriseSpec defines the desired state of EmqxEnterprise

Appears in:

FieldDescription
replicas integerThe fields of Broker. The replicas of emqx broker
image string
imagePullPolicy PullPolicy (opens new window)
imagePullSecrets LocalObjectReference (opens new window) array
serviceAccountName string
resources ResourceRequirements (opens new window)The service account name which is being bind with the service account of the crd instance.
storage PersistentVolumeClaimSpec (opens new window)
labels object (keys:string, values:string)The labels configure must be specified.
annotations object (keys:string, values:string)
affinity Affinity (opens new window)
toleRations Toleration (opens new window) array
nodeName string
nodeSelector object (keys:string, values:string)
extraVolumes Volume (opens new window) array
extraVolumeMounts VolumeMount (opens new window) array
env EnvVar (opens new window) array
securityContext PodSecurityContext (opens new window)
emqxTemplate EmqxEnterpriseTemplate
telegrafTemplate TelegrafTemplate

# EmqxEnterpriseTemplate

Appears in:

FieldDescription
license string
listener Listener
acl ACL array
modules EmqxEnterpriseModule array
plugins Plugin array

# Listener

Appears in:

FieldDescription
labels object (keys:string, values:string)
annotations object (keys:string, values:string)
type ServiceType (opens new window)
loadBalancerIP string
loadBalancerSourceRanges string array
externalIPs string array
ports Ports
nodePorts Ports
certificate Certificate

# Plugin

Appears in:

FieldDescription
name string
enable boolean

# Ports

Appears in:

FieldDescription
mqtt integer
mqtts integer
ws integer
wss integer
dashboard integer
api integer

# Status

Emqx Status defines the observed state of EMQX

Appears in:

FieldDescription
conditions Condition arrayINSERT ADDITIONAL STATUS FIELD - define observed state of cluster Important: Run "operator-sdk generate k8s" to regenerate code after modifying this file Add custom validation using kubebuilder tags: https://book.kubebuilder.io/beyond_basics/generating_crd.html

# TelegrafTemplate

Appears in:

FieldDescription
image string
conf string
resources ResourceRequirements (opens new window)
imagePullPolicy PullPolicy (opens new window)

# Topics

Appears in:

FieldDescription
filter string array
equal string array
What’s on this page