The Meraki Community
Register or Sign in
cancel
Turn on suggestions
Auto-suggest helps you quickly narrow down your search results by suggesting possible matches as you type.
Showing results for 
Show  only  | Search instead for 
Did you mean: 
  • About ShawnHu
ShawnHu

ShawnHu

Meraki Employee

Member since Jan 24, 2018

Thursday
Groups
  • API Early Access Group

    API Early Access Group

    598
View All
Kudos from
User Count
John-K
Meraki Employee John-K
2
PhilipDAth
Kind of a big deal PhilipDAth
12
Adrian4
Adrian4
1
MeredithW
Community Manager MeredithW
3
mikehopkins
mikehopkins
1
View All
Kudos given to
User Count
MerakiJess
Meraki Employee MerakiJess
1
Oren
Meraki Employee Oren
1
John-K
Meraki Employee John-K
10
ddexterpark
ddexterpark
1
Minyi
Meraki Employee Minyi
4
View All

Community Record

38
Posts
58
Kudos
7
Solutions

Badges

ECMS1
Meraki FIT Level One
Meraki FIT Level Two
Meraki Master
1st Birthday
5th Birthday View All
Latest Contributions by ShawnHu
  • Topics ShawnHu has Participated In
  • Latest Contributions by ShawnHu

Re: updating switch port config

by Meraki Employee ShawnHu in Developers & APIs
‎07-20-2023 04:41 AM
4 Kudos
‎07-20-2023 04:41 AM
4 Kudos
@Adrian4 Yes, you can. Action batch is designed for this.   https://developer.cisco.com/meraki/api-v1/action-batches-overview/#action-batches     ... View more

Re: Response: 400 Bad Request: "Could not auto-detect IP version for ''."

by Meraki Employee ShawnHu in Developers & APIs
‎01-04-2023 01:33 AM
3 Kudos
‎01-04-2023 01:33 AM
3 Kudos
@RandomTable1  Can you share the whole error message from the interactive API documentation? I don't see the same message in the Python library.   Also, you don't need to set every single parameter in the JSON body if you don't need to change it. I recommend you perform the GET uplink setting first and only include the parameters you want to change in the JSON body.   For example, below is a JSON body that changes the uplink WAN2 with a static IPv4 address and gateway. Other parameters will remain the same.     { "interfaces": {  "wan2": { "svis": { "ipv4": { "assignmentMode": "static", "address": "1.2.3.4/24", "gateway": "1.2.3.1", "nameservers": { "addresses": [ "1.2.3.1" ] } } } } } }     ... View more

Re: Meraki API Postman for Newbie

by Meraki Employee ShawnHu in Developers & APIs
‎12-27-2022 06:06 PM
‎12-27-2022 06:06 PM
@Cliff92I assume you meant the endpoint returned an empty list ([]), but the call was successful. Please try the following endpoints to get the client info for a specific Meraki device or a network.    https://developer.cisco.com/meraki/api-latest/#!get-device-clients https://developer.cisco.com/meraki/api-latest/#!get-network-client https://developer.cisco.com/meraki/api-latest/#!get-network-clients  --> Filters are available for querying specific clients such as wireless or online clients.   For a given network, here is an example of retrieving wireless clients for the last 2 hours connected to the network. {{baseUrl}}/networks/:networkId/clients?timespan=7200&recentDeviceConnections[]=Wireless ... View more

Re: Packet Capture via Dashboard API

by Meraki Employee ShawnHu in Developers & APIs
‎12-27-2022 05:30 PM
‎12-27-2022 05:30 PM
Unfortunately, I don't think there are any changes to this.  ... View more

Re: Webhooks for Down Alerts

