REST Resource: projects.locations.lbRouteExtensions

Resource: LbRouteExtension

LbRouteExtension is a resource that lets you control where traffic is routed to for a given request.

JSON representation
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "forwardingRules": [
    string
  ],
  "extensionChains": [
    {
      object (ExtensionChain)
    }
  ],
  "loadBalancingScheme": enum (LoadBalancingScheme),
  "metadata": {
    object
  }
}
Fields
name

string

Required. Identifier. Name of the LbRouteExtension resource in the following format: projects/{project}/locations/{location}/lbRouteExtensions/{lbRouteExtension}.

createTime

string (Timestamp format)

Output only. The timestamp when the resource was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Output only. The timestamp when the resource was updated.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

description

string

Optional. A human-readable description of the resource.

labels

map (key: string, value: string)

Optional. Set of labels associated with the LbRouteExtension resource.

The format must comply with the requirements for labels for Google Cloud resources.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

forwardingRules[]

string

Required. A list of references to the forwarding rules to which this service extension is attached. At least one forwarding rule is required. There can be only one LbRouteExtension resource per forwarding rule.

extensionChains[]

object (ExtensionChain)

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.

loadBalancingScheme

enum (LoadBalancingScheme)

Required. All backend services and forwarding rules referenced by this extension must share the same load balancing scheme. Supported values: INTERNAL_MANAGED, EXTERNAL_MANAGED. For more information, refer to Backend services overview.

metadata

object (Struct format)

Optional. The metadata provided here is included as part of the metadata_context (of type google.protobuf.Struct) in the ProcessingRequest message sent to the extension server. The metadata is available under the namespace com.google.lb_route_extension.<resourceName>. The following variables are supported in the metadata Struct:

{forwarding_rule_id} - substituted with the forwarding rule's fully qualified resource name.

This field is not supported for plugin extensions. Setting it results in a validation error.

Methods

create

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

delete

Deletes the specified LbRouteExtension resource.

get

Gets details of the specified LbRouteExtension resource.

list

Lists LbRouteExtension resources in a given project and location.

patch

Updates the parameters of the specified LbRouteExtension resource.