Top Level API Objects

Definitions

v1.Node

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard object metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ObjectMeta

spec

specification of a node; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status

false

v1.NodeSpec

status

most recently observed status of the node; populated by the system, read-only; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status

false

v1.NodeStatus

v1.PersistentVolumeClaimList

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard list metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

v1.ListMeta

items

a list of persistent volume claims; see http://releases.k8s.io/HEAD/docs/persistent-volumes.md#persistentvolumeclaims

false

v1.PersistentVolumeClaim array

v1.ObjectFieldSelector

Name Description Required Schema Default

apiVersion

version of the schema that fieldPath is written in terms of; defaults to v1

false

string

fieldPath

path of the field to select in the specified API version

true

string

v1.SELinuxOptions

Name Description Required Schema Default

user

the user label to apply to the container; see http://releases.k8s.io/HEAD/docs/labels.md

false

string

role

the role label to apply to the container; see http://releases.k8s.io/HEAD/docs/labels.md

false

string

type

the type label to apply to the container; see http://releases.k8s.io/HEAD/docs/labels.md

false

string

level

the level label to apply to the container; see http://releases.k8s.io/HEAD/docs/labels.md

false

string

v1.ContainerStateRunning

Name Description Required Schema Default

startedAt

time at which the container was last (re-)started

false

string

v1.VolumeMount

Name Description Required Schema Default

name

name of the volume to mount

true

string

readOnly

mounted read-only if true, read-write otherwise (false or unspecified)

false

boolean

false

mountPath

path within the container at which the volume should be mounted

true

string

v1.PersistentVolumeClaimSpec

Name Description Required Schema Default

accessModes

the desired access modes the volume should have; see http://releases.k8s.io/HEAD/docs/persistent-volumes.md#access-modes-1

false

v1.PersistentVolumeAccessMode array

resources

the desired resources the volume should have; see http://releases.k8s.io/HEAD/docs/persistent-volumes.md#resources

false

v1.ResourceRequirements

volumeName

the binding reference to the persistent volume backing this claim

false

string

v1.GCEPersistentDiskVolumeSource

Name Description Required Schema Default

pdName

unique name of the PD resource in GCE; see http://releases.k8s.io/HEAD/docs/volumes.md#gcepersistentdisk

true

string

fsType

file system type to mount, such as ext4, xfs, ntfs; see http://releases.k8s.io/HEAD/docs/volumes.md#gcepersistentdisk

true

string

partition

partition on the disk to mount (e.g., 1 for /dev/sda1); if omitted the plain device name (e.g., /dev/sda) will be mounted; see http://releases.k8s.io/HEAD/docs/volumes.md#gcepersistentdisk

false

integer (int32)

readOnly

read-only if true, read-write otherwise (false or unspecified); see http://releases.k8s.io/HEAD/docs/volumes.md#gcepersistentdisk

false

boolean

false

v1.NamespaceStatus

Name Description Required Schema Default

phase

phase is the current lifecycle phase of the namespace; see http://releases.k8s.io/HEAD/docs/design/namespaces.md#phases

false

string

v1.ResourceQuotaSpec

Name Description Required Schema Default

hard

hard is the set of desired hard limits for each named resource; see http://releases.k8s.io/HEAD/docs/design/admission_control_resource_quota.md#admissioncontrol-plugin-resourcequota

false

any

v1.NamespaceSpec

Name Description Required Schema Default

finalizers

an opaque list of values that must be empty to permanently remove object from storage; see http://releases.k8s.io/HEAD/docs/design/namespaces.md#finalizers

false

v1.FinalizerName array

v1.PersistentVolume

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard object metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ObjectMeta

spec

specification of a persistent volume as provisioned by an administrator; see http://releases.k8s.io/HEAD/docs/persistent-volumes.md#persistent-volumes

false

v1.PersistentVolumeSpec

status

current status of a persistent volume; populated by the system, read-only; see http://releases.k8s.io/HEAD/docs/persistent-volumes.md#persistent-volumes

false

v1.PersistentVolumeStatus

v1.PersistentVolumeStatus

Name Description Required Schema Default

phase

the current phase of a persistent volume; see http://releases.k8s.io/HEAD/docs/persistent-volumes.md#phase

false

string

message

human-readable message indicating details about why the volume is in this state

false

string

reason

(brief) reason the volume is not is not available

false

string

v1.EndpointsList

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard list metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ListMeta

items

list of endpoints

true

v1.Endpoints array

v1.GitRepoVolumeSource

Name Description Required Schema Default

repository

repository URL

true

string

revision

commit hash for the specified revision

true

string

v1.Capabilities

Name Description Required Schema Default

add

added capabilities

false

v1.Capability array

drop

droped capabilities

false

v1.Capability array

v1.NodeCondition

Name Description Required Schema Default

type

type of node condition, currently only Ready

true

string

status

status of the condition, one of True, False, Unknown

true

string

lastHeartbeatTime

last time we got an update on a given condition

false

string

lastTransitionTime

last time the condition transit from one status to another

false

string

reason

(brief) reason for the condition’s last transition

false

string

message

human readable message indicating details about last transition

false

string

v1.PodTemplateList

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard list metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ListMeta

items

list of pod templates

true

v1.PodTemplate array

v1.LocalObjectReference

Name Description Required Schema Default

name

name of the referent; see http://releases.k8s.io/HEAD/docs/identifiers.md#names

false

string

v1.ResourceQuotaStatus

Name Description Required Schema Default

hard

