全部产品
Search
文档中心

资源管理:DeleteRole - 删除角色

更新时间:Aug 28, 2026

调用DeleteRole删除角色。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

RoleName

string

角色名称。

长度为 1~64 个字符,可包含英文字母、数字、点号(.)和短横线(-)。

ECSAdmin

返回参数

名称

类型

描述

示例值

object

RequestId

string

请求 ID。

898FAB24-7509-43EE-A287-086FE4C44394

示例

正常返回示例

JSON格式

{
  "RequestId": "898FAB24-7509-43EE-A287-086FE4C44394"
}

错误码

HTTP status code

错误码

错误信息

描述

400 InvalidParameter.RoleName.InvalidChars The specified role name contains invalid characters. 角色名称包含无效字符。
400 InvalidParameter.RoleName.Length The maximum length of the role name is exceeded. 角色名称长度超出限制。
404 EntityNotExist.Role The role does not exist. 角色不存在。
409 DeleteConflict.Role.Policy The role cannot have any attached policies when you delete it. 删除角色前,角色不能有任何权限策略。

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情