topic Re: Process to migrate to v1 in Network Platform API

Process to migrate to v1

KeelynHenning0941 — Mon, 29 Jan 2024 16:24:45 GMT

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?

Re: Process to migrate to v1

aleabrahao — Mon, 29 Jan 2024 16:29:35 GMT

Take look at this.

Network Reformation with Cisco Meraki Dashboard API

Re: Process to migrate to v1

KH6 — Mon, 29 Jan 2024 16:38:19 GMT

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

Re: Process to migrate to v1

KeelynHenning0941 — Mon, 29 Jan 2024 22:57:06 GMT

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"

Re: Process to migrate to v1

Ryan_Miles — Mon, 29 Jan 2024 23:56:56 GMT

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/

Re: Process to migrate to v1

Philip D'Ath — Tue, 30 Jan 2024 22:54:45 GMT

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).

Re: Process to migrate to v1

sungod — Wed, 31 Jan 2024 10:03:53 GMT

As @Philip D'Ath 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 @KH6 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

Re: Process to migrate to v1

KeelynHenning0941 — Thu, 01 Feb 2024 16:03:53 GMT

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