hard is the set of enforced hard limits for each named resource; see http://releases.k8s.io/HEAD/docs/design/admission_control_resource_quota.md#admissioncontrol-plugin-resourcequota

false

any

used

used is the current observed total usage of the resource in the namespace

false

any

v1.ExecAction

Name Description Required Schema Default

command

command line to execute inside the container; working directory for the command is root (/) in the container’s file system; the command is exec’d, not run inside a shell; exit status of 0 is treated as live/healthy and non-zero is unhealthy

false

string array

v1.ObjectMeta

Name Description Required Schema Default

name

string that identifies an object. Must be unique within a namespace; cannot be updated; see http://releases.k8s.io/HEAD/docs/identifiers.md#names

false

string

generateName

an optional prefix to use to generate a unique name; has the same validation rules as name; optional, and is applied only name if is not specified; see http://releases.k8s.io/HEAD/docs/api-conventions.md#idempotency

false

string

namespace

namespace of the object; must be a DNS_LABEL; cannot be updated; see http://releases.k8s.io/HEAD/docs/namespaces.md

false

string

selfLink

URL for the object; populated by the system, read-only

false

string

uid

unique UUID across space and time; populated by the system; read-only; see http://releases.k8s.io/HEAD/docs/identifiers.md#uids

false

string

resourceVersion

string that identifies the internal version of this object that can be used by clients to determine when objects have changed; populated by the system, read-only; value must be treated as opaque by clients and passed unmodified back to the server: http://releases.k8s.io/HEAD/docs/api-conventions.md#concurrency-control-and-consistency

false

string

generation

a sequence number representing a specific generation of the desired state; populated by the system; read-only

false

integer (int64)

creationTimestamp

RFC 3339 date and time at which the object was created; populated by the system, read-only; null for lists; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

string

deletionTimestamp

RFC 3339 date and time at which the object will be deleted; populated by the system when a graceful deletion is requested, read-only; if not set, graceful deletion of the object has not been requested; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

string

labels

map of string keys and values that can be used to organize and categorize objects; may match selectors of replication controllers and services; see http://releases.k8s.io/HEAD/docs/labels.md

false

any

annotations

map of string keys and values that can be used by external tooling to store and retrieve arbitrary metadata about objects; see http://releases.k8s.io/HEAD/docs/annotations.md

false

any

api.Patch

v1.LimitRangeSpec

Name Description Required Schema Default

limits

limits is the list of LimitRangeItem objects that are enforced

true

v1.LimitRangeItem array

v1.ISCSIVolumeSource

Name Description Required Schema Default

targetPortal

iSCSI target portal

true

string

iqn

iSCSI Qualified Name

true

string

lun

iscsi target lun number

true

integer (int32)

fsType

file system type to mount, such as ext4, xfs, ntfs

true

string

readOnly

read-only if true, read-write otherwise (false or unspecified)

false

boolean

false

v1.EmptyDirVolumeSource

Name Description Required Schema Default

medium

type of storage used to back the volume; must be an empty string (default) or Memory; see http://releases.k8s.io/HEAD/docs/volumes.md#emptydir

false

string

v1.NodeList

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard list metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ListMeta

items

list of nodes

true

v1.Node array

v1.PersistentVolumeClaim

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard object metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ObjectMeta

spec

the desired characteristics of a volume; see http://releases.k8s.io/HEAD/docs/persistent-volumes.md#persistentvolumeclaims

false

v1.PersistentVolumeClaimSpec

status

the current status of a persistent volume claim; read-only; see http://releases.k8s.io/HEAD/docs/persistent-volumes.md#persistentvolumeclaims

false

v1.PersistentVolumeClaimStatus

v1.NamespaceList

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard list metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ListMeta

items

items is the list of Namespace objects in the list; see http://releases.k8s.io/HEAD/docs/namespaces.md

true

v1.Namespace array

v1.ServiceAccount

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard object metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ObjectMeta

secrets

list of secrets that can be used by pods running as this service account; see http://releases.k8s.io/HEAD/docs/secrets.md

false

v1.ObjectReference array

imagePullSecrets

list of references to secrets in the same namespace available for pulling container images; see http://releases.k8s.io/HEAD/docs/secrets.md#manually-specifying-an-imagepullsecret

false

v1.LocalObjectReference array

v1.NodeAddress

Name Description Required Schema Default

type

node address type, one of Hostname, ExternalIP or InternalIP

true

string

address

the node address

true

string

v1.Namespace

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard object metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ObjectMeta

spec

spec defines the behavior of the Namespace; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status

false

v1.NamespaceSpec

status

status describes the current status of a Namespace; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status

false

v1.NamespaceStatus

v1.ListMeta

Name Description Required Schema Default

selfLink

URL for the object; populated by the system, read-only

false

string

resourceVersion

string that identifies the internal version of this object that can be used by clients to determine when objects have changed; populated by the system, read-only; value must be treated as opaque by clients and passed unmodified back to the server: http://releases.k8s.io/HEAD/docs/api-conventions.md#concurrency-control-and-consistency

false

string

v1.PersistentVolumeClaimVolumeSource

Name Description Required Schema Default

claimName

the name of the claim in the same namespace to be mounted as a volume; see http://releases.k8s.io/HEAD/docs/persistent-volumes.md#persistentvolumeclaims

true

string

readOnly

mount volume as read-only when true; default false

false

boolean

false

v1.PersistentVolumeClaimStatus

Name Description Required Schema Default

phase

the current phase of the claim

false

string

accessModes

the actual access modes the volume has; see http://releases.k8s.io/HEAD/docs/persistent-volumes.md#access-modes-1

false

