mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-11 15:39:42 +00:00
116 lines
4.5 KiB
Text
116 lines
4.5 KiB
Text
NAME
|
|
gcloud alpha pam grants create - create a new Privileged Access Manager
|
|
grant
|
|
|
|
SYNOPSIS
|
|
gcloud alpha pam grants create --requested-duration=REQUESTED_DURATION
|
|
(--entitlement=ENTITLEMENT
|
|
: --folder=FOLDER --location=LOCATION --organization=ORGANIZATION)
|
|
[--additional-email-recipients=[ADDITIONAL_EMAIL_RECIPIENTS,...]]
|
|
[--justification=JUSTIFICATION] [GCLOUD_WIDE_FLAG ...]
|
|
|
|
DESCRIPTION
|
|
(ALPHA) Create a new Privileged Access Manager (PAM) grant under an
|
|
entitlement.
|
|
|
|
EXAMPLES
|
|
The following command creates a new grant against the 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
|
|
abc@example.com and xyz@example.com:
|
|
|
|
$ gcloud alpha pam grants create --entitlement=ENTITLEMENT_NAME \
|
|
--requested-duration=5400s \
|
|
--justification="some justification" \
|
|
--additional-email-recipients=abc@example.com,xyz@example.com
|
|
|
|
REQUIRED FLAGS
|
|
--requested-duration=REQUESTED_DURATION
|
|
Duration of the grant being created.
|
|
|
|
Entitlement resource - Entitlement the grant is to be created against. 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 project attribute:
|
|
◆ provide the argument --entitlement on the command line with a fully
|
|
specified name;
|
|
◆ provide the argument --project on the command line;
|
|
◆ set the property core/project. This resource can be one of the
|
|
following types:
|
|
[privilegedaccessmanager.projects.locations.entitlements,
|
|
privilegedaccessmanager.folders.locations.entitlements,
|
|
privilegedaccessmanager.organizations.locations.entitlements].
|
|
|
|
This must be specified.
|
|
|
|
--entitlement=ENTITLEMENT
|
|
ID of the entitlement or fully qualified identifier for the
|
|
entitlement.
|
|
|
|
To set the entitlement attribute:
|
|
▸ provide the argument --entitlement on the command line.
|
|
|
|
This flag argument must be specified if any of the other arguments in
|
|
this group are specified.
|
|
|
|
--folder=FOLDER
|
|
The name of the folder
|
|
|
|
To set the folder attribute:
|
|
▸ provide the argument --entitlement on the command line with a
|
|
fully specified name;
|
|
▸ provide the argument --folder on the command line. Must be
|
|
specified for resource of type
|
|
[privilegedaccessmanager.folders.locations.entitlements].
|
|
|
|
--location=LOCATION
|
|
The resource location
|
|
|
|
To set the location attribute:
|
|
▸ provide the argument --entitlement on the command line with a
|
|
fully specified name;
|
|
▸ provide the argument --location on the command line.
|
|
|
|
--organization=ORGANIZATION
|
|
The name of the organization
|
|
|
|
To set the organization attribute:
|
|
▸ provide the argument --entitlement on the command line with a
|
|
fully specified name;
|
|
▸ provide the argument --organization on the command line. Must be
|
|
specified for resource of type
|
|
[privilegedaccessmanager.organizations.locations.entitlements].
|
|
|
|
OPTIONAL FLAGS
|
|
--additional-email-recipients=[ADDITIONAL_EMAIL_RECIPIENTS,...]
|
|
Additional email addresses that are notified for all actions performed
|
|
on the grant.
|
|
|
|
--justification=JUSTIFICATION
|
|
Justification for the grant.
|
|
|
|
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 $ gcloud help for details.
|
|
|
|
API REFERENCE
|
|
This command uses the privilegedaccessmanager/v1alpha API. The full
|
|
documentation for this API can be found at:
|
|
https://cloud.google.com/iam/docs/pam-overview
|
|
|
|
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:
|
|
|
|
$ gcloud pam grants create
|
|
|
|
$ gcloud beta pam grants create
|
|
|