Google Cloud Native v0.28.0, Feb 2 23

google-native.networkservices/v1.TlsRoute

Creates a new TlsRoute in a given project and location.

Create TlsRoute Resource

new TlsRoute(name: string, args: TlsRouteArgs, opts?: CustomResourceOptions);

@overload
def TlsRoute(resource_name: str,
             opts: Optional[ResourceOptions] = None,
             description: Optional[str] = None,
             gateways: Optional[Sequence[str]] = None,
             location: Optional[str] = None,
             meshes: Optional[Sequence[str]] = None,
             name: Optional[str] = None,
             project: Optional[str] = None,
             rules: Optional[Sequence[TlsRouteRouteRuleArgs]] = None,
             tls_route_id: Optional[str] = None)
@overload
def TlsRoute(resource_name: str,
             args: TlsRouteArgs,
             opts: Optional[ResourceOptions] = None)

func NewTlsRoute(ctx *Context, name string, args TlsRouteArgs, opts ...ResourceOption) (*TlsRoute, error)

public TlsRoute(string name, TlsRouteArgs args, CustomResourceOptions? opts = null)

public TlsRoute(String name, TlsRouteArgs args)
public TlsRoute(String name, TlsRouteArgs args, CustomResourceOptions options)

type: google-native:networkservices/v1:TlsRoute
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

name string: The unique name of the resource.
args TlsRouteArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

resource_name str: The unique name of the resource.
args TlsRouteArgs: The arguments to resource properties.
opts ResourceOptions: Bag of options to control resource's behavior.

ctx Context: Context object for the current deployment.
name string: The unique name of the resource.
args TlsRouteArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args TlsRouteArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args TlsRouteArgs: The arguments to resource properties.
options CustomResourceOptions: Bag of options to control resource's behavior.

TlsRoute Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

The TlsRoute resource accepts the following input properties:

Rules List<Pulumi.GoogleNative.NetworkServices.V1.Inputs.TlsRouteRouteRuleArgs>: Rules that define how traffic is routed and handled. At least one RouteRule must be supplied. If there are multiple rules then the action taken will be the first rule to match.
TlsRouteId string: Required. Short name of the TlsRoute resource to be created. E.g. TODO(Add an example).
Description string: Optional. A free-text description of the resource. Max length 1024 characters.
Gateways List<string>: Optional. Gateways defines a list of gateways this TlsRoute is attached to, as one of the routing rules to route the requests served by the gateway. Each gateway reference should match the pattern: projects/*/locations/global/gateways/
Location string
Meshes List<string>: Optional. Meshes defines a list of meshes this TlsRoute is attached to, as one of the routing rules to route the requests served by the mesh. Each mesh reference should match the pattern: projects/*/locations/global/meshes/ The attached Mesh should be of a type SIDECAR
Name string: Name of the TlsRoute resource. It matches pattern projects/*/locations/global/tlsRoutes/tls_route_name>.
Project string

Rules []TlsRouteRouteRuleArgs: Rules that define how traffic is routed and handled. At least one RouteRule must be supplied. If there are multiple rules then the action taken will be the first rule to match.
TlsRouteId string: Required. Short name of the TlsRoute resource to be created. E.g. TODO(Add an example).
Description string: Optional. A free-text description of the resource. Max length 1024 characters.
Gateways []string: Optional. Gateways defines a list of gateways this TlsRoute is attached to, as one of the routing rules to route the requests served by the gateway. Each gateway reference should match the pattern: projects/*/locations/global/gateways/
Location string
Meshes []string: Optional. Meshes defines a list of meshes this TlsRoute is attached to, as one of the routing rules to route the requests served by the mesh. Each mesh reference should match the pattern: projects/*/locations/global/meshes/ The attached Mesh should be of a type SIDECAR
Name string: Name of the TlsRoute resource. It matches pattern projects/*/locations/global/tlsRoutes/tls_route_name>.
Project string

