go-nautobot

README

go-nautobot

Package nautobot provides an API 1.0 client for NetworkToCode's Nautobot IPAM and DCIM service.

This package assumes you are using Nautobot 1.0

Why this fork exists

This project is a fork of fbreckle/go-netbox.

This fork exists solely to support e-breuninger/terraform-provider-netbox. As such, some changes in this fork do only make sense in that context.

Versioning

tbd. In the meanwhile, look at branches and tags.

Changes in this fork

Change models.ip_address.AssignedObject type to prevent json marshalling errors since this change

Add x-omitempty: false to some attributes, allowing them to be set to their empty value. issue

Change ConfigContext type for VMs and Devices #2

Fix LocalConfigContext to support arbitrary JSON object #4

Using the client

The github.com/go-nautobot/nautobot package has some convenience functions for creating clients with the most common configurations you are likely to need while connecting to NetBox. NewNetboxAt allows you to specify a hostname (including port, if you need it), and NewNetboxWithAPIKey allows you to specify both a hostname:port and API token.

import (
    "github.com/thushjandan/go-nautobot/nautobot"
)
...
    c := nautobot.NewNautobotAt("your.nautobot.host:8000")
    // OR
    c := nautobot.NewNautobotWithAPIKey("your.nautobot.host:8000", "your_nautobot_token")

If you specify the API key, you do not need to pass an additional authInfo to operations that need authentication, and can pass nil:

    c.Dcim.DcimDeviceTypesCreate(createRequest, nil)

If you connect to nautobot via HTTPS you have to create an HTTPS configured transport:

package main

import (
	"os"

	httptransport "github.com/go-openapi/runtime/client"
	"github.com/thushjandan/go-nautobot/nautobot/client"
	"github.com/thushjandan/go-nautobot/nautobot/client/dcim"

	log "github.com/sirupsen/logrus"
)

func main() {
	token := os.Getenv("NETBOX_TOKEN")
	if token == "" {
		log.Fatalf("Please provide nautobot API token via env var NETBOX_TOKEN")
	}

	netboxHost := os.Getenv("NETBOX_HOST")
	if netboxHost == "" {
		log.Fatalf("Please provide nautobot host via env var NETBOX_HOST")
	}

	transport := httptransport.New(netboxHost, client.DefaultBasePath, []string{"https"})
	transport.DefaultAuthentication = httptransport.APIKeyAuth("Authorization", "header", "Token "+token)

	c := client.New(transport, nil)

	req := dcim.NewDcimSitesListParams()
	res, err := c.Dcim.DcimSitesList(req, nil)
	if err != nil {
		log.Fatalf("Cannot get sites list: %v", err)
	}
	log.Infof("res: %v", res)
}

Go Module support

Go 1.13+

go get github.com/thushjandan/go-nautobot

More complex client configuration

The client is generated using go-swagger. This means the generated client makes use of github.com/go-openapi/runtime/client. If you need a more complex configuration, it is probably possible with a combination of this generated client and the runtime options.

The godocs for the go-openapi/runtime/client module explain the client options in detail, including different authentication and debugging options. One thing I want to flag because it is so useful: setting the DEBUG environment variable will dump all requests to standard out.

Regenerating the client

To regenerate the client with a new or different swagger schema, first clean the existing client, then replace swagger.json, run the json preprocessor (requires python3) and finally re-generate:

make clean
make preprocess
make generate