openapi: 3.2.0 info: title: Cisco Ise Sgtvnvlan API version: '1.0' description: 'Operations tagged sgtvnvlan across 2 of this provider''s published API definitions: cisco-ise-ers-open-api-ers-apis.yaml, cisco-ise-legacy-ers-security-groups-to-virtual-network.yaml. Each path carries the servers of the definition it was published in.' x-provenance: method: harvested authored_by: Cisco harvested_by: API Evangelist harvested_on: '2026-08-19' first_party: true provider_published: true source_host: pubhub.devnetcloud.com note: 103 ISE API descriptions (1,490 operations; 32 OpenAPI 3.0.x + 71 Swagger 2.0) enumerated from Cisco's own DevNet project manifest and fetched anonymously. Byte-identity reconfirmed 2026-08-19 by SHA-256 against the live source. derived_view: Per-tag view of cisco-ise-legacy-ers-security-groups-to-virtual-network.yaml, the provider's source document. Operations and schemas are the provider's, unmodified; only the partition is ours. derived_from: cisco-ise-legacy-ers-security-groups-to-virtual-network.yaml operation_coverage: 8/13 x-evidence: - type: source url: https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/ - type: source url: https://developer.cisco.com/docs/identity-services-engine/ servers: - url: https://{server}:{port}/ers/config description: Append /ctsapi/v2 or /ctsapi/v3 to above URL while accessing CTS APIs variables: server: description: The host where the API is rooted default: localhost port: description: The port no for CTS APIs is 9063 and for other APIs it is 443 default: '443' tags: - name: sgtvnvlan paths: /sgtvnvlan/: get: tags: - sgtvnvlan summary: Get-All parameters: - name: filter in: query description: Filter Supported Fields:[sgtId] required: false allowReserved: true schema: type: string example: toDate.CONTAINS.SEP - $ref: '#/components/parameters/ppage' - $ref: '#/components/parameters/psize' responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/sgtvnvlanListResponse' application/xml: schema: $ref: '#/components/schemas/sgtvnvlanListResponse' text/html: schema: type: string example: null '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ERSResponse' application/xml: schema: $ref: '#/components/schemas/ERSResponse' text/html: schema: type: string example: null '401': description: Unauthorized '403': description: Forbidden '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ERSResponse' application/xml: schema: $ref: '#/components/schemas/ERSResponse' text/html: schema: type: string example: null '406': description: Not Acceptable '415': description: UnSupported Media Type content: application/json: schema: $ref: '#/components/schemas/ERSResponse' application/xml: schema: $ref: '#/components/schemas/ERSResponse' text/html: schema: type: string example: null security: - HTTPBasicAuthentication: [] post: tags: - sgtvnvlan summary: Create parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/trustsec.sgtvnvlan' example: SgtVNVlanContainer: name: name description: description id: dceff5c6-d4f2-48b7-92ae-87adcdd2777b sgtId: sgt_id virtualnetworklist: - vlans: - defaultVlan: true data: true maxValue: 270513735 name: vlan1 description: description1 id: dceff5c6-d4f2-48b7-92ae-87adcdd2777b - defaultVlan: false data: false maxValue: 196233424 name: vlan2 description: description id: dceff5c6-d4f2-48b7-92ae-87adcdd2777b - defaultVlan: false data: true maxValue: 0 name: vlan3 description: description id: dceff5c6-d4f2-48b7-92ae-87adcdd2777b name: virtual1 description: description defaultVirtualNetwork: false id: dceff5c6-d4f2-48b7-92ae-87adcdd2777b - vlans: - defaultVlan: false data: false maxValue: 348204138 name: vlan4 name: virtual2 description: description defaultVirtualNetwork: true id: dceff5c6-d4f2-48b7-92ae-87adcdd2777b required: true responses: '201': description: Created '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ERSResponse' application/xml: schema: $ref: '#/components/schemas/ERSResponse' text/html: schema: type: string example: null '401': description: Unauthorized '403': description: Forbidden '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ERSResponse' application/xml: schema: $ref: '#/components/schemas/ERSResponse' text/html: schema: type: string example: null '406': description: Not Acceptable '415': description: UnSupported Media Type content: application/json: schema: $ref: '#/components/schemas/ERSResponse' application/xml: schema: $ref: '#/components/schemas/ERSResponse' text/html: schema: type: string example: null '500': description: Internal Server Error security: - HTTPBasicAuthentication: [] servers: - url: https://{server}:{port}/ers/config description: Append /ctsapi/v2 or /ctsapi/v3 to above URL while accessing CTS APIs variables: server: description: The host where the API is rooted default: localhost port: description: The port no for CTS APIs is 9063 and for other APIs it is 443 default: '443' /sgtvnvlan/{id}: get: tags: - sgtvnvlan summary: Get-By-Id parameters: - name: id in: path required: true schema: title: id type: string example: null responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/sgtvnvlanResponse' application/xml: schema: $ref: '#/components/schemas/sgtvnvlanResponse' text/html: schema: type: string example: null '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ERSResponse' application/xml: schema: $ref: '#/components/schemas/ERSResponse' text/html: schema: type: string example: null '401': description: Unauthorized '403': description: Forbidden '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ERSResponse' application/xml: schema: $ref: '#/components/schemas/ERSResponse' text/html: schema: type: string example: null '406': description: Not Acceptable '415': description: UnSupported Media Type content: application/json: schema: $ref: '#/components/schemas/ERSResponse' application/xml: schema: $ref: '#/components/schemas/ERSResponse' text/html: schema: type: string example: null security: - HTTPBasicAuthentication: [] put: tags: - sgtvnvlan summary: Update parameters: - name: id in: path required: true schema: title: id type: string example: null requestBody: content: application/json: schema: $ref: '#/components/schemas/trustsec.sgtvnvlan' example: SgtVNVlanContainer: name: name description: description id: dceff5c6-d4f2-48b7-92ae-87adcdd2777b sgtId: sgt_id virtualnetworklist: - vlans: - defaultVlan: true data: true maxValue: 481243036 name: vlan1 description: description1 id: dceff5c6-d4f2-48b7-92ae-87adcdd2777b - defaultVlan: false data: false maxValue: 2115810125 name: vlan2 description: description id: dceff5c6-d4f2-48b7-92ae-87adcdd2777b - defaultVlan: false data: true maxValue: 0 name: vlan3 description: description id: dceff5c6-d4f2-48b7-92ae-87adcdd2777b name: virtual1 description: description defaultVirtualNetwork: false id: dceff5c6-d4f2-48b7-92ae-87adcdd2777b - vlans: - defaultVlan: false data: false maxValue: 78163534 name: vlan4 name: virtual2 description: description defaultVirtualNetwork: true id: dceff5c6-d4f2-48b7-92ae-87adcdd2777b required: true responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/UpdatedFieldsResponse' application/xml: schema: $ref: '#/components/schemas/UpdatedFieldsResponse' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ERSResponse' application/xml: schema: $ref: '#/components/schemas/ERSResponse' text/html: schema: type: string example: null '401': description: Unauthorized '403': description: Forbidden '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ERSResponse' application/xml: schema: $ref: '#/components/schemas/ERSResponse' text/html: schema: type: string example: null '406': description: Not Acceptable '415': description: UnSupported Media Type content: application/json: schema: $ref: '#/components/schemas/ERSResponse' application/xml: schema: $ref: '#/components/schemas/ERSResponse' text/html: schema: type: string example: null '500': description: Internal Server Error response content: application/json: schema: $ref: '#/components/schemas/ERSResponse' security: - HTTPBasicAuthentication: [] delete: tags: - sgtvnvlan summary: Delete parameters: - name: id in: path required: true schema: title: id type: string example: null responses: '204': description: No Content '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ERSResponse' application/xml: schema: $ref: '#/components/schemas/ERSResponse' text/html: schema: type: string example: null '401': description: Unauthorized '403': description: Forbidden '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ERSResponse' application/xml: schema: $ref: '#/components/schemas/ERSResponse' text/html: schema: type: string example: null '406': description: Not Acceptable '415': description: UnSupported Media Type content: application/json: schema: $ref: '#/components/schemas/ERSResponse' application/xml: schema: $ref: '#/components/schemas/ERSResponse' text/html: schema: type: string example: null security: - HTTPBasicAuthentication: [] servers: - url: https://{server}:{port}/ers/config description: Append /ctsapi/v2 or /ctsapi/v3 to above URL while accessing CTS APIs variables: server: description: The host where the API is rooted default: localhost port: description: The port no for CTS APIs is 9063 and for other APIs it is 443 default: '443' /ers/config/sgtvnvlan/{id}: get: tags: - sgtvnvlan summary: Get security group to virtual network by ID description:
This API allows the client to get a security group to virtual network by ID.
parameters: - name: id in: path required: true schema: type: string - in: header name: HTTP ERS-Media-Type Header description: Example:- trustsec.sgtvnvlan.1.0 required: false schema: type: string - in: header name: HTTP X-CSRF-TOKEN Header description: Required Only if Enabled from GUI Example:- fetch schema: type: string responses: 200: description: OK content: application/json: schema: $ref: '#/components/schemas/vn' application/xml: schema: $ref: '#/components/schemas/vn' put: tags: - sgtvnvlan summary: Update security group to virtual network description:This API allows the client to update a security group to virtual network.
parameters: - name: id in: path required: true schema: type: string - in: header name: HTTP ERS-Media-Type Header description: Example:- trustsec.sgtvnvlan.1.0 required: false schema: type: string - in: header name: HTTP X-CSRF-TOKEN Header description: The Token value from the GET X-CSRF-TOKEN fetch request schema: type: string - in: header name: Bulk Support description: Operation 'Update' can be used within Bulk Request schema: type: string - in: header name: Additional Information description: Generation Id is a read Only attribute hence any values that would be sent in the request would be ignored schema: type: string responses: 200: description: OK content: application/json: schema: $ref: '#/components/schemas/Update' application/xml: schema: $ref: '#/components/schemas/Update' requestBody: content: application/json: schema: $ref: '#/components/schemas/vn' application/xml: schema: $ref: '#/components/schemas/vn' delete: tags: - sgtvnvlan summary: Delete security group to virtual network description:This API deletes a security group ACL to virtual network.
parameters: - name: id in: path required: true schema: type: string - in: header name: HTTP ERS-Media-Type Header description: Example:- trustsec.sgtvnvlan.1.0 required: false schema: type: string - in: header name: HTTP X-CSRF-TOKEN Header description: The Token value from the GET X-CSRF-TOKEN fetch request schema: type: string - in: header name: Bulk Support description: Operation 'Delete' can be used within Bulk Request schema: type: string responses: 204: description: No Content /ers/config/sgtvnvlan: get: tags: - sgtvnvlan summary: Get all security group to virtual networks description:This API allows the client to get all the security group ACL to virtual networks.
To search guest users by using toDate column,follow the format:
DD-MON-YY (Example:13-SEP-18)
Day or Year:GET /ers/config/guestuser/?filter=toDate.CONTAINS.13
Month:GET /ers/config/guestuser/?filter=toDate.CONTAINS.SEP
Date:GET /ers/config/guestuser/?filter=toDate.CONTAINS.13-SEP-18
This API creates a security group to virtual network.
parameters: - in: header name: HTTP ERS-Media-Type Header description: Example:- trustsec.sgtvnvlan.1.0 required: false schema: type: string - in: header name: HTTP X-CSRF-TOKEN Header description: The Token value from the GET X-CSRF-TOKEN fetch request schema: type: string - in: header name: Bulk Support description: Operation 'Create' can be used within Bulk Request schema: type: string - in: header name: Additional Information description: Generation Id is a read Only attribute hence any values that would be sent in the request would be ignored schema: type: string responses: 201: description: Created requestBody: content: application/json: schema: $ref: '#/components/schemas/vn' application/xml: schema: $ref: '#/components/schemas/vn' /ers/config/sgtvnvlan/versioninfo: get: tags: - sgtvnvlan summary: Get security group to virtual network version information description:This API helps to retrieve the version information related to the security group to virtual network.
responses: 200: description: OK content: application/json: schema: $ref: '#/components/schemas/VersionInfo' /ers/config/sgtvnvlan/submit: put: tags: - sgtvnvlan summary: Submit bulk request description:This API allows the client to submit the bulk request.
responses: 202: description: Accepted requestBody: content: application/json: schema: $ref: '#/components/schemas/bulkrequest' application/xml: schema: $ref: '#/components/schemas/bulkrequest' /ers/config/sgtvnvlan/bulk/{bulkid}: get: tags: - sgtvnvlan summary: Monitor bulk request description:This API allows the client to monitor the bulk request.
parameters: - name: bulkid in: path required: true description: 'The bulk ID is a dynamically generated value.