rules List<TlsRouteRouteRuleArgs>: Rules that define how traffic is routed and handled. At least one RouteRule must be supplied. If there are multiple rules then the action taken will be the first rule to match.
tlsRouteId String: Required. Short name of the TlsRoute resource to be created. E.g. TODO(Add an example).
description String: Optional. A free-text description of the resource. Max length 1024 characters.
gateways List<String>: Optional. Gateways defines a list of gateways this TlsRoute is attached to, as one of the routing rules to route the requests served by the gateway. Each gateway reference should match the pattern: projects/*/locations/global/gateways/
location String
meshes List<String>: Optional. Meshes defines a list of meshes this TlsRoute is attached to, as one of the routing rules to route the requests served by the mesh. Each mesh reference should match the pattern: projects/*/locations/global/meshes/ The attached Mesh should be of a type SIDECAR
name String: Name of the TlsRoute resource. It matches pattern projects/*/locations/global/tlsRoutes/tls_route_name>.
project String

rules TlsRouteRouteRuleArgs[]: Rules that define how traffic is routed and handled. At least one RouteRule must be supplied. If there are multiple rules then the action taken will be the first rule to match.
tlsRouteId string: Required. Short name of the TlsRoute resource to be created. E.g. TODO(Add an example).
description string: Optional. A free-text description of the resource. Max length 1024 characters.
gateways string[]: Optional. Gateways defines a list of gateways this TlsRoute is attached to, as one of the routing rules to route the requests served by the gateway. Each gateway reference should match the pattern: projects/*/locations/global/gateways/
location string
meshes string[]: Optional. Meshes defines a list of meshes this TlsRoute is attached to, as one of the routing rules to route the requests served by the mesh. Each mesh reference should match the pattern: projects/*/locations/global/meshes/ The attached Mesh should be of a type SIDECAR
name string: Name of the TlsRoute resource. It matches pattern projects/*/locations/global/tlsRoutes/tls_route_name>.
project string

rules Sequence[TlsRouteRouteRuleArgs]: Rules that define how traffic is routed and handled. At least one RouteRule must be supplied. If there are multiple rules then the action taken will be the first rule to match.
tls_route_id str: Required. Short name of the TlsRoute resource to be created. E.g. TODO(Add an example).
description str: Optional. A free-text description of the resource. Max length 1024 characters.
gateways Sequence[str]: Optional. Gateways defines a list of gateways this TlsRoute is attached to, as one of the routing rules to route the requests served by the gateway. Each gateway reference should match the pattern: projects/*/locations/global/gateways/
location str
meshes Sequence[str]: Optional. Meshes defines a list of meshes this TlsRoute is attached to, as one of the routing rules to route the requests served by the mesh. Each mesh reference should match the pattern: projects/*/locations/global/meshes/ The attached Mesh should be of a type SIDECAR
name str: Name of the TlsRoute resource. It matches pattern projects/*/locations/global/tlsRoutes/tls_route_name>.
project str

rules List<Property Map>: Rules that define how traffic is routed and handled. At least one RouteRule must be supplied. If there are multiple rules then the action taken will be the first rule to match.
tlsRouteId String: Required. Short name of the TlsRoute resource to be created. E.g. TODO(Add an example).
description String: Optional. A free-text description of the resource. Max length 1024 characters.
gateways List<String>: Optional. Gateways defines a list of gateways this TlsRoute is attached to, as one of the routing rules to route the requests served by the gateway. Each gateway reference should match the pattern: projects/*/locations/global/gateways/
location String
meshes List<String>: Optional. Meshes defines a list of meshes this TlsRoute is attached to, as one of the routing rules to route the requests served by the mesh. Each mesh reference should match the pattern: projects/*/locations/global/meshes/ The attached Mesh should be of a type SIDECAR
name String: Name of the TlsRoute resource. It matches pattern projects/*/locations/global/tlsRoutes/tls_route_name>.
project String

Outputs

All input properties are implicitly available as output properties. Additionally, the TlsRoute resource produces the following output properties:

CreateTime string: The timestamp when the resource was created.
Id string: The provider-assigned unique ID for this managed resource.
SelfLink string: Server-defined URL of this resource
UpdateTime string: The timestamp when the resource was updated.

CreateTime string: The timestamp when the resource was created.
Id string: The provider-assigned unique ID for this managed resource.
SelfLink string: Server-defined URL of this resource
UpdateTime string: The timestamp when the resource was updated.

createTime String: The timestamp when the resource was created.
id String: The provider-assigned unique ID for this managed resource.
selfLink String: Server-defined URL of this resource
updateTime String: The timestamp when the resource was updated.

createTime string: The timestamp when the resource was created.
id string: The provider-assigned unique ID for this managed resource.
selfLink string: Server-defined URL of this resource
updateTime string: The timestamp when the resource was updated.

create_time str: The timestamp when the resource was created.
id str: The provider-assigned unique ID for this managed resource.
self_link str: Server-defined URL of this resource
update_time str: The timestamp when the resource was updated.

createTime String: The timestamp when the resource was created.
id String: The provider-assigned unique ID for this managed resource.
selfLink String: Server-defined URL of this resource
updateTime String: The timestamp when the resource was updated.

Supporting Types

TlsRouteRouteAction

Destinations List<Pulumi.GoogleNative.NetworkServices.V1.Inputs.TlsRouteRouteDestination>: The destination services to which traffic should be forwarded. At least one destination service is required.

Destinations []TlsRouteRouteDestination: The destination services to which traffic should be forwarded. At least one destination service is required.

destinations List<TlsRouteRouteDestination>: The destination services to which traffic should be forwarded. At least one destination service is required.

destinations TlsRouteRouteDestination[]: The destination services to which traffic should be forwarded. At least one destination service is required.

destinations Sequence[TlsRouteRouteDestination]: The destination services to which traffic should be forwarded. At least one destination service is required.

destinations List<Property Map>: The destination services to which traffic should be forwarded. At least one destination service is required.

TlsRouteRouteActionResponse

Destinations List<Pulumi.GoogleNative.NetworkServices.V1.Inputs.TlsRouteRouteDestinationResponse>: The destination services to which traffic should be forwarded. At least one destination service is required.

Destinations []TlsRouteRouteDestinationResponse: The destination services to which traffic should be forwarded. At least one destination service is required.

destinations List<TlsRouteRouteDestinationResponse>: The destination services to which traffic should be forwarded. At least one destination service is required.

destinations TlsRouteRouteDestinationResponse[]: The destination services to which traffic should be forwarded. At least one destination service is required.

destinations Sequence[TlsRouteRouteDestinationResponse]: The destination services to which traffic should be forwarded. At least one destination service is required.

destinations List<Property Map>: The destination services to which traffic should be forwarded. At least one destination service is required.

TlsRouteRouteDestination

ServiceName string: The URL of a BackendService to route traffic to.
Weight int: Optional. Specifies the proportion of requests forwareded to the backend referenced by the service_name field. This is computed as: weight/Sum(weights in destinations) Weights in all destinations does not need to sum up to 100.

ServiceName string: The URL of a BackendService to route traffic to.
Weight int: Optional. Specifies the proportion of requests forwareded to the backend referenced by the service_name field. This is computed as: weight/Sum(weights in destinations) Weights in all destinations does not need to sum up to 100.

serviceName String: The URL of a BackendService to route traffic to.
weight Integer: Optional. Specifies the proportion of requests forwareded to the backend referenced by the service_name field. This is computed as: weight/Sum(weights in destinations) Weights in all destinations does not need to sum up to 100.

serviceName string: The URL of a BackendService to route traffic to.
weight number: Optional. Specifies the proportion of requests forwareded to the backend referenced by the service_name field. This is computed as: weight/Sum(weights in destinations) Weights in all destinations does not need to sum up to 100.

service_name str: The URL of a BackendService to route traffic to.
weight int: Optional. Specifies the proportion of requests forwareded to the backend referenced by the service_name field. This is computed as: weight/Sum(weights in destinations) Weights in all destinations does not need to sum up to 100.

