DeleteTasksコマンドは,idパラメーターで指定する終了(End)状態のタスクを削除します。
タスクの状態を示すstatusパラメーターで,対象のタスクの範囲を指定できます。タスクの種類を指定することもできます。
作成日や終了日などのタスクに関連づけられた日付を用いて,削除するタスクの範囲を指定できます。次の指定ができます。
(1) 記述形式
htsmcli [ サーバのロケーション] DeleteTasks
[ 共通オプション ]
[ { -f | --force } ]
[ { id=タスクID |
[ { storagedomainname=ストレージドメイン名
[ migrationgroupname=マイグレーショングループ名 ]
[ targetstoragetiername=ストレージ階層名 ]
| subsystemname=ストレージシステム名 } ]
[ status=状態 [ ,状態 ]... ]
[ [ datetype = { Creation | End } ]
daystobase=基準日までの日数
[ direction={ Before | After | Just } ] ]
[ tasktype={ Migration | Shredding | Locking | Unlocking
| VolumeCreation | ExternalMapping } ] } ]
(2) オプション
(3) パラメーター
パラメーターの指定は,任意です。
表5-63 DeleteTasksコマンドのパラメーター
パラメーター名 | 説明 |
---|---|
id | タスクIDを指定します。 タスクIDは,GetTasksコマンドなどで,タスクの情報が出力される時にID属性として表示されます。 このパラメーターは,ほかのパラメーターと同時には指定できません。 |
storagedomainname | ストレージドメイン名を指定します。migrationgroupnameまたはtargetstoragetiernameを指定する場合には必ず指定してください。 |
migrationgroupname | マイグレーショングループ名を指定します。storagedomainnameと組み合わせて指定してください。 |
targetstoragetiername | 移動先ストレージ階層名を指定します。storagedomainnameと組み合わせて指定してください。 マイグレーションタスクの絞り込みだけに使用できます。 |
subsystemname | ストレージシステム名を指定します。 Device Manager CLIのGetStorageArrayでStorageArrayオブジェクトのname属性に表示される値を指定します。 ストレージシステム名が不明な場合は,プロダクト名とシリアル番号を指定します。 省略時はストレージシステムによる絞り込みはしません。 |
status | タスクの状態を指定します。 指定できる値の詳細については,「5.8 タスクの状態」を参照してください。 タスクの状態を複数個指定する場合には,コンマで区切ってください。 |
datetype | 日付種別範囲指定で使用する,タスクに関連づけられた日付の種別(作成日,終了日)を指定します。
|
daystobase | 基準日とする日までの日数を,0または正の整数で指定します。タスクの取得範囲の基準日を,現在からの逆算日数(何日前か)で指定します。 |
direction | タスクの取得範囲を,基準日からの向きで指定します。
|
tasktype | タスクの種類を指定します。
|
(4) 出力項目
DeleteTasksコマンドは,複数種類のタスクを削除できます。そのため,タスクの種類によって出力項目が変わります。
出力項目はタスク作成時と同じです。
指定したタスクの範囲に該当するタスクがない場合には,何も出力されません。
(5) コマンド指定例と実行結果
htsmcli DeleteTasks storagedomainname="MegaTechUSP600-Primary" status="Cancel" tasktype="Migration"
CONFIRMATION:
An instance of Task(1 of 1)
ID=TK1f2lymqv
taskType=Migration
status=Cancel
timeEstimate=0:02:02
creationTime=2014/01/25 16:53:11
endTime=2014/01/28 16:53:45
ownerID=user
storageDomainName=MegaTechUSP600-Primary
migrationGroupName=MG011
previousTargetStorageTierName=
targetStorageTierName=MegaTech-HighCost
eraseData=No
zeroDataDiscard=No
notifyToURL=mailto:test@example.com
description=
List of 2 MigrationInfo elements:
An instance of MigrationInfo(1 of 2)
sourceControllerDeviceNumber=3:A6
targetControllerDeviceNumber=2:80
timeEstimate=0:01:01
An instance of MigrationInfo(2 of 2)
sourceControllerDeviceNumber=3:A7
targetControllerDeviceNumber=2:84
timeEstimate=0:01:01
Are you sure you want to delete this task? (Y/N) :