18.8 暗号化鍵を作成する
個数を指定して、暗号化鍵を作成します。暗号化鍵の作成後は、必ずバックアップをしてください。
- メモ
-
REST API を実行するユーザが、対象ストレージシステムのリソースをREST API でロックしている場合、このAPIは実行できません。その場合は、ロックを解除してから実行してください。
実行権限
セキュリティ管理者（参照・編集）
リクエストライン
POST ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/encryption-keys
リクエストメッセージ
- オブジェクトID
- なし。
- クエリパラメータ
-
なし。
- ボディ
-
{ "count": 10 }属性
型
説明
count
int
（必須）作成する暗号化鍵の数
1以上の値を指定します。
count属性で指定した値と既存の鍵の数が、作成できる鍵の数の最大数を超える場合、1個も作成されずにエラーとなります。
レスポンスメッセージ
- ボディ
-
ジョブオブジェクトを返します。ジョブオブジェクトの説明を参照してください。このAPIはaffectedResourcesを表示しません。暗号化鍵が作成できたかどうかは、暗号化鍵の個数を取得するAPI、または暗号化鍵の一覧を取得するAPIを実行して確認してください。
ステータスコード
この操作のリクエストに対するステータスコードの意味を次に示します。そのほかのステータスコードについては、HTTPステータスコードの説明を参照してください。
|
ステータスコード |
メッセージ |
説明 |
|---|---|---|
|
412 |
Precondition Failed |
ストレージシステムのマイクロコードのバージョンは、この操作をサポートしていません。 |
コード例
curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X POST --data-binary @./InputParameters.json https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/886000123457/encryption-keys