danehans / acigo

Acigo is a Go package for interacting with Cisco ACI using API calls.

About Acigo

Acigo is a Go package for interacting with Cisco ACI using API calls.

Usage

1. Grab the source

go get github.com/udhos/acigo

2. Grab dependencies

go get github.com/gorilla/websocket

3. Import the package in your program

import "github.com/udhos/acigo/aci"

Example

package main

import (
	"fmt"
	"github.com/udhos/acigo/aci"
)

func main() {

	a, errNew := aci.New(aci.ClientOptions{})
	if errNew != nil {
		fmt.Printf("login new client error: %v\n", errNew)
		return
	}

	// Since credentials have not been specified explicitly under ClientOptions,
	// Login() will use env vars: APIC_HOSTS=host, APIC_USER=username, APIC_PASS=pwd
	errLogin := a.Login()
	if errLogin != nil {
		fmt.Printf("login error: %v\n", errLogin)
		return
	}

	errAdd := a.TenantAdd("tenant-example", "")
	if errAdd != nil {
		fmt.Printf("tenant add error: %v\n", errAdd)
		return
	}

	errLogout := a.Logout()
	if errLogout != nil {
		fmt.Printf("logout error: %v\n", errLogout)
		return
	}
}

Documentation

Acigo documentation in GoDoc: https://godoc.org/github.com/udhos/acigo/aci

See Also

Cisco APIC REST API User Guide

APIC Management Information Model Reference