ContainerStatus

io.k8s.api.core.v1.ContainerStatus source ↗

ContainerStatus contains details for the current status of this container.

allocatedResourcesmap[string]QuantityAllocatedResources represents the compute resources allocated for this container by the node. Kubelet sets this value to Container.Resources.Requests upon successful pod admission and after successfully admitting desired pod resize.
allocatedResourcesStatus[]ResourceStatusAllocatedResourcesStatus represents the status of various resources allocated for this Pod.
namestring requiredName of the resource. Must be unique within the pod and in case of non-DRA resource, match one of the resources from the pod spec. For DRA resources, the value must be "claim:<claim_name>/<request>". When this status is reported about a container, the "claim_name" and "request" must match one of the claims of this container.
resources[]ResourceHealthList of unique resources health. Each element in the list contains an unique resource ID and its health. At a minimum, for the lifetime of a Pod, resource ID must uniquely identify the resource allocated to the Pod on the Node. If other Pod on the same Node reports the status with the same resource ID, it must be the same resource they share. See ResourceID type definition for a specific format it has in various use cases.
healthstringHealth of the resource. can be one of:
  • Healthy: operates as normal
  • Unhealthy: reported unhealthy. We consider this a temporary health issue
since we do not have a mechanism today to distinguish temporary and permanent issues.
  • Unknown: The status cannot be determined.
For example, Device Plugin got unregistered and hasn't been re-registered since.In future we may want to introduce the PermanentlyUnhealthy Status.
resourceIDstring requiredResourceID is the unique identifier of the resource. See the ResourceID type for more information.
containerIDstringContainerID is the ID of the container in the format '<type>://<container_id>'. Where type is a container runtime identifier, returned from Version call of CRI API (for example "containerd").
imagestring requiredImage is the name of container image that the container is running. The container image may not match the image used in the PodSpec, as it may have been resolved by the runtime.More info: https://kubernetes.io/docs/concepts/containers/images.
imageIDstring requiredImageID is the image ID of the container's image. The image ID may not match the image ID of the image used in the PodSpec, as it may have been resolved by the runtime.
lastStateContainerStateLastTerminationState holds the last termination state of the container to help debug container crashes and restarts. This field is not populated if the container is still running and RestartCount is 0.
runningContainerStateRunningDetails about a running container
startedAtTimeTime at which the container was last (re-)started
terminatedContainerStateTerminatedDetails about a terminated container
containerIDstringContainer's ID in the format '<type>://<container_id>'
exitCodeinteger (int32) requiredExit status from the last termination of the container
finishedAtTimeTime at which the container last terminated
messagestringMessage regarding the last termination of the container
reasonstring(brief) reason from the last termination of the container
signalinteger (int32)Signal from the last termination of the container
startedAtTimeTime at which previous execution of the container started
waitingContainerStateWaitingDetails about a waiting container
messagestringMessage regarding why the container is not yet running.
reasonstring(brief) reason the container is not yet running.
namestring requiredName is a DNS_LABEL representing the unique name of the container. Each container in a pod must have a unique name across all container types.Cannot be updated.
readyboolean requiredReady specifies whether the container is currently passing its readiness check. The value will change as readiness probes keep executing. If no readiness probes are specified, this field defaults to true once the container is fully started (see Started field).The value is typically used to determine whether a container is ready to accept traffic.
resourcesResourceRequirementsResources represents the compute resource requests and limits that have been successfully enacted on the running container after it has been started or has been successfully resized.
claims[]ResourceClaimClaims lists the names of resources, defined in spec.resourceClaims, that are used by this container.This field depends on the DynamicResourceAllocation feature gate.This field is immutable. It can only be set for containers.
namestring requiredName must match the name of one entry in pod.spec.resourceClaims of the Pod where this field is used. It makes that resource available inside a container.
requeststringRequest is the name chosen for a request in the referenced claim. If empty, everything from the claim is made available, otherwise only the result of this request.
limitsmap[string]QuantityLimits describes the maximum amount of compute resources allowed.More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
requestsmap[string]QuantityRequests describes the minimum amount of compute resources required. If Requests is omitted for a container, it defaults to Limits if that is explicitly specified, otherwise to an implementation-defined value. Requests cannot exceed Limits.More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
restartCountinteger (int32) requiredRestartCount holds the number of times the container has been restarted. Kubelet makes an effort to always increment the value, but there are cases when the state may be lost due to node restarts and then the value may be reset to 0. The value is never negative.
startedbooleanStarted indicates whether the container has finished its postStart lifecycle hook and passed its startup probe. Initialized as false, becomes true after startupProbe is considered successful. Resets to false when the container is restarted, or if kubelet loses state temporarily. In both cases, startup probes will run again. Is always true when no startupProbe is defined and container is running and has passed the postStart lifecycle hook. The null value must be treated the same as false.
stateContainerStateState holds details about the container's current condition.
runningContainerStateRunningDetails about a running container
startedAtTimeTime at which the container was last (re-)started
terminatedContainerStateTerminatedDetails about a terminated container
containerIDstringContainer's ID in the format '<type>://<container_id>'
exitCodeinteger (int32) requiredExit status from the last termination of the container
finishedAtTimeTime at which the container last terminated
messagestringMessage regarding the last termination of the container
reasonstring(brief) reason from the last termination of the container
signalinteger (int32)Signal from the last termination of the container
startedAtTimeTime at which previous execution of the container started
waitingContainerStateWaitingDetails about a waiting container
messagestringMessage regarding why the container is not yet running.
reasonstring(brief) reason the container is not yet running.
stopSignalstringStopSignal reports the effective stop signal for this container
userContainerUserUser represents user identity information initially attached to the first process of the container
linuxLinuxContainerUserLinux holds user identity information initially attached to the first process of the containers in Linux. Note that the actual running identity can be changed if the process has enough privilege to do so.
gidinteger (int64) requiredGID is the primary gid initially attached to the first process in the container
supplementalGroups[]integer (int64)SupplementalGroups are the supplemental groups initially attached to the first process in the container
uidinteger (int64) requiredUID is the primary uid initially attached to the first process in the container
volumeMounts[]VolumeMountStatusStatus of volume mounts.
mountPathstring requiredMountPath corresponds to the original VolumeMount.
namestring requiredName corresponds to the name of the original VolumeMount.
readOnlybooleanReadOnly corresponds to the original VolumeMount.
recursiveReadOnlystringRecursiveReadOnly must be set to Disabled, Enabled, or unspecified (for non-readonly mounts). An IfPossible value in the original VolumeMount must be translated to Disabled or Enabled, depending on the mount result.