README
¶
go-sdwan
go-sdwan is a Go client library for Cisco SDWAN. It is based on Nathan's excellent goaci module and features a simple, extensible API and advanced JSON manipulation.
Getting Started
Installing
To start using go-sdwan, install Go and go get:
$ go get -u github.com/netascode/go-sdwan
Basic Usage
package main
import "github.com/netascode/go-sdwan"
func main() {
client, _ := sdwan.NewClient("1.1.1.1", "user", "pwd", true)
res, _ := client.Get("/admin/resourcegroup")
println(res.Get("0.id").String())
}
This will print something like:
0:RESOURCE_GROUPNode:1626378545017:2
Result manipulation
sdwan.Result uses GJSON to simplify handling JSON results. See the GJSON documentation for more detail.
res, _ := client.Get("/admin/resourcegroup")
for _, group := range res.Array() {
println(group.Get("@pretty").String()) // pretty print resource groups
}
POST data creation
sdwan.Body is a wrapper for SJSON. SJSON supports a path syntax simplifying JSON creation.
body := sdwan.Body{}.
Set("name", "test").
Set("desc", "API Test")
client.Post("/admin/resourcegroup", body.Str)
Documentation
See the documentation for more details.
Documentation
¶
Overview ¶
Package sdwan is a Cisco SDWAN REST client library for Go.
Index ¶
- Constants
- func BackoffDelayFactor(x float64) func(*Client)
- func BackoffMaxDelay(x int) func(*Client)
- func BackoffMinDelay(x int) func(*Client)
- func MaxRetries(x int) func(*Client)
- func NoLogPayload(req *Req)
- func RequestTimeout(x time.Duration) func(*Client)
- type Body
- type Client
- func (client *Client) Authenticate() error
- func (client *Client) Backoff(attempts int) bool
- func (client *Client) Delete(path string, mods ...func(*Req)) (Res, error)
- func (client *Client) DeleteBody(path, data string, mods ...func(*Req)) (Res, error)
- func (client *Client) Do(req Req) (Res, error)
- func (client *Client) Get(path string, mods ...func(*Req)) (Res, error)
- func (client *Client) GetManagerVersion() error
- func (client *Client) Login() error
- func (client Client) NewReq(method, uri string, body io.Reader, mods ...func(*Req)) Req
- func (client *Client) Post(path, data string, mods ...func(*Req)) (Res, error)
- func (client *Client) Put(path, data string, mods ...func(*Req)) (Res, error)
- type Req
- type Res
Constants ¶
const DefaultBackoffDelayFactor float64 = 3
const DefaultBackoffMaxDelay int = 60
const DefaultBackoffMinDelay int = 2
const DefaultMaxRetries int = 3
Variables ¶
This section is empty.
Functions ¶
func BackoffDelayFactor ¶
BackoffDelayFactor modifies the backoff delay factor from the default of 3.
func BackoffMaxDelay ¶
BackoffMaxDelay modifies the maximum delay between two retries from the default of 60.
func BackoffMinDelay ¶
BackoffMinDelay modifies the minimum delay between two retries from the default of 2.
func MaxRetries ¶
MaxRetries modifies the maximum number of retries from the default of 3.
func NoLogPayload ¶
func NoLogPayload(req *Req)
NoLogPayload prevents logging of payloads. Primarily used by the Login and Refresh methods where this could expose secrets.
func RequestTimeout ¶
RequestTimeout modifies the HTTP request timeout from the default of 60 seconds.
Types ¶
type Body ¶
type Body struct {
Str string
}
Body wraps SJSON for building JSON body strings. Usage example:
Body{}.Set("name", "ABC").Str
type Client ¶
type Client struct {
// HttpClient is the *http.Client used for API requests.
HttpClient *http.Client
// Url is the SDWAN vManage IP or hostname, e.g. https://10.0.0.1:443 (port is optional).
Url string
// Token is the current authentication token
Token string
// Usr is the SDWAN username.
Usr string
// Pwd is the SDWAN password.
Pwd string
// Insecure determines if insecure https connections are allowed.
Insecure bool
// Maximum number of retries
MaxRetries int
// Minimum delay between two retries
BackoffMinDelay int
// Maximum delay between two retries
BackoffMaxDelay int
// Backoff delay factor
BackoffDelayFactor float64
// Authentication mutex
AuthenticationMutex *sync.Mutex
// SDWAN Manager Version
ManagerVersion string
}
Client is an HTTP SDWAN client. Use sdwan.NewClient to initiate a client. This will ensure proper cookie handling and processing of modifiers.
func NewClient ¶
NewClient creates a new SDWAN HTTP client. Pass modifiers in to modify the behavior of the client, e.g.
client, _ := NewClient("vmanage1.cisco.com", "user", "password", true, RequestTimeout(120))
func (*Client) Authenticate ¶
Login if no token available and try to retrieve version
func (*Client) DeleteBody ¶ added in v0.1.6
DeleteBody makes a DELETE request with a payload. Hint: Use the Body struct to easily create DELETE body data.
func (*Client) Do ¶
Do makes a request. Requests for Do are built ouside of the client, e.g.
req := client.NewReq("GET", "/admin/resourcegroup", nil)
res, _ := client.Do(req)
func (*Client) Get ¶
Get makes a GET request and returns a GJSON result. Results will be the raw data structure as returned by vManage
func (*Client) GetManagerVersion ¶ added in v0.1.7
Get SDWAN Manager version
type Req ¶
type Req struct {
// HttpReq is the *http.Request obejct.
HttpReq *http.Request
// LogPayload indicates whether logging of payloads should be enabled.
LogPayload bool
}
Req wraps http.Request for API requests.
type Res ¶
Res is an API response returned by client requests. This is a GJSON result, which offers advanced and safe parsing capabilities. https://github.com/tidwall/gjson
Source Files