v1.PersistentVolumeAccessMode array

capacity

the actual resources the volume has

false

any

v1.ResourceQuotaList

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard list metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ListMeta

items

items is a list of ResourceQuota objects; see http://releases.k8s.io/HEAD/docs/design/admission_control_resource_quota.md#admissioncontrol-plugin-resourcequota

true

v1.ResourceQuota array

v1.EndpointSubset

Name Description Required Schema Default

addresses

IP addresses which offer the related ports

false

v1.EndpointAddress array

ports

port numbers available on the related IP addresses

false

v1.EndpointPort array

v1.SecretVolumeSource

Name Description Required Schema Default

secretName

secretName is the name of a secret in the pod’s namespace; see http://releases.k8s.io/HEAD/docs/volumes.md#secrets

true

string

v1.EnvVarSource

Name Description Required Schema Default

fieldRef

selects a field of the pod; only name and namespace are supported

true

v1.ObjectFieldSelector

v1.LoadBalancerIngress

Name Description Required Schema Default

ip

IP address of ingress point

false

string

hostname

hostname of ingress point

false

string

v1.Service

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard object metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ObjectMeta

spec

specification of the desired behavior of the service; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status

false

v1.ServiceSpec

status

most recently observed status of the service; populated by the system, read-only; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status

false

v1.ServiceStatus

v1.ServiceAccountList

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard list metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ListMeta

items

list of ServiceAccounts; see http://releases.k8s.io/HEAD/docs/service_accounts.md#service-accounts

true

v1.ServiceAccount array

v1.LimitRangeList

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard list metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ListMeta

items

items is a list of LimitRange objects; see http://releases.k8s.io/HEAD/docs/design/admission_control_limit_range.md

true

v1.LimitRange array

v1.Endpoints

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard object metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ObjectMeta

subsets

sets of addresses and ports that comprise a service

true

v1.EndpointSubset array

v1.DeleteOptions

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

gracePeriodSeconds

the duration in seconds to wait before deleting this object; defaults to a per object value if not specified; zero means delete immediately

true

integer (int64)

v1.Volume

Name Description Required Schema Default

name

volume name; must be a DNS_LABEL and unique within the pod; see http://releases.k8s.io/HEAD/docs/identifiers.md#names

true

string

hostPath

pre-existing host file or directory; generally for privileged system daemons or other agents tied to the host; see http://releases.k8s.io/HEAD/docs/volumes.md#hostpath

false

v1.HostPathVolumeSource

emptyDir

temporary directory that shares a pod’s lifetime; see http://releases.k8s.io/HEAD/docs/volumes.md#emptydir

false

v1.EmptyDirVolumeSource

gcePersistentDisk

GCE disk resource attached to the host machine on demand; see http://releases.k8s.io/HEAD/docs/volumes.md#gcepersistentdisk

false

v1.GCEPersistentDiskVolumeSource

awsElasticBlockStore

AWS disk resource attached to the host machine on demand; see http://releases.k8s.io/HEAD/docs/volumes.md#awselasticblockstore

false

v1.AWSElasticBlockStoreVolumeSource

gitRepo

git repository at a particular revision

false

v1.GitRepoVolumeSource

secret

secret to populate volume; see http://releases.k8s.io/HEAD/docs/volumes.md#secrets

false

v1.SecretVolumeSource

nfs

NFS volume that will be mounted in the host machine; see http://releases.k8s.io/HEAD/docs/volumes.md#nfs

false

v1.NFSVolumeSource

iscsi

iSCSI disk attached to host machine on demand; see http://releases.k8s.io/HEAD/examples/iscsi/README.md

false

v1.ISCSIVolumeSource

glusterfs

Glusterfs volume that will be mounted on the host machine; see http://releases.k8s.io/HEAD/examples/glusterfs/README.md

false

v1.GlusterfsVolumeSource

persistentVolumeClaim

a reference to a PersistentVolumeClaim in the same namespace; see http://releases.k8s.io/HEAD/docs/persistent-volumes.md#persistentvolumeclaims

false

v1.PersistentVolumeClaimVolumeSource

rbd

rados block volume that will be mounted on the host machine; see http://releases.k8s.io/HEAD/examples/rbd/README.md

false

v1.RBDVolumeSource

v1.Probe

Name Description Required Schema Default

exec

exec-based handler

false

v1.ExecAction

httpGet

HTTP-based handler

false

v1.HTTPGetAction

tcpSocket

TCP-based handler; TCP hooks not yet supported

false

v1.TCPSocketAction

initialDelaySeconds

number of seconds after the container has started before liveness probes are initiated; see http://releases.k8s.io/HEAD/docs/pod-states.md#container-probes

false

integer (int64)

timeoutSeconds

number of seconds after which liveness probes timeout; defaults to 1 second; see http://releases.k8s.io/HEAD/docs/pod-states.md#container-probes

false

integer (int64)

v1.Capability

v1.ReplicationController

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard object metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ObjectMeta

spec

specification of the desired behavior of the replication controller; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status

false

v1.ReplicationControllerSpec

status

most recently observed status of the replication controller; populated by the system, read-only; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status

false

v1.ReplicationControllerStatus

v1.LimitRange

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard object metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ObjectMeta

spec

spec defines the limits enforced; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status

false

v1.LimitRangeSpec

v1.PodStatus

Name Description Required Schema Default

phase

current condition of the pod; see http://releases.k8s.io/HEAD/docs/pod-states.md#pod-phase

false

string

conditions

current service state of pod; see http://releases.k8s.io/HEAD/docs/pod-states.md#pod-conditions

