feat(telemetry link): Onboarding TelemetryLink

docs/data-sources/telemetrylink.md

@@ -0,0 +1,42 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "stackit_telemetrylink Data Source - stackit"
+subcategory: ""
+description: |-
+  TelemetryLink data source schema. Uses the default_region specified in the provider configuration as a fallback in case no region is defined on datasource level.
+---
+
+# stackit_telemetrylink (Data Source)
+
+TelemetryLink data source schema. Uses the `default_region` specified in the provider configuration as a fallback in case no `region` is defined on datasource level.
+
+## Example Usage
+
+```terraform
+data "stackit_telemetrylink" "link" {
+  resource_type = "project"
+  resource_id   = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+  region        = "eu01"
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `resource_id` (String) STACKIT project ID, folder ID, or organization ID associated with the Telemetry Link resource.
+- `resource_type` (String) The resource type of the TelemetryLink resource, possible values: Possible values are: `organization`, `folder`, `project`.
+
+### Optional
+
+- `region` (String) STACKIT region name the resource is located in. If not defined, the provider region is used.
+
+### Read-Only
+
+- `create_time` (String) The time the Telemetry Link was created.
+- `description` (String) The description of the Telemetry Link resource.
+- `display_name` (String) The displayed name of the Telemetry Link resource.
+- `id` (String) Terraform's internal resource identifier. It is structured as "`resource_type`, `resource_id`,`region`".
+- `status` (String) The status of the TelemetryLink, possible values: Possible values are: `active`, `inactive`, `failed`, `reconciling`, `deleting`.
+- `telemetry_router_id` (String) The Telemetry Router ID.

docs/index.md

@@ -210,6 +210,7 @@ Note: AWS specific checks must be skipped as they do not work on STACKIT. For de
 - `sfs_custom_endpoint` (String) Custom endpoint for the Stackit Filestorage API
 - `ske_custom_endpoint` (String) Custom endpoint for the Kubernetes Engine (SKE) service
 - `sqlserverflex_custom_endpoint` (String) Custom endpoint for the SQL Server Flex service
+- `telemetrylink_custom_endpoint` (String) Custom endpoint for the Telemetry Link service
 - `telemetryrouter_custom_endpoint` (String) Custom endpoint for the Telemetry Router service
 - `token_custom_endpoint` (String) Custom endpoint for the token API, which is used to request access tokens when using the key flow
 - `use_oidc` (Boolean) Enables OIDC for Authentication. This can also be sourced from the `STACKIT_USE_OIDC` Environment Variable. Defaults to `false`.

docs/resources/telemetrylink.md

@@ -0,0 +1,62 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "stackit_telemetrylink Resource - stackit"
+subcategory: ""
+description: |-
+  TelemetryLink instance resource schema. Uses the default_region specified in the provider configuration as a fallback in case no region is defined on resource level.
+---
+
+# stackit_telemetrylink (Resource)
+
+TelemetryLink instance resource schema. Uses the `default_region` specified in the provider configuration as a fallback in case no `region` is defined on resource level.
+
+## Example Usage
+
+```terraform
+resource "stackit_telemetrylink" "link" {
+  resource_type       = "project"
+  resource_id         = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+  region              = "eu01"
+  display_name        = "telemetrylink-example"
+  access_token        = "eyJxxx"
+  telemetry_router_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+}
+
+resource "stackit_telemetrylink" "link2" {
+  resource_type       = "project"
+  resource_id         = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+  region              = "eu01"
+  display_name        = "telemetrylink-example"
+  description         = "telemetrylink description"
+  access_token        = "eyJxxx"
+  telemetry_router_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+}
+
+# Only use the import statement, if you want to import an existing TelemetryLink
+import {
+  to = stackit_telemetrylink.import-example
+  id = "${var.resource_type},${var.resource_id},${var.region}"
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `display_name` (String) The displayed name of the Telemetry Link resource.
+- `resource_id` (String) STACKIT project ID, folder ID, or organization ID associated with the Telemetry Link resource.
+- `resource_type` (String) The resource type of the TelemetryLink resource, possible values: Possible values are: `organization`, `folder`, `project`.
+- `telemetry_router_id` (String) The Telemetry Router ID.
+
+### Optional
+
+- `access_token` (String, Sensitive) The access token of the Telemetry Router instance.
+- `description` (String) The description of the Telemetry Link resource.
+- `region` (String) STACKIT region name the resource is located in. If not defined, the provider region is used.
+
+### Read-Only
+
+- `create_time` (String) The time the Telemetry Link was created.
+- `id` (String) Terraform's internal resource identifier. It is structured as "`resource_type`, `resource_id`,`region`".
+- `status` (String) The status of the TelemetryLink, possible values: Possible values are: `active`, `inactive`, `failed`, `reconciling`, `deleting`.

examples/data-sources/stackit_telemetrylink/data-source.tf

@@ -0,0 +1,5 @@
+data "stackit_telemetrylink" "link" {
+  resource_type = "project"
+  resource_id   = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+  region        = "eu01"
+}

examples/resources/stackit_telemetrylink/resource.tf

@@ -0,0 +1,24 @@
+resource "stackit_telemetrylink" "link" {
+  resource_type       = "project"
+  resource_id         = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+  region              = "eu01"
+  display_name        = "telemetrylink-example"
+  access_token        = "eyJxxx"
+  telemetry_router_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+}
+
+resource "stackit_telemetrylink" "link2" {
+  resource_type       = "project"
+  resource_id         = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+  region              = "eu01"
+  display_name        = "telemetrylink-example"
+  description         = "telemetrylink description"
+  access_token        = "eyJxxx"
+  telemetry_router_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+}
+
+# Only use the import statement, if you want to import an existing TelemetryLink
+import {
+  to = stackit_telemetrylink.import-example
+  id = "${var.resource_type},${var.resource_id},${var.region}"
+}

go.mod

@@ -44,6 +44,7 @@ require (
 	github.com/stackitcloud/stackit-sdk-go/services/sfs v0.10.1
 	github.com/stackitcloud/stackit-sdk-go/services/ske v1.15.0
 	github.com/stackitcloud/stackit-sdk-go/services/sqlserverflex v1.11.0
+	github.com/stackitcloud/stackit-sdk-go/services/telemetrylink v0.2.0
 	github.com/stackitcloud/stackit-sdk-go/services/telemetryrouter v0.3.0
 	github.com/teambition/rrule-go v1.8.2
 	golang.org/x/mod v0.36.0

go.sum

@@ -734,6 +734,8 @@ github.com/stackitcloud/stackit-sdk-go/services/ske v1.15.0 h1:sSuwbqAvh89jUUX2R
 github.com/stackitcloud/stackit-sdk-go/services/ske v1.15.0/go.mod h1:TbqmZhLMofmfl+HhVl6oHYcI3zvXTm1vRjN3A/fOkM4=
 github.com/stackitcloud/stackit-sdk-go/services/sqlserverflex v1.11.0 h1:PwjQeupEnXxhu+uWCUzO/hUfL4yqNblOcZbP2jvaQtU=
 github.com/stackitcloud/stackit-sdk-go/services/sqlserverflex v1.11.0/go.mod h1:AiUoMAqQcOlMgDtkVJlqI7P/VGD5xjN3dYjERGnwN/M=
+github.com/stackitcloud/stackit-sdk-go/services/telemetrylink v0.2.0 h1:U1mQoCk0TXc8NsSc/Sl9PKMdEyJpWNU2zLnsqmx6wEc=
+github.com/stackitcloud/stackit-sdk-go/services/telemetrylink v0.2.0/go.mod h1:hgw8janWmDfP2bnuZensxqcAePr49BX5ug8Rq85o+h8=
 github.com/stackitcloud/stackit-sdk-go/services/telemetryrouter v0.3.0 h1:MEvzGItcbig+9A4JvK2E5W6/mqXDPafiGkDZ1BprBAI=
 github.com/stackitcloud/stackit-sdk-go/services/telemetryrouter v0.3.0/go.mod h1:WUmgKtwpe90Yq3YbgNxc2clTTULVxCu0ha6lMTjUnII=
 github.com/stbenjam/no-sprintf-host-port v0.3.1 h1:AyX7+dxI4IdLBPtDbsGAyqiTSLpCP9hWRrXQDU4Cm/g=

stackit/internal/core/core.go

@@ -72,6 +72,7 @@ type ProviderData struct {
 	ServiceEnablementCustomEndpoint string
 	SfsCustomEndpoint               string
 	ServiceAccountCustomEndpoint    string
+	TelemetryLinkCustomEndpoint     string
 	TelemetryRouterCustomEndpoint   string
 	EnableBetaResources             bool
 	Experiments                     []string

stackit/internal/services/telemetrylink/link/datasource.go

@@ -0,0 +1,201 @@
+package link
+
+import (
+	"context"
+	"fmt"
+	"net/http"
+	"time"
+
+	"github.com/hashicorp/terraform-plugin-framework-validators/stringvalidator"
+	"github.com/hashicorp/terraform-plugin-framework/datasource"
+	"github.com/hashicorp/terraform-plugin-framework/datasource/schema"
+	"github.com/hashicorp/terraform-plugin-framework/schema/validator"
+	"github.com/hashicorp/terraform-plugin-framework/types"
+	"github.com/hashicorp/terraform-plugin-log/tflog"
+	telemetrylink "github.com/stackitcloud/stackit-sdk-go/services/telemetrylink/v1betaapi"
+
+	"github.com/stackitcloud/terraform-provider-stackit/stackit/internal/conversion"
+	"github.com/stackitcloud/terraform-provider-stackit/stackit/internal/core"
+	"github.com/stackitcloud/terraform-provider-stackit/stackit/internal/services/telemetrylink/utils"
+	tfutils "github.com/stackitcloud/terraform-provider-stackit/stackit/internal/utils"
+	"github.com/stackitcloud/terraform-provider-stackit/stackit/internal/validate"
+)
+
+var (
+	_ datasource.DataSource = &telemetryLinkDataSource{}
+)
+
+func NewTelemetryLinkDataSource() datasource.DataSource {
+	return &telemetryLinkDataSource{}
+}
+
+type DataSourceModel struct {
+	ID                types.String `tfsdk:"id"` // Required by Terraform
+	Region            types.String `tfsdk:"region"`
+	ResourceType      types.String `tfsdk:"resource_type"`
+	ResourceID        types.String `tfsdk:"resource_id"`
+	DisplayName       types.String `tfsdk:"display_name"`
+	Description       types.String `tfsdk:"description"`
+	TelemetryRouterID types.String `tfsdk:"telemetry_router_id"`
+	CreateTime        types.String `tfsdk:"create_time"`
+	Status            types.String `tfsdk:"status"`
+}
+
+type telemetryLinkDataSource struct {
+	client       *telemetrylink.APIClient
+	providerData core.ProviderData
+}
+
+func (d *telemetryLinkDataSource) Metadata(_ context.Context, req datasource.MetadataRequest, resp *datasource.MetadataResponse) {
+	resp.TypeName = req.ProviderTypeName + "_telemetrylink"
+}
+
+func (d *telemetryLinkDataSource) Configure(ctx context.Context, req datasource.ConfigureRequest, resp *datasource.ConfigureResponse) {
+	providerData, ok := conversion.ParseProviderData(ctx, req.ProviderData, &resp.Diagnostics)
+	if !ok {
+		return
+	}
+	d.providerData = providerData
+
+	apiClient := utils.ConfigureClient(ctx, &providerData, &resp.Diagnostics)
+	if resp.Diagnostics.HasError() {
+		return
+	}
+	d.client = apiClient
+	tflog.Info(ctx, "TelemetryLink client configured")
+}
+
+func (d *telemetryLinkDataSource) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
+	resp.Schema = schema.Schema{
+		Description: fmt.Sprintf("TelemetryLink data source schema. %s", core.DatasourceRegionFallbackDocstring),
+		Attributes: map[string]schema.Attribute{
+			"id": schema.StringAttribute{
+				Description: schemaDescriptions["id"],
+				Computed:    true,
+			},
+			"resource_type": schema.StringAttribute{
+				Description: schemaDescriptions["resource_type"],
+				Required:    true,
+				Validators: []validator.String{
+					stringvalidator.OneOf(resourceTypes...),
+					validate.NoSeparator(),
+				},
+			},
+			"resource_id": schema.StringAttribute{
+				Description: schemaDescriptions["resource_id"],
+				Required:    true,
+				Validators: []validator.String{
+					validate.UUID(),
+					validate.NoSeparator(),
+				},
+			},
+			"region": schema.StringAttribute{
+				Description: schemaDescriptions["region"],
+				// the region cannot be found, so it has to be passed
+				Optional: true,
+			},
+			"display_name": schema.StringAttribute{
+				Description: schemaDescriptions["display_name"],
+				Computed:    true,
+			},
+			"description": schema.StringAttribute{
+				Description: schemaDescriptions["description"],
+				Computed:    true,
+			},
+			"telemetry_router_id": schema.StringAttribute{
+				Description: schemaDescriptions["telemetry_router_id"],
+				Computed:    true,
+			},
+			"create_time": schema.StringAttribute{
+				Description: schemaDescriptions["create_time"],
+				Computed:    true,
+			},
+			"status": schema.StringAttribute{
+				Description: schemaDescriptions["status"],
+				Computed:    true,
+			},
+		},
+	}
+}
+
+func (d *telemetryLinkDataSource) Read(ctx context.Context, req datasource.ReadRequest, resp *datasource.ReadResponse) { // nolint:gocritic // function signature required by Terraform
+	var model DataSourceModel
+	diags := req.Config.Get(ctx, &model)
+	resp.Diagnostics.Append(diags...)
+	if resp.Diagnostics.HasError() {
+		return
+	}
+
+	ctx = core.InitProviderContext(ctx)
+
+	resourceType := model.ResourceType.ValueString()
+	resourceID := model.ResourceID.ValueString()
+	region := d.providerData.GetRegionWithOverride(model.Region)
+
+	ctx = tflog.SetField(ctx, "resource_type", resourceType)
+	ctx = tflog.SetField(ctx, "resource_id", resourceID)
+	ctx = tflog.SetField(ctx, "region", region)
+
+	var response *telemetrylink.TelemetryLinkResponse
+	var err error
+	switch resourceType {
+	case resourceTypeOrganization:
+		response, err = d.client.DefaultAPI.GetOrganizationTelemetryLink(ctx, resourceID, region).Execute()
+	case resourceTypeFolder:
+		response, err = d.client.DefaultAPI.GetFolderTelemetryLink(ctx, resourceID, region).Execute()
+	case resourceTypeProject:
+		response, err = d.client.DefaultAPI.GetProjectTelemetryLink(ctx, resourceID, region).Execute()
+	default:
+		core.LogAndAddError(ctx, &resp.Diagnostics, "Error reading TelemetryLink", fmt.Sprintf("Unsupported resource type: %s", resourceType))
+		return
+	}
+	if err != nil {
+		tfutils.LogError(
+			ctx,
+			&resp.Diagnostics,
+			err,
+			"Error reading TelemetryLink",
+			fmt.Sprintf("TelemetryLink for resource type %q and resource ID %q does not exist.", resourceType, resourceID),
+			map[int]string{
+				http.StatusForbidden: fmt.Sprintf("Resource with type %q ID %q not found or forbidden access", resourceType, resourceID),
+			},
+		)
+		resp.State.RemoveResource(ctx)
+		return
+	}
+	ctx = core.LogResponse(ctx)
+
+	err = mapDataSourceFields(ctx, response, &model, region)
+	if err != nil {
+		core.LogAndAddError(ctx, &resp.Diagnostics, "Error reading TelemetryLink", fmt.Sprintf("Processing response: %v", err))
+		return
+	}
+	diags = resp.State.Set(ctx, model)
+	resp.Diagnostics.Append(diags...)
+	if resp.Diagnostics.HasError() {
+		return
+	}
+	tflog.Info(ctx, "TelemetryLink read", map[string]interface{}{
+		"resource_type": resourceType,
+		"resource_id":   resourceID,
+	})
+}
+
+func mapDataSourceFields(_ context.Context, link *telemetrylink.TelemetryLinkResponse, model *DataSourceModel, region string) error {
+	if link == nil {
+		return fmt.Errorf("link is nil")
+	}
+	if model == nil {
+		return fmt.Errorf("model is nil")
+	}
+
+	model.ID = tfutils.BuildInternalTerraformId(model.ResourceType.ValueString(), model.ResourceID.ValueString(), region)
+	model.Region = types.StringValue(region)
+	model.DisplayName = types.StringValue(link.DisplayName)
+	model.Description = types.StringPointerValue(link.Description)
+	model.TelemetryRouterID = types.StringValue(link.TelemetryRouterId)
+	model.CreateTime = types.StringValue(link.CreateTime.Format(time.RFC3339))
+	model.Status = types.StringValue(string(link.Status))
+
+	return nil
+}