创建PersistentVolumeClaim

功能介绍

该API用于在指定的Namespace下创建PersistentVolumeClaim。

使用已有的EVS创建PVC时，请参照CCE用户指南中使用云硬盘存储章节的使用已有的EVS创建PVC中步骤5为集群增加关联的metadata，以确保在删除节点或集群时避免删除已挂载的静态PV关联的EVS盘。若不执行上述操作或创建静态PV/PVC时没有执行过上述操作，请务必确保删除节点前，提前将静态PV关联的云硬盘从节点上卸载。

URI

POST /api/v1/namespaces/{namespace}/persistentvolumeclaims

表1 描述该API的参数。

请求消息

请求参数：

云硬盘存储卷请求示例：

• 1.15及以上版本集群，示例如下：

  {
      "kind":"PersistentVolumeClaim",
      "apiVersion":"v1",
      "metadata":{
          "name":"cce-evs-k6m16atm-3ays",
          "namespace":"default",
          "selfLink":"/api/v1/namespaces/default/persistentvolumeclaims/cce-evs-k6m16atm-3ays",
          "uid":"80f111e7-7d7e-4841-bd73-7ef97df0ee51",
          "creationTimestamp":"2020-02-14T10:30:20Z",
          "labels":{
              "failure-domain.beta.kubernetes.io/region":"cn-north-5",
              "failure-domain.beta.kubernetes.io/zone":"cn-north-5a"
          },
          "annotations":{
              "everest.io/crypt-key-id":"527cbece-428d-463b-a92c-936a11077b5d", //创建加密卷必需，若无或不全，则不加密；
              "everest.io/disk-volume-type":"SATA"
          },
          "finalizers":[
              "kubernetes.io/pvc-protection"
          ]
      },
      "spec":{
          "accessModes":[
              "ReadWriteOnce"
          ],
          "resources":{
              "requests":{
                  "storage":"10Gi"
              }
          },
          "storageClassName":"csi-disk",
          "volumeMode":"Filesystem"
      }
  }

• 1.13及之前版本示例：

  {
      "apiVersion": "v1",
      "kind": "PersistentVolumeClaim",
      "metadata": {
          "name": "db-mysql",
          "namespace": "default",
          "annotations": {
          "paas.storage.io/cryptKeyId": "1ed68cb7-b09b-423c-8d66-fdd2e063769d",     //此annotation表明是否加密，若无，则不加密；
  	"volume.beta.kubernetes.io/storage-class": "sata",
  	"volume.beta.kubernetes.io/storage-provisioner": "flexvolume-huawei.com/fuxivol"
          },
          "labels": {
  	"failure-domain.beta.kubernetes.io/region": "cn-north-4",
  	"failure-domain.beta.kubernetes.io/zone": "cn-north-4a"
          }
      },
      "spec": {
          "accessModes": [
              "ReadWriteMany"
          ],
          "resources": {
              "requests": {
                  "storage": "10Gi"
              }
          }
      }
  }

响应消息

响应参数：

响应参数的详细描述请参见14.2 Table2 Request parameters.

云硬盘存储卷响应示例：

• 1.15及以上版本集群，示例如下：

  {
      "kind":"PersistentVolumeClaim",
      "apiVersion":"v1",
      "metadata":{
          "name":"cce-evs-k6m16atm-3ays",
          "namespace":"default",
          "selfLink":"/api/v1/namespaces/default/persistentvolumeclaims/cce-evs-k6m16atm-3ays",
          "uid":"80f111e7-7d7e-4841-bd73-7ef97df0ee51",
          "resourceVersion":"2287083",
          "creationTimestamp":"2020-02-14T10:30:20Z",
          "labels":{
              "failure-domain.beta.kubernetes.io/region":"cn-north-5",
              "failure-domain.beta.kubernetes.io/zone":"cn-north-5a"
          },
          "annotations":{
              "everest.io/crypt-key-id":"527cbece-428d-463b-a92c-936a11077b5d",//若为加密卷，则存在
              "everest.io/disk-volume-type":"SATA"
          },
          "finalizers":[
              "kubernetes.io/pvc-protection"
          ]
      },
      "spec":{
          "accessModes":[
              "ReadWriteOnce"
          ],
          "resources":{
              "requests":{
                  "storage":"10Gi"
              }
          },
          "storageClassName":"csi-disk",
          "volumeName": "pvc-d34f6a93-9eba-4a33-9320-8fa4addd3753",
          "volumeMode":"Filesystem"
      },
      "status":{
          "phase":"Pending"
      }
  }

• 1.13及之前版本yaml示例：

  {
      "kind": "PersistentVolumeClaim",
      "apiVersion": "v1",
      "metadata": {
          "name": "db-mysql",
          "namespace": "default",
          "selfLink": "/api/v1/namespaces/default/persistentvolumeclaims/db-mysql",
          "uid": "ac34af93-8cdd-11e8-8ee0-fa163e49263c",
          "resourceVersion": "4197709",
          "creationTimestamp": "2018-07-21T12:00:33Z",
          "labels": {
              "failure-domain.beta.kubernetes.io/region": "cn-north-4",
              "failure-domain.beta.kubernetes.io/zone": "cn-north-4a"
          },
          "annotations": {
              "paas.storage.io/cryptKeyId": "1ed68cb7-b09b-423c-8d66-fdd2e063769d"   //若为加密卷，则存在
              "pv.kubernetes.io/bind-completed": "yes",
              "pv.kubernetes.io/bound-by-controller": "yes",
              "volume.beta.kubernetes.io/storage-class": "sata",
              "volume.beta.kubernetes.io/storage-provisioner": "flexvolume-huawei.com/fuxivol"
          }
      },
      "spec": {
          "accessModes": [
              "ReadWriteMany"
          ],
          "resources": {
              "requests": {
                  "storage": "10Gi"
              }
          },
          "volumeName": "pvc-ac34af93-8cdd-11e8-8ee0-fa163e49263c",
          "volumeNamespace": "default"
      },
      "status": {
          "phase": "Bound",
          "accessModes": [
              "ReadWriteMany"
          ],
          "capacity": {
              "storage": "10Gi"
          }
      }
  }

状态码

表8描述API的状态码。

异常状态码请参见状态码。