gcloud service-extensions wasm-plugins update Stay organized with collections Save and categorize content based on your preferences.
- NAME
- gcloud service-extensions wasm-plugins update - update a
WasmPluginresource
- gcloud service-extensions wasm-plugins update - update a
- SYNOPSIS
gcloud service-extensions wasm-plugins update(WASM_PLUGIN:--location=LOCATION)[--async][--description=DESCRIPTION][--labels=[KEY=VALUE,…]][--log-config=[LOG_CONFIG,…]][--image=IMAGE--main-version=MAIN_VERSION--plugin-config=PLUGIN_CONFIG|--plugin-config-file=PATH_TO_FILE|--plugin-config-uri=PLUGIN_CONFIG_URI][GCLOUD_WIDE_FLAG …]
- DESCRIPTION
- Update an existing
WasmPluginresource and optionally create aWasmPluginVersionresource and set it as the main (serving) one.If
--imageis not specified:- the method only updates the
WasmPluginresource without creating aWasmPluginVersion. - the
--plugin-config***flags are disallowed. - if
--main-versionis set, then the referencedWasmPluginVersionmust already exist and it is set as the main(serving) one.
If
--imageis specified:- the
--main-versionflag must also be specified. - the method updates the
WasmPluginresource and creates a newWasmPluginVersionwith--main-versionname and sets itas the main (serving) one. - the
--plugin-config***flags are allowed. - the
--asyncflag is disallowed.
- the method only updates the
- EXAMPLES
- To update a
WasmPlugincalledmy-plugin, run:gcloudservice-extensionswasm-pluginsupdatemy-plugin--main-version=new-version--description="A new description."--labels=label1=value1To update a
WasmPlugincalledmy-pluginand alsocreate a new version calledv1and set it as main:gcloudservice-extensionswasm-pluginsupdatemy-plugin--main-version=v1--description="A new description."--labels=label1=value1--image=…-docker.pkg.dev/my-project/repository/container:tag - POSITIONAL ARGUMENTS
- WasmPlugin resource - The ID of the
WasmPluginto update. Thearguments 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 inother ways.To set the
projectattribute:- provide the argument
wasm_pluginon the command line with a fullyspecified name; - provide the argument
--projecton the command line; - set the property
core/project.
This must be specified.
WASM_PLUGIN- ID of the WasmPlugin or fully qualified identifier for the WasmPlugin.
To set the
wasm_pluginattribute:- provide the argument
wasm_pluginon the command line.
This positional argument must be specified if any of the other arguments in thisgroup are specified.
- provide the argument
--location=LOCATION- The location ID.To set the
locationattribute:- provide the argument
wasm_pluginon the command line with a fullyspecified name; - provide the argument
--locationon the command line; - use global location.
- provide the argument
- provide the argument
- WasmPlugin resource - The ID of the
- FLAGS
--async- Return immediately, without waiting for the operation in progress to complete.
--description=DESCRIPTION- A human-readable description of the resource.
--labels=[KEY=VALUE,…]- List of label KEY=VALUE pairs to add.
Keys must start with a lowercase character and contain only hyphens(
-), underscores (_), lowercase characters, andnumbers. Values must contain only hyphens (-), underscores(_), lowercase characters, and numbers. --log-config=[LOG_CONFIG,…]- Logging options for the activity performed by this plugin. The following optionscan be set:
enable: whether to enable logging. Iflog-configflagis set,enableoption is required.
sample-rate: configures the sampling rate of activity logs, where1.0means all logged activity is reported and0.0means no activity is reported. The default value is1.0, and thevalue of the field must be in range0to1(inclusive).
min-log-level: specifies the lowest level of the logs that shouldbe exported to Cloud Logging. The default value isINFO.
Example usage:
--log-config=enable=True,sample-rate=0.5,min-log-level=INFO--log_config=enable=False --image=IMAGE- URI of the container image containing the plugin's Wasm module, stored in theArtifact Registry.
--main-version=MAIN_VERSION- The ID of the
WasmPluginVersionthat should be the currentlyserving one. The version referred to must be a child of thisWasmPlugin.If the
--imageflag was also provided, theWasmPluginVersionwill be created for thatWasmPluginand will be set as the current main version. - Configuration for the plugin, provided at runtime by the
on_configurefunction (Rust Proxy-Wasm SDK) or theonConfiguremethod (C++ Proxy-Wasm SDK).At most one of these can be specified:
--plugin-config=PLUGIN_CONFIG- Plugin runtime configuration in the textual format.
--plugin-config-file=PATH_TO_FILE- Path to a local file containing the plugin runtime configuration.
Use a full or relative path to a local file containing the value ofplugin_config_file.
--plugin-config-uri=PLUGIN_CONFIG_URI- URI of the container image containing the plugin's runtime configuration, storedin the Artifact Registry.
- 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
- These variants are also available:
gcloudalphaservice-extensionswasm-pluginsupdategcloudbetaservice-extensionswasm-pluginsupdate
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-07-01 UTC.