.TH "GCLOUD_SECRETS_REMOVE\-IAM\-POLICY\-BINDING" 1



.SH "NAME"
.HP
gcloud secrets remove\-iam\-policy\-binding \- remove IAM policy binding for a secret



.SH "SYNOPSIS"
.HP
\f5gcloud secrets remove\-iam\-policy\-binding\fR \fISECRET\fR \fB\-\-member\fR=\fIPRINCIPAL\fR \fB\-\-role\fR=\fIROLE\fR [\fB\-\-location\fR=\fILOCATION\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 from the IAM policy of a secret. One binding consists
of a member and a role.

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



.SH "EXAMPLES"

To remove an IAM policy binding for the role of 'roles/viewer' for the user
\'test\-user@gmail.com' on the my\-secret, run:

.RS 2m
$ gcloud secrets remove\-iam\-policy\-binding my\-secret \e
    \-\-member='user:test\-user@gmail.com' \-\-role='roles/viewer'
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Secret resource \- Name of the secret from which to remove IAM policy binding.
This represents a Cloud resource. (NOTE) Some attributes are not given arguments
in this group but can be set in other ways.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5SECRET\fR on the command line with a fully specified
name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fISECRET\fR

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

To set the \f5secret\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5SECRET\fR on the command line.
.RE
.sp


.RE
.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

Location resource \- The location to remove iam policy. This represents a Cloud
resource. (NOTE) Some attributes are not given arguments in this group but can
be set in other ways.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-location\fR on the command line with a fully
specified name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp


.RS 2m
.TP 2m
\fB\-\-location\fR=\fILOCATION\fR

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

To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-location\fR on the command line.
.RE
.sp

.RE
.sp
.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 "NOTES"

This variant is also available:

.RS 2m
$ gcloud beta secrets remove\-iam\-policy\-binding
.RE