DataVolume

cdi.kubevirt.io / v1beta1

apiVersion: cdi.kubevirt.io/v1beta1 kind: DataVolume metadata: name: example

apiVersion string

APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind string

Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata object

spec object required

DataVolumeSpec defines the DataVolume type specification

checkpoints []object

Checkpoints is a list of DataVolumeCheckpoints, representing stages in a multistage import.

current string required

Current is the identifier of the snapshot created for this checkpoint.

previous string required

Previous is the identifier of the snapshot from the previous checkpoint.

contentType string

DataVolumeContentType options: "kubevirt", "archive"

enum: kubevirt, archive

finalCheckpoint boolean

FinalCheckpoint indicates whether the current DataVolumeCheckpoint is the final checkpoint.

preallocation boolean

Preallocation controls whether storage for DataVolumes should be allocated in advance.

priorityClassName string

PriorityClassName for Importer, Cloner and Uploader pod

pvc object

PVC is the PVC specification

accessModes []string

accessModes contains the desired access modes the volume should have. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1

dataSource object

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. When the AnyVolumeDataSource feature gate is enabled, dataSource contents will be copied to dataSourceRef, and dataSourceRef contents will be copied to dataSource when dataSourceRef.namespace is not specified. If the namespace is specified, then dataSourceRef will not be copied to dataSource.

apiGroup string

APIGroup is the group for the resource being referenced. If APIGroup is not specified, the specified Kind must be in the core API group. For any other third-party types, APIGroup is required.

kind string required

Kind is the type of resource being referenced

name string required

Name is the name of resource being referenced

dataSourceRef object

dataSourceRef specifies the object from which to populate the volume with data, if a non-empty volume is desired. This may be any 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, when namespace isn't specified in dataSourceRef, 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. When namespace is specified in dataSourceRef, dataSource isn't set to the same value and must be empty. There are three important differences between dataSource and dataSourceRef: * While dataSource only allows two specific types of objects, dataSourceRef allows any non-core object, as well as PersistentVolumeClaim objects. * While dataSource ignores disallowed values (dropping them), dataSourceRef preserves all values, and generates an error if a disallowed value is specified. * While dataSource only allows local objects, dataSourceRef allows objects in any namespaces. (Beta) Using this field requires the AnyVolumeDataSource feature gate to be enabled. (Alpha) Using the namespace field of dataSourceRef requires the CrossNamespaceVolumeDataSource feature gate to be enabled.

apiGroup string

APIGroup is the group for the resource being referenced. If APIGroup is not specified, the specified Kind must be in the core API group. For any other third-party types, APIGroup is required.

kind string required

Kind is the type of resource being referenced

name string required

Name is the name of resource being referenced

namespace string

Namespace is the namespace of resource being referenced Note that when a namespace is specified, a gateway.networking.k8s.io/ReferenceGrant object is required in the referent namespace to allow that namespace's owner to accept the reference. See the ReferenceGrant documentation for details. (Alpha) This field requires the CrossNamespaceVolumeDataSource feature gate to be enabled.

resources object

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

limits object

Limits describes the maximum amount of compute resources allowed. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests object

Requests describes the minimum amount of compute resources required. If Requests is omitted for a container, it defaults to Limits if that is explicitly specified, otherwise to an implementation-defined value. Requests cannot exceed Limits. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

selector object

selector is a label query over volumes to consider for binding.

matchExpressions []object

matchExpressions is a list of label selector requirements. The requirements are ANDed.

key string required

key is the label key that the selector applies to.

operator string required

operator represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists and DoesNotExist.

values []string

values is an array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch.

matchLabels object

matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is "key", the operator is "In", and the values array contains only "value". The requirements are ANDed.

storageClassName string

storageClassName is the name of the StorageClass required by the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1

volumeAttributesClassName string

