Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cisco-en-programmability/dnacenter-go-sdk
Cisco DNA Center SDK for Go Programming Language
https://github.com/cisco-en-programmability/dnacenter-go-sdk
Last synced: 25 days ago
JSON representation
Cisco DNA Center SDK for Go Programming Language
- Host: GitHub
- URL: https://github.com/cisco-en-programmability/dnacenter-go-sdk
- Owner: cisco-en-programmability
- License: mit
- Created: 2020-10-22T21:28:49.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-11-14T20:15:03.000Z (28 days ago)
- Last Synced: 2024-11-14T21:17:36.585Z (28 days ago)
- Language: Go
- Homepage: https://pkg.go.dev/github.com/cisco-en-programmability/dnacenter-go-sdk/v5
- Size: 1.69 MB
- Stars: 6
- Watchers: 5
- Forks: 11
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-cisco-dnac - dnacenter-go-sdk
README
# dnacenter-go-sdk
dnacenter-go-sdk is a Go client library for [Catalyst Center Platform](https://developer.cisco.com/dnacenter/).
## Usage
```go
import dnac "github.com/cisco-en-programmability/dnacenter-go-sdk/v6/sdk"
```
## Introduction
The dnacenter-go-sdk makes it easier to work with the Cisco Catalyst Center Platform RESTFul APIs from Go.
It supports version 2.3.5.3, but it is backward compatible with other versions as long as those versions use the same URLs and options as version 2.3.5.3.
## Getting started
The first think you need to do is to generate an API client. There are two options to do it:
1. Parameters
2. Environment variables
### Parameters
The client could be generated with the following parameters:
- `baseURL`: The base URL, FQDN or IP, of the Catalyst Center instance.
- `username`: The username for the API authentication and authorization.
- `password`: The password for the API authentication and authorization.
- `debug`: Boolean to enable debugging
- `sslVerify`: Boolean to enable or disable SSL certificate verification.
- `waitTimeToManyRequest`: Time in minutes SDK will wait after API responds with 429 status code (to many requests) it defaults is in 1 minute.
```go
Client, err = dnac.NewClientWithOptions("https://sandboxdnac.cisco.com",
"devnetuser", "Cisco123!",
"false", "false", nil)
devicesCount, _, err := Client.Devices.GetDeviceCount()
```
### Using environment variables
The client can be configured with the following environment variables:
- `DNAC_BASE_URL`: The base URL, FQDN or IP, of the Catalyst Center instance.
- `DNAC_USERNAME`: The username for the API authentication and authorization.
- `DNAC_PASSWORD`: The password for the API authentication and authorization.
- `DNAC_DEBUG`: Boolean to enable debugging
- `DNAC_SSL_VERIFY`: Boolean to enable or disable SSL certificate verification.
- `DNAC_WAIT_TIME`: Time in minutes SDK will wait after API responds with 429 status code (to many requests) it defaults is in 1 minute.
```go
Client, err = dnac.NewClient()
devicesCount, _, err := Client.Devices.GetDeviceCount()
```
## Examples
Here is an example of how we can generate a client, get a device count and then a list of devices filtering them using query params.
```go
Client, err = dnac.NewClientWithOptions("https://sandboxdnac.cisco.com",
"devnetuser", "Cisco123!",
"false", "false",nil)
devicesCount, _, err := Client.Devices.GetDeviceCount()
if err != nil {
fmt.Println(err)
}
fmt.Println("Device Count:", devicesCount.Response)
getDeviceListQueryParams = &dnac.GetDeviceListQueryParams{
PlatformID: []string{"C9300-24UX"},
}
fmt.Println("Printing device list ... PlatformID is C9300-24UX")
devices, _, err = Client.Devices.GetDeviceList(getDeviceListQueryParams)
if err != nil {
fmt.Println(err)
}
if devices.Response != nil {
for id, device := range *devices.Response {
fmt.Println("GET:", id, device.ID, device.MacAddress, device.ManagementIPAddress, device.PlatformID)
}
}
```
## Documentation
### dnacenter-go-sdk/v5
[](https://pkg.go.dev/github.com/cisco-en-programmability/dnacenter-go-sdk/v6)
### dnacenter-go-sdk/v5
[](https://pkg.go.dev/github.com/cisco-en-programmability/dnacenter-go-sdk/v5)
### dnacenter-go-sdk/v4
[](https://pkg.go.dev/github.com/cisco-en-programmability/dnacenter-go-sdk/v4)
### dnacenter-go-sdk/v3
[](https://pkg.go.dev/github.com/cisco-en-programmability/dnacenter-go-sdk/v3)
### dnacenter-go-sdk/v2
[](https://pkg.go.dev/github.com/cisco-en-programmability/dnacenter-go-sdk/v2)
### dnacenter-go-sdk
[](https://pkg.go.dev/github.com/cisco-en-programmability/dnacenter-go-sdk)
## Compatibility matrix
| SDK versions | Cisco Catalyst Center version supported |
|--------------|------------------------------------|
| 0.y.z | 2.1.2 |
| 1.y.z | 2.1.2 |
| 2.y.z | 2.2.2.3 |
| 3.y.z | 2.2.3.3 |
| 4.y.z | 2.3.3.0 |
| 5.y.z | 2.3.5.3 |
| 6.y.z | 2.3.7.6 |
## Changelog
All notable changes to this project will be documented in the [CHANGELOG](https://github.com/cisco-en-programmability/dnacenter-go-sdk/blob/main/CHANGELOG.md) file.
The development team may make additional name changes as the library evolves with the Cisco Catalyst Center APIs.
## License
This library is distributed under the MIT license found in the [LICENSE](./LICENSE) file.