18.11　暗号化鍵をリストアする

メモ

REST API を実行するユーザが、対象ストレージシステムのリソースをREST API でロックしている場合、このAPIは実行できません。その場合は、ロックを解除してから実行してください。

実行権限

セキュリティ管理者（参照・編集）

リクエストヘッダ

このAPIでは、リクエストボディをmultipart/form-data形式で送信します。リクエストヘッダのContent-Typeにはmultipart/form-dataを指定してください。　

リクエストライン

POST ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/encryption-keys/file/actions/restore/invoke

リクエストメッセージ

オブジェクトID

fileを指定します。

fileは、暗号化鍵をファイルにバックアップしたりリストアしたりする場合に、オブジェクトIDとして指定する固定の値です。

クエリパラメータ

なし。

ボディ

属性	型	説明
password	string	（必須）暗号化鍵をバックアップしたときに指定したパスワード
file	file	（必須）バックアップした暗号化鍵のファイル 最新のバックアップファイルを指定してください。 バックアップ後に暗号化鍵が変更されたなどの理由によって最新でない暗号化鍵はリストアできません。

レスポンスメッセージ

ボディ

ジョブオブジェクトを返します。ジョブオブジェクトのスキーマについては、ジョブオブジェクトの説明を参照してください。ただし、このAPIはaffectedResourcesを表示しません。

Actionテンプレート

なし。

ステータスコード

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

コード例

curl -v -H "Accept:application/json" -H "Content-Type: multipart/form-data" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -H "Expect:" -X POST -F "file=@C:\backupfile.ekf" -F "password=backuppassword" https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/886000123457/encryption-keys/file/actions/restore/invoke