Updated on 2025-08-20 GMT+08:00

Deleting Authorization

Function

This API is used to delete the authorization of a specified user or all users.

This API applies to the following scenarios: When the access permission of a specified user needs to be revoked or the authorization of all users needs to be cleared during system maintenance, the administrator can use this API to do so. Before using this API, the administrator must have the permission to delete the authorization and specify the user whose authorization is to be deleted or delete the authorization of all users. After the deletion is complete, the authorization of the specified user will be removed, or the authorization of all users will be cleared. Users cannot access related functions. If the user does not exist, the administrator does not have the operation permission, or the system detects that there is no administrator permission during authorization deletion of all users, the API will return an error message.

Debugging

You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.

URI

DELETE /v2/{project_id}/authorizations

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition: Project ID. For details, see Obtaining a Project ID and Name.

Constraints: N/A

Range: N/A

Default Value: N/A

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

user_id

No

String

Definition: User ID. If this parameter is set to all, the authorization of all IAM users will be deleted.

Constraints: N/A

Range: N/A

Default Value: N/A

Request Parameters

None

Response Parameters

Status code: 200

OK

None

Example Requests

Delete the authorization of a specified user.

DELETE https://{endpoint}/v2/{project_id}/authorizations?user_id=****d80fb058844ae8b82aa66d9fe****

Example Responses

Status code: 200

OK

{
  "result" : "true"
}

Status Codes

Status Code

Description

200

OK

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

Error Codes

See Error Codes.