by Meraki Employee ShawnHu in Developers & APIs
‎12-27-2022 12:57 AM
1 Kudo
‎12-27-2022 12:57 AM
1 Kudo
@mikehopkins   I checked my webhook alerts in history, and I can see alertType like "appliances went down/up", "switches went down/up", and "cameras went down/up". I also ran a quick verification on an appliance. Here is the alert. As you can see, the alert type is "appliances went down," while alertTypeId is "stopped_reporting". So you are right about the sample.  { "version": "0.1", "sharedSecret": "", "sentAt": "2022-12-27T08:45:16.808865Z", "organizationId": REMOVED FOR PRIVACY, "organizationName":REMOVED FOR PRIVACY, "organizationUrl":REMOVED FOR PRIVACY, "networkId":REMOVED FOR PRIVACY, "networkName":REMOVED FOR PRIVACY, "networkUrl":REMOVED FOR PRIVACY, "networkTags": [REMOVED FOR PRIVACY ], "deviceSerial":REMOVED FOR PRIVACY, "deviceMac":REMOVED FOR PRIVACY, "deviceName": "", "deviceUrl":REMOVED FOR PRIVACY, "deviceTags": [], "deviceModel": "MX65", "alertId": "646829496510174305", "alertType": "appliances went down", "alertTypeId": "stopped_reporting", "alertLevel": "critical", "occurredAt": "2022-12-27T08:40:09.000000Z", "alertData": {} }   ... View more

Re: dashboard.devices.updateDevice -> error 404

by Meraki Employee ShawnHu in Developers & APIs
‎12-25-2022 05:20 PM
1 Kudo
‎12-25-2022 05:20 PM
1 Kudo
@meilenstein  Can you confirm that the device has been added to a network already?  If yes, you should find the network ID in the result of getOrganizationInventoryDevice.  It's expected the dashboard.devices.getDevice endpoint to return 404 error if the device just sits in the inventory but not in a network.  ... View more

Re: Create/Update an organisation licensing model to "per-device" or PDL v...

by Meraki Employee ShawnHu in Developers & APIs
‎12-11-2022 04:57 PM
2 Kudos
‎12-11-2022 04:57 PM
2 Kudos
@RodHoward  Could the clone organization endpoint be a workaround in your case to create organizations using the desired licensing model? https://developer.cisco.com/meraki/api-v1/#!clone-organization ... View more

Re: Difference in Uplink API status endpoints

by Meraki Employee ShawnHu in Developers & APIs
‎12-06-2022 11:19 PM
‎12-06-2022 11:19 PM
@Techniche I verified these two endpoints on our demo environment and can confirm the document is correct.  Endpoint get-organization-appliance-uplink-statuses doesn't provide the uplink info for MG. Besides this, both endpoints return the same parameters for each MX or Z device.  ... View more

Re: API Audit

by Meraki Employee ShawnHu in Developers & APIs
‎09-14-2022 07:20 PM
3 Kudos
‎09-14-2022 07:20 PM
3 Kudos
@TroyV Since the API key is part of the administrator profile and the access permission is based on what privilege the administrator is assigned with in a specific organization. For audit purposes, there are two endpoints you can leverage. getOrganizationApiRequestsOverview  and getOrganizationApiRequests  You can use the adminId from the latter endpoint linking to a specific user(with the getOrganizationAdmins endpoint). Here is a request example from getOrganizationApiRequests. { "adminId": "212406", "method": "GET", "host": "server.example.com", "path": "/api/v1/organizations/12345/apiRequests", "queryString": "timespan=604800", "userAgent": "PostmanRuntime/7.6.0", "ts": "2018-02-11T00:00:00.090210Z", "responseCode": 200, "sourceIp": "123.123.123.1", "version": 1, "operationId": "getOrganizationApiRequests" } ... View more

