[RS] Add warehouse snapshot resource

[catalina-gav]

📝 Description

When I am automating and managing data analytics infrastructure using Microsoft Fabric across multiple environments,
I want to provision and configure Warehouse Snapshot 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_warehouse_snapshot
• API documentation:
  • Create: https://learn.microsoft.com/en-us/rest/api/fabric/warehousesnapshot/items/create-warehouse-snapshot?tabs=HTTP
  • Get: https://learn.microsoft.com/en-us/rest/api/fabric/warehousesnapshot/items/get-warehouse-snapshot?tabs=HTTP
  • Update: https://learn.microsoft.com/en-us/rest/api/fabric/warehousesnapshot/items/update-warehouse-snapshot?tabs=HTTP
  • List: https://learn.microsoft.com/en-us/rest/api/fabric/warehousesnapshot/items/list-warehouse-snapshots?tabs=HTTP
  • Delete: https://learn.microsoft.com/en-us/rest/api/fabric/warehousesnapshot/items/delete-warehouse-snapshot?tabs=HTTP
• Estimated complexity/effort: easy
• Related resources/data-sources: https://learn.microsoft.com/en-us/fabric/data-warehouse/warehouse-snapshot

🚧 Potential Terraform Configuration / Desired Solution

# Example - Item with configuration
resource "fabric_warehouse_snapshot" "example" {
  display_name = "example1"
  workspace_id = "00000000-0000-0000-0000-000000000000"

  configuration = {
    parentWarehouseId = "00000000-0000-0000-0000-000000000000"
    snapshotDateTime   = "YYYY-MM-DDTHH:mm:ssZ"
  }
}

📎 Additional context

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.