PersistentVolumeClaim is a user’s request for and claim to a persistent volume
PersistentVolumeClaim is a user’s request for and claim to a persistent volume
object
Property | Type | Description |
---|---|---|
|
|
APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
|
Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata |
|
|
|
PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes |
|
|
PersistentVolumeClaimStatus is the current status of a persistent volume claim. |
PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes
object
Property | Type | Description |
---|---|---|
|
|
accessModes contains the desired access modes the volume should have. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 |
|
|
TypedLocalObjectReference contains enough information to let you locate the typed referenced object inside the same namespace. |
|
|
TypedLocalObjectReference contains enough information to let you locate the typed referenced object inside the same namespace. |
|
|
ResourceRequirements describes the compute resource requirements. |
|
selector is a label query over volumes to consider for binding. |
|
|
|
storageClassName is the name of the StorageClass required by the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1 |
|
|
volumeMode defines what type of volume is required by the claim. Value of Filesystem is implied when not included in claim spec. |
|
|
volumeName is the binding reference to the PersistentVolume backing this claim. |
TypedLocalObjectReference contains enough information to let you locate the typed referenced object inside the same namespace.
object
kind
name
Property | Type | Description |
---|---|---|
|
|
APIGroup is the group for the resource being referenced. If APIGroup is not specified, the specified Kind must be in the core API group. For any other third-party types, APIGroup is required. |
|
|
Kind is the type of resource being referenced |
|
|
Name is the name of resource being referenced |
TypedLocalObjectReference contains enough information to let you locate the typed referenced object inside the same namespace.
object
kind
name
Property | Type | Description |
---|---|---|
|
|
APIGroup is the group for the resource being referenced. If APIGroup is not specified, the specified Kind must be in the core API group. For any other third-party types, APIGroup is required. |
|
|
Kind is the type of resource being referenced |
|
|
Name is the name of resource being referenced |
ResourceRequirements describes the compute resource requirements.
object
Property | Type | Description |
---|---|---|
|
Limits describes the maximum amount of compute resources allowed. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
|
|
Requests 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. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
PersistentVolumeClaimStatus is the current status of a persistent volume claim.
object
Property | Type | Description |
---|---|---|
|
|
accessModes contains the actual access modes the volume backing the PVC has. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 |
|
allocatedResources is the storage resource within AllocatedResources tracks the capacity allocated to a PVC. It may be larger than the actual capacity when a volume expansion operation is requested. For storage quota, the larger value from allocatedResources and PVC.spec.resources is used. If allocatedResources is not set, PVC.spec.resources alone is used for quota calculation. If a volume expansion capacity request is lowered, allocatedResources is only lowered if there are no expansion operations in progress and if the actual volume capacity is equal or lower than the requested capacity. This is an alpha field and requires enabling RecoverVolumeExpansionFailure feature. |
|
|
capacity represents the actual resources of the underlying volume. |
|
|
|
conditions is the current Condition of persistent volume claim. If underlying persistent volume is being resized then the Condition will be set to 'ResizeStarted'. |
|
|
PersistentVolumeClaimCondition contails details about state of pvc |
|
|
phase represents the current phase of PersistentVolumeClaim. Possible enum values:
- |
|
|
resizeStatus stores status of resize operation. ResizeStatus is not set by default but when expansion is complete resizeStatus is set to empty string by resize controller or kubelet. This is an alpha field and requires enabling RecoverVolumeExpansionFailure feature. |
conditions is the current Condition of persistent volume claim. If underlying persistent volume is being resized then the Condition will be set to 'ResizeStarted'.
array
PersistentVolumeClaimCondition contails details about state of pvc
object
type
status
Property | Type | Description |
---|---|---|
|
lastProbeTime is the time we probed the condition. |
|
|
lastTransitionTime is the time the condition transitioned from one status to another. |
|
|
|
message is the human-readable message indicating details about last transition. |
|
|
reason is a unique, this should be a short, machine understandable string that gives the reason for condition’s last transition. If it reports "ResizeStarted" that means the underlying persistent volume is being resized. |
|
|
|
|
|
The following API endpoints are available:
/api/v1/persistentvolumeclaims
GET
: list or watch objects of kind PersistentVolumeClaim
/api/v1/watch/persistentvolumeclaims
GET
: watch individual changes to a list of PersistentVolumeClaim. deprecated: use the 'watch' parameter with a list operation instead.
/api/v1/namespaces/{namespace}/persistentvolumeclaims