In our example, we want to set the values that are found in Your Manual Tag. Specifies which column in the sheet contains the values we want to set on the matched rows in vScope.Since those values are names of the machines, we want to use the Name tag for matching. Specifies which tag in the Excel sheet that should be used to match the values in matchColumn.In our example, we want to map the rows using the values in the Name column. Specifies which column in the excel sheet that contains the values we want to use to match rows to rows in vScope.In our example, we want to tag All Machines (see article’s second picture). Determines the resource we want as source for the rows we want to tag.The “ &” acts as a separator between the query parameters, and “ %20” means space. Each parameter we need to define has been highlighted with a color in the image. It may look overwhelming at first, but we’ll break it down below. To do this we simply add the information to the request URL in Postman. Without specifying what we want to do with the query string, vScope won’t know what to do with the information in the excel file.
Step 5 – Specify information you want added to vScope We’ve highlighted what this looks like for us in the image below. This will tell vScope that Postman is allowed to post this. Next we add the API token by adding a query string parameter. Enter the address to your vScope, it might look something like this and add /rest/action/bulktag/xlsx. We start off by creating the request (building an URL). In this case we’ll be able to use the token for 3 days.Ĭlick ‘Add token’, and done! We now have a token we can use in Postman.īehind the popup you should see an empty project like the image below. Go to vScope -> Settings -> API tokens -> +Add tokenĬhoose a user that is allowed to access the resource you wish to add information to, and choose how many days the token will be active. This token will tell vScope that Postman is allowed to make changes. To import the manual tag to vScope we’ll need an API token for Postman. The most important thing in this step is that the XLSX file contains the server names and the tag you wish to import. Open the excel file in Excel and add the tag you want to import to vScope. Take note of the resource type in the top left corner. If you don’t already have an xlsx file prepared you can export a XLSX document with the server names from vScope. In this example we will import the tag ‘Your Manual Tag” for our servers. Make sure your computer have access vScope so that Postman can connect to vScope’s open API. Start off by downloading and installing Postman.
Postman is free to use and makes API requests simpler.
Here’s a step by step how-to to how to use vScope’s open API using Postman. Sometimes API requests are needed for specific tasks, for example importing manual tags and their values, or importing IP targets. If you are not experienced using rest API’s it’s recommended to ask for help from a colleague who is. Using vScope’s API is an advanced level of vScope and is usually not necessary.