翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# KMU を使用して AWS CloudHSM キーを削除する
<a name="key_mgmt_util-deleteKey"></a>

key AWS CloudHSM \$1mgmt\$1util の **deleteKey** コマンドを使用して、 AWS CloudHSM クラスターのハードウェアセキュリティモジュール (HSM) からキーを削除します。一度に削除できるキーは 1 つだけです。キーペアの一方のキーを削除しても、ペアの他方のキーには影響がありません。

キーを削除できるのは、キー所有者のみです。キーを共有するユーザーは、キーを暗号化オペレーションで使用することはできますが、削除することはできません。

key\$1mgmt\$1util コマンドを実行する前に、[key\$1mgmt\$1util を起動し](key_mgmt_util-setup.md#key_mgmt_util-start)、Crypto User (CU) として HSM に [ログインする](key_mgmt_util-log-in.md) 必要があります。

## Syntax
<a name="deleteKey-syntax"></a>

```
deleteKey -h 

deleteKey -k
```

## 例
<a name="deleteKey-examples"></a>

以下の例では、**deleteKey** を使用してキーを HSM から削除する方法を示します。

**Example : キーを削除する**  
次のコマンドでは、キーハンドルが `6` のキーを削除します。コマンドが成功すると、**deleteKey** はクラスターの各 HSM から成功メッセージを返します。  

```
Command: deleteKey -k 6

        Cfm3DeleteKey returned: 0x00 : HSM Return: SUCCESS

        Cluster Error Status
        Node id 1 and err state 0x00000000 : HSM Return: SUCCESS
        Node id 2 and err state 0x00000000 : HSM Return: SUCCESS
```

**Example : キーを削除する (失敗)**  
指定したキーハンドルに対応するキーがないためにコマンドが失敗すると、**deleteKey** はオブジェクトハンドルが無効であるというエラーメッセージを返します。  

```
Command: deleteKey -k 252126

        Cfm3FindKey returned: 0xa8 : HSM Error: Invalid object handle is passed to this operation

        Cluster Error Status
        Node id 1 and err state 0x000000a8 : HSM Error: Invalid object handle is passed to this operation
        Node id 2 and err state 0x000000a8 : HSM Error: Invalid object handle is passed to this operation
```
現在のユーザーがキーの所有者ではないためにコマンドが失敗すると、コマンドはアクセス拒否エラーを返します。  

```
Command:  deleteKey -k 262152

Cfm3DeleteKey returned: 0xc6 : HSM Error: Key Access is denied.
```

## パラメータ
<a name="deleteKey-parameters"></a>

**-h**  
コマンドのコマンドラインヘルプを表示します   
必須: はい

**-k**  
削除するキーのキーハンドルを指定します。HSM のキーのキーハンドルを確認するには、[findKey](key_mgmt_util-findKey.md) を使用します。  
必須: はい

## 関連トピック
<a name="deleteKey-seealso"></a>
+ [findKey](key_mgmt_util-findKey.md)