本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 KMU 刪除 AWS CloudHSM 金鑰
<a name="key_mgmt_util-deleteKey"></a>

使用 AWS CloudHSM key\$1mgmt\$1util 中的 **deleteKey**命令，從 AWS CloudHSM 叢集中的硬體安全模組 (HSM) 刪除金鑰。您一次只能刪除一個金鑰。刪除金鑰對中的一個金鑰，對金鑰對中的另一個金鑰沒有影響。

只有金鑰擁有者可以刪除金鑰。共用金鑰的使用者可以在密碼編譯操作中使用它，但不能刪除它。

執行任何 key\$1mgmt\$1util 命令之前，您必須先[啟動 key\$1mgmt\$1util](key_mgmt_util-setup.md#key_mgmt_util-start) 並以加密使用者 (CU) 的身分[登入](key_mgmt_util-log-in.md) HSM。

## 語法
<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.
```

## Parameters
<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)