Process to migrate to v1

Keelyn
Conversationalist

Process to migrate to v1

I am working with a customer to migrate to v1 and I cannot find the exact process to do so. Can anyone please help me out with the exact steps I need to take?

7 Replies 7
alemabrahao
Kind of a big deal
Kind of a big deal

Take  look at this.

 

Network Reformation with Cisco Meraki Dashboard API

I am not a Cisco Meraki employee. My suggestions are based on documentation of Meraki best practices and day-to-day experience.

Please, if this post was useful, leave your kudos and mark it as solved.
KH
Meraki Employee
Meraki Employee

You can also see the new calls in this path changes article

Keelyn
Conversationalist

Thanks for the links! So I think I got it but I am running into an issue with my path and operationID. Here is an example of the output I am seeing.

 

"adminId": "XXXXXXXX",
"method": "GET",
"host": "n532.meraki.com",
"path": "/api/v0/organizations/XXXXXX/licenseState",
"queryString": "",
"userAgent": "Java/11.0.18",
"ts": "2024-01-29T19:41:29.015935Z",
"responseCode": 200,
"sourceIp": "X.X.X.X",
"version": 0,
"operationId": "getOrganizationLicenseState"

That appears to be a version 0 request. You should only be using v1 calls.

 

https://developer.cisco.com/meraki/api-v1/get-organization-licenses-overview/

sungod
Head in the Cloud

As @PhilipDAth says you need to look at the details for all the endpoints you are using, even if the name/parameters are the same, do not just assume it works exactly the same, the v1 responses can be far richer (and continue to evolve).

 

The link @KH posted is probably the best way to speed up identifying the v0-v1 mapping.

 

Then use the respective endpoint pages to compare v0 with v1...

https://developer.cisco.com/meraki/api-v0/overview/

https://developer.cisco.com/meraki/api-v1/overview/

 

 

With v1 there are many more endpoints, in particular there may be v1 ways to get org-wide info that would have required iterating over networks in v0. I would take some time to look at the full set of v1 endpoints and see what opportunity there is to improve rather than simply replicate a v0 approach in v1.

 

You don't mention what environment your customer is using, the Meraki Python library is good, it handles a lot of the low-level work for you and tracks API updates pretty closely...

https://github.com/meraki/dashboard-api-python/blob/main/README.md

 

Also there's the official Ansible collection...

https://blogs.cisco.com/developer/merakiansiblecollectio01

 

PhilipDAth
Kind of a big deal
Kind of a big deal

You'll need to search for the replacement function here:
https://developer.cisco.com/meraki/api-v1/ 

And then change to using that (and you may need to change the parameters as well).

Keelyn
Conversationalist

Thank you everyone for the responses! I think I got this one figured out.

Get notified when there are additional replies to this discussion.
Welcome to the Meraki Community!
To start contributing, simply sign in with your Cisco account. If you don't yet have a Cisco account, you can sign up.