6.9 パリティグループをフォーマットする
- メモ
-
この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 ""