create Core V1Persistent Volume
POST {{baseUrl}}/api/v1/persistentvolumes?dryRun=<string>&fieldManager=<string>&fieldValidation=<string>&pretty=<string>
create a PersistentVolume
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
dryRun | string | When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed | |
fieldManager | string | fieldManager is a name associated with the actor or entity that is making these changes. The value must be less than or 128 characters long, and only contain printable characters, as defined by https://golang.org/pkg/unicode/#IsPrint. | |
fieldValidation | string | fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. | |
pretty | string | If 'true', then the output is pretty printed. |
Request Body
{"apiVersion"=>"<string>", "kind"=>"<string>", "metadata"=>{"annotations"=>{"sunt_e60"=>"<string>", "sitd22"=>"<string>", "mollit_feb"=>"<string>"}, "creationTimestamp"=>"<dateTime>", "deletionGracePeriodSeconds"=>"<long>", "deletionTimestamp"=>"<dateTime>", "finalizers"=>["<string>", "<string>"], "generateName"=>"<string>", "generation"=>"<long>", "labels"=>{"nisic00"=>"<string>", "culpa13e"=>"<string>", "reprehenderit__ea"=>"<string>", "ullamco5"=>"<string>"}, "managedFields"=>[{"apiVersion"=>"<string>", "fieldsType"=>"<string>", "manager"=>"<string>", "operation"=>"<string>", "subresource"=>"<string>", "time"=>"<dateTime>"}, {"apiVersion"=>"<string>", "fieldsType"=>"<string>", "manager"=>"<string>", "operation"=>"<string>", "subresource"=>"<string>", "time"=>"<dateTime>"}], "name"=>"<string>", "namespace"=>"<string>", "ownerReferences"=>[{"apiVersion"=>"<string>", "kind"=>"<string>", "name"=>"<string>", "uid"=>"<string>", "blockOwnerDeletion"=>"<boolean>", "controller"=>"<boolean>"}, {"apiVersion"=>"<string>", "kind"=>"<string>", "name"=>"<string>", "uid"=>"<string>", "blockOwnerDeletion"=>"<boolean>", "controller"=>"<boolean>"}], "resourceVersion"=>"<string>", "selfLink"=>"<string>", "uid"=>"<string>"}, "spec"=>{"accessModes"=>["<string>", "<string>"], "awsElasticBlockStore"=>{"volumeID"=>"<string>", "fsType"=>"<string>", "partition"=>"<integer>", "readOnly"=>"<boolean>"}, "azureDisk"=>{"diskName"=>"<string>", "diskURI"=>"<string>", "cachingMode"=>"<string>", "fsType"=>"<string>", "kind"=>"<string>", "readOnly"=>"<boolean>"}, "azureFile"=>{"secretName"=>"<string>", "shareName"=>"<string>", "readOnly"=>"<boolean>", "secretNamespace"=>"<string>"}, "capacity"=>{"aliqua_934"=>"<string>", "amet889"=>"<string>"}, "cephfs"=>{"monitors"=>["<string>", "<string>"], "path"=>"<string>", "readOnly"=>"<boolean>", "secretFile"=>"<string>", "secretRef"=>{"name"=>"<string>", "namespace"=>"<string>"}, "user"=>"<string>"}, "cinder"=>{"volumeID"=>"<string>", "fsType"=>"<string>", "readOnly"=>"<boolean>", "secretRef"=>{"name"=>"<string>", "namespace"=>"<string>"}}, "claimRef"=>{"apiVersion"=>"<string>", "fieldPath"=>"<string>", "kind"=>"<string>", "name"=>"<string>", "namespace"=>"<string>", "resourceVersion"=>"<string>", "uid"=>"<string>"}, "csi"=>{"driver"=>"<string>", "volumeHandle"=>"<string>", "controllerExpandSecretRef"=>{"name"=>"<string>", "namespace"=>"<string>"}, "controllerPublishSecretRef"=>{"name"=>"<string>", "namespace"=>"<string>"}, "fsType"=>"<string>", "nodeExpandSecretRef"=>{"name"=>"<string>", "namespace"=>"<string>"}, "nodePublishSecretRef"=>{"name"=>"<string>", "namespace"=>"<string>"}, "nodeStageSecretRef"=>{"name"=>"<string>", "namespace"=>"<string>"}, "readOnly"=>"<boolean>", "volumeAttributes"=>{"incididunt_b"=>"<string>", "dolor21e"=>"<string>"}}, "fc"=>{"fsType"=>"<string>", "lun"=>"<integer>", "readOnly"=>"<boolean>", "targetWWNs"=>["<string>", "<string>"], "wwids"=>["<string>", "<string>"]}, "flexVolume"=>{"driver"=>"<string>", "fsType"=>"<string>", "options"=>{"do_32e"=>"<string>", "consectetur1"=>"<string>", "sint_c"=>"<string>"}, "readOnly"=>"<boolean>", "secretRef"=>{"name"=>"<string>", "namespace"=>"<string>"}}, "flocker"=>{"datasetName"=>"<string>", "datasetUUID"=>"<string>"}, "gcePersistentDisk"=>{"pdName"=>"<string>", "fsType"=>"<string>", "partition"=>"<integer>", "readOnly"=>"<boolean>"}, "glusterfs"=>{"endpoints"=>"<string>", "path"=>"<string>", "endpointsNamespace"=>"<string>", "readOnly"=>"<boolean>"}, "hostPath"=>{"path"=>"<string>", "type"=>"<string>"}, "iscsi"=>{"targetPortal"=>"<string>", "iqn"=>"<string>", "lun"=>"<integer>", "chapAuthDiscovery"=>"<boolean>", "chapAuthSession"=>"<boolean>", "fsType"=>"<string>", "initiatorName"=>"<string>", "iscsiInterface"=>"<string>", "portals"=>["<string>", "<string>"], "readOnly"=>"<boolean>", "secretRef"=>{"name"=>"<string>", "namespace"=>"<string>"}}, "local"=>{"path"=>"<string>", "fsType"=>"<string>"}, "mountOptions"=>["<string>", "<string>"], "nfs"=>{"server"=>"<string>", "path"=>"<string>", "readOnly"=>"<boolean>"}, "nodeAffinity"=>{"required"=>{"nodeSelectorTerms"=>[{"matchExpressions"=>[{"key"=>"<string>", "operator"=>"<string>", "values"=>["<string>", "<string>"]}, {"key"=>"<string>", "operator"=>"<string>", "values"=>["<string>", "<string>"]}], "matchFields"=>[{"key"=>"<string>", "operator"=>"<string>", "values"=>["<string>", "<string>"]}, {"key"=>"<string>", "operator"=>"<string>", "values"=>["<string>", "<string>"]}]}, {"matchExpressions"=>[{"key"=>"<string>", "operator"=>"<string>", "values"=>["<string>", "<string>"]}, {"key"=>"<string>", "operator"=>"<string>", "values"=>["<string>", "<string>"]}], "matchFields"=>[{"key"=>"<string>", "operator"=>"<string>", "values"=>["<string>", "<string>"]}, {"key"=>"<string>", "operator"=>"<string>", "values"=>["<string>", "<string>"]}]}]}}, "persistentVolumeReclaimPolicy"=>"<string>", "photonPersistentDisk"=>{"pdID"=>"<string>", "fsType"=>"<string>"}, "portworxVolume"=>{"volumeID"=>"<string>", "fsType"=>"<string>", "readOnly"=>"<boolean>"}, "quobyte"=>{"registry"=>"<string>", "volume"=>"<string>", "group"=>"<string>", "readOnly"=>"<boolean>", "tenant"=>"<string>", "user"=>"<string>"}, "rbd"=>{"monitors"=>["<string>", "<string>"], "image"=>"<string>", "fsType"=>"<string>", "keyring"=>"<string>", "pool"=>"<string>", "readOnly"=>"<boolean>", "secretRef"=>{"name"=>"<string>", "namespace"=>"<string>"}, "user"=>"<string>"}, "scaleIO"=>{"gateway"=>"<string>", "system"=>"<string>", "secretRef"=>{"name"=>"<string>", "namespace"=>"<string>"}, "fsType"=>"<string>", "protectionDomain"=>"<string>", "readOnly"=>"<boolean>", "sslEnabled"=>"<boolean>", "storageMode"=>"<string>", "storagePool"=>"<string>", "volumeName"=>"<string>"}, "storageClassName"=>"<string>", "storageos"=>{"fsType"=>"<string>", "readOnly"=>"<boolean>", "secretRef"=>{"apiVersion"=>"<string>", "fieldPath"=>"<string>", "kind"=>"<string>", "name"=>"<string>", "namespace"=>"<string>", "resourceVersion"=>"<string>", "uid"=>"<string>"}, "volumeName"=>"<string>", "volumeNamespace"=>"<string>"}, "volumeMode"=>"<string>", "vsphereVolume"=>{"volumePath"=>"<string>", "fsType"=>"<string>", "storagePolicyID"=>"<string>", "storagePolicyName"=>"<string>"}}, "status"=>{"lastPhaseTransitionTime"=>"<dateTime>", "message"=>"<string>", "phase"=>"<string>", "reason"=>"<string>"}}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: Created
{"apiVersion":"\u003cstring\u003e","kind":"\u003cstring\u003e","metadata":{"annotations":{"sunt_e60":"\u003cstring\u003e","sitd22":"\u003cstring\u003e","mollit_feb":"\u003cstring\u003e"},"creationTimestamp":"\u003cdateTime\u003e","deletionGracePeriodSeconds":"\u003clong\u003e","deletionTimestamp":"\u003cdateTime\u003e","finalizers":["\u003cstring\u003e","\u003cstring\u003e"],"generateName":"\u003cstring\u003e","generation":"\u003clong\u003e","labels":{"nisic00":"\u003cstring\u003e","culpa13e":"\u003cstring\u003e","reprehenderit__ea":"\u003cstring\u003e","ullamco5":"\u003cstring\u003e"},"managedFields":[{"apiVersion":"\u003cstring\u003e","fieldsType":"\u003cstring\u003e","fieldsV1":{},"manager":"\u003cstring\u003e","operation":"\u003cstring\u003e","subresource":"\u003cstring\u003e","time":"\u003cdateTime\u003e"},{"apiVersion":"\u003cstring\u003e","fieldsType":"\u003cstring\u003e","fieldsV1":{},"manager":"\u003cstring\u003e","operation":"\u003cstring\u003e","subresource":"\u003cstring\u003e","time":"\u003cdateTime\u003e"}],"name":"\u003cstring\u003e","namespace":"\u003cstring\u003e","ownerReferences":[{"apiVersion":"\u003cstring\u003e","kind":"\u003cstring\u003e","name":"\u003cstring\u003e","uid":"\u003cstring\u003e","blockOwnerDeletion":"\u003cboolean\u003e","controller":"\u003cboolean\u003e"},{"apiVersion":"\u003cstring\u003e","kind":"\u003cstring\u003e","name":"\u003cstring\u003e","uid":"\u003cstring\u003e","blockOwnerDeletion":"\u003cboolean\u003e","controller":"\u003cboolean\u003e"}],"resourceVersion":"\u003cstring\u003e","selfLink":"\u003cstring\u003e","uid":"\u003cstring\u003e"},"spec":{"accessModes":["\u003cstring\u003e","\u003cstring\u003e"],"awsElasticBlockStore":{"volumeID":"\u003cstring\u003e","fsType":"\u003cstring\u003e","partition":"\u003cinteger\u003e","readOnly":"\u003cboolean\u003e"},"azureDisk":{"diskName":"\u003cstring\u003e","diskURI":"\u003cstring\u003e","cachingMode":"\u003cstring\u003e","fsType":"\u003cstring\u003e","kind":"\u003cstring\u003e","readOnly":"\u003cboolean\u003e"},"azureFile":{"secretName":"\u003cstring\u003e","shareName":"\u003cstring\u003e","readOnly":"\u003cboolean\u003e","secretNamespace":"\u003cstring\u003e"},"capacity":{"aliqua_934":"\u003cstring\u003e","amet889":"\u003cstring\u003e"},"cephfs":{"monitors":["\u003cstring\u003e","\u003cstring\u003e"],"path":"\u003cstring\u003e","readOnly":"\u003cboolean\u003e","secretFile":"\u003cstring\u003e","secretRef":{"name":"\u003cstring\u003e","namespace":"\u003cstring\u003e"},"user":"\u003cstring\u003e"},"cinder":{"volumeID":"\u003cstring\u003e","fsType":"\u003cstring\u003e","readOnly":"\u003cboolean\u003e","secretRef":{"name":"\u003cstring\u003e","namespace":"\u003cstring\u003e"}},"claimRef":{"apiVersion":"\u003cstring\u003e","fieldPath":"\u003cstring\u003e","kind":"\u003cstring\u003e","name":"\u003cstring\u003e","namespace":"\u003cstring\u003e","resourceVersion":"\u003cstring\u003e","uid":"\u003cstring\u003e"},"csi":{"driver":"\u003cstring\u003e","volumeHandle":"\u003cstring\u003e","controllerExpandSecretRef":{"name":"\u003cstring\u003e","namespace":"\u003cstring\u003e"},"controllerPublishSecretRef":{"name":"\u003cstring\u003e","namespace":"\u003cstring\u003e"},"fsType":"\u003cstring\u003e","nodeExpandSecretRef":{"name":"\u003cstring\u003e","namespace":"\u003cstring\u003e"},"nodePublishSecretRef":{"name":"\u003cstring\u003e","namespace":"\u003cstring\u003e"},"nodeStageSecretRef":{"name":"\u003cstring\u003e","namespace":"\u003cstring\u003e"},"readOnly":"\u003cboolean\u003e","volumeAttributes":{"incididunt_b":"\u003cstring\u003e","dolor21e":"\u003cstring\u003e"}},"fc":{"fsType":"\u003cstring\u003e","lun":"\u003cinteger\u003e","readOnly":"\u003cboolean\u003e","targetWWNs":["\u003cstring\u003e","\u003cstring\u003e"],"wwids":["\u003cstring\u003e","\u003cstring\u003e"]},"flexVolume":{"driver":"\u003cstring\u003e","fsType":"\u003cstring\u003e","options":{"do_32e":"\u003cstring\u003e","consectetur1":"\u003cstring\u003e","sint_c":"\u003cstring\u003e"},"readOnly":"\u003cboolean\u003e","secretRef":{"name":"\u003cstring\u003e","namespace":"\u003cstring\u003e"}},"flocker":{"datasetName":"\u003cstring\u003e","datasetUUID":"\u003cstring\u003e"},"gcePersistentDisk":{"pdName":"\u003cstring\u003e","fsType":"\u003cstring\u003e","partition":"\u003cinteger\u003e","readOnly":"\u003cboolean\u003e"},"glusterfs":{"endpoints":"\u003cstring\u003e","path":"\u003cstring\u003e","endpointsNamespace":"\u003cstring\u003e","readOnly":"\u003cboolean\u003e"},"hostPath":{"path":"\u003cstring\u003e","type":"\u003cstring\u003e"},"iscsi":{"targetPortal":"\u003cstring\u003e","iqn":"\u003cstring\u003e","lun":"\u003cinteger\u003e","chapAuthDiscovery":"\u003cboolean\u003e","chapAuthSession":"\u003cboolean\u003e","fsType":"\u003cstring\u003e","initiatorName":"\u003cstring\u003e","iscsiInterface":"\u003cstring\u003e","portals":["\u003cstring\u003e","\u003cstring\u003e"],"readOnly":"\u003cboolean\u003e","secretRef":{"name":"\u003cstring\u003e","namespace":"\u003cstring\u003e"}},"local":{"path":"\u003cstring\u003e","fsType":"\u003cstring\u003e"},"mountOptions":["\u003cstring\u003e","\u003cstring\u003e"],"nfs":{"server":"\u003cstring\u003e","path":"\u003cstring\u003e","readOnly":"\u003cboolean\u003e"},"nodeAffinity":{"required":{"nodeSelectorTerms":[{"matchExpressions":[{"key":"\u003cstring\u003e","operator":"\u003cstring\u003e","values":["\u003cstring\u003e","\u003cstring\u003e"]},{"key":"\u003cstring\u003e","operator":"\u003cstring\u003e","values":["\u003cstring\u003e","\u003cstring\u003e"]}],"matchFields":[{"key":"\u003cstring\u003e","operator":"\u003cstring\u003e","values":["\u003cstring\u003e","\u003cstring\u003e"]},{"key":"\u003cstring\u003e","operator":"\u003cstring\u003e","values":["\u003cstring\u003e","\u003cstring\u003e"]}]},{"matchExpressions":[{"key":"\u003cstring\u003e","operator":"\u003cstring\u003e","values":["\u003cstring\u003e","\u003cstring\u003e"]},{"key":"\u003cstring\u003e","operator":"\u003cstring\u003e","values":["\u003cstring\u003e","\u003cstring\u003e"]}],"matchFields":[{"key":"\u003cstring\u003e","operator":"\u003cstring\u003e","values":["\u003cstring\u003e","\u003cstring\u003e"]},{"key":"\u003cstring\u003e","operator":"\u003cstring\u003e","values":["\u003cstring\u003e","\u003cstring\u003e"]}]}]}},"persistentVolumeReclaimPolicy":"\u003cstring\u003e","photonPersistentDisk":{"pdID":"\u003cstring\u003e","fsType":"\u003cstring\u003e"},"portworxVolume":{"volumeID":"\u003cstring\u003e","fsType":"\u003cstring\u003e","readOnly":"\u003cboolean\u003e"},"quobyte":{"registry":"\u003cstring\u003e","volume":"\u003cstring\u003e","group":"\u003cstring\u003e","readOnly":"\u003cboolean\u003e","tenant":"\u003cstring\u003e","user":"\u003cstring\u003e"},"rbd":{"monitors":["\u003cstring\u003e","\u003cstring\u003e"],"image":"\u003cstring\u003e","fsType":"\u003cstring\u003e","keyring":"\u003cstring\u003e","pool":"\u003cstring\u003e","readOnly":"\u003cboolean\u003e","secretRef":{"name":"\u003cstring\u003e","namespace":"\u003cstring\u003e"},"user":"\u003cstring\u003e"},"scaleIO":{"gateway":"\u003cstring\u003e","system":"\u003cstring\u003e","secretRef":{"name":"\u003cstring\u003e","namespace":"\u003cstring\u003e"},"fsType":"\u003cstring\u003e","protectionDomain":"\u003cstring\u003e","readOnly":"\u003cboolean\u003e","sslEnabled":"\u003cboolean\u003e","storageMode":"\u003cstring\u003e","storagePool":"\u003cstring\u003e","volumeName":"\u003cstring\u003e"},"storageClassName":"\u003cstring\u003e","storageos":{"fsType":"\u003cstring\u003e","readOnly":"\u003cboolean\u003e","secretRef":{"apiVersion":"\u003cstring\u003e","fieldPath":"\u003cstring\u003e","kind":"\u003cstring\u003e","name":"\u003cstring\u003e","namespace":"\u003cstring\u003e","resourceVersion":"\u003cstring\u003e","uid":"\u003cstring\u003e"},"volumeName":"\u003cstring\u003e","volumeNamespace":"\u003cstring\u003e"},"volumeMode":"\u003cstring\u003e","vsphereVolume":{"volumePath":"\u003cstring\u003e","fsType":"\u003cstring\u003e","storagePolicyID":"\u003cstring\u003e","storagePolicyName":"\u003cstring\u003e"}},"status":{"lastPhaseTransitionTime":"\u003cdateTime\u003e","message":"\u003cstring\u003e","phase":"\u003cstring\u003e","reason":"\u003cstring\u003e"}}