Package com.pulumi.gcp.compute
Class RegionBackendService
- java.lang.Object
-
- com.pulumi.resources.Resource
-
- com.pulumi.resources.CustomResource
-
- com.pulumi.gcp.compute.RegionBackendService
-
public class RegionBackendService extends com.pulumi.resources.CustomResource
A Region Backend Service defines a regionally-scoped group of virtual machines that will serve traffic for load balancing. To get more information about RegionBackendService, see: * [API documentation](https://cloud.google.com/compute/docs/reference/latest/regionBackendServices) * How-to Guides * [Internal TCP/UDP Load Balancing](https://cloud.google.com/compute/docs/load-balancing/internal/) > **Warning:** All arguments including the following potentially sensitive values will be stored in the raw state as plain text: `iap.oauth2_client_secret`, `iap.oauth2_client_secret_sha256`. Read more about sensitive data in state. ## Example Usage ### Region Backend Service Basic ```java package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.gcp.compute.HealthCheck; import com.pulumi.gcp.compute.HealthCheckArgs; import com.pulumi.gcp.compute.inputs.HealthCheckTcpHealthCheckArgs; import com.pulumi.gcp.compute.RegionBackendService; import com.pulumi.gcp.compute.RegionBackendServiceArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var defaultHealthCheck = new HealthCheck("defaultHealthCheck", HealthCheckArgs.builder() .checkIntervalSec(1) .timeoutSec(1) .tcpHealthCheck(HealthCheckTcpHealthCheckArgs.builder() .port("80") .build()) .build()); var defaultRegionBackendService = new RegionBackendService("defaultRegionBackendService", RegionBackendServiceArgs.builder() .region("us-central1") .healthChecks(defaultHealthCheck.id()) .connectionDrainingTimeoutSec(10) .sessionAffinity("CLIENT_IP") .build()); } } ``` ### Region Backend Service Cache ```java package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.gcp.compute.RegionHealthCheck; import com.pulumi.gcp.compute.RegionHealthCheckArgs; import com.pulumi.gcp.compute.inputs.RegionHealthCheckHttpHealthCheckArgs; import com.pulumi.gcp.compute.RegionBackendService; import com.pulumi.gcp.compute.RegionBackendServiceArgs; import com.pulumi.gcp.compute.inputs.RegionBackendServiceCdnPolicyArgs; import com.pulumi.resources.CustomResourceOptions; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var defaultRegionHealthCheck = new RegionHealthCheck("defaultRegionHealthCheck", RegionHealthCheckArgs.builder() .region("us-central1") .httpHealthCheck(RegionHealthCheckHttpHealthCheckArgs.builder() .port(80) .build()) .build(), CustomResourceOptions.builder() .provider(google_beta) .build()); var defaultRegionBackendService = new RegionBackendService("defaultRegionBackendService", RegionBackendServiceArgs.builder() .region("us-central1") .healthChecks(defaultRegionHealthCheck.id()) .enableCdn(true) .cdnPolicy(RegionBackendServiceCdnPolicyArgs.builder() .cacheMode("CACHE_ALL_STATIC") .defaultTtl(3600) .clientTtl(7200) .maxTtl(10800) .negativeCaching(true) .signedUrlCacheMaxAgeSec(7200) .build()) .loadBalancingScheme("EXTERNAL") .protocol("HTTP") .build(), CustomResourceOptions.builder() .provider(google_beta) .build()); } } ``` ### Region Backend Service Ilb Round Robin ```java package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.gcp.compute.HealthCheck; import com.pulumi.gcp.compute.HealthCheckArgs; import com.pulumi.gcp.compute.inputs.HealthCheckHttpHealthCheckArgs; import com.pulumi.gcp.compute.RegionBackendService; import com.pulumi.gcp.compute.RegionBackendServiceArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var healthCheck = new HealthCheck("healthCheck", HealthCheckArgs.builder() .httpHealthCheck(HealthCheckHttpHealthCheckArgs.builder() .port(80) .build()) .build()); var default_ = new RegionBackendService("default", RegionBackendServiceArgs.builder() .region("us-central1") .healthChecks(healthCheck.id()) .protocol("HTTP") .loadBalancingScheme("INTERNAL_MANAGED") .localityLbPolicy("ROUND_ROBIN") .build()); } } ``` ### Region Backend Service External ```java package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.gcp.compute.RegionHealthCheck; import com.pulumi.gcp.compute.RegionHealthCheckArgs; import com.pulumi.gcp.compute.inputs.RegionHealthCheckTcpHealthCheckArgs; import com.pulumi.gcp.compute.RegionBackendService; import com.pulumi.gcp.compute.RegionBackendServiceArgs; import com.pulumi.resources.CustomResourceOptions; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var healthCheck = new RegionHealthCheck("healthCheck", RegionHealthCheckArgs.builder() .region("us-central1") .tcpHealthCheck(RegionHealthCheckTcpHealthCheckArgs.builder() .port(80) .build()) .build(), CustomResourceOptions.builder() .provider(google_beta) .build()); var default_ = new RegionBackendService("default", RegionBackendServiceArgs.builder() .region("us-central1") .healthChecks(healthCheck.id()) .protocol("TCP") .loadBalancingScheme("EXTERNAL") .build(), CustomResourceOptions.builder() .provider(google_beta) .build()); } } ``` ### Region Backend Service External Weighted ```java package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.gcp.compute.RegionHealthCheck; import com.pulumi.gcp.compute.RegionHealthCheckArgs; import com.pulumi.gcp.compute.inputs.RegionHealthCheckHttpHealthCheckArgs; import com.pulumi.gcp.compute.RegionBackendService; import com.pulumi.gcp.compute.RegionBackendServiceArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var healthCheck = new RegionHealthCheck("healthCheck", RegionHealthCheckArgs.builder() .region("us-central1") .httpHealthCheck(RegionHealthCheckHttpHealthCheckArgs.builder() .port(80) .build()) .build()); var default_ = new RegionBackendService("default", RegionBackendServiceArgs.builder() .region("us-central1") .healthChecks(healthCheck.id()) .protocol("TCP") .loadBalancingScheme("EXTERNAL") .localityLbPolicy("WEIGHTED_MAGLEV") .build()); } } ``` ### Region Backend Service Ilb Ring Hash ```java package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.gcp.compute.HealthCheck; import com.pulumi.gcp.compute.HealthCheckArgs; import com.pulumi.gcp.compute.inputs.HealthCheckHttpHealthCheckArgs; import com.pulumi.gcp.compute.RegionBackendService; import com.pulumi.gcp.compute.RegionBackendServiceArgs; import com.pulumi.gcp.compute.inputs.RegionBackendServiceCircuitBreakersArgs; import com.pulumi.gcp.compute.inputs.RegionBackendServiceConsistentHashArgs; import com.pulumi.gcp.compute.inputs.RegionBackendServiceConsistentHashHttpCookieArgs; import com.pulumi.gcp.compute.inputs.RegionBackendServiceConsistentHashHttpCookieTtlArgs; import com.pulumi.gcp.compute.inputs.RegionBackendServiceOutlierDetectionArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var healthCheck = new HealthCheck("healthCheck", HealthCheckArgs.builder() .httpHealthCheck(HealthCheckHttpHealthCheckArgs.builder() .port(80) .build()) .build()); var default_ = new RegionBackendService("default", RegionBackendServiceArgs.builder() .region("us-central1") .healthChecks(healthCheck.id()) .loadBalancingScheme("INTERNAL_MANAGED") .localityLbPolicy("RING_HASH") .sessionAffinity("HTTP_COOKIE") .protocol("HTTP") .circuitBreakers(RegionBackendServiceCircuitBreakersArgs.builder() .maxConnections(10) .build()) .consistentHash(RegionBackendServiceConsistentHashArgs.builder() .httpCookie(RegionBackendServiceConsistentHashHttpCookieArgs.builder() .ttl(RegionBackendServiceConsistentHashHttpCookieTtlArgs.builder() .seconds(11) .nanos(1111) .build()) .name("mycookie") .build()) .build()) .outlierDetection(RegionBackendServiceOutlierDetectionArgs.builder() .consecutiveErrors(2) .build()) .build()); } } ``` ### Region Backend Service Balancing Mode ```java package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.gcp.compute.ComputeFunctions; import com.pulumi.gcp.compute.inputs.GetImageArgs; import com.pulumi.gcp.compute.Network; import com.pulumi.gcp.compute.NetworkArgs; import com.pulumi.gcp.compute.Subnetwork; import com.pulumi.gcp.compute.SubnetworkArgs; import com.pulumi.gcp.compute.InstanceTemplate; import com.pulumi.gcp.compute.InstanceTemplateArgs; import com.pulumi.gcp.compute.inputs.InstanceTemplateNetworkInterfaceArgs; import com.pulumi.gcp.compute.inputs.InstanceTemplateDiskArgs; import com.pulumi.gcp.compute.RegionInstanceGroupManager; import com.pulumi.gcp.compute.RegionInstanceGroupManagerArgs; import com.pulumi.gcp.compute.inputs.RegionInstanceGroupManagerVersionArgs; import com.pulumi.gcp.compute.RegionHealthCheck; import com.pulumi.gcp.compute.RegionHealthCheckArgs; import com.pulumi.gcp.compute.inputs.RegionHealthCheckHttpHealthCheckArgs; import com.pulumi.gcp.compute.RegionBackendService; import com.pulumi.gcp.compute.RegionBackendServiceArgs; import com.pulumi.gcp.compute.inputs.RegionBackendServiceBackendArgs; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { final var debianImage = ComputeFunctions.getImage(GetImageArgs.builder() .family("debian-11") .project("debian-cloud") .build()); var defaultNetwork = new Network("defaultNetwork", NetworkArgs.builder() .autoCreateSubnetworks(false) .routingMode("REGIONAL") .build()); var defaultSubnetwork = new Subnetwork("defaultSubnetwork", SubnetworkArgs.builder() .ipCidrRange("10.1.2.0/24") .region("us-central1") .network(defaultNetwork.id()) .build()); var instanceTemplate = new InstanceTemplate("instanceTemplate", InstanceTemplateArgs.builder() .machineType("e2-medium") .networkInterfaces(InstanceTemplateNetworkInterfaceArgs.builder() .network(defaultNetwork.id()) .subnetwork(defaultSubnetwork.id()) .build()) .disks(InstanceTemplateDiskArgs.builder() .sourceImage(debianImage.applyValue(getImageResult -> getImageResult.selfLink())) .autoDelete(true) .boot(true) .build()) .tags( "allow-ssh", "load-balanced-backend") .build()); var rigm = new RegionInstanceGroupManager("rigm", RegionInstanceGroupManagerArgs.builder() .region("us-central1") .versions(RegionInstanceGroupManagerVersionArgs.builder() .instanceTemplate(instanceTemplate.id()) .name("primary") .build()) .baseInstanceName("internal-glb") .targetSize(1) .build()); var defaultRegionHealthCheck = new RegionHealthCheck("defaultRegionHealthCheck", RegionHealthCheckArgs.builder() .region("us-central1") .httpHealthCheck(RegionHealthCheckHttpHealthCheckArgs.builder() .portSpecification("USE_SERVING_PORT") .build()) .build()); var defaultRegionBackendService = new RegionBackendService("defaultRegionBackendService", RegionBackendServiceArgs.builder() .loadBalancingScheme("INTERNAL_MANAGED") .backends(RegionBackendServiceBackendArgs.builder() .group(rigm.instanceGroup()) .balancingMode("UTILIZATION") .capacityScaler(1) .build()) .region("us-central1") .protocol("HTTP") .timeoutSec(10) .healthChecks(defaultRegionHealthCheck.id()) .build()); } } ``` ### Region Backend Service Connection Tracking ```java package generated_program; import com.pulumi.Context; import com.pulumi.Pulumi; import com.pulumi.core.Output; import com.pulumi.gcp.compute.RegionHealthCheck; import com.pulumi.gcp.compute.RegionHealthCheckArgs; import com.pulumi.gcp.compute.inputs.RegionHealthCheckTcpHealthCheckArgs; import com.pulumi.gcp.compute.RegionBackendService; import com.pulumi.gcp.compute.RegionBackendServiceArgs; import com.pulumi.gcp.compute.inputs.RegionBackendServiceConnectionTrackingPolicyArgs; import com.pulumi.resources.CustomResourceOptions; import java.util.List; import java.util.ArrayList; import java.util.Map; import java.io.File; import java.nio.file.Files; import java.nio.file.Paths; public class App { public static void main(String[] args) { Pulumi.run(App::stack); } public static void stack(Context ctx) { var healthCheck = new RegionHealthCheck("healthCheck", RegionHealthCheckArgs.builder() .region("us-central1") .tcpHealthCheck(RegionHealthCheckTcpHealthCheckArgs.builder() .port(22) .build()) .build(), CustomResourceOptions.builder() .provider(google_beta) .build()); var default_ = new RegionBackendService("default", RegionBackendServiceArgs.builder() .region("us-central1") .healthChecks(healthCheck.id()) .connectionDrainingTimeoutSec(10) .sessionAffinity("CLIENT_IP") .protocol("TCP") .loadBalancingScheme("EXTERNAL") .connectionTrackingPolicy(RegionBackendServiceConnectionTrackingPolicyArgs.builder() .trackingMode("PER_SESSION") .connectionPersistenceOnUnhealthyBackends("NEVER_PERSIST") .idleTimeoutSec(60) .enableStrongAffinity(true) .build()) .build(), CustomResourceOptions.builder() .provider(google_beta) .build()); } } ``` ## Import RegionBackendService can be imported using any of these accepted formats ```sh $ pulumi import gcp:compute/regionBackendService:RegionBackendService default projects/{{project}}/regions/{{region}}/backendServices/{{name}} ``` ```sh $ pulumi import gcp:compute/regionBackendService:RegionBackendService default {{project}}/{{region}}/{{name}} ``` ```sh $ pulumi import gcp:compute/regionBackendService:RegionBackendService default {{region}}/{{name}} ``` ```sh $ pulumi import gcp:compute/regionBackendService:RegionBackendService default {{name}} ```
-
-
Constructor Summary
Constructors Constructor Description RegionBackendService(java.lang.String name)
RegionBackendService(java.lang.String name, RegionBackendServiceArgs args)
RegionBackendService(java.lang.String name, RegionBackendServiceArgs args, com.pulumi.resources.CustomResourceOptions options)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description com.pulumi.core.Output<java.util.Optional<java.lang.Integer>>
affinityCookieTtlSec()
com.pulumi.core.Output<java.util.Optional<java.util.List<RegionBackendServiceBackend>>>
backends()
com.pulumi.core.Output<RegionBackendServiceCdnPolicy>
cdnPolicy()
com.pulumi.core.Output<java.util.Optional<RegionBackendServiceCircuitBreakers>>
circuitBreakers()
com.pulumi.core.Output<java.util.Optional<java.lang.Integer>>
connectionDrainingTimeoutSec()
com.pulumi.core.Output<java.util.Optional<RegionBackendServiceConnectionTrackingPolicy>>
connectionTrackingPolicy()
com.pulumi.core.Output<java.util.Optional<RegionBackendServiceConsistentHash>>
consistentHash()
com.pulumi.core.Output<java.lang.String>
creationTimestamp()
com.pulumi.core.Output<java.util.Optional<java.lang.String>>
description()
com.pulumi.core.Output<java.util.Optional<java.lang.Boolean>>
enableCdn()
com.pulumi.core.Output<java.util.Optional<RegionBackendServiceFailoverPolicy>>
failoverPolicy()
com.pulumi.core.Output<java.lang.String>
fingerprint()
static RegionBackendService
get(java.lang.String name, com.pulumi.core.Output<java.lang.String> id, RegionBackendServiceState state, com.pulumi.resources.CustomResourceOptions options)
Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.com.pulumi.core.Output<java.util.Optional<java.lang.String>>
healthChecks()
com.pulumi.core.Output<java.util.Optional<RegionBackendServiceIap>>
iap()
com.pulumi.core.Output<java.util.Optional<java.lang.String>>
loadBalancingScheme()
com.pulumi.core.Output<java.util.Optional<java.lang.String>>
localityLbPolicy()
com.pulumi.core.Output<RegionBackendServiceLogConfig>
logConfig()
com.pulumi.core.Output<java.lang.String>
name()
com.pulumi.core.Output<java.util.Optional<java.lang.String>>
network()
com.pulumi.core.Output<java.util.Optional<RegionBackendServiceOutlierDetection>>
outlierDetection()
com.pulumi.core.Output<java.lang.String>
portName()
com.pulumi.core.Output<java.lang.String>
project()
com.pulumi.core.Output<java.lang.String>
protocol()
com.pulumi.core.Output<java.lang.String>
region()
com.pulumi.core.Output<java.util.Optional<java.lang.String>>
securityPolicy()
com.pulumi.core.Output<java.lang.String>
selfLink()
com.pulumi.core.Output<java.lang.String>
sessionAffinity()
com.pulumi.core.Output<java.util.Optional<RegionBackendServiceSubsetting>>
subsetting()
com.pulumi.core.Output<java.lang.Integer>
timeoutSec()
-
-
-
Constructor Detail
-
RegionBackendService
public RegionBackendService(java.lang.String name)
- Parameters:
name
- The _unique_ name of the resulting resource.
-
RegionBackendService
public RegionBackendService(java.lang.String name, @Nullable RegionBackendServiceArgs args)
- Parameters:
name
- The _unique_ name of the resulting resource.args
- The arguments to use to populate this resource's properties.
-
RegionBackendService
public RegionBackendService(java.lang.String name, @Nullable RegionBackendServiceArgs args, @Nullable com.pulumi.resources.CustomResourceOptions options)
- Parameters:
name
- The _unique_ name of the resulting resource.args
- The arguments to use to populate this resource's properties.options
- A bag of options that control this resource's behavior.
-
-
Method Detail
-
affinityCookieTtlSec
public com.pulumi.core.Output<java.util.Optional<java.lang.Integer>> affinityCookieTtlSec()
- Returns:
- 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.
-
backends
public com.pulumi.core.Output<java.util.Optional<java.util.List<RegionBackendServiceBackend>>> backends()
- Returns:
- The set of backends that serve this RegionBackendService. Structure is documented below.
-
cdnPolicy
public com.pulumi.core.Output<RegionBackendServiceCdnPolicy> cdnPolicy()
- Returns:
- Cloud CDN configuration for this BackendService. Structure is documented below.
-
circuitBreakers
public com.pulumi.core.Output<java.util.Optional<RegionBackendServiceCircuitBreakers>> circuitBreakers()
- Returns:
- 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.
-
connectionDrainingTimeoutSec
public com.pulumi.core.Output<java.util.Optional<java.lang.Integer>> connectionDrainingTimeoutSec()
- Returns:
- Time for which instance will be drained (not accept new connections, but still work to finish started).
-
connectionTrackingPolicy
public com.pulumi.core.Output<java.util.Optional<RegionBackendServiceConnectionTrackingPolicy>> connectionTrackingPolicy()
- Returns:
- Connection Tracking configuration for this BackendService. This is available only for Layer 4 Internal Load Balancing and Network Load Balancing. Structure is documented below.
-
consistentHash
public com.pulumi.core.Output<java.util.Optional<RegionBackendServiceConsistentHash>> consistentHash()
- Returns:
- 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 -
-
creationTimestamp
public com.pulumi.core.Output<java.lang.String> creationTimestamp()
- Returns:
- Creation timestamp in RFC3339 text format.
-
description
public com.pulumi.core.Output<java.util.Optional<java.lang.String>> description()
- Returns:
- An optional description of this resource.
-
enableCdn
public com.pulumi.core.Output<java.util.Optional<java.lang.Boolean>> enableCdn()
- Returns:
- If true, enable Cloud CDN for this RegionBackendService.
-
failoverPolicy
public com.pulumi.core.Output<java.util.Optional<RegionBackendServiceFailoverPolicy>> failoverPolicy()
- Returns:
- Policy for failovers. Structure is documented below.
-
fingerprint
public com.pulumi.core.Output<java.lang.String> fingerprint()
- Returns:
- Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking.
-
healthChecks
public com.pulumi.core.Output<java.util.Optional<java.lang.String>> healthChecks()
- Returns:
- The set of URLs to HealthCheck resources for health checking this RegionBackendService. Currently at most one health check can be specified. A health check must be specified unless the backend service uses an internet or serverless NEG as a backend.
-
iap
public com.pulumi.core.Output<java.util.Optional<RegionBackendServiceIap>> iap()
- Returns:
- Settings for enabling Cloud Identity Aware Proxy Structure is documented below.
-
loadBalancingScheme
public com.pulumi.core.Output<java.util.Optional<java.lang.String>> loadBalancingScheme()
- Returns:
- 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). For more information, refer to [Choosing a load balancer](https://cloud.google.com/load-balancing/docs/backend-service). Default value is `INTERNAL`. Possible values are: `EXTERNAL`, `EXTERNAL_MANAGED`, `INTERNAL`, `INTERNAL_MANAGED`.
-
localityLbPolicy
public com.pulumi.core.Output<java.util.Optional<java.lang.String>> localityLbPolicy()
- Returns:
- The load balancing algorithm used within the scope of the locality. The possible values are:
-
logConfig
public com.pulumi.core.Output<RegionBackendServiceLogConfig> logConfig()
- Returns:
- 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.
-
name
public com.pulumi.core.Output<java.lang.String> name()
- Returns:
- Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `a-z?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. ***
-
network
public com.pulumi.core.Output<java.util.Optional<java.lang.String>> network()
- Returns:
- 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.
-
outlierDetection
public com.pulumi.core.Output<java.util.Optional<RegionBackendServiceOutlierDetection>> outlierDetection()
- Returns:
- 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.
-
portName
public com.pulumi.core.Output<java.lang.String> portName()
- Returns:
- 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, EXTERNAL_MANAGED, 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).
-
project
public com.pulumi.core.Output<java.lang.String> project()
- Returns:
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
-
protocol
public com.pulumi.core.Output<java.lang.String> protocol()
- Returns:
- 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. Possible values are: `HTTP`, `HTTPS`, `HTTP2`, `SSL`, `TCP`, `UDP`, `GRPC`, `UNSPECIFIED`.
-
region
public com.pulumi.core.Output<java.lang.String> region()
- Returns:
- The Region in which the created backend service should reside. If it is not provided, the provider region is used.
-
securityPolicy
public com.pulumi.core.Output<java.util.Optional<java.lang.String>> securityPolicy()
- Returns:
- The security policy associated with this backend service.
-
selfLink
public com.pulumi.core.Output<java.lang.String> selfLink()
- Returns:
- The URI of the created resource.
-
sessionAffinity
public com.pulumi.core.Output<java.lang.String> sessionAffinity()
- Returns:
- Type of session affinity to use. The default is NONE. Session affinity is not applicable if the protocol is UDP. Possible values are: `NONE`, `CLIENT_IP`, `CLIENT_IP_PORT_PROTO`, `CLIENT_IP_PROTO`, `GENERATED_COOKIE`, `HEADER_FIELD`, `HTTP_COOKIE`, `CLIENT_IP_NO_DESTINATION`.
-
subsetting
public com.pulumi.core.Output<java.util.Optional<RegionBackendServiceSubsetting>> subsetting()
- Returns:
- Subsetting configuration for this BackendService. Currently this is applicable only for Internal TCP/UDP load balancing and Internal HTTP(S) load balancing.
-
timeoutSec
public com.pulumi.core.Output<java.lang.Integer> timeoutSec()
- Returns:
- How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds. Valid range is [1, 86400].
-
get
public static RegionBackendService get(java.lang.String name, com.pulumi.core.Output<java.lang.String> id, @Nullable RegionBackendServiceState state, @Nullable com.pulumi.resources.CustomResourceOptions options)
Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.- Parameters:
name
- The _unique_ name of the resulting resource.id
- The _unique_ provider ID of the resource to lookup.state
-options
- Optional settings to control the behavior of the CustomResource.
-
-