wasm_plugins

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

Overview

Name	wasm_plugins
Type	Resource
Id	google.networkservices.wasm_plugins

Fields

The following fields are returned by SELECT queries:

get

Successful response

Name	Datatype	Description
name	string	Identifier. Name of the WasmPlugin resource in the following format: projects/{project}/locations/{location}/wasmPlugins/{wasm_plugin}.
createTime	string (google-datetime)	Output only. The timestamp when the resource was created.
description	string	Optional. A human-readable description of the resource.
labels	object	Optional. Set of labels associated with the WasmPlugin resource. The format must comply with the following requirements.
logConfig	object	Optional. Specifies the logging options for the activity performed by this plugin. If logging is enabled, plugin logs are exported to Cloud Logging. Note that the settings relate to the logs generated by using logging statements in your Wasm code. (id: WasmPluginLogConfig)
mainVersionId	string	Optional. The ID of the WasmPluginVersion resource that is the currently serving one. The version referred to must be a child of this WasmPlugin resource.
updateTime	string (google-datetime)	Output only. The timestamp when the resource was updated.
usedBy	array	Output only. List of all extensions that use this WasmPlugin resource.
versions	object	Optional. All versions of this WasmPlugin resource in the key-value format. The key is the resource ID, and the value is the VersionDetails object. Lets you create or update a WasmPlugin resource and its versions in a single request. When the main_version_id field is not empty, it must point to one of the VersionDetails objects in the map. If provided in a PATCH request, the new versions replace the previous set. Any version omitted from the versions field is removed. Because the WasmPluginVersion resource is immutable, if a WasmPluginVersion resource with the same name already exists and differs, the request fails. Note: In a GET request, this field is populated only if the field GetWasmPluginRequest.view is set to WASM_PLUGIN_VIEW_FULL.

list

Successful response

Name	Datatype	Description
name	string	Identifier. Name of the WasmPlugin resource in the following format: projects/{project}/locations/{location}/wasmPlugins/{wasm_plugin}.
createTime	string (google-datetime)	Output only. The timestamp when the resource was created.
description	string	Optional. A human-readable description of the resource.
labels	object	Optional. Set of labels associated with the WasmPlugin resource. The format must comply with the following requirements.
logConfig	object	Optional. Specifies the logging options for the activity performed by this plugin. If logging is enabled, plugin logs are exported to Cloud Logging. Note that the settings relate to the logs generated by using logging statements in your Wasm code. (id: WasmPluginLogConfig)
mainVersionId	string	Optional. The ID of the WasmPluginVersion resource that is the currently serving one. The version referred to must be a child of this WasmPlugin resource.
updateTime	string (google-datetime)	Output only. The timestamp when the resource was updated.
usedBy	array	Output only. List of all extensions that use this WasmPlugin resource.
versions	object	Optional. All versions of this WasmPlugin resource in the key-value format. The key is the resource ID, and the value is the VersionDetails object. Lets you create or update a WasmPlugin resource and its versions in a single request. When the main_version_id field is not empty, it must point to one of the VersionDetails objects in the map. If provided in a PATCH request, the new versions replace the previous set. Any version omitted from the versions field is removed. Because the WasmPluginVersion resource is immutable, if a WasmPluginVersion resource with the same name already exists and differs, the request fails. Note: In a GET request, this field is populated only if the field GetWasmPluginRequest.view is set to WASM_PLUGIN_VIEW_FULL.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	projectsId, locationsId, wasmPluginsId	view	Gets details of the specified WasmPlugin resource.
list	select	projectsId, locationsId	pageSize, pageToken	Lists WasmPlugin resources in a given project and location.
create	insert	projectsId, locationsId	wasmPluginId	Creates a new WasmPlugin resource in a given project and location.
patch	update	projectsId, locationsId, wasmPluginsId	updateMask	Updates the parameters of the specified WasmPlugin resource.
delete	delete	projectsId, locationsId, wasmPluginsId		Deletes the specified WasmPlugin 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
wasmPluginsId	string
pageSize	integer (int32)
pageToken	string
updateMask	string (google-fieldmask)
view	string
wasmPluginId	string

SELECT examples

get

Gets details of the specified WasmPlugin resource.

SELECT
name,
createTime,
description,
labels,
logConfig,
mainVersionId,
updateTime,
usedBy,
versions
FROM google.networkservices.wasm_plugins
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND wasmPluginsId = '{{ wasmPluginsId }}' -- required
AND view = '{{ view }}';

list

Lists WasmPlugin resources in a given project and location.

SELECT
name,
createTime,
description,
labels,
logConfig,
mainVersionId,
updateTime,
usedBy,
versions
FROM google.networkservices.wasm_plugins
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}';

INSERT examples

create

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

INSERT INTO google.networkservices.wasm_plugins (
data__name,
data__description,
data__labels,
data__mainVersionId,
data__logConfig,
data__versions,
projectsId,
locationsId,
wasmPluginId
)
SELECT 
'{{ name }}',
'{{ description }}',
'{{ labels }}',
'{{ mainVersionId }}',
'{{ logConfig }}',
'{{ versions }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ wasmPluginId }}'
RETURNING
name,
done,
error,
metadata,
response
;

Manifest

# Description fields are for documentation purposes
- name: wasm_plugins
  props:
    - name: projectsId
      value: string
      description: Required parameter for the wasm_plugins resource.
    - name: locationsId
      value: string
      description: Required parameter for the wasm_plugins resource.
    - name: name
      value: string
      description: >
        Identifier. Name of the `WasmPlugin` resource in the following format: `projects/{project}/locations/{location}/wasmPlugins/{wasm_plugin}`.
        
    - 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 `WasmPlugin` resource. The format must comply with [the following requirements](https://cloud.google.com/compute/docs/labeling-resources#requirements).
        
    - name: mainVersionId
      value: string
      description: >
        Optional. The ID of the `WasmPluginVersion` resource that is the currently serving one. The version referred to must be a child of this `WasmPlugin` resource.
        
    - name: logConfig
      value: object
      description: >
        Optional. Specifies the logging options for the activity performed by this plugin. If logging is enabled, plugin logs are exported to Cloud Logging. Note that the settings relate to the logs generated by using logging statements in your Wasm code.
        
    - name: versions
      value: object
      description: >
        Optional. All versions of this `WasmPlugin` resource in the key-value format. The key is the resource ID, and the value is the `VersionDetails` object. Lets you create or update a `WasmPlugin` resource and its versions in a single request. When the `main_version_id` field is not empty, it must point to one of the `VersionDetails` objects in the map. If provided in a `PATCH` request, the new versions replace the previous set. Any version omitted from the `versions` field is removed. Because the `WasmPluginVersion` resource is immutable, if a `WasmPluginVersion` resource with the same name already exists and differs, the request fails. Note: In a `GET` request, this field is populated only if the field `GetWasmPluginRequest.view` is set to `WASM_PLUGIN_VIEW_FULL`.
        
    - name: wasmPluginId
      value: string

UPDATE examples

patch

Updates the parameters of the specified WasmPlugin resource.

UPDATE google.networkservices.wasm_plugins
SET 
data__name = '{{ name }}',
data__description = '{{ description }}',
data__labels = '{{ labels }}',
data__mainVersionId = '{{ mainVersionId }}',
data__logConfig = '{{ logConfig }}',
data__versions = '{{ versions }}'
WHERE 
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND wasmPluginsId = '{{ wasmPluginsId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
done,
error,
metadata,
response;

DELETE examples

delete

Deletes the specified WasmPlugin resource.

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