Class RegionBackendServiceState

Inheritance

System.Object

InputArgs

ResourceArgs

RegionBackendServiceState

Inherited Members

ResourceArgs.Empty

System.Object.Equals(System.Object)

System.Object.Equals(System.Object, System.Object)

System.Object.GetHashCode()

System.Object.GetType()

System.Object.MemberwiseClone()

System.Object.ReferenceEquals(System.Object, System.Object)

System.Object.ToString()

Namespace: Pulumi.Gcp.Compute

Assembly: Pulumi.Gcp.dll

Syntax

public sealed class RegionBackendServiceState : ResourceArgs

Constructors

View Source

RegionBackendServiceState()

Declaration

public RegionBackendServiceState()

Properties

View Source

AffinityCookieTtlSec

Lifetime of cookies in seconds if session_affinity is GENERATED_COOKIE. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value for TTL is one day. When the load balancing scheme is INTERNAL, this field is not used.

Declaration

public Input<int> AffinityCookieTtlSec { get; set; }

Property Value

Type	Description
Input<System.Int32>

View Source

Backends

The set of backends that serve this RegionBackendService. Structure is documented below.

Declaration

public InputList<RegionBackendServiceBackendGetArgs> Backends { get; set; }

Property Value

Type	Description
InputList<RegionBackendServiceBackendGetArgs>

View Source

CircuitBreakers

Settings controlling the volume of connections to a backend service. This field is applicable only when the load_balancing_scheme is set to INTERNAL_MANAGED and the protocol is set to HTTP, HTTPS, or HTTP2. Structure is documented below.

Declaration

public Input<RegionBackendServiceCircuitBreakersGetArgs> CircuitBreakers { get; set; }

Property Value

Type	Description
Input<RegionBackendServiceCircuitBreakersGetArgs>

View Source

ConnectionDrainingTimeoutSec

Time for which instance will be drained (not accept new connections, but still work to finish started).

Declaration

public Input<int> ConnectionDrainingTimeoutSec { get; set; }

Property Value

Type	Description
Input<System.Int32>

View Source

ConsistentHash

Consistent Hash-based load balancing can be used to provide soft session affinity based on HTTP headers, cookies or other properties. This load balancing policy is applicable only for HTTP connections. The affinity to a particular destination host will be lost when one or more hosts are added/removed from the destination service. This field specifies parameters that control consistent hashing. This field only applies when all of the following are true -

Declaration

public Input<RegionBackendServiceConsistentHashGetArgs> ConsistentHash { get; set; }

Property Value

Type	Description
Input<RegionBackendServiceConsistentHashGetArgs>

View Source

CreationTimestamp

Creation timestamp in RFC3339 text format.

Declaration

public Input<string> CreationTimestamp { get; set; }

Property Value

Type	Description
Input<System.String>

View Source

Description

An optional description of this resource. Provide this property when you create the resource.

Declaration

public Input<string> Description { get; set; }

Property Value

Type	Description
Input<System.String>

View Source

FailoverPolicy

Policy for failovers. Structure is documented below.

Declaration

public Input<RegionBackendServiceFailoverPolicyGetArgs> FailoverPolicy { get; set; }

Property Value

Type	Description
Input<RegionBackendServiceFailoverPolicyGetArgs>

View Source

Fingerprint

Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking.

Declaration

public Input<string> Fingerprint { get; set; }

Property Value

Type	Description
Input<System.String>

View Source

HealthChecks

The set of URLs to HealthCheck resources for health checking this RegionBackendService. Currently at most one health check can be specified, and a health check is required.

Declaration

public Input<string> HealthChecks { get; set; }

Property Value

Type	Description
Input<System.String>

View Source

LoadBalancingScheme

Indicates what kind of load balancing this regional backend service will be used for. A backend service created for one type of load balancing cannot be used with the other(s).

Declaration

public Input<string> LoadBalancingScheme { get; set; }

Property Value

Type	Description
Input<System.String>

View Source

LocalityLbPolicy

