在单个方法调用中创建、修改和/或移动多个卷
IBMTSDS_StorageConfigurationService. CreateOrModifyElementsFromStoragePool 是供应商扩展方法,允许在单个方法调用中创建/修改/移动多个卷。
对于大量卷,此方法比多次循环调用 CreateOrModifyElementFromStoragePool 更高效。InPool、Goal 和 ElementType 输入参数与 CreateOrModifyElementFromStoragePool 中的相应参数相同。
参数
以下定义总结了与 CreateOrModifyElementFromStoragePool 不同的参数。
- TheElements(卷修改或卷移动时必需)
- 如果该值不为 null,它表示您希望修改指定的每个卷。
- Quantity(卷创建时必需)
- 作为输入,表示要创建的 StorageVolume 实例的数量。 在修改 StorageVolume 实例时,此参数必须为 null。作为输出,表示所创建的卷的数量(如果成功)。或者,如果由于卷太多且 VirtualPool 实例上没有足够容量而创建失败,那么表示可创建的卷的数量。
- ElementNames
- 分配给正在创建或修改的各个卷的元素名称的数组。可通过以下两种不同的方式提供卷名:
- 第一种方式是为每个卷名称提供值的一个元素。在创建卷时,长度必须等于 Quantity 的值。如果不为 NULL,那么在修改卷时,长度必须与 TheElements 参数中指定的长度相同。例如,要创建两个卷“testVolume_3”和“testVolume_4”,将 ElementNames 参数的值设置为 ['testVolume_3','testVolume_4'],并将 FirstSuffix 参数的值保留为 null。
- 第二种方式是提供卷名称的前导字符串作为唯一的元素。在此情况下,所有卷的名称具有相同格式 [LeadingString]_[IncrementingNumber]。[LeadingString] 是此参数的值,而第一个 [IncrementingNumber] 是 FirstSuffix 参数的值。增量为 1。要以第一种方式创建两个卷“testVolume_3”和“testVolume_4”,请将 ElementNames 参数的值设置为 ['testVolume'] 并将 FirstSuffix 参数的值设置为 3。
- FirstSuffix
- 在使用上述第二种方法创建卷或修改卷名时,表示卷名的起始后缀编号。用户可使用此参数提供起始 [IncrementingNumber]。如果为 null,那么缺省值为 1。
在使用上述第一种方法创建卷或修改卷名时,值必须为 null。注: FirstSuffix 参数不包含在公共信息模型 (CIM)或存储管理计划规范 (SMI-S) 模式中。该参数是一个 IBM® 扩展。
- ReturnCodes
- 创建或修改的每个卷都可能发生与其相关的不同错误。此输出参数是针对每次尝试的每个个别返回码的数组。