如何對應命令參數
建議變更
PDF
Workflow Automation（WFA）命令中的參數會根據特定規則對應至特定屬性和字典項目參考。建立或編輯WFA命令時、您必須瞭解對應命令參數的規則。
命令參數對應可定義如何在工作流程中定義命令詳細資料。當您在工作流程中指定命令的命令詳細資料時、命令的對應命令參數會顯示在索引標籤中。這些索引標籤的名稱是根據「參數對應」索引標籤的「物件名稱」欄中所指定的群組名稱來命名。在工作流程中指定命令詳細資料時、未對應的參數會顯示在「其他參數」索引標籤中。
命令參數對應的規則會根據命令類別以及命令在工作流程編輯器中的呈現方式而適用。
以下是命令類別：
-
建立物件的命令
-
更新物件的命令
-
移除物件的命令
-
處理選用父物件和子物件的命令
-
更新物件之間關聯的命令
以下列出每個類別的規則：
所有命令類別
在對應命令參數時、您應該根據命令在工作流程中的使用方式、使用自然路徑。
下列範例說明如何定義自然路徑：
-
對於「ArrayIP」參數、視命令而定、您應該使用「Volume」（磁碟區）目錄項目的「Aggregate、array.ip」屬性、而非「array.ip」屬性。
當工作流程建立磁碟區、然後參照建立的磁碟區來執行其他步驟時、這一點很重要。以下是類似的範例：
-
「Qtree」目錄項目的「Volume、Aggregate、Array、IP」
-
「volume．gregate．array．ip」（磁碟區、Aggregate、陣列、IP）
-
-
對於命令中使用的「叢集」、您應該使用下列其中一項：
-
「Volume」（磁碟區）目錄項目的「vserver.cluster。primary_address」
-
「Qtree」目錄項目的「volume．vserver．cluster．primary_address」
-
建立物件的命令
此類命令用於下列其中一項：
-
尋找父物件並定義新物件
-
如果物件不存在、請搜尋物件並建立物件
您應該針對此類別的命令使用下列參數對應規則：
-
將所建立物件的相關參數對應至物件的字典項目。
-
透過所建立的字典項目參考來對應父物件。
-
新增參數時、請確定相關屬性存在於字典項目中。
以下是此規則的例外情況：
-
某些建立的物件沒有對應的字典項目、只有父物件對應到相關的父字典項目、例如*建立VIF*命令、其中只有陣列可以對應到陣列的字典項目。
-
不需要參數對應
例如、在* Create或resize Aggregate *命令中的「Executiontimeout」參數是未對應的參數。
-
下列通過認證的命令是此類別的範例：
-
建立Volume
-
建立LUN
更新物件的命令
此命令類別可用來尋找物件並更新屬性。
您應該針對此類別的命令使用下列參數對應規則：
-
將更新的物件對應至字典項目。
-
請勿對應已更新物件的參數。
例如、在*設定Volume State*命令中、會對應「Volume」參數、但新的「tate」會取消對應。
移除物件的命令
此命令類別可用來尋找物件並加以刪除。
您應該將命令刪除的物件對應至其字典項目。例如、在*移除Volume *命令中、要刪除的「Volume」會對應至「Volume」（磁碟區）目錄項目的相關屬性和參考資料。
處理選用父物件和子物件的命令
您應該針對此類別的命令使用下列參數對應規則：
-
請勿將命令的任何必要參數對應為命令選用參數的參考。
當命令處理特定父物件的選用子物件時、此規則就更具關聯性。在這種情況下、子物件和父物件應明確對應。例如、在*停止重複資料刪除工作*命令中、命令會在特定磁碟區上停止執行重複資料刪除工作（與「Array」一起指定時）、或在指定「Array」的所有磁碟區上停止執行重複資料刪除工作。在這種情況下、陣列參數應直接對應至「Array」（陣列）字典項目、而非對應至「Volume」（磁碟區）、因為此命令中的「Volume」（磁碟區）是選用參數。
-
如果邏輯層級的字典項目之間存在父與子關係、但特定命令中的實際執行個體之間沒有關係、則應分別對應這些物件。
例如、在*移動Volume *命令中、「Volume」會從目前的父Aggregate移至新的目的地Aggregate。因此、「Volume」參數會對應至「Volume」（磁碟區）的目錄項目、而目的地Aggregate參數會分別對應至「Aggregate」（集合）的目錄項目、但不會對應為「volume.aggregate.name.`」
更新物件之間關聯的命令
對於此類別的命令、您應該將關聯和物件對應至相關的字典項目。例如，在「Add Volume to vFiler」命令中，「Volume」和「vFiler」參數會對應到「Volume」和「vFiler」字典項目的相關屬性。