producer_extensions

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

Overview

Name	producer_extensions
Type	Resource
Id	google.networkservices.producer_extensions

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
name	string	Identifier. Name of the ProducerExtension resource in the following format: projects/{project}/locations/{location}/producerExtensions/{producer_extension}.
createTime	string (google-datetime)	Output only. The timestamp when the resource was created.
description	string	Optional. A human-readable description of the resource.
etag	string	Optional. Etag of the resource. If this is provided, it must match the server's etag. If the provided etag does not match the server's etag, the request will fail with a 409 ABORTED error.
extensionSettings	object	Required. The configuration for the service that this ProducerExtension offers. (id: ProducerExtensionExtensionSettings)
labels	object	Optional. Set of labels associated with the ProducerExtension resource. The format must comply with [the following requirements]((https://cloud.google.com/compute/docs/labeling-resources#requirements).
phase	string	Required. The phase in which this ProducerExtension should execute. (PHASE_UNSPECIFIED, TRAFFIC, AUTHZ)
updateTime	string (google-datetime)	Output only. The timestamp when the resource was updated.

list

Name	Datatype	Description
name	string	Identifier. Name of the ProducerExtension resource in the following format: projects/{project}/locations/{location}/producerExtensions/{producer_extension}.
createTime	string (google-datetime)	Output only. The timestamp when the resource was created.
description	string	Optional. A human-readable description of the resource.
etag	string	Optional. Etag of the resource. If this is provided, it must match the server's etag. If the provided etag does not match the server's etag, the request will fail with a 409 ABORTED error.
extensionSettings	object	Required. The configuration for the service that this ProducerExtension offers. (id: ProducerExtensionExtensionSettings)
labels	object	Optional. Set of labels associated with the ProducerExtension resource. The format must comply with [the following requirements]((https://cloud.google.com/compute/docs/labeling-resources#requirements).
phase	string	Required. The phase in which this ProducerExtension should execute. (PHASE_UNSPECIFIED, TRAFFIC, AUTHZ)
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, producerExtensionsId		Gets details of the specified ProducerExtension resource.
list	select	projectsId, locationsId	pageSize, pageToken	Lists ProducerExtension resources in a given project and location.
create	insert	projectsId, locationsId	producerExtensionId	Creates a new ProducerExtension resource in a given project and location.
delete	delete	projectsId, locationsId, producerExtensionsId	etag	Deletes the specified ProducerExtension 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
producerExtensionsId	string
projectsId	string
etag	string
pageSize	integer (int32)
pageToken	string
producerExtensionId	string

SELECT examples

get

Gets details of the specified ProducerExtension resource.

SELECT
name,
createTime,
description,
etag,
extensionSettings,
labels,
phase,
updateTime
FROM google.networkservices.producer_extensions
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND producerExtensionsId = '{{ producerExtensionsId }}' -- required
;

list

Lists ProducerExtension resources in a given project and location.

SELECT
name,
createTime,
description,
etag,
extensionSettings,
labels,
phase,
updateTime
FROM google.networkservices.producer_extensions
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
;

INSERT examples

create

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

INSERT INTO google.networkservices.producer_extensions (
data__description,
data__etag,
data__extensionSettings,
data__labels,
data__name,
data__phase,
projectsId,
locationsId,
producerExtensionId
)
SELECT 
'{{ description }}',
'{{ etag }}',
'{{ extensionSettings }}',
'{{ labels }}',
'{{ name }}',
'{{ phase }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ producerExtensionId }}'
RETURNING
name,
done,
error,
metadata,
response
;

Manifest

# Description fields are for documentation purposes
- name: producer_extensions
props:
  - name: projectsId
    value: "{{ projectsId }}"
    description: Required parameter for the producer_extensions resource.
  - name: locationsId
    value: "{{ locationsId }}"
    description: Required parameter for the producer_extensions resource.
  - name: description
    value: "{{ description }}"
    description: |
      Optional. A human-readable description of the resource.
  - name: etag
    value: "{{ etag }}"
    description: |
      Optional. Etag of the resource. If this is provided, it must match the server's etag. If the provided etag does not match the server's etag, the request will fail with a 409 ABORTED error.
  - name: extensionSettings
    description: |
      Required. The configuration for the service that this `ProducerExtension` offers.
    value:
      authority: "{{ authority }}"
      observabilityMode: {{ observabilityMode }}
      service: "{{ service }}"
      supportedEvents:
        - "{{ supportedEvents }}"
  - name: labels
    value: "{{ labels }}"
    description: |
      Optional. Set of labels associated with the `ProducerExtension` resource. The format must comply with [the following requirements]((https://cloud.google.com/compute/docs/labeling-resources#requirements).
  - name: name
    value: "{{ name }}"
    description: |
      Identifier. Name of the `ProducerExtension` resource in the following format: `projects/{project}/locations/{location}/producerExtensions/{producer_extension}`.
  - name: phase
    value: "{{ phase }}"
    description: |
      Required. The phase in which this `ProducerExtension` should execute.
    valid_values: ['PHASE_UNSPECIFIED', 'TRAFFIC', 'AUTHZ']
  - name: producerExtensionId
    value: "{{ producerExtensionId }}"

DELETE examples

delete

Deletes the specified ProducerExtension resource.

DELETE FROM google.networkservices.producer_extensions
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND producerExtensionsId = '{{ producerExtensionsId }}' --required
AND etag = '{{ etag }}'
;