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 |
++ | + |
spec |
+specification of a node; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status |
+false |
++ | + |
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.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 |
++ | + |
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 |
++ | + |
resources |
+the desired resources the volume should have; see http://releases.k8s.io/HEAD/docs/persistent-volumes.md#resources |
+false |
++ | + |
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 |
++ | + |
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 |
++ | + |
spec |
+specification of a persistent volume as provisioned by an administrator; see http://releases.k8s.io/HEAD/docs/persistent-volumes.md#persistent-volumes |
+false |
++ | + |
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
+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 |
++ | + |
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 |
++ | + |
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 |
++ | + |
used |
+used is the current observed total usage of the resource in the namespace |
+false |
++ | + |
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 |
++ | + |
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 |
++ | + |
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 |
++ | + |
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 |
++ | + |
spec |
+the desired characteristics of a volume; see http://releases.k8s.io/HEAD/docs/persistent-volumes.md#persistentvolumeclaims |
+false |
++ | + |
status |
+the current status of a persistent volume claim; read-only; see http://releases.k8s.io/HEAD/docs/persistent-volumes.md#persistentvolumeclaims |
+false |
++ | + |
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 |
++ | + |
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 |
++ | + |
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 |
++ | + |
spec |
+spec defines the behavior of the Namespace; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status |
+false |
++ | + |
status |
+status describes the current status of a Namespace; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status |
+false |
++ | + |
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 |
++ | + |
capacity |
+the actual resources the volume has |
+false |
++ | + |
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 |
++ | + |
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.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 |
++ | + |
spec |
+specification of the desired behavior of the service; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status |
+false |
++ | + |
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.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 |
++ | + |
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 |
++ | + |
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 |
++ | + |
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 |
++ | + |
emptyDir |
+temporary directory that shares a pod’s lifetime; see http://releases.k8s.io/HEAD/docs/volumes.md#emptydir |
+false |
++ | + |
gcePersistentDisk |
+GCE disk resource attached to the host machine on demand; see http://releases.k8s.io/HEAD/docs/volumes.md#gcepersistentdisk |
+false |
++ | + |
awsElasticBlockStore |
+AWS disk resource attached to the host machine on demand; see http://releases.k8s.io/HEAD/docs/volumes.md#awselasticblockstore |
+false |
++ | + |
gitRepo |
+git repository at a particular revision |
+false |
++ | + |
secret |
+secret to populate volume; see http://releases.k8s.io/HEAD/docs/volumes.md#secrets |
+false |
++ | + |
nfs |
+NFS volume that will be mounted in the host machine; see http://releases.k8s.io/HEAD/docs/volumes.md#nfs |
+false |
++ | + |
iscsi |
+iSCSI disk attached to host machine on demand; see http://releases.k8s.io/HEAD/examples/iscsi/README.md |
+false |
++ | + |
glusterfs |
+Glusterfs volume that will be mounted on the host machine; see http://releases.k8s.io/HEAD/examples/glusterfs/README.md |
+false |
++ | + |
persistentVolumeClaim |
+a reference to a PersistentVolumeClaim in the same namespace; see http://releases.k8s.io/HEAD/docs/persistent-volumes.md#persistentvolumeclaims |
+false |
++ | + |
rbd |
+rados block volume that will be mounted on the host machine; see http://releases.k8s.io/HEAD/examples/rbd/README.md |
+false |
++ | + |
v1.Probe
+Name | +Description | +Required | +Schema | +Default | +
---|---|---|---|---|
exec |
+exec-based handler |
+false |
++ | + |
httpGet |
+HTTP-based handler |
+false |
++ | + |
tcpSocket |
+TCP-based handler; TCP hooks not yet supported |
+false |
++ | + |
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 |
++ | + |
spec |
+specification of the desired behavior of the replication controller; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status |
+false |
++ | + |
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.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 |
++ | + |
spec |
+spec defines the limits enforced; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status |
+false |
++ | + |
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 |
++ | + |
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 |
++ | + |
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 |
++ | + |
spec |
+spec defines the desired quota; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status |
+false |
++ | + |
status |
+status defines the actual enforced quota and current usage; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status |
+false |
++ | + |
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 |
++ | + |
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.NodeStatus
+Name | +Description | +Required | +Schema | +Default | +
---|---|---|---|---|
capacity |
+compute resource capacity of the node; see http://releases.k8s.io/HEAD/docs/compute_resources.md |
+false |
++ | + |
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.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 |
++ | + |
httpGet |
+HTTP-based handler |
+false |
++ | + |
tcpSocket |
+TCP-based handler; TCP hooks not yet supported |
+false |
++ | + |
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 |
++ | + |
template |
+object that describes the pod that will be created if insufficient replicas are detected; takes precendence over templateRef; see http://releases.k8s.io/HEAD/docs/replication-controller.md#pod-template |
+false |
++ | + |
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 |
++ | + |
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 |
++ | + |
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 |
++ | + |
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 |
++ | + |
template |
+the template of the desired behavior of the pod; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status |
+false |
++ | + |
v1.ServiceStatus
+Name | +Description | +Required | +Schema | +Default | +
---|---|---|---|---|
loadBalancer |
+status of load-balancer |
+false |
++ | + |
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 of 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 |
++ | + |
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 |
++ | + |
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 |
++ | + |
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 |
++ | + |
lifecycle |
+actions that the management system should take in response to container lifecycle events; cannot be updated |
+false |
++ | + |
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.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 |
++ | + |
gcePersistentDisk |
+GCE disk resource provisioned by an admin; see http://releases.k8s.io/HEAD/docs/volumes.md#gcepersistentdisk |
+false |
++ | + |
awsElasticBlockStore |
+AWS disk resource provisioned by an admin; see http://releases.k8s.io/HEAD/docs/volumes.md#awselasticblockstore |
+false |
++ | + |
hostPath |
+a HostPath provisioned by a developer or tester; for develment use only; see http://releases.k8s.io/HEAD/docs/volumes.md#hostpath |
+false |
++ | + |
glusterfs |
+Glusterfs volume resource provisioned by an admin; see http://releases.k8s.io/HEAD/examples/glusterfs/README.md |
+false |
++ | + |
nfs |
+NFS volume resource provisioned by an admin; see http://releases.k8s.io/HEAD/docs/volumes.md#nfs |
+false |
++ | + |
rbd |
+rados block volume that will be mounted on the host machine; see http://releases.k8s.io/HEAD/examples/rbd/README.md |
+false |
++ | + |
iscsi |
+an iSCSI disk resource provisioned by an admin |
+false |
++ | + |
accessModes |
+all ways the volume can be mounted; see http://releases.k8s.io/HEAD/docs/persistent-volumes.md#access-modes |
+false |
++ | + |
claimRef |
+when bound, a reference to the bound claim; see http://releases.k8s.io/HEAD/docs/persistent-volumes.md#binding |
+false |
++ | + |
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 |
++ | + |
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 |
++ | + |
target |
+an object to bind to |
+true |
++ | + |
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 |
++ | + |
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 |
++ | + |
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 |
++ | + |
running |
+details about a running container |
+false |
++ | + |
terminated |
+details about a terminated container |
+false |
++ | + |
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 |
++ | + |
lastState |
+details about the container’s last termination condition |
+false |
++ | + |
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 |
++ | + |
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 |
++ | + |
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 |
++ | + |
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 |
++ | + |
involvedObject |
+object this event is about |
+true |
++ | + |
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 |
++ | + |
firstTimestamp |
+the time at which the event was first recorded |
+false |
+string |
++ |
lastTimestamp |
+the time at which the most recent occurance 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.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 |
++ | + |
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 |
++ | + |
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 |
++ | + |
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 |
++ | + |
min |
+min usage constraints on this kind by resource name |
+false |
++ | + |
default |
+default values on this kind by resource name if omitted |
+false |
++ | + |
v1.PodTemplateSpec
+Name | +Description | +Required | +Schema | +Default | +
---|---|---|---|---|
metadata |
+standard object metadata; see http://releases.k8s.io/HEAD/docs/api-conventions.md#metadata |
+false |
++ | + |
spec |
+specification of the desired behavior of the pod; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status |
+false |
++ | + |
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 |
++ | + |
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 |
++ | + |
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 |
++ | + |
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 |
++ | + |
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 |
++ | + |
spec |
+specification of the desired behavior of the pod; http://releases.k8s.io/HEAD/docs/api-conventions.md#spec-and-status |
+false |
++ | + |
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.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 |
++ | + |
any
+Represents an untyped JSON map - see the description of the field for more info about the structure of this object.
+