.TH "GCLOUD_SERVICE\-EXTENSIONS_WASM\-PLUGINS_UPDATE" 1



.SH "NAME"
.HP
gcloud service\-extensions wasm\-plugins update \- update a \f5WasmPlugin\fR resource



.SH "SYNOPSIS"
.HP
\f5gcloud service\-extensions wasm\-plugins update\fR (\fIWASM_PLUGIN\fR\ :\ \fB\-\-location\fR=\fILOCATION\fR) [\fB\-\-async\fR] [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-log\-config\fR=[\fILOG_CONFIG\fR,...]] [\fB\-\-image\fR=\fIIMAGE\fR\ \fB\-\-main\-version\fR=\fIMAIN_VERSION\fR\ \fB\-\-plugin\-config\fR=\fIPLUGIN_CONFIG\fR\ |\ \fB\-\-plugin\-config\-file\fR=\fIPATH_TO_FILE\fR\ |\ \fB\-\-plugin\-config\-uri\fR=\fIPLUGIN_CONFIG_URI\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Update an existing \f5WasmPlugin\fR resource and optionally create a
\f5WasmPluginVersion\fR resource and set it as the main (serving) one.

If \f5\-\-image\fR is not specified:
.RS 2m
.IP "\(bu" 2m
the method only updates the \f5WasmPlugin\fR resource without creating a
\f5WasmPluginVersion\fR.
.IP "\(bu" 2m
the \f5\-\-plugin\-config***\fR flags are disallowed.
.IP "\(bu" 2m
if \f5\-\-main\-version\fR is set, then the referenced \f5WasmPluginVersion\fR
must already exist and it is set as the main (serving) one.
.RE
.sp

If \f5\-\-image\fR is specified:
.RS 2m
.IP "\(bu" 2m
the \f5\-\-main\-version\fR flag must also be specified.
.IP "\(bu" 2m
the method updates the \f5WasmPlugin\fR resource and creates a new
\f5WasmPluginVersion\fR with \f5\-\-main\-version\fR name and sets it as the
main (serving) one.
.IP "\(bu" 2m
the \f5\-\-plugin\-config***\fR flags are allowed.
.IP "\(bu" 2m
the \f5\-\-async\fR flag is disallowed.
.RE
.sp



.SH "EXAMPLES"

To update a \f5WasmPlugin\fR called \f5my\-plugin\fR, run:

.RS 2m
$ gcloud service\-extensions wasm\-plugins update my\-plugin \e
    \-\-main\-version=new\-version \-\-description="A new description." \e
    \-\-labels=label1=value1
.RE

To update a \f5WasmPlugin\fR called \f5my\-plugin\fR and also create a new
version called \f5v1\fR and set it as main:

.RS 2m
$ gcloud service\-extensions wasm\-plugins update my\-plugin \e
    \-\-main\-version=v1 \-\-description="A new description." \e
    \-\-labels=label1=value1 \e
    \-\-image=...\-docker.pkg.dev/my\-project/repository/container:tag
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

WasmPlugin resource \- The ID of the \f5WasmPlugin\fR 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 \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5wasm_plugin\fR on the command line with a fully
specified name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fIWASM_PLUGIN\fR

ID of the WasmPlugin or fully qualified identifier for the WasmPlugin.

To set the \f5wasm_plugin\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5wasm_plugin\fR on the command line.
.RE
.sp

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

.TP 2m
\fB\-\-location\fR=\fILOCATION\fR

The location ID.


To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5wasm_plugin\fR on the command line with a fully
specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-location\fR on the command line;
.IP "\(bu" 2m
use global location.
.RE
.sp


.RE
.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-async\fR

Return immediately, without waiting for the operation in progress to complete.

.TP 2m
\fB\-\-description\fR=\fIDESCRIPTION\fR

A human\-readable description of the resource.

.TP 2m
\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]

List of label KEY=VALUE pairs to add.

Keys must start with a lowercase character and contain only hyphens (\f5\-\fR),
underscores (\f5_\fR), lowercase characters, and numbers. Values must contain
only hyphens (\f5\-\fR), underscores (\f5_\fR), lowercase characters, and
numbers.

.TP 2m
\fB\-\-log\-config\fR=[\fILOG_CONFIG\fR,...]

Logging options for the activity performed by this plugin. The following options
can be set:
.RS 2m
.IP "\(em" 2m
\f5enable\fR: whether to enable logging. If \f5log\-config\fR flag is set,
\f5enable\fR option is required.
.RE
.sp

.RS 2m
.IP "\(em" 2m
\f5sample\-rate\fR: configures the sampling rate of activity logs, where
\f51.0\fR means all logged activity is reported and \f50.0\fR means no activity
is reported. The default value is \f51.0\fR, and the value of the field must be
in range \f50\fR to \f51\fR (inclusive).
.RE
.sp

.RS 2m
.IP "\(em" 2m
\f5min\-log\-level\fR: specifies the lowest level of the logs that should be
exported to Cloud Logging. The default value is \f5INFO\fR.
.RE
.sp

Example usage:
\f5\-\-log\-config=enable=True,sample\-rate=0.5,min\-log\-level=INFO
\-\-log_config=enable=False\fR

.TP 2m
\fB\-\-image\fR=\fIIMAGE\fR

URI of the container image containing the plugin's Wasm module, stored in the
Artifact Registry.

.TP 2m
\fB\-\-main\-version\fR=\fIMAIN_VERSION\fR

The ID of the \f5WasmPluginVersion\fR that should be the currently serving one.
The version referred to must be a child of this \f5WasmPlugin\fR.

If the \f5\-\-image\fR flag was also provided, the \f5WasmPluginVersion\fR will
be created for that \f5WasmPlugin\fR and will be set as the current main
version.

.TP 2m

Configuration for the plugin, provided at runtime by the \f5on_configure\fR
function (Rust Proxy\-Wasm SDK) or the \f5onConfigure\fR method (C++ Proxy\-Wasm
SDK).

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-plugin\-config\fR=\fIPLUGIN_CONFIG\fR

Plugin runtime configuration in the textual format.

.TP 2m
\fB\-\-plugin\-config\-file\fR=\fIPATH_TO_FILE\fR

Path to a local file containing the plugin runtime configuration.

Use a full or relative path to a local file containing the value of
plugin_config_file.

.TP 2m
\fB\-\-plugin\-config\-uri\fR=\fIPLUGIN_CONFIG_URI\fR

URI of the container image containing the plugin's runtime configuration, stored
in the Artifact Registry.


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

These variants are also available:

.RS 2m
$ gcloud alpha service\-extensions wasm\-plugins update
.RE

.RS 2m
$ gcloud beta service\-extensions wasm\-plugins update
.RE