# REST Resource: projects.locations.wasmPlugins.versions

- [Resource: WasmPluginVersion](https://docs.cloud.google.com/service-extensions/docs/reference/rest/v1alpha1/projects.locations.wasmPlugins.versions#WasmPluginVersion)
  - [JSON representation](https://docs.cloud.google.com/service-extensions/docs/reference/rest/v1alpha1/projects.locations.wasmPlugins.versions#WasmPluginVersion.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/service-extensions/docs/reference/rest/v1alpha1/projects.locations.wasmPlugins.versions#METHODS_SUMMARY)

## Resource: WasmPluginVersion

A single immutable version of a `WasmPlugin` resource. Defines the Wasm module used and optionally its runtime config.

| JSON representation |
|---|
| ``` { "name": string, "createTime": string, "updateTime": string, "description": string, "labels": { string: string, ... }, "imageUri": string, "imageDigest": string, "pluginConfigDigest": string, // Union field `plugin_config_source` can be only one of the following: "pluginConfigData": string, "pluginConfigUri": string // End of list of possible types for union field `plugin_config_source`. } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. Name of the `WasmPluginVersion` resource in the following format: `projects/{project}/locations/{location}/wasmPlugins/{wasmPlugin}/ versions/{wasmPluginVersion}`. |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The timestamp when the resource was created. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `updateTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The timestamp when the resource was updated. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `description` | `string` Optional. A human-readable description of the resource. |
| `labels` | `map (key: string, value: string)` Optional. Set of labels associated with the `WasmPluginVersion` resource. An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |
| `imageUri` | `string` Optional. URI of the image containing the Wasm module, stored in Artifact Registry. The URI can refer to one of the following repository formats: - Container images: the `imageUri` must point to a container that contains a single file with the name `plugin.wasm`. When a new `WasmPluginVersion` resource is created, the digest of the image is saved in the `imageDigest` field. When pulling a container image from Artifact Registry, the digest value is used instead of an image tag. - Generic artifacts: the `imageUri` must be in this format: `projects/{project}/locations/{location}/repositories/{repository}/ genericArtifacts/{package}:{version}`. The specified package and version must contain a file with the name `plugin.wasm`. When a new `WasmPluginVersion` resource is created, the checksum of the contents of the file is saved in the `imageDigest` field. |
| `imageDigest` | `string` Output only. This field holds the digest (usually checksum) value for the plugin image. The value is calculated based on the `imageUri` field. If the `imageUri` field refers to a container image, the digest value is obtained from the container image. If the `imageUri` field refers to a generic artifact, the digest value is calculated based on the contents of the file. |
| `pluginConfigDigest` | `string` Output only. This field holds the digest (usually checksum) value for the plugin configuration. The value is calculated based on the contents of `pluginConfigData` field or the image defined by the `pluginConfigUri` field. |
| Union field `plugin_config_source`. `plugin_config_source` can be only one of the following: ||
| `pluginConfigData` | `string (https://developers.google.com/discovery/v1/type-format format)` Configuration for the plugin. The configuration is provided to the plugin at runtime through the `ON_CONFIGURE` callback. When a new `WasmPluginVersion` resource is created, the digest of the contents is saved in the `pluginConfigDigest` field. A base64-encoded string. |
| `pluginConfigUri` | `string` URI of the plugin configuration stored in the Artifact Registry. The configuration is provided to the plugin at runtime through the `ON_CONFIGURE` callback. The URI can refer to one of the following repository formats: - Container images: the `pluginConfigUri` must point to a container that contains a single file with the name `plugin.config`. When a new `WasmPluginVersion` resource is created, the digest of the image is saved in the `pluginConfigDigest` field. When pulling a container image from Artifact Registry, the digest value is used instead of an image tag. - Generic artifacts: the `pluginConfigUri` must be in this format: `projects/{project}/locations/{location}/repositories/{repository}/ genericArtifacts/{package}:{version}`. The specified package and version must contain a file with the name `plugin.config`. When a new `WasmPluginVersion` resource is created, the checksum of the contents of the file is saved in the `pluginConfigDigest` field. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/service-extensions/docs/reference/rest/v1alpha1/projects.locations.wasmPlugins.versions/create` | Creates a new `WasmPluginVersion` resource in a given project and location. |
| ### `https://docs.cloud.google.com/service-extensions/docs/reference/rest/v1alpha1/projects.locations.wasmPlugins.versions/delete` | Deletes the specified `WasmPluginVersion` resource. |
| ### `https://docs.cloud.google.com/service-extensions/docs/reference/rest/v1alpha1/projects.locations.wasmPlugins.versions/get` | Gets details of the specified `WasmPluginVersion` resource. |
| ### `https://docs.cloud.google.com/service-extensions/docs/reference/rest/v1alpha1/projects.locations.wasmPlugins.versions/list` | Lists `WasmPluginVersion` resources in a given project and location. |