blob: 51778d183d6f01e00459923544fa842072465b8f [file] [log] [blame]
Matteo Scandoloa4285862020-12-01 18:10:10 -08001/*
2Copyright The Kubernetes Authors.
3
4Licensed under the Apache License, Version 2.0 (the "License");
5you may not use this file except in compliance with the License.
6You may obtain a copy of the License at
7
8 http://www.apache.org/licenses/LICENSE-2.0
9
10Unless required by applicable law or agreed to in writing, software
11distributed under the License is distributed on an "AS IS" BASIS,
12WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13See the License for the specific language governing permissions and
14limitations under the License.
15*/
16
17package v1alpha1
18
19// This file contains a collection of methods that can be used from go-restful to
20// generate Swagger API documentation for its models. Please read this PR for more
21// information on the implementation: https://github.com/emicklei/go-restful/pull/215
22//
23// TODOs are ignored from the parser (e.g. TODO(andronat):... || TODO:...) if and only if
24// they are on one line! For multiple line or blocks that you want to ignore use ---.
25// Any context after a --- is ignored.
26//
27// Those methods can be generated by using hack/update-generated-swagger-docs.sh
28
29// AUTO-GENERATED FUNCTIONS START HERE. DO NOT EDIT.
30var map_CSIStorageCapacity = map[string]string{
31 "": "CSIStorageCapacity stores the result of one CSI GetCapacity call. For a given StorageClass, this describes the available capacity in a particular topology segment. This can be used when considering where to instantiate new PersistentVolumes.\n\nFor example this can express things like: - StorageClass \"standard\" has \"1234 GiB\" available in \"topology.kubernetes.io/zone=us-east1\" - StorageClass \"localssd\" has \"10 GiB\" available in \"kubernetes.io/hostname=knode-abc123\"\n\nThe following three cases all imply that no capacity is available for a certain combination: - no object exists with suitable topology and storage class name - such an object exists, but the capacity is unset - such an object exists, but the capacity is zero\n\nThe producer of these objects can decide which approach is more suitable.\n\nThis is an alpha feature and only available when the CSIStorageCapacity feature is enabled.",
32 "metadata": "Standard object's metadata. The name has no particular meaning. It must be be a DNS subdomain (dots allowed, 253 characters). To ensure that there are no conflicts with other CSI drivers on the cluster, the recommendation is to use csisc-<uuid>, a generated name, or a reverse-domain name which ends with the unique CSI driver name.\n\nObjects are namespaced.\n\nMore info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata",
33 "nodeTopology": "NodeTopology defines which nodes have access to the storage for which capacity was reported. If not set, the storage is not accessible from any node in the cluster. If empty, the storage is accessible from all nodes. This field is immutable.",
34 "storageClassName": "The name of the StorageClass that the reported capacity applies to. It must meet the same requirements as the name of a StorageClass object (non-empty, DNS subdomain). If that object no longer exists, the CSIStorageCapacity object is obsolete and should be removed by its creator. This field is immutable.",
35 "capacity": "Capacity is the value reported by the CSI driver in its GetCapacityResponse for a GetCapacityRequest with topology and parameters that match the previous fields.\n\nThe semantic is currently (CSI spec 1.2) defined as: The available capacity, in bytes, of the storage that can be used to provision volumes. If not set, that information is currently unavailable and treated like zero capacity.",
36}
37
38func (CSIStorageCapacity) SwaggerDoc() map[string]string {
39 return map_CSIStorageCapacity
40}
41
42var map_CSIStorageCapacityList = map[string]string{
43 "": "CSIStorageCapacityList is a collection of CSIStorageCapacity objects.",
44 "metadata": "Standard list metadata More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata",
45 "items": "Items is the list of CSIStorageCapacity objects.",
46}
47
48func (CSIStorageCapacityList) SwaggerDoc() map[string]string {
49 return map_CSIStorageCapacityList
50}
51
52var map_VolumeAttachment = map[string]string{
53 "": "VolumeAttachment captures the intent to attach or detach the specified volume to/from the specified node.\n\nVolumeAttachment objects are non-namespaced.",
54 "metadata": "Standard object metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata",
55 "spec": "Specification of the desired attach/detach volume behavior. Populated by the Kubernetes system.",
56 "status": "Status of the VolumeAttachment request. Populated by the entity completing the attach or detach operation, i.e. the external-attacher.",
57}
58
59func (VolumeAttachment) SwaggerDoc() map[string]string {
60 return map_VolumeAttachment
61}
62
63var map_VolumeAttachmentList = map[string]string{
64 "": "VolumeAttachmentList is a collection of VolumeAttachment objects.",
65 "metadata": "Standard list metadata More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata",
66 "items": "Items is the list of VolumeAttachments",
67}
68
69func (VolumeAttachmentList) SwaggerDoc() map[string]string {
70 return map_VolumeAttachmentList
71}
72
73var map_VolumeAttachmentSource = map[string]string{
74 "": "VolumeAttachmentSource represents a volume that should be attached. Right now only PersistenVolumes can be attached via external attacher, in future we may allow also inline volumes in pods. Exactly one member can be set.",
75 "persistentVolumeName": "Name of the persistent volume to attach.",
76}
77
78func (VolumeAttachmentSource) SwaggerDoc() map[string]string {
79 return map_VolumeAttachmentSource
80}
81
82var map_VolumeAttachmentSpec = map[string]string{
83 "": "VolumeAttachmentSpec is the specification of a VolumeAttachment request.",
84 "attacher": "Attacher indicates the name of the volume driver that MUST handle this request. This is the name returned by GetPluginName().",
85 "source": "Source represents the volume that should be attached.",
86 "nodeName": "The node that the volume should be attached to.",
87}
88
89func (VolumeAttachmentSpec) SwaggerDoc() map[string]string {
90 return map_VolumeAttachmentSpec
91}
92
93var map_VolumeAttachmentStatus = map[string]string{
94 "": "VolumeAttachmentStatus is the status of a VolumeAttachment request.",
95 "attached": "Indicates the volume is successfully attached. This field must only be set by the entity completing the attach operation, i.e. the external-attacher.",
96 "attachmentMetadata": "Upon successful attach, this field is populated with any information returned by the attach operation that must be passed into subsequent WaitForAttach or Mount calls. This field must only be set by the entity completing the attach operation, i.e. the external-attacher.",
97 "attachError": "The last error encountered during attach operation, if any. This field must only be set by the entity completing the attach operation, i.e. the external-attacher.",
98 "detachError": "The last error encountered during detach operation, if any. This field must only be set by the entity completing the detach operation, i.e. the external-attacher.",
99}
100
101func (VolumeAttachmentStatus) SwaggerDoc() map[string]string {
102 return map_VolumeAttachmentStatus
103}
104
105var map_VolumeError = map[string]string{
106 "": "VolumeError captures an error encountered during a volume operation.",
107 "time": "Time the error was encountered.",
108 "message": "String detailing the error encountered during Attach or Detach operation. This string maybe logged, so it should not contain sensitive information.",
109}
110
111func (VolumeError) SwaggerDoc() map[string]string {
112 return map_VolumeError
113}
114
115// AUTO-GENERATED FUNCTIONS END HERE