versions

Creates, updates, deletes, gets or lists a versions resource.

Overview

Name	versions
Type	Resource
Id	google.networkservices.versions

Fields

The following fields are returned by SELECT queries:

get

Successful response

Name	Datatype	Description
name	string	Identifier. Name of the WasmPluginVersion resource in the following format: projects/{project}/locations/{location}/wasmPlugins/{wasm_plugin}/ versions/{wasm_plugin_version}.
createTime	string (google-datetime)	Output only. The timestamp when the resource was created.
description	string	Optional. A human-readable description of the resource.
imageDigest	string	Output only. This field holds the digest (usually checksum) value for the plugin image. The value is calculated based on the image_uri field. If the image_uri field refers to a container image, the digest value is obtained from the container image. If the image_uri field refers to a generic artifact, the digest value is calculated based on the contents of the file.
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 image_uri 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 image_digest field. When pulling a container image from Artifact Registry, the digest value is used instead of an image tag. * Generic artifacts: the image_uri 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 image_digest field.
labels	object	Optional. Set of labels associated with the WasmPluginVersion resource.
pluginConfigData	string (byte)	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 plugin_config_digest field.
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 plugin_config_data field or the image defined by the plugin_config_uri field.
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 plugin_config_uri 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 plugin_config_digest field. When pulling a container image from Artifact Registry, the digest value is used instead of an image tag. * Generic artifacts: the plugin_config_uri 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 plugin_config_digest field.
updateTime	string (google-datetime)	Output only. The timestamp when the resource was updated.

list

Successful response

Name	Datatype	Description
name	string	Identifier. Name of the WasmPluginVersion resource in the following format: projects/{project}/locations/{location}/wasmPlugins/{wasm_plugin}/ versions/{wasm_plugin_version}.
createTime	string (google-datetime)	Output only. The timestamp when the resource was created.
description	string	Optional. A human-readable description of the resource.
imageDigest	string	Output only. This field holds the digest (usually checksum) value for the plugin image. The value is calculated based on the image_uri field. If the image_uri field refers to a container image, the digest value is obtained from the container image. If the image_uri field refers to a generic artifact, the digest value is calculated based on the contents of the file.
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 image_uri 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 image_digest field. When pulling a container image from Artifact Registry, the digest value is used instead of an image tag. * Generic artifacts: the image_uri 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 image_digest field.
labels	object	Optional. Set of labels associated with the WasmPluginVersion resource.
pluginConfigData	string (byte)	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 plugin_config_digest field.
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 plugin_config_data field or the image defined by the plugin_config_uri field.
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 plugin_config_uri 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 plugin_config_digest field. When pulling a container image from Artifact Registry, the digest value is used instead of an image tag. * Generic artifacts: the plugin_config_uri 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 plugin_config_digest field.
updateTime	string (google-datetime)	Output only. The timestamp when the resource was updated.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	projectsId, locationsId, wasmPluginsId, versionsId		Gets details of the specified WasmPluginVersion resource.
list	select	projectsId, locationsId, wasmPluginsId	pageSize, pageToken	Lists WasmPluginVersion resources in a given project and location.
create	insert	projectsId, locationsId, wasmPluginsId	wasmPluginVersionId	Creates a new WasmPluginVersion resource in a given project and location.
delete	delete	projectsId, locationsId, wasmPluginsId, versionsId		Deletes the specified WasmPluginVersion resource.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
locationsId	string
projectsId	string
versionsId	string
wasmPluginsId	string
pageSize	integer (int32)
pageToken	string
wasmPluginVersionId	string

SELECT examples

get

Gets details of the specified WasmPluginVersion resource.

SELECT
name,
createTime,
description,
imageDigest,
imageUri,
labels,
pluginConfigData,
pluginConfigDigest,
pluginConfigUri,
updateTime
FROM google.networkservices.versions
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND wasmPluginsId = '{{ wasmPluginsId }}' -- required
AND versionsId = '{{ versionsId }}' -- required;

list

Lists WasmPluginVersion resources in a given project and location.

SELECT
name,
createTime,
description,
imageDigest,
imageUri,
labels,
pluginConfigData,
pluginConfigDigest,
pluginConfigUri,
updateTime
FROM google.networkservices.versions
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND wasmPluginsId = '{{ wasmPluginsId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}';

INSERT examples

create

Creates a new WasmPluginVersion resource in a given project and location.

INSERT INTO google.networkservices.versions (
data__pluginConfigData,
data__pluginConfigUri,
data__name,
data__description,
data__labels,
data__imageUri,
projectsId,
locationsId,
wasmPluginsId,
wasmPluginVersionId
)
SELECT 
'{{ pluginConfigData }}',
'{{ pluginConfigUri }}',
'{{ name }}',
'{{ description }}',
'{{ labels }}',
'{{ imageUri }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ wasmPluginsId }}',
'{{ wasmPluginVersionId }}'
RETURNING
name,
done,
error,
metadata,
response
;

Manifest

# Description fields are for documentation purposes
- name: versions
  props:
    - name: projectsId
      value: string
      description: Required parameter for the versions resource.
    - name: locationsId
      value: string
      description: Required parameter for the versions resource.
    - name: wasmPluginsId
      value: string
      description: Required parameter for the versions resource.
    - name: pluginConfigData
      value: string
      description: >
        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 `plugin_config_digest` field.
        
    - name: pluginConfigUri
      value: string
      description: >
        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 `plugin_config_uri` 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 `plugin_config_digest` field. When pulling a container image from Artifact Registry, the digest value is used instead of an image tag. * Generic artifacts: the `plugin_config_uri` 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 `plugin_config_digest` field.
        
    - name: name
      value: string
      description: >
        Identifier. Name of the `WasmPluginVersion` resource in the following format: `projects/{project}/locations/{location}/wasmPlugins/{wasm_plugin}/ versions/{wasm_plugin_version}`.
        
    - name: description
      value: string
      description: >
        Optional. A human-readable description of the resource.
        
    - name: labels
      value: object
      description: >
        Optional. Set of labels associated with the `WasmPluginVersion` resource.
        
    - name: imageUri
      value: string
      description: >
        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 `image_uri` 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 `image_digest` field. When pulling a container image from Artifact Registry, the digest value is used instead of an image tag. * Generic artifacts: the `image_uri` 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 `image_digest` field.
        
    - name: wasmPluginVersionId
      value: string

DELETE examples

delete

Deletes the specified WasmPluginVersion resource.

DELETE FROM google.networkservices.versions
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND wasmPluginsId = '{{ wasmPluginsId }}' --required
AND versionsId = '{{ versionsId }}' --required;