gcloud pam entitlements search

NAME
gcloud pam entitlements search - search and list all Privileged Access Manager entitlements in a parent for which you are a requester/approver
SYNOPSIS
gcloud pam entitlements search--caller-access-type=CALLER_ACCESS_TYPE(--location=LOCATION :--folder=FOLDER--organization=ORGANIZATION)[--filter=EXPRESSION][--limit=LIMIT][--page-size=PAGE_SIZE][--sort-by=[FIELD,…]][GCLOUD_WIDE_FLAG]
DESCRIPTION
Search and list all Privileged Access Manager (PAM) entitlements in aproject/folder/organization location for which you are a requester/approver.
EXAMPLES
The following command searches for and lists all entitlements for which you area requester, in a project namedsample-project, and in locationglobal:
gcloudpamentitlementssearch--project=sample-project--location=global--caller-access-type=grant-requester

The following command searches for and lists all entitlements for which you arean approver, in a project namedsample-project, and in locationglobal:

gcloudpamentitlementssearch--project=sample-project--location=global--caller-access-type=grant-approver

The following command searches for and lists all entitlements for which you area requester, in a folder with IDFOLDER_ID,and in locationglobal:

gcloudpamentitlementssearch--folder=FOLDER_ID--location=global--caller-access-type=grant-requester

The following command searches for and lists all entitlements for which you arean approver, in a folder with IDFOLDER_ID,and in locationglobal:

gcloudpamentitlementssearch--folder=FOLDER_ID--location=global--caller-access-type=grant-approver

The following command searches for and lists all entitlements for which you area requester, in an organization with IDORGANIZATION_ID, and in locationglobal:

gcloudpamentitlementssearch--organization=ORGANIZATION_ID--location=global--caller-access-type=grant-requester

The following command searches for and lists all entitlements for which you arean approver, in an organization with IDORGANIZATION_ID, and in locationglobal:

gcloudpamentitlementssearch--organization=ORGANIZATION_ID--location=global--caller-access-type=grant-approver
REQUIRED FLAGS
--caller-access-type=CALLER_ACCESS_TYPE
Search for entitlements based on whether you are a requester or approver.CALLER_ACCESS_TYPE must be one of:grant-approver,grant-requester.
Location resource - Location of the entitlements. The arguments in this groupcan be used to specify the attributes of this resource. (NOTE) Some attributesare not given arguments in this group but can be set in other ways.

To set theproject attribute:

  • provide the argument--location on the command line with a fullyspecified name;
  • provide the argument--project on the command line;
  • set the propertycore/project. This resource can be one of thefollowing types: [privilegedaccessmanager.projects.locations,privilegedaccessmanager.folders.locations,privilegedaccessmanager.organizations.locations].

This must be specified.

--location=LOCATION
ID of the location or fully qualified identifier for the location.

To set thelocation attribute:

  • provide the argument--location on the command line.

This flag argument must be specified if any of the other arguments in this groupare specified.

--folder=FOLDER
The name of the folder

To set thefolder attribute:

  • provide the argument--location on the command line with a fullyspecified name;
  • provide the argument--folder on the command line. Must bespecified for resource of type [privilegedaccessmanager.folders.locations].
--organization=ORGANIZATION
The name of the organization

To set theorganization attribute:

  • provide the argument--location on the command line with a fullyspecified name;
  • provide the argument--organization on the command line. Must bespecified for resource of type[privilegedaccessmanager.organizations.locations].
LIST COMMAND FLAGS
--filter=EXPRESSION
Apply a Boolean filterEXPRESSION to each resource itemto be listed. If the expression evaluatesTrue, then that item islisted. For more details and examples of filter expressions, run $gcloud topic filters. This flaginteracts with other flags that are applied in this order:--flatten,--sort-by,--filter,--limit.
--limit=LIMIT
Maximum number of resources to list. The default isunlimited. Thisflag interacts with other flags that are applied in this order:--flatten,--sort-by,--filter,--limit.
--page-size=PAGE_SIZE
Some services group resource list output into pages. This flag specifies themaximum number of resources per page. The default is determined by the serviceif it supports paging, otherwise it isunlimited (no paging).Paging may be applied before or after--filter and--limit depending on the service.
--sort-by=[FIELD,…]
Comma-separated list of resource field key names to sort by. The default orderis ascending. Prefix a field with ``~´´ for descending order on thatfield. This flag interacts with other flags that are applied in this order:--flatten,--sort-by,--filter,--limit.
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 theprivilegedaccessmanager/v1 API. The fulldocumentation for this API can be found at:https://cloud.google.com/iam/docs/pam-overview
NOTES
These variants are also available:
gcloudalphapamentitlementssearch
gcloudbetapamentitlementssearch

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-05-07 UTC.