false

v1.PodCondition array

message

human readable message indicating details about why the pod is in this condition

false

string

reason

(brief-CamelCase) reason indicating details about why the pod is in this condition

false

string

hostIP

IP address of the host to which the pod is assigned; empty if not yet scheduled

false

string

podIP

IP address allocated to the pod; routable at least within the cluster; empty if not yet allocated

false

string

startTime

RFC 3339 date and time at which the object was acknowledged by the Kubelet. This is before the Kubelet pulled the container image(s) for the pod.

false

string

containerStatuses

list of container statuses; see http://releases.k8s.io/HEAD/docs/pod-states.md#container-statuses

false

v1.ContainerStatus array

v1.PodSpec

Name Description Required Schema Default

volumes

list of volumes that can be mounted by containers belonging to the pod; see http://releases.k8s.io/HEAD/docs/volumes.md

false

v1.Volume array

containers

list of containers belonging to the pod; cannot be updated; containers cannot currently be added or removed; there must be at least one container in a Pod; see http://releases.k8s.io/HEAD/docs/containers.md

true

v1.Container array

restartPolicy

restart policy for all containers within the pod; one of Always, OnFailure, Never; defaults to Always; see http://releases.k8s.io/HEAD/docs/pod-states.md#restartpolicy

false

string

terminationGracePeriodSeconds

optional duration in seconds the pod needs to terminate gracefully; may be decreased in delete request; value must be non-negative integer; the value zero indicates delete immediately; if this value is not set, the default grace period will be used instead; 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 longer than the expected cleanup time for your process

false

integer (int64)

activeDeadlineSeconds

false

integer (int64)

dnsPolicy

DNS policy for containers within the pod; one of ClusterFirst or Default

false

string

nodeSelector

selector which must match a node’s labels for the pod to be scheduled on that node; see http://releases.k8s.io/HEAD/examples/node-selection/README.md

false

any

serviceAccountName

name of the ServiceAccount to use to run this pod; see http://releases.k8s.io/HEAD/docs/service_accounts.md

false

string

nodeName

node requested for this pod

false

string

hostNetwork

host networking requested for this pod

false

boolean

false

imagePullSecrets

list of references to secrets in the same namespace available for pulling the container images; see http://releases.k8s.io/HEAD/docs/images.md#specifying-imagepullsecrets-on-a-pod

false

v1.LocalObjectReference array

v1.ContainerPort

Name Description Required Schema Default

name

name for the port that can be referred to by services; must be an IANA_SVC_NAME and unique within the pod

false

string

hostPort

number of port to expose on the host; most containers do not need this

false

integer (int32)

containerPort

number of port to expose on the pod’s IP address

true

integer (int32)

protocol

protocol for port; must be UDP or TCP; TCP if unspecified

false

string

hostIP

host IP to bind the port to

false

string

v1.EventList

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard list metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ListMeta

items

list of events

true

v1.Event array

v1.ResourceQuota

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard object metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ObjectMeta

spec

spec defines the desired quota; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status

false

v1.ResourceQuotaSpec

status

status defines the actual enforced quota and current usage; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status

false

v1.ResourceQuotaStatus

v1.Lifecycle

Name Description Required Schema Default

postStart

called immediately after a container is started; if the handler fails, the container is terminated and restarted according to its restart policy; other management of the container blocks until the hook completes; see http://releases.k8s.io/HEAD/docs/container-environment.md#hook-details

false

v1.Handler

preStop

called before a container is terminated; the container is terminated after the handler completes; other management of the container blocks until the hook completes; see http://releases.k8s.io/HEAD/docs/container-environment.md#hook-details

false

v1.Handler

v1.NodeStatus

Name Description Required Schema Default

capacity

compute resource capacity of the node; see http://releases.k8s.io/HEAD/docs/compute_resources.md

false

any

phase

most recently observed lifecycle phase of the node; see http://releases.k8s.io/HEAD/docs/node.md#node-phase

false

string

conditions

list of node conditions observed; see http://releases.k8s.io/HEAD/docs/node.md#node-condition

false

v1.NodeCondition array

addresses

list of addresses reachable to the node; see http://releases.k8s.io/HEAD/docs/node.md#node-addresses

false

v1.NodeAddress array

nodeInfo

set of ids/uuids to uniquely identify the node; see http://releases.k8s.io/HEAD/docs/node.md#node-info

false

v1.NodeSystemInfo

v1.GlusterfsVolumeSource

Name Description Required Schema Default

endpoints

gluster hosts endpoints name; see http://releases.k8s.io/HEAD/examples/glusterfs/README.md#create-a-pod

true

string

path

path to gluster volume; see http://releases.k8s.io/HEAD/examples/glusterfs/README.md#create-a-pod

true

string

readOnly

glusterfs volume to be mounted with read-only permissions; see http://releases.k8s.io/HEAD/examples/glusterfs/README.md#create-a-pod

false

boolean

false

v1.Handler

Name Description Required Schema Default

exec

exec-based handler

false

v1.ExecAction

httpGet

HTTP-based handler

false

v1.HTTPGetAction

tcpSocket

TCP-based handler; TCP hooks not yet supported

false

v1.TCPSocketAction

v1.ReplicationControllerSpec

Name Description Required Schema Default

replicas

number of replicas desired; defaults to 1; see http://releases.k8s.io/HEAD/docs/replication-controller.md#what-is-a-replication-controller

false

integer (int32)

selector

label keys and values that must match in order to be controlled by this replication controller, if empty defaulted to labels on Pod template; see http://releases.k8s.io/HEAD/docs/labels.md#label-selectors