serviceName String: The URL of a BackendService to route traffic to.
weight Number: Optional. Specifies the proportion of requests forwareded to the backend referenced by the service_name field. This is computed as: weight/Sum(weights in destinations) Weights in all destinations does not need to sum up to 100.

TlsRouteRouteDestinationResponse

ServiceName string: The URL of a BackendService to route traffic to.
Weight int: Optional. Specifies the proportion of requests forwareded to the backend referenced by the service_name field. This is computed as: weight/Sum(weights in destinations) Weights in all destinations does not need to sum up to 100.

ServiceName string: The URL of a BackendService to route traffic to.
Weight int: Optional. Specifies the proportion of requests forwareded to the backend referenced by the service_name field. This is computed as: weight/Sum(weights in destinations) Weights in all destinations does not need to sum up to 100.

serviceName String: The URL of a BackendService to route traffic to.
weight Integer: Optional. Specifies the proportion of requests forwareded to the backend referenced by the service_name field. This is computed as: weight/Sum(weights in destinations) Weights in all destinations does not need to sum up to 100.

serviceName string: The URL of a BackendService to route traffic to.
weight number: Optional. Specifies the proportion of requests forwareded to the backend referenced by the service_name field. This is computed as: weight/Sum(weights in destinations) Weights in all destinations does not need to sum up to 100.

service_name str: The URL of a BackendService to route traffic to.
weight int: Optional. Specifies the proportion of requests forwareded to the backend referenced by the service_name field. This is computed as: weight/Sum(weights in destinations) Weights in all destinations does not need to sum up to 100.

serviceName String: The URL of a BackendService to route traffic to.
weight Number: Optional. Specifies the proportion of requests forwareded to the backend referenced by the service_name field. This is computed as: weight/Sum(weights in destinations) Weights in all destinations does not need to sum up to 100.

TlsRouteRouteMatch

Alpn List<string>: Optional. ALPN (Application-Layer Protocol Negotiation) to match against. Examples: "http/1.1", "h2". At least one of sni_host and alpn is required. Up to 5 alpns across all matches can be set.
SniHost List<string>: Optional. SNI (server name indicator) to match against. SNI will be matched against all wildcard domains, i.e. www.example.com will be first matched against www.example.com, then *.example.com, then *.com. Partial wildcards are not supported, and values like *w.example.com are invalid. At least one of sni_host and alpn is required. Up to 5 sni hosts across all matches can be set.

Alpn []string: Optional. ALPN (Application-Layer Protocol Negotiation) to match against. Examples: "http/1.1", "h2". At least one of sni_host and alpn is required. Up to 5 alpns across all matches can be set.
SniHost []string: Optional. SNI (server name indicator) to match against. SNI will be matched against all wildcard domains, i.e. www.example.com will be first matched against www.example.com, then *.example.com, then *.com. Partial wildcards are not supported, and values like *w.example.com are invalid. At least one of sni_host and alpn is required. Up to 5 sni hosts across all matches can be set.

alpn List<String>: Optional. ALPN (Application-Layer Protocol Negotiation) to match against. Examples: "http/1.1", "h2". At least one of sni_host and alpn is required. Up to 5 alpns across all matches can be set.
sniHost List<String>: Optional. SNI (server name indicator) to match against. SNI will be matched against all wildcard domains, i.e. www.example.com will be first matched against www.example.com, then *.example.com, then *.com. Partial wildcards are not supported, and values like *w.example.com are invalid. At least one of sni_host and alpn is required. Up to 5 sni hosts across all matches can be set.

alpn string[]: Optional. ALPN (Application-Layer Protocol Negotiation) to match against. Examples: "http/1.1", "h2". At least one of sni_host and alpn is required. Up to 5 alpns across all matches can be set.
sniHost string[]: Optional. SNI (server name indicator) to match against. SNI will be matched against all wildcard domains, i.e. www.example.com will be first matched against www.example.com, then *.example.com, then *.com. Partial wildcards are not supported, and values like *w.example.com are invalid. At least one of sni_host and alpn is required. Up to 5 sni hosts across all matches can be set.

