gcloud alpha compute os-config policy-orchestrators update

NAME
gcloud alpha compute os-config policy-orchestrators update - update a policy orchestrator
SYNOPSIS
gcloud alpha compute os-config policy-orchestrators update (POLICY_ORCHESTRATOR : --folder=FOLDER --organization=ORGANIZATION) [--action=ACTION] [--async] [--policy-file=POLICY_FILE] [--policy-id=POLICY_ID] [--state=STATE] [--clear-folders     | --include-folders=INCLUDE_FOLDERS] [--clear-locations     | --include-locations=INCLUDE_LOCATIONS] [--clear-projects     | --include-projects=INCLUDE_PROJECTS] [GCLOUD_WIDE_FLAG …]
DESCRIPTION
(ALPHA) Update a policy orchestrator.
EXAMPLES

To update an policy orchestrator my-orchestrator in folder 123456 with config file /path/to/file/config.yaml, run: 

gcloud alpha compute os-config policy-orchestrators update my-orchestrator --folder=123456 --policy-file=/path/to/file/config.yaml

To update an policy orchestrator my-orchestrator in folder 123456 with state STOPPED, run: 

gcloud alpha compute os-config policy-orchestrators update my-orchestrator --folder=123456 --state=stopped
POSITIONAL ARGUMENTS
Policy orchestrator resource - Policy orchestrator to update. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways.

To set the project attribute:

  • provide the argument policy_orchestrator on the command line with a fully specified name;
  • provide the argument --project on the command line;
  • set the property core/project. This resource can be one of the following types: [policy_orchestrator_project, policy_orchestrator_folder, policy_orchestrator_organization].

This must be specified.

POLICY_ORCHESTRATOR
ID of the policy_orchestrator or fully qualified identifier for the policy_orchestrator.

To set the policy_orchestrator attribute:

  • provide the argument policy_orchestrator on the command line.

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

--folder=FOLDER
Folder of the policy_orchestrator. To set the folder attribute:
  • provide the argument policy_orchestrator on the command line with a fully specified name;
  • provide the argument --folder on the command line. Must be specified for resource of type [policy_orchestrator_folder].
--organization=ORGANIZATION
Organization of the policy_orchestrator. To set the organization attribute:
  • provide the argument policy_orchestrator on the command line with a fully specified name;
  • provide the argument --organization on the command line. Must be specified for resource of type [policy_orchestrator_organization].
FLAGS
--action=ACTION
Action to be taken on policy. ACTION must be one of:
delete
Delete a policy with a given name. policy-id must be specified.
upsert
Create or update a policy. policy-file must be specified.
--async
Return immediately, without waiting for the operation in progress to complete.
--policy-file=POLICY_FILE
Absolute path to the OS policy assignment file on your local client. File must be in either JSON or YAML format. This file defines the OS policies that you want to apply to your VMs, the target VMs that you want to apply the policies to, and the rollout rate at which to apply the OS policies on a zonal level. For more information about this resource and sample OS policy assignment files, see https://cloud.google.com/compute/docs/os-configuration-management/working-with-os-policies#os-policy-assignment.
--policy-id=POLICY_ID
Policy id. Must be specified for DELETE action.
--state=STATE
State of the policy orchestrator. STATE must be one of:
active
Updates the policy orchestrator to ACTIVE state.
stopped
Updates the policy orchestrator to STOPPED state.
Folders to include in the policy orchestrator. Comma-separated list of folder numbers. If --include-folders is set, --clear-folders must not be set. At most one of these can be specified:
--clear-folders
Clears included folders from policy orchestrator selectors.
--include-folders=INCLUDE_FOLDERS
Applies policy to selected folders only.
Locations to include in the policy orchestrator, e.g. us-central1-a. If include-locations is set, clear-locations must not be set. At most one of these can be specified:
--clear-locations
Clears included locations from policy orchestrator selectors.
--include-locations=INCLUDE_LOCATIONS
Applies policy to selected locations only.
Projects to include in the policy orchestrator. Comma separated list of project numbers. If include-projects is set, clear-projects must not be set. At most one of these can be specified:
--clear-projects
Clears included projects from policy orchestrator selectors.
--include-projects=INCLUDE_PROJECTS
Applies policy to selected projects only.
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 osconfig/v2alpha API. The full documentation for this API can be found at: https://cloud.google.com/compute/docs/osconfig/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 beta compute os-config policy-orchestrators update