false

any

template

object that describes the pod that will be created if insufficient replicas are detected; takes precedence over templateRef; see http://releases.k8s.io/HEAD/docs/replication-controller.md#pod-template

false

v1.PodTemplateSpec

v1.EventSource

Name Description Required Schema Default

component

component that generated the event

false

string

host

name of the host where the event is generated

false

string

v1.StatusCause

Name Description Required Schema Default

reason

machine-readable description of the cause of the error; if this value is empty there is no information available

false

string

message

human-readable description of the cause of the error; this field may be presented as-is to a reader

false

string

field

field of the resource that has caused this error, as named by its JSON serialization; may include dot and postfix notation for nested attributes; arrays are zero-indexed; fields may appear more than once in an array of causes due to fields having multiple errors

false

string

v1.PodCondition

Name Description Required Schema Default

type

kind of the condition, currently only Ready; see http://releases.k8s.io/HEAD/docs/pod-states.md#pod-conditions

true

string

status

status of the condition, one of True, False, Unknown; see http://releases.k8s.io/HEAD/docs/pod-states.md#pod-conditions

true

string

v1.RBDVolumeSource

Name Description Required Schema Default

monitors

a collection of Ceph monitors; see http://releases.k8s.io/HEAD/examples/rbd/README.md#how-to-use-it

true

string array

image

rados image name; see http://releases.k8s.io/HEAD/examples/rbd/README.md#how-to-use-it

true

string

fsType

file system type to mount, such as ext4, xfs, ntfs; see http://releases.k8s.io/HEAD/examples/rbd/README.md#how-to-use-it

false

string

pool

rados pool name; default is rbd; optional; see http://releases.k8s.io/HEAD/examples/rbd/README.md#how-to-use-it

true

string

user

rados user name; default is admin; optional; see http://releases.k8s.io/HEAD/examples/rbd/README.md#how-to-use-it

true

string

keyring

keyring is the path to key ring for rados user; default is /etc/ceph/keyring; optional; see http://releases.k8s.io/HEAD/examples/rbd/README.md#how-to-use-it

true

string

secretRef

name of a secret to authenticate the RBD user; if provided overrides keyring; optional; see http://releases.k8s.io/HEAD/examples/rbd/README.md#how-to-use-it

true

v1.LocalObjectReference

readOnly

rbd volume to be mounted with read-only permissions; see http://releases.k8s.io/HEAD/examples/rbd/README.md#how-to-use-it

false

boolean

false

v1.Status

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard list metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ListMeta

status

status of the operation; either Success, or Failure; see http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status

false

string

message

human-readable description of the status of this operation

false

string

reason

machine-readable description of why this operation is in the Failure status; if this value is empty there is no information available; a reason clarifies an HTTP status code but does not override it

false

string

details

extended data associated with the reason; each reason may define its own extended details; this field is optional and the data returned is not guaranteed to conform to any schema except that defined by the reason type

false

v1.StatusDetails

code

suggested HTTP return code for this status; 0 if not set

false

integer (int32)

v1.PodTemplate

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard object metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ObjectMeta

template

the template of the desired behavior of the pod; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status

false

v1.PodTemplateSpec

v1.ServiceStatus

Name Description Required Schema Default

loadBalancer

status of load-balancer

false

v1.LoadBalancerStatus

v1.NFSVolumeSource

Name Description Required Schema Default

server

the hostname or IP address of the NFS server; see http://releases.k8s.io/HEAD/docs/volumes.md#nfs

true

string

path

the path that is exported by the NFS server; see http://releases.k8s.io/HEAD/docs/volumes.md#nfs

true

string

readOnly

forces the NFS export to be mounted with read-only permissions; see http://releases.k8s.io/HEAD/docs/volumes.md#nfs

false

boolean

false

v1.EndpointPort

Name Description Required Schema Default

name

name of this port

false

string

port

port number of the endpoint

true

integer (int32)

protocol

protocol for this port; must be UDP or TCP; TCP if unspecified

false

string

v1.TCPSocketAction

Name Description Required Schema Default

port

number or name of the port to access on the container; number must be in the range 1 to 65535; name must be an IANA_SVC_NAME

true

string

v1.HTTPGetAction

Name Description Required Schema Default

path

path to access on the HTTP server

false

string

port

number or name of the port to access on the container; number must be in the range 1 to 65535; name must be an IANA_SVC_NAME

true

string

host

hostname to connect to; defaults to pod IP

false

string

scheme

scheme to connect with, must be HTTP or HTTPS, defaults to HTTP

false

string

v1.StatusDetails

Name Description Required Schema Default

name

the name attribute of the resource associated with the status StatusReason (when there is a single name which can be described)

false

string

kind

the kind attribute of the resource associated with the status StatusReason; on some operations may differ from the requested resource Kind; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

causes

the Causes array includes more details associated with the StatusReason failure; not all StatusReasons may provide detailed causes

false

v1.StatusCause array

retryAfterSeconds

the number of seconds before the client should attempt to retry this operation

false

integer (int32)

v1.LoadBalancerStatus

Name Description Required Schema Default

ingress

load-balancer ingress points

false

v1.LoadBalancerIngress array

v1.SecretList

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard list metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ListMeta

items

items is a list of secret objects; see http://releases.k8s.io/HEAD/docs/secrets.md

true

v1.Secret array

v1.Container

Name Description Required Schema Default

name

name of the container; must be a DNS_LABEL and unique within the pod; cannot be updated

true

string

image

