Hitachi

Hitachi Command Suite Configuration Manager REST API リファレンスガイド


6.9 パリティグループをフォーマットする

パリティグループから作成したすべてのボリュームをフォーマットします。パリティグループ内のすべてのボリュームを閉塞状態(BLK)にしておいてください。
メモ

このAPIは、VSP 5000 シリーズVSP E シリーズVSP Gx00 モデルまたはVSP Fx00 モデルの場合に使用できます。

実行権限

ストレージ管理者(プロビジョニング)

リクエストライン

PUT <ベースURL>/v1/objects/storages/<ストレージデバイスID>/parity-groups/<オブジェクトID>/actions/format/invoke

このAPIはPOSTメソッドでも実行できます。

リクエストメッセージ

オブジェクトID

パリティグループの情報取得で取得したparityGroupIdの値を指定します。

属性

説明

parityGroupId

string

(必須)パリティグループ番号

分散パリティグループの場合も同様に指定します。

1-3-1、1-3-2、および1-3-3の分散パリティグループの場合、次のように指定します。

"parityGroupId":"1-3"
クエリパラメータ

なし。

ボディ

なし。

レスポンスメッセージ

ボディ

ジョブオブジェクトを返します。ジョブオブジェクトの説明を参照してください。このAPIはaffectedResourcesを表示しません。ジョブオブジェクトのstate属性がSucceededになるとフォーマットが実行されます。各ボリュームのフォーマットが完了したかどうかは、次のURLで確認してください。<パリティグループ番号>にはオブジェクトIDに指定したパリティグループ番号を指定します。

GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/ldevs?parityGroupId=<パリティグループ番号

指定したパリティグループ内のすべてのボリュームのステータスが正常状態(NML)になれば、フォーマットは完了しています。

Actionテンプレート

なし。

ステータスコード

この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。

コード例

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X PUT https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/836000123456/parity-groups/1-7/actions/format/invoke -d ""