Ask our Experts
Didn't find what you are looking for? Ask our experts!
Subscribing is a smart move!
You can subscribe to this board after you log in or create your free account.
Invite a Co-worker
Send a co-worker an invite to the portal.Just enter their email address and we'll connect them to register. After joining, they will belong to the same company.
Send Invite Cancel
Recommended Forums
Link copied. Please paste this link to share this article on your social media post.
Link copied. Please paste this link to share this article on your social media post.
Hello @MarcoPer1985
I'll add some comments in addition to the comments you've received already.
As mentioned already, ITA (both on-premise and hosted/SaaS) offers rest based apis. The endpoints themselves are documented view the api page itself on the ITA server when you access this URL: https://<server IP>/api/current/docs/index.html
(the URL will ask you for ITA user credentials
Access to the API's is based on the ITA user used to access / authenticate. So if you authenticate with an administrator level user, the user can make administrator level api calls. If you create a readonly ITA user, then that user will have readonly access. Note, api access is also limited to the rooms/equipment the user is granted.
When connected and authenticated to the api page you will see information for all of the endpoints. I pasted a portion of the assets endpoints below.
You can expand each endpoint call to see the details, and use the UI to test them to see results by clicking the "Try it out" button. Please note when "trying" the api calls you are making actual api calls to your ITA server so if you try deleting assets, you're actually deleting assets.
You asked whether the below data is present in the API's:
* Assets / devices -- yes, in the assets endpoints I pasted above
* Rooms and racks -- yes, also in the assets endpoints I pasted above
* Capacity and power data -- yes, if you are looking for current and historical capacity data, look for the KPI endpoints
* Measurements and inventory information -- This information may be more limited as of now, depending on what data you're looking for. Can you share an example? In most cases measurement data itself comes from another system like Data Center Expert or IT Expert, and the raw data would come from those systems via API calls. But if you're looking for something else, it may be present in ITA's api's.
I'll provide a few comments below to guide you regarding collecting room and inventory data via the API's.
* Asset data in ITA is stored with uuid's as the asset unique id's. All assets including rooms and room assets have uuid's.
* The "GET /assets" endpoint I pasted above is usually the first/initial call made to an ITA server. Based on the ITA user used for authentication, this command will return all the rooms and location information the user has access to. I recommend you use the "recursive=true" parameter on this command to get the parent location and all its children room and locations.
* Once you have your room and locations list, you can programmatically extract each room uuid then use the "GET /asset/{asset-id}" call using the room uuid as the "asset-id" and use the "children" parameter to get all of the room floor mounted assets (including racks).
* Then you can loop again for all the racks in the room to make the same GET by asset id call using the rack uuid's as the asset-id with the children parameter to fetch all the rack content.
There are other parameters you'll see defined on some of the api endpoint pages which allow you to fetch specific data when fetching inventory, like for example if you want tags or custom properties returned in the output.
Hope this helps.
Regards
Greg Sterling
You’ve reached the end of your document
Create your free account or log in to subscribe to the board - and gain access to more than 10,000+ support articles along with insights from experts and peers.