Meraki

CBurkhead · ‎Oct 18 2024

For the purposes of this application, offline vs. dormant is not relevant. We have customers that are not always quick to allow the repair/replacement of devices at their sites, so there are devices that stay offline for long period of time. We keep track of these on a dashboard that refreshes periodically. This dashboard is also used to monitor more current offline devices as well. Yes, if any of these older devices come online, we will get the normal Meraki email, but we want some backup as well. I would like to be able to avoid having to save datetime data to a file if there is another source for the "last seen" information, but if this is no longer going to be available though the API past a month's time, I will do what I need to do.

CBurkhead · ‎Oct 18 2024

From looking at these new endpoints, it seems clear that trying to get some status information for a device that has been offline for more than a month will not be possible. You can get the information that it is offline, but not when it went offline. The last seen datetime that is in the current organization status endpoint is not in getOrganizationDevicesAvailabilities and though you can get this from the offline data returned by getOrganizationDevicesAvailabilitiesChangeHistory, you can't retrieve data more than a month old with that endpoint. Does anyone know where/how to get the datetime a device was last seen for a device that does not involve getOrganizationDevicesStatuses?

CBurkhead · ‎Feb 29 2024

You can use Wing IDE Personal, too. It is also free.

CBurkhead · ‎Jul 12 2023

I think that should be just what I need. Thanks!

CBurkhead · ‎Jul 12 2023

I think I already know the answer to this question, but I wanted to check to make sure I was not missing anything. Is there an endpoint that will provide the messages that appear in the dashboard under the name of a device that is in an alerting status? Messages like "Radar event pattern detected across 2 channels" and "DNS is misconfigured". I know that for the radar messages you can get information on them in the event log, but I don't think that is possible with other messages, or it would be hard to track them down. I have looked in the device status endpoints as well as the device endpoints and did not find anything. I was hoping to find this so that information can be added to a status app I wrote so I don't have to go into the dashboard just to see why a device is alerting.

CBurkhead · ‎May 12 2023

I know I read that description multiple times and I missed where it said bytes. Must need more coffee...or maybe less coffee. Thanks for the info on the schema. That will be very useful for the future.

CBurkhead · ‎May 12 2023

I am working with data from the /networks/{networkId}/appliance/uplinks/usageHistory and /networks/{networkId}/appliance/trafficShaping/uplinkBandwidth endpoints. The question I have is what units this data is in? The usage values for the sent and received data seems to be bytes based on what I am seeing. The bandwidth limitUp and limlitDown values I think are in Kbps based on the values I am getting and what I know about the connections to the appliances. Does anyone know for certain? Is there somewhere I can look that has the data definition for the endpoints that includes units for data when it is not obvious? Thanks!

CBurkhead · ‎Mar 20 2023

I talked with Meraki some on Friday and they didn't have any real suggestions/solutions. I did create a new account with API access to the the two organizations I was having issues with. They both worked with the new account. I was going to change the API key for my main account, but on Saturday it was working fine for all organizations with the original key. I am thinking this was some sort of backend problem in the API.

CBurkhead · ‎Mar 17 2023

I have submitted a case to Meraki.

CBurkhead · ‎Mar 17 2023

Perhaps. But what does an account password have to do with an API key? And, if it was the password for the account with this key, shouldn't this error be coming up for every organization, since the same API key is being used for all of them?

CBurkhead · ‎Mar 17 2023

Yes. As I said this API key accesses all of the other organizations we administer and has worked with both of these organizations for months. I was even using it to access the first organization I saw this error with yesterday morning with no issues.

CBurkhead · ‎Mar 17 2023

I started getting this error yesterday when trying to access data for one organization. Since then I have found another that does the same thing. This seems to be occurring as soon as I try to access data in the specific organization. I did some testing and got the error trying to access the /organizations/{OrgID}/networks and /organizations/{OrgID}/devices/statuses endpoints. I would imagine that it would happen with any endpoint that tried to access data in the organization. Has anyone else seen this? It is only happening with 2 organizations and the scripts access 50+ others with no issues. All of the scripts are using the same API key and that account has access to all of the organizations we administer. As I said this just started yesterday and both of these organizations have been accessible via API for months with no problems.

CBurkhead · ‎Sep 12 2021

That is helpful to know and the error is pretty much the same, but those postings are from 5 years ago. I have been running the current version of requests since it was released 2 months ago, and did not run into this problem until just last week. I also tried installing the the previous version of requests to see if it made a difference and it did not. One of the packages that they recommend installing, PyOpenSSL is not even supported by requests anymore. I did check my version of OpenSSL, and upgraded that to the latest version, but that did not help, either. My other searches for errors like this haven't given me anything more recent than 2019. I have gotten around the problem by changing my exception handling and doing retries on the request if this exception is thrown. That is working at present and is allowing my scripts to run normally. I will continue to try and figure this out, but for now the main issue has been taken care of. Thanks for all of the help!

CBurkhead · ‎Sep 12 2021

There is not actual HTTP status code being returned. This is a thrown exception during the API call, so the variable receiving the data does not even exist when looking in the debugger since it is being created with the call to the requests library. The following are the messages that come back from the exception. Both are from the same script on different runs. As you can see from the messages, the exception is on different API calls, but overall is the same error. HTTPSConnectionPool(host='api.meraki.com', port=443): Max retries exceeded with url: /api/v1/organizations/582090251837636617/inventoryDevices?perPage=1000 (Caused by SSLError(SSLEOFError(8, 'EOF occurred in violation of protocol (_ssl.c:1129)'))) HTTPSConnectionPool(host='api.meraki.com', port=443): Max retries exceeded with url: /api/v1/organizations (Caused by SSLError(SSLEOFError(8, 'EOF occurred in violation of protocol (_ssl.c:1129)')))

