Community
- Command Central
- MVP Program
- Monthly Mission
- Blogs
- Groups
- Events
- Media Vault
Products
- Observability
- Network Management
- Application Management
- IT Security
- IT Service Management
- System Management
- Database Management
Content Exchange
- SolarWinds Platform
- Server & Application Monitor
- Database Performance Analyzer
- Server Configuration Monitor
- Network Performance Monitor
- Network Configuration Manager
- SQL Sentry
- Web Help Desk
Free Tools & Trials

Create an Subnet under an existing Group using the RESTful API approach

raymond.chan.hk

Hi all,

I am looking for a way to create a new IPAM.Subnet, 192.168.3.0 /28, to an existing Group using the RESTful API approach. I have visited the Orion SDK Swagger Doc and learned that there is an endpoint, /CreateSubnetForGroup, to do so. Also, I have created a new Group, "Subnet Group A" and the Group's SubnetId is 100 (checked in the SWQL Studio).

However, I received an HTTP-400 Bad Request response with the message "Hierarchy group with id/name '100' not found" after requesting this endpoint. A similar error happens even if I change the JSON payload hierarchyGroup value from "100" to "Subnet Group A". After some tests, the only available value for the hierarchyGroup value I know is "IP Networks". With this value, I can obtain the HTTP-200 response, and the Subnet is created successfully. However, the Subnet is created in the "IP Networks" group hierarchy but not the "Subnet Group A".

Is there a way to create a subnet in the target Group directly? or how to reposition that subnet from the "IP Networks" group to the "Subnet Group A" using the API approach?

Any help would be appreciated. Thanks.

API Endpoint:

/Invoke/IPAM.SubnetManagement/CreateSubnetForGroup

API Request:

curl  -X POST \
  'https://localhost:17774/SolarWinds/InformationService/v3/Json/Invoke/IPAM.SubnetManagement/CreateSubnetForGroup' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Basic 123456789=' \
  --data-raw '{
  "subnetAddress": "192.168.3.0",
  "rawCidr": 28,
  "hierarchyGroup": "100"
}'

Group View in the Manage Subnets & IP Addresses page (localhost/.../subnets.aspx) (before subnet creation)

Group View in the Manage Subnets & IP Addresses page (localhost/.../subnets.aspx) (after subnet creation)

Find more posts tagged with

Accepted answers

All comments

mesverrum

So the part that confusing you is that a hierarchy group is not just the folders you see there. It represents this sort of logical divide so that they can allow overlapping ip spaces. If you havent gone out of your way to create a heirarchy group you probably dont have any.

Check this thread, you probably just need to create a subnet with the normal verb.

thwack.solarwinds.com/.../create-subnet-in-ipam-using-api

raymond.chan.hk

Thanks for the reply.

I am new to SolarWinds and not familiar with the terminology yet. I believe the endpoint (verb) "/CreateSubnetForGroup" is used to create a subnet under a designated Hierarchy Group but a Group. That's why I could not specify the hierarchyGroup value as the Subnet Group A but IP Networks.

I have read the post you mentioned. If I use the normal verb (/CreateSubnet) instead, the subnet will be created in the default Hierarchy Group, IP Networks. Since I am looking for a solution to create a subnet in a specific Group, this endpoint cannot achieve this goal.

mesverrum

So in this case since there isn't a verb to do exactly what you intend in a single step you need to create the subnet, then do a set-swisobject on the new subnet and set its parentid to the relevant group. Takes a couple extra steps but thats how that part of the API works

github.com/.../IPAM-Observability-2022.2

raymond.chan.hk

Actually, I considered and tried this approach before posting this question too. The conclusion is that updating the "ParentId" of the subnet (192.168.3.0/28) record alone is not enough. Even after updating the "ParentId" pointing to the designated Group, Subnet Group A (id = 100) & the browser refresh, the UI still shows this subnet under the HierarchyGroup, IP Networks.

I then rolled back the ParentId update and repositioned the subnet under Subnet Group A in the UI. In SWQL Studio, I noticed that the ParentId of the subnet record was updated to 100. In addition, records in the IPAM.GroupNode and IPAM.GroupAncestors tables were inserted and updated accordingly. I believe this is one of the reasons why the UI did not update after I updated the ParentId alone using the API. However, I have not found a way to insert records into these 2 tables. As a result, I am stuck.

Before the reposition

After the reposition