Name: go-netbox
Owner: DigitalOcean
Description: Package netbox provides an API client for DigitalOcean's NetBox IPAM and DCIM service.
Created: 2016-06-29 00:32:14.0
Updated: 2018-05-22 07:39:36.0
Pushed: 2018-05-07 16:26:52.0
Homepage: null
Size: 955
Language: Go
GitHub Committers
| User | Most Recent Commit | # Commits |
|---|
Other Committers
| User | Most Recent Commit | # Commits |
|---|
Package netbox provides an API 2.0 client for DigitalOcean's NetBox
IPAM and DCIM service.
This package assumes you are using NetBox 2.0, as the NetBox 1.0 API no longer exists.
The github.com/go-netbox/netbox 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.
rt (
"github.com/digitalocean/go-netbox/netbox"
c := netbox.NewNetboxAt("your.netbox.host:8000")
// OR
c := netbox.NewNetboxWithAPIKey("your.netbox.host:8000", "your_netbox_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)
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.
To regenerate the client with a new or different swagger schema, first clean the existing client, then replace swagger.json and finally re-generate:
clean
ew_swagger_file.json swagger.json
generate