- NAME
-
- gcloud beta compute reservations sub-blocks test-iam-permissions - test IAM permissions on a Compute Engine reservation sub-block
- SYNOPSIS
-
-
gcloud beta compute reservations sub-blocks test-iam-permissionsRESERVATION--block-name=BLOCK_NAME--permissions=[PERMISSION,…]--sub-block-name=SUB_BLOCK_NAME[--zone=ZONE] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(BETA)Returns the subset of permissions that the caller has on the specified Compute Engine reservation sub-block. - EXAMPLES
-
To test the 'compute.reservations.get' and 'compute.reservations.update'
permissions on a reservation sub-block named 'my-sub-block', which is part of
block 'my-block' under reservation 'my-reservation' in zone 'us-central1-a',
run:
gcloud beta compute reservations sub-blocks test-iam-permissions my-reservation --zone=us-central1-a --block-name=my-block --sub-block-name=my-sub-block --permissions=compute.reservations.get,compute.reservations.update - POSITIONAL ARGUMENTS
-
RESERVATION- Name of the reservation to test-iam-permissions.
- REQUIRED FLAGS
-
--block-name=BLOCK_NAME- The name of the reservation block.
--permissions=[PERMISSION,…]- Set of permissions to check for the resource.
--sub-block-name=SUB_BLOCK_NAME- The name of the reservation sub block.
- OPTIONAL FLAGS
-
--zone=ZONE-
Zone of the reservation to test-iam-permissions. If not specified and the
property isn't set, you might be prompted to select a zone (interactive mode only).compute/zoneTo avoid prompting when this flag is omitted, you can set the
property:compute/zonegcloud config set compute/zone ZONEA list of zones can be fetched by running:
gcloud compute zones listTo unset the property, run:
gcloud config unset compute/zoneAlternatively, the zone can be stored in the environment variable
.CLOUDSDK_COMPUTE_ZONE
- 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 compute reservations sub-blocks test-iam-permissionsgcloud preview compute reservations sub-blocks test-iam-permissions
gcloud beta compute reservations sub-blocks test-iam-permissions
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-07-14 UTC.