- INFORMATION
-
gcloud preview compute target-tcp-proxies 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 preview compute target-tcp-proxies test-iam-permissions - test IAM permissions for a target TCP proxy
- SYNOPSIS
-
-
gcloud preview compute target-tcp-proxies test-iam-permissionsNAME--permissions=[PERMISSION,…] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(PREVIEW)gcloud preview compute target-tcp-proxies test-iam-permissionstests the IAM permissions that a caller has on a target TCP proxy.Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may "fail open" without warning.
- EXAMPLES
-
To test if the caller has 'compute.targetTcpProxies.get' permission on a global
target TCP proxy 'my-proxy', run:
gcloud preview compute target-tcp-proxies test-iam-permissions my-proxy --permissions=compute.targetTcpProxies.get - POSITIONAL ARGUMENTS
-
NAME- Name of the target TCP proxy to test IAM permissions for.
- REQUIRED FLAGS
-
--permissions=[PERMISSION,…]- Set of permissions to check for the resource.
- 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 DEVELOPER PREVIEW and may 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 compute target-tcp-proxies test-iam-permissionsgcloud alpha compute target-tcp-proxies test-iam-permissionsgcloud beta compute target-tcp-proxies test-iam-permissions
gcloud preview compute target-tcp-proxies 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.
[[["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-07-14 UTC."],[],[]]