.TH "GCLOUD_ALPHA_PAM_GRANTS" 1



.SH "NAME"
.HP
gcloud alpha pam grants \- manage Privileged Access Manager grants



.SH "SYNOPSIS"
.HP
\f5gcloud alpha pam grants\fR \fICOMMAND\fR [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR The \f5gcloud pam grants\fR command group lets you manage
Privileged Access Manager (PAM) grants.



.SH "EXAMPLES"

To create a new grant against an entitlement with the full name
\f5\fIENTITLEMENT_NAME\fR\fR, a requested duration of \f51 hour 30 minutes\fR, a
justification of \f5some justification\fR, and two additional email recipients
\f5abc@example.com\fR and \f5xyz@example.com\fR, run:

.RS 2m
$ gcloud alpha pam grants create \-\-entitlement=ENTITLEMENT_NAME \e
  \-\-requested\-duration=5400s \e
  \-\-justification="some justification" \e
  \-\-additional\-email\-recipients=abc@example.com,xyz@example.com
.RE

To describe a grant with the full name \f5\fIGRANT_NAME\fR\fR, run:

.RS 2m
$ gcloud alpha pam grants describe GRANT_NAME
.RE

To list all grants associated with an entitlement with the full name
\f5\fIENTITLEMENT_NAME\fR\fR, run:

.RS 2m
$ gcloud alpha pam grants list \-\-entitlement=ENTITLEMENT_NAME
.RE

To deny a grant with the full name \f5\fIGRANT_NAME\fR\fR and a reason \f5denial
reason\fR, run:

.RS 2m
$ gcloud alpha pam grants deny GRANT_NAME \-\-reason="denial reason"
.RE

To approve a grant with the full name \f5\fIGRANT_NAME\fR\fR and a reason
\f5approval reason\fR, run:

.RS 2m
$ gcloud alpha pam grants approve GRANT_NAME \e
  \-\-reason="approval reason"
.RE

To revoke a grant with the full name \f5\fIGRANT_NAME\fR\fR and a reason
\f5revoke reason\fR, run:

.RS 2m
$ gcloud alpha pam grants revoke GRANT_NAME \-\-reason="revoke reason"
.RE

To search for and list all grants that you have created that are associated with
an entitlement with the full name \f5\fIENTITLEMENT_NAME\fR\fR, run:

.RS 2m
$ gcloud alpha pam grants search \-\-entitlement=ENTITLEMENT_NAME \e
  \-\-caller\-relationship=had\-created
.RE

To search for and list all grants that you have approved or denied, that are
associated with an entitlement with the full name \f5\fIENTITLEMENT_NAME\fR\fR,
run:

.RS 2m
$ gcloud alpha pam grants search \-\-entitlement=ENTITLEMENT_NAME \e
  \-\-caller\-relationship=had\-approved
.RE

To search for and list all grants that you can approve that are associated with
an entitlement with the full name \f5\fIENTITLEMENT_NAME\fR\fR, run:

.RS 2m
$ gcloud alpha pam grants search \-\-entitlement=ENTITLEMENT_NAME \e
  \-\-caller\-relationship=can\-approve
.RE

To withdraw a grant with the full name \f5\fIGRANT_NAME\fR\fR, run:

.RS 2m
$ gcloud alpha pam grants withdraw GRANT_NAME
.RE



.SH "GCLOUD WIDE FLAGS"

These flags are available to all commands: \-\-help.

Run \fB$ gcloud help\fR for details.



.SH "COMMANDS"

\f5\fICOMMAND\fR\fR is one of the following:

.RS 2m
.TP 2m
\fBapprove\fR

\fB(ALPHA)\fR Approve a Privileged Access Manager (PAM) grant.

.TP 2m
\fBcreate\fR

\fB(ALPHA)\fR Create a new Privileged Access Manager (PAM) grant.

.TP 2m
\fBdeny\fR

\fB(ALPHA)\fR Deny a Privileged Access Manager (PAM) grant.

.TP 2m
\fBdescribe\fR

\fB(ALPHA)\fR Show details of a Privileged Access Manager (PAM) grant.

.TP 2m
\fBlist\fR

\fB(ALPHA)\fR List all Privileged Access Manager (PAM) grants associated with an
entitlement.

.TP 2m
\fBrevoke\fR

\fB(ALPHA)\fR Revoke a Privileged Access Manager (PAM) grant.

.TP 2m
\fBsearch\fR

\fB(ALPHA)\fR Search for and list all Privileged Access Manager (PAM) grants you
have created, have approved, or can approve.

.TP 2m
\fBwithdraw\fR

\fB(ALPHA)\fR Withdraw a Privileged Access Manager (PAM) grant.


.RE
.sp

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

.RS 2m
$ gcloud beta pam grants
.RE