文档首页/ MaaS模型即服务/ API参考/ API Key鉴权管理/ 删除API Key
更新时间：2026-10-27 GMT+08:00
查看PDF
分享

删除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和名称接口获取。

约束限制：不涉及。

取值范围：不涉及。

默认取值：不涉及。

key_id

是

String

参数解释：待删除的API Key ID。可通过查询API Key列表接口获取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异常。

错误码

请参见错误码。

父主题： API Key鉴权管理