Re: Organization is API Enabled but no Info Available when using [getOrgani...

by Meraki Employee ShawnHu in Developers & APIs
‎08-24-2022 06:30 PM
‎08-24-2022 06:30 PM
@Eddysanoli  Did you intentionally hide the last digits of the organization ID for privacy? Or it's was done by the ansible-playbook? I just want to clarify that  "7087539913..." with those dots in the string is not a valid organization ID. As you can retrieve 'getOrganizations', you can find the full organization ID for your target organization.  You can find an example output here. https://developer.cisco.com/meraki/api-v1/#!get-organizations ... View more

Re: Serial Number not working - 404?

by Meraki Employee ShawnHu in Developers & APIs
‎08-18-2022 11:58 PM
2 Kudos
‎08-18-2022 11:58 PM
2 Kudos
It still looks like a wrong/non-existing SN to me. To narrow down this, first, ensure you have the right network permission(which I assume you already have as you can get the organization list). Then try the below curl command to rule out any library issues.    curl -L --request GET \ --url https://api.meraki.com/api/v1/devices/[YOUR SERIAL NUMBER] \ --header 'Content-Type: application/json' \ --header 'Accept: application/json' \ --header 'X-Cisco-Meraki-API-Key: [YOUR API KEY]' ... View more

Re: Episode 82: Cloud Management Spreads its Wings

by Meraki Employee ShawnHu in Meraki Unboxed Podcast
‎07-31-2022 01:05 AM
‎07-31-2022 01:05 AM
We are also pleased to share a lately published eLearning course on this topic. Check out the below curriculum. https://learning.meraki.net/#/curricula/ee146e6c-5d90-4627-a87b-758627e388a6  Module 1: The Journey to Cloud Management for Catalyst (15 min) Module 2: Cloud Monitoring for Catalyst (20 min) Module 3: Cloud Management for Catalyst (Coming soon) ... View more

Re: Dashboard Troubleshooting with Packet Capture

by Meraki Employee ShawnHu in Dashboard & Administration
‎07-22-2022 12:53 AM
‎07-22-2022 12:53 AM
Both are valid points. So the Access privilege options are based on the target network selected. When using the network tag to scope network(s), there will be only four default privileges, given different networks might contain different device types.    You are right about no API support for port management privilege setting.  And unfortunately, the Update an Administrator  endpoint currently does not support the custom access privilege either (in your case Packet_Capture) . I bet there is some good reasons for this, but it may be worth reaching out to your Meraki sales team and submitting a feature request to evaluate.    { "errors": [ "'access' must be one of: 'full', 'read-only', 'guest-ambassador' or 'monitor-only'" ] }   ... View more

Re: Dashboard Troubleshooting with Packet Capture

by Meraki Employee ShawnHu in Dashboard & Administration
‎07-07-2022 09:23 PM
1 Kudo
‎07-07-2022 09:23 PM
1 Kudo
This will work as long as the network contains MS products and the packet capture will be enabled for the whole network not just MS. Let's say an MX+MS+MR network,  once port management privilege set as packet capture allowed and assigned to an administrator, the admin should be able to perform packet capture on all nodes in that network.   ... View more

Re: Dashboard Troubleshooting with Packet Capture

by Meraki Employee ShawnHu in Dashboard & Administration
‎07-07-2022 05:58 PM
2 Kudos
‎07-07-2022 05:58 PM
2 Kudos
Once a port management privilege is created,  you should see it in the 'Access' dropdown when assigning privilege to your SAML role. So, this should work too.  ... View more

Re: Dashboard Troubleshooting with Packet Capture

by Meraki Employee ShawnHu in Dashboard & Administration
‎07-06-2022 06:20 PM
3 Kudos
‎07-06-2022 06:20 PM
3 Kudos
@RaphaelL If you have switches in your network, may be worth exploring the 'Switch Port Management Privileges' described in the below documentation.   Be aware that the packet capture settings will apply to the entire network.   https://documentation.meraki.com/General_Administration/Managing_Dashboard_Access/Managing_Dashboard_Administrators_and_Permissions#Switch_Port_Management_Privileges   Here is my quick test: - Create a port management privilege called 'packet-capture' and select an existing switchport tag. - Assign the admin with the access privilege 'packet-capture' under the organization > administrators, just like how you assign privilege to other admins. - The administrator will have very similar visibility and control to a normal 'read-only' network admin but with additional #1 packet capture enabled for the whole network, # 2 write permission to specific switchports configured in port management privilege based on the tag you choose.   Hope this is helpful. ... View more

Re: Generate list of public IP's

by Meraki Employee ShawnHu in Developers & APIs
‎12-21-2021 05:10 PM
‎12-21-2021 05:10 PM
Hi RJ,  You are right, API needs to be toggled per organization. The bonus point is now you can activate the API by using the API.    Use the below endpoints to get your organization IDs first and then enable API on the organization level. (Replace the <key> and {organizationId} with your own values.)   curl -L -H 'X-Cisco-Meraki-API-Key:<key>' -H 'Content-Type: application/json' -X GET 'https://api.meraki.com/api/v1/organizations'   curl -L -H 'X-Cisco-Meraki-API-Key: <key>' -H 'Content-Type: application/json' -X PUT --data-binary '{"api": {"enabled": true}}' 'https://api.meraki.com/api/v1/organizations/{organizationId}' ... View more

Re: Generate list of public IP's

by Meraki Employee ShawnHu in Developers & APIs
‎12-16-2021 05:51 PM
1 Kudo
‎12-16-2021 05:51 PM
1 Kudo
Hi RJ,   Yes, you can run it against multiple organizations by using the Looper option. Here is an example to get all uplink statuses from multiple organizations.  You wouldn't have organization names but with the id you can differentiate them.      ... View more

Re: Generate list of public IP's

by Meraki Employee ShawnHu in Developers & APIs
‎12-16-2021 04:45 PM
1 Kudo
‎12-16-2021 04:45 PM
1 Kudo
You might want to check this Meraki Tools google sheet plugin. The only thing you need is an API key. https://workspace.google.com/marketplace/app/meraki_tools/11340767263  ... View more

Re: API Summary Report

by Meraki Employee ShawnHu in Developers & APIs
‎11-28-2021 04:54 PM
‎11-28-2021 04:54 PM
You can also leverage the 'Meraki Tools' to get the network appliance uplink usage and use google sheet to generate whatever chart you prefer. https://workspace.google.com/marketplace/app/meraki_tools/11340767263   ... View more

Re: Global Dashboard Search By MAC Address

by Meraki Employee ShawnHu in Developers & APIs
‎10-28-2021 07:44 AM
‎10-28-2021 07:44 AM
Maybe something is wrong with your postman request setting. Can you try CURL? curl --location --request GET 'https://api.meraki.com/api/v1/organizations/<your org id>/clients/search?mac=<your client mac>' \ --header 'X-Cisco-Meraki-API-Key: <Your API key>'   Both postman and CURL worked for me. ... View more

Re: Global Dashboard Search By MAC Address

by Meraki Employee ShawnHu in Developers & APIs
‎10-28-2021 06:22 AM
1 Kudo
‎10-28-2021 06:22 AM
1 Kudo
Hi @sfaeder    Yes, there is a new endpoint 'client search by MAC' to solve your problem.   {{baseUrl}}/organizations/:organizationId/clients/search?mac=xx:xx:xx:xx:xx:xx   Check this announcement (page 29 of the attached doc).  https://community.meraki.com/t5/Developers-APIs/Dashboard-API-Fall-2021-Feature-Announcements-What-s-new/m-p/132578#M5224  ... View more

Re: IN BETA: Link-layer network topology

by Meraki Employee ShawnHu in Developers & APIs
‎09-21-2021 08:45 PM
‎09-21-2021 08:45 PM
Just ran and it worked for me with both generic base URL and direct shard URL. Can you confirm you have signed up for the Developer Early Access Program on your target dashboard organization? You can find the link in the original post. ... View more

Re: Collection variable from Postman response to update environment

by Meraki Employee ShawnHu in Developers & APIs
‎08-18-2021 02:32 AM
‎08-18-2021 02:32 AM
@Kenneth  You can write test scripts within postman to achieve this. https://learning.postman.com/docs/writing-scripts/test-scripts/    Here is an example to iterate the organization list from getOrganizations request and set target org id to an environment variable.  (of course, you need an environment and associate it with your requests)   const jsonData = JSON.parse(responseBody); for (let i = 0; i < jsonData.length; i++ ){   if (jsonData[i]['name'] === "postman-test"){   pm.environment.set("organizationId", jsonData[i]['id']);   } } ... View more

Re: Please tell me how to solve '429 - Too many requests'.

by Meraki Employee ShawnHu in Developers & APIs
‎07-20-2021 05:46 AM
4 Kudos
‎07-20-2021 05:46 AM
4 Kudos
There is a concurrency limit of 10 concurrent requests per IP. It sounds like you are not the only one who is calling the same Meraki organization probably with a automation script.    Try to use the below endpoints to investigate.   Use 'getOrganizationApiRequestsOverview' to get an overview of API summary during a given timespan. Here is an example.   { "responseCodeCounts": { "200": 50000, "201": 4000, "204": 1000, "400": 3500, "404": 1500, "429": 10000 } }   Use 'getOrganizationApiRequests' to analyze details on what are those API calls, who is calling them from which IP.  Below is an example of the output. You might need to create a script to analyze the output as there are tens of thousands of items in case of API being misused.   [ { "adminId": "212406", "method": "GET", "host": "api.meraki.com", "path": "/api/v0/organizations/33349/apiRequests", "queryString": "timespan=604800", "userAgent": "PostmanRuntime/7.6.0", "ts": "2019-02-20T17:31:23Z", "responseCode": 200, "sourceIp": "123.123.123.1" } ]   Once you identify the suspect admin ID, use 'getOrganizationAdmins' to get the email identity.     ... View more
Kudos from
User Count
John-K
Meraki Employee John-K
2
PhilipDAth
Kind of a big deal PhilipDAth
12
Adrian4
Adrian4
1
MeredithW
Community Manager MeredithW
3
mikehopkins
mikehopkins
1
View All
Kudos given to
User Count
MerakiJess
Meraki Employee MerakiJess
1
Oren
Meraki Employee Oren
1
John-K
Meraki Employee John-K
10
ddexterpark
ddexterpark
1
Minyi
Meraki Employee Minyi
4
View All
My Accepted Solutions
Subject Views Posted

Re: updating switch port config

Developers & APIs
315 ‎07-20-2023 04:41 AM

Re: dashboard.devices.updateDevice -> error 404

Developers & APIs
684 ‎12-25-2022 05:20 PM

Re: Serial Number not working - 404?

Developers & APIs
497 ‎08-18-2022 11:58 PM

Re: Dashboard Troubleshooting with Packet Capture

Dashboard & Administration
2907 ‎07-06-2022 06:20 PM

Re: Global Dashboard Search By MAC Address

Developers & APIs
4814 ‎10-28-2021 06:22 AM

Re: Please tell me how to solve '429 - Too many requests'.

Developers & APIs
5130 ‎07-20-2021 05:46 AM
View All
My Top Kudoed Posts
Subject Kudos Views

Re: updating switch port config

Developers & APIs
4 315

Re: Please tell me how to solve '429 - Too many requests'.

Developers & APIs
4 5130

Re: Response: 400 Bad Request: "Could not auto-detect IP version for ''."

Developers & APIs
3 245

Re: API Audit

Developers & APIs
3 451

Re: Dashboard Troubleshooting with Packet Capture

Dashboard & Administration
3 2907
View All
Powered by Khoros
custom.footer.
  • Community Guidelines
  • Cisco Privacy
  • Khoros Privacy
  • Cookies
  • Terms of Use
© 2023 Meraki