删除授权
功能介绍
删除授权接口用于删除指定用户的授权或删除全量用户的授权。该接口适用于以下场景:当需要撤销特定用户的访问权限或在系统维护时清理所有用户的授权时,管理员可通过此接口删除指定用户的授权或全量用户的授权。使用该接口的前提条件是管理员具备删除授权的权限,并且需要指定要删除授权的用户或选择删除全量用户的授权。删除操作完成后,指定用户的授权将被移除,或所有用户的授权将被清空,用户将无法再访问相关功能。若用户不存在、管理员无权限操作或删除全量授权时系统检测到无管理员权限,接口将返回相应的错误信息。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
DELETE /v2/{project_id}/authorizations
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
参数解释:用户项目ID,获取方法请参见获取项目ID和名称。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
user_id |
否 |
String |
参数解释:用户ID,当user_id为all时,表示删除所有IAM子用户的授权。 约束限制:不涉及。 取值范围:不涉及。 默认取值:不涉及。 |
请求参数
无
响应参数
状态码:200
OK。
无
请求示例
删除指定用户的授权
DELETE https://{endpoint}/v2/{project_id}/authorizations?user_id=****d80fb058844ae8b82aa66d9fe****
响应示例
状态码:200
OK。
{ "result" : "true" }
状态码
状态码 |
描述 |
---|---|
200 |
OK。 |
400 |
Bad Request。 |
401 |
Unauthorized。 |
403 |
Forbidden。 |
404 |
Not Found。 |
错误码
请参见错误码。