Skip to content

Commit 110e0de

Browse files
authored
Merge pull request #90 from cisco-en-programmability/develop
Develop v6.0.0
2 parents e8aec13 + dd1d508 commit 110e0de

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

68 files changed

+32435
-8591
lines changed

.github/ISSUE_TEMPLATE/bug_report.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ A clear and concise description of what you expected to happen.
2222
Please provide an screenshot of the successful API call with cuRL, Postman, etc.
2323

2424
**Environment (please complete the following information):**
25-
* Cisco DNA Center Version and patch:
25+
* Cisco Catalyst Center Version and patch:
2626
* Go Version:
2727
* SDK version:
2828
* OS Version:

CHANGELOG.md

Lines changed: 17 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
66

77
## [Unreleased]
88

9+
## [6.0.0] - 2024-11-14
10+
11+
### Added
12+
New services for Cisco Catalyst Center 2.3.7.6's API:
13+
- CiscoTrustedCertificates *CiscoTrustedCertificatesService
14+
- AIEndpointAnalytics *AIEndpointAnalyticsService
15+
916
## [5.0.32] - 2024-08-06
1017
### Added
1118
- Set User-Agent header in API client
@@ -24,6 +31,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
2431
## [5.0.28] - 2024-06-04
2532
- `TopOfStackSerialNumber` and `CablingScheme` added to `RequestDeviceOnboardingPnpClaimADeviceToASite`
2633
- Fix `ResponseItemWirelessGetWirelessProfileProfileDetailsSSIDDetails` to support empty string
34+
35+
### Note
36+
- SDK now compatible with Cisco Catalyst Center 2.3.7.6's API.
2737

2838
## [5.0.27] - 2024-04-22
2939
- Function `GetTemplatesDetails` change response struct from an object to an array objects.
@@ -161,7 +171,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
161171

162172
## [5.0.0] - 2023-04-12
163173
### Added
164-
- New services for Cisco DNA Center 2.3.5.3's API:
174+
- New services for Cisco Catalyst Center 2.3.5.3's API:
165175
- AuthenticationManagement *AuthenticationManagementService
166176
- DisasterRecovery *DisasterRecoveryService
167177
- EoX *EoXService
@@ -202,7 +212,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
202212
- WirelessService.RebootAccessPoints
203213
- WirelessService.ConfigureAccessPoints
204214

