
.TH "GCLOUD_ACCESS\-CONTEXT\-MANAGER_POLICIES_REMOVE\-IAM\-POLICY\-BINDING" 1



.SH "NAME"
.HP
gcloud access\-context\-manager policies remove\-iam\-policy\-binding \- remove IAM policy binding for an access policy



.SH "SYNOPSIS"
.HP
\f5gcloud access\-context\-manager policies remove\-iam\-policy\-binding\fR [\fIPOLICY\fR] \fB\-\-member\fR=\fIPRINCIPAL\fR \fB\-\-role\fR=\fIROLE\fR [\fB\-\-all\fR\ |\ \fB\-\-condition\fR=[\fIKEY\fR=\fIVALUE\fR,...]\ |\ \fB\-\-condition\-from\-file\fR=\fIPATH_TO_FILE\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Removes a policy binding to the IAM policy of an access policy, given an access
policy ID and the binding.



.SH "EXAMPLES"

To remove an IAM policy binding for the role of \f5\fIroles/editor\fR\fR for the
user 'test\-user@gmail.com' on the access policy 'accessPolicies/123', run:

.RS 2m
$ gcloud access\-context\-manager policies remove\-iam\-policy\-binding \e
    accessPolicies/123 \-\-member='user:test\-user@gmail.com' \e
    \-\-role='roles/editor'
.RE

See https://cloud.google.com/iam/docs/managing\-policies for details of policy
role and member types.



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Policy resource \- The access policy to remove the IAM binding. This represents
a Cloud resource.


.TP 2m
[\fIPOLICY\fR]

ID of the policy or fully qualified identifier for the policy.

To set the \f5policy\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5policy\fR on the command line;
.IP "\(em" 2m
set the property \f5access_context_manager/policy\fR;
.IP "\(em" 2m
automatically, if the current account belongs to an organization with exactly
one access policy..
.RE
.sp


.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-member\fR=\fIPRINCIPAL\fR

The principal to remove the binding for. Should be of the form
\f5user|group|serviceAccount:email\fR or \f5domain:domain\fR.

Examples: \f5user:test\-user@gmail.com\fR, \f5group:admins@example.com\fR,
\f5serviceAccount:test123@example.domain.com\fR, or
\f5domain:example.domain.com\fR.

Deleted principals have an additional \f5deleted:\fR prefix and a \f5?uid=UID\fR
suffix, where \f5\fIUID\fR\fR is a unique identifier for the principal. Example:
\f5deleted:user:test\-user@gmail.com?uid=123456789012345678901\fR.

Some resources also accept the following special values:
.RS 2m
.IP "\(em" 2m
\f5allUsers\fR \- Special identifier that represents anyone who is on the
internet, with or without a Google account.
.IP "\(em" 2m
\f5allAuthenticatedUsers\fR \- Special identifier that represents anyone who is
authenticated with a Google account or a service account.
.RE
.sp

.TP 2m
\fB\-\-role\fR=\fIROLE\fR

The role to remove the principal from.


.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-all\fR

Remove all bindings with this role and principal, irrespective of any
conditions.

.TP 2m
\fB\-\-condition\fR=[\fIKEY\fR=\fIVALUE\fR,...]

The condition of the binding that you want to remove. When the condition is
explicitly specified as \f5None\fR (\f5\-\-condition=None\fR), a binding without
a condition is removed. Otherwise, only a binding with a condition that exactly
matches the specified condition (including the optional description) is removed.
For more on conditions, refer to the conditions overview guide:
https://cloud.google.com/iam/docs/conditions\-overview

When using the \f5\-\-condition\fR flag, include the following key\-value pairs:

.RS 2m
.TP 2m
\fBexpression\fR
(Required) Condition expression that evaluates to True or False. This uses a
subset of Common Expression Language syntax.

If the condition expression includes a comma, use a different delimiter to
separate the key\-value pairs. Specify the delimiter before listing the
key\-value pairs. For example, to specify a colon (\f5:\fR) as the delimiter, do
the following: \f5\-\-condition=^:^title=TITLE:expression=EXPRESSION\fR. For
more information, see
https://cloud.google.com/sdk/gcloud/reference/topic/escaping.

.TP 2m
\fBtitle\fR
(Required) A short string describing the purpose of the expression.

.TP 2m
\fBdescription\fR
(Optional) Additional description for the expression.

.RE
.sp
.TP 2m
\fB\-\-condition\-from\-file\fR=\fIPATH_TO_FILE\fR

Path to a local JSON or YAML file that defines the condition. To see available
fields, see the help for \f5\-\-condition\fR. Use a full or relative path to a
local file containing the value of condition.


.RE
.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 "API REFERENCE"

This command uses the \fBaccesscontextmanager/v1\fR API. The full documentation
for this API can be found at:
https://cloud.google.com/access\-context\-manager/docs/reference/rest/



.SH "NOTES"

These variants are also available:

.RS 2m
$ gcloud alpha access\-context\-manager policies \e
    remove\-iam\-policy\-binding
.RE

.RS 2m
$ gcloud beta access\-context\-manager policies \e
    remove\-iam\-policy\-binding
.RE


