Yandex

v0.10.0 published on Thursday, Nov 18, 2021 by Pulumi

AlbBackendGroup

Creates a backend group in the specified folder and adds the specified backends to it. For more information, see the official documentation.

Example Usage

using Pulumi;
using Yandex = Pulumi.Yandex;

class MyStack : Stack
{
    public MyStack()
    {
        var test_backend_group = new Yandex.AlbBackendGroup("test-backend-group", new Yandex.AlbBackendGroupArgs
        {
            HttpBackends = 
            {
                new Yandex.Inputs.AlbBackendGroupHttpBackendArgs
                {
                    Healthcheck = new Yandex.Inputs.AlbBackendGroupHttpBackendHealthcheckArgs
                    {
                        HttpHealthcheck = new Yandex.Inputs.AlbBackendGroupHttpBackendHealthcheckHttpHealthcheckArgs
                        {
                            Path = "/",
                        },
                        Interval = "1s",
                        Timeout = "1s",
                    },
                    Http2 = true,
                    LoadBalancingConfig = new Yandex.Inputs.AlbBackendGroupHttpBackendLoadBalancingConfigArgs
                    {
                        PanicThreshold = 50,
                    },
                    Name = "test-http-backend",
                    Port = 8080,
                    TargetGroupIds = 
                    {
                        yandex_alb_target_group.Test_target_group.Id,
                    },
                    Tls = new Yandex.Inputs.AlbBackendGroupHttpBackendTlsArgs
                    {
                        Sni = "backend-domain.internal",
                    },
                    Weight = 1,
                },
            },
        });
    }

}
package main