The load balancing algorithm used within the scope of the locality. The possible values are - ROUND_ROBIN - This is a simple policy in which each healthy backend is selected in round robin order. LEAST_REQUEST - An O(1) algorithm which selects two random healthy hosts and picks the host which has fewer active requests. RING_HASH - The ring/modulo hash load balancer implements consistent hashing to backends. The algorithm has the property that the addition/removal of a host from a set of N hosts only affects 1/N of the requests. RANDOM - The load balancer selects a random healthy host. ORIGINAL_DESTINATION - Backend host is selected based on the client connection metadata, i.e., connections are opened to the same address as the destination address of the incoming connection before the connection was redirected to the load balancer. MAGLEV - used as a drop in replacement for the ring hash load balancer. Maglev is not as stable as ring hash but has faster table lookup build times and host selection times. For more information about Maglev, refer to https://ai.google/research/pubs/pub44824 This field is applicable only when the load_balancing_scheme is set to INTERNAL_MANAGED and the protocol is set to HTTP, HTTPS, or HTTP2.

Declaration

public Input<string> LocalityLbPolicy { get; set; }

Property Value

Type	Description
Input<System.String>

View Source

LogConfig

This field denotes the logging options for the load balancer traffic served by this backend service. If logging is enabled, logs will be exported to Stackdriver. Structure is documented below.

Declaration

public Input<RegionBackendServiceLogConfigGetArgs> LogConfig { get; set; }

Property Value

Type	Description
Input<RegionBackendServiceLogConfigGetArgs>

View Source

Name

Name of the cookie.

Declaration

public Input<string> Name { get; set; }

Property Value

Type	Description
Input<System.String>

View Source

Network

The URL of the network to which this backend service belongs. This field can only be specified when the load balancing scheme is set to INTERNAL.

Declaration

public Input<string> Network { get; set; }

Property Value

Type	Description
Input<System.String>

View Source

OutlierDetection

Settings controlling eviction of unhealthy hosts from the load balancing pool. This field is applicable only when the load_balancing_scheme is set to INTERNAL_MANAGED and the protocol is set to HTTP, HTTPS, or HTTP2. Structure is documented below.

Declaration

public Input<RegionBackendServiceOutlierDetectionGetArgs> OutlierDetection { get; set; }

Property Value

Type	Description
Input<RegionBackendServiceOutlierDetectionGetArgs>

View Source

PortName

A named port on a backend instance group representing the port for communication to the backend VMs in that group. Required when the loadBalancingScheme is EXTERNAL, INTERNAL_MANAGED, or INTERNAL_SELF_MANAGED and the backends are instance groups. The named port must be defined on each backend instance group. This parameter has no meaning if the backends are NEGs. API sets a default of "http" if not given. Must be omitted when the loadBalancingScheme is INTERNAL (Internal TCP/UDP Load Balancing).

Declaration

public Input<string> PortName { get; set; }

Property Value

Type	Description
Input<System.String>

View Source

Project

The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

Declaration

public Input<string> Project { get; set; }

Property Value

Type	Description
Input<System.String>

View Source

Protocol

The protocol this RegionBackendService uses to communicate with backends. The default is HTTP. NOTE: HTTP2 is only valid for beta HTTP/2 load balancer types and may result in errors if used with the GA API.

Declaration

public Input<string> Protocol { get; set; }

Property Value

Type	Description
Input<System.String>

View Source

Region

The Region in which the created backend service should reside. If it is not provided, the provider region is used.

Declaration

public Input<string> Region { get; set; }

Property Value

Type	Description
Input<System.String>

View Source

SelfLink

The URI of the created resource.

Declaration

public Input<string> SelfLink { get; set; }

Property Value

Type	Description
Input<System.String>

View Source

SessionAffinity

Type of session affinity to use. The default is NONE. Session affinity is not applicable if the protocol is UDP.

Declaration

public Input<string> SessionAffinity { get; set; }

Property Value

Type	Description
Input<System.String>

View Source

TimeoutSec

How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds. Valid range is [1, 86400].

Declaration

public Input<int> TimeoutSec { get; set; }

Property Value

Type	Description
Input<System.Int32>