[RS] Add Gateway Resource

[badeamarjieh]

📝 Description

When I am automating and managing data analytics infrastructure using Microsoft Fabric across multiple environments,
I want to provision and configure Gateways as code in Terraform,
So I can consistently and securely manage my data connectivity resources, ensure repeatable deployments, and streamline updates in a single Infrastructure-as-Code workflow.

🔬 Details / References

• Resource Name: fabric_gateway
• API documentation:
  • Create Gateway: https://learn.microsoft.com/en-us/rest/api/fabric/core/gateways/create-gateway?tabs=HTTP
  • Delete Gateway: https://learn.microsoft.com/en-us/rest/api/fabric/core/gateways/delete-gateway?tabs=HTTP
  • Get Gateway: https://learn.microsoft.com/en-us/rest/api/fabric/core/gateways/get-gateway?tabs=HTTP
  • Update Gateway: https://learn.microsoft.com/en-us/rest/api/fabric/core/gateways/update-gateway?tabs=HTTP
• Estimated complexity/effort: moderate
• Related resources/data-sources:
  • resources/data-source: connections (not introduced yet)
  • data-source: capacity

🚧 Potential Terraform Configuration / Desired Solution

resource "fabric_gateway" "example" {
  type = "VirtualNetwork"
  display_name = "example"
  capacity_id= data.fabric_capacity.example.id
  number_of_member_gateways = 2
  inactivity_minutes_before_sleep = 120
  virtual_network_azure_resource = { 
    resource_group_name = "example_resource_group" #or dependency on azurerm terraform provider?
    subnet_name = "example_subnet_name"
    subscription_id= "ed26b6f3-7bc5-44b0-9565-a8942619ef4c"
    virtual_network_name= "exmaple_virtual_network_name"
  }
}

📎 Additional context

Although Create Gateway API is not polymorphic at the moment, as it only accepts a Virtual Network payload. The suggested solution proposes a polymorphic solution as per future expectations for this API.

No response

☑️ Acceptance Criteria

No response

✅ Definition of Done

• Data Transfer Objects (DTOs)
• Resource Implementation
• Resource Added to Provider
• Unit Tests for Happy path
• Unit Tests for Error path
• Acceptance Tests
• Example in the ./examples folder
• Schema documentation in code
• Updated auto-generated provider docs with task docs

🔰 Code of Conduct

• I agree to follow this project's Code of Conduct.