7.12 DPボリュームのゼロデータページを破棄する
DPボリュームのゼロデータページを破棄して、ページを解放します。ページを解放することでプールの空き容量を増やすことができます。
実行権限
ストレージ管理者（プロビジョニング）
リクエストライン
PUT ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/ldevs/＜オブジェクトID＞/actions/discard-zero-page/invoke
このAPIはPOSTメソッドでも実行できます。
リクエストメッセージ
- オブジェクトID
-
ボリュームの情報取得で取得したldevIdの値を指定します。
属性
型
説明
ldevId
int
（必須）LDEV番号を10進数で指定します。
- クエリパラメータ
- なし。
- ボディ
- なし。
レスポンスメッセージ
ジョブオブジェクトを返します。affectedResources以外の属性については、ジョブオブジェクトの説明を参照してください。
|
属性 |
説明 |
|---|---|
|
affectedResources |
ゼロデータページを破棄したボリュームのURL |
Actionテンプレート
なし。
ステータスコード
この操作のリクエストに対するステータスコードの意味を次に示します。そのほかのステータスコードについては、HTTPステータスコードの説明を参照してください。
|
ステータスコード |
メッセージ |
説明 |
|---|---|---|
|
412 |
Precondition Failed |
ボリュームが次のどれかの条件を満たすため、指定されたアクションを実行できません。
|
コード例
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/ldevs/1/actions/discard-zero-page/invoke -d ""