alpn Sequence[str]: Optional. ALPN (Application-Layer Protocol Negotiation) to match against. Examples: "http/1.1", "h2". At least one of sni_host and alpn is required. Up to 5 alpns across all matches can be set.
sni_host Sequence[str]: Optional. SNI (server name indicator) to match against. SNI will be matched against all wildcard domains, i.e. www.example.com will be first matched against www.example.com, then *.example.com, then *.com. Partial wildcards are not supported, and values like *w.example.com are invalid. At least one of sni_host and alpn is required. Up to 5 sni hosts across all matches can be set.

alpn List<String>: Optional. ALPN (Application-Layer Protocol Negotiation) to match against. Examples: "http/1.1", "h2". At least one of sni_host and alpn is required. Up to 5 alpns across all matches can be set.
sniHost List<String>: Optional. SNI (server name indicator) to match against. SNI will be matched against all wildcard domains, i.e. www.example.com will be first matched against www.example.com, then *.example.com, then *.com. Partial wildcards are not supported, and values like *w.example.com are invalid. At least one of sni_host and alpn is required. Up to 5 sni hosts across all matches can be set.

TlsRouteRouteMatchResponse

Alpn List<string>: Optional. ALPN (Application-Layer Protocol Negotiation) to match against. Examples: "http/1.1", "h2". At least one of sni_host and alpn is required. Up to 5 alpns across all matches can be set.
SniHost List<string>: Optional. SNI (server name indicator) to match against. SNI will be matched against all wildcard domains, i.e. www.example.com will be first matched against www.example.com, then *.example.com, then *.com. Partial wildcards are not supported, and values like *w.example.com are invalid. At least one of sni_host and alpn is required. Up to 5 sni hosts across all matches can be set.

Alpn []string: Optional. ALPN (Application-Layer Protocol Negotiation) to match against. Examples: "http/1.1", "h2". At least one of sni_host and alpn is required. Up to 5 alpns across all matches can be set.
SniHost []string: Optional. SNI (server name indicator) to match against. SNI will be matched against all wildcard domains, i.e. www.example.com will be first matched against www.example.com, then *.example.com, then *.com. Partial wildcards are not supported, and values like *w.example.com are invalid. At least one of sni_host and alpn is required. Up to 5 sni hosts across all matches can be set.

alpn List<String>: Optional. ALPN (Application-Layer Protocol Negotiation) to match against. Examples: "http/1.1", "h2". At least one of sni_host and alpn is required. Up to 5 alpns across all matches can be set.
sniHost List<String>: Optional. SNI (server name indicator) to match against. SNI will be matched against all wildcard domains, i.e. www.example.com will be first matched against www.example.com, then *.example.com, then *.com. Partial wildcards are not supported, and values like *w.example.com are invalid. At least one of sni_host and alpn is required. Up to 5 sni hosts across all matches can be set.

alpn string[]: Optional. ALPN (Application-Layer Protocol Negotiation) to match against. Examples: "http/1.1", "h2". At least one of sni_host and alpn is required. Up to 5 alpns across all matches can be set.
sniHost string[]: Optional. SNI (server name indicator) to match against. SNI will be matched against all wildcard domains, i.e. www.example.com will be first matched against www.example.com, then *.example.com, then *.com. Partial wildcards are not supported, and values like *w.example.com are invalid. At least one of sni_host and alpn is required. Up to 5 sni hosts across all matches can be set.

alpn Sequence[str]: Optional. ALPN (Application-Layer Protocol Negotiation) to match against. Examples: "http/1.1", "h2". At least one of sni_host and alpn is required. Up to 5 alpns across all matches can be set.
sni_host Sequence[str]: Optional. SNI (server name indicator) to match against. SNI will be matched against all wildcard domains, i.e. www.example.com will be first matched against www.example.com, then *.example.com, then *.com. Partial wildcards are not supported, and values like *w.example.com are invalid. At least one of sni_host and alpn is required. Up to 5 sni hosts across all matches can be set.

