Terraform Provider Overview

DE-CIX PDM Team Updated by DE-CIX PDM Team

Terraform Provider for DE-CIX (IX-API)

⚠️ Preview Release — The Cloud ROUTER features of this Terraform provider are currently in preview

The DE-CIX IX-API Terraform provider allows you to manage your interconnection services as Infrastructure as Code (IaC) using HashiCorp Terraform. It enables automated provisioning and lifecycle management of DE-CIX resources through a declarative configuration model.

The provider implements the IX-API open standard and extends it with DE-CIX Cloud ROUTER functionality.

Why Use Terraform with DE-CIX?

  • Automate service provisioning and configuration
  • Maintain version-controlled infrastructure
  • Ensure consistent and repeatable deployments
  • Integrate DE-CIX services into your DevOps workflows

What You Can Do

With the IX-API Terraform provider, you can:

  • Manage standard IX-API resources — provision accounts, contacts, connections, and network services
  • Provision Cloud ROUTER (VRF) instances with custom ASN, capacity, and routing policies
  • Attach your Cloud ROUTER to P2P VC and Cloud VC connections with full BGP and BFD configuration
  • Define BGP routing policies
  • Manage static routes
  • Query live operational state — BGP session state, BFD state, advertised/received routes, VRF routing tables, and ARP tables
  • Discover available offerings

Key Concepts

IX-API

An open standard that defines a common REST API for Internet Exchange Points. The Terraform provider maps IX-API resources to Terraform-managed infrastructure.

Cloud ROUTER (VRF)

A managed virtual routing instance at a DE-CIX location. Each Cloud ROUTER has an ASN, a bandwidth capacity, and one or more Network Service Configs attached to it.

Network Service Config (NSC)

Configuration for a BGP session linking a Cloud ROUTER to a network service (P2P VC or Cloud VC). An NSC links the Cloud ROUTER to a specific network service and carries configuration such as IP addresses, BGP neighbor details, VLAN settings, and BFD enablement.

Prefix List

A named list of IP prefixes with optional length constraints. Referenced by routing policies to match BGP routes.

Policy

Routing rule set for accepting, rejecting, or modifying BGP routes. A named BGP routing policy composed of ordered entries. Each entry optionally matches a prefix list and applies an action (accept or reject) with optional attribute modifications such as local preference or AS path prepending.

Product Offering

Defines capacity tiers and commercial attributes

Next Steps

Getting Started

Provider Configuration

Managing Services

State Management

End-to-End Example

How did we do?

Getting Started

Get in touch