CBurkhead · ‎Sep 11 2021

Since early yesterday (9/10), I have been seeing many of my scripts getting Connection error exceptions thrown (requests.exceptions.ConnectionError) when trying to access endpoints. These are Python scripts using the requests library, not the SDK. This has been very random. Sometimes they will error immediately when trying to get the organization list, or whatever the first endpoint call is. Sometimes they will start and then errors will occur during the run through the rest of the script execution. Sometimes they will start erroring during execution for a few calls and then start working again, executing the same calls that were thrown the exception. Sometimes they work just fine. I am accessing the API via api.meraki.com and my header is: {'X-Cisco-Meraki-API-Key':apikey, 'Accept':'application/json', 'Content-Type':'application/json'} Has anyone been seeing anything similar? Is there another URL I should be using, besides api.meraki.com?

CBurkhead · ‎May 5 2020

You will need the "rules" in your payload for this to work, I am surprised you got the 200 without it being in there. The only thought I had was what your headers value is? I know, particularly on a PUT or POST, if the header is wrong sometimes you will get return codes that look good, but nothing actually happens or something weird happens. Make sure that your header for the PUT contains your API key and {'Content-Type':'application/json'}. You don't need the content type when doing a GET, but I have found you have to have it for a PUT or POST.

CBurkhead · ‎Mar 12 2020

Checked for the privacy setting and I don't have it. Since I am in the US, it does not sound like I should. Thanks for the link regarding the security log retention. I will check that out. Based on my own testing, it looks like the maximum number of days I can go back is about 36. Thanks for the quick response, @BrechtSchamp!

CBurkhead · ‎Mar 12 2020

I am trying to pull security events for the past 6 months for a customer. I am using GET /networks/{networkId}/securityEvents and am specifying the timespan to be 183*86400 seconds. The documentation says that the default timespan is 31 days and you can go back as far as 365 days. However, I am only getting data as far back as 2/5/20. If I remove the timespan parameter, I get the same time period. Has anyone tried to get data more than about a month old for security events? Based on my data today, it looks like the maximum you can get is about 35 days.

CBurkhead · ‎Feb 17 2020

Not a problem. I had to deal with the same thing getting date information for security events.

CBurkhead · ‎Feb 17 2020

Like many of the datetime values returned by the API, it is a Unix time (# of seconds since 1/1/1970). It will also be in UTC, so if you need local time, you will need to convert it. I would imaging there is a datetime conversion in C# that will take this and convert it to a normal value that you can then manipulate.

CBurkhead · ‎Dec 16 2019

You should be able to use GET /organizations/{organizationId}/deviceStatuses to retrieve the status of the devices in an organization. Anything that is not "offline" should be accessible.

CBurkhead · ‎Nov 6 2019

I can't speak to that code and what it is doing, but I am able to create a new network in an organization using the /organizations/{organizationId}/networks endpoint without specifying a network ID to copy from or a value for disableRemoteStatusPage. The basics of this code is the following: import requests import json header = {'X-Cisco-Meraki-API-Key': myAPIkey} header.update({'Content-Type':'application/json'}) orgId = '9876543210' url = 'https://api.meraki.com/api/v0/organizations/'+orgId+'/networks' payload = {'name':'Test Network','type':'appliance','timeZone':'US/Eastern'} response = requests.request('POST', url, data=json.dumps(payload), headers=header) This code returns a code of 201 and the network does get created. If I had to guess what the problem is for the supplied code, I would say that create_organization_network.copy_from_network_id needs some kind of value. If you don't want to supply a network ID, try assigning a value of None to it.

CBurkhead · ‎Oct 31 2019

A couple of notes, the ErrorCheck function that gets called is my internal function that converts the returned data to JSON and verifies there are no errors. It returns the data from the endpoint or a value of None. Also, I have had to modify this function a couple of times depending on the data that the endpoint is returning. It was originally made for getting client data, which was just lists of data. You might have to alter how the data is appended if you are getting a dictionary with lists in it or some other format. It does work as written for networks/{networkID}/clients.

CBurkhead · ‎Oct 31 2019

Here is the Python function for doing this. # This function takes the API URL and query string. It returns all of the JSON data from the API request that has # been broken up into pages of data. def GetPages(url,query): data = [] done = False while done == False: try: ret = requests.request('GET', url, headers=g_header, params=query) except requests.exceptions.ConnectionError: print('A connection error has occurred while getting the page information.\n') return None # Append the new data to the existing. data += ErrorCheck(ret) # Get the page URLs from the HTTP header of the API call and split it into the URLs. pages = ret.headers['Link'].split(',') # See if there is a page for the 'next' page of data. page = next((i for i in pages if 'rel=next' in i), None) if page != None: # Isolate the token and then add it to the new query. token = page.split('startingAfter=')[1] token = token.split('&')[0] query['startingAfter'] = token else: done = True return data The call to this would be something like: clientlist = GetPages(url,querystring) Where url is the full URL to the endpoint and querystring would be the parameters you want, like {'timespan':'30','perPage':'1000'}

CBurkhead · ‎Oct 31 2019

That is the same error I have been seeing using a different endpoint (/networks/{networkId}/events) for the includedEventTypes parameter. No matter how I specify the data, I am told that that it must be an array. Hopefully, the answer for this problem will be the same for this other endpoint.

About CBurkhead

CBurkhead

Community Record

Badges