Docker image name; see http://releases.k8s.io/HEAD/docs/images.md

false

string

command

entrypoint array; not executed within a shell; the docker image’s entrypoint is used if this is not provided; cannot be updated; variable references $(VAR_NAME) are expanded using the container’s environment variables; if a variable cannot be resolved, the reference in the input string will be unchanged; the $(VAR_NAME) syntax can be escaped with a double , ie: (VAR_NAME) ; escaped references will never be expanded, regardless of whether the variable exists or not; see http://releases.k8s.io/HEAD/docs/containers.md#containers-and-commands

false

string array

args

command array; the docker image’s cmd is used if this is not provided; arguments to the entrypoint; cannot be updated; variable references $(VAR_NAME) are expanded using the container’s environment variables; if a variable cannot be resolved, the reference in the input string will be unchanged; the $(VAR_NAME) syntax can be escaped with a double , ie: (VAR_NAME) ; escaped references will never be expanded, regardless of whether the variable exists or not; see http://releases.k8s.io/HEAD/docs/containers.md#containers-and-commands

false

string array

workingDir

container’s working directory; defaults to image’s default; cannot be updated

false

string

ports

list of ports to expose from the container; cannot be updated

false

v1.ContainerPort array

env

list of environment variables to set in the container; cannot be updated

false

v1.EnvVar array

resources

Compute Resources required by this container; cannot be updated; see http://releases.k8s.io/HEAD/docs/compute_resources.md

false

v1.ResourceRequirements

volumeMounts

pod volumes to mount into the container’s filesyste; cannot be updated

false

v1.VolumeMount array

livenessProbe

periodic probe of container liveness; container will be restarted if the probe fails; cannot be updated; see http://releases.k8s.io/HEAD/docs/pod-states.md#container-probes

false

v1.Probe

readinessProbe

periodic probe of container service readiness; container will be removed from service endpoints if the probe fails; cannot be updated; see http://releases.k8s.io/HEAD/docs/pod-states.md#container-probes

false

v1.Probe

lifecycle

actions that the management system should take in response to container lifecycle events; cannot be updated

false

v1.Lifecycle

terminationMessagePath

path at which the file to which the container’s termination message will be written is mounted into the container’s filesystem; message written is intended to be brief final status, such as an assertion failure message; defaults to /dev/termination-log; cannot be updated

false

string

imagePullPolicy

image pull policy; one of Always, Never, IfNotPresent; defaults to Always if :latest tag is specified, or IfNotPresent otherwise; cannot be updated; see http://releases.k8s.io/HEAD/docs/images.md#updating-images

false

string

securityContext

security options the pod should run with; see http://releases.k8s.io/HEAD/docs/security_context.md

false

v1.SecurityContext

v1.PersistentVolumeSpec

Name Description Required Schema Default

capacity

a description of the persistent volume’s resources and capacityr; see http://releases.k8s.io/HEAD/docs/persistent-volumes.md#capacity

false

any

gcePersistentDisk

GCE disk resource provisioned by an admin; see http://releases.k8s.io/HEAD/docs/volumes.md#gcepersistentdisk

false

v1.GCEPersistentDiskVolumeSource

awsElasticBlockStore

AWS disk resource provisioned by an admin; see http://releases.k8s.io/HEAD/docs/volumes.md#awselasticblockstore

false

v1.AWSElasticBlockStoreVolumeSource

hostPath

a HostPath provisioned by a developer or tester; for development use only; see http://releases.k8s.io/HEAD/docs/volumes.md#hostpath

false

v1.HostPathVolumeSource

glusterfs

Glusterfs volume resource provisioned by an admin; see http://releases.k8s.io/HEAD/examples/glusterfs/README.md

false

v1.GlusterfsVolumeSource

nfs

NFS volume resource provisioned by an admin; see http://releases.k8s.io/HEAD/docs/volumes.md#nfs

false

v1.NFSVolumeSource

rbd

rados block volume that will be mounted on the host machine; see http://releases.k8s.io/HEAD/examples/rbd/README.md

false

v1.RBDVolumeSource

iscsi

an iSCSI disk resource provisioned by an admin

false

v1.ISCSIVolumeSource

accessModes

all ways the volume can be mounted; see http://releases.k8s.io/HEAD/docs/persistent-volumes.md#access-modes

false

v1.PersistentVolumeAccessMode array

claimRef

when bound, a reference to the bound claim; see http://releases.k8s.io/HEAD/docs/persistent-volumes.md#binding

false

v1.ObjectReference

persistentVolumeReclaimPolicy

what happens to a volume when released from its claim; Valid options are Retain (default) and Recycle. Recyling must be supported by the volume plugin underlying this persistent volume. See http://releases.k8s.io/HEAD/docs/persistent-volumes.md#recycling-policy

false

string

v1.ReplicationControllerStatus

Name Description Required Schema Default

replicas

most recently oberved number of replicas; see http://releases.k8s.io/HEAD/docs/replication-controller.md#what-is-a-replication-controller

true

integer (int32)

observedGeneration

reflects the generation of the most recently observed replication controller

false

integer (int64)

v1.FinalizerName

v1.ServicePort

Name Description Required Schema Default

name

the name of this port; optional if only one port is defined

false

string

protocol

the protocol used by this port; must be UDP or TCP; TCP if unspecified

false

string

port

the port number that is exposed

true

integer (int32)

targetPort

number or name of the port to access on the pods targeted by the service; defaults to the service port; number must be in the range 1 to 65535; name must be an IANA_SVC_NAME; see http://releases.k8s.io/HEAD/docs/services.md#defining-a-service

