@@ -319,304 +319,3 @@ spec:
319319 storage : true
320320 subresources :
321321 status : {}
322- - additionalPrinterColumns :
323- - description : Indicates if all the individual snapshots in the group are ready
324- to be used to restore a group of volumes.
325- jsonPath : .status.readyToUse
326- name : ReadyToUse
327- type : boolean
328- - description : Determines whether this VolumeGroupSnapshotContent and its physical
329- group snapshot on the underlying storage system should be deleted when its
330- bound VolumeGroupSnapshot is deleted.
331- jsonPath : .spec.deletionPolicy
332- name : DeletionPolicy
333- type : string
334- - description : Name of the CSI driver used to create the physical group snapshot
335- on the underlying storage system.
336- jsonPath : .spec.driver
337- name : Driver
338- type : string
339- - description : Name of the VolumeGroupSnapshotClass from which this group snapshot
340- was (or will be) created.
341- jsonPath : .spec.volumeGroupSnapshotClassName
342- name : VolumeGroupSnapshotClass
343- type : string
344- - description : Namespace of the VolumeGroupSnapshot object to which this VolumeGroupSnapshotContent
345- object is bound.
346- jsonPath : .spec.volumeGroupSnapshotRef.namespace
347- name : VolumeGroupSnapshotNamespace
348- type : string
349- - description : Name of the VolumeGroupSnapshot object to which this VolumeGroupSnapshotContent
350- object is bound.
351- jsonPath : .spec.volumeGroupSnapshotRef.name
352- name : VolumeGroupSnapshot
353- type : string
354- - jsonPath : .metadata.creationTimestamp
355- name : Age
356- type : date
357- name : v1alpha1
358- schema :
359- openAPIV3Schema :
360- description : |-
361- VolumeGroupSnapshotContent represents the actual "on-disk" group snapshot object
362- in the underlying storage system
363- properties :
364- apiVersion :
365- description : |-
366- APIVersion defines the versioned schema of this representation of an object.
367- Servers should convert recognized schemas to the latest internal value, and
368- may reject unrecognized values.
369- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
370- type : string
371- kind :
372- description : |-
373- Kind is a string value representing the REST resource this object represents.
374- Servers may infer this from the endpoint the client submits requests to.
375- Cannot be updated.
376- In CamelCase.
377- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
378- type : string
379- metadata :
380- type : object
381- spec :
382- description : |-
383- Spec defines properties of a VolumeGroupSnapshotContent created by the underlying storage system.
384- Required.
385- properties :
386- deletionPolicy :
387- description : |-
388- DeletionPolicy determines whether this VolumeGroupSnapshotContent and the
389- physical group snapshot on the underlying storage system should be deleted
390- when the bound VolumeGroupSnapshot is deleted.
391- Supported values are "Retain" and "Delete".
392- "Retain" means that the VolumeGroupSnapshotContent and its physical group
393- snapshot on underlying storage system are kept.
394- "Delete" means that the VolumeGroupSnapshotContent and its physical group
395- snapshot on underlying storage system are deleted.
396- For dynamically provisioned group snapshots, this field will automatically
397- be filled in by the CSI snapshotter sidecar with the "DeletionPolicy" field
398- defined in the corresponding VolumeGroupSnapshotClass.
399- For pre-existing snapshots, users MUST specify this field when creating the
400- VolumeGroupSnapshotContent object.
401- Required.
402- enum :
403- - Delete
404- - Retain
405- type : string
406- driver :
407- description : |-
408- Driver is the name of the CSI driver used to create the physical group snapshot on
409- the underlying storage system.
410- This MUST be the same as the name returned by the CSI GetPluginName() call for
411- that driver.
412- Required.
413- type : string
414- source :
415- description : |-
416- Source specifies whether the snapshot is (or should be) dynamically provisioned
417- or already exists, and just requires a Kubernetes object representation.
418- This field is immutable after creation.
419- Required.
420- properties :
421- groupSnapshotHandles :
422- description : |-
423- GroupSnapshotHandles specifies the CSI "group_snapshot_id" of a pre-existing
424- group snapshot and a list of CSI "snapshot_id" of pre-existing snapshots
425- on the underlying storage system for which a Kubernetes object
426- representation was (or should be) created.
427- This field is immutable.
428- properties :
429- volumeGroupSnapshotHandle :
430- description : |-
431- VolumeGroupSnapshotHandle specifies the CSI "group_snapshot_id" of a pre-existing
432- group snapshot on the underlying storage system for which a Kubernetes object
433- representation was (or should be) created.
434- This field is immutable.
435- Required.
436- type : string
437- volumeSnapshotHandles :
438- description : |-
439- VolumeSnapshotHandles is a list of CSI "snapshot_id" of pre-existing
440- snapshots on the underlying storage system for which Kubernetes objects
441- representation were (or should be) created.
442- This field is immutable.
443- Required.
444- items :
445- type : string
446- type : array
447- required :
448- - volumeGroupSnapshotHandle
449- - volumeSnapshotHandles
450- type : object
451- x-kubernetes-validations :
452- - message : groupSnapshotHandles is immutable
453- rule : self == oldSelf
454- volumeHandles :
455- description : |-
456- VolumeHandles is a list of volume handles on the backend to be snapshotted
457- together. It is specified for dynamic provisioning of the VolumeGroupSnapshot.
458- This field is immutable.
459- items :
460- type : string
461- type : array
462- x-kubernetes-validations :
463- - message : volumeHandles is immutable
464- rule : self == oldSelf
465- type : object
466- x-kubernetes-validations :
467- - message : volumeHandles is required once set
468- rule : ' !has(oldSelf.volumeHandles) || has(self.volumeHandles)'
469- - message : groupSnapshotHandles is required once set
470- rule : ' !has(oldSelf.groupSnapshotHandles) || has(self.groupSnapshotHandles)'
471- - message : exactly one of volumeHandles and groupSnapshotHandles must
472- be set
473- rule : (has(self.volumeHandles) && !has(self.groupSnapshotHandles))
474- || (!has(self.volumeHandles) && has(self.groupSnapshotHandles))
475- volumeGroupSnapshotClassName :
476- description : |-
477- VolumeGroupSnapshotClassName is the name of the VolumeGroupSnapshotClass from
478- which this group snapshot was (or will be) created.
479- Note that after provisioning, the VolumeGroupSnapshotClass may be deleted or
480- recreated with different set of values, and as such, should not be referenced
481- post-snapshot creation.
482- For dynamic provisioning, this field must be set.
483- This field may be unset for pre-provisioned snapshots.
484- type : string
485- volumeGroupSnapshotRef :
486- description : |-
487- VolumeGroupSnapshotRef specifies the VolumeGroupSnapshot object to which this
488- VolumeGroupSnapshotContent object is bound.
489- VolumeGroupSnapshot.Spec.VolumeGroupSnapshotContentName field must reference to
490- this VolumeGroupSnapshotContent's name for the bidirectional binding to be valid.
491- For a pre-existing VolumeGroupSnapshotContent object, name and namespace of the
492- VolumeGroupSnapshot object MUST be provided for binding to happen.
493- This field is immutable after creation.
494- Required.
495- properties :
496- apiVersion :
497- description : API version of the referent.
498- type : string
499- fieldPath :
500- description : |-
501- If referring to a piece of an object instead of an entire object, this string
502- should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2].
503- For example, if the object reference is to a container within a pod, this would take on a value like:
504- "spec.containers{name}" (where "name" refers to the name of the container that triggered
505- the event) or if no container name is specified "spec.containers[2]" (container with
506- index 2 in this pod). This syntax is chosen only to have some well-defined way of
507- referencing a part of an object.
508- TODO: this design is not final and this field is subject to change in the future.
509- type : string
510- kind :
511- description : |-
512- Kind of the referent.
513- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
514- type : string
515- name :
516- description : |-
517- Name of the referent.
518- More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
519- type : string
520- namespace :
521- description : |-
522- Namespace of the referent.
523- More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
524- type : string
525- resourceVersion :
526- description : |-
527- Specific resourceVersion to which this reference is made, if any.
528- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
529- type : string
530- uid :
531- description : |-
532- UID of the referent.
533- More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids
534- type : string
535- type : object
536- x-kubernetes-map-type : atomic
537- x-kubernetes-validations :
538- - message : both volumeGroupSnapshotRef.name and volumeGroupSnapshotRef.namespace
539- must be set
540- rule : has(self.name) && has(self.__namespace__)
541- required :
542- - deletionPolicy
543- - driver
544- - source
545- - volumeGroupSnapshotRef
546- type : object
547- status :
548- description : status represents the current information of a group snapshot.
549- properties :
550- creationTime :
551- description : |-
552- CreationTime is the timestamp when the point-in-time group snapshot is taken
553- by the underlying storage system.
554- If not specified, it indicates the creation time is unknown.
555- If not specified, it means the readiness of a group snapshot is unknown.
556- The format of this field is a Unix nanoseconds time encoded as an int64.
557- On Unix, the command date +%s%N returns the current time in nanoseconds
558- since 1970-01-01 00:00:00 UTC.
559- format : int64
560- type : integer
561- error :
562- description : |-
563- Error is the last observed error during group snapshot creation, if any.
564- Upon success after retry, this error field will be cleared.
565- properties :
566- message :
567- description : |-
568- message is a string detailing the encountered error during snapshot
569- creation if specified.
570- NOTE: message may be logged, and it should not contain sensitive
571- information.
572- type : string
573- time :
574- description : time is the timestamp when the error was encountered.
575- format : date-time
576- type : string
577- type : object
578- readyToUse :
579- description : |-
580- ReadyToUse indicates if all the individual snapshots in the group are ready to be
581- used to restore a group of volumes.
582- ReadyToUse becomes true when ReadyToUse of all individual snapshots become true.
583- type : boolean
584- volumeGroupSnapshotHandle :
585- description : |-
586- VolumeGroupSnapshotHandle is a unique id returned by the CSI driver
587- to identify the VolumeGroupSnapshot on the storage system.
588- If a storage system does not provide such an id, the
589- CSI driver can choose to return the VolumeGroupSnapshot name.
590- type : string
591- volumeSnapshotHandlePairList :
592- description : |-
593- VolumeSnapshotHandlePairList is a list of CSI "volume_id" and "snapshot_id"
594- pair returned by the CSI driver to identify snapshots and their source volumes
595- on the storage system.
596- items :
597- description : VolumeSnapshotHandlePair defines a pair of a source
598- volume handle and a snapshot handle
599- properties :
600- snapshotHandle :
601- description : |-
602- SnapshotHandle is a unique id returned by the CSI driver to identify a volume
603- snapshot on the storage system
604- type : string
605- volumeHandle :
606- description : |-
607- VolumeHandle is a unique id returned by the CSI driver to identify a volume
608- on the storage system
609- type : string
610- required :
611- - snapshotHandle
612- - volumeHandle
613- type : object
614- type : array
615- type : object
616- required :
617- - spec
618- type : object
619- served : true
620- storage : false
621- subresources :
622- status : {}
0 commit comments