volumeAttributesClassName may be used to set the VolumeAttributesClass used by this claim. If specified, the CSI driver will create or update the volume with the attributes defined in the corresponding VolumeAttributesClass. This has a different purpose than storageClassName, it can be changed after the claim is created. An empty string value means that no VolumeAttributesClass will be applied to the claim but it's not allowed to reset this field to empty string once it is set. If unspecified and the PersistentVolumeClaim is unbound, the default VolumeAttributesClass will be set by the persistentvolume controller if it exists. If the resource referred to by volumeAttributesClass does not exist, this PersistentVolumeClaim will be set to a Pending state, as reflected by the modifyVolumeStatus field, until such as a resource exists. More info: https://kubernetes.io/docs/concepts/storage/volume-attributes-classes/ (Beta) Using this field requires the VolumeAttributesClass feature gate to be enabled (off by default).

volumeMode string

volumeMode defines what type of volume is required by the claim. Value of Filesystem is implied when not included in claim spec.

volumeName string

volumeName is the binding reference to the PersistentVolume backing this claim.

serviceAccountName string

ServiceAccountName for Importer and Uploader pod

source object

Source is the src of the data for the requested DataVolume

blank object

DataVolumeBlankImage provides the parameters to create a new raw blank image for the PVC

gcs object

DataVolumeSourceGCS provides the parameters to create a Data Volume from an GCS source

secretRef string

SecretRef provides the secret reference needed to access the GCS source

url string required

URL is the url of the GCS source

http object

DataVolumeSourceHTTP can be either an http or https endpoint, with an optional basic auth user name and password, and an optional configmap containing additional CAs

certConfigMap string

CertConfigMap is a configmap reference, containing a Certificate Authority(CA) public key, and a base64 encoded pem certificate

checksum string

Checksum is the expected checksum of the file. Format: "algorithm:hash", e.g., "sha256:1234abcd..." or "md5:5678efgh..." Supported algorithms: md5, sha1, sha256, sha512 If specified, the importer will verify the downloaded content matches this checksum

extraHeaders []string

ExtraHeaders is a list of strings containing extra headers to include with HTTP transfer requests

secretExtraHeaders []string

SecretExtraHeaders is a list of Secret references, each containing an extra HTTP header that may include sensitive information

secretRef string

SecretRef A Secret reference, the secret should contain accessKeyId (user name) base64 encoded, and secretKey (password) also base64 encoded

url string required

URL is the URL of the http(s) endpoint

imageio object

DataVolumeSourceImageIO provides the parameters to create a Data Volume from an imageio source

certConfigMap string

CertConfigMap provides a reference to the CA cert

diskId string required

DiskID provides id of a disk to be imported

insecureSkipVerify boolean

InsecureSkipVerify is a flag to skip certificate verification

secretRef string

SecretRef provides the secret reference needed to access the ovirt-engine

url string required

URL is the URL of the ovirt-engine

pvc object

DataVolumeSourcePVC provides the parameters to create a Data Volume from an existing PVC

name string required

The name of the source PVC

namespace string required

The namespace of the source PVC

registry object

DataVolumeSourceRegistry provides the parameters to create a Data Volume from an registry source

certConfigMap string

CertConfigMap provides a reference to the Registry certs

imageStream string

ImageStream is the name of image stream for import

platform object

Platform describes the minimum runtime requirements of the image

architecture string

Architecture specifies the image target CPU architecture

pullMethod string

PullMethod can be either "pod" (default import), or "node" (node docker cache based import)

secretRef string

SecretRef provides the secret reference needed to access the Registry source

url string

URL is the url of the registry source (starting with the scheme: docker, oci-archive)

s3 object

DataVolumeSourceS3 provides the parameters to create a Data Volume from an S3 source

certConfigMap string

CertConfigMap is a configmap reference, containing a Certificate Authority(CA) public key, and a base64 encoded pem certificate

secretRef string

SecretRef provides the secret reference needed to access the S3 source

url string required

URL is the url of the S3 source

snapshot object

