gcloud alpha access-context-manager cloud-bindings update

NAME

gcloud alpha access-context-manager cloud-bindings update - update an existing access binding under an organization

SYNOPSIS

gcloud alpha access-context-manager cloud-bindings update (--binding=BINDING : --organization=ORGANIZATION) [--binding-file=YAML_FILE] [--dry-run-level=[DRY_RUN_LEVEL,…]] [--level=[LEVEL,…]] [--restricted-client-application-client-ids=[RESTRICTED_CLIENT_APPLICATION_CLIENT_IDS,…]] [--restricted-client-application-names=[RESTRICTED_CLIENT_APPLICATION_NAMES,…]] [GCLOUD_WIDE_FLAG …]

DESCRIPTION

(ALPHA) Update an existing access binding. You can update the level, dry run level, scoped access settings, restricted client application client IDs and restricted client application names. They can't all be empty.

EXAMPLES

To update an existing access binding, run:

gcloud alpha access-context-manager cloud-bindings update --binding=my-binding-id --level=accessPolicies/123/accessLevels/new-abc

To remove level and add dry run level, run:

gcloud alpha access-context-manager cloud-bindings update --binding=my-binding-id --level= --dry-run-level=accessPolicies/123/accessLevels/new-def

To update restricted client applications, run:

gcloud alpha access-context-manager cloud-bindings update --binding=my-binding-id --restricted-client-application-client-ids='123.apps.googleusercontent.com' --restricted-client-application-names='Cloud Console, Google
 Cloud SDK'

Or

gcloud alpha access-context-manager cloud-bindings update --binding=my-binding-id --binding-file='binding.yaml'

REQUIRED FLAGS

Cloud access binding resource - The cloud access binding you want to update. The arguments in this group can be used to specify the attributes of this resource.

This must be specified.

--binding=BINDING

ID of the cloud-access-binding or fully qualified identifier for the cloud-access-binding.

To set the binding attribute:

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

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

--organization=ORGANIZATION

The ID of the organization. To set the organization attribute:

• provide the argument --binding on the command line with a fully specified name;
• provide the argument --organization on the command line;
• set the property access_context_manager/organization.

OPTIONAL FLAGS

--binding-file=YAML_FILE

Path to the file that contains a Google Cloud Platform user access binding.

This file contains a YAML-compliant object representing a GcpUserAccessBinding (as described in the API reference) containing ScopedAccessSettings only. No other binding fields are allowed.

The file content replaces the corresponding fields in the existing binding.

--dry-run-level=[DRY_RUN_LEVEL,…]

The dry run access level that replaces the existing dry run level for the given binding. The input must be the full identifier of an access level, such as accessPolicies/123/accessLevels/new-def.

--level=[LEVEL,…]

The access level that replaces the existing level for the given binding. The input must be the full identifier of an access level, such as accessPolicies/123/accessLevels/new-abc.

--restricted-client-application-client-ids=[RESTRICTED_CLIENT_APPLICATION_CLIENT_IDS,…]

The application client IDs that replace the existing application client IDs for the restricted client applications in the given binding.

--restricted-client-application-names=[RESTRICTED_CLIENT_APPLICATION_NAMES,…]

The application names that replace the existing application names for the restricted client applications in the given binding.

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 the accesscontextmanager/v1alpha API. The full documentation for this API can be found at: https://cloud.google.com/access-context-manager/docs/reference/rest/

NOTES

This command is currently in alpha and might 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. This variant is also available:

gcloud access-context-manager cloud-bindings update