.TH "GCLOUD_ALPHA_SERVICES_POLICIES_UPDATE" 1



.SH "NAME"
.HP
gcloud alpha services policies update \- update consumer policy for a project, folder or organization



.SH "SYNOPSIS"
.HP
\f5gcloud alpha services policies update\fR \fB\-\-consumer\-policy\-file\fR=\fICONSUMER_POLICY_FILE\fR [\fB\-\-bypass\-api\-usage\-check\fR] [\fB\-\-bypass\-dependency\-check\fR] [\fB\-\-validate\-only\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR Update consumer policy for a project, folder or organization.



.SH "EXAMPLES"

Update consumer policy

.RS 2m
$ gcloud alpha services policies update \e
     \-\-consumer\-policy\-file=/path/to/the/file.yaml
.RE

Validate the update action on the policy:

.RS 2m
$ gcloud alpha services policies update \e
     \-\-consumer\-policy\-file=/path/to/the/file.yaml \-\-validate\-only
.RE

Update consumer policy and bypass dependency check:

.RS 2m
$ gcloud alpha services policies update \e
     \-\-consumer\-policy\-file=/path/to/the/file.yaml \e
     \-\-bypass\-dependency\-check
.RE

Update consumer policy and bypass api usage check:

.RS 2m
$ gcloud alpha services policies update \e
     \-\-consumer\-policy\-file=/path/to/the/file.yaml \e
     \-\-bypass\-api\-usage\-check
.RE



.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-consumer\-policy\-file\fR=\fICONSUMER_POLICY_FILE\fR

Path to the file that contains the consumer policy in the YAML format.


.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-bypass\-api\-usage\-check\fR

If true, the system will bypass usage checks for services that are being
removed. If false, the system will check if the service to be removed was used
in the last 30 days or enabled in the last 3 days. If so, an error will be
returned.

.TP 2m
\fB\-\-bypass\-dependency\-check\fR

This flag controls dependency management within the consumer policy. If false,
dependencies are enforced. When adding a new service, it verifies that all the
services dependencies are already present in the policy. When removing a
service, the system will ensure that no other services in the policy depend on
it. If the policy lacks any required dependencies, the update will not succeed,
and an error will be returned.

.TP 2m
\fB\-\-validate\-only\fR

Validate the to update action, but don't actually perform it


.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "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.