alpn List<String>: Optional. ALPN (Application-Layer Protocol Negotiation) to match against. Examples: "http/1.1", "h2". At least one of sni_host and alpn is required. Up to 5 alpns across all matches can be set.
sniHost List<String>: Optional. SNI (server name indicator) to match against. SNI will be matched against all wildcard domains, i.e. www.example.com will be first matched against www.example.com, then *.example.com, then *.com. Partial wildcards are not supported, and values like *w.example.com are invalid. At least one of sni_host and alpn is required. Up to 5 sni hosts across all matches can be set.

TlsRouteRouteRule

Action Pulumi.GoogleNative.NetworkServices.V1.Inputs.TlsRouteRouteAction: The detailed rule defining how to route matched traffic.
Matches List<Pulumi.GoogleNative.NetworkServices.V1.Inputs.TlsRouteRouteMatch>: RouteMatch defines the predicate used to match requests to a given action. Multiple match types are "OR"ed for evaluation.

Action TlsRouteRouteAction: The detailed rule defining how to route matched traffic.
Matches []TlsRouteRouteMatch: RouteMatch defines the predicate used to match requests to a given action. Multiple match types are "OR"ed for evaluation.

action TlsRouteRouteAction: The detailed rule defining how to route matched traffic.
matches List<TlsRouteRouteMatch>: RouteMatch defines the predicate used to match requests to a given action. Multiple match types are "OR"ed for evaluation.

action TlsRouteRouteAction: The detailed rule defining how to route matched traffic.
matches TlsRouteRouteMatch[]: RouteMatch defines the predicate used to match requests to a given action. Multiple match types are "OR"ed for evaluation.

action TlsRouteRouteAction: The detailed rule defining how to route matched traffic.
matches Sequence[TlsRouteRouteMatch]: RouteMatch defines the predicate used to match requests to a given action. Multiple match types are "OR"ed for evaluation.

action Property Map: The detailed rule defining how to route matched traffic.
matches List<Property Map>: RouteMatch defines the predicate used to match requests to a given action. Multiple match types are "OR"ed for evaluation.

TlsRouteRouteRuleResponse

Action Pulumi.GoogleNative.NetworkServices.V1.Inputs.TlsRouteRouteActionResponse: The detailed rule defining how to route matched traffic.
Matches List<Pulumi.GoogleNative.NetworkServices.V1.Inputs.TlsRouteRouteMatchResponse>: RouteMatch defines the predicate used to match requests to a given action. Multiple match types are "OR"ed for evaluation.

Action TlsRouteRouteActionResponse: The detailed rule defining how to route matched traffic.
Matches []TlsRouteRouteMatchResponse: RouteMatch defines the predicate used to match requests to a given action. Multiple match types are "OR"ed for evaluation.

action TlsRouteRouteActionResponse: The detailed rule defining how to route matched traffic.
matches List<TlsRouteRouteMatchResponse>: RouteMatch defines the predicate used to match requests to a given action. Multiple match types are "OR"ed for evaluation.

action TlsRouteRouteActionResponse: The detailed rule defining how to route matched traffic.
matches TlsRouteRouteMatchResponse[]: RouteMatch defines the predicate used to match requests to a given action. Multiple match types are "OR"ed for evaluation.

action TlsRouteRouteActionResponse: The detailed rule defining how to route matched traffic.
matches Sequence[TlsRouteRouteMatchResponse]: RouteMatch defines the predicate used to match requests to a given action. Multiple match types are "OR"ed for evaluation.

action Property Map: The detailed rule defining how to route matched traffic.
matches List<Property Map>: RouteMatch defines the predicate used to match requests to a given action. Multiple match types are "OR"ed for evaluation.

Package Details

Repository: Google Cloud Native pulumi/pulumi-google-native
License: Apache-2.0