v2.0.0

linodego v2

linodego v2 is the next major version of the Go client for the Linode API. This release removes long-standing compatibility shims, adopts a Go major-version module path, and modernizes the client internals by replacing the Resty-based transport layer with a net/http implementation.

Full migration guide: https://github.com/linode/linodego/blob/main/docs/linode_v2_migration_guide.md

Highlights

• Go module import path updated to /v2
• NewClient now returns (Client, error)
• Client internals migrated from Resty to net/http
• Older preview/temporary V2 compatibility APIs consolidated back into the original non-V2 names
• Firewall APIs cleaned up with endpoint-specific rule models
• Object Storage APIs standardized around regions instead of clusters
• Bucket access APIs now use the newer access shape directly
• Region capability constants are now strongly typed
• Many request/update APIs now use typed options structs
• Legacy aliases and compatibility types removed

Breaking changes at a glance

• Update imports to:
  • github.com/linode/linodego/v2
• Handle errors from NewClient
• Replace removed deprecated APIs and aliases
• Replace removed preview/temporary V2 compatibility APIs with the original non-V2 names
• Update firewall code to the new endpoint-specific rule types
• Update Object Storage code to region-based APIs
• Update any code that depended on Resty request/response hooks
• Expect some request/response type cleanup, including stronger typing and less pointer-heavy models

Other Changes

🚀 New Features

• Support NodeBalancer lke_cluster field by @jbilskiAkam in #933
• add locks field to various resources by @zliang-akamai in #942
• Updating Go sdk to include group_by at dashboard level by @mawasthy-lgtm in #979

🧪 Testing Improvements

• Upgrade test image linode/alpine3.19 to new version and regenerate fixture files by @psnoch-akamai in #952

⚙️ Repo/CI Improvements

• Add AGENTS.md by @zliang-akamai in #981

📖 Documentation

• add migration guide for linodego v2 by @zliang-akamai in #984

📦 Dependency Updates

• build(deps): bump actions/dependency-review-action from 4 to 5 by @dependabot[bot] in #962
• build(deps): bump golang.org/x/net from 0.54.0 to 0.55.0 by @dependabot[bot] in #977
• build(deps): bump k8s.io/client-go from 0.29.4 to 0.35.5 by @dependabot[bot] in #965

New Contributors

• @jbilskiAkam made their first contribution in #933
• @mawasthy-lgtm made their first contribution in #979

Full Changelog: v1.69.1...v2.0.0