k8s.io/kubernetes@v1.31.0-alpha.0.0.20240520171757-56147500dadc/cluster/addons/volumesnapshots/crd/snapshot.storage.k8s.io_volumesnapshotclasses.yaml (about)

     1  ---
     2  apiVersion: apiextensions.k8s.io/v1
     3  kind: CustomResourceDefinition
     4  metadata:
     5    labels:
     6      addonmanager.kubernetes.io/mode: Reconcile
     7    annotations:
     8      controller-gen.kubebuilder.io/version: v0.8.0
     9      api-approved.kubernetes.io: "https://github.com/kubernetes-csi/external-snapshotter/pull/665"
    10    creationTimestamp: null
    11    name: volumesnapshotclasses.snapshot.storage.k8s.io
    12  spec:
    13    group: snapshot.storage.k8s.io
    14    names:
    15      kind: VolumeSnapshotClass
    16      listKind: VolumeSnapshotClassList
    17      plural: volumesnapshotclasses
    18      shortNames:
    19        - vsclass
    20        - vsclasses
    21      singular: volumesnapshotclass
    22    scope: Cluster
    23    versions:
    24      - additionalPrinterColumns:
    25          - jsonPath: .driver
    26            name: Driver
    27            type: string
    28          - description: Determines whether a VolumeSnapshotContent created through the
    29              VolumeSnapshotClass should be deleted when its bound VolumeSnapshot is deleted.
    30            jsonPath: .deletionPolicy
    31            name: DeletionPolicy
    32            type: string
    33          - jsonPath: .metadata.creationTimestamp
    34            name: Age
    35            type: date
    36        name: v1
    37        schema:
    38          openAPIV3Schema:
    39            description: VolumeSnapshotClass specifies parameters that a underlying storage
    40              system uses when creating a volume snapshot. A specific VolumeSnapshotClass
    41              is used by specifying its name in a VolumeSnapshot object. VolumeSnapshotClasses
    42              are non-namespaced
    43            properties:
    44              apiVersion:
    45                description: 'APIVersion defines the versioned schema of this representation
    46                of an object. Servers should convert recognized schemas to the latest
    47                internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
    48                type: string
    49              deletionPolicy:
    50                description: deletionPolicy determines whether a VolumeSnapshotContent
    51                  created through the VolumeSnapshotClass should be deleted when its bound
    52                  VolumeSnapshot is deleted. Supported values are "Retain" and "Delete".
    53                  "Retain" means that the VolumeSnapshotContent and its physical snapshot
    54                  on underlying storage system are kept. "Delete" means that the VolumeSnapshotContent
    55                  and its physical snapshot on underlying storage system are deleted.
    56                  Required.
    57                enum:
    58                  - Delete
    59                  - Retain
    60                type: string
    61              driver:
    62                description: driver is the name of the storage driver that handles this
    63                  VolumeSnapshotClass. Required.
    64                type: string
    65              kind:
    66                description: 'Kind is a string value representing the REST resource this
    67                object represents. Servers may infer this from the endpoint the client
    68                submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds'
    69                type: string
    70              parameters:
    71                additionalProperties:
    72                  type: string
    73                description: parameters is a key-value map with storage driver specific
    74                  parameters for creating snapshots. These values are opaque to Kubernetes.
    75                type: object
    76            required:
    77              - deletionPolicy
    78              - driver
    79            type: object
    80        served: true
    81        storage: true
    82        subresources: {}
    83      - additionalPrinterColumns:
    84          - jsonPath: .driver
    85            name: Driver
    86            type: string
    87          - description: Determines whether a VolumeSnapshotContent created through the VolumeSnapshotClass should be deleted when its bound VolumeSnapshot is deleted.
    88            jsonPath: .deletionPolicy
    89            name: DeletionPolicy
    90            type: string
    91          - jsonPath: .metadata.creationTimestamp
    92            name: Age
    93            type: date
    94        name: v1beta1
    95        # This indicates the v1beta1 version of the custom resource is deprecated.
    96        # API requests to this version receive a warning in the server response.
    97        deprecated: true
    98        # This overrides the default warning returned to clients making v1beta1 API requests.
    99        deprecationWarning: "snapshot.storage.k8s.io/v1beta1 VolumeSnapshotClass is deprecated; use snapshot.storage.k8s.io/v1 VolumeSnapshotClass"
   100        schema:
   101          openAPIV3Schema:
   102            description: VolumeSnapshotClass specifies parameters that a underlying storage system uses when creating a volume snapshot. A specific VolumeSnapshotClass is used by specifying its name in a VolumeSnapshot object. VolumeSnapshotClasses are non-namespaced
   103            properties:
   104              apiVersion:
   105                description: 'APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources'
   106                type: string
   107              deletionPolicy:
   108                description: deletionPolicy determines whether a VolumeSnapshotContent created through the VolumeSnapshotClass should be deleted when its bound VolumeSnapshot is deleted. Supported values are "Retain" and "Delete". "Retain" means that the VolumeSnapshotContent and its physical snapshot on underlying storage system are kept. "Delete" means that the VolumeSnapshotContent and its physical snapshot on underlying storage system are deleted. Required.
   109                enum:
   110                  - Delete
   111                  - Retain
   112                type: string
   113              driver:
   114                description: driver is the name of the storage driver that handles this VolumeSnapshotClass. Required.
   115                type: string
   116              kind:
   117                description: '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'
   118                type: string
   119              parameters:
   120                additionalProperties:
   121                  type: string
   122                description: parameters is a key-value map with storage driver specific parameters for creating snapshots. These values are opaque to Kubernetes.
   123                type: object
   124            required:
   125              - deletionPolicy
   126              - driver
   127            type: object
   128        served: false
   129        storage: false
   130        subresources: {}
   131  status:
   132    acceptedNames:
   133      kind: ""
   134      plural: ""
   135    conditions: []
   136    storedVersions: []