- HTTP request
- Path parameters
- Request body
- Response body
- Authorization scopes
- IAM Permissions
- Examples
- Try it!
grants.revoke
is used to immediately revoke access for a grant. This method can be called when the grant is in a non-terminal state.
HTTP request
POST https://privilegedaccessmanager.googleapis.com/v1beta/{name=projects/*/locations/*/entitlements/*/grants/*}:revoke
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
name |
Required. Name of the grant resource which is being revoked. |
Request body
The request body contains data with the following structure:
JSON representation |
---|
{ "reason": string } |
Fields | |
---|---|
reason |
Optional. The reason for revoking this grant. |
Response body
If successful, the response body contains an instance of Operation
.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.
IAM Permissions
Requires the following IAM permission on the name
resource:
privilegedaccessmanager.grants.revoke
For more information, see the IAM documentation.