gcloud alpha pam grants

NAME

gcloud alpha pam grants - manage Privileged Access Manager grants

SYNOPSIS

gcloud alpha pam grants COMMAND [GCLOUD_WIDE_FLAG …]

DESCRIPTION

(ALPHA) The gcloud pam grants command group lets you manage Privileged Access Manager (PAM) grants.

EXAMPLES

To create a new grant against an entitlement with the full name ENTITLEMENT_NAME, a requested duration of 1 hour 30 minutes, a justification of some justification, and two additional email recipients [e-mail] and [e-mail], run:

gcloud alpha pam grants create --entitlement=ENTITLEMENT_NAME --requested-duration=5400s --justification="some justification" --additional-email-recipients=[e-mail],[e-mail]

To describe a grant with the full name GRANT_NAME, run:

gcloud alpha pam grants describe GRANT_NAME

To list all grants associated with an entitlement with the full name ENTITLEMENT_NAME, run:

gcloud alpha pam grants list --entitlement=ENTITLEMENT_NAME

To deny a grant with the full name GRANT_NAME and a reason denial reason, run:

gcloud alpha pam grants deny GRANT_NAME --reason="denial reason"

To approve a grant with the full name GRANT_NAME and a reason approval reason, run:

gcloud alpha pam grants approve GRANT_NAME --reason="approval reason"

To revoke a grant with the full name GRANT_NAME and a reason revoke reason, run:

gcloud alpha pam grants revoke GRANT_NAME --reason="revoke reason"

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

gcloud alpha pam grants search --entitlement=ENTITLEMENT_NAME --caller-relationship=had-created

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

gcloud alpha pam grants search --entitlement=ENTITLEMENT_NAME --caller-relationship=had-approved

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

gcloud alpha pam grants search --entitlement=ENTITLEMENT_NAME --caller-relationship=can-approve

GCLOUD WIDE FLAGS

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

Run $ gcloud help for details.

COMMANDS

COMMAND is one of the following:

approve

(ALPHA) Approve a Privileged Access Manager (PAM) grant.

create

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

deny

(ALPHA) Deny a Privileged Access Manager (PAM) grant.

describe

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

list

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

revoke

(ALPHA) Revoke a Privileged Access Manager (PAM) grant.

search

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

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. This variant is also available:

gcloud beta pam grants