# REST Resource: projects.locations.lbRouteExtensions

- [Resource: LbRouteExtension](https://docs.cloud.google.com/service-extensions/docs/reference/rest/v1/projects.locations.lbRouteExtensions#LbRouteExtension)
  - [JSON representation](https://docs.cloud.google.com/service-extensions/docs/reference/rest/v1/projects.locations.lbRouteExtensions#LbRouteExtension.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/service-extensions/docs/reference/rest/v1/projects.locations.lbRouteExtensions#METHODS_SUMMARY)

## 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 (`https://docs.cloud.google.com/service-extensions/docs/reference/rest/v1/ExtensionChain`) } ], "loadBalancingScheme": enum (`https://docs.cloud.google.com/service-extensions/docs/reference/rest/v1/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 (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The timestamp when the resource was created. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `updateTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The timestamp when the resource was updated. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `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](https://cloud.google.com/compute/docs/labeling-resources#requirements) 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. Only one `LbRouteExtension` resource can be associated with a forwarding rule. |
| `extensionChains[]` | ``object (`https://docs.cloud.google.com/service-extensions/docs/reference/rest/v1/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 (`https://docs.cloud.google.com/service-extensions/docs/reference/rest/v1/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](https://cloud.google.com/load-balancing/docs/backend-service). |
| `metadata` | ``object (`https://protobuf.dev/reference/protobuf/google.protobuf#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 applies to all extensions in all extensions chains in this resource. The metadata is available under the key `com.google.lb_route_extension.<resourceName>`. The following variables are supported in the metadata: `{forwarding_rule_id}` - substituted with the forwarding rule's fully qualified resource name. This field must not be set if at least one of the extension chains contains plugin extensions. Setting it results in a validation error. You can set metadata at either the resource level or the extension level. The extension level metadata is recommended because you can pass a different set of metadata through each extension to the backend. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/service-extensions/docs/reference/rest/v1/projects.locations.lbRouteExtensions/create` | Creates a new `LbRouteExtension` resource in a given project and location. |
| ### `https://docs.cloud.google.com/service-extensions/docs/reference/rest/v1/projects.locations.lbRouteExtensions/delete` | Deletes the specified `LbRouteExtension` resource. |
| ### `https://docs.cloud.google.com/service-extensions/docs/reference/rest/v1/projects.locations.lbRouteExtensions/get` | Gets details of the specified `LbRouteExtension` resource. |
| ### `https://docs.cloud.google.com/service-extensions/docs/reference/rest/v1/projects.locations.lbRouteExtensions/list` | Lists `LbRouteExtension` resources in a given project and location. |
| ### `https://docs.cloud.google.com/service-extensions/docs/reference/rest/v1/projects.locations.lbRouteExtensions/patch` | Updates the parameters of the specified `LbRouteExtension` resource. |