false

string

nodePort

the port on each node on which this service is exposed when type=NodePort or LoadBalancer; usually assigned by the system; if specified, it will be allocated to the service if unused or else creation of the service will fail; see http://releases.k8s.io/HEAD/docs/services.md#type—nodeport

true

integer (int32)

v1.ComponentCondition

Name Description Required Schema Default

type

type of component condition, currently only Healthy

true

string

status

current status of this component condition, one of True, False, Unknown

true

string

message

health check message received from the component

false

string

error

error code from health check attempt (if any)

false

string

v1.ComponentStatusList

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard list metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ListMeta

items

list of component status objects

true

v1.ComponentStatus array

v1.HostPathVolumeSource

Name Description Required Schema Default

path

path of the directory on the host; see http://releases.k8s.io/HEAD/docs/volumes.md#hostpath

true

string

json.WatchEvent

Name Description Required Schema Default

type

the type of watch event; may be ADDED, MODIFIED, DELETED, or ERROR

false

string

object

the object being watched; will match the type of the resource endpoint or be a Status object if the type is ERROR

false

string

v1.Binding

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard object metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ObjectMeta

target

an object to bind to

true

v1.ObjectReference

v1.ContainerStateTerminated

Name Description Required Schema Default

exitCode

exit status from the last termination of the container

true

integer (int32)

signal

signal from the last termination of the container

false

integer (int32)

reason

(brief) reason from the last termination of the container

false

string

message

message regarding the last termination of the container

false

string

startedAt

time at which previous execution of the container started

false

string

finishedAt

time at which the container last terminated

false

string

containerID

container’s ID in the format docker://<container_id>

false

string

v1.SecurityContext

Name Description Required Schema Default

capabilities

the linux capabilites that should be added or removed; see http://releases.k8s.io/HEAD/docs/design/security_context.md#security-context

false

v1.Capabilities

privileged

run the container in privileged mode; see http://releases.k8s.io/HEAD/docs/design/security_context.md#security-context

false

boolean

false

seLinuxOptions

options that control the SELinux labels applied; see http://releases.k8s.io/HEAD/docs/design/security_context.md#security-context

false

v1.SELinuxOptions

runAsUser

the user id that runs the first process in the container; see http://releases.k8s.io/HEAD/docs/design/security_context.md#security-context

false

integer (int64)

v1.ContainerState

Name Description Required Schema Default

waiting

details about a waiting container

false

v1.ContainerStateWaiting

running

details about a running container

false

v1.ContainerStateRunning

terminated

details about a terminated container

false

v1.ContainerStateTerminated

v1.AWSElasticBlockStoreVolumeSource

Name Description Required Schema Default

volumeID

unique id of the PD resource in AWS; see http://releases.k8s.io/HEAD/docs/volumes.md#awselasticblockstore

true

string

fsType

file system type to mount, such as ext4, xfs, ntfs; see http://releases.k8s.io/HEAD/docs/volumes.md#awselasticblockstore

true

string

partition

partition on the disk to mount (e.g., 1 for /dev/sda1); if omitted the plain device name (e.g., /dev/sda) will be mounted; see http://releases.k8s.io/HEAD/docs/volumes.md#awselasticblockstore

false

integer (int32)

readOnly

read-only if true, read-write otherwise (false or unspecified); see http://releases.k8s.io/HEAD/docs/volumes.md#awselasticblockstore

false

boolean

false

v1.ContainerStatus

Name Description Required Schema Default

name

name of the container; must be a DNS_LABEL and unique within the pod; cannot be updated

true

string

state

details about the container’s current condition

false

v1.ContainerState

lastState

details about the container’s last termination condition

false

v1.ContainerState

ready

specifies whether the container has passed its readiness probe

true

boolean

false

restartCount

the number of times the container has been restarted, currently based on the number of dead containers that have not yet been removed

true

integer (int32)

image

image of the container; see http://releases.k8s.io/HEAD/docs/images.md

true

string

imageID

ID of the container’s image

true

string

containerID

container’s ID in the format docker://<container_id>; see http://releases.k8s.io/HEAD/docs/container-environment.md#container-information

false

string

v1.ReplicationControllerList

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard list metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ListMeta

items

list of replication controllers; see http://releases.k8s.io/HEAD/docs/replication-controller.md

true

v1.ReplicationController array

v1.Secret

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard object metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ObjectMeta

data

data contains the secret data. Each key must be a valid DNS_SUBDOMAIN or leading dot followed by valid DNS_SUBDOMAIN. Each value must be a base64 encoded string as described in https://tools.ietf.org/html/rfc4648#section-4

false

any

type

type facilitates programmatic handling of secret data

false

string

v1.Event

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard object metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

true

v1.ObjectMeta

involvedObject

object this event is about

true

v1.ObjectReference

reason

short, machine understandable string that gives the reason for the transition into the object’s current status

false

string

message

human-readable description of the status of this operation

false

string

source

component reporting this event

false

v1.EventSource

firstTimestamp

the time at which the event was first recorded

false

string

lastTimestamp

the time at which the most recent occurrence of this event was recorded

false

string

count

the number of times this event has occurred

false

integer (int32)

v1.EnvVar

Name Description Required Schema Default

name

name of the environment variable; must be a C_IDENTIFIER

true

string

value

value of the environment variable; defaults to empty string; variable references $(VAR_NAME) are expanded using the previously defined environment varibles in the container and any service environment variables; if a variable cannot be resolved, the reference in the input string will be unchanged; the $(VAR_NAME) syntax can be escaped with a double , ie: (VAR_NAME) ; escaped references will never be expanded, regardless of whether the variable exists or not

