查询PVC变更

本章节介绍如何使用Kubectl查询PVC变更状态，当前华为CSI通过CRD提供以下API。

查询VolumeModifyClaim

使用kubectl查询VolumeModifyClaim步骤如下。

1. 使用远程访问工具（以PuTTY为例），通过管理IP地址，登录Kubernetes集群的任意master节点。

2. 执行以下命令，查询PVC变更。其中 vmc-name 为VolumeModifyClaim资源名称。

   kubectl get volumemodifyclaims <vmc-name> -owide
   

   命令结果示例如下：

   NAME    STATUS      READY   SOURCEKIND     SOURCENAME   STARTEDAT              COMPLETEDAT            AGE
   myvmc   Completed   1/1     StorageClass   mysc         2024-06-06T03:19:13Z   2024-06-06T03:19:16Z   2m2s
   

   表 1 回显说明

   名称	说明
   NAME	VolumeModifyClaim资源名称。
   STATUS	VolumeModifyClaim资源状态，可取值如下： Pending：初始状态。 Creating：VolumeModifyClaim完成基本校验，且服务端已经接收变更任务，但是该任务还未执行完成。 Completed：所有关联的PVC均完成变更。 Rollback：关联的PVC部分完成变更时，用户执行了删除PVC变更操作。 Deleting：关联的PVC全部完成变更时，用户执行了删除PVC变更操作。
   READY	完成变更PVC数量/全部待变更PVC数量。
   SOURCEKIND	数据源类型，例如StorageClass。
   SOURCENAME	数据源名称，例如StorageClass名称。
   STARTEDAT	变更开始时间，指服务端接收该任务并开始处理的时间戳。
   COMPLETEDAT	变更完成时间，指所有关联的PVC均完成变更后的时时间戳，仅STATUS为Completed时，存在该值。
   AGE	VolumeModifyClaim从创建至当前的存活时间。

VolumeModifyClaim支持使用kubectl查看Events信息，当VolumeModifyClaim无法满足创建要求，或者创建过程中出现错误时，服务端将记录Events信息。参考命令如下：

kubectl describe volumemodifyclaims local-to-hypermetro 

查询VolumeModifyContent

VolumeModifyContent由VolumeModifyClaim资源创建，记录了单个PVC的变更详情，使用kubectl查询VolumeModifyContent步骤如下。

1. 使用远程访问工具（以PuTTY为例），通过管理IP地址，登录Kubernetes集群的任意master节点。

2. 执行命令，查询PVC变更。其中myvmc-uid为VolumeModifyContent资源名称。

   kubectl get volumemodifycontents myvmc-uid  -owide
   

   命令结果示例如下：

   NAME         STATUS      MODIFYCLAIMNAME     SOURCEVOLUME   STARTEDAT              COMPLETEDAT            AGE
   myvmc-uid    Completed   myvmc               default/mypvc  2024-06-06T03:19:07Z   2024-06-06T03:19:09Z   36m
   

   表 2 回显说明

   名称	说明
   NAME	VolumeModifyContent资源名称，格式为：VolumeModifyClaim名称-关联PVC的UID。
   STATUS	VolumeModifyContent资源状态，可取值如下： Pending：初始状态。 Creating：VolumeModifyContent完成基本校验，且服务端已经接收变更任务，但是该任务还未执行完成。 Completed：关联的PVC完成变更。 Rollback：正在回滚PVC变更。
   MODIFYCLAIMNAME	关联的VolumeModifyClaim名称。
   SOURCEVOLUME	关联的PVC信息，格式为：命名空间名称/PVC名称。
   STARTEDAT	PVC变更开始时间，指服务端接收该任务并开始处理的时间戳。
   COMPLETEDAT	PVC变更完成时间，指所有关联的PVC均完成变更后的时时间戳，仅STATUS为Completed时，存在该值。
   AGE	即VolumeModifyContent从创建至当前的存活时间。

VolumeModifyContent支持使用kubectl查看Events信息，当VolumeModifyContent无法满足创建要求，或者变更PVC出现错误时，服务端将记录Events信息。参考命令如下：

kubectl describe volumemodifycontents myvmc-uid