18.7　特定の暗号化鍵を取得する

鍵のIDを指定して、特定の暗号化鍵の情報を取得します。このAPIでは、DEKまたはFREEの鍵を取得します。CEKまたはKEKの鍵を取得したい場合は、暗号化鍵の一覧を取得するAPIを使用してください。

実行権限

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

リクエストライン

GET ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/encryption-keys/＜オブジェクトID＞

リクエストメッセージ

オブジェクトID

暗号化鍵の一覧を取得するAPIで取得したkeyIdの値を指定します。

属性	型	説明
keyId	string	（必須）鍵のID

クエリパラメータ: なし。

ボディ: なし。

レスポンスメッセージ

ボディ

{
    "keyId": "7",
    "createdTime": "2018-10-29T04:32:26Z",
    "keyType": "DEK",
    "uuid": "-",
    "targetDeviceLocation": "HDD00-09",
    "keyGeneratedLocation": "DKC",
    "numOfBackups": 4
}

属性	型	説明
keyId	string	鍵のID
createdTime	ISO8601string	鍵の作成日時
keyType	string	鍵の種別 `DEK`：暗号化鍵格納したデータを暗号化するための鍵です。 `FREE`：暗号化鍵の割り当て前の未使用の鍵
uuid	string	鍵のUUID 常に、`-`（ハイフン）が出力されます。
targetDeviceLocation	string	鍵の割り当て先ドライブのロケーション番号（DEKの場合） `-`（ハイフン）（FREEの場合）
keyGeneratedLocation	string	鍵の作成場所 `DKC`：ストレージシステム `KMS`：鍵管理サーバ
numOfBackups	int	鍵のバックアップ回数

ステータスコード

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

ステータスコード	メッセージ	説明
412	Precondition Failed	ストレージシステムのマイクロコードのバージョンは、この操作をサポートしていません。

コード例

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X GET https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/886000123457/encryption-keys/7

18.7 特定の暗号化鍵を取得する

18.7　特定の暗号化鍵を取得する