Implement Fabric API v4 resources

[displague]

Community Note

• Please vote on this issue by adding a 👍 reaction to the original issue to help the community and maintainers prioritize this request
• Please do not leave "+1" or "me too" comments, they generate extra noise for issue followers and do not help prioritize the request
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Equinix Fabric has a new v4 API with an improved interface for managing connections, ports, gateways, and tokens.

This API replaces many of the v2 and v3 APIs. Details to follow in the comments about which endpoints/resources will need to be modified or deprecated to meet the API timelines.

A Go SDK will be needed to implement the new Terraform resources. ecx-go could be extended, but this is a hand-edited SDK with legacy branding. A new generated SDK (using openapitools/openapi-generator-cli, for example) would be advisable. SwaggerHub provides a downloadable Go client, automated or manual publishing of this client would be helpful.

New or Affected Resource(s)

The following items should be linked to individual issues when they exist.

Proposed New Resources:

• equinix_fabric_connection
  Fabric v4 - Initial implementation with Connections #209
• equinix_fabric_connection_action - unclear if this should be a resource or a property
• equinix_fabric_connection_routing_protocols - unclear if this should be a resource or a property
• equinix_fabric_connection_bulk_routing_protocols - unclear if this should be a resource or a property
• equinix_fabric_bulk_connection
• equinix_fabric_gateway equinix_fabric_cloud_router
• equinix_fabric_service_profile
• equinix_fabric_service_tokens

Proposed New Datasources:

• equinix_fabric_connections (using /search)
• equinix_fabric_connection (using id or other unique criteria)
• equinix_fabric_metros (unclear if this is needed over a generic equinix_metros datasource)
• equinix_fabric_metro (by id, unclear if this is needed over a generic equinix_metro)
• equinix_fabric_prices (uses /search)
• equinix_fabric_gateways (using /search)
• equinix_fabric_gateway equinix_fabric_cloud_router (using id or other unique criteria)
• equinix_fabric_gateway_packages
• equinix_fabric_gateway_package (by id)
• equinix_fabric_service_profiles
• equinix_fabric_service_profiles (by id)
• equinix_fabric_service_tokens
• equinix_fabric_service_token (by id)
• equinix_fabric_port
  Fabric v4 - Port data schema implementation and Terraform Script - Create Connection example #232
• equinix_fabric_ports (by id)
• equinix_fabric_port_stats
• equinix_fabric_ports_stats
• equinix_fabric_connection_stats

Affected:

• equinix_ecx_l2_connection
• equinix_ecx_l2_connection_accepter
• equinix_ecx_l2_serviceprofile
• equinix_ecx_l2_sellerprofile
• equinix_ecx_l2_sellerprofiles
• equinix_ecx_port

Milestones for this:

• Connection Resource / Datasource implemented
  • Documentation in place
    • Examples are updated
  • Testing in place
  • Connection Merged
• Examples / Modules updated to take advantage of this
  • Limitations outlined? Port and Profile, for example
• ECX Parity
  • equinix_ecx_l2_connection
  • equinix_ecx_l2_connection_accepter
  • equinix_ecx_l2_serviceprofile
  • (Data Sources) equinix_ecx_l2_sellerprofile
  • (Data Sources) equinix_ecx_l2_sellerprofiles
  • (Data Sources) equinix_ecx_port
  • Guide: Migrating from ECX to Fabric
    • Cover the 12? patterns
• All new functionality

Potential Terraform Configuration

# TBD example demonstrating all resources

References

• Design decisions may need to be reached on multi-versioned resources, if needed: Pattern for supporting additional Equinix APIs #66

[displague]

A branch has been created to start this work off with an internal/ generated Go SDK for Fabric v4 APIs.
https://github.com/equinix/terraform-provider-equinix/compare/fabric-v4

[displague]

The resources described above are no longer representative of the latest public spec:
https://app.swaggerhub.com/apis/equinix-api/fabric/4.3

[displague]

updated the lists in the description to add equinix_fabric_service_profiles as introduced by 4.2 or 4.3 spec.

[displague]

This work is now been tracked in the equinix:fabric-v4 branch.

We're awaiting more Fabric resources which will be applied directly to this branch before ultimately being merged into the main branch.

[displague]

Noting that Fabric 4.6 API is now available (not yet in Fabric Go): equinix-labs/fabric-java#18