DataVolumeSourceSnapshot provides the parameters to create a Data Volume from an existing VolumeSnapshot

name string required

The name of the source VolumeSnapshot

namespace string required

The namespace of the source VolumeSnapshot

upload object

DataVolumeSourceUpload provides the parameters to create a Data Volume by uploading the source

vddk object

DataVolumeSourceVDDK provides the parameters to create a Data Volume from a Vmware source

backingFile string

BackingFile is the path to the virtual hard disk to migrate from vCenter/ESXi

extraArgs string

ExtraArgs is a reference to a ConfigMap containing extra arguments to pass directly to the VDDK library

initImageURL string

InitImageURL is an optional URL to an image containing an extracted VDDK library, overrides v2v-vmware config map

secretRef string

SecretRef provides a reference to a secret containing the username and password needed to access the vCenter or ESXi host

thumbprint string

Thumbprint is the certificate thumbprint of the vCenter or ESXi host

url string

URL is the URL of the vCenter or ESXi host with the VM to migrate

uuid string

UUID is the UUID of the virtual machine that the backing file is attached to in vCenter/ESXi

sourceRef object

SourceRef is an indirect reference to the source of data for the requested DataVolume

kind string required

The kind of the source reference, currently only "DataSource" is supported

name string required

The name of the source reference

namespace string

The namespace of the source reference, defaults to the DataVolume namespace

storage object

Storage is the requested storage specification

accessModes []string

AccessModes contains the desired access modes the volume should have. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1

dataSource object

This field can be used to specify either: * An existing VolumeSnapshot object (snapshot.storage.k8s.io/VolumeSnapshot) * An existing PVC (PersistentVolumeClaim) * An existing custom resource that implements data population (Alpha) In order to use custom resource types that implement data population, the AnyVolumeDataSource feature gate must be enabled. 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.

apiGroup string

APIGroup is the group for the resource being referenced. If APIGroup is not specified, the specified Kind must be in the core API group. For any other third-party types, APIGroup is required.

kind string required

Kind is the type of resource being referenced

name string required

Name is the name of resource being referenced

dataSourceRef object

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 allows any non-core object, as well as PersistentVolumeClaim objects. * While DataSource ignores disallowed values (dropping them), DataSourceRef preserves all values, and generates an error if a disallowed value is specified. (Beta) Using this field requires the AnyVolumeDataSource feature gate to be enabled.

apiGroup string

APIGroup is the group for the resource being referenced. If APIGroup is not specified, the specified Kind must be in the core API group. For any other third-party types, APIGroup is required.

kind string required

Kind is the type of resource being referenced

name string required

Name is the name of resource being referenced

namespace string

resources object

Resources represents the minimum resources the volume should have. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources

limits object

Limits describes the maximum amount of compute resources allowed. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests object

selector object

A label query over volumes to consider for binding.

matchExpressions []object

matchExpressions is a list of label selector requirements. The requirements are ANDed.

key string required

key is the label key that the selector applies to.

operator string required

operator represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists and DoesNotExist.

values []string

matchLabels object

storageClassName string

Name of the StorageClass required by the claim. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1

volumeMode string

volumeMode defines what type of volume is required by the claim. Value of Filesystem is implied when not included in claim spec.

volumeName string

VolumeName is the binding reference to the PersistentVolume backing this claim.

status object

DataVolumeStatus contains the current status of the DataVolume

claimName string

ClaimName is the name of the underlying PVC used by the DataVolume.

conditions []object

lastHeartbeatTime string

format: date-time

lastTransitionTime string

format: date-time

message string

reason string

status string required

type string required

DataVolumeConditionType is the string representation of known condition types

phase string

Phase is the current phase of the data volume

progress string

DataVolumeProgress is the current progress of the DataVolume transfer operation. Value between 0 and 100 inclusive, N/A if not available

restartCount integer

RestartCount is the number of times the pod populating the DataVolume has restarted

format: int32

No matches. Try .spec.checkpoints for an exact path