功能介绍

该API用于更新PersistentVolumeClaim对象。

其中以下字段支持更新：

• metadata.labels
• metadata.generateName

URI

PATCH /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}

表1 描述该API的参数。

请求消息

请求参数：

“Content-Type”消息头说明请参见PATCH请求方法操作说明。

请求示例：

Content-Type: application/merge-patch+json

{
    "metadata": {
        "labels": {
            "failure-domain.beta.kubernetes.io/region": "cn-north-4",
            "failure-domain.beta.kubernetes.io/zone": "cn-north-4a",
            "app":"mysql"
        }
    }
}

响应消息

响应参数：

响应参数的详细描述请参见表2.

响应示例：

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

  {
      "kind":"PersistentVolumeClaim",
      "apiVersion":"v1",
      "metadata":{
          "name":"cce-evs-k6m131jj-i1px",
          "namespace":"default",
          "selfLink":"/api/v1/namespaces/default/persistentvolumeclaims/cce-evs-k6m131jj-i1px",
          "uid":"d34f6a93-9eba-4a33-9320-8fa4addd3753",
          "resourceVersion":"2286592",
          "creationTimestamp":"2020-02-14T10:27:43Z",
          "labels":{
              "failure-domain.beta.kubernetes.io/region":"cn-north-5",
              "failure-domain.beta.kubernetes.io/zone":"cn-north-5a"
          },
          "annotations":{
              "everest.io/disk-volume-type":"SAS",
              "pv.kubernetes.io/bind-completed":"yes",
              "pv.kubernetes.io/bound-by-controller":"yes",
              "volume.beta.kubernetes.io/storage-provisioner":"everest-csi-provisioner"
          },
          "finalizers":[
              "kubernetes.io/pvc-protection"
          ]
      },
      "spec":{
          "accessModes":[
              "ReadWriteOnce"
          ],
          "resources":{
              "requests":{
                  "storage":"10Gi"
              }
          },
          "volumeName":"pvc-d34f6a93-9eba-4a33-9320-8fa4addd3753",
          "storageClassName":"csi-disk",
          "volumeMode":"Filesystem"
      },
      "status":{
          "phase":"Bound",
          "accessModes":[
              "ReadWriteOnce"
          ],
          "capacity":{
              "storage":"10Gi"
          }
      }
  }

• 1.13及之前集群版本示例：

  {
      "kind": "PersistentVolumeClaim",
      "apiVersion": "v1",
      "metadata": {
          "name": "db-mysql-0",
          "namespace": "default",
          "selfLink": "/api/v1/namespaces/default/persistentvolumeclaims/db-mysql-0",
          "uid": "9d070d77-8ce1-11e8-8ee0-fa163e49263c",
          "resourceVersion": "4202924",
          "creationTimestamp": "2018-07-21T12:28:46Z",
          "labels": {
              "app": "mysql",
              "failure-domain.beta.kubernetes.io/region": "cn-north-4",
              "failure-domain.beta.kubernetes.io/zone": "cn-north-4a"
          },
          "annotations": {
              "pv.kubernetes.io/bind-completed": "yes",
              "pv.kubernetes.io/bound-by-controller": "yes",
              "volume.beta.kubernetes.io/storage-class": "SAS",
              "volume.beta.kubernetes.io/storage-provisioner": "flexvolume-huawei.com/fuxivol"
          }
      },
      "spec": {
          "accessModes": [
              "ReadWriteMany"
          ],
          "resources": {
              "requests": {
                  "storage": "5Gi"
              }
          },
          "volumeName": "pvc-9d070d77-8ce1-11e8-8ee0-fa163e49263c",
          "volumeNamespace": "default"
      },
      "status": {
          "phase": "Bound",
          "accessModes": [
              "ReadWriteMany"
          ],
          "capacity": {
              "storage": "5Gi"
          }
      }
  }

状态码

表2描述API的状态码。

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