gcloud beta saas-runtime unit-operations update Stay organized with collections Save and categorize content based on your preferences.
- NAME
- gcloud beta saas-runtime unit-operations update - update a Unit Operation
- SYNOPSIS
gcloud beta saas-runtime unit-operations updateUNIT_OPERATION[--cancel][--location=LOCATION][--schedule-start-time=SCHEDULE_START_TIME][--clear-parent-unit-operation|--parent-unit-operation=PARENT_UNIT_OPERATION][--clear-rollout|--rollout=ROLLOUT][--deprovision|--provision--clear-provision-release|--provision-release=PROVISION_RELEASE--provision-input-variables=[type=TYPE],[value=VALUE],[variable=VARIABLE] |--add-provision-input-variables=[type=TYPE],[value=VALUE],[variable=VARIABLE]--clear-provision-input-variables|--remove-provision-input-variables=[type=TYPE],[value=VALUE],[variable=VARIABLE] |--upgrade--clear-upgrade-release|--upgrade-release=UPGRADE_RELEASE--upgrade-input-variables=[type=TYPE],[value=VALUE],[variable=VARIABLE] |--add-upgrade-input-variables=[type=TYPE],[value=VALUE],[variable=VARIABLE]--clear-upgrade-input-variables|--remove-upgrade-input-variables=[type=TYPE],[value=VALUE],[variable=VARIABLE]][--labels=[LABELS,…] |--update-labels=[UPDATE_LABELS,…]--clear-labels|--remove-labels=REMOVE_LABELS][GCLOUD_WIDE_FLAG …]
- DESCRIPTION
(BETA)Update a Unit Operation- EXAMPLES
- To update the Unit Operation, run:
gcloudbetasaas-runtimeunit-operationsupdate - POSITIONAL ARGUMENTS
- UnitOperation resource - Identifier. The resource name (full URI of theresource) following the standard naming scheme:
"projects/{project}/locations/{location}/unitOperations/{unitOperation}"ThisrepresentsaCloudresource.(NOTE)Someattributesarenotgivenargumentsinthisgroupbutcanbesetinotherways.
To set the
projectattribute:- provide the argument
unit_operationon the command line with afully specified name; - provide the argument
--projecton the command line; - set the property
core/project.
To set the
locationattribute:- provide the argument
unit_operationon the command line with afully specified name; - provide the argument
--locationon the command line.
This must be specified.
UNIT_OPERATION- ID of the unitOperation or fully qualified identifier for the unitOperation.
To set the
unit_operationattribute:- provide the argument
unit_operationon the command line.
- provide the argument
- provide the argument
- UnitOperation resource - Identifier. The resource name (full URI of theresource) following the standard naming scheme:
- FLAGS
--cancel- When true, attempt to cancel the operation. Cancellation may fail if theoperation is already executing. (Optional)
--location=LOCATION- For resources [parent-unit-operation, provision-release, rollout,unit_operation, upgrade-release], provides fallback value for resource locationattribute. When the resource's full URI path is not provided, location willfallback to this flag value.
- A time specification to schedule the maintenance.
--schedule-start-time=SCHEDULE_START_TIME- Start of operation. If not set, will be set to the start of the next window.(optional)
- Update parent_unit_operation.
At most one of these can be specified:
--clear-parent-unit-operation- Clear parent_unit_operation value and set to null.
- ParentUnitOperation resource - Set parent_unit_operation to new value.
Reference to parent resource: UnitOperation. If an operation needs to createother operations as part of its workflow, each of the child operations shouldhave this field set to the parent. This can be used for tracing. (Optional) Thisrepresents a Cloud resource. (NOTE) Some attributes are not given arguments inthis group but can be set in other ways.
To set the
projectattribute:- provide the argument
--parent-unit-operationon the command linewith a fully specified name; - provide the argument
--projecton the command line; - set the property
core/project.
To set the
locationattribute:- provide the argument
--parent-unit-operationon the command linewith a fully specified name; - provide the argument
--locationon the command line.
--parent-unit-operation=PARENT_UNIT_OPERATION- ID of the parentUnitOperation or fully qualified identifier for theparentUnitOperation.
To set the
unit-operationattribute:- provide the argument
--parent-unit-operationon the command line.
- provide the argument
- provide the argument
- Update rollout.
At most one of these can be specified:
--clear-rollout- Clear rollout value and set to null.
- RolloutId resource - Set rollout to new value.
Specifies which rollout created this Unit Operation. This cannot be modified andis used for filtering purposes only. If a dependent unit and unit operation arecreated as part of another unit operation, they will use the same rolloutId.This represents a Cloud resource. (NOTE) Some attributes are not given argumentsin this group but can be set in other ways.
To set the
projectattribute:- provide the argument
--rollouton the command line with a fullyspecified name; - provide the argument
--projecton the command line; - set the property
core/project.
To set the
locationattribute:- provide the argument
--rollouton the command line with a fullyspecified name; - provide the argument
--locationon the command line.
--rollout=ROLLOUT- ID of the rolloutId or fully qualified identifier for the rolloutId.
To set the
rolloutattribute:- provide the argument
--rollouton the command line.
- provide the argument
- provide the argument
- Arguments for the unit operation type.
At most one of these can be specified:
- Deprovision is the unit operation that deprovision the underlying resourcesrepresented by a Unit. Can only execute if the Unit is currently provisioned.
--deprovision- This flag can be used to specify an empty deprovision operation.
- Provision is the unit operation that provision the underlying resourcesrepresented by a Unit. Can only execute if the Unit is not currentlyprovisioned.
--provision- This flag can be used to specify an empty provision operation.
- Update provision_release.
At most one of these can be specified:
--clear-provision-release- Clear provision_release value and set to null.
- Release resource - Set provision_release to new value.
Reference to the Release object to use for the Unit. (optional). This representsa Cloud resource. (NOTE) Some attributes are not given arguments in this groupbut can be set in other ways.
To set the
projectattribute:- provide the argument
--provision-releaseon the command line with afully specified name; - provide the argument
--projecton the command line; - set the property
core/project.
To set the
locationattribute:- provide the argument
--provision-releaseon the command line with afully specified name; - provide the argument
--locationon the command line.
--provision-release=PROVISION_RELEASE- ID of the release or fully qualified identifier for the release.
To set the
releaseattribute:- provide the argument
--provision-releaseon the command line.
- provide the argument
- provide the argument
- Update provision_input_variables.
At most one of these can be specified:
--provision-input-variables=[type=TYPE],[value=VALUE],[variable=VARIABLE]- Set provision_input_variables to new value. Set of input variables. Maximum 100.(optional).
type- Name of a supported variable type. Supported types are string, int, bool.
value- String encoded value for the variable.
variable- Name of the variable from actuation configs.
Shorthand Example:--provision-input-variables=type=string,value=string,variable=string--provision-input-variables=type=string,value=string,variable=string
JSON Example:--provision-input-variables='[{"type": "string", "value": "string", "variable": "string"}]'
File Example:--provision-input-variables=path_to_file.(yaml|json)
--add-provision-input-variables=[type=TYPE],[value=VALUE],[variable=VARIABLE]- Add new value to provision_input_variables list. Set of input variables. Maximum100. (optional).
type- Name of a supported variable type. Supported types are string, int, bool.
value- String encoded value for the variable.
variable- Name of the variable from actuation configs.
Shorthand Example:--add-provision-input-variables=type=string,value=string,variable=string--add-provision-input-variables=type=string,value=string,variable=string
JSON Example:--add-provision-input-variables='[{"type": "string", "value": "string", "variable": "string"}]'
File Example:--add-provision-input-variables=path_to_file.(yaml|json)
- At most one of these can be specified:
--clear-provision-input-variables- Clear provision_input_variables value and set to empty list.
--remove-provision-input-variables=[type=TYPE],[value=VALUE],[variable=VARIABLE]- Remove existing value from provision_input_variables list. Set of inputvariables. Maximum 100. (optional).
type- Name of a supported variable type. Supported types are string, int, bool.
value- String encoded value for the variable.
variable- Name of the variable from actuation configs.
Shorthand Example:--remove-provision-input-variables=type=string,value=string,variable=string--remove-provision-input-variables=type=string,value=string,variable=string
JSON Example:--remove-provision-input-variables='[{"type": "string", "value": "string", "variable": "string"}]'
File Example:--remove-provision-input-variables=path_to_file.(yaml|json)
- Upgrade is the unit operation that upgrades a provisioned unit, which may alsoinclude the underlying resources represented by a Unit. Can only execute if theUnit is currently provisioned.
--upgrade- This flag can be used to specify an empty upgrade operation.
- Update upgrade_release.
At most one of these can be specified:
--clear-upgrade-release- Clear upgrade_release value and set to null.
- Release resource - Set upgrade_release to new value.
Reference to the Release object to use for the Unit. (optional). This representsa Cloud resource. (NOTE) Some attributes are not given arguments in this groupbut can be set in other ways.
To set the
projectattribute:- provide the argument
--upgrade-releaseon the command line with afully specified name; - provide the argument
--projecton the command line; - set the property
core/project.
To set the
locationattribute:- provide the argument
--upgrade-releaseon the command line with afully specified name; - provide the argument
--locationon the command line.
--upgrade-release=UPGRADE_RELEASE- ID of the release or fully qualified identifier for the release.
To set the
releaseattribute:- provide the argument
--upgrade-releaseon the command line.
- provide the argument
- provide the argument
- Update upgrade_input_variables.
At most one of these can be specified:
--upgrade-input-variables=[type=TYPE],[value=VALUE],[variable=VARIABLE]- Set upgrade_input_variables to new value. Set of input variables. Maximum 100.(optional).
type- Name of a supported variable type. Supported types are string, int, bool.
value- String encoded value for the variable.
variable- Name of the variable from actuation configs.
Shorthand Example:--upgrade-input-variables=type=string,value=string,variable=string--upgrade-input-variables=type=string,value=string,variable=string
JSON Example:--upgrade-input-variables='[{"type": "string", "value": "string", "variable": "string"}]'
File Example:--upgrade-input-variables=path_to_file.(yaml|json)
--add-upgrade-input-variables=[type=TYPE],[value=VALUE],[variable=VARIABLE]- Add new value to upgrade_input_variables list. Set of input variables. Maximum100. (optional).
type- Name of a supported variable type. Supported types are string, int, bool.
value- String encoded value for the variable.
variable- Name of the variable from actuation configs.
Shorthand Example:--add-upgrade-input-variables=type=string,value=string,variable=string--add-upgrade-input-variables=type=string,value=string,variable=string
JSON Example:--add-upgrade-input-variables='[{"type": "string", "value": "string", "variable": "string"}]'
File Example:--add-upgrade-input-variables=path_to_file.(yaml|json)
- At most one of these can be specified:
--clear-upgrade-input-variables- Clear upgrade_input_variables value and set to empty list.
--remove-upgrade-input-variables=[type=TYPE],[value=VALUE],[variable=VARIABLE]- Remove existing value from upgrade_input_variables list. Set of input variables.Maximum 100. (optional).
type- Name of a supported variable type. Supported types are string, int, bool.
value- String encoded value for the variable.
variable- Name of the variable from actuation configs.
Shorthand Example:--remove-upgrade-input-variables=type=string,value=string,variable=string--remove-upgrade-input-variables=type=string,value=string,variable=string
JSON Example:--remove-upgrade-input-variables='[{"type": "string", "value": "string", "variable": "string"}]'
File Example:--remove-upgrade-input-variables=path_to_file.(yaml|json)
- Deprovision is the unit operation that deprovision the underlying resourcesrepresented by a Unit. Can only execute if the Unit is currently provisioned.
- Update labels.
At most one of these can be specified:
--labels=[LABELS,…]- Set labels to new value. The labels on the resource, which can be used forcategorization. similar to Kubernetes resource labels.
KEY- Keys must start with a lowercase character and contain only hyphens(
-), underscores (_), lowercase characters, andnumbers. VALUE- Values must contain only hyphens (
-), underscores (_),lowercase characters, and numbers.
Shorthand Example:--labels=string=string
JSON Example:--labels='{"string": "string"}'
File Example:--labels=path_to_file.(yaml|json)
--update-labels=[UPDATE_LABELS,…]- Update labels value or add key value pair. The labels on the resource, which canbe used for categorization. similar to Kubernetes resource labels.
KEY- Keys must start with a lowercase character and contain only hyphens(
-), underscores (_), lowercase characters, andnumbers. VALUE- Values must contain only hyphens (
-), underscores (_),lowercase characters, and numbers.
Shorthand Example:--update-labels=string=string
JSON Example:--update-labels='{"string": "string"}'
File Example:--update-labels=path_to_file.(yaml|json)
- At most one of these can be specified:
--clear-labels- Clear labels value and set to empty map.
--remove-labels=REMOVE_LABELS- Remove existing value from map labels. Sets
remove_labelsvalue.Shorthand Example:--remove-labels=string,stringJSON Example:--remove-labels=["string"]
File Example:--remove-labels=path_to_file.(yaml|json)
- 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
saasservicemgmt/v1beta1API. The fulldocumentation for this API can be found at:https://cloud.google.com/saas-runtime/docs - NOTES
- This command is currently in beta and might change without notice.
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-10-07 UTC.