github/kubernetes
1
0
Fork 0
mirror of https://github.com/k3s-io/kubernetes.git synced 2025-07-28 05:57:25 +00:00
Code Issues Projects Releases Wiki Activity

correct struct fields in various core storage structs

Browse Source 
The field names in godoc for various core storage structs have been
corrected with this commit.

Additional Ref# #105963 (comment)

Signed-off-by: Humble Chirammal <hchiramm@redhat.com>
This commit is contained in:
Humble Chirammal 2022-01-11 12:06:29 +05:30
parent a0dfd958d5
commit 1cb0dd028f
9 changed files with 239 additions and 239 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

74
api/openapi-spec/swagger.json generated
View File

@ -7772,11 +7772,11 @@
}, },
"spec": { "spec": {
"$ref": "#/definitions/io.k8s.api.core.v1.PersistentVolumeSpec", "$ref": "#/definitions/io.k8s.api.core.v1.PersistentVolumeSpec",
"description": "Spec defines a specification of a persistent volume owned by the cluster. Provisioned by an administrator. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes" "description": "spec defines a specification of a persistent volume owned by the cluster. Provisioned by an administrator. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes"
}, },
"status": { "status": {
"$ref": "#/definitions/io.k8s.api.core.v1.PersistentVolumeStatus", "$ref": "#/definitions/io.k8s.api.core.v1.PersistentVolumeStatus",
"description": "Status represents the current information/status for the persistent volume. Populated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes" "description": "status represents the current information/status for the persistent volume. Populated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes"
} }
}, },
"type": "object", "type": "object",
@ -7805,11 +7805,11 @@
}, },
"spec": { "spec": {
"$ref": "#/definitions/io.k8s.api.core.v1.PersistentVolumeClaimSpec", "$ref": "#/definitions/io.k8s.api.core.v1.PersistentVolumeClaimSpec",
"description": "Spec defines the desired characteristics of a volume requested by a pod author. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims" "description": "spec defines the desired characteristics of a volume requested by a pod author. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims"
}, },
"status": { "status": {
"$ref": "#/definitions/io.k8s.api.core.v1.PersistentVolumeClaimStatus", "$ref": "#/definitions/io.k8s.api.core.v1.PersistentVolumeClaimStatus",
"description": "Status represents the current information/status of a persistent volume claim. Read-only. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims" "description": "status represents the current information/status of a persistent volume claim. Read-only. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims"
} }
}, },
"type": "object", "type": "object",
@ -7826,18 +7826,18 @@
"properties": { "properties": {
"lastProbeTime": { "lastProbeTime": {
"$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.Time", "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.Time",
"description": "Last time we probed the condition." "description": "lastProbeTime is the time we probed the condition."
}, },
"lastTransitionTime": { "lastTransitionTime": {
"$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.Time", "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.Time",
"description": "Last time the condition transitioned from one status to another." "description": "lastTransitionTime is the time the condition transitioned from one status to another."
}, },
"message": { "message": {
"description": "Human-readable message indicating details about last transition.", "description": "message is the human-readable message indicating details about last transition.",
"type": "string" "type": "string"
}, },
"reason": { "reason": {
"description": "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.", "description": "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.",
"type": "string" "type": "string"
}, },
"status": { "status": {
@ -7866,7 +7866,7 @@
"type": "string" "type": "string"
}, },
"items": { "items": {
"description": "A list of persistent volume claims. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims", "description": "items is a list of persistent volume claims. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims",
"items": { "items": {
"$ref": "#/definitions/io.k8s.api.core.v1.PersistentVolumeClaim" "$ref": "#/definitions/io.k8s.api.core.v1.PersistentVolumeClaim"
}, },
@ -7897,7 +7897,7 @@
"description": "PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes", "description": "PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes",
"properties": { "properties": {
"accessModes": { "accessModes": {
"description": "AccessModes contains the desired access modes the volume should have. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1", "description": "accessModes contains the desired access modes the volume should have. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1",
"items": { "items": {
"type": "string" "type": "string"
}, },
@ -7905,22 +7905,22 @@
}, },
"dataSource": { "dataSource": {
"$ref": "#/definitions/io.k8s.api.core.v1.TypedLocalObjectReference", "$ref": "#/definitions/io.k8s.api.core.v1.TypedLocalObjectReference",
"description": "This field can be used to specify either: * An existing VolumeSnapshot object (snapshot.storage.k8s.io/VolumeSnapshot) * An existing PVC (PersistentVolumeClaim) If the provisioner or an external controller can support the specified data source, it will create a new volume based on the contents of the specified data source. If the AnyVolumeDataSource feature gate is enabled, this field will always have the same contents as the DataSourceRef field." "description": "dataSource field can be used to specify either: * An existing VolumeSnapshot object (snapshot.storage.k8s.io/VolumeSnapshot) * An existing PVC (PersistentVolumeClaim) If the provisioner or an external controller can support the specified data source, it will create a new volume based on the contents of the specified data source. If the AnyVolumeDataSource feature gate is enabled, this field will always have the same contents as the DataSourceRef field."
}, },
"dataSourceRef": { "dataSourceRef": {
"$ref": "#/definitions/io.k8s.api.core.v1.TypedLocalObjectReference", "$ref": "#/definitions/io.k8s.api.core.v1.TypedLocalObjectReference",
"description": "Specifies the object from which to populate the volume with data, if a non-empty volume is desired. This may be any local object from a non-empty API group (non core object) or a PersistentVolumeClaim object. When this field is specified, volume binding will only succeed if the type of the specified object matches some installed volume populator or dynamic provisioner. This field will replace the functionality of the DataSource field and as such if both fields are non-empty, they must have the same value. For backwards compatibility, both fields (DataSource and DataSourceRef) will be set to the same value automatically if one of them is empty and the other is non-empty. There are two important differences between DataSource and DataSourceRef: * While DataSource only allows two specific types of objects, DataSourceRef\n allows any non-core object, as well as PersistentVolumeClaim objects.\n* While DataSource ignores disallowed values (dropping them), DataSourceRef\n preserves all values, and generates an error if a disallowed value is\n specified.\n(Alpha) Using this field requires the AnyVolumeDataSource feature gate to be enabled." "description": "dataSourceRef specifies the object from which to populate the volume with data, if a non-empty volume is desired. This may be any local object from a non-empty API group (non core object) or a PersistentVolumeClaim object. When this field is specified, volume binding will only succeed if the type of the specified object matches some installed volume populator or dynamic provisioner. This field will replace the functionality of the DataSource field and as such if both fields are non-empty, they must have the same value. For backwards compatibility, both fields (DataSource and DataSourceRef) will be set to the same value automatically if one of them is empty and the other is non-empty. There are two important differences between DataSource and DataSourceRef: * While DataSource only allows two specific types of objects, DataSourceRef\n allows any non-core object, as well as PersistentVolumeClaim objects.\n* While DataSource ignores disallowed values (dropping them), DataSourceRef\n preserves all values, and generates an error if a disallowed value is\n specified.\n(Alpha) Using this field requires the AnyVolumeDataSource feature gate to be enabled."
}, },
"resources": { "resources": {
"$ref": "#/definitions/io.k8s.api.core.v1.ResourceRequirements", "$ref": "#/definitions/io.k8s.api.core.v1.ResourceRequirements",
"description": "Resources represents the minimum resources the volume should have. If RecoverVolumeExpansionFailure feature is enabled users are allowed to specify resource requirements that are lower than previous value but must still be higher than capacity recorded in the status field of the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources" "description": "resources represents the minimum resources the volume should have. If RecoverVolumeExpansionFailure feature is enabled users are allowed to specify resource requirements that are lower than previous value but must still be higher than capacity recorded in the status field of the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources"
}, },
"selector": { "selector": {
"$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.LabelSelector", "$ref": "#/definitions/io.k8s.apimachinery.pkg.apis.meta.v1.LabelSelector",
"description": "A label query over volumes to consider for binding." "description": "selector is a label query over volumes to consider for binding."
}, },
"storageClassName": { "storageClassName": {
"description": "Name of the StorageClass required by the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1", "description": "storageClassName is the name of the StorageClass required by the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1",
"type": "string" "type": "string"
}, },
"volumeMode": { "volumeMode": {
@ -7928,7 +7928,7 @@
"type": "string" "type": "string"
}, },
"volumeName": { "volumeName": {
"description": "VolumeName is the binding reference to the PersistentVolume backing this claim.", "description": "volumeName is the binding reference to the PersistentVolume backing this claim.",
"type": "string" "type": "string"
} }
}, },
@ -7938,7 +7938,7 @@
"description": "PersistentVolumeClaimStatus is the current status of a persistent volume claim.", "description": "PersistentVolumeClaimStatus is the current status of a persistent volume claim.",
"properties": { "properties": {
"accessModes": { "accessModes": {
"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", "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",
"items": { "items": {
"type": "string" "type": "string"
}, },
@ -7948,18 +7948,18 @@
"additionalProperties": { "additionalProperties": {
"$ref": "#/definitions/io.k8s.apimachinery.pkg.api.resource.Quantity" "$ref": "#/definitions/io.k8s.apimachinery.pkg.api.resource.Quantity"
}, },
"description": "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.", "description": "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.",
"type": "object" "type": "object"
}, },
"capacity": { "capacity": {
"additionalProperties": { "additionalProperties": {
"$ref": "#/definitions/io.k8s.apimachinery.pkg.api.resource.Quantity" "$ref": "#/definitions/io.k8s.apimachinery.pkg.api.resource.Quantity"
}, },
"description": "Represents the actual resources of the underlying volume.", "description": "capacity represents the actual resources of the underlying volume.",
"type": "object" "type": "object"
}, },
"conditions": { "conditions": {
"description": "Current Condition of persistent volume claim. If underlying persistent volume is being resized then the Condition will be set to 'ResizeStarted'.", "description": "conditions is the current Condition of persistent volume claim. If underlying persistent volume is being resized then the Condition will be set to 'ResizeStarted'.",
"items": { "items": {
"$ref": "#/definitions/io.k8s.api.core.v1.PersistentVolumeClaimCondition" "$ref": "#/definitions/io.k8s.api.core.v1.PersistentVolumeClaimCondition"
}, },
@ -7968,7 +7968,7 @@
"x-kubernetes-patch-strategy": "merge" "x-kubernetes-patch-strategy": "merge"
}, },
"phase": { "phase": {
"description": "Phase represents the current phase of PersistentVolumeClaim.\n\nPossible enum values:\n - `\"Bound\"` used for PersistentVolumeClaims that are bound\n - `\"Lost\"` used for PersistentVolumeClaims that lost their underlying PersistentVolume. The claim was bound to a PersistentVolume and this volume does not exist any longer and all data on it was lost.\n - `\"Pending\"` used for PersistentVolumeClaims that are not yet bound", "description": "phase represents the current phase of PersistentVolumeClaim.\n\nPossible enum values:\n - `\"Bound\"` used for PersistentVolumeClaims that are bound\n - `\"Lost\"` used for PersistentVolumeClaims that lost their underlying PersistentVolume. The claim was bound to a PersistentVolume and this volume does not exist any longer and all data on it was lost.\n - `\"Pending\"` used for PersistentVolumeClaims that are not yet bound",
"enum": [ "enum": [
"Bound", "Bound",
"Lost", "Lost",
@ -7977,7 +7977,7 @@
"type": "string" "type": "string"
}, },
"resizeStatus": { "resizeStatus": {
"description": "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.", "description": "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.",
"type": "string" "type": "string"
} }
}, },
@ -8004,11 +8004,11 @@
"description": "PersistentVolumeClaimVolumeSource references the user's PVC in the same namespace. This volume finds the bound PV and mounts that volume for the pod. A PersistentVolumeClaimVolumeSource is, essentially, a wrapper around another type of volume that is owned by someone else (the system).", "description": "PersistentVolumeClaimVolumeSource references the user's PVC in the same namespace. This volume finds the bound PV and mounts that volume for the pod. A PersistentVolumeClaimVolumeSource is, essentially, a wrapper around another type of volume that is owned by someone else (the system).",
"properties": { "properties": {
"claimName": { "claimName": {
"description": "ClaimName is the name of a PersistentVolumeClaim in the same namespace as the pod using this volume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims", "description": "claimName is the name of a PersistentVolumeClaim in the same namespace as the pod using this volume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims",
"type": "string" "type": "string"
}, },
"readOnly": { "readOnly": {
"description": "Will force the ReadOnly setting in VolumeMounts. Default false.", "description": "readOnly Will force the ReadOnly setting in VolumeMounts. Default false.",
"type": "boolean" "type": "boolean"
} }
}, },
@ -8025,7 +8025,7 @@
"type": "string" "type": "string"
}, },
"items": { "items": {
"description": "List of persistent volumes. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes", "description": "items is a list of persistent volumes. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes",
"items": { "items": {
"$ref": "#/definitions/io.k8s.api.core.v1.PersistentVolume" "$ref": "#/definitions/io.k8s.api.core.v1.PersistentVolume"
}, },
@ -8056,7 +8056,7 @@
"description": "PersistentVolumeSpec is the specification of a persistent volume.", "description": "PersistentVolumeSpec is the specification of a persistent volume.",
"properties": { "properties": {
"accessModes": { "accessModes": {
"description": "AccessModes contains all ways the volume can be mounted. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes", "description": "accessModes contains all ways the volume can be mounted. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes",
"items": { "items": {
"type": "string" "type": "string"
}, },
@ -8078,7 +8078,7 @@
"additionalProperties": { "additionalProperties": {
"$ref": "#/definitions/io.k8s.apimachinery.pkg.api.resource.Quantity" "$ref": "#/definitions/io.k8s.apimachinery.pkg.api.resource.Quantity"
}, },
"description": "A description of the persistent volume's resources and capacity. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity", "description": "capacity is the description of the persistent volume's resources and capacity. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity",
"type": "object" "type": "object"
}, },
"cephfs": { "cephfs": {
@ -8091,7 +8091,7 @@
}, },
"claimRef": { "claimRef": {
"$ref": "#/definitions/io.k8s.api.core.v1.ObjectReference", "$ref": "#/definitions/io.k8s.api.core.v1.ObjectReference",
"description": "ClaimRef is part of a bi-directional binding between PersistentVolume and PersistentVolumeClaim. Expected to be non-nil when bound. claim.VolumeName is the authoritative bind between PV and PVC. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#binding" "description": "claimRef is part of a bi-directional binding between PersistentVolume and PersistentVolumeClaim. Expected to be non-nil when bound. claim.VolumeName is the authoritative bind between PV and PVC. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#binding"
}, },
"csi": { "csi": {
"$ref": "#/definitions/io.k8s.api.core.v1.CSIPersistentVolumeSource", "$ref": "#/definitions/io.k8s.api.core.v1.CSIPersistentVolumeSource",
@ -8130,7 +8130,7 @@
"description": "local represents directly-attached storage with node affinity" "description": "local represents directly-attached storage with node affinity"
}, },
"mountOptions": { "mountOptions": {
"description": "A list of mount options, e.g. [\"ro\", \"soft\"]. Not validated - mount will simply fail if one is invalid. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options", "description": "mountOptions is the list of mount options, e.g. [\"ro\", \"soft\"]. Not validated - mount will simply fail if one is invalid. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options",
"items": { "items": {
"type": "string" "type": "string"
}, },
@ -8142,10 +8142,10 @@
}, },
"nodeAffinity": { "nodeAffinity": {
"$ref": "#/definitions/io.k8s.api.core.v1.VolumeNodeAffinity", "$ref": "#/definitions/io.k8s.api.core.v1.VolumeNodeAffinity",
"description": "NodeAffinity defines constraints that limit what nodes this volume can be accessed from. This field influences the scheduling of pods that use this volume." "description": "nodeAffinity defines constraints that limit what nodes this volume can be accessed from. This field influences the scheduling of pods that use this volume."
}, },
"persistentVolumeReclaimPolicy": { "persistentVolumeReclaimPolicy": {
"description": "What happens to a persistent volume when released from its claim. Valid options are Retain (default for manually created PersistentVolumes), Delete (default for dynamically provisioned PersistentVolumes), and Recycle (deprecated). Recycle must be supported by the volume plugin underlying this PersistentVolume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#reclaiming\n\nPossible enum values:\n - `\"Delete\"` means the volume will be deleted from Kubernetes on release from its claim. The volume plugin must support Deletion.\n - `\"Recycle\"` means the volume will be recycled back into the pool of unbound persistent volumes on release from its claim. The volume plugin must support Recycling.\n - `\"Retain\"` means the volume will be left in its current phase (Released) for manual reclamation by the administrator. The default policy is Retain.", "description": "persistentVolumeReclaimPolicy defines what happens to a persistent volume when released from its claim. Valid options are Retain (default for manually created PersistentVolumes), Delete (default for dynamically provisioned PersistentVolumes), and Recycle (deprecated). Recycle must be supported by the volume plugin underlying this PersistentVolume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#reclaiming\n\nPossible enum values:\n - `\"Delete\"` means the volume will be deleted from Kubernetes on release from its claim. The volume plugin must support Deletion.\n - `\"Recycle\"` means the volume will be recycled back into the pool of unbound persistent volumes on release from its claim. The volume plugin must support Recycling.\n - `\"Retain\"` means the volume will be left in its current phase (Released) for manual reclamation by the administrator. The default policy is Retain.",
"enum": [ "enum": [
"Delete", "Delete",
"Recycle", "Recycle",
@ -8174,7 +8174,7 @@
"description": "scaleIO represents a ScaleIO persistent volume attached and mounted on Kubernetes nodes." "description": "scaleIO represents a ScaleIO persistent volume attached and mounted on Kubernetes nodes."
}, },
"storageClassName": { "storageClassName": {
"description": "Name of StorageClass to which this persistent volume belongs. Empty value means that this volume does not belong to any StorageClass.", "description": "storageClassName is the name of StorageClass to which this persistent volume belongs. Empty value means that this volume does not belong to any StorageClass.",
"type": "string" "type": "string"
}, },
"storageos": { "storageos": {
@ -8196,11 +8196,11 @@
"description": "PersistentVolumeStatus is the current status of a persistent volume.", "description": "PersistentVolumeStatus is the current status of a persistent volume.",
"properties": { "properties": {
"message": { "message": {
"description": "A human-readable message indicating details about why the volume is in this state.", "description": "message is a human-readable message indicating details about why the volume is in this state.",
"type": "string" "type": "string"
}, },
"phase": { "phase": {
"description": "Phase indicates if a volume is available, bound to a claim, or released by a claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#phase\n\nPossible enum values:\n - `\"Available\"` used for PersistentVolumes that are not yet bound Available volumes are held by the binder and matched to PersistentVolumeClaims\n - `\"Bound\"` used for PersistentVolumes that are bound\n - `\"Failed\"` used for PersistentVolumes that failed to be correctly recycled or deleted after being released from a claim\n - `\"Pending\"` used for PersistentVolumes that are not available\n - `\"Released\"` used for PersistentVolumes where the bound PersistentVolumeClaim was deleted released volumes must be recycled before becoming available again this phase is used by the persistent volume claim binder to signal to another process to reclaim the resource", "description": "phase indicates if a volume is available, bound to a claim, or released by a claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#phase\n\nPossible enum values:\n - `\"Available\"` used for PersistentVolumes that are not yet bound Available volumes are held by the binder and matched to PersistentVolumeClaims\n - `\"Bound\"` used for PersistentVolumes that are bound\n - `\"Failed\"` used for PersistentVolumes that failed to be correctly recycled or deleted after being released from a claim\n - `\"Pending\"` used for PersistentVolumes that are not available\n - `\"Released\"` used for PersistentVolumes where the bound PersistentVolumeClaim was deleted released volumes must be recycled before becoming available again this phase is used by the persistent volume claim binder to signal to another process to reclaim the resource",
"enum": [ "enum": [
"Available", "Available",
"Bound", "Bound",
@ -8211,7 +8211,7 @@
"type": "string" "type": "string"
}, },
"reason": { "reason": {
"description": "Reason is a brief CamelCase string that describes any failure and is meant for machine parsing and tidy display in the CLI.", "description": "reason is a brief CamelCase string that describes any failure and is meant for machine parsing and tidy display in the CLI.",
"type": "string" "type": "string"
} }
}, },
@ -10647,7 +10647,7 @@
"description": "iscsi represents an ISCSI Disk resource that is attached to a kubelet's host machine and then exposed to the pod. More info: https://examples.k8s.io/volumes/iscsi/README.md" "description": "iscsi represents an ISCSI Disk resource that is attached to a kubelet's host machine and then exposed to the pod. More info: https://examples.k8s.io/volumes/iscsi/README.md"
}, },
"name": { "name": {
"description": "Volume's name. Must be a DNS_LABEL and unique within the pod. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names", "description": "name of the volume. Must be a DNS_LABEL and unique within the pod. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names",
"type": "string" "type": "string"
}, },
"nfs": { "nfs": {
@ -10757,7 +10757,7 @@
"properties": { "properties": {
"required": { "required": {
"$ref": "#/definitions/io.k8s.api.core.v1.NodeSelector", "$ref": "#/definitions/io.k8s.api.core.v1.NodeSelector",
"description": "Required specifies hard node constraints that must be met." "description": "required specifies hard node constraints that must be met."
} }
}, },
"type": "object" "type": "object"

74
api/openapi-spec/v3/api__v1_openapi.json
View File

@ -3360,12 +3360,12 @@
"spec": { "spec": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.PersistentVolumeSpec", "$ref": "#/components/schemas/io.k8s.api.core.v1.PersistentVolumeSpec",
"default": {}, "default": {},
"description": "Spec defines a specification of a persistent volume owned by the cluster. Provisioned by an administrator. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes" "description": "spec defines a specification of a persistent volume owned by the cluster. Provisioned by an administrator. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes"
}, },
"status": { "status": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.PersistentVolumeStatus", "$ref": "#/components/schemas/io.k8s.api.core.v1.PersistentVolumeStatus",
"default": {}, "default": {},
"description": "Status represents the current information/status for the persistent volume. Populated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes" "description": "status represents the current information/status for the persistent volume. Populated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes"
} }
}, },
"type": "object", "type": "object",
@ -3396,12 +3396,12 @@
"spec": { "spec": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.PersistentVolumeClaimSpec", "$ref": "#/components/schemas/io.k8s.api.core.v1.PersistentVolumeClaimSpec",
"default": {}, "default": {},
"description": "Spec defines the desired characteristics of a volume requested by a pod author. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims" "description": "spec defines the desired characteristics of a volume requested by a pod author. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims"
}, },
"status": { "status": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.PersistentVolumeClaimStatus", "$ref": "#/components/schemas/io.k8s.api.core.v1.PersistentVolumeClaimStatus",
"default": {}, "default": {},
"description": "Status represents the current information/status of a persistent volume claim. Read-only. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims" "description": "status represents the current information/status of a persistent volume claim. Read-only. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims"
} }
}, },
"type": "object", "type": "object",
@ -3419,19 +3419,19 @@
"lastProbeTime": { "lastProbeTime": {
"$ref": "#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.Time", "$ref": "#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.Time",
"default": {}, "default": {},
"description": "Last time we probed the condition." "description": "lastProbeTime is the time we probed the condition."
}, },
"lastTransitionTime": { "lastTransitionTime": {
"$ref": "#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.Time", "$ref": "#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.Time",
"default": {}, "default": {},
"description": "Last time the condition transitioned from one status to another." "description": "lastTransitionTime is the time the condition transitioned from one status to another."
}, },
"message": { "message": {
"description": "Human-readable message indicating details about last transition.", "description": "message is the human-readable message indicating details about last transition.",
"type": "string" "type": "string"
}, },
"reason": { "reason": {
"description": "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.", "description": "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.",
"type": "string" "type": "string"
}, },
"status": { "status": {
@ -3462,7 +3462,7 @@
"type": "string" "type": "string"
}, },
"items": { "items": {
"description": "A list of persistent volume claims. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims", "description": "items is a list of persistent volume claims. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims",
"items": { "items": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.PersistentVolumeClaim", "$ref": "#/components/schemas/io.k8s.api.core.v1.PersistentVolumeClaim",
"default": {} "default": {}
@ -3495,7 +3495,7 @@
"description": "PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes", "description": "PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes",
"properties": { "properties": {
"accessModes": { "accessModes": {
"description": "AccessModes contains the desired access modes the volume should have. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1", "description": "accessModes contains the desired access modes the volume should have. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1",
"items": { "items": {
"default": "", "default": "",
"type": "string" "type": "string"
@ -3504,23 +3504,23 @@
}, },
"dataSource": { "dataSource": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.TypedLocalObjectReference", "$ref": "#/components/schemas/io.k8s.api.core.v1.TypedLocalObjectReference",
"description": "This field can be used to specify either: * An existing VolumeSnapshot object (snapshot.storage.k8s.io/VolumeSnapshot) * An existing PVC (PersistentVolumeClaim) If the provisioner or an external controller can support the specified data source, it will create a new volume based on the contents of the specified data source. If the AnyVolumeDataSource feature gate is enabled, this field will always have the same contents as the DataSourceRef field." "description": "dataSource field can be used to specify either: * An existing VolumeSnapshot object (snapshot.storage.k8s.io/VolumeSnapshot) * An existing PVC (PersistentVolumeClaim) If the provisioner or an external controller can support the specified data source, it will create a new volume based on the contents of the specified data source. If the AnyVolumeDataSource feature gate is enabled, this field will always have the same contents as the DataSourceRef field."
}, },
"dataSourceRef": { "dataSourceRef": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.TypedLocalObjectReference", "$ref": "#/components/schemas/io.k8s.api.core.v1.TypedLocalObjectReference",
"description": "Specifies the object from which to populate the volume with data, if a non-empty volume is desired. This may be any local object from a non-empty API group (non core object) or a PersistentVolumeClaim object. When this field is specified, volume binding will only succeed if the type of the specified object matches some installed volume populator or dynamic provisioner. This field will replace the functionality of the DataSource field and as such if both fields are non-empty, they must have the same value. For backwards compatibility, both fields (DataSource and DataSourceRef) will be set to the same value automatically if one of them is empty and the other is non-empty. There are two important differences between DataSource and DataSourceRef: * While DataSource only allows two specific types of objects, DataSourceRef\n allows any non-core object, as well as PersistentVolumeClaim objects.\n* While DataSource ignores disallowed values (dropping them), DataSourceRef\n preserves all values, and generates an error if a disallowed value is\n specified.\n(Alpha) Using this field requires the AnyVolumeDataSource feature gate to be enabled." "description": "dataSourceRef specifies the object from which to populate the volume with data, if a non-empty volume is desired. This may be any local object from a non-empty API group (non core object) or a PersistentVolumeClaim object. When this field is specified, volume binding will only succeed if the type of the specified object matches some installed volume populator or dynamic provisioner. This field will replace the functionality of the DataSource field and as such if both fields are non-empty, they must have the same value. For backwards compatibility, both fields (DataSource and DataSourceRef) will be set to the same value automatically if one of them is empty and the other is non-empty. There are two important differences between DataSource and DataSourceRef: * While DataSource only allows two specific types of objects, DataSourceRef\n allows any non-core object, as well as PersistentVolumeClaim objects.\n* While DataSource ignores disallowed values (dropping them), DataSourceRef\n preserves all values, and generates an error if a disallowed value is\n specified.\n(Alpha) Using this field requires the AnyVolumeDataSource feature gate to be enabled."
}, },
"resources": { "resources": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.ResourceRequirements", "$ref": "#/components/schemas/io.k8s.api.core.v1.ResourceRequirements",
"default": {}, "default": {},
"description": "Resources represents the minimum resources the volume should have. If RecoverVolumeExpansionFailure feature is enabled users are allowed to specify resource requirements that are lower than previous value but must still be higher than capacity recorded in the status field of the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources" "description": "resources represents the minimum resources the volume should have. If RecoverVolumeExpansionFailure feature is enabled users are allowed to specify resource requirements that are lower than previous value but must still be higher than capacity recorded in the status field of the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources"
}, },
"selector": { "selector": {
"$ref": "#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.LabelSelector", "$ref": "#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.LabelSelector",
"description": "A label query over volumes to consider for binding." "description": "selector is a label query over volumes to consider for binding."
}, },
"storageClassName": { "storageClassName": {
"description": "Name of the StorageClass required by the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1", "description": "storageClassName is the name of the StorageClass required by the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1",
"type": "string" "type": "string"
}, },
"volumeMode": { "volumeMode": {
@ -3528,7 +3528,7 @@
"type": "string" "type": "string"
}, },
"volumeName": { "volumeName": {
"description": "VolumeName is the binding reference to the PersistentVolume backing this claim.", "description": "volumeName is the binding reference to the PersistentVolume backing this claim.",
"type": "string" "type": "string"
} }
}, },
@ -3538,7 +3538,7 @@
"description": "PersistentVolumeClaimStatus is the current status of a persistent volume claim.", "description": "PersistentVolumeClaimStatus is the current status of a persistent volume claim.",
"properties": { "properties": {
"accessModes": { "accessModes": {
"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", "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",
"items": { "items": {
"default": "", "default": "",
"type": "string" "type": "string"
@ -3550,7 +3550,7 @@
"$ref": "#/components/schemas/io.k8s.apimachinery.pkg.api.resource.Quantity", "$ref": "#/components/schemas/io.k8s.apimachinery.pkg.api.resource.Quantity",
"default": {} "default": {}
}, },
"description": "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.", "description": "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.",
"type": "object" "type": "object"
}, },
"capacity": { "capacity": {
@ -3558,11 +3558,11 @@
"$ref": "#/components/schemas/io.k8s.apimachinery.pkg.api.resource.Quantity", "$ref": "#/components/schemas/io.k8s.apimachinery.pkg.api.resource.Quantity",
"default": {} "default": {}
}, },
"description": "Represents the actual resources of the underlying volume.", "description": "capacity represents the actual resources of the underlying volume.",
"type": "object" "type": "object"
}, },
"conditions": { "conditions": {
"description": "Current Condition of persistent volume claim. If underlying persistent volume is being resized then the Condition will be set to 'ResizeStarted'.", "description": "conditions is the current Condition of persistent volume claim. If underlying persistent volume is being resized then the Condition will be set to 'ResizeStarted'.",
"items": { "items": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.PersistentVolumeClaimCondition", "$ref": "#/components/schemas/io.k8s.api.core.v1.PersistentVolumeClaimCondition",
"default": {} "default": {}
@ -3572,7 +3572,7 @@
"x-kubernetes-patch-strategy": "merge" "x-kubernetes-patch-strategy": "merge"
}, },
"phase": { "phase": {
"description": "Phase represents the current phase of PersistentVolumeClaim.\n\nPossible enum values:\n - `\"Bound\"` used for PersistentVolumeClaims that are bound\n - `\"Lost\"` used for PersistentVolumeClaims that lost their underlying PersistentVolume. The claim was bound to a PersistentVolume and this volume does not exist any longer and all data on it was lost.\n - `\"Pending\"` used for PersistentVolumeClaims that are not yet bound", "description": "phase represents the current phase of PersistentVolumeClaim.\n\nPossible enum values:\n - `\"Bound\"` used for PersistentVolumeClaims that are bound\n - `\"Lost\"` used for PersistentVolumeClaims that lost their underlying PersistentVolume. The claim was bound to a PersistentVolume and this volume does not exist any longer and all data on it was lost.\n - `\"Pending\"` used for PersistentVolumeClaims that are not yet bound",
"enum": [ "enum": [
"Bound", "Bound",
"Lost", "Lost",
@ -3581,7 +3581,7 @@
"type": "string" "type": "string"
}, },
"resizeStatus": { "resizeStatus": {
"description": "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.", "description": "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.",
"type": "string" "type": "string"
} }
}, },
@ -3611,11 +3611,11 @@
"properties": { "properties": {
"claimName": { "claimName": {
"default": "", "default": "",
"description": "ClaimName is the name of a PersistentVolumeClaim in the same namespace as the pod using this volume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims", "description": "claimName is the name of a PersistentVolumeClaim in the same namespace as the pod using this volume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims",
"type": "string" "type": "string"
}, },
"readOnly": { "readOnly": {
"description": "Will force the ReadOnly setting in VolumeMounts. Default false.", "description": "readOnly Will force the ReadOnly setting in VolumeMounts. Default false.",
"type": "boolean" "type": "boolean"
} }
}, },
@ -3632,7 +3632,7 @@
"type": "string" "type": "string"
}, },
"items": { "items": {
"description": "List of persistent volumes. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes", "description": "items is a list of persistent volumes. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes",
"items": { "items": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.PersistentVolume", "$ref": "#/components/schemas/io.k8s.api.core.v1.PersistentVolume",
"default": {} "default": {}
@ -3665,7 +3665,7 @@
"description": "PersistentVolumeSpec is the specification of a persistent volume.", "description": "PersistentVolumeSpec is the specification of a persistent volume.",
"properties": { "properties": {
"accessModes": { "accessModes": {
"description": "AccessModes contains all ways the volume can be mounted. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes", "description": "accessModes contains all ways the volume can be mounted. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes",
"items": { "items": {
"default": "", "default": "",
"type": "string" "type": "string"
@ -3689,7 +3689,7 @@
"$ref": "#/components/schemas/io.k8s.apimachinery.pkg.api.resource.Quantity", "$ref": "#/components/schemas/io.k8s.apimachinery.pkg.api.resource.Quantity",
"default": {} "default": {}
}, },
"description": "A description of the persistent volume's resources and capacity. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity", "description": "capacity is the description of the persistent volume's resources and capacity. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity",
"type": "object" "type": "object"
}, },
"cephfs": { "cephfs": {
@ -3702,7 +3702,7 @@
}, },
"claimRef": { "claimRef": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.ObjectReference", "$ref": "#/components/schemas/io.k8s.api.core.v1.ObjectReference",
"description": "ClaimRef is part of a bi-directional binding between PersistentVolume and PersistentVolumeClaim. Expected to be non-nil when bound. claim.VolumeName is the authoritative bind between PV and PVC. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#binding" "description": "claimRef is part of a bi-directional binding between PersistentVolume and PersistentVolumeClaim. Expected to be non-nil when bound. claim.VolumeName is the authoritative bind between PV and PVC. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#binding"
}, },
"csi": { "csi": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.CSIPersistentVolumeSource", "$ref": "#/components/schemas/io.k8s.api.core.v1.CSIPersistentVolumeSource",
@ -3741,7 +3741,7 @@
"description": "local represents directly-attached storage with node affinity" "description": "local represents directly-attached storage with node affinity"
}, },
"mountOptions": { "mountOptions": {
"description": "A list of mount options, e.g. [\"ro\", \"soft\"]. Not validated - mount will simply fail if one is invalid. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options", "description": "mountOptions is the list of mount options, e.g. [\"ro\", \"soft\"]. Not validated - mount will simply fail if one is invalid. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options",
"items": { "items": {
"default": "", "default": "",
"type": "string" "type": "string"
@ -3754,10 +3754,10 @@
}, },
"nodeAffinity": { "nodeAffinity": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.VolumeNodeAffinity", "$ref": "#/components/schemas/io.k8s.api.core.v1.VolumeNodeAffinity",
"description": "NodeAffinity defines constraints that limit what nodes this volume can be accessed from. This field influences the scheduling of pods that use this volume." "description": "nodeAffinity defines constraints that limit what nodes this volume can be accessed from. This field influences the scheduling of pods that use this volume."
}, },
"persistentVolumeReclaimPolicy": { "persistentVolumeReclaimPolicy": {
"description": "What happens to a persistent volume when released from its claim. Valid options are Retain (default for manually created PersistentVolumes), Delete (default for dynamically provisioned PersistentVolumes), and Recycle (deprecated). Recycle must be supported by the volume plugin underlying this PersistentVolume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#reclaiming\n\nPossible enum values:\n - `\"Delete\"` means the volume will be deleted from Kubernetes on release from its claim. The volume plugin must support Deletion.\n - `\"Recycle\"` means the volume will be recycled back into the pool of unbound persistent volumes on release from its claim. The volume plugin must support Recycling.\n - `\"Retain\"` means the volume will be left in its current phase (Released) for manual reclamation by the administrator. The default policy is Retain.", "description": "persistentVolumeReclaimPolicy defines what happens to a persistent volume when released from its claim. Valid options are Retain (default for manually created PersistentVolumes), Delete (default for dynamically provisioned PersistentVolumes), and Recycle (deprecated). Recycle must be supported by the volume plugin underlying this PersistentVolume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#reclaiming\n\nPossible enum values:\n - `\"Delete\"` means the volume will be deleted from Kubernetes on release from its claim. The volume plugin must support Deletion.\n - `\"Recycle\"` means the volume will be recycled back into the pool of unbound persistent volumes on release from its claim. The volume plugin must support Recycling.\n - `\"Retain\"` means the volume will be left in its current phase (Released) for manual reclamation by the administrator. The default policy is Retain.",
"enum": [ "enum": [
"Delete", "Delete",
"Recycle", "Recycle",
@ -3786,7 +3786,7 @@
"description": "scaleIO represents a ScaleIO persistent volume attached and mounted on Kubernetes nodes." "description": "scaleIO represents a ScaleIO persistent volume attached and mounted on Kubernetes nodes."
}, },
"storageClassName": { "storageClassName": {
"description": "Name of StorageClass to which this persistent volume belongs. Empty value means that this volume does not belong to any StorageClass.", "description": "storageClassName is the name of StorageClass to which this persistent volume belongs. Empty value means that this volume does not belong to any StorageClass.",
"type": "string" "type": "string"
}, },
"storageos": { "storageos": {
@ -3808,11 +3808,11 @@
"description": "PersistentVolumeStatus is the current status of a persistent volume.", "description": "PersistentVolumeStatus is the current status of a persistent volume.",
"properties": { "properties": {
"message": { "message": {
"description": "A human-readable message indicating details about why the volume is in this state.", "description": "message is a human-readable message indicating details about why the volume is in this state.",
"type": "string" "type": "string"
}, },
"phase": { "phase": {
"description": "Phase indicates if a volume is available, bound to a claim, or released by a claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#phase\n\nPossible enum values:\n - `\"Available\"` used for PersistentVolumes that are not yet bound Available volumes are held by the binder and matched to PersistentVolumeClaims\n - `\"Bound\"` used for PersistentVolumes that are bound\n - `\"Failed\"` used for PersistentVolumes that failed to be correctly recycled or deleted after being released from a claim\n - `\"Pending\"` used for PersistentVolumes that are not available\n - `\"Released\"` used for PersistentVolumes where the bound PersistentVolumeClaim was deleted released volumes must be recycled before becoming available again this phase is used by the persistent volume claim binder to signal to another process to reclaim the resource", "description": "phase indicates if a volume is available, bound to a claim, or released by a claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#phase\n\nPossible enum values:\n - `\"Available\"` used for PersistentVolumes that are not yet bound Available volumes are held by the binder and matched to PersistentVolumeClaims\n - `\"Bound\"` used for PersistentVolumes that are bound\n - `\"Failed\"` used for PersistentVolumes that failed to be correctly recycled or deleted after being released from a claim\n - `\"Pending\"` used for PersistentVolumes that are not available\n - `\"Released\"` used for PersistentVolumes where the bound PersistentVolumeClaim was deleted released volumes must be recycled before becoming available again this phase is used by the persistent volume claim binder to signal to another process to reclaim the resource",
"enum": [ "enum": [
"Available", "Available",
"Bound", "Bound",
@ -3823,7 +3823,7 @@
"type": "string" "type": "string"
}, },
"reason": { "reason": {
"description": "Reason is a brief CamelCase string that describes any failure and is meant for machine parsing and tidy display in the CLI.", "description": "reason is a brief CamelCase string that describes any failure and is meant for machine parsing and tidy display in the CLI.",
"type": "string" "type": "string"
} }
}, },
@ -6354,7 +6354,7 @@
}, },
"name": { "name": {
"default": "", "default": "",
"description": "Volume's name. Must be a DNS_LABEL and unique within the pod. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names", "description": "name of the volume. Must be a DNS_LABEL and unique within the pod. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names",
"type": "string" "type": "string"
}, },
"nfs": { "nfs": {
@ -6468,7 +6468,7 @@
"properties": { "properties": {
"required": { "required": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.NodeSelector", "$ref": "#/components/schemas/io.k8s.api.core.v1.NodeSelector",
"description": "Required specifies hard node constraints that must be met." "description": "required specifies hard node constraints that must be met."
} }
}, },
"type": "object" "type": "object"

44
api/openapi-spec/v3/apis__apps__v1_openapi.json
View File

@ -2455,12 +2455,12 @@
"spec": { "spec": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.PersistentVolumeClaimSpec", "$ref": "#/components/schemas/io.k8s.api.core.v1.PersistentVolumeClaimSpec",
"default": {}, "default": {},
"description": "Spec defines the desired characteristics of a volume requested by a pod author. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims" "description": "spec defines the desired characteristics of a volume requested by a pod author. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims"
}, },
"status": { "status": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.PersistentVolumeClaimStatus", "$ref": "#/components/schemas/io.k8s.api.core.v1.PersistentVolumeClaimStatus",
"default": {}, "default": {},
"description": "Status represents the current information/status of a persistent volume claim. Read-only. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims" "description": "status represents the current information/status of a persistent volume claim. Read-only. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims"
} }
}, },
"type": "object", "type": "object",
@ -2478,19 +2478,19 @@
"lastProbeTime": { "lastProbeTime": {
"$ref": "#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.Time", "$ref": "#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.Time",
"default": {}, "default": {},
"description": "Last time we probed the condition." "description": "lastProbeTime is the time we probed the condition."
}, },
"lastTransitionTime": { "lastTransitionTime": {
"$ref": "#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.Time", "$ref": "#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.Time",
"default": {}, "default": {},
"description": "Last time the condition transitioned from one status to another." "description": "lastTransitionTime is the time the condition transitioned from one status to another."
}, },
"message": { "message": {
"description": "Human-readable message indicating details about last transition.", "description": "message is the human-readable message indicating details about last transition.",
"type": "string" "type": "string"
}, },
"reason": { "reason": {
"description": "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.", "description": "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.",
"type": "string" "type": "string"
}, },
"status": { "status": {
@ -2517,7 +2517,7 @@
"description": "PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes", "description": "PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes",
"properties": { "properties": {
"accessModes": { "accessModes": {
"description": "AccessModes contains the desired access modes the volume should have. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1", "description": "accessModes contains the desired access modes the volume should have. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1",
"items": { "items": {
"default": "", "default": "",
"type": "string" "type": "string"
@ -2526,23 +2526,23 @@
}, },
"dataSource": { "dataSource": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.TypedLocalObjectReference", "$ref": "#/components/schemas/io.k8s.api.core.v1.TypedLocalObjectReference",
"description": "This field can be used to specify either: * An existing VolumeSnapshot object (snapshot.storage.k8s.io/VolumeSnapshot) * An existing PVC (PersistentVolumeClaim) If the provisioner or an external controller can support the specified data source, it will create a new volume based on the contents of the specified data source. If the AnyVolumeDataSource feature gate is enabled, this field will always have the same contents as the DataSourceRef field." "description": "dataSource field can be used to specify either: * An existing VolumeSnapshot object (snapshot.storage.k8s.io/VolumeSnapshot) * An existing PVC (PersistentVolumeClaim) If the provisioner or an external controller can support the specified data source, it will create a new volume based on the contents of the specified data source. If the AnyVolumeDataSource feature gate is enabled, this field will always have the same contents as the DataSourceRef field."
}, },
"dataSourceRef": { "dataSourceRef": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.TypedLocalObjectReference", "$ref": "#/components/schemas/io.k8s.api.core.v1.TypedLocalObjectReference",
"description": "Specifies the object from which to populate the volume with data, if a non-empty volume is desired. This may be any local object from a non-empty API group (non core object) or a PersistentVolumeClaim object. When this field is specified, volume binding will only succeed if the type of the specified object matches some installed volume populator or dynamic provisioner. This field will replace the functionality of the DataSource field and as such if both fields are non-empty, they must have the same value. For backwards compatibility, both fields (DataSource and DataSourceRef) will be set to the same value automatically if one of them is empty and the other is non-empty. There are two important differences between DataSource and DataSourceRef: * While DataSource only allows two specific types of objects, DataSourceRef\n allows any non-core object, as well as PersistentVolumeClaim objects.\n* While DataSource ignores disallowed values (dropping them), DataSourceRef\n preserves all values, and generates an error if a disallowed value is\n specified.\n(Alpha) Using this field requires the AnyVolumeDataSource feature gate to be enabled." "description": "dataSourceRef specifies the object from which to populate the volume with data, if a non-empty volume is desired. This may be any local object from a non-empty API group (non core object) or a PersistentVolumeClaim object. When this field is specified, volume binding will only succeed if the type of the specified object matches some installed volume populator or dynamic provisioner. This field will replace the functionality of the DataSource field and as such if both fields are non-empty, they must have the same value. For backwards compatibility, both fields (DataSource and DataSourceRef) will be set to the same value automatically if one of them is empty and the other is non-empty. There are two important differences between DataSource and DataSourceRef: * While DataSource only allows two specific types of objects, DataSourceRef\n allows any non-core object, as well as PersistentVolumeClaim objects.\n* While DataSource ignores disallowed values (dropping them), DataSourceRef\n preserves all values, and generates an error if a disallowed value is\n specified.\n(Alpha) Using this field requires the AnyVolumeDataSource feature gate to be enabled."
}, },
"resources": { "resources": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.ResourceRequirements", "$ref": "#/components/schemas/io.k8s.api.core.v1.ResourceRequirements",
"default": {}, "default": {},
"description": "Resources represents the minimum resources the volume should have. If RecoverVolumeExpansionFailure feature is enabled users are allowed to specify resource requirements that are lower than previous value but must still be higher than capacity recorded in the status field of the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources" "description": "resources represents the minimum resources the volume should have. If RecoverVolumeExpansionFailure feature is enabled users are allowed to specify resource requirements that are lower than previous value but must still be higher than capacity recorded in the status field of the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources"
}, },
"selector": { "selector": {
"$ref": "#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.LabelSelector", "$ref": "#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.LabelSelector",
"description": "A label query over volumes to consider for binding." "description": "selector is a label query over volumes to consider for binding."
}, },
"storageClassName": { "storageClassName": {
"description": "Name of the StorageClass required by the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1", "description": "storageClassName is the name of the StorageClass required by the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1",
"type": "string" "type": "string"
}, },
"volumeMode": { "volumeMode": {
@ -2550,7 +2550,7 @@
"type": "string" "type": "string"
}, },
"volumeName": { "volumeName": {
"description": "VolumeName is the binding reference to the PersistentVolume backing this claim.", "description": "volumeName is the binding reference to the PersistentVolume backing this claim.",
"type": "string" "type": "string"
} }
}, },
@ -2560,7 +2560,7 @@
"description": "PersistentVolumeClaimStatus is the current status of a persistent volume claim.", "description": "PersistentVolumeClaimStatus is the current status of a persistent volume claim.",
"properties": { "properties": {
"accessModes": { "accessModes": {
"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", "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",
"items": { "items": {
"default": "", "default": "",
"type": "string" "type": "string"
@ -2572,7 +2572,7 @@
"$ref": "#/components/schemas/io.k8s.apimachinery.pkg.api.resource.Quantity", "$ref": "#/components/schemas/io.k8s.apimachinery.pkg.api.resource.Quantity",
"default": {} "default": {}
}, },
"description": "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.", "description": "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.",
"type": "object" "type": "object"
}, },
"capacity": { "capacity": {
@ -2580,11 +2580,11 @@
"$ref": "#/components/schemas/io.k8s.apimachinery.pkg.api.resource.Quantity", "$ref": "#/components/schemas/io.k8s.apimachinery.pkg.api.resource.Quantity",
"default": {} "default": {}
}, },
"description": "Represents the actual resources of the underlying volume.", "description": "capacity represents the actual resources of the underlying volume.",
"type": "object" "type": "object"
}, },
"conditions": { "conditions": {
"description": "Current Condition of persistent volume claim. If underlying persistent volume is being resized then the Condition will be set to 'ResizeStarted'.", "description": "conditions is the current Condition of persistent volume claim. If underlying persistent volume is being resized then the Condition will be set to 'ResizeStarted'.",
"items": { "items": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.PersistentVolumeClaimCondition", "$ref": "#/components/schemas/io.k8s.api.core.v1.PersistentVolumeClaimCondition",
"default": {} "default": {}
@ -2594,7 +2594,7 @@
"x-kubernetes-patch-strategy": "merge" "x-kubernetes-patch-strategy": "merge"
}, },
"phase": { "phase": {
"description": "Phase represents the current phase of PersistentVolumeClaim.\n\nPossible enum values:\n - `\"Bound\"` used for PersistentVolumeClaims that are bound\n - `\"Lost\"` used for PersistentVolumeClaims that lost their underlying PersistentVolume. The claim was bound to a PersistentVolume and this volume does not exist any longer and all data on it was lost.\n - `\"Pending\"` used for PersistentVolumeClaims that are not yet bound", "description": "phase represents the current phase of PersistentVolumeClaim.\n\nPossible enum values:\n - `\"Bound\"` used for PersistentVolumeClaims that are bound\n - `\"Lost\"` used for PersistentVolumeClaims that lost their underlying PersistentVolume. The claim was bound to a PersistentVolume and this volume does not exist any longer and all data on it was lost.\n - `\"Pending\"` used for PersistentVolumeClaims that are not yet bound",
"enum": [ "enum": [
"Bound", "Bound",
"Lost", "Lost",
@ -2603,7 +2603,7 @@
"type": "string" "type": "string"
}, },
"resizeStatus": { "resizeStatus": {
"description": "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.", "description": "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.",
"type": "string" "type": "string"
} }
}, },
@ -2633,11 +2633,11 @@
"properties": { "properties": {
"claimName": { "claimName": {
"default": "", "default": "",
"description": "ClaimName is the name of a PersistentVolumeClaim in the same namespace as the pod using this volume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims", "description": "claimName is the name of a PersistentVolumeClaim in the same namespace as the pod using this volume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims",
"type": "string" "type": "string"
}, },
"readOnly": { "readOnly": {
"description": "Will force the ReadOnly setting in VolumeMounts. Default false.", "description": "readOnly Will force the ReadOnly setting in VolumeMounts. Default false.",
"type": "boolean" "type": "boolean"
} }
}, },
@ -3867,7 +3867,7 @@
}, },
"name": { "name": {
"default": "", "default": "",
"description": "Volume's name. Must be a DNS_LABEL and unique within the pod. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names", "description": "name of the volume. Must be a DNS_LABEL and unique within the pod. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names",
"type": "string" "type": "string"
}, },
"nfs": { "nfs": {

20
api/openapi-spec/v3/apis__batch__v1_openapi.json
View File

@ -1796,7 +1796,7 @@
"description": "PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes", "description": "PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes",
"properties": { "properties": {
"accessModes": { "accessModes": {
"description": "AccessModes contains the desired access modes the volume should have. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1", "description": "accessModes contains the desired access modes the volume should have. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1",
"items": { "items": {
"default": "", "default": "",
"type": "string" "type": "string"
@ -1805,23 +1805,23 @@
}, },
"dataSource": { "dataSource": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.TypedLocalObjectReference", "$ref": "#/components/schemas/io.k8s.api.core.v1.TypedLocalObjectReference",
"description": "This field can be used to specify either: * An existing VolumeSnapshot object (snapshot.storage.k8s.io/VolumeSnapshot) * An existing PVC (PersistentVolumeClaim) If the provisioner or an external controller can support the specified data source, it will create a new volume based on the contents of the specified data source. If the AnyVolumeDataSource feature gate is enabled, this field will always have the same contents as the DataSourceRef field." "description": "dataSource field can be used to specify either: * An existing VolumeSnapshot object (snapshot.storage.k8s.io/VolumeSnapshot) * An existing PVC (PersistentVolumeClaim) If the provisioner or an external controller can support the specified data source, it will create a new volume based on the contents of the specified data source. If the AnyVolumeDataSource feature gate is enabled, this field will always have the same contents as the DataSourceRef field."
}, },
"dataSourceRef": { "dataSourceRef": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.TypedLocalObjectReference", "$ref": "#/components/schemas/io.k8s.api.core.v1.TypedLocalObjectReference",
"description": "Specifies the object from which to populate the volume with data, if a non-empty volume is desired. This may be any local object from a non-empty API group (non core object) or a PersistentVolumeClaim object. When this field is specified, volume binding will only succeed if the type of the specified object matches some installed volume populator or dynamic provisioner. This field will replace the functionality of the DataSource field and as such if both fields are non-empty, they must have the same value. For backwards compatibility, both fields (DataSource and DataSourceRef) will be set to the same value automatically if one of them is empty and the other is non-empty. There are two important differences between DataSource and DataSourceRef: * While DataSource only allows two specific types of objects, DataSourceRef\n allows any non-core object, as well as PersistentVolumeClaim objects.\n* While DataSource ignores disallowed values (dropping them), DataSourceRef\n preserves all values, and generates an error if a disallowed value is\n specified.\n(Alpha) Using this field requires the AnyVolumeDataSource feature gate to be enabled." "description": "dataSourceRef specifies the object from which to populate the volume with data, if a non-empty volume is desired. This may be any local object from a non-empty API group (non core object) or a PersistentVolumeClaim object. When this field is specified, volume binding will only succeed if the type of the specified object matches some installed volume populator or dynamic provisioner. This field will replace the functionality of the DataSource field and as such if both fields are non-empty, they must have the same value. For backwards compatibility, both fields (DataSource and DataSourceRef) will be set to the same value automatically if one of them is empty and the other is non-empty. There are two important differences between DataSource and DataSourceRef: * While DataSource only allows two specific types of objects, DataSourceRef\n allows any non-core object, as well as PersistentVolumeClaim objects.\n* While DataSource ignores disallowed values (dropping them), DataSourceRef\n preserves all values, and generates an error if a disallowed value is\n specified.\n(Alpha) Using this field requires the AnyVolumeDataSource feature gate to be enabled."
}, },
"resources": { "resources": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.ResourceRequirements", "$ref": "#/components/schemas/io.k8s.api.core.v1.ResourceRequirements",
"default": {}, "default": {},
"description": "Resources represents the minimum resources the volume should have. If RecoverVolumeExpansionFailure feature is enabled users are allowed to specify resource requirements that are lower than previous value but must still be higher than capacity recorded in the status field of the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources" "description": "resources represents the minimum resources the volume should have. If RecoverVolumeExpansionFailure feature is enabled users are allowed to specify resource requirements that are lower than previous value but must still be higher than capacity recorded in the status field of the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources"
}, },
"selector": { "selector": {
"$ref": "#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.LabelSelector", "$ref": "#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.LabelSelector",
"description": "A label query over volumes to consider for binding." "description": "selector is a label query over volumes to consider for binding."
}, },
"storageClassName": { "storageClassName": {
"description": "Name of the StorageClass required by the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1", "description": "storageClassName is the name of the StorageClass required by the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1",
"type": "string" "type": "string"
}, },
"volumeMode": { "volumeMode": {
@ -1829,7 +1829,7 @@
"type": "string" "type": "string"
}, },
"volumeName": { "volumeName": {
"description": "VolumeName is the binding reference to the PersistentVolume backing this claim.", "description": "volumeName is the binding reference to the PersistentVolume backing this claim.",
"type": "string" "type": "string"
} }
}, },
@ -1859,11 +1859,11 @@
"properties": { "properties": {
"claimName": { "claimName": {
"default": "", "default": "",
"description": "ClaimName is the name of a PersistentVolumeClaim in the same namespace as the pod using this volume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims", "description": "claimName is the name of a PersistentVolumeClaim in the same namespace as the pod using this volume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims",
"type": "string" "type": "string"
}, },
"readOnly": { "readOnly": {
"description": "Will force the ReadOnly setting in VolumeMounts. Default false.", "description": "readOnly Will force the ReadOnly setting in VolumeMounts. Default false.",
"type": "boolean" "type": "boolean"
} }
}, },
@ -3093,7 +3093,7 @@
}, },
"name": { "name": {
"default": "", "default": "",
"description": "Volume's name. Must be a DNS_LABEL and unique within the pod. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names", "description": "name of the volume. Must be a DNS_LABEL and unique within the pod. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names",
"type": "string" "type": "string"
}, },
"nfs": { "nfs": {

20
api/openapi-spec/v3/apis__batch__v1beta1_openapi.json
View File

@ -1598,7 +1598,7 @@
"description": "PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes", "description": "PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes",
"properties": { "properties": {
"accessModes": { "accessModes": {
"description": "AccessModes contains the desired access modes the volume should have. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1", "description": "accessModes contains the desired access modes the volume should have. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1",
"items": { "items": {
"default": "", "default": "",
"type": "string" "type": "string"
@ -1607,23 +1607,23 @@
}, },
"dataSource": { "dataSource": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.TypedLocalObjectReference", "$ref": "#/components/schemas/io.k8s.api.core.v1.TypedLocalObjectReference",
"description": "This field can be used to specify either: * An existing VolumeSnapshot object (snapshot.storage.k8s.io/VolumeSnapshot) * An existing PVC (PersistentVolumeClaim) If the provisioner or an external controller can support the specified data source, it will create a new volume based on the contents of the specified data source. If the AnyVolumeDataSource feature gate is enabled, this field will always have the same contents as the DataSourceRef field." "description": "dataSource field can be used to specify either: * An existing VolumeSnapshot object (snapshot.storage.k8s.io/VolumeSnapshot) * An existing PVC (PersistentVolumeClaim) If the provisioner or an external controller can support the specified data source, it will create a new volume based on the contents of the specified data source. If the AnyVolumeDataSource feature gate is enabled, this field will always have the same contents as the DataSourceRef field."
}, },
"dataSourceRef": { "dataSourceRef": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.TypedLocalObjectReference", "$ref": "#/components/schemas/io.k8s.api.core.v1.TypedLocalObjectReference",
"description": "Specifies the object from which to populate the volume with data, if a non-empty volume is desired. This may be any local object from a non-empty API group (non core object) or a PersistentVolumeClaim object. When this field is specified, volume binding will only succeed if the type of the specified object matches some installed volume populator or dynamic provisioner. This field will replace the functionality of the DataSource field and as such if both fields are non-empty, they must have the same value. For backwards compatibility, both fields (DataSource and DataSourceRef) will be set to the same value automatically if one of them is empty and the other is non-empty. There are two important differences between DataSource and DataSourceRef: * While DataSource only allows two specific types of objects, DataSourceRef\n allows any non-core object, as well as PersistentVolumeClaim objects.\n* While DataSource ignores disallowed values (dropping them), DataSourceRef\n preserves all values, and generates an error if a disallowed value is\n specified.\n(Alpha) Using this field requires the AnyVolumeDataSource feature gate to be enabled." "description": "dataSourceRef specifies the object from which to populate the volume with data, if a non-empty volume is desired. This may be any local object from a non-empty API group (non core object) or a PersistentVolumeClaim object. When this field is specified, volume binding will only succeed if the type of the specified object matches some installed volume populator or dynamic provisioner. This field will replace the functionality of the DataSource field and as such if both fields are non-empty, they must have the same value. For backwards compatibility, both fields (DataSource and DataSourceRef) will be set to the same value automatically if one of them is empty and the other is non-empty. There are two important differences between DataSource and DataSourceRef: * While DataSource only allows two specific types of objects, DataSourceRef\n allows any non-core object, as well as PersistentVolumeClaim objects.\n* While DataSource ignores disallowed values (dropping them), DataSourceRef\n preserves all values, and generates an error if a disallowed value is\n specified.\n(Alpha) Using this field requires the AnyVolumeDataSource feature gate to be enabled."
}, },
"resources": { "resources": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.ResourceRequirements", "$ref": "#/components/schemas/io.k8s.api.core.v1.ResourceRequirements",
"default": {}, "default": {},
"description": "Resources represents the minimum resources the volume should have. If RecoverVolumeExpansionFailure feature is enabled users are allowed to specify resource requirements that are lower than previous value but must still be higher than capacity recorded in the status field of the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources" "description": "resources represents the minimum resources the volume should have. If RecoverVolumeExpansionFailure feature is enabled users are allowed to specify resource requirements that are lower than previous value but must still be higher than capacity recorded in the status field of the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources"
}, },
"selector": { "selector": {
"$ref": "#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.LabelSelector", "$ref": "#/components/schemas/io.k8s.apimachinery.pkg.apis.meta.v1.LabelSelector",
"description": "A label query over volumes to consider for binding." "description": "selector is a label query over volumes to consider for binding."
}, },
"storageClassName": { "storageClassName": {
"description": "Name of the StorageClass required by the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1", "description": "storageClassName is the name of the StorageClass required by the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1",
"type": "string" "type": "string"
}, },
"volumeMode": { "volumeMode": {
@ -1631,7 +1631,7 @@
"type": "string" "type": "string"
}, },
"volumeName": { "volumeName": {
"description": "VolumeName is the binding reference to the PersistentVolume backing this claim.", "description": "volumeName is the binding reference to the PersistentVolume backing this claim.",
"type": "string" "type": "string"
} }
}, },
@ -1661,11 +1661,11 @@
"properties": { "properties": {
"claimName": { "claimName": {
"default": "", "default": "",
"description": "ClaimName is the name of a PersistentVolumeClaim in the same namespace as the pod using this volume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims", "description": "claimName is the name of a PersistentVolumeClaim in the same namespace as the pod using this volume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims",
"type": "string" "type": "string"
}, },
"readOnly": { "readOnly": {
"description": "Will force the ReadOnly setting in VolumeMounts. Default false.", "description": "readOnly Will force the ReadOnly setting in VolumeMounts. Default false.",
"type": "boolean" "type": "boolean"
} }
}, },
@ -2895,7 +2895,7 @@
}, },
"name": { "name": {
"default": "", "default": "",
"description": "Volume's name. Must be a DNS_LABEL and unique within the pod. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names", "description": "name of the volume. Must be a DNS_LABEL and unique within the pod. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names",
"type": "string" "type": "string"
}, },
"nfs": { "nfs": {

16
api/openapi-spec/v3/apis__storage.k8s.io__v1_openapi.json
View File

@ -584,7 +584,7 @@
"description": "PersistentVolumeSpec is the specification of a persistent volume.", "description": "PersistentVolumeSpec is the specification of a persistent volume.",
"properties": { "properties": {
"accessModes": { "accessModes": {
"description": "AccessModes contains all ways the volume can be mounted. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes", "description": "accessModes contains all ways the volume can be mounted. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes",
"items": { "items": {
"default": "", "default": "",
"type": "string" "type": "string"
@ -608,7 +608,7 @@
"$ref": "#/components/schemas/io.k8s.apimachinery.pkg.api.resource.Quantity", "$ref": "#/components/schemas/io.k8s.apimachinery.pkg.api.resource.Quantity",
"default": {} "default": {}
}, },
"description": "A description of the persistent volume's resources and capacity. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity", "description": "capacity is the description of the persistent volume's resources and capacity. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity",
"type": "object" "type": "object"
}, },
"cephfs": { "cephfs": {
@ -621,7 +621,7 @@
}, },
"claimRef": { "claimRef": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.ObjectReference", "$ref": "#/components/schemas/io.k8s.api.core.v1.ObjectReference",
"description": "ClaimRef is part of a bi-directional binding between PersistentVolume and PersistentVolumeClaim. Expected to be non-nil when bound. claim.VolumeName is the authoritative bind between PV and PVC. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#binding" "description": "claimRef is part of a bi-directional binding between PersistentVolume and PersistentVolumeClaim. Expected to be non-nil when bound. claim.VolumeName is the authoritative bind between PV and PVC. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#binding"
}, },
"csi": { "csi": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.CSIPersistentVolumeSource", "$ref": "#/components/schemas/io.k8s.api.core.v1.CSIPersistentVolumeSource",
@ -660,7 +660,7 @@
"description": "local represents directly-attached storage with node affinity" "description": "local represents directly-attached storage with node affinity"
}, },
"mountOptions": { "mountOptions": {
"description": "A list of mount options, e.g. [\"ro\", \"soft\"]. Not validated - mount will simply fail if one is invalid. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options", "description": "mountOptions is the list of mount options, e.g. [\"ro\", \"soft\"]. Not validated - mount will simply fail if one is invalid. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options",
"items": { "items": {
"default": "", "default": "",
"type": "string" "type": "string"
@ -673,10 +673,10 @@
}, },
"nodeAffinity": { "nodeAffinity": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.VolumeNodeAffinity", "$ref": "#/components/schemas/io.k8s.api.core.v1.VolumeNodeAffinity",
"description": "NodeAffinity defines constraints that limit what nodes this volume can be accessed from. This field influences the scheduling of pods that use this volume." "description": "nodeAffinity defines constraints that limit what nodes this volume can be accessed from. This field influences the scheduling of pods that use this volume."
}, },
"persistentVolumeReclaimPolicy": { "persistentVolumeReclaimPolicy": {
"description": "What happens to a persistent volume when released from its claim. Valid options are Retain (default for manually created PersistentVolumes), Delete (default for dynamically provisioned PersistentVolumes), and Recycle (deprecated). Recycle must be supported by the volume plugin underlying this PersistentVolume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#reclaiming\n\nPossible enum values:\n - `\"Delete\"` means the volume will be deleted from Kubernetes on release from its claim. The volume plugin must support Deletion.\n - `\"Recycle\"` means the volume will be recycled back into the pool of unbound persistent volumes on release from its claim. The volume plugin must support Recycling.\n - `\"Retain\"` means the volume will be left in its current phase (Released) for manual reclamation by the administrator. The default policy is Retain.", "description": "persistentVolumeReclaimPolicy defines what happens to a persistent volume when released from its claim. Valid options are Retain (default for manually created PersistentVolumes), Delete (default for dynamically provisioned PersistentVolumes), and Recycle (deprecated). Recycle must be supported by the volume plugin underlying this PersistentVolume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#reclaiming\n\nPossible enum values:\n - `\"Delete\"` means the volume will be deleted from Kubernetes on release from its claim. The volume plugin must support Deletion.\n - `\"Recycle\"` means the volume will be recycled back into the pool of unbound persistent volumes on release from its claim. The volume plugin must support Recycling.\n - `\"Retain\"` means the volume will be left in its current phase (Released) for manual reclamation by the administrator. The default policy is Retain.",
"enum": [ "enum": [
"Delete", "Delete",
"Recycle", "Recycle",
@ -705,7 +705,7 @@
"description": "scaleIO represents a ScaleIO persistent volume attached and mounted on Kubernetes nodes." "description": "scaleIO represents a ScaleIO persistent volume attached and mounted on Kubernetes nodes."
}, },
"storageClassName": { "storageClassName": {
"description": "Name of StorageClass to which this persistent volume belongs. Empty value means that this volume does not belong to any StorageClass.", "description": "storageClassName is the name of StorageClass to which this persistent volume belongs. Empty value means that this volume does not belong to any StorageClass.",
"type": "string" "type": "string"
}, },
"storageos": { "storageos": {
@ -983,7 +983,7 @@
"properties": { "properties": {
"required": { "required": {
"$ref": "#/components/schemas/io.k8s.api.core.v1.NodeSelector", "$ref": "#/components/schemas/io.k8s.api.core.v1.NodeSelector",
"description": "Required specifies hard node constraints that must be met." "description": "required specifies hard node constraints that must be met."
} }
}, },
"type": "object" "type": "object"

78
staging/src/k8s.io/api/core/v1/generated.proto
View File

@ -2594,13 +2594,13 @@ message PersistentVolume {
// +optional // +optional
optional k8s.io.apimachinery.pkg.apis.meta.v1.ObjectMeta metadata = 1; optional k8s.io.apimachinery.pkg.apis.meta.v1.ObjectMeta metadata = 1;
// Spec defines a specification of a persistent volume owned by the cluster. // spec defines a specification of a persistent volume owned by the cluster.
// Provisioned by an administrator. // Provisioned by an administrator.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes
// +optional // +optional
optional PersistentVolumeSpec spec = 2; optional PersistentVolumeSpec spec = 2;
// Status represents the current information/status for the persistent volume. // status represents the current information/status for the persistent volume.
// Populated by the system. // Populated by the system.
// Read-only. // Read-only.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes
@ -2615,12 +2615,12 @@ message PersistentVolumeClaim {
// +optional // +optional
optional k8s.io.apimachinery.pkg.apis.meta.v1.ObjectMeta metadata = 1; optional k8s.io.apimachinery.pkg.apis.meta.v1.ObjectMeta metadata = 1;
// Spec defines the desired characteristics of a volume requested by a pod author. // spec defines the desired characteristics of a volume requested by a pod author.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
// +optional // +optional
optional PersistentVolumeClaimSpec spec = 2; optional PersistentVolumeClaimSpec spec = 2;
// Status represents the current information/status of a persistent volume claim. // status represents the current information/status of a persistent volume claim.
// Read-only. // Read-only.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
// +optional // +optional
@ -2633,21 +2633,21 @@ message PersistentVolumeClaimCondition {
optional string status = 2; optional string status = 2;
// Last time we probed the condition. // lastProbeTime is the time we probed the condition.
// +optional // +optional
optional k8s.io.apimachinery.pkg.apis.meta.v1.Time lastProbeTime = 3; optional k8s.io.apimachinery.pkg.apis.meta.v1.Time lastProbeTime = 3;
// Last time the condition transitioned from one status to another. // lastTransitionTime is the time the condition transitioned from one status to another.
// +optional // +optional
optional k8s.io.apimachinery.pkg.apis.meta.v1.Time lastTransitionTime = 4; optional k8s.io.apimachinery.pkg.apis.meta.v1.Time lastTransitionTime = 4;
// Unique, this should be a short, machine understandable string that gives the reason // 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 // for condition's last transition. If it reports "ResizeStarted" that means the underlying
// persistent volume is being resized. // persistent volume is being resized.
// +optional // +optional
optional string reason = 5; optional string reason = 5;
// Human-readable message indicating details about last transition. // message is the human-readable message indicating details about last transition.
// +optional // +optional
optional string message = 6; optional string message = 6;
} }
@ -2659,7 +2659,7 @@ message PersistentVolumeClaimList {
// +optional // +optional
optional k8s.io.apimachinery.pkg.apis.meta.v1.ListMeta metadata = 1; optional k8s.io.apimachinery.pkg.apis.meta.v1.ListMeta metadata = 1;
// A list of persistent volume claims. // items is a list of persistent volume claims.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
repeated PersistentVolumeClaim items = 2; repeated PersistentVolumeClaim items = 2;
} }
@ -2667,16 +2667,16 @@ message PersistentVolumeClaimList {
// PersistentVolumeClaimSpec describes the common attributes of storage devices // PersistentVolumeClaimSpec describes the common attributes of storage devices
// and allows a Source for provider-specific attributes // and allows a Source for provider-specific attributes
message PersistentVolumeClaimSpec { message PersistentVolumeClaimSpec {
// AccessModes contains the desired access modes the volume should have. // accessModes contains the desired access modes the volume should have.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1
// +optional // +optional
repeated string accessModes = 1; repeated string accessModes = 1;
// A label query over volumes to consider for binding. // selector is a label query over volumes to consider for binding.
// +optional // +optional
optional k8s.io.apimachinery.pkg.apis.meta.v1.LabelSelector selector = 4; optional k8s.io.apimachinery.pkg.apis.meta.v1.LabelSelector selector = 4;
// Resources represents the minimum resources the volume should have. // resources represents the minimum resources the volume should have.
// If RecoverVolumeExpansionFailure feature is enabled users are allowed to specify resource requirements // If RecoverVolumeExpansionFailure feature is enabled users are allowed to specify resource requirements
// that are lower than previous value but must still be higher than capacity recorded in the // that are lower than previous value but must still be higher than capacity recorded in the
// status field of the claim. // status field of the claim.
@ -2684,11 +2684,11 @@ message PersistentVolumeClaimSpec {
// +optional // +optional
optional ResourceRequirements resources = 2; optional ResourceRequirements resources = 2;
// VolumeName is the binding reference to the PersistentVolume backing this claim. // volumeName is the binding reference to the PersistentVolume backing this claim.
// +optional // +optional
optional string volumeName = 3; optional string volumeName = 3;
// Name of the StorageClass required by the claim. // storageClassName is the name of the StorageClass required by the claim.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1 // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1
// +optional // +optional
optional string storageClassName = 5; optional string storageClassName = 5;
@ -2698,7 +2698,7 @@ message PersistentVolumeClaimSpec {
// +optional // +optional
optional string volumeMode = 6; optional string volumeMode = 6;
// This field can be used to specify either: // dataSource field can be used to specify either:
// * An existing VolumeSnapshot object (snapshot.storage.k8s.io/VolumeSnapshot) // * An existing VolumeSnapshot object (snapshot.storage.k8s.io/VolumeSnapshot)
// * An existing PVC (PersistentVolumeClaim) // * An existing PVC (PersistentVolumeClaim)
// If the provisioner or an external controller can support the specified data source, // If the provisioner or an external controller can support the specified data source,
@ -2708,7 +2708,7 @@ message PersistentVolumeClaimSpec {
// +optional // +optional
optional TypedLocalObjectReference dataSource = 7; optional TypedLocalObjectReference dataSource = 7;
// Specifies the object from which to populate the volume with data, if a non-empty // dataSourceRef specifies the object from which to populate the volume with data, if a non-empty
// volume is desired. This may be any local object from a non-empty API group (non // volume is desired. This may be any local object from a non-empty API group (non
// core object) or a PersistentVolumeClaim object. // core object) or a PersistentVolumeClaim object.
// When this field is specified, volume binding will only succeed if the type of // When this field is specified, volume binding will only succeed if the type of
@ -2731,27 +2731,27 @@ message PersistentVolumeClaimSpec {
// PersistentVolumeClaimStatus is the current status of a persistent volume claim. // PersistentVolumeClaimStatus is the current status of a persistent volume claim.
message PersistentVolumeClaimStatus { message PersistentVolumeClaimStatus {
// Phase represents the current phase of PersistentVolumeClaim. // phase represents the current phase of PersistentVolumeClaim.
// +optional // +optional
optional string phase = 1; optional string phase = 1;
// AccessModes contains the actual access modes the volume backing the PVC has. // 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 // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1
// +optional // +optional
repeated string accessModes = 2; repeated string accessModes = 2;
// Represents the actual resources of the underlying volume. // capacity represents the actual resources of the underlying volume.
// +optional // +optional
map<string, k8s.io.apimachinery.pkg.api.resource.Quantity> capacity = 3; map<string, k8s.io.apimachinery.pkg.api.resource.Quantity> capacity = 3;
// Current Condition of persistent volume claim. If underlying persistent volume is being // conditions is the current Condition of persistent volume claim. If underlying persistent volume is being
// resized then the Condition will be set to 'ResizeStarted'. // resized then the Condition will be set to 'ResizeStarted'.
// +optional // +optional
// +patchMergeKey=type // +patchMergeKey=type
// +patchStrategy=merge // +patchStrategy=merge
repeated PersistentVolumeClaimCondition conditions = 4; repeated PersistentVolumeClaimCondition conditions = 4;
// The storage resource within AllocatedResources tracks the capacity allocated to a PVC. It may // 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. // 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. // 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 allocatedResources is not set, PVC.spec.resources alone is used for quota calculation.
@ -2763,7 +2763,7 @@ message PersistentVolumeClaimStatus {
// +optional // +optional
map<string, k8s.io.apimachinery.pkg.api.resource.Quantity> allocatedResources = 5; map<string, k8s.io.apimachinery.pkg.api.resource.Quantity> allocatedResources = 5;
// ResizeStatus stores status of resize operation. // resizeStatus stores status of resize operation.
// ResizeStatus is not set by default but when expansion is complete resizeStatus is set to empty // ResizeStatus is not set by default but when expansion is complete resizeStatus is set to empty
// string by resize controller or kubelet. // string by resize controller or kubelet.
// This is an alpha field and requires enabling RecoverVolumeExpansionFailure feature. // This is an alpha field and requires enabling RecoverVolumeExpansionFailure feature.
@ -2794,11 +2794,11 @@ message PersistentVolumeClaimTemplate {
// PersistentVolumeClaimVolumeSource is, essentially, a wrapper around another // PersistentVolumeClaimVolumeSource is, essentially, a wrapper around another
// type of volume that is owned by someone else (the system). // type of volume that is owned by someone else (the system).
message PersistentVolumeClaimVolumeSource { message PersistentVolumeClaimVolumeSource {
// ClaimName is the name of a PersistentVolumeClaim in the same namespace as the pod using this volume. // claimName is the name of a PersistentVolumeClaim in the same namespace as the pod using this volume.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
optional string claimName = 1; optional string claimName = 1;
// Will force the ReadOnly setting in VolumeMounts. // readOnly Will force the ReadOnly setting in VolumeMounts.
// Default false. // Default false.
// +optional // +optional
optional bool readOnly = 2; optional bool readOnly = 2;
@ -2811,7 +2811,7 @@ message PersistentVolumeList {
// +optional // +optional
optional k8s.io.apimachinery.pkg.apis.meta.v1.ListMeta metadata = 1; optional k8s.io.apimachinery.pkg.apis.meta.v1.ListMeta metadata = 1;
// List of persistent volumes. // items is a list of persistent volumes.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes
repeated PersistentVolume items = 2; repeated PersistentVolume items = 2;
} }
@ -2925,27 +2925,27 @@ message PersistentVolumeSource {
// PersistentVolumeSpec is the specification of a persistent volume. // PersistentVolumeSpec is the specification of a persistent volume.
message PersistentVolumeSpec { message PersistentVolumeSpec {
// A description of the persistent volume's resources and capacity. // capacity is the description of the persistent volume's resources and capacity.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity
// +optional // +optional
map<string, k8s.io.apimachinery.pkg.api.resource.Quantity> capacity = 1; map<string, k8s.io.apimachinery.pkg.api.resource.Quantity> capacity = 1;
// The actual volume backing the persistent volume. // persistentVolumeSource is the actual volume backing the persistent volume.
optional PersistentVolumeSource persistentVolumeSource = 2; optional PersistentVolumeSource persistentVolumeSource = 2;
// AccessModes contains all ways the volume can be mounted. // accessModes contains all ways the volume can be mounted.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes
// +optional // +optional
repeated string accessModes = 3; repeated string accessModes = 3;
// ClaimRef is part of a bi-directional binding between PersistentVolume and PersistentVolumeClaim. // claimRef is part of a bi-directional binding between PersistentVolume and PersistentVolumeClaim.
// Expected to be non-nil when bound. // Expected to be non-nil when bound.
// claim.VolumeName is the authoritative bind between PV and PVC. // claim.VolumeName is the authoritative bind between PV and PVC.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#binding // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#binding
// +optional // +optional
optional ObjectReference claimRef = 4; optional ObjectReference claimRef = 4;
// What happens to a persistent volume when released from its claim. // persistentVolumeReclaimPolicy defines what happens to a persistent volume when released from its claim.
// Valid options are Retain (default for manually created PersistentVolumes), Delete (default // Valid options are Retain (default for manually created PersistentVolumes), Delete (default
// for dynamically provisioned PersistentVolumes), and Recycle (deprecated). // for dynamically provisioned PersistentVolumes), and Recycle (deprecated).
// Recycle must be supported by the volume plugin underlying this PersistentVolume. // Recycle must be supported by the volume plugin underlying this PersistentVolume.
@ -2953,12 +2953,12 @@ message PersistentVolumeSpec {
// +optional // +optional
optional string persistentVolumeReclaimPolicy = 5; optional string persistentVolumeReclaimPolicy = 5;
// Name of StorageClass to which this persistent volume belongs. Empty value // storageClassName is the name of StorageClass to which this persistent volume belongs. Empty value
// means that this volume does not belong to any StorageClass. // means that this volume does not belong to any StorageClass.
// +optional // +optional
optional string storageClassName = 6; optional string storageClassName = 6;
// A list of mount options, e.g. ["ro", "soft"]. Not validated - mount will // mountOptions is the list of mount options, e.g. ["ro", "soft"]. Not validated - mount will
// simply fail if one is invalid. // simply fail if one is invalid.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options
// +optional // +optional
@ -2969,7 +2969,7 @@ message PersistentVolumeSpec {
// +optional // +optional
optional string volumeMode = 8; optional string volumeMode = 8;
// NodeAffinity defines constraints that limit what nodes this volume can be accessed from. // nodeAffinity defines constraints that limit what nodes this volume can be accessed from.
// This field influences the scheduling of pods that use this volume. // This field influences the scheduling of pods that use this volume.
// +optional // +optional
optional VolumeNodeAffinity nodeAffinity = 9; optional VolumeNodeAffinity nodeAffinity = 9;
@ -2977,16 +2977,16 @@ message PersistentVolumeSpec {
// PersistentVolumeStatus is the current status of a persistent volume. // PersistentVolumeStatus is the current status of a persistent volume.
message PersistentVolumeStatus { message PersistentVolumeStatus {
// Phase indicates if a volume is available, bound to a claim, or released by a claim. // phase indicates if a volume is available, bound to a claim, or released by a claim.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#phase // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#phase
// +optional // +optional
optional string phase = 1; optional string phase = 1;
// A human-readable message indicating details about why the volume is in this state. // message is a human-readable message indicating details about why the volume is in this state.
// +optional // +optional
optional string message = 2; optional string message = 2;
// Reason is a brief CamelCase string that describes any failure and is meant // reason is a brief CamelCase string that describes any failure and is meant
// for machine parsing and tidy display in the CLI. // for machine parsing and tidy display in the CLI.
// +optional // +optional
optional string reason = 3; optional string reason = 3;
@ -5454,12 +5454,12 @@ message TypedLocalObjectReference {
// Volume represents a named volume in a pod that may be accessed by any container in the pod. // Volume represents a named volume in a pod that may be accessed by any container in the pod.
message Volume { message Volume {
// Volume's name. // name of the volume.
// Must be a DNS_LABEL and unique within the pod. // Must be a DNS_LABEL and unique within the pod.
// More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names // More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
optional string name = 1; optional string name = 1;
// VolumeSource represents the location and type of the mounted volume. // volumeSource represents the location and type of the mounted volume.
// If not specified, the Volume is implied to be an EmptyDir. // If not specified, the Volume is implied to be an EmptyDir.
// This implied behavior is deprecated and will be removed in a future version. // This implied behavior is deprecated and will be removed in a future version.
optional VolumeSource volumeSource = 2; optional VolumeSource volumeSource = 2;
@ -5510,7 +5510,7 @@ message VolumeMount {
// VolumeNodeAffinity defines constraints that limit what nodes this volume can be accessed from. // VolumeNodeAffinity defines constraints that limit what nodes this volume can be accessed from.
message VolumeNodeAffinity { message VolumeNodeAffinity {
// Required specifies hard node constraints that must be met. // required specifies hard node constraints that must be met.
optional NodeSelector required = 1; optional NodeSelector required = 1;
} }

78
staging/src/k8s.io/api/core/v1/types.go
View File

@ -34,11 +34,11 @@ const (
// Volume represents a named volume in a pod that may be accessed by any container in the pod. // Volume represents a named volume in a pod that may be accessed by any container in the pod.
type Volume struct { type Volume struct {
// Volume's name. // name of the volume.
// Must be a DNS_LABEL and unique within the pod. // Must be a DNS_LABEL and unique within the pod.
// More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names // More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
Name string `json:"name" protobuf:"bytes,1,opt,name=name"` Name string `json:"name" protobuf:"bytes,1,opt,name=name"`
// VolumeSource represents the location and type of the mounted volume. // volumeSource represents the location and type of the mounted volume.
// If not specified, the Volume is implied to be an EmptyDir. // If not specified, the Volume is implied to be an EmptyDir.
// This implied behavior is deprecated and will be removed in a future version. // This implied behavior is deprecated and will be removed in a future version.
VolumeSource `json:",inline" protobuf:"bytes,2,opt,name=volumeSource"` VolumeSource `json:",inline" protobuf:"bytes,2,opt,name=volumeSource"`
@ -188,10 +188,10 @@ type VolumeSource struct {
// PersistentVolumeClaimVolumeSource is, essentially, a wrapper around another // PersistentVolumeClaimVolumeSource is, essentially, a wrapper around another
// type of volume that is owned by someone else (the system). // type of volume that is owned by someone else (the system).
type PersistentVolumeClaimVolumeSource struct { type PersistentVolumeClaimVolumeSource struct {
// ClaimName is the name of a PersistentVolumeClaim in the same namespace as the pod using this volume. // claimName is the name of a PersistentVolumeClaim in the same namespace as the pod using this volume.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
ClaimName string `json:"claimName" protobuf:"bytes,1,opt,name=claimName"` ClaimName string `json:"claimName" protobuf:"bytes,1,opt,name=claimName"`
// Will force the ReadOnly setting in VolumeMounts. // readOnly Will force the ReadOnly setting in VolumeMounts.
// Default false. // Default false.
// +optional // +optional
ReadOnly bool `json:"readOnly,omitempty" protobuf:"varint,2,opt,name=readOnly"` ReadOnly bool `json:"readOnly,omitempty" protobuf:"varint,2,opt,name=readOnly"`
@ -306,13 +306,13 @@ type PersistentVolume struct {
// +optional // +optional
metav1.ObjectMeta `json:"metadata,omitempty" protobuf:"bytes,1,opt,name=metadata"` metav1.ObjectMeta `json:"metadata,omitempty" protobuf:"bytes,1,opt,name=metadata"`
// Spec defines a specification of a persistent volume owned by the cluster. // spec defines a specification of a persistent volume owned by the cluster.
// Provisioned by an administrator. // Provisioned by an administrator.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes
// +optional // +optional
Spec PersistentVolumeSpec `json:"spec,omitempty" protobuf:"bytes,2,opt,name=spec"` Spec PersistentVolumeSpec `json:"spec,omitempty" protobuf:"bytes,2,opt,name=spec"`
// Status represents the current information/status for the persistent volume. // status represents the current information/status for the persistent volume.
// Populated by the system. // Populated by the system.
// Read-only. // Read-only.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes
@ -322,34 +322,34 @@ type PersistentVolume struct {
// PersistentVolumeSpec is the specification of a persistent volume. // PersistentVolumeSpec is the specification of a persistent volume.
type PersistentVolumeSpec struct { type PersistentVolumeSpec struct {
// A description of the persistent volume's resources and capacity. // capacity is the description of the persistent volume's resources and capacity.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity
// +optional // +optional
Capacity ResourceList `json:"capacity,omitempty" protobuf:"bytes,1,rep,name=capacity,casttype=ResourceList,castkey=ResourceName"` Capacity ResourceList `json:"capacity,omitempty" protobuf:"bytes,1,rep,name=capacity,casttype=ResourceList,castkey=ResourceName"`
// The actual volume backing the persistent volume. // persistentVolumeSource is the actual volume backing the persistent volume.
PersistentVolumeSource `json:",inline" protobuf:"bytes,2,opt,name=persistentVolumeSource"` PersistentVolumeSource `json:",inline" protobuf:"bytes,2,opt,name=persistentVolumeSource"`
// AccessModes contains all ways the volume can be mounted. // accessModes contains all ways the volume can be mounted.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes
// +optional // +optional
AccessModes []PersistentVolumeAccessMode `json:"accessModes,omitempty" protobuf:"bytes,3,rep,name=accessModes,casttype=PersistentVolumeAccessMode"` AccessModes []PersistentVolumeAccessMode `json:"accessModes,omitempty" protobuf:"bytes,3,rep,name=accessModes,casttype=PersistentVolumeAccessMode"`
// ClaimRef is part of a bi-directional binding between PersistentVolume and PersistentVolumeClaim. // claimRef is part of a bi-directional binding between PersistentVolume and PersistentVolumeClaim.
// Expected to be non-nil when bound. // Expected to be non-nil when bound.
// claim.VolumeName is the authoritative bind between PV and PVC. // claim.VolumeName is the authoritative bind between PV and PVC.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#binding // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#binding
// +optional // +optional
ClaimRef *ObjectReference `json:"claimRef,omitempty" protobuf:"bytes,4,opt,name=claimRef"` ClaimRef *ObjectReference `json:"claimRef,omitempty" protobuf:"bytes,4,opt,name=claimRef"`
// What happens to a persistent volume when released from its claim. // persistentVolumeReclaimPolicy defines what happens to a persistent volume when released from its claim.
// Valid options are Retain (default for manually created PersistentVolumes), Delete (default // Valid options are Retain (default for manually created PersistentVolumes), Delete (default
// for dynamically provisioned PersistentVolumes), and Recycle (deprecated). // for dynamically provisioned PersistentVolumes), and Recycle (deprecated).
// Recycle must be supported by the volume plugin underlying this PersistentVolume. // Recycle must be supported by the volume plugin underlying this PersistentVolume.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#reclaiming // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#reclaiming
// +optional // +optional
PersistentVolumeReclaimPolicy PersistentVolumeReclaimPolicy `json:"persistentVolumeReclaimPolicy,omitempty" protobuf:"bytes,5,opt,name=persistentVolumeReclaimPolicy,casttype=PersistentVolumeReclaimPolicy"` PersistentVolumeReclaimPolicy PersistentVolumeReclaimPolicy `json:"persistentVolumeReclaimPolicy,omitempty" protobuf:"bytes,5,opt,name=persistentVolumeReclaimPolicy,casttype=PersistentVolumeReclaimPolicy"`
// Name of StorageClass to which this persistent volume belongs. Empty value // storageClassName is the name of StorageClass to which this persistent volume belongs. Empty value
// means that this volume does not belong to any StorageClass. // means that this volume does not belong to any StorageClass.
// +optional // +optional
StorageClassName string `json:"storageClassName,omitempty" protobuf:"bytes,6,opt,name=storageClassName"` StorageClassName string `json:"storageClassName,omitempty" protobuf:"bytes,6,opt,name=storageClassName"`
// A list of mount options, e.g. ["ro", "soft"]. Not validated - mount will // mountOptions is the list of mount options, e.g. ["ro", "soft"]. Not validated - mount will
// simply fail if one is invalid. // simply fail if one is invalid.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options
// +optional // +optional
@ -358,7 +358,7 @@ type PersistentVolumeSpec struct {
// or to remain in raw block state. Value of Filesystem is implied when not included in spec. // or to remain in raw block state. Value of Filesystem is implied when not included in spec.
// +optional // +optional
VolumeMode *PersistentVolumeMode `json:"volumeMode,omitempty" protobuf:"bytes,8,opt,name=volumeMode,casttype=PersistentVolumeMode"` VolumeMode *PersistentVolumeMode `json:"volumeMode,omitempty" protobuf:"bytes,8,opt,name=volumeMode,casttype=PersistentVolumeMode"`
// NodeAffinity defines constraints that limit what nodes this volume can be accessed from. // nodeAffinity defines constraints that limit what nodes this volume can be accessed from.
// This field influences the scheduling of pods that use this volume. // This field influences the scheduling of pods that use this volume.
// +optional // +optional
NodeAffinity *VolumeNodeAffinity `json:"nodeAffinity,omitempty" protobuf:"bytes,9,opt,name=nodeAffinity"` NodeAffinity *VolumeNodeAffinity `json:"nodeAffinity,omitempty" protobuf:"bytes,9,opt,name=nodeAffinity"`
@ -366,7 +366,7 @@ type PersistentVolumeSpec struct {
// VolumeNodeAffinity defines constraints that limit what nodes this volume can be accessed from. // VolumeNodeAffinity defines constraints that limit what nodes this volume can be accessed from.
type VolumeNodeAffinity struct { type VolumeNodeAffinity struct {
// Required specifies hard node constraints that must be met. // required specifies hard node constraints that must be met.
Required *NodeSelector `json:"required,omitempty" protobuf:"bytes,1,opt,name=required"` Required *NodeSelector `json:"required,omitempty" protobuf:"bytes,1,opt,name=required"`
} }
@ -399,14 +399,14 @@ const (
// PersistentVolumeStatus is the current status of a persistent volume. // PersistentVolumeStatus is the current status of a persistent volume.
type PersistentVolumeStatus struct { type PersistentVolumeStatus struct {
// Phase indicates if a volume is available, bound to a claim, or released by a claim. // phase indicates if a volume is available, bound to a claim, or released by a claim.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#phase // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#phase
// +optional // +optional
Phase PersistentVolumePhase `json:"phase,omitempty" protobuf:"bytes,1,opt,name=phase,casttype=PersistentVolumePhase"` Phase PersistentVolumePhase `json:"phase,omitempty" protobuf:"bytes,1,opt,name=phase,casttype=PersistentVolumePhase"`
// A human-readable message indicating details about why the volume is in this state. // message is a human-readable message indicating details about why the volume is in this state.
// +optional // +optional
Message string `json:"message,omitempty" protobuf:"bytes,2,opt,name=message"` Message string `json:"message,omitempty" protobuf:"bytes,2,opt,name=message"`
// Reason is a brief CamelCase string that describes any failure and is meant // reason is a brief CamelCase string that describes any failure and is meant
// for machine parsing and tidy display in the CLI. // for machine parsing and tidy display in the CLI.
// +optional // +optional
Reason string `json:"reason,omitempty" protobuf:"bytes,3,opt,name=reason"` Reason string `json:"reason,omitempty" protobuf:"bytes,3,opt,name=reason"`
@ -421,7 +421,7 @@ type PersistentVolumeList struct {
// More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
// +optional // +optional
metav1.ListMeta `json:"metadata,omitempty" protobuf:"bytes,1,opt,name=metadata"` metav1.ListMeta `json:"metadata,omitempty" protobuf:"bytes,1,opt,name=metadata"`
// List of persistent volumes. // items is a list of persistent volumes.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes
Items []PersistentVolume `json:"items" protobuf:"bytes,2,rep,name=items"` Items []PersistentVolume `json:"items" protobuf:"bytes,2,rep,name=items"`
} }
@ -437,12 +437,12 @@ type PersistentVolumeClaim struct {
// +optional // +optional
metav1.ObjectMeta `json:"metadata,omitempty" protobuf:"bytes,1,opt,name=metadata"` metav1.ObjectMeta `json:"metadata,omitempty" protobuf:"bytes,1,opt,name=metadata"`
// Spec defines the desired characteristics of a volume requested by a pod author. // spec defines the desired characteristics of a volume requested by a pod author.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
// +optional // +optional
Spec PersistentVolumeClaimSpec `json:"spec,omitempty" protobuf:"bytes,2,opt,name=spec"` Spec PersistentVolumeClaimSpec `json:"spec,omitempty" protobuf:"bytes,2,opt,name=spec"`
// Status represents the current information/status of a persistent volume claim. // status represents the current information/status of a persistent volume claim.
// Read-only. // Read-only.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
// +optional // +optional
@ -458,7 +458,7 @@ type PersistentVolumeClaimList struct {
// More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
// +optional // +optional
metav1.ListMeta `json:"metadata,omitempty" protobuf:"bytes,1,opt,name=metadata"` metav1.ListMeta `json:"metadata,omitempty" protobuf:"bytes,1,opt,name=metadata"`
// A list of persistent volume claims. // items is a list of persistent volume claims.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
Items []PersistentVolumeClaim `json:"items" protobuf:"bytes,2,rep,name=items"` Items []PersistentVolumeClaim `json:"items" protobuf:"bytes,2,rep,name=items"`
} }
@ -466,24 +466,24 @@ type PersistentVolumeClaimList struct {
// PersistentVolumeClaimSpec describes the common attributes of storage devices // PersistentVolumeClaimSpec describes the common attributes of storage devices
// and allows a Source for provider-specific attributes // and allows a Source for provider-specific attributes
type PersistentVolumeClaimSpec struct { type PersistentVolumeClaimSpec struct {
// AccessModes contains the desired access modes the volume should have. // accessModes contains the desired access modes the volume should have.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1
// +optional // +optional
AccessModes []PersistentVolumeAccessMode `json:"accessModes,omitempty" protobuf:"bytes,1,rep,name=accessModes,casttype=PersistentVolumeAccessMode"` AccessModes []PersistentVolumeAccessMode `json:"accessModes,omitempty" protobuf:"bytes,1,rep,name=accessModes,casttype=PersistentVolumeAccessMode"`
// A label query over volumes to consider for binding. // selector is a label query over volumes to consider for binding.
// +optional // +optional
Selector *metav1.LabelSelector `json:"selector,omitempty" protobuf:"bytes,4,opt,name=selector"` Selector *metav1.LabelSelector `json:"selector,omitempty" protobuf:"bytes,4,opt,name=selector"`
// Resources represents the minimum resources the volume should have. // resources represents the minimum resources the volume should have.
// If RecoverVolumeExpansionFailure feature is enabled users are allowed to specify resource requirements // If RecoverVolumeExpansionFailure feature is enabled users are allowed to specify resource requirements
// that are lower than previous value but must still be higher than capacity recorded in the // that are lower than previous value but must still be higher than capacity recorded in the
// status field of the claim. // status field of the claim.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
// +optional // +optional
Resources ResourceRequirements `json:"resources,omitempty" protobuf:"bytes,2,opt,name=resources"` Resources ResourceRequirements `json:"resources,omitempty" protobuf:"bytes,2,opt,name=resources"`
// VolumeName is the binding reference to the PersistentVolume backing this claim. // volumeName is the binding reference to the PersistentVolume backing this claim.
// +optional // +optional
VolumeName string `json:"volumeName,omitempty" protobuf:"bytes,3,opt,name=volumeName"` VolumeName string `json:"volumeName,omitempty" protobuf:"bytes,3,opt,name=volumeName"`
// Name of the StorageClass required by the claim. // storageClassName is the name of the StorageClass required by the claim.
// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1 // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1
// +optional // +optional
StorageClassName *string `json:"storageClassName,omitempty" protobuf:"bytes,5,opt,name=storageClassName"` StorageClassName *string `json:"storageClassName,omitempty" protobuf:"bytes,5,opt,name=storageClassName"`
@ -491,7 +491,7 @@ type PersistentVolumeClaimSpec struct {
// Value of Filesystem is implied when not included in claim spec. // Value of Filesystem is implied when not included in claim spec.
// +optional // +optional
VolumeMode *PersistentVolumeMode `json:"volumeMode,omitempty" protobuf:"bytes,6,opt,name=volumeMode,casttype=PersistentVolumeMode"` VolumeMode *PersistentVolumeMode `json:"volumeMode,omitempty" protobuf:"bytes,6,opt,name=volumeMode,casttype=PersistentVolumeMode"`
// This field can be used to specify either: // dataSource field can be used to specify either:
// * An existing VolumeSnapshot object (snapshot.storage.k8s.io/VolumeSnapshot) // * An existing VolumeSnapshot object (snapshot.storage.k8s.io/VolumeSnapshot)
// * An existing PVC (PersistentVolumeClaim) // * An existing PVC (PersistentVolumeClaim)
// If the provisioner or an external controller can support the specified data source, // If the provisioner or an external controller can support the specified data source,
@ -500,7 +500,7 @@ type PersistentVolumeClaimSpec struct {
// the same contents as the DataSourceRef field. // the same contents as the DataSourceRef field.
// +optional // +optional
DataSource *TypedLocalObjectReference `json:"dataSource,omitempty" protobuf:"bytes,7,opt,name=dataSource"` DataSource *TypedLocalObjectReference `json:"dataSource,omitempty" protobuf:"bytes,7,opt,name=dataSource"`
// Specifies the object from which to populate the volume with data, if a non-empty // dataSourceRef specifies the object from which to populate the volume with data, if a non-empty
// volume is desired. This may be any local object from a non-empty API group (non // volume is desired. This may be any local object from a non-empty API group (non
// core object) or a PersistentVolumeClaim object. // core object) or a PersistentVolumeClaim object.
// When this field is specified, volume binding will only succeed if the type of // When this field is specified, volume binding will only succeed if the type of
@ -556,41 +556,41 @@ const (
type PersistentVolumeClaimCondition struct { type PersistentVolumeClaimCondition struct {
Type PersistentVolumeClaimConditionType `json:"type" protobuf:"bytes,1,opt,name=type,casttype=PersistentVolumeClaimConditionType"` Type PersistentVolumeClaimConditionType `json:"type" protobuf:"bytes,1,opt,name=type,casttype=PersistentVolumeClaimConditionType"`
Status ConditionStatus `json:"status" protobuf:"bytes,2,opt,name=status,casttype=ConditionStatus"` Status ConditionStatus `json:"status" protobuf:"bytes,2,opt,name=status,casttype=ConditionStatus"`
// Last time we probed the condition. // lastProbeTime is the time we probed the condition.
// +optional // +optional
LastProbeTime metav1.Time `json:"lastProbeTime,omitempty" protobuf:"bytes,3,opt,name=lastProbeTime"` LastProbeTime metav1.Time `json:"lastProbeTime,omitempty" protobuf:"bytes,3,opt,name=lastProbeTime"`
// Last time the condition transitioned from one status to another. // lastTransitionTime is the time the condition transitioned from one status to another.
// +optional // +optional
LastTransitionTime metav1.Time `json:"lastTransitionTime,omitempty" protobuf:"bytes,4,opt,name=lastTransitionTime"` LastTransitionTime metav1.Time `json:"lastTransitionTime,omitempty" protobuf:"bytes,4,opt,name=lastTransitionTime"`
// Unique, this should be a short, machine understandable string that gives the reason // 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 // for condition's last transition. If it reports "ResizeStarted" that means the underlying
// persistent volume is being resized. // persistent volume is being resized.
// +optional // +optional
Reason string `json:"reason,omitempty" protobuf:"bytes,5,opt,name=reason"` Reason string `json:"reason,omitempty" protobuf:"bytes,5,opt,name=reason"`
// Human-readable message indicating details about last transition. // message is the human-readable message indicating details about last transition.
// +optional // +optional
Message string `json:"message,omitempty" protobuf:"bytes,6,opt,name=message"` Message string `json:"message,omitempty" protobuf:"bytes,6,opt,name=message"`
} }
// PersistentVolumeClaimStatus is the current status of a persistent volume claim. // PersistentVolumeClaimStatus is the current status of a persistent volume claim.
type PersistentVolumeClaimStatus struct { type PersistentVolumeClaimStatus struct {
// Phase represents the current phase of PersistentVolumeClaim. // phase represents the current phase of PersistentVolumeClaim.
// +optional // +optional
Phase PersistentVolumeClaimPhase `json:"phase,omitempty" protobuf:"bytes,1,opt,name=phase,casttype=PersistentVolumeClaimPhase"` Phase PersistentVolumeClaimPhase `json:"phase,omitempty" protobuf:"bytes,1,opt,name=phase,casttype=PersistentVolumeClaimPhase"`
// AccessModes contains the actual access modes the volume backing the PVC has. // 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 // More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1
// +optional // +optional
AccessModes []PersistentVolumeAccessMode `json:"accessModes,omitempty" protobuf:"bytes,2,rep,name=accessModes,casttype=PersistentVolumeAccessMode"` AccessModes []PersistentVolumeAccessMode `json:"accessModes,omitempty" protobuf:"bytes,2,rep,name=accessModes,casttype=PersistentVolumeAccessMode"`
// Represents the actual resources of the underlying volume. // capacity represents the actual resources of the underlying volume.
// +optional // +optional
Capacity ResourceList `json:"capacity,omitempty" protobuf:"bytes,3,rep,name=capacity,casttype=ResourceList,castkey=ResourceName"` Capacity ResourceList `json:"capacity,omitempty" protobuf:"bytes,3,rep,name=capacity,casttype=ResourceList,castkey=ResourceName"`
// Current Condition of persistent volume claim. If underlying persistent volume is being // conditions is the current Condition of persistent volume claim. If underlying persistent volume is being
// resized then the Condition will be set to 'ResizeStarted'. // resized then the Condition will be set to 'ResizeStarted'.
// +optional // +optional
// +patchMergeKey=type // +patchMergeKey=type
// +patchStrategy=merge // +patchStrategy=merge
Conditions []PersistentVolumeClaimCondition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type" protobuf:"bytes,4,rep,name=conditions"` Conditions []PersistentVolumeClaimCondition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type" protobuf:"bytes,4,rep,name=conditions"`
// The storage resource within AllocatedResources tracks the capacity allocated to a PVC. It may // 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. // 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. // 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 allocatedResources is not set, PVC.spec.resources alone is used for quota calculation.
@ -601,7 +601,7 @@ type PersistentVolumeClaimStatus struct {
// +featureGate=RecoverVolumeExpansionFailure // +featureGate=RecoverVolumeExpansionFailure
// +optional // +optional
AllocatedResources ResourceList `json:"allocatedResources,omitempty" protobuf:"bytes,5,rep,name=allocatedResources,casttype=ResourceList,castkey=ResourceName"` AllocatedResources ResourceList `json:"allocatedResources,omitempty" protobuf:"bytes,5,rep,name=allocatedResources,casttype=ResourceList,castkey=ResourceName"`
// ResizeStatus stores status of resize operation. // resizeStatus stores status of resize operation.
// ResizeStatus is not set by default but when expansion is complete resizeStatus is set to empty // ResizeStatus is not set by default but when expansion is complete resizeStatus is set to empty
// string by resize controller or kubelet. // string by resize controller or kubelet.
// This is an alpha field and requires enabling RecoverVolumeExpansionFailure feature. // This is an alpha field and requires enabling RecoverVolumeExpansionFailure feature.

74
staging/src/k8s.io/api/core/v1/types_swagger_doc_generated.go generated
View File

@ -1261,8 +1261,8 @@ func (ObjectReference) SwaggerDoc() map[string]string {
var map_PersistentVolume = map[string]string{ var map_PersistentVolume = map[string]string{
"": "PersistentVolume (PV) is a storage resource provisioned by an administrator. It is analogous to a node. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes", "": "PersistentVolume (PV) is a storage resource provisioned by an administrator. It is analogous to a node. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes",
"metadata": "Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata", "metadata": "Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata",
"spec": "Spec defines a specification of a persistent volume owned by the cluster. Provisioned by an administrator. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes", "spec": "spec defines a specification of a persistent volume owned by the cluster. Provisioned by an administrator. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes",
"status": "Status represents the current information/status for the persistent volume. Populated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes", "status": "status represents the current information/status for the persistent volume. Populated by the system. Read-only. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes",
} }
func (PersistentVolume) SwaggerDoc() map[string]string { func (PersistentVolume) SwaggerDoc() map[string]string {
@ -1272,8 +1272,8 @@ func (PersistentVolume) SwaggerDoc() map[string]string {
var map_PersistentVolumeClaim = map[string]string{ var map_PersistentVolumeClaim = map[string]string{
"": "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",
"metadata": "Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata", "metadata": "Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata",
"spec": "Spec defines the desired characteristics of a volume requested by a pod author. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims", "spec": "spec defines the desired characteristics of a volume requested by a pod author. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims",
"status": "Status represents the current information/status of a persistent volume claim. Read-only. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims", "status": "status represents the current information/status of a persistent volume claim. Read-only. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims",
} }
func (PersistentVolumeClaim) SwaggerDoc() map[string]string { func (PersistentVolumeClaim) SwaggerDoc() map[string]string {
@ -1282,10 +1282,10 @@ func (PersistentVolumeClaim) SwaggerDoc() map[string]string {
var map_PersistentVolumeClaimCondition = map[string]string{ var map_PersistentVolumeClaimCondition = map[string]string{
"": "PersistentVolumeClaimCondition contails details about state of pvc", "": "PersistentVolumeClaimCondition contails details about state of pvc",
"lastProbeTime": "Last time we probed the condition.", "lastProbeTime": "lastProbeTime is the time we probed the condition.",
"lastTransitionTime": "Last time the condition transitioned from one status to another.", "lastTransitionTime": "lastTransitionTime is the time the condition transitioned from one status to another.",
"reason": "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.", "reason": "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.",
"message": "Human-readable message indicating details about last transition.", "message": "message is the human-readable message indicating details about last transition.",
} }
func (PersistentVolumeClaimCondition) SwaggerDoc() map[string]string { func (PersistentVolumeClaimCondition) SwaggerDoc() map[string]string {
@ -1295,7 +1295,7 @@ func (PersistentVolumeClaimCondition) SwaggerDoc() map[string]string {
var map_PersistentVolumeClaimList = map[string]string{ var map_PersistentVolumeClaimList = map[string]string{
"": "PersistentVolumeClaimList is a list of PersistentVolumeClaim items.", "": "PersistentVolumeClaimList is a list of PersistentVolumeClaim items.",
"metadata": "Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds", "metadata": "Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
"items": "A list of persistent volume claims. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims", "items": "items is a list of persistent volume claims. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims",
} }
func (PersistentVolumeClaimList) SwaggerDoc() map[string]string { func (PersistentVolumeClaimList) SwaggerDoc() map[string]string {
@ -1304,14 +1304,14 @@ func (PersistentVolumeClaimList) SwaggerDoc() map[string]string {
var map_PersistentVolumeClaimSpec = map[string]string{ var map_PersistentVolumeClaimSpec = map[string]string{
"": "PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes", "": "PersistentVolumeClaimSpec describes the common attributes of storage devices and allows a Source for provider-specific attributes",
"accessModes": "AccessModes contains the desired access modes the volume should have. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1", "accessModes": "accessModes contains the desired access modes the volume should have. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1",
"selector": "A label query over volumes to consider for binding.", "selector": "selector is a label query over volumes to consider for binding.",
"resources": "Resources represents the minimum resources the volume should have. If RecoverVolumeExpansionFailure feature is enabled users are allowed to specify resource requirements that are lower than previous value but must still be higher than capacity recorded in the status field of the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources", "resources": "resources represents the minimum resources the volume should have. If RecoverVolumeExpansionFailure feature is enabled users are allowed to specify resource requirements that are lower than previous value but must still be higher than capacity recorded in the status field of the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources",
"volumeName": "VolumeName is the binding reference to the PersistentVolume backing this claim.", "volumeName": "volumeName is the binding reference to the PersistentVolume backing this claim.",
"storageClassName": "Name of the StorageClass required by the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1", "storageClassName": "storageClassName is the name of the StorageClass required by the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1",
"volumeMode": "volumeMode defines what type of volume is required by the claim. Value of Filesystem is implied when not included in claim spec.", "volumeMode": "volumeMode defines what type of volume is required by the claim. Value of Filesystem is implied when not included in claim spec.",
"dataSource": "This field can be used to specify either: * An existing VolumeSnapshot object (snapshot.storage.k8s.io/VolumeSnapshot) * An existing PVC (PersistentVolumeClaim) If the provisioner or an external controller can support the specified data source, it will create a new volume based on the contents of the specified data source. If the AnyVolumeDataSource feature gate is enabled, this field will always have the same contents as the DataSourceRef field.", "dataSource": "dataSource field can be used to specify either: * An existing VolumeSnapshot object (snapshot.storage.k8s.io/VolumeSnapshot) * An existing PVC (PersistentVolumeClaim) If the provisioner or an external controller can support the specified data source, it will create a new volume based on the contents of the specified data source. If the AnyVolumeDataSource feature gate is enabled, this field will always have the same contents as the DataSourceRef field.",
"dataSourceRef": "Specifies the object from which to populate the volume with data, if a non-empty volume is desired. This may be any local object from a non-empty API group (non core object) or a PersistentVolumeClaim object. When this field is specified, volume binding will only succeed if the type of the specified object matches some installed volume populator or dynamic provisioner. This field will replace the functionality of the DataSource field and as such if both fields are non-empty, they must have the same value. For backwards compatibility, both fields (DataSource and DataSourceRef) will be set to the same value automatically if one of them is empty and the other is non-empty. There are two important differences between DataSource and DataSourceRef: * While DataSource only allows two specific types of objects, DataSourceRef\n allows any non-core object, as well as PersistentVolumeClaim objects.\n* While DataSource ignores disallowed values (dropping them), DataSourceRef\n preserves all values, and generates an error if a disallowed value is\n specified.\n(Alpha) Using this field requires the AnyVolumeDataSource feature gate to be enabled.", "dataSourceRef": "dataSourceRef specifies the object from which to populate the volume with data, if a non-empty volume is desired. This may be any local object from a non-empty API group (non core object) or a PersistentVolumeClaim object. When this field is specified, volume binding will only succeed if the type of the specified object matches some installed volume populator or dynamic provisioner. This field will replace the functionality of the DataSource field and as such if both fields are non-empty, they must have the same value. For backwards compatibility, both fields (DataSource and DataSourceRef) will be set to the same value automatically if one of them is empty and the other is non-empty. There are two important differences between DataSource and DataSourceRef: * While DataSource only allows two specific types of objects, DataSourceRef\n allows any non-core object, as well as PersistentVolumeClaim objects.\n* While DataSource ignores disallowed values (dropping them), DataSourceRef\n preserves all values, and generates an error if a disallowed value is\n specified.\n(Alpha) Using this field requires the AnyVolumeDataSource feature gate to be enabled.",
} }
func (PersistentVolumeClaimSpec) SwaggerDoc() map[string]string { func (PersistentVolumeClaimSpec) SwaggerDoc() map[string]string {
@ -1320,12 +1320,12 @@ func (PersistentVolumeClaimSpec) SwaggerDoc() map[string]string {
var map_PersistentVolumeClaimStatus = map[string]string{ var map_PersistentVolumeClaimStatus = map[string]string{
"": "PersistentVolumeClaimStatus is the current status of a persistent volume claim.", "": "PersistentVolumeClaimStatus is the current status of a persistent volume claim.",
"phase": "Phase represents the current phase of PersistentVolumeClaim.", "phase": "phase represents the current phase of PersistentVolumeClaim.",
"accessModes": "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", "accessModes": "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",
"capacity": "Represents the actual resources of the underlying volume.", "capacity": "capacity represents the actual resources of the underlying volume.",
"conditions": "Current Condition of persistent volume claim. If underlying persistent volume is being resized then the Condition will be set to 'ResizeStarted'.", "conditions": "conditions is the current Condition of persistent volume claim. If underlying persistent volume is being resized then the Condition will be set to 'ResizeStarted'.",
"allocatedResources": "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.", "allocatedResources": "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.",
"resizeStatus": "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.", "resizeStatus": "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.",
} }
func (PersistentVolumeClaimStatus) SwaggerDoc() map[string]string { func (PersistentVolumeClaimStatus) SwaggerDoc() map[string]string {
@ -1344,8 +1344,8 @@ func (PersistentVolumeClaimTemplate) SwaggerDoc() map[string]string {
var map_PersistentVolumeClaimVolumeSource = map[string]string{ var map_PersistentVolumeClaimVolumeSource = map[string]string{
"": "PersistentVolumeClaimVolumeSource references the user's PVC in the same namespace. This volume finds the bound PV and mounts that volume for the pod. A PersistentVolumeClaimVolumeSource is, essentially, a wrapper around another type of volume that is owned by someone else (the system).", "": "PersistentVolumeClaimVolumeSource references the user's PVC in the same namespace. This volume finds the bound PV and mounts that volume for the pod. A PersistentVolumeClaimVolumeSource is, essentially, a wrapper around another type of volume that is owned by someone else (the system).",
"claimName": "ClaimName is the name of a PersistentVolumeClaim in the same namespace as the pod using this volume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims", "claimName": "claimName is the name of a PersistentVolumeClaim in the same namespace as the pod using this volume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims",
"readOnly": "Will force the ReadOnly setting in VolumeMounts. Default false.", "readOnly": "readOnly Will force the ReadOnly setting in VolumeMounts. Default false.",
} }
func (PersistentVolumeClaimVolumeSource) SwaggerDoc() map[string]string { func (PersistentVolumeClaimVolumeSource) SwaggerDoc() map[string]string {
@ -1355,7 +1355,7 @@ func (PersistentVolumeClaimVolumeSource) SwaggerDoc() map[string]string {
var map_PersistentVolumeList = map[string]string{ var map_PersistentVolumeList = map[string]string{
"": "PersistentVolumeList is a list of PersistentVolume items.", "": "PersistentVolumeList is a list of PersistentVolume items.",
"metadata": "Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds", "metadata": "Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
"items": "List of persistent volumes. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes", "items": "items is a list of persistent volumes. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes",
} }
func (PersistentVolumeList) SwaggerDoc() map[string]string { func (PersistentVolumeList) SwaggerDoc() map[string]string {
@ -1394,14 +1394,14 @@ func (PersistentVolumeSource) SwaggerDoc() map[string]string {
var map_PersistentVolumeSpec = map[string]string{ var map_PersistentVolumeSpec = map[string]string{
"": "PersistentVolumeSpec is the specification of a persistent volume.", "": "PersistentVolumeSpec is the specification of a persistent volume.",
"capacity": "A description of the persistent volume's resources and capacity. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity", "capacity": "capacity is the description of the persistent volume's resources and capacity. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity",
"accessModes": "AccessModes contains all ways the volume can be mounted. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes", "accessModes": "accessModes contains all ways the volume can be mounted. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes",
"claimRef": "ClaimRef is part of a bi-directional binding between PersistentVolume and PersistentVolumeClaim. Expected to be non-nil when bound. claim.VolumeName is the authoritative bind between PV and PVC. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#binding", "claimRef": "claimRef is part of a bi-directional binding between PersistentVolume and PersistentVolumeClaim. Expected to be non-nil when bound. claim.VolumeName is the authoritative bind between PV and PVC. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#binding",
"persistentVolumeReclaimPolicy": "What happens to a persistent volume when released from its claim. Valid options are Retain (default for manually created PersistentVolumes), Delete (default for dynamically provisioned PersistentVolumes), and Recycle (deprecated). Recycle must be supported by the volume plugin underlying this PersistentVolume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#reclaiming", "persistentVolumeReclaimPolicy": "persistentVolumeReclaimPolicy defines what happens to a persistent volume when released from its claim. Valid options are Retain (default for manually created PersistentVolumes), Delete (default for dynamically provisioned PersistentVolumes), and Recycle (deprecated). Recycle must be supported by the volume plugin underlying this PersistentVolume. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#reclaiming",
"storageClassName": "Name of StorageClass to which this persistent volume belongs. Empty value means that this volume does not belong to any StorageClass.", "storageClassName": "storageClassName is the name of StorageClass to which this persistent volume belongs. Empty value means that this volume does not belong to any StorageClass.",
"mountOptions": "A list of mount options, e.g. [\"ro\", \"soft\"]. Not validated - mount will simply fail if one is invalid. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options", "mountOptions": "mountOptions is the list of mount options, e.g. [\"ro\", \"soft\"]. Not validated - mount will simply fail if one is invalid. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options",
"volumeMode": "volumeMode defines if a volume is intended to be used with a formatted filesystem or to remain in raw block state. Value of Filesystem is implied when not included in spec.", "volumeMode": "volumeMode defines if a volume is intended to be used with a formatted filesystem or to remain in raw block state. Value of Filesystem is implied when not included in spec.",
"nodeAffinity": "NodeAffinity defines constraints that limit what nodes this volume can be accessed from. This field influences the scheduling of pods that use this volume.", "nodeAffinity": "nodeAffinity defines constraints that limit what nodes this volume can be accessed from. This field influences the scheduling of pods that use this volume.",
} }
func (PersistentVolumeSpec) SwaggerDoc() map[string]string { func (PersistentVolumeSpec) SwaggerDoc() map[string]string {
@ -1410,9 +1410,9 @@ func (PersistentVolumeSpec) SwaggerDoc() map[string]string {
var map_PersistentVolumeStatus = map[string]string{ var map_PersistentVolumeStatus = map[string]string{
"": "PersistentVolumeStatus is the current status of a persistent volume.", "": "PersistentVolumeStatus is the current status of a persistent volume.",
"phase": "Phase indicates if a volume is available, bound to a claim, or released by a claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#phase", "phase": "phase indicates if a volume is available, bound to a claim, or released by a claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#phase",
"message": "A human-readable message indicating details about why the volume is in this state.", "message": "message is a human-readable message indicating details about why the volume is in this state.",
"reason": "Reason is a brief CamelCase string that describes any failure and is meant for machine parsing and tidy display in the CLI.", "reason": "reason is a brief CamelCase string that describes any failure and is meant for machine parsing and tidy display in the CLI.",
} }
func (PersistentVolumeStatus) SwaggerDoc() map[string]string { func (PersistentVolumeStatus) SwaggerDoc() map[string]string {
@ -2423,7 +2423,7 @@ func (TypedLocalObjectReference) SwaggerDoc() map[string]string {
var map_Volume = map[string]string{ var map_Volume = map[string]string{
"": "Volume represents a named volume in a pod that may be accessed by any container in the pod.", "": "Volume represents a named volume in a pod that may be accessed by any container in the pod.",
"name": "Volume's name. Must be a DNS_LABEL and unique within the pod. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names", "name": "name of the volume. Must be a DNS_LABEL and unique within the pod. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names",
} }
func (Volume) SwaggerDoc() map[string]string { func (Volume) SwaggerDoc() map[string]string {
@ -2456,7 +2456,7 @@ func (VolumeMount) SwaggerDoc() map[string]string {
var map_VolumeNodeAffinity = map[string]string{ var map_VolumeNodeAffinity = map[string]string{
"": "VolumeNodeAffinity defines constraints that limit what nodes this volume can be accessed from.", "": "VolumeNodeAffinity defines constraints that limit what nodes this volume can be accessed from.",
"required": "Required specifies hard node constraints that must be met.", "required": "required specifies hard node constraints that must be met.",
} }
func (VolumeNodeAffinity) SwaggerDoc() map[string]string { func (VolumeNodeAffinity) SwaggerDoc() map[string]string {