feat(interlink): add partner datasources (#3874)

* feat(interlink): add partner datasources

* fix

* docs

* fixes

Author: yfodil

.github/workflows/acceptance-tests.yaml

@@ -31,6 +31,7 @@ jobs:
           - iam
           - inference
           - instance
+          - interlink
           - iot
           - ipam
           - jobs

.github/workflows/nightly.yml

@@ -33,6 +33,7 @@ jobs:
           - iam
           - inference
           - instance
+          - interlink
           - iot
           - ipam
           - jobs

docs/data-sources/interlink_partner.md

@@ -0,0 +1,45 @@
+---
+subcategory: "Interlink"
+page_title: "Scaleway: scaleway_interlink_partner"
+---
+
+# scaleway_interlink_partner (Data Source)
+
+Gets information about an Interlink Partner.
+
+A partner is an organization that provides shared connections at PoPs, allowing you to create hosted links without owning physical infrastructure.
+
+## Example Usage
+
+```terraform
+# Retrieve a partner by its ID
+data "scaleway_interlink_partner" "by_id" {
+  partner_id = "fr-par/11111111-1111-1111-1111-111111111111"
+}
+```
+
+```terraform
+# Retrieve a partner by name
+data "scaleway_interlink_partner" "by_name" {
+  name = "FreePro"
+}
+```
+
+
+
+## Argument Reference
+
+- `partner_id` - (Optional) The ID of the partner. Can be a plain UUID or a regional ID. Conflicts with `name`.
+- `name` - (Optional) The name of the partner to filter for. Conflicts with `partner_id`.
+- `region` - (Defaults to [provider](../index.md#region) `region`) The [region](../guides/regions_and_zones.md#regions) in which the partner operates.
+
+## Attributes Reference
+
+In addition to all arguments above, the following attributes are exported:
+
+- `id` - The ID of the partner.
+- `contact_email` - Contact email address of the partner.
+- `logo_url` - URL of the partner's logo.
+- `portal_url` - URL of the partner's portal.
+- `created_at` - Creation date of the partner.
+- `updated_at` - Last update date of the partner.

docs/data-sources/interlink_partners.md

@@ -0,0 +1,44 @@
+---
+subcategory: "Interlink"
+page_title: "Scaleway: scaleway_interlink_partners"
+---
+
+# scaleway_interlink_partners (Data Source)
+
+Gets information about multiple Interlink Partners.
+
+A partner is an organization that provides shared connections at PoPs. Use this data source to list and filter available partners for creating hosted links.
+
+## Example Usage
+
+```terraform
+# List all partners in a region
+data "scaleway_interlink_partners" "all" {
+  region = "fr-par"
+}
+
+# List partners available at specific PoPs
+data "scaleway_interlink_partners" "at_pops" {
+  pop_ids = [
+    data.scaleway_interlink_pop.main.id,
+  ]
+}
+```
+
+
+
+## Argument Reference
+
+- `pop_ids` - (Optional) Filter for partners present (offering a connection) in one of these PoPs.
+- `region` - (Defaults to [provider](../index.md#region) `region`) The [region](../guides/regions_and_zones.md#regions) to list partners from.
+
+## Attributes Reference
+
+- `partners` - List of partners matching the filters. Each entry contains:
+    - `id` - ID of the partner.
+    - `name` - Name of the partner.
+    - `contact_email` - Contact email address.
+    - `logo_url` - URL of the partner's logo.
+    - `portal_url` - URL of the partner's portal.
+    - `created_at` - Creation date.
+    - `updated_at` - Last update date.

examples/data-sources/scaleway_interlink_partner/data-source-by-id.tf

@@ -0,0 +1,4 @@
+# Retrieve a partner by its ID
+data "scaleway_interlink_partner" "by_id" {
+  partner_id = "fr-par/11111111-1111-1111-1111-111111111111"
+}

examples/data-sources/scaleway_interlink_partner/data-source-by-name.tf

@@ -0,0 +1,4 @@
+# Retrieve a partner by name
+data "scaleway_interlink_partner" "by_name" {
+  name = "FreePro"
+}

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

@@ -0,0 +1,11 @@
+# List all partners in a region
+data "scaleway_interlink_partners" "all" {
+  region = "fr-par"
+}
+
+# List partners available at specific PoPs
+data "scaleway_interlink_partners" "at_pops" {
+  pop_ids = [
+    data.scaleway_interlink_pop.main.id,
+  ]
+}

internal/services/interlink/descriptions/partner_data_source.md

@@ -0,0 +1,3 @@
+Gets information about an Interlink Partner.
+
+A partner is an organization that provides shared connections at PoPs, allowing you to create hosted links without owning physical infrastructure.

internal/services/interlink/descriptions/partners_data_source.md

@@ -0,0 +1,3 @@
+Gets information about multiple Interlink Partners.
+
+A partner is an organization that provides shared connections at PoPs. Use this data source to list and filter available partners for creating hosted links.

internal/services/interlink/helpers.go

@@ -0,0 +1,31 @@
+package interlink
+
+import (
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
+	interlink "github.com/scaleway/scaleway-sdk-go/api/interlink/v1beta1"
+	"github.com/scaleway/scaleway-sdk-go/scw"
+	"github.com/scaleway/terraform-provider-scaleway/v2/internal/locality/regional"
+	"github.com/scaleway/terraform-provider-scaleway/v2/internal/meta"
+)
+
+func interlinkAPIWithRegion(d *schema.ResourceData, m any) (*interlink.API, scw.Region, error) {
+	interlinkAPI := interlink.NewAPI(meta.ExtractScwClient(m))
+
+	region, err := meta.ExtractRegion(d, m)
+	if err != nil {
+		return nil, "", err
+	}
+
+	return interlinkAPI, region, err
+}
+
+func NewAPIWithRegionAndID(m any, id string) (*interlink.API, scw.Region, string, error) {
+	interlinkAPI := interlink.NewAPI(meta.ExtractScwClient(m))
+
+	region, ID, err := regional.ParseID(id)
+	if err != nil {
+		return nil, "", "", err
+	}
+
+	return interlinkAPI, region, ID, err
+}