false

string

valueFrom

source for the environment variable’s value; cannot be used if value is not empty

false

v1.EnvVarSource

v1.ResourceRequirements

Name Description Required Schema Default

limits

Maximum amount of compute resources allowed; see http://releases.k8s.io/HEAD/docs/design/resources.md#resource-specifications

false

any

requests

Minimum amount of resources requested; requests are honored only for persistent volumes as of now; see http://releases.k8s.io/HEAD/docs/design/resources.md#resource-specifications

false

any

v1.PersistentVolumeAccessMode

v1.ComponentStatus

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard object metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ObjectMeta

conditions

list of component conditions observed

false

v1.ComponentCondition array

v1.LimitRangeItem

Name Description Required Schema Default

type

type of resource that this limit applies to

false

string

max

max usage constraints on this kind by resource name

false

any

min

min usage constraints on this kind by resource name

false

any

default

default values on this kind by resource name if omitted

false

any

v1.PodTemplateSpec

Name Description Required Schema Default

metadata

standard object metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ObjectMeta

spec

specification of the desired behavior of the pod; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status

false

v1.PodSpec

v1.PodList

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard list metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

v1.ListMeta

items

list of pods; see http://releases.k8s.io/HEAD/docs/pods.md

true

v1.Pod array

v1.ServiceList

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard list metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ListMeta

items

list of services

true

v1.Service array

v1.PersistentVolumeList

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard list metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

v1.ListMeta

items

list of persistent volumes; see http://releases.k8s.io/HEAD/docs/persistent-volumes.md

false

v1.PersistentVolume array

v1.ObjectReference

Name Description Required Schema Default

kind

kind of the referent; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

namespace

namespace of the referent; see http://releases.k8s.io/HEAD/docs/namespaces.md

false

string

name

name of the referent; see http://releases.k8s.io/HEAD/docs/identifiers.md#names

false

string

uid

uid of the referent; see http://releases.k8s.io/HEAD/docs/identifiers.md#uids

false

string

apiVersion

API version of the referent

false

string

resourceVersion

specific resourceVersion to which this reference is made, if any: http://releases.k8s.io/HEAD/docs/api-conventions.md#concurrency-control-and-consistency

false

string

fieldPath

if referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2]

false

string

v1.ContainerStateWaiting

Name Description Required Schema Default

reason

(brief) reason the container is not yet running, such as pulling its image

false

string

v1.NodeSystemInfo

Name Description Required Schema Default

machineID

machine-id reported by the node

true

string

systemUUID

system-uuid reported by the node

true

string

bootID

boot id is the boot-id reported by the node

true

string

kernelVersion

Kernel version reported by the node from uname -r (e.g. 3.16.0-0.bpo.4-amd64)

true

string

osImage

OS image used reported by the node from /etc/os-release (e.g. Debian GNU/Linux 7 (wheezy))

true

string

containerRuntimeVersion

Container runtime version reported by the node through runtime remote API (e.g. docker://1.5.0)

true

string

kubeletVersion

Kubelet version reported by the node

true

string

kubeProxyVersion

Kube-proxy version reported by the node

true

string

v1.ServiceSpec

Name Description Required Schema Default

ports

ports exposed by the service; see http://releases.k8s.io/HEAD/docs/services.md#virtual-ips-and-service-proxies

true

v1.ServicePort array

selector

label keys and values that must match in order to receive traffic for this service; if empty, all pods are selected, if not specified, endpoints must be manually specified; see http://releases.k8s.io/HEAD/docs/services.md#overview

false

any

clusterIP

IP address of the service; usually assigned by the system; if specified, it will be allocated to the service if unused or else creation of the service will fail; cannot be updated; None can be specified for a headless service when proxying is not required; see http://releases.k8s.io/HEAD/docs/services.md#virtual-ips-and-service-proxies

false

string

type

type of this service; must be ClusterIP, NodePort, or LoadBalancer; defaults to ClusterIP; see http://releases.k8s.io/HEAD/docs/services.md#external-services

false

string

deprecatedPublicIPs

deprecated. externally visible IPs (e.g. load balancers) that should be proxied to this service

false

string array

sessionAffinity

enable client IP based session affinity; must be ClientIP or None; defaults to None; see http://releases.k8s.io/HEAD/docs/services.md#virtual-ips-and-service-proxies

false

string

v1.Pod

Name Description Required Schema Default

kind

kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/api-conventions.md#types-kinds

false

string

apiVersion

version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/api-conventions.md#resources

false

string

metadata

standard object metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata

false

v1.ObjectMeta

spec

specification of the desired behavior of the pod; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status

false

v1.PodSpec

status

most recently observed status of the pod; populated by the system, read-only; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status

false

v1.PodStatus

v1.NodeSpec

Name Description Required Schema Default

podCIDR

pod IP range assigned to the node

false

string

externalID

deprecated. External ID assigned to the node by some machine database (e.g. a cloud provider). Defaults to node name when empty.

false

string

providerID

ID of the node assigned by the cloud provider in the format: <ProviderName>://<ProviderSpecificNodeID>

false

string

unschedulable

disable pod scheduling on the node; see http://releases.k8s.io/HEAD/docs/node.md#manual-node-administration

false

boolean

false

v1.EndpointAddress

Name Description Required Schema Default

ip

IP address of the endpoint

true

string

targetRef

reference to object providing the endpoint

false

v1.ObjectReference

any

Represents an untyped JSON map - see the description of the field for more info about the structure of this object.