Added support for the plan_id field used to create or change a load balancer's plan to a higher one (e.g. p250, p750, ...).

Christian Hamm · Christian Hamm · commit 2d8a29821cac · 2025-05-21T16:40:47.000+02:00
diff --git a/docs/data-sources/loadbalancer.md b/docs/data-sources/loadbalancer.md
@@ -38,6 +38,7 @@ data "stackit_loadbalancer" "example" {
 - `listeners` (Attributes List) List of all listeners which will accept traffic. Limited to 20. (see [below for nested schema](#nestedatt--listeners))
 - `networks` (Attributes List) List of networks that listeners and targets reside in. (see [below for nested schema](#nestedatt--networks))
 - `options` (Attributes) Defines any optional functionality you want to have enabled on your load balancer. (see [below for nested schema](#nestedatt--options))
+- `plan_id` (String) The service plan ID. Defaults to p10. See the API docs for a list of available plans at: https://docs.api.stackit.cloud/documentation/load-balancer/version/v1#tag/APIService/operation/APIService_ListPlans
 - `private_address` (String) Transient private Load Balancer IP address. It can change any time.
 - `target_pools` (Attributes List) List of all target pools which will be used in the Load Balancer. Limited to 20. (see [below for nested schema](#nestedatt--target_pools))
 
diff --git a/docs/resources/loadbalancer.md b/docs/resources/loadbalancer.md
@@ -74,6 +74,7 @@ resource "stackit_server_network_interface_attach" "nic-attachment" {
 resource "stackit_loadbalancer" "example" {
   project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
   name       = "example-load-balancer"
+  plan_id    = "p10"
   target_pools = [
     {
       name        = "example-target-pool"
@@ -129,6 +130,7 @@ resource "stackit_loadbalancer" "example" {
 ### Optional
 
 - `options` (Attributes) Defines any optional functionality you want to have enabled on your load balancer. (see [below for nested schema](#nestedatt--options))
+- `plan_id` (String) The service plan ID. Defaults to p10. See the API docs for a list of available plans at: https://docs.api.stackit.cloud/documentation/load-balancer/version/v1#tag/APIService/operation/APIService_ListPlans
 - `region` (String) The resource region. If not defined, the provider region is used.
 
 ### Read-Only
diff --git a/examples/resources/stackit_loadbalancer/resource.tf b/examples/resources/stackit_loadbalancer/resource.tf
@@ -55,6 +55,7 @@ resource "stackit_server_network_interface_attach" "nic-attachment" {
 resource "stackit_loadbalancer" "example" {
   project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
   name       = "example-load-balancer"
+  plan_id    = "p10"
   target_pools = [
     {
       name        = "example-target-pool"
diff --git a/stackit/internal/services/loadbalancer/loadbalancer/datasource.go b/stackit/internal/services/loadbalancer/loadbalancer/datasource.go
@@ -72,6 +72,7 @@ func (r *loadBalancerDataSource) Schema(_ context.Context, _ datasource.SchemaRe
 		"protocol":                              "Protocol is the highest network protocol we understand to load balance.",
 		"target_pool":                           "Reference target pool by target pool name.",
 		"name":                                  "Load balancer name.",
+		"plan_id":                               "The service plan ID. Defaults to p10. See the API docs for a list of available plans at: https://docs.api.stackit.cloud/documentation/load-balancer/version/v1#tag/APIService/operation/APIService_ListPlans",
 		"networks":                              "List of networks that listeners and targets reside in.",
 		"network_id":                            "Openstack network ID.",
 		"role":                                  "The role defines how the load balancer is using the network.",
@@ -122,6 +123,10 @@ func (r *loadBalancerDataSource) Schema(_ context.Context, _ datasource.SchemaRe
 				Description: descriptions["external_address"],
 				Computed:    true,
 			},
+			"plan_id": schema.StringAttribute{
+				Description: descriptions["plan_id"],
+				Computed:    true,
+			},
 			"listeners": schema.ListNestedAttribute{
 				Description: descriptions["listeners"],
 				Computed:    true,
diff --git a/stackit/internal/services/loadbalancer/loadbalancer/resource.go b/stackit/internal/services/loadbalancer/loadbalancer/resource.go
@@ -52,6 +52,7 @@ type Model struct {
 	ExternalAddress types.String `tfsdk:"external_address"`
 	Listeners       types.List   `tfsdk:"listeners"`
 	Name            types.String `tfsdk:"name"`
+	PlanId          types.String `tfsdk:"plan_id"`
 	Networks        types.List   `tfsdk:"networks"`
 	Options         types.Object `tfsdk:"options"`
 	PrivateAddress  types.String `tfsdk:"private_address"`
@@ -268,6 +269,7 @@ func (r *loadBalancerResource) Schema(_ context.Context, _ resource.SchemaReques
 		"protocol":                              "Protocol is the highest network protocol we understand to load balance. " + utils.SupportedValuesDocumentation(protocolOptions),
 		"target_pool":                           "Reference target pool by target pool name.",
 		"name":                                  "Load balancer name.",
+		"plan_id":                               "The service plan ID. Defaults to p10. See the API docs for a list of available plans at: https://docs.api.stackit.cloud/documentation/load-balancer/version/v1#tag/APIService/operation/APIService_ListPlans",
 		"networks":                              "List of networks that listeners and targets reside in.",
 		"network_id":                            "Openstack network ID.",
 		"role":                                  "The role defines how the load balancer is using the network. " + utils.SupportedValuesDocumentation(roleOptions),
@@ -332,6 +334,14 @@ The example below creates the supporting infrastructure using the STACKIT Terraf
 					stringplanmodifier.RequiresReplace(),
 				},
 			},
+			"plan_id": schema.StringAttribute{
+				Description: descriptions["plan_id"],
+				Optional:    true,
+				Computed:    true,
+				PlanModifiers: []planmodifier.String{
+					stringplanmodifier.RequiresReplace(),
+				},
+			},
 			"listeners": schema.ListNestedAttribute{
 				Description: descriptions["listeners"],
 				Required:    true,
@@ -864,6 +874,7 @@ func toCreatePayload(ctx context.Context, model *Model) (*loadbalancer.CreateLoa
 		ExternalAddress: conversion.StringValueToPointer(model.ExternalAddress),
 		Listeners:       listenersPayload,
 		Name:            conversion.StringValueToPointer(model.Name),
+		PlanId:          conversion.StringValueToPointer(model.PlanId),
 		Networks:        networksPayload,
 		Options:         optionsPayload,
 		TargetPools:     targetPoolsPayload,
@@ -1178,6 +1189,7 @@ func mapFields(ctx context.Context, lb *loadbalancer.LoadBalancer, m *Model, reg
 		strings.Join(idParts, core.Separator),
 	)
 
+	m.PlanId = types.StringPointerValue(lb.PlanId)
 	m.ExternalAddress = types.StringPointerValue(lb.ExternalAddress)
 	m.PrivateAddress = types.StringPointerValue(lb.PrivateAddress)
 
diff --git a/stackit/internal/services/loadbalancer/loadbalancer/resource_test.go b/stackit/internal/services/loadbalancer/loadbalancer/resource_test.go
@@ -179,6 +179,149 @@ func TestToCreatePayload(t *testing.T) {
 			},
 			true,
 		},
+		{
+			"service_plan_ok",
+			&Model{
+				PlanId:          types.StringValue("p10"),
+				ExternalAddress: types.StringValue("external_address"),
+				Listeners: types.ListValueMust(types.ObjectType{AttrTypes: listenerTypes}, []attr.Value{
+					types.ObjectValueMust(listenerTypes, map[string]attr.Value{
+						"display_name": types.StringValue("display_name"),
+						"port":         types.Int64Value(80),
+						"protocol":     types.StringValue(string(loadbalancer.LISTENERPROTOCOL_TCP)),
+						"server_name_indicators": types.ListValueMust(types.ObjectType{AttrTypes: serverNameIndicatorTypes}, []attr.Value{
+							types.ObjectValueMust(
+								serverNameIndicatorTypes,
+								map[string]attr.Value{
+									"name": types.StringValue("domain.com"),
+								},
+							),
+						},
+						),
+						"target_pool": types.StringValue("target_pool"),
+					}),
+				}),
+				Name: types.StringValue("name"),
+				Networks: types.ListValueMust(types.ObjectType{AttrTypes: networkTypes}, []attr.Value{
+					types.ObjectValueMust(networkTypes, map[string]attr.Value{
+						"network_id": types.StringValue("network_id"),
+						"role":       types.StringValue(string(loadbalancer.NETWORKROLE_LISTENERS_AND_TARGETS)),
+					}),
+					types.ObjectValueMust(networkTypes, map[string]attr.Value{
+						"network_id": types.StringValue("network_id_2"),
+						"role":       types.StringValue(string(loadbalancer.NETWORKROLE_LISTENERS_AND_TARGETS)),
+					}),
+				}),
+				Options: types.ObjectValueMust(
+					optionsTypes,
+					map[string]attr.Value{
+						"acl": types.SetValueMust(
+							types.StringType,
+							[]attr.Value{types.StringValue("cidr")}),
+						"private_network_only": types.BoolValue(true),
+						"observability": types.ObjectValueMust(observabilityTypes, map[string]attr.Value{
+							"logs": types.ObjectValueMust(observabilityOptionTypes, map[string]attr.Value{
+								"credentials_ref": types.StringValue("logs-credentials_ref"),
+								"push_url":        types.StringValue("logs-push_url"),
+							}),
+							"metrics": types.ObjectValueMust(observabilityOptionTypes, map[string]attr.Value{
+								"credentials_ref": types.StringValue("metrics-credentials_ref"),
+								"push_url":        types.StringValue("metrics-push_url"),
+							}),
+						}),
+					},
+				),
+				TargetPools: types.ListValueMust(types.ObjectType{AttrTypes: targetPoolTypes}, []attr.Value{
+					types.ObjectValueMust(targetPoolTypes, map[string]attr.Value{
+						"active_health_check": types.ObjectValueMust(activeHealthCheckTypes, map[string]attr.Value{
+							"healthy_threshold":   types.Int64Value(1),
+							"interval":            types.StringValue("2s"),
+							"interval_jitter":     types.StringValue("3s"),
+							"timeout":             types.StringValue("4s"),
+							"unhealthy_threshold": types.Int64Value(5),
+						}),
+						"name":        types.StringValue("name"),
+						"target_port": types.Int64Value(80),
+						"targets": types.ListValueMust(types.ObjectType{AttrTypes: targetTypes}, []attr.Value{
+							types.ObjectValueMust(targetTypes, map[string]attr.Value{
+								"display_name": types.StringValue("display_name"),
+								"ip":           types.StringValue("ip"),
+							}),
+						}),
+						"session_persistence": types.ObjectValueMust(sessionPersistenceTypes, map[string]attr.Value{
+							"use_source_ip_address": types.BoolValue(true),
+						}),
+					}),
+				}),
+			},
+			&loadbalancer.CreateLoadBalancerPayload{
+				PlanId:          utils.Ptr("p10"),
+				ExternalAddress: utils.Ptr("external_address"),
+				Listeners: &[]loadbalancer.Listener{
+					{
+						DisplayName: utils.Ptr("display_name"),
+						Port:        utils.Ptr(int64(80)),
+						Protocol:    loadbalancer.LISTENERPROTOCOL_TCP.Ptr(),
+						ServerNameIndicators: &[]loadbalancer.ServerNameIndicator{
+							{
+								Name: utils.Ptr("domain.com"),
+							},
+						},
+						TargetPool: utils.Ptr("target_pool"),
+					},
+				},
+				Name: utils.Ptr("name"),
+				Networks: &[]loadbalancer.Network{
+					{
+						NetworkId: utils.Ptr("network_id"),
+						Role:      loadbalancer.NETWORKROLE_LISTENERS_AND_TARGETS.Ptr(),
+					},
+					{
+						NetworkId: utils.Ptr("network_id_2"),
+						Role:      loadbalancer.NETWORKROLE_LISTENERS_AND_TARGETS.Ptr(),
+					},
+				},
+				Options: &loadbalancer.LoadBalancerOptions{
+					AccessControl: &loadbalancer.LoadbalancerOptionAccessControl{
+						AllowedSourceRanges: &[]string{"cidr"},
+					},
+					PrivateNetworkOnly: utils.Ptr(true),
+					Observability: &loadbalancer.LoadbalancerOptionObservability{
+						Logs: &loadbalancer.LoadbalancerOptionLogs{
+							CredentialsRef: utils.Ptr("logs-credentials_ref"),
+							PushUrl:        utils.Ptr("logs-push_url"),
+						},
+						Metrics: &loadbalancer.LoadbalancerOptionMetrics{
+							CredentialsRef: utils.Ptr("metrics-credentials_ref"),
+							PushUrl:        utils.Ptr("metrics-push_url"),
+						},
+					},
+				},
+				TargetPools: &[]loadbalancer.TargetPool{
+					{
+						ActiveHealthCheck: &loadbalancer.ActiveHealthCheck{
+							HealthyThreshold:   utils.Ptr(int64(1)),
+							Interval:           utils.Ptr("2s"),
+							IntervalJitter:     utils.Ptr("3s"),
+							Timeout:            utils.Ptr("4s"),
+							UnhealthyThreshold: utils.Ptr(int64(5)),
+						},
+						Name:       utils.Ptr("name"),
+						TargetPort: utils.Ptr(int64(80)),
+						Targets: &[]loadbalancer.Target{
+							{
+								DisplayName: utils.Ptr("display_name"),
+								Ip:          utils.Ptr("ip"),
+							},
+						},
+						SessionPersistence: &loadbalancer.SessionPersistence{
+							UseSourceIpAddress: utils.Ptr(true),
+						},
+					},
+				},
+			},
+			true,
+		},
 		{
 			"nil_model",
 			nil,

Original file line number	Diff line number	Diff line change
`@@ -55,6 +55,7 @@ resource "stackit_server_network_interface_attach" "nic-attachment" {`
`55`	`55`	`resource "stackit_loadbalancer" "example" {`
`56`	`56`	`project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"`
`57`	`57`	`name = "example-load-balancer"`
	`58`	`+ plan_id = "p10"`
`58`	`59`	`target_pools = [`
`59`	`60`	`{`
`60`	`61`	`name = "example-target-pool"`