205-
- The SDK was updated with the official DNA Center API 2.3.5.3 documentation, therefore some structures or data types may have changed.[Oficial Documentation](https://developer.cisco.com/docs/dna-center/#!cisco-dna-center-2-3-5-api-overview).
215+
- The SDK was updated with the official Catalyst Center API 2.3.5.3 documentation, therefore some structures or data types may have changed.[Oficial Documentation](https://developer.cisco.com/docs/dna-center/#!cisco-dna-center-2-3-5-api-overview).
206216

207217

208218

@@ -269,19 +279,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
269279
## [4.0.0] - 2022-06-16
270280

271281
### Added
272-
New services for Cisco DNA Center 2.3.3.0's API:
282+
New services for Cisco Catalyst Center 2.3.3.0's API:
273283
- CiscoDnaCenterSystem *CiscoDnaCenterSystemService
274284
- LanAutomation *LanAutomationService
275285
- SystemSettings *SystemSettingsService
276286

277287
### Removed
278-
Services removed on Cisco DNA Center 2.3.3.0's API:
288+
Services removed on Cisco Catalyst Center 2.3.3.0's API:
279289
- AuthenticationManagement *AuthenticationManagementService
280290
- DisasterRecovery *DisasterRecoveryService
281291
- Policy *PolicyService
282292

283293
### Changed
284-
- SDK now compatible with Cisco DNA Center 2.3.3.0's API.
294+
- SDK now compatible with Cisco Catalyst Center 2.3.3.0's API.
285295

286296
## [3.6.3] - 2022-03-17
287297
### Changed
@@ -647,4 +657,5 @@ Services removed on Cisco DNA Center 2.3.3.0's API:
647657
[5.0.30]: https://github.com/cisco-en-programmability/dnacenter-go-sdk/compare/v5.0.29...v5.0.30
648658
[5.0.31]: https://github.com/cisco-en-programmability/dnacenter-go-sdk/compare/v5.0.30...v5.0.31
649659
[5.0.32]: https://github.com/cisco-en-programmability/dnacenter-go-sdk/compare/v5.0.31...v5.0.32
650-
[Unreleased]: https://github.com/cisco-en-programmability/dnacenter-go-sdk/compare/v5.0.32...main
660+
[6.0.0]: https://github.com/cisco-en-programmability/dnacenter-go-sdk/compare/v5.0.27...v6.0.0
661+
[Unreleased]: https://github.com/cisco-en-programmability/dnacenter-go-sdk/compare/v6.0.0...main

README.md

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
# dnacenter-go-sdk
22

3-
dnacenter-go-sdk is a Go client library for [DNA Center Platform](https://developer.cisco.com/dnacenter/).
3+
dnacenter-go-sdk is a Go client library for [Catalyst Center Platform](https://developer.cisco.com/dnacenter/).
44

55
## Usage
66

77
```go
8-
import dnac "github.com/cisco-en-programmability/dnacenter-go-sdk/v5/sdk"
8+
import dnac "github.com/cisco-en-programmability/dnacenter-go-sdk/v6/sdk"
99
```
1010

1111
## Introduction
1212

13-
The dnacenter-go-sdk makes it easier to work with the Cisco DNA Center Platform RESTFul APIs from Go.
13+
The dnacenter-go-sdk makes it easier to work with the Cisco Catalyst Center Platform RESTFul APIs from Go.
1414

1515
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.
1616

@@ -25,7 +25,7 @@ The first think you need to do is to generate an API client. There are two optio
2525

2626
The client could be generated with the following parameters:
2727

28-
- `baseURL`: The base URL, FQDN or IP, of the DNA instance.
28+
- `baseURL`: The base URL, FQDN or IP, of the Catalyst Center instance.
2929
- `username`: The username for the API authentication and authorization.
3030
- `password`: The password for the API authentication and authorization.
3131
- `debug`: Boolean to enable debugging
@@ -43,7 +43,7 @@ devicesCount, _, err := Client.Devices.GetDeviceCount()
4343

4444
The client can be configured with the following environment variables:
4545

46-
- `DNAC_BASE_URL`: The base URL, FQDN or IP, of the DNA instance.
46+
- `DNAC_BASE_URL`: The base URL, FQDN or IP, of the Catalyst Center instance.
4747
- `DNAC_USERNAME`: The username for the API authentication and authorization.
4848
- `DNAC_PASSWORD`: The password for the API authentication and authorization.
4949
- `DNAC_DEBUG`: Boolean to enable debugging
@@ -85,6 +85,8 @@ if devices.Response != nil {
8585

8686
## Documentation
8787
### dnacenter-go-sdk/v5
88+
[![PkgGoDev](https://pkg.go.dev/badge/github.com/)](https://pkg.go.dev/github.com/cisco-en-programmability/dnacenter-go-sdk/v6)
89+
### dnacenter-go-sdk/v5
8890
[![PkgGoDev](https://pkg.go.dev/badge/github.com/)](https://pkg.go.dev/github.com/cisco-en-programmability/dnacenter-go-sdk/v5)
8991
### dnacenter-go-sdk/v4
9092
[![PkgGoDev](https://pkg.go.dev/badge/github.com/)](https://pkg.go.dev/github.com/cisco-en-programmability/dnacenter-go-sdk/v4)
@@ -96,20 +98,21 @@ if devices.Response != nil {
9698
[![PkgGoDev](https://pkg.go.dev/badge/github.com/)](https://pkg.go.dev/github.com/cisco-en-programmability/dnacenter-go-sdk)
9799
## Compatibility matrix
98100

99-
| SDK versions | Cisco DNA Center version supported |
101+
| SDK versions | Cisco Catalyst Center version supported |
100102
|--------------|------------------------------------|
101103
| 0.y.z | 2.1.2 |
102104
| 1.y.z | 2.1.2 |
103105
| 2.y.z | 2.2.2.3 |
104106
| 3.y.z | 2.2.3.3 |
105107
| 4.y.z | 2.3.3.0 |
106108
| 5.y.z | 2.3.5.3 |
109+
| 6.y.z | 2.3.7.6 |
107110

108111
## Changelog
109112

110113
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.
111114

112-
The development team may make additional name changes as the library evolves with the Cisco DNA Center APIs.
115+
The development team may make additional name changes as the library evolves with the Cisco Catalyst Center APIs.
113116

114117

115118
## License

examples/application-policy/main.go

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,10 @@ package main
33
import (
44
"fmt"
55

6-
dnac "github.com/cisco-en-programmability/dnacenter-go-sdk/v5/sdk"
6+
dnac "github.com/cisco-en-programmability/dnacenter-go-sdk/v6/sdk"
77
)
88

9-
// Client is DNA Center API client
9+
// Client is Catalyst Center API client
1010
var client *dnac.Client
1111

1212
func main() {

examples/applications/main.go

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,10 @@ package main
33
import (
44
"fmt"
55

6-
dnac "github.com/cisco-en-programmability/dnacenter-go-sdk/v5/sdk"
6+
dnac "github.com/cisco-en-programmability/dnacenter-go-sdk/v6/sdk"
77
)
88

9-
// Client is DNA Center API client
9+
// Client is Catalyst Center API client
1010
var client *dnac.Client
1111

1212
func main() {

examples/clients/main.go

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,10 @@ package main
33
import (
44
"fmt"
55

6-
dnac "github.com/cisco-en-programmability/dnacenter-go-sdk/v5/sdk"
6+
dnac "github.com/cisco-en-programmability/dnacenter-go-sdk/v6/sdk"
77
)
88

9-
// Client is DNA Center API client
9+
// Client is Catalyst Center API client
1010
var client *dnac.Client
1111

1212
func main() {

examples/command-runner/main.go

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,10 +5,10 @@ import (
55
"fmt"
66
"time"
77

8-
dnac "github.com/cisco-en-programmability/dnacenter-go-sdk/v5/sdk"
8+
dnac "github.com/cisco-en-programmability/dnacenter-go-sdk/v6/sdk"
99
)
1010

11-
// client is DNA Center API client
11+
// client is Catalyst Center API client
1212
var client *dnac.Client
1313

1414
func main() {

examples/compliance/main.go

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,10 @@ package main
33
import (
44
"fmt"
55

6-
dnac "github.com/cisco-en-programmability/dnacenter-go-sdk/v5/sdk"
6+
dnac "github.com/cisco-en-programmability/dnacenter-go-sdk/v6/sdk"
77
)
88

9-
// client is DNA Center API client
9+
// client is Catalyst Center API client
1010
var client *dnac.Client
1111

1212
func main() {

examples/configuration_archive/main.go

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,10 @@ package main
33
import (
44
"fmt"
55

6-
dnac "github.com/cisco-en-programmability/dnacenter-go-sdk/v5/sdk"
6+
dnac "github.com/cisco-en-programmability/dnacenter-go-sdk/v6/sdk"
77
)
88

9-
// client is DNA Center API client
9+
// client is Catalyst Center API client
1010
var client *dnac.Client
1111

1212
func main() {
@@ -39,7 +39,7 @@ func main() {
3939

4040
fmt.Println("Post ConfArchive")
4141
reqBody := &dnac.RequestConfigurationArchiveExportDeviceConfigurations{
42-
DeviceID: []string{deviceUUID},
42+
DeviceID: deviceUUID,
4343
Password: "C1sco123!",
4444
}
4545

examples/configuration_templates/main.go

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,10 @@ import (
44
"encoding/json"
55
"fmt"
66

7-
dnac "github.com/cisco-en-programmability/dnacenter-go-sdk/v5/sdk"
7+
dnac "github.com/cisco-en-programmability/dnacenter-go-sdk/v6/sdk"
88
)
99

10-
// client is DNA Center API client
10+
// client is Catalyst Center API client
1111
var client *dnac.Client
1212

1313
func responseInterfaceToString(v interface{}) string {
@@ -93,7 +93,7 @@ func main() {
9393
// return
9494
// }
9595

96-
resp, _, err := client.ConfigurationTemplates.GetProjectsDetails(&dnac.GetProjectsDetailsQueryParams{
96+
resp, _, err := client.ConfigurationTemplates.GetProjectsDetailsV2(&dnac.GetProjectsDetailsV2QueryParams{
9797
Name: "Onboarding Configuration",
9898
})
9999

0 commit comments

Comments
 (0)