import (
	"github.com/pulumi/pulumi-yandex/sdk/go/yandex"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := yandex.NewAlbBackendGroup(ctx, "test_backend_group", &yandex.AlbBackendGroupArgs{
			HttpBackends: AlbBackendGroupHttpBackendArray{
				&AlbBackendGroupHttpBackendArgs{
					Healthcheck: &AlbBackendGroupHttpBackendHealthcheckArgs{
						HttpHealthcheck: &AlbBackendGroupHttpBackendHealthcheckHttpHealthcheckArgs{
							Path: pulumi.String("/"),
						},
						Interval: pulumi.String("1s"),
						Timeout:  pulumi.String("1s"),
					},
					Http2: pulumi.Bool(true),
					LoadBalancingConfig: &AlbBackendGroupHttpBackendLoadBalancingConfigArgs{
						PanicThreshold: pulumi.Int(50),
					},
					Name: pulumi.String("test-http-backend"),
					Port: pulumi.Int(8080),
					TargetGroupIds: pulumi.StringArray{
						pulumi.Any(yandex_alb_target_group.Test - target - group.Id),
					},
					Tls: &AlbBackendGroupHttpBackendTlsArgs{
						Sni: pulumi.String("backend-domain.internal"),
					},
					Weight: pulumi.Int(1),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
import pulumi
import pulumi_yandex as yandex

test_backend_group = yandex.AlbBackendGroup("test-backend-group", http_backends=[yandex.AlbBackendGroupHttpBackendArgs(
    healthcheck=yandex.AlbBackendGroupHttpBackendHealthcheckArgs(
        http_healthcheck=yandex.AlbBackendGroupHttpBackendHealthcheckHttpHealthcheckArgs(
            path="/",
        ),
        interval="1s",
        timeout="1s",
    ),
    http2=True,
    load_balancing_config=yandex.AlbBackendGroupHttpBackendLoadBalancingConfigArgs(
        panic_threshold=50,
    ),
    name="test-http-backend",
    port=8080,
    target_group_ids=[yandex_alb_target_group["test-target-group"]["id"]],
    tls=yandex.AlbBackendGroupHttpBackendTlsArgs(
        sni="backend-domain.internal",
    ),
    weight=1,
)])
import * as pulumi from "@pulumi/pulumi";
import * as yandex from "@pulumi/yandex";

const test_backend_group = new yandex.AlbBackendGroup("test-backend-group", {
    httpBackends: [{
        healthcheck: {
            httpHealthcheck: {
                path: "/",
            },
            interval: "1s",
            timeout: "1s",
        },
        http2: true,
        loadBalancingConfig: {
            panicThreshold: 50,
        },
        name: "test-http-backend",
        port: 8080,
        targetGroupIds: [yandex_alb_target_group_test_target_group.id],
        tls: {
            sni: "backend-domain.internal",
        },
        weight: 1,
    }],
});

Create a AlbBackendGroup Resource

new AlbBackendGroup(name: string, args?: AlbBackendGroupArgs, opts?: CustomResourceOptions);
@overload
def AlbBackendGroup(resource_name: str,
                    opts: Optional[ResourceOptions] = None,
                    description: Optional[str] = None,
                    folder_id: Optional[str] = None,
                    grpc_backends: Optional[Sequence[AlbBackendGroupGrpcBackendArgs]] = None,
                    http_backends: Optional[Sequence[AlbBackendGroupHttpBackendArgs]] = None,
                    labels: Optional[Mapping[str, str]] = None,
                    name: Optional[str] = None)
@overload
def AlbBackendGroup(resource_name: str,
                    args: Optional[AlbBackendGroupArgs] = None,
                    opts: Optional[ResourceOptions] = None)
func NewAlbBackendGroup(ctx *Context, name string, args *AlbBackendGroupArgs, opts ...ResourceOption) (*AlbBackendGroup, error)
public AlbBackendGroup(string name, AlbBackendGroupArgs? args = null, CustomResourceOptions? opts = null)
name string
The unique name of the resource.
args AlbBackendGroupArgs
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 AlbBackendGroupArgs
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 AlbBackendGroupArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name string
The unique name of the resource.
args AlbBackendGroupArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.

AlbBackendGroup 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 AlbBackendGroup resource accepts the following input properties:

Description string
Description of the backend group.
FolderId string
Folder that the resource belongs to. If value is omitted, the default provider folder is used.
GrpcBackends List<AlbBackendGroupGrpcBackendArgs>
Grpc backend specification that will be used by the ALB Backend Group. Structure is documented below.
HttpBackends List<AlbBackendGroupHttpBackendArgs>
Http backend specification that will be used by the ALB Backend Group. Structure is documented below.
Labels Dictionary<string, string>
Labels to assign to this backend group.
Name string
Name of the backend.
Description string
Description of the backend group.
FolderId string
Folder that the resource belongs to. If value is omitted, the default provider folder is used.
GrpcBackends []AlbBackendGroupGrpcBackendArgs
Grpc backend specification that will be used by the ALB Backend Group. Structure is documented below.
HttpBackends []AlbBackendGroupHttpBackendArgs
Http backend specification that will be used by the ALB Backend Group. Structure is documented below.
Labels map[string]string
Labels to assign to this backend group.
Name string
Name of the backend.
description string
Description of the backend group.
folderId string
Folder that the resource belongs to. If value is omitted, the default provider folder is used.
grpcBackends AlbBackendGroupGrpcBackendArgs[]
Grpc backend specification that will be used by the ALB Backend Group. Structure is documented below.
httpBackends AlbBackendGroupHttpBackendArgs[]
Http backend specification that will be used by the ALB Backend Group. Structure is documented below.
labels {[key: string]: string}
Labels to assign to this backend group.
name string
Name of the backend.
description str
Description of the backend group.
folder_id str
Folder that the resource belongs to. If value is omitted, the default provider folder is used.
grpc_backends Sequence[AlbBackendGroupGrpcBackendArgs]
Grpc backend specification that will be used by the ALB Backend Group. Structure is documented below.
http_backends Sequence[AlbBackendGroupHttpBackendArgs]
Http backend specification that will be used by the ALB Backend Group. Structure is documented below.
labels Mapping[str, str]
Labels to assign to this backend group.
name str
Name of the backend.

Outputs

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

CreatedAt string
The backend group creation timestamp.
Id string
The provider-assigned unique ID for this managed resource.
CreatedAt string
The backend group creation timestamp.
Id string
The provider-assigned unique ID for this managed resource.
createdAt string
The backend group creation timestamp.
id string
The provider-assigned unique ID for this managed resource.
created_at str
The backend group creation timestamp.
id str
The provider-assigned unique ID for this managed resource.

Look up an Existing AlbBackendGroup Resource

Get an existing AlbBackendGroup resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: AlbBackendGroupState, opts?: CustomResourceOptions): AlbBackendGroup
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        created_at: Optional[str] = None,
        description: Optional[str] = None,
        folder_id: Optional[str] = None,
        grpc_backends: Optional[Sequence[AlbBackendGroupGrpcBackendArgs]] = None,
        http_backends: Optional[Sequence[AlbBackendGroupHttpBackendArgs]] = None,
        labels: Optional[Mapping[str, str]] = None,
        name: Optional[str] = None) -> AlbBackendGroup
func GetAlbBackendGroup(ctx *Context, name string, id IDInput, state *AlbBackendGroupState, opts ...ResourceOption) (*AlbBackendGroup, error)
public static AlbBackendGroup Get(string name, Input<string> id, AlbBackendGroupState? state, CustomResourceOptions? opts = null)
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
resource_name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name
The unique name of the resulting resource.
id
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.

The following state arguments are supported:

CreatedAt string
The backend group creation timestamp.
Description string
Description of the backend group.
FolderId string
Folder that the resource belongs to. If value is omitted, the default provider folder is used.
GrpcBackends List<AlbBackendGroupGrpcBackendArgs>
Grpc backend specification that will be used by the ALB Backend Group. Structure is documented below.
HttpBackends List<AlbBackendGroupHttpBackendArgs>
Http backend specification that will be used by the ALB Backend Group. Structure is documented below.
Labels Dictionary<string, string>
Labels to assign to this backend group.
Name string
Name of the backend.
CreatedAt string
The backend group creation timestamp.
Description string
Description of the backend group.
FolderId string
Folder that the resource belongs to. If value is omitted, the default provider folder is used.
GrpcBackends []AlbBackendGroupGrpcBackendArgs
Grpc backend specification that will be used by the ALB Backend Group. Structure is documented below.
HttpBackends []AlbBackendGroupHttpBackendArgs
Http backend specification that will be used by the ALB Backend Group. Structure is documented below.
Labels map[string]string
Labels to assign to this backend group.
Name string
Name of the backend.
createdAt string
The backend group creation timestamp.
description string
Description of the backend group.
folderId string
Folder that the resource belongs to. If value is omitted, the default provider folder is used.
grpcBackends AlbBackendGroupGrpcBackendArgs[]
Grpc backend specification that will be used by the ALB Backend Group. Structure is documented below.
httpBackends AlbBackendGroupHttpBackendArgs[]
Http backend specification that will be used by the ALB Backend Group. Structure is documented below.
labels {[key: string]: string}
Labels to assign to this backend group.
name string
Name of the backend.
created_at str
The backend group creation timestamp.
description str
Description of the backend group.
folder_id str
Folder that the resource belongs to. If value is omitted, the default provider folder is used.
grpc_backends Sequence[AlbBackendGroupGrpcBackendArgs]
Grpc backend specification that will be used by the ALB Backend Group. Structure is documented below.
http_backends Sequence[AlbBackendGroupHttpBackendArgs]
Http backend specification that will be used by the ALB Backend Group. Structure is documented below.
labels Mapping[str, str]
Labels to assign to this backend group.
name str
Name of the backend.

Supporting Types

AlbBackendGroupGrpcBackend

Name string
Name of the backend.
TargetGroupIds List<string>
References target groups for the backend.
Healthcheck AlbBackendGroupGrpcBackendHealthcheck
Healthcheck specification that will be used by this backend. Structure is documented below.
LoadBalancingConfig AlbBackendGroupGrpcBackendLoadBalancingConfig
Load Balancing Config specification that will be used by this backend. Structure is documented below.
Port int
Port for incoming traffic.
Tls AlbBackendGroupGrpcBackendTls
Tls specification that will be used by this backend. Structure is documented below.
Weight int
Weight of the backend. Traffic will be split between backends of the same BackendGroup according to their weights.
Name string
Name of the backend.
TargetGroupIds []string
References target groups for the backend.
Healthcheck AlbBackendGroupGrpcBackendHealthcheck
Healthcheck specification that will be used by this backend. Structure is documented below.
LoadBalancingConfig AlbBackendGroupGrpcBackendLoadBalancingConfig
Load Balancing Config specification that will be used by this backend. Structure is documented below.
Port int
Port for incoming traffic.
Tls AlbBackendGroupGrpcBackendTls
Tls specification that will be used by this backend. Structure is documented below.
Weight int
Weight of the backend. Traffic will be split between backends of the same BackendGroup according to their weights.
name string
Name of the backend.
targetGroupIds string[]
References target groups for the backend.
healthcheck AlbBackendGroupGrpcBackendHealthcheck
Healthcheck specification that will be used by this backend. Structure is documented below.
loadBalancingConfig AlbBackendGroupGrpcBackendLoadBalancingConfig
Load Balancing Config specification that will be used by this backend. Structure is documented below.
port number
Port for incoming traffic.
tls AlbBackendGroupGrpcBackendTls
Tls specification that will be used by this backend. Structure is documented below.
weight number
Weight of the backend. Traffic will be split between backends of the same BackendGroup according to their weights.
name str
Name of the backend.
target_group_ids Sequence[str]
References target groups for the backend.
healthcheck AlbBackendGroupGrpcBackendHealthcheck
Healthcheck specification that will be used by this backend. Structure is documented below.
load_balancing_config AlbBackendGroupGrpcBackendLoadBalancingConfig
Load Balancing Config specification that will be used by this backend. Structure is documented below.
port int
Port for incoming traffic.
tls AlbBackendGroupGrpcBackendTls
Tls specification that will be used by this backend. Structure is documented below.
weight int
Weight of the backend. Traffic will be split between backends of the same BackendGroup according to their weights.

AlbBackendGroupGrpcBackendHealthcheck

Interval string
Interval between health checks.
Timeout string
Time to wait for a health check response.
GrpcHealthcheck AlbBackendGroupGrpcBackendHealthcheckGrpcHealthcheck
Grpc Healthcheck specification that will be used by this healthcheck. Structure is documented below.
HealthcheckPort int
Optional alternative port for health checking.
HealthyThreshold int
Number of consecutive successful health checks required to promote endpoint into the healthy state. 0 means 1. Note that during startup, only a single successful health check is required to mark a host healthy.
HttpHealthcheck AlbBackendGroupGrpcBackendHealthcheckHttpHealthcheck
Http Healthcheck specification that will be used by this healthcheck. Structure is documented below.
IntervalJitterPercent double
An optional jitter amount as a percentage of interval. If specified, during every interval value of (interval_ms * interval_jitter_percent / 100) will be added to the wait time.
StreamHealthcheck AlbBackendGroupGrpcBackendHealthcheckStreamHealthcheck
Stream Healthcheck specification that will be used by this healthcheck. Structure is documented below.
UnhealthyThreshold int
Number of consecutive failed health checks required to demote endpoint into the unhealthy state. 0 means 1. Note that for HTTP health checks, a single 503 immediately makes endpoint unhealthy.
Interval string
Interval between health checks.
Timeout string
Time to wait for a health check response.
GrpcHealthcheck AlbBackendGroupGrpcBackendHealthcheckGrpcHealthcheck
Grpc Healthcheck specification that will be used by this healthcheck. Structure is documented below.
HealthcheckPort int
Optional alternative port for health checking.
HealthyThreshold int
Number of consecutive successful health checks required to promote endpoint into the healthy state. 0 means 1. Note that during startup, only a single successful health check is required to mark a host healthy.
HttpHealthcheck AlbBackendGroupGrpcBackendHealthcheckHttpHealthcheck
Http Healthcheck specification that will be used by this healthcheck. Structure is documented below.
IntervalJitterPercent float64
An optional jitter amount as a percentage of interval. If specified, during every interval value of (interval_ms * interval_jitter_percent / 100) will be added to the wait time.
StreamHealthcheck AlbBackendGroupGrpcBackendHealthcheckStreamHealthcheck
Stream Healthcheck specification that will be used by this healthcheck. Structure is documented below.
UnhealthyThreshold int
Number of consecutive failed health checks required to demote endpoint into the unhealthy state. 0 means 1. Note that for HTTP health checks, a single 503 immediately makes endpoint unhealthy.
interval string
Interval between health checks.
timeout string
Time to wait for a health check response.
grpcHealthcheck AlbBackendGroupGrpcBackendHealthcheckGrpcHealthcheck
Grpc Healthcheck specification that will be used by this healthcheck. Structure is documented below.
healthcheckPort number
Optional alternative port for health checking.
healthyThreshold number
Number of consecutive successful health checks required to promote endpoint into the healthy state. 0 means 1. Note that during startup, only a single successful health check is required to mark a host healthy.
httpHealthcheck AlbBackendGroupGrpcBackendHealthcheckHttpHealthcheck
Http Healthcheck specification that will be used by this healthcheck. Structure is documented below.
intervalJitterPercent number
An optional jitter amount as a percentage of interval. If specified, during every interval value of (interval_ms * interval_jitter_percent / 100) will be added to the wait time.
streamHealthcheck AlbBackendGroupGrpcBackendHealthcheckStreamHealthcheck
Stream Healthcheck specification that will be used by this healthcheck. Structure is documented below.
unhealthyThreshold number
Number of consecutive failed health checks required to demote endpoint into the unhealthy state. 0 means 1. Note that for HTTP health checks, a single 503 immediately makes endpoint unhealthy.
interval str
Interval between health checks.
timeout str
Time to wait for a health check response.
grpc_healthcheck AlbBackendGroupGrpcBackendHealthcheckGrpcHealthcheck
Grpc Healthcheck specification that will be used by this healthcheck. Structure is documented below.
healthcheck_port int
Optional alternative port for health checking.
healthy_threshold int
Number of consecutive successful health checks required to promote endpoint into the healthy state. 0 means 1. Note that during startup, only a single successful health check is required to mark a host healthy.
http_healthcheck AlbBackendGroupGrpcBackendHealthcheckHttpHealthcheck
Http Healthcheck specification that will be used by this healthcheck. Structure is documented below.
interval_jitter_percent float
An optional jitter amount as a percentage of interval. If specified, during every interval value of (interval_ms * interval_jitter_percent / 100) will be added to the wait time.
stream_healthcheck AlbBackendGroupGrpcBackendHealthcheckStreamHealthcheck
Stream Healthcheck specification that will be used by this healthcheck. Structure is documented below.
unhealthy_threshold int
Number of consecutive failed health checks required to demote endpoint into the unhealthy state. 0 means 1. Note that for HTTP health checks, a single 503 immediately makes endpoint unhealthy.

AlbBackendGroupGrpcBackendHealthcheckGrpcHealthcheck

ServiceName string
Service name for grpc.health.v1.HealthCheckRequest message.
ServiceName string
Service name for grpc.health.v1.HealthCheckRequest message.
serviceName string
Service name for grpc.health.v1.HealthCheckRequest message.
service_name str
Service name for grpc.health.v1.HealthCheckRequest message.

AlbBackendGroupGrpcBackendHealthcheckHttpHealthcheck

Path string
HTTP path.
Host string
“Host” HTTP header value.
Http2 bool
If set, health checks will use HTTP2.
Path string
HTTP path.
Host string
“Host” HTTP header value.
Http2 bool
If set, health checks will use HTTP2.
path string
HTTP path.
host string
“Host” HTTP header value.
http2 boolean
If set, health checks will use HTTP2.
path str
HTTP path.
host str
“Host” HTTP header value.
http2 bool
If set, health checks will use HTTP2.

AlbBackendGroupGrpcBackendHealthcheckStreamHealthcheck

Receive string
Text to search in reply.
Send string
Message to send. If empty, it’s a connect-only health check.
Receive string
Text to search in reply.
Send string
Message to send. If empty, it’s a connect-only health check.
receive string
Text to search in reply.
send string
Message to send. If empty, it’s a connect-only health check.
receive str
Text to search in reply.
send str
Message to send. If empty, it’s a connect-only health check.

AlbBackendGroupGrpcBackendLoadBalancingConfig

LocalityAwareRoutingPercent int
Percent of traffic to be sent to the same availability zone. The rest will be equally divided between other zones.
PanicThreshold int
If percentage of healthy hosts in the backend is lower than panic_threshold, traffic will be routed to all backends no matter what the health status is. This helps to avoid healthy backends overloading when everything is bad. Zero means no panic threshold.
StrictLocality bool
If set, will route requests only to the same availability zone. Balancer won’t know about endpoints in other zones.
LocalityAwareRoutingPercent int
Percent of traffic to be sent to the same availability zone. The rest will be equally divided between other zones.
PanicThreshold int
If percentage of healthy hosts in the backend is lower than panic_threshold, traffic will be routed to all backends no matter what the health status is. This helps to avoid healthy backends overloading when everything is bad. Zero means no panic threshold.
StrictLocality bool
If set, will route requests only to the same availability zone. Balancer won’t know about endpoints in other zones.
localityAwareRoutingPercent number
Percent of traffic to be sent to the same availability zone. The rest will be equally divided between other zones.
panicThreshold number
If percentage of healthy hosts in the backend is lower than panic_threshold, traffic will be routed to all backends no matter what the health status is. This helps to avoid healthy backends overloading when everything is bad. Zero means no panic threshold.
strictLocality boolean
If set, will route requests only to the same availability zone. Balancer won’t know about endpoints in other zones.
locality_aware_routing_percent int
Percent of traffic to be sent to the same availability zone. The rest will be equally divided between other zones.
panic_threshold int
If percentage of healthy hosts in the backend is lower than panic_threshold, traffic will be routed to all backends no matter what the health status is. This helps to avoid healthy backends overloading when everything is bad. Zero means no panic threshold.
strict_locality bool
If set, will route requests only to the same availability zone. Balancer won’t know about endpoints in other zones.

AlbBackendGroupGrpcBackendTls

Sni string

SNI string for TLS connections.

  • validation_context.0.trusted_ca_id - (Optional) Trusted CA certificate ID in the Certificate Manager.
  • validation_context.0.trusted_ca_bytes - (Optional) PEM-encoded trusted CA certificate chain.
ValidationContext AlbBackendGroupGrpcBackendTlsValidationContext
Sni string

SNI string for TLS connections.

  • validation_context.0.trusted_ca_id - (Optional) Trusted CA certificate ID in the Certificate Manager.
  • validation_context.0.trusted_ca_bytes - (Optional) PEM-encoded trusted CA certificate chain.
ValidationContext AlbBackendGroupGrpcBackendTlsValidationContext
sni string

SNI string for TLS connections.

  • validation_context.0.trusted_ca_id - (Optional) Trusted CA certificate ID in the Certificate Manager.
  • validation_context.0.trusted_ca_bytes - (Optional) PEM-encoded trusted CA certificate chain.
validationContext AlbBackendGroupGrpcBackendTlsValidationContext
sni str

SNI string for TLS connections.

  • validation_context.0.trusted_ca_id - (Optional) Trusted CA certificate ID in the Certificate Manager.
  • validation_context.0.trusted_ca_bytes - (Optional) PEM-encoded trusted CA certificate chain.
validation_context AlbBackendGroupGrpcBackendTlsValidationContext

AlbBackendGroupGrpcBackendTlsValidationContext

AlbBackendGroupHttpBackend

Name string
Name of the backend.
TargetGroupIds List<string>
References target groups for the backend.
Healthcheck AlbBackendGroupHttpBackendHealthcheck
Healthcheck specification that will be used by this backend. Structure is documented below.
Http2 bool
If set, health checks will use HTTP2.
LoadBalancingConfig AlbBackendGroupHttpBackendLoadBalancingConfig
Load Balancing Config specification that will be used by this backend. Structure is documented below.
Port int
Port for incoming traffic.
Tls AlbBackendGroupHttpBackendTls
Tls specification that will be used by this backend. Structure is documented below.
Weight int
Weight of the backend. Traffic will be split between backends of the same BackendGroup according to their weights.
Name string
Name of the backend.
TargetGroupIds []string
References target groups for the backend.
Healthcheck AlbBackendGroupHttpBackendHealthcheck
Healthcheck specification that will be used by this backend. Structure is documented below.
Http2 bool
If set, health checks will use HTTP2.
LoadBalancingConfig AlbBackendGroupHttpBackendLoadBalancingConfig
Load Balancing Config specification that will be used by this backend. Structure is documented below.
Port int
Port for incoming traffic.
Tls AlbBackendGroupHttpBackendTls
Tls specification that will be used by this backend. Structure is documented below.
Weight int
Weight of the backend. Traffic will be split between backends of the same BackendGroup according to their weights.
name string
Name of the backend.
targetGroupIds string[]
References target groups for the backend.
healthcheck AlbBackendGroupHttpBackendHealthcheck
Healthcheck specification that will be used by this backend. Structure is documented below.
http2 boolean
If set, health checks will use HTTP2.
loadBalancingConfig AlbBackendGroupHttpBackendLoadBalancingConfig
Load Balancing Config specification that will be used by this backend. Structure is documented below.
port number
Port for incoming traffic.
tls AlbBackendGroupHttpBackendTls
Tls specification that will be used by this backend. Structure is documented below.
weight number
Weight of the backend. Traffic will be split between backends of the same BackendGroup according to their weights.
name str
Name of the backend.
target_group_ids Sequence[str]
References target groups for the backend.
healthcheck AlbBackendGroupHttpBackendHealthcheck
Healthcheck specification that will be used by this backend. Structure is documented below.
http2 bool
If set, health checks will use HTTP2.
load_balancing_config AlbBackendGroupHttpBackendLoadBalancingConfig
Load Balancing Config specification that will be used by this backend. Structure is documented below.
port int
Port for incoming traffic.
tls AlbBackendGroupHttpBackendTls
Tls specification that will be used by this backend. Structure is documented below.
weight int
Weight of the backend. Traffic will be split between backends of the same BackendGroup according to their weights.

AlbBackendGroupHttpBackendHealthcheck

Interval string
Interval between health checks.
Timeout string
Time to wait for a health check response.
GrpcHealthcheck AlbBackendGroupHttpBackendHealthcheckGrpcHealthcheck
Grpc Healthcheck specification that will be used by this healthcheck. Structure is documented below.
HealthcheckPort int
Optional alternative port for health checking.
HealthyThreshold int
Number of consecutive successful health checks required to promote endpoint into the healthy state. 0 means 1. Note that during startup, only a single successful health check is required to mark a host healthy.
HttpHealthcheck AlbBackendGroupHttpBackendHealthcheckHttpHealthcheck
Http Healthcheck specification that will be used by this healthcheck. Structure is documented below.
IntervalJitterPercent double
An optional jitter amount as a percentage of interval. If specified, during every interval value of (interval_ms * interval_jitter_percent / 100) will be added to the wait time.
StreamHealthcheck AlbBackendGroupHttpBackendHealthcheckStreamHealthcheck
Stream Healthcheck specification that will be used by this healthcheck. Structure is documented below.
UnhealthyThreshold int
Number of consecutive failed health checks required to demote endpoint into the unhealthy state. 0 means 1. Note that for HTTP health checks, a single 503 immediately makes endpoint unhealthy.
Interval string
Interval between health checks.
Timeout string
Time to wait for a health check response.
GrpcHealthcheck AlbBackendGroupHttpBackendHealthcheckGrpcHealthcheck
Grpc Healthcheck specification that will be used by this healthcheck. Structure is documented below.
HealthcheckPort int
Optional alternative port for health checking.
HealthyThreshold int
Number of consecutive successful health checks required to promote endpoint into the healthy state. 0 means 1. Note that during startup, only a single successful health check is required to mark a host healthy.
HttpHealthcheck AlbBackendGroupHttpBackendHealthcheckHttpHealthcheck
Http Healthcheck specification that will be used by this healthcheck. Structure is documented below.
IntervalJitterPercent float64
An optional jitter amount as a percentage of interval. If specified, during every interval value of (interval_ms * interval_jitter_percent / 100) will be added to the wait time.
StreamHealthcheck AlbBackendGroupHttpBackendHealthcheckStreamHealthcheck
Stream Healthcheck specification that will be used by this healthcheck. Structure is documented below.
UnhealthyThreshold int
Number of consecutive failed health checks required to demote endpoint into the unhealthy state. 0 means 1. Note that for HTTP health checks, a single 503 immediately makes endpoint unhealthy.
interval string
Interval between health checks.
timeout string
Time to wait for a health check response.
grpcHealthcheck AlbBackendGroupHttpBackendHealthcheckGrpcHealthcheck
Grpc Healthcheck specification that will be used by this healthcheck. Structure is documented below.
healthcheckPort number
Optional alternative port for health checking.
healthyThreshold number
Number of consecutive successful health checks required to promote endpoint into the healthy state. 0 means 1. Note that during startup, only a single successful health check is required to mark a host healthy.
httpHealthcheck AlbBackendGroupHttpBackendHealthcheckHttpHealthcheck
Http Healthcheck specification that will be used by this healthcheck. Structure is documented below.
intervalJitterPercent number
An optional jitter amount as a percentage of interval. If specified, during every interval value of (interval_ms * interval_jitter_percent / 100) will be added to the wait time.
streamHealthcheck AlbBackendGroupHttpBackendHealthcheckStreamHealthcheck
Stream Healthcheck specification that will be used by this healthcheck. Structure is documented below.
unhealthyThreshold number
Number of consecutive failed health checks required to demote endpoint into the unhealthy state. 0 means 1. Note that for HTTP health checks, a single 503 immediately makes endpoint unhealthy.
interval str
Interval between health checks.
timeout str
Time to wait for a health check response.
grpc_healthcheck AlbBackendGroupHttpBackendHealthcheckGrpcHealthcheck
Grpc Healthcheck specification that will be used by this healthcheck. Structure is documented below.
healthcheck_port int
Optional alternative port for health checking.
healthy_threshold int
Number of consecutive successful health checks required to promote endpoint into the healthy state. 0 means 1. Note that during startup, only a single successful health check is required to mark a host healthy.
http_healthcheck AlbBackendGroupHttpBackendHealthcheckHttpHealthcheck
Http Healthcheck specification that will be used by this healthcheck. Structure is documented below.
interval_jitter_percent float
An optional jitter amount as a percentage of interval. If specified, during every interval value of (interval_ms * interval_jitter_percent / 100) will be added to the wait time.
stream_healthcheck AlbBackendGroupHttpBackendHealthcheckStreamHealthcheck
Stream Healthcheck specification that will be used by this healthcheck. Structure is documented below.
unhealthy_threshold int
Number of consecutive failed health checks required to demote endpoint into the unhealthy state. 0 means 1. Note that for HTTP health checks, a single 503 immediately makes endpoint unhealthy.

AlbBackendGroupHttpBackendHealthcheckGrpcHealthcheck

ServiceName string
Service name for grpc.health.v1.HealthCheckRequest message.
ServiceName string
Service name for grpc.health.v1.HealthCheckRequest message.
serviceName string
Service name for grpc.health.v1.HealthCheckRequest message.
service_name str
Service name for grpc.health.v1.HealthCheckRequest message.

AlbBackendGroupHttpBackendHealthcheckHttpHealthcheck

Path string
HTTP path.
Host string
“Host” HTTP header value.
Http2 bool
If set, health checks will use HTTP2.
Path string
HTTP path.
Host string
“Host” HTTP header value.
Http2 bool
If set, health checks will use HTTP2.
path string
HTTP path.
host string
“Host” HTTP header value.
http2 boolean
If set, health checks will use HTTP2.
path str
HTTP path.
host str
“Host” HTTP header value.
http2 bool
If set, health checks will use HTTP2.

AlbBackendGroupHttpBackendHealthcheckStreamHealthcheck

Receive string
Text to search in reply.
Send string
Message to send. If empty, it’s a connect-only health check.
Receive string
Text to search in reply.
Send string
Message to send. If empty, it’s a connect-only health check.
receive string
Text to search in reply.
send string
Message to send. If empty, it’s a connect-only health check.
receive str
Text to search in reply.
send str
Message to send. If empty, it’s a connect-only health check.

AlbBackendGroupHttpBackendLoadBalancingConfig

LocalityAwareRoutingPercent int
Percent of traffic to be sent to the same availability zone. The rest will be equally divided between other zones.
PanicThreshold int
If percentage of healthy hosts in the backend is lower than panic_threshold, traffic will be routed to all backends no matter what the health status is. This helps to avoid healthy backends overloading when everything is bad. Zero means no panic threshold.
StrictLocality bool
If set, will route requests only to the same availability zone. Balancer won’t know about endpoints in other zones.
LocalityAwareRoutingPercent int
Percent of traffic to be sent to the same availability zone. The rest will be equally divided between other zones.
PanicThreshold int
If percentage of healthy hosts in the backend is lower than panic_threshold, traffic will be routed to all backends no matter what the health status is. This helps to avoid healthy backends overloading when everything is bad. Zero means no panic threshold.
StrictLocality bool
If set, will route requests only to the same availability zone. Balancer won’t know about endpoints in other zones.
localityAwareRoutingPercent number
Percent of traffic to be sent to the same availability zone. The rest will be equally divided between other zones.
panicThreshold number
If percentage of healthy hosts in the backend is lower than panic_threshold, traffic will be routed to all backends no matter what the health status is. This helps to avoid healthy backends overloading when everything is bad. Zero means no panic threshold.
strictLocality boolean
If set, will route requests only to the same availability zone. Balancer won’t know about endpoints in other zones.
locality_aware_routing_percent int
Percent of traffic to be sent to the same availability zone. The rest will be equally divided between other zones.
panic_threshold int
If percentage of healthy hosts in the backend is lower than panic_threshold, traffic will be routed to all backends no matter what the health status is. This helps to avoid healthy backends overloading when everything is bad. Zero means no panic threshold.
strict_locality bool
If set, will route requests only to the same availability zone. Balancer won’t know about endpoints in other zones.

AlbBackendGroupHttpBackendTls

Sni string

SNI string for TLS connections.

  • validation_context.0.trusted_ca_id - (Optional) Trusted CA certificate ID in the Certificate Manager.
  • validation_context.0.trusted_ca_bytes - (Optional) PEM-encoded trusted CA certificate chain.
ValidationContext AlbBackendGroupHttpBackendTlsValidationContext
Sni string

SNI string for TLS connections.

  • validation_context.0.trusted_ca_id - (Optional) Trusted CA certificate ID in the Certificate Manager.
  • validation_context.0.trusted_ca_bytes - (Optional) PEM-encoded trusted CA certificate chain.
ValidationContext AlbBackendGroupHttpBackendTlsValidationContext
sni string

SNI string for TLS connections.

  • validation_context.0.trusted_ca_id - (Optional) Trusted CA certificate ID in the Certificate Manager.
  • validation_context.0.trusted_ca_bytes - (Optional) PEM-encoded trusted CA certificate chain.
validationContext AlbBackendGroupHttpBackendTlsValidationContext
sni str

SNI string for TLS connections.

  • validation_context.0.trusted_ca_id - (Optional) Trusted CA certificate ID in the Certificate Manager.
  • validation_context.0.trusted_ca_bytes - (Optional) PEM-encoded trusted CA certificate chain.
validation_context AlbBackendGroupHttpBackendTlsValidationContext

AlbBackendGroupHttpBackendTlsValidationContext

Import

A backend group can be imported using the id of the resource, e.g.

 $ pulumi import yandex:index/albBackendGroup:AlbBackendGroup default backend_group_id

Package Details

Repository
https://github.com/pulumi/pulumi-yandex
License
Apache-2.0
Notes
This Pulumi package is based on the yandex Terraform Provider.