# 删除API Key
#### 功能介绍
删除接口是应对安全威胁与清理废弃资产的最终防线。当API Key发生不可控的泄露、业务永久下线，可通过该接口将其彻底销毁。删除操作是不可逆的，一旦执行，该密钥的所有访问权限将被立即且永久地撤销。这一机制确保了即使攻击者获取了密钥副本，也无法再对模型服务发起任何有效请求，从而彻底切断了未授权访问的路径，为平台构筑了坚实的安全底线。
约束：
- 鉴权：调用本接口需在请求头携带有效IAM token（X-Auth-Token），并具备对应细粒度权限：删除需modelarts:apiKey:delete。
  
- 租户隔离：接口操作范围由当前token所属的Project/Domain 决定，project_id由鉴权上下文自动带入，不支持跨租户操作。
  
- 请保证账号余额充足，否则会删除失败。
  
 
#### URI
DELETE /v1/{project_id}/maas/api-auth/api-keys/{key_id}
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释** ：项目ID，是华为云中用于标识租户资源的唯一编号，与具体的区域（Region）相关联。在调用华为云API时用于定位资源所属的项目空间。可通过[获取项目ID和名称](https://support.huaweicloud.com/api-maas/api-maas-0028.html)接口获取。 **约束限制**：不涉及。 **取值范围**：不涉及。 **默认取值**：不涉及。 |
| key_id     | 是    | String | **参数解释** ：待删除的API Key ID。可通过[查询API Key列表](https://support.huaweicloud.com/api-maas/ListApiKeysV2.html)接口获取ID。 **约束限制**：必须为当前用户所属domain下存在的Key ID。 **取值范围**：不涉及。 **默认取值**：不涉及。                          |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数                                 | 参数类型                                | 描述                                                                                                                                                                               |
|:---|:---|:---|
| result | String | **参数解释：**操作结果标识，固定返回"success"。 **取值范围**：不涉及。 |
   
**状态码：403**
表3响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                          |
|:---|:---|:---|
| error_msg  | String | **参数解释**：错误信息描述。 **取值范围**：不涉及。 |
| error_code | String | **参数解释**：错误码。 **取值范围**：不涉及。    |
   
#### 请求示例
删除API Key
```
DELETE https://{endpoint}/v1/{project_id}/maas/api-auth/api-keys/fe777039-a2b8-42ff-ac59-194509b8f331
```
#### 响应示例
**状态码：200**
```
success
```
**状态码：403**
```
{
  "error_msg" : "Invalid token.",
  "error_code" : "ModelArts.0104"
}
```
#### 状态码
| 状态码 | 描述           |
|:---|:---|
| 200 | 删除成功。        |
| 403 | 用户鉴权token异常。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-maas/ErrorCode.html)。