- INFORMATION
-
gcloud compute instance-templates test-iam-permissionsis supported in universe domainuniverse; however, some of the values used in the help text may not be available. Command examples may not work as-is and may requires changes before execution. - NAME
-
- gcloud compute instance-templates test-iam-permissions - test IAM permissions for a Compute Engine instance template
- SYNOPSIS
-
-
gcloud compute instance-templates test-iam-permissionsINSTANCE_TEMPLATE--permissions=[PERMISSIONS,…] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
- Returns permissions that a caller has on the specified instance template.
- EXAMPLES
-
To test if the caller has
compute.instanceTemplates.getpermission on an instance template, run:gcloud compute instance-templates test-iam-permissions my-instance-template --permissions=compute.instanceTemplates.get - POSITIONAL ARGUMENTS
-
-
Instance template resource - The instance template for which to test
permissions. This represents a Cloud 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
instance_templateon the command line with a fully specified name; -
provide the argument
--projecton the command line; -
set the property
core/project.
This must be specified.
INSTANCE_TEMPLATE-
ID of the instance_template or fully qualified identifier for the
instance_template.
To set the
instance_templateattribute:-
provide the argument
instance_templateon the command line.
-
provide the argument
-
provide the argument
-
Instance template resource - The instance template for which to test
permissions. This represents a Cloud resource. (NOTE) Some attributes are not
given arguments in this group but can be set in other ways.
- REQUIRED FLAGS
-
--permissions=[PERMISSIONS,…]- Permissions to be tested.
- 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. - API REFERENCE
-
This command uses the
compute/v1API. The full documentation for this API can be found at: https://cloud.google.com/compute/ - NOTES
-
These variants are also available:
gcloud alpha compute instance-templates test-iam-permissionsgcloud beta compute instance-templates test-iam-permissionsgcloud preview compute instance-templates test-iam-permissions
gcloud compute instance-templates 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-06-30 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-06-30 UTC."],[],[]]