Equinix Fabric Go client

Equinix Fabric client library written in Go.

Purpose

Equinix Fabric client library was written in Go for purpose of managing Fabric
resources from Terraform provider plugin.

Library gives possibility to manage layer two connections and service profiles
on Equinix Fabric and connect to any Cloud Service Provider, other Enterprise
or between own ports.

Features

Client library consumes Equinix Fabric’s REST API and allows to:

• manage Fabric L2 connections
  • retrieve L2 connection details
  • create non redundant L2 connection
  • create redundant L2 connection
  • delete L2 connection
  • update L2 connection (name and speed)
• manage Fabric L2 service profiles
• retrieve list of Fabric user ports
• retrieve list of Fabric L2 seller profiles

NOTE: scope of this library is limited to needs of Terraform provider plugin
and it is not providing full capabilities of Equinix Fabric API

Usage

Code

1. Add ecx-go module to import statement.
   In below example, Equinix oauth2-go module is imported as well

   import (
    "github.com/equinix/oauth2-go"
    "github.com/equinix/ecx-go"
   )

2. Define baseURL that will be used in all REST API requests

    baseURL := "https://sandboxapi.equinix.com"

3. Create oAuth configuration and oAuth enabled http.Client

    authConfig := oauth2.Config{
      ClientID:     "someClientId",
      ClientSecret: "someSecret",
      BaseURL:      baseURL}
    ctx := context.Background()
    authClient := authConfig.New(ctx)

4. Create Equinix Fabric REST client with a given baseURL and oauth’s http.Client

    var ecxClient ecx.Client = ecx.NewClient(ctx, baseURL, authClient)

5. Use Equinix Fabric client to perform some operation i.e. fetch

    l2conn, err := ecxClient.GetL2Connection("myUUID")
    if err != nil {
      log.Printf("Error while fetching connection - %v", err)
    } else {
      log.Printf("Retrieved connection - %+v", l2conn)
    }