in JSON) Notice that desired and actual state are separated REST API desired state REST API actual state REST API is uniform, i.e. all resources has the same structure: kind, apiVersion, metadata, spec, Status REST API is extensible, you can add your own objects freely kind: Pod # What kind of object is this? apiVersion: v1 # What schema version is used? metadata: # Metadata about this object name: my-pod labels: app: web spec: # Desired state, set by user containers: - image: nginx:1.23 ports: - containerPort: 80 status: # Actual, observed state, set by controller conditions: - type: Ready status: "True" lastTransitionTime: 2018-01-01T00:00:00Z