.TH "GCLOUD_ALPHA_IAM_POLICIES_DELETE" 1



.SH "NAME"
.HP
gcloud alpha iam policies delete \- delete a policy on the given attachment point with the given name



.SH "SYNOPSIS"
.HP
\f5gcloud alpha iam policies delete\fR \fIPOLICY_ID\fR \fB\-\-attachment\-point\fR=\fIATTACHMENT_POINT\fR \fB\-\-kind\fR=\fIKIND\fR [\fB\-\-etag\fR=\fIETAG\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR Delete a policy on the given attachment point with the given name.



.SH "EXAMPLES"

The following command deletes the IAM policy defined at the resource project
\f5\fI123\fR\fR of kind \f5\fIdenypolicies\fR\fR and id
\f5\fImy\-deny\-policy\fR\fR, with etag \f5\fIabc\fR\fR:

.RS 2m
$ gcloud alpha iam policies delete my\-deny\-policy \e
    \-\-attachment\-point=cloudresourcemanager.googleapis.com/\e
projects/123 \-\-kind=denypolicies \-\-etag=abc
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIPOLICY_ID\fR

Policy ID that is unique for the resource to which the policy is attached.


.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-attachment\-point\fR=\fIATTACHMENT_POINT\fR

Resource to which the policy is attached. For valid formats, see
https://cloud.google.com/iam/help/deny/attachment\-point.

.TP 2m
\fB\-\-kind\fR=\fIKIND\fR

Policy type. Use \f5denypolicies\fR for deny policies.


.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-etag\fR=\fIETAG\fR

Etag that identifies the version of the existing policy. It can be obtained by
running \f5gcloud iam policies get\fR. When deleting a policy, if the etag is
omitted, the policy is deleted regardless of its current etag. When updating a
policy, if the etag is omitted, the update uses the etag provided in the policy
file.


.RE
.sp

.SH "GCLOUD WIDE FLAGS"

These flags are available to all commands: \-\-access\-token\-file, \-\-account,
\-\-billing\-project, \-\-configuration, \-\-flags\-file, \-\-flatten,
\-\-format, \-\-help, \-\-impersonate\-service\-account, \-\-log\-http,
\-\-project, \-\-quiet, \-\-trace\-token, \-\-user\-output\-enabled,
\-\-verbosity.

Run \fB$ gcloud help\fR for details.



.SH "NOTES"

This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct project,
you might be trying to access an API with an invitation\-only early access
allowlist. These variants are also available:

.RS 2m
$ gcloud iam policies delete
.RE

.RS 2m
$ gcloud beta iam policies delete
.RE