- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Examples
- Try it!
Deletes a policy binding and returns a long-running operation. Callers will need the IAM permissions on both the policy and target. Once the binding is deleted, the policy no longer applies to the target.
HTTP request
DELETE https://iam.googleapis.com/v3beta/{name=projects/*/locations/*/policyBindings/*}
The URL uses gRPC Transcoding syntax.
Path parameters
name
string
Required. The name of the policy binding to delete.
Format:
-
projects/{projectId}/locations/{location}/policyBindings/{policyBindingId} -
projects/{projectNumber}/locations/{location}/policyBindings/{policyBindingId} -
folders/{folderId}/locations/{location}/policyBindings/{policyBindingId} -
organizations/{organizationId}/locations/{location}/policyBindings/{policyBindingId}
Query parameters
| Parameters | |
|---|---|
etag
|
Optional. The etag of the policy binding. If this is provided, it must match the server's etag. |
validateOnly
|
Optional. If set, validate the request and preview the deletion, but do not actually post it. |
Request body
The request body must be empty.
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 .
