文档首页 > > API参考> Kubernetes API> PersistentVolumeClaim> 列出指定的Namespace下的PersistentVolumeClaim

列出指定的Namespace下的PersistentVolumeClaim

分享
更新时间:2020/09/18 GMT+08:00

功能介绍

该API用于列出指定Namespace下的所有PersistentVolumeClaim资源对象。

URI

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

表1 描述该API的参数。

表1 参数描述

参数

是否必选

描述

namespace

Yes

Object name and auth scope, such as for teams and projects.

pretty

No

If 'true', then the output is pretty printed.

includeUninitialized

No

If true, partially initialized resources are included in the response.

fieldSelector

No

A selector to restrict the list of returned objects by their fields. Defaults to everything.

labelSelector

No

A selector to restrict the list of returned objects by their labels. Defaults to everything.

resourceVersion

No

When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history.

timeoutSeconds

No

Timeout for the list/watch call.

watch

No

Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.

请求消息

N/A

响应消息

响应参数:

表2 响应参数

参数

参数类型

描述

kind

String

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.

apiVersion

String

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.

metadata

metadata object

Standard list metadata.

items

Object

A list of persistent volume claims.

具体请参见14.2-Table2 Request parameters

表3 metadata字段数据结构说明

参数

参数类型

描述

resourceVersion

String

String that identifies the server's internal version of this object that can be used by clients to determine when objects have changed. Value must be treated as opaque by clients and passed unmodified back to the server. Populated by the system. Read-only.

selfLink

String

SelfLink is a URL representing this object. Populated by the system. Read-only.

响应示例:

  • 1.15及以上版本集群,示例如下:
    {
        "kind":"PersistentVolumeClaimList",
        "apiVersion":"v1",
        "metadata":{
            "selfLink":"/api/v1/persistentvolumeclaims",
            "resourceVersion":"2306215"
        },
        "items":[
            {
                "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":"SATA",
                        "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": "PersistentVolumeClaimList",
        "apiVersion": "v1",
        "metadata": {
            "selfLink": "/api/v1/namespaces/default/persistentvolumeclaims",
            "resourceVersion": "4198037"
        },
        "items": [
            {
                "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": {
                        "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"
                    }
                }
            },
            {
                "metadata": {
                    "name": "db-mysql-0",
                    "namespace": "default",
                    "selfLink": "/api/v1/namespaces/default/persistentvolumeclaims/db-mysql-0",
                    "uid": "f6585eb2-8cdd-11e8-a538-fa163e082286",
                    "resourceVersion": "4198033",
                    "creationTimestamp": "2018-07-21T12:02:38Z",
                    "labels": {
                        "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": "sata",
                        "volume.beta.kubernetes.io/storage-provisioner": "flexvolume-huawei.com/fuxivol"
                    }
                },
                "spec": {
                    "accessModes": [
                        "ReadWriteMany"
                    ],
                    "resources": {
                        "requests": {
                            "storage": "5Gi"
                        }
                    },
                    "volumeName": "pvc-f6585eb2-8cdd-11e8-a538-fa163e082286",
                    "volumeNamespace": "default"
                },
                "status": {
                    "phase": "Bound",
                    "accessModes": [
                        "ReadWriteMany"
                    ],
                    "capacity": {
                        "storage": "5Gi"
                    }
                }
            }
        ]
    }
分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问