- NAME
-
- gcloud beta kms inventory get-protected-resources-summary - gets the protected resources summary
- SYNOPSIS
-
-
gcloud beta kms inventory get-protected-resources-summary(--keyname=KEYNAME:--keyring=KEYRING--location=LOCATION) [--fallback-scope=FALLBACK_SCOPE] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(BETA)gcloud beta kms inventory get-protected-resources-summaryreturns a summary of the resources a key is protecting.The summary includes how many projects contain protected resources, how many protected resources there are, what are the types of protected resources, and the count for each type of protected resource.
- EXAMPLES
-
To view the summary of protected resources for the key
projects/test-prj/locations/us/keyRings/us-keyring/cryptoKeys/us-key, run:gcloud beta kms inventory get-protected-resources-summary --keyname=projects/test-prj/locations/us/keyRings/us-keyring/cryptoKeys/us-key - REQUIRED FLAGS
-
-
Key resource - The KMS key resource. 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
projectattribute:-
provide the argument
--keynameon the command line with a fully specified name; -
set the property
core/project.
This must be specified.
--keyname=KEYNAME-
ID of the key or fully qualified identifier for the key.
To set the
keyattribute:-
provide the argument
--keynameon the command line.
This flag argument must be specified if any of the other arguments in this group are specified.
-
provide the argument
--keyring=KEYRING-
The KMS keyring of the key.
To set the
keyringattribute:-
provide the argument
--keynameon the command line with a fully specified name; -
provide the argument
--keyringon the command line.
-
provide the argument
--location=LOCATION-
The Google Cloud location for the key.
To set the
locationattribute:-
provide the argument
--keynameon the command line with a fully specified name; -
provide the argument
--locationon the command line.
-
provide the argument
-
provide the argument
-
Key resource - The KMS key resource. 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.
- OPTIONAL FLAGS
-
--fallback-scope=FALLBACK_SCOPE-
If permission is denied at the organization level, fall back to the project
level scope.
FALLBACK_SCOPEmust be one of:FALLBACK_SCOPE_UNSPECIFIED,FALLBACK_SCOPE_PROJECT.
- 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 helpfor details. - NOTES
-
This command is currently in beta and might change without notice. These
variants are also available:
gcloud kms inventory get-protected-resources-summarygcloud alpha kms inventory get-protected-resources-summary
gcloud beta kms inventory get-protected-resources-summary
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-03-24 UTC.