.TH "GCLOUD_FUNCTIONS_ADD\-INVOKER\-POLICY\-BINDING" 1



.SH "NAME"
.HP
gcloud functions add\-invoker\-policy\-binding \- adds an invoker binding to the IAM policy of a Google Cloud Function



.SH "SYNOPSIS"
.HP
\f5gcloud functions add\-invoker\-policy\-binding\fR (\fINAME\fR\ :\ \fB\-\-region\fR=\fIREGION\fR) \fB\-\-member\fR=\fIPRINCIPAL\fR [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Adds an invoker role IAM policy binding that allows the specified member to
invoke the specified function.

For Cloud Functions (1st gen), this adds the Cloud Functions Invoker binding to
the IAM policy of the specified function.

For Cloud Functions (2nd gen), this adds the Cloud Run Invoker binding to the
IAM policy of the specified function's underlying Cloud Run service.



.SH "EXAMPLES"

To add the invoker role policy binding for \f5FUNCTION\-1\fR for member
\f5MEMBER\-1\fR run:

.RS 2m
$ gcloud functions add\-invoker\-policy\-binding FUNCTION\-1 \e
    \-\-member=MEMBER\-1
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Function resource \- The Cloud Function name to add the invoker binding to. The
arguments in this group can be used to specify the attributes of this 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 \f5NAME\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
\fINAME\fR

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

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

This positional argument must be specified if any of the other arguments in this
group are specified.

.TP 2m
\fB\-\-region\fR=\fIREGION\fR

The Cloud region for the function. Overrides the default \f5functions/region\fR
property value for this command invocation.

To set the \f5region\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5NAME\fR on the command line with a fully specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-region\fR on the command line;
.IP "\(bu" 2m
set the property \f5functions/region\fR.
.RE
.sp


.RE
.RE
.sp

.SH "REQUIRED FLAGS"

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

The principal to add to the IAM policy. 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.

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


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

These variants are also available:

.RS 2m
$ gcloud alpha functions add\-invoker\-policy\-binding
.RE

.RS 2m
$ gcloud beta functions add\-invoker\-policy\-binding
.RE