lb_edge_extensions

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

Overview

Name	lb_edge_extensions
Type	Resource
Id	google.networkservices.lb_edge_extensions

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
name	string	Required. Identifier. Name of the LbEdgeExtension resource in the following format: projects/{project}/locations/{location}/lbEdgeExtensions/{lb_edge_extension}.
createTime	string (google-datetime)	Output only. The timestamp when the resource was created.
description	string	Optional. A human-readable description of the resource.
extensionChains	array	Required. A set of ordered extension chains that contain the match conditions and extensions to execute. Match conditions for each extension chain are evaluated in sequence for a given request. The first extension chain that has a condition that matches the request is executed. Any subsequent extension chains do not execute. Limited to 5 extension chains per resource.
forwardingRules	array	Required. A list of references to the forwarding rules to which this service extension is attached. At least one forwarding rule is required. Only one LbEdgeExtension resource can be associated with a forwarding rule.
labels	object	Optional. Set of labels associated with the LbEdgeExtension resource. The format must comply with the requirements for labels for Google Cloud resources.
loadBalancingScheme	string	Required. All forwarding rules referenced by this extension must share the same load balancing scheme. Supported values: EXTERNAL_MANAGED.
updateTime	string (google-datetime)	Output only. The timestamp when the resource was updated.

list

Name	Datatype	Description
name	string	Required. Identifier. Name of the LbEdgeExtension resource in the following format: projects/{project}/locations/{location}/lbEdgeExtensions/{lb_edge_extension}.
createTime	string (google-datetime)	Output only. The timestamp when the resource was created.
description	string	Optional. A human-readable description of the resource.
extensionChains	array	Required. A set of ordered extension chains that contain the match conditions and extensions to execute. Match conditions for each extension chain are evaluated in sequence for a given request. The first extension chain that has a condition that matches the request is executed. Any subsequent extension chains do not execute. Limited to 5 extension chains per resource.
forwardingRules	array	Required. A list of references to the forwarding rules to which this service extension is attached. At least one forwarding rule is required. Only one LbEdgeExtension resource can be associated with a forwarding rule.
labels	object	Optional. Set of labels associated with the LbEdgeExtension resource. The format must comply with the requirements for labels for Google Cloud resources.
loadBalancingScheme	string	Required. All forwarding rules referenced by this extension must share the same load balancing scheme. Supported values: EXTERNAL_MANAGED.
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, lbEdgeExtensionsId		Gets details of the specified LbEdgeExtension resource.
list	select	projectsId, locationsId	pageToken, pageSize, filter, orderBy	Lists LbEdgeExtension resources in a given project and location.
create	insert	projectsId, locationsId	lbEdgeExtensionId, requestId	Creates a new LbEdgeExtension resource in a given project and location.
patch	update	projectsId, locationsId, lbEdgeExtensionsId	updateMask, requestId	Updates the parameters of the specified LbEdgeExtension resource.
delete	delete	projectsId, locationsId, lbEdgeExtensionsId	requestId	Deletes the specified LbEdgeExtension 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
lbEdgeExtensionsId	string
locationsId	string
projectsId	string
filter	string
lbEdgeExtensionId	string
orderBy	string
pageSize	integer (int32)
pageToken	string
requestId	string
updateMask	string (google-fieldmask)

SELECT examples

get

Gets details of the specified LbEdgeExtension resource.

SELECT
name,
createTime,
description,
extensionChains,
forwardingRules,
labels,
loadBalancingScheme,
updateTime
FROM google.networkservices.lb_edge_extensions
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND lbEdgeExtensionsId = '{{ lbEdgeExtensionsId }}' -- required
;

list

Lists LbEdgeExtension resources in a given project and location.

SELECT
name,
createTime,
description,
extensionChains,
forwardingRules,
labels,
loadBalancingScheme,
updateTime
FROM google.networkservices.lb_edge_extensions
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND pageToken = '{{ pageToken }}'
AND pageSize = '{{ pageSize }}'
AND filter = '{{ filter }}'
AND orderBy = '{{ orderBy }}'
;

INSERT examples

create

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

INSERT INTO google.networkservices.lb_edge_extensions (
data__loadBalancingScheme,
data__extensionChains,
data__labels,
data__forwardingRules,
data__description,
data__name,
projectsId,
locationsId,
lbEdgeExtensionId,
requestId
)
SELECT 
'{{ loadBalancingScheme }}',
'{{ extensionChains }}',
'{{ labels }}',
'{{ forwardingRules }}',
'{{ description }}',
'{{ name }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ lbEdgeExtensionId }}',
'{{ requestId }}'
RETURNING
name,
done,
error,
metadata,
response
;

Manifest

# Description fields are for documentation purposes
- name: lb_edge_extensions
  props:
    - name: projectsId
      value: string
      description: Required parameter for the lb_edge_extensions resource.
    - name: locationsId
      value: string
      description: Required parameter for the lb_edge_extensions resource.
    - name: loadBalancingScheme
      value: string
      description: >
        Required. All forwarding rules referenced by this extension must share the same load balancing scheme. Supported values: `EXTERNAL_MANAGED`.
        
      valid_values: ['LOAD_BALANCING_SCHEME_UNSPECIFIED', 'INTERNAL_MANAGED', 'EXTERNAL_MANAGED']
    - name: extensionChains
      value: array
      description: >
        Required. A set of ordered extension chains that contain the match conditions and extensions to execute. Match conditions for each extension chain are evaluated in sequence for a given request. The first extension chain that has a condition that matches the request is executed. Any subsequent extension chains do not execute. Limited to 5 extension chains per resource.
        
    - name: labels
      value: object
      description: >
        Optional. Set of labels associated with the `LbEdgeExtension` resource. The format must comply with [the requirements for labels](https://cloud.google.com/compute/docs/labeling-resources#requirements) for Google Cloud resources.
        
    - name: forwardingRules
      value: array
      description: >
        Required. A list of references to the forwarding rules to which this service extension is attached. At least one forwarding rule is required. Only one `LbEdgeExtension` resource can be associated with a forwarding rule.
        
    - name: description
      value: string
      description: >
        Optional. A human-readable description of the resource.
        
    - name: name
      value: string
      description: >
        Required. Identifier. Name of the `LbEdgeExtension` resource in the following format: `projects/{project}/locations/{location}/lbEdgeExtensions/{lb_edge_extension}`.
        
    - name: lbEdgeExtensionId
      value: string
    - name: requestId
      value: string

UPDATE examples

patch

Updates the parameters of the specified LbEdgeExtension resource.

UPDATE google.networkservices.lb_edge_extensions
SET 
data__loadBalancingScheme = '{{ loadBalancingScheme }}',
data__extensionChains = '{{ extensionChains }}',
data__labels = '{{ labels }}',
data__forwardingRules = '{{ forwardingRules }}',
data__description = '{{ description }}',
data__name = '{{ name }}'
WHERE 
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND lbEdgeExtensionsId = '{{ lbEdgeExtensionsId }}' --required
AND updateMask = '{{ updateMask}}'
AND requestId = '{{ requestId}}'
RETURNING
name,
done,
error,
metadata,
response;

DELETE examples

delete

Deletes the specified LbEdgeExtension resource.

DELETE FROM google.networkservices.lb_edge_extensions
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND lbEdgeExtensionsId = '{{ lbEdgeExtensionsId }}' --required
AND requestId = '{{ requestId }}'
;