[OMG-629] Add TF provider for team hierarchy links

.generator/team_hierarchy_links.txt

@@ -0,0 +1,18 @@
+resources:
+  team-hierarchy-links:
+    read:
+      method: get
+      path: /api/v2/team-hierarchy-links/{link_id}
+    create:
+      method: post
+      path: /api/v2/team-hierarchy-links
+    update:
+      method: patch
+      path: /api/v2/team-hierarchy-links/{link_id}
+    delete:
+      method: delete
+      path: /api/v2/team-hierarchy-links/{link_id}
+datasources:
+  team-hierarchy-links:
+    singular: /api/v2/team-hierarchy-links/{link_id}
+    plural: /api/v2/team-hierarchy-links

datadog/fwprovider/data_source_datadog_team-hierarchy-links.go

@@ -0,0 +1,145 @@
+package fwprovider
+
+import (
+	"context"
+
+	"github.com/DataDog/datadog-api-client-go/v2/api/datadogV2"
+	"github.com/hashicorp/terraform-plugin-framework/datasource"
+	"github.com/hashicorp/terraform-plugin-framework/datasource/schema"
+	"github.com/hashicorp/terraform-plugin-framework/types"
+
+	"github.com/terraform-providers/terraform-provider-datadog/datadog/internal/utils"
+)
+
+var (
+	_ datasource.DataSource = &datadogTeamHierarchyLinksDataSource{}
+)
+
+type datadogTeamHierarchyLinksDataSource struct {
+	Api  *datadogV2.TeamsApi
+	Auth context.Context
+}
+
+type datadogTeamHierarchyLinksDataSourceModel struct {
+	// Datasource ID
+	ID types.String `tfsdk:"id"`
+
+	// Query Parameters
+	LinkId           types.String `tfsdk:"link_id"`
+	FilterParentTeam types.String `tfsdk:"filter[parent_team]"`
+	FilterSubTeam    types.String `tfsdk:"filter[sub_team]"`
+
+	// Computed values
+	CreatedAt     types.String `tfsdk:"created_at"`
+	ProvisionedBy types.String `tfsdk:"provisioned_by"`
+}
+
+func NewDatadogTeamHierarchyLinksDataSource() datasource.DataSource {
+	return &datadogTeamHierarchyLinksDataSource{}
+}
+
+func (d *datadogTeamHierarchyLinksDataSource) Configure(_ context.Context, request datasource.ConfigureRequest, response *datasource.ConfigureResponse) {
+	providerData, _ := request.ProviderData.(*FrameworkProvider)
+	d.Api = providerData.DatadogApiInstances.GetTeamsApiV2()
+	d.Auth = providerData.Auth
+}
+
+func (d *datadogTeamHierarchyLinksDataSource) Metadata(_ context.Context, request datasource.MetadataRequest, response *datasource.MetadataResponse) {
+	response.TypeName = "team_hierarchy_links"
+}
+
+func (d *datadogTeamHierarchyLinksDataSource) Schema(_ context.Context, _ datasource.SchemaRequest, response *datasource.SchemaResponse) {
+	response.Schema = schema.Schema{
+		Description: "Use this data source to retrieve information about an existing Datadog team-hierarchy-links.",
+		Attributes: map[string]schema.Attribute{
+			// Datasource ID
+			"id": utils.ResourceIDAttribute(),
+			// Query Parameters
+			"link_id": schema.StringAttribute{
+				Optional:    true,
+				Description: "UPDATE ME",
+			},
+			"filter[parent_team]": schema.StringAttribute{
+				Optional:    true,
+				Description: "UPDATE ME",
+			},
+			"filter[sub_team]": schema.StringAttribute{
+				Optional:    true,
+				Description: "UPDATE ME",
+			},
+			// Computed values
+			"created_at": schema.StringAttribute{
+				Computed:    true,
+				Description: "Timestamp when the team hierarchy link was created",
+			},
+			"provisioned_by": schema.StringAttribute{
+				Computed:    true,
+				Description: "The provisioner of the team hierarchy link",
+			},
+		},
+	}
+}
+
+func (d *datadogTeamHierarchyLinksDataSource) Read(ctx context.Context, request datasource.ReadRequest, response *datasource.ReadResponse) {
+	var state datadogTeamHierarchyLinksDataSourceModel
+	response.Diagnostics.Append(request.Config.Get(ctx, &state)...)
+	if response.Diagnostics.HasError() {
+		return
+	}
+
+	if !state.TeamHierarchyLinksId.IsNull() {
+		teamHierarchyLinksId := state.TeamHierarchyLinksId.ValueString()
+		ddResp, _, err := d.Api.GetTeamHierarchyLinks(d.Auth, teamHierarchyLinksId)
+		if err != nil {
+			response.Diagnostics.Append(utils.FrameworkErrorDiag(err, "error getting datadog teamHierarchyLinks"))
+			return
+		}
+
+		d.updateState(ctx, &state, ddResp.Data)
+	} else {
+		filterParentTeam := state.FilterParentTeam.ValueString()
+		filterSubTeam := state.FilterSubTeam.ValueString()
+
+		optionalParams := datadogV2.ListTeamHierarchyLinkssOptionalParameters{
+			FilterParentTeam: &filterParentTeam,
+			FilterSubTeam:    &filterSubTeam,
+		}
+
+		ddResp, _, err := d.Api.ListTeamHierarchyLinkss(d.Auth, optionalParams)
+		if err != nil {
+			response.Diagnostics.Append(utils.FrameworkErrorDiag(err, "error listing datadog teamHierarchyLinks"))
+			return
+		}
+
+		if len(ddResp.Data) > 1 {
+			response.Diagnostics.AddError("filters returned more than one result, use more specific search criteria", "")
+			return
+		}
+		if len(ddResp.Data) == 0 {
+			response.Diagnostics.AddError("filters returned no results", "")
+			return
+		}
+
+		d.updateStateFromListResponse(ctx, &state, &ddResp.Data[0])
+	}
+
+	// Save data into Terraform state
+	response.Diagnostics.Append(response.State.Set(ctx, &state)...)
+}
+
+func (d *datadogTeamHierarchyLinksDataSource) updateState(ctx context.Context, state *datadogTeamHierarchyLinksDataSourceModel, teamHierarchyLinksData *datadogV2.TeamHierarchyLinks) {
+	state.ID = types.StringValue(teamHierarchyLinksData.GetId())
+
+	attributes := teamHierarchyLinksData.GetAttributes()
+	state.CreatedAt = types.StringValue(attributes.GetCreatedAt().String())
+	state.ProvisionedBy = types.StringValue(attributes.GetProvisionedBy())
+}
+
+func (d *datadogTeamHierarchyLinksDataSource) updateStateFromListResponse(ctx context.Context, state *datadogTeamHierarchyLinksDataSourceModel, teamHierarchyLinksData *datadogV2.TeamHierarchyLinks) {
+	state.ID = types.StringValue(teamHierarchyLinksData.GetId())
+	state.LinkId = types.StringValue(teamHierarchyLinksData.GetId())
+
+	attributes := teamHierarchyLinksData.GetAttributes()
+	state.CreatedAt = types.StringValue(attributes.GetCreatedAt().String())
+	state.ProvisionedBy = types.StringValue(attributes.GetProvisionedBy())
+}