创建、修改和/或移动单个卷
IBMTSDS_StorageConfigurationService. CreateOrModifyElementFromStoragePool 是公共信息模型 (CIM)和存储管理计划规范 (SMI-S) 标准方法,用于从 Concrete StoragePool 实例创建或修改 StorageVolume 实例。
此方法可同时创建或修改一个卷。 使用目标池的引用指定 InPool 参数时,该方法也用于将卷从一个池移动到另一个池。
参数
以下定义概述 IBMTSDS_StorageConfigurationService.
CreateOrModifyElementFromStoragePool 方法如何处理输入参数的不同值:
- TheElement(修改时必需)
- 作为输入参数,如果该值为 null,那么指示想要创建卷。如果该值不为 null,它表示您要尝试修改指定的卷。作为输出参数,TheElement 引用已创建或修改的卷。
- ElementType
- 指示正在创建或修改的元素类型的枚举。仅支持卷值。因此,ElementType 的值为 2 (StorageVolume) 或 5 (ThinlyProvisionedStorageVolume)。请参阅 BlockServer.mof 文件以获取详细信息。
- InPool(创建和移动时必需)
- 对要创建卷或将卷移动到的 StoragePool 实例的引用。它必须是 IBMTSDS_VirtualPool 的实例。
- Goal
- 对表示卷的 DataType 值的 StorageSetting 实例的引用。它必须是对 IBMTSDS_DataTypeSetting 实例的引用。IBMTSDS_DataTypeSetting 具有两个实例:IBMTSDS:SystemBlockSize 和 IBMTSDS:XIVBlockSize。在创建卷时,如果此参数为 null,那么将使用缺省值 IBMTSDS:XIVBlockSize。在修改卷时,如果指定 Size 参数,但是此参数为 null,那么将使用缺省值 IBMTSDS:XIVBlockSize,并且将调整卷的大小。
- Size
- 在创建或修改卷时,此参数指定想要的大小(作为输入)和实现的大小(作为输出参数)。在修改卷大小时,缺省情况下仅支持大小扩展。如果想要缩小卷,请将 ForceShrink 参数设置为 true。
- ForceShrink
- 在修改卷时,如果 Size 参数小于卷的实际大小,那么该参数将指定对卷进行收缩。
如果此参数为 null 或者设置为 false,那么收缩卷将失败。要收缩卷,请将该参数设置为 true。缺省值为 false。ForceShrink 参数不包含在 CIM 或 SMI-S 模式中。该参数是一个 IBM® 扩展。注意: 收缩卷可能导致数据丢失。
- Locked
- 在修改卷/快照时,此参数指定卷/快照锁定状态为已锁定或未锁定。如果此参数为 null,那么不会修改卷/快照锁定状态。如果此参数设置为 0,那么解锁卷/快照。如果将此参数设置为 1,那么锁定卷/快照。其他值无效。
在锁定卷/快照且在相同方法中修改其他属性时,那么将在最后步骤中锁定卷/快照。
在解锁卷/快照且在相同方法中修改其他属性时,那么将在第一步中解锁卷/快照。
注: Locked 参数不包含在 CIM 或 SMI-S 模式中。该参数是一个 IBM 扩展。
- ElementName
- 分配给卷的描述性名称。注: 卷名在系统中必须唯一。不能是已分配给系统中的其他某个卷的名称。