1. Overview

This API Calls allows the user with the appropriate privileges to add a network to the TCPWave IPAM. The parameters, parameter types, and the data types of the REST call are shown below. Execution of this REST call is audited by the TCPWave IPAM. Customers are advised to execute this REST API call in a non production environment before attempting to execute it in a production environment.

1.1. Version information

Version : 11.32P4
August 13, 2022

1.2. URI scheme

BasePath : /tims/rest
Schemes : HTTPS

1.3. Tags

  • Microsoft AD sites Service

  • Autonomous System Number Service

  • Acl Service

  • Active Directory Service

  • Admin Group Service

  • Admin Preference Service

  • Administrator Roles Service

  • Alarm Subscription Service

  • Algorithm Service

  • Appliance Group Service

  • Asset Service

  • Audit data Backup Files Service

  • Audit Report Service

  • Audit Logs and License Information

  • Authentication Configuration Service

  • Authentication Permission Service

  • Authentication Token management

  • Authentication Type

  • Authorization Information

  • Bookmark Service

  • Capacity Planning Dashboard Service

  • Central Logging Service

  • Certificate Management Service

  • Chart Service

  • Checkouts Service Details

  • Class Code Logo Service

  • Class Code Service

  • Cloud Instance Service

  • Cloud DNS Provider Service

  • Cloud Network Service

  • Contact Service

  • Contingency Service Details

  • Custom Dashboard Service

  • Database Service

  • DHCP Active Lease Service

  • DHCP Class Service

  • DHCP Defaults Service

  • DHCP Failover Service

  • DHCP option space

  • DHCP Appliance Service

  • DNS Analytics Service

  • DNS Defaults Service

  • DNS External Root Hints Service

  • DNS Forwarders Service

  • DNS Appliance Service

  • DNS Appliance Template Service

  • DNS Tools Service

  • DNSViz Service

  • Discovery Agent Command Service

  • Discovery Agent Service

  • Switch Discovery Details Service

  • Discovery Appliance Service

  • Device Discovery Details Service

  • Discovery Event Service

  • Discovery Service

  • Discovery Template Service

  • Domain Service

  • Dropdown Service

  • Export Compliance Management Service

  • Export Service

  • Non-Managed DNS Masters Service

  • Non-Managed DNS Zones Service

  • File Distribution Management Service

  • File Upload Service

  • Firewall Service

  • DNS Flatten Record Service

  • Function Service

  • Global Options Service

  • Hierarchy Service

  • History Tab Service

  • Home Service

  • Host Naming Policy

  • IPAM Appliance Service

  • IPAM Template Service

  • IPAM Version Service

  • IPV6 DHCP Appliance Service

  • IPV6 DNS Appliance Service

  • IPV6 Scope Service

  • IPV6 Template Service

  • IPV6 Block Service

  • IPV6 Object Service

  • IPv6 Policy Compliance Service Details

  • IPV6 Pool Service

  • Reverse Zone Service

  • IPV6 Subnet Group Service

  • IPV6 Subnet Service

  • iDRAC Management Service

  • Import Cloud Service

  • Import Service

  • Internet Root Hints Service

  • Location Service

  • Log Category Service

  • Log Channel Service

  • Manage Appliance Services

  • Microsoft DNS Charts

  • Mirrored Zone Service

  • Monitor Service

  • Message Certificate Management Service

  • Network Security Monitoring Service

  • Network Service

  • Firmware Patch Service

  • Object Service

  • Organization ImportExport Service

  • Organization Service

  • Params Service

  • Query Alternate Resolver Service

  • Quick Move Service

  • RPZ Service

  • Role Service

  • Root Access Management Service

  • Router Subnet Service

  • Scheduler related calls Service

  • Scheduled Job Executor Status Service

  • Scheduled Job Service

  • Schedule Handler Service

  • Scheduled Audit Report Service

  • Scope Service

  • Search Service

  • Security Group Service

  • Server License Service

  • Server Service

  • Appliance Sync Status Service

  • Subnet Group Service

  • Subnet Service

  • Subnet Template Service

  • DNS TSIG (Transaction Signatures) Keys Service

  • Template Service

  • Threat Intelligent Widget Service

  • Time Zone Service

  • UndoData Service

  • User Certificate Service

  • User Service

  • IPv6 Audit Report Service

  • IPv6 IPAM Template Service

  • Microsoft DHCP Appliance Service

  • Microsoft DNS Appliance Service

  • View Service

  • Widget Service

  • Microsoft DHCP Exclusion range Service

  • Workflow Handler Service

  • Xtn Service

  • Zone Service

  • VMWare Discovery Details Service

  • IPv6 Subnet Template Service

2. Authentication

The GUI and CLI users are subjected to authentication checks and their sessions are associated with the credentials that are used by the system to provide fine-grained authorization to various resources in the system. TIMS secures the access to the system from other tools using REST API directly by using long-lived security tokens for authentication and authorization. These tokens are associated with a client (Admin, and IP/Host), and credentials (Role). TIMS ensures same authorization checks are employed for these clients as the CLI and GUI clients.

The token generation interface can be invoked by any Admin to generate a new token that is valid for the period as defined by the system (default 60 days) from a given client machine (IP/Host). The generated token can be used from the same system and the Admin's credentials are applied to the API calls invoked with that token.

Example invocation of token generation interface using curl –

curl –H "Content-Type: application/json" -d '{"ip":"10.10.10.237","application":"tims","description":"Test"}' 'https://example.com:7443/tims/rest/auth_token/get'

Certificate Authentication - To enable a SSL connection the TCPWave IPAM management appliance needs to have a Digital Certificate which will allow the remote TCPWave DNS/DHCP appliances or the web browser or a third-party automation system to trust the authenticity of the management. The DNS and DHCP transactions for configuration management, statistics, patches, RESTAPI calls from a home-grown automation system or a third party automated system, or a browser session that wants to send an encrypted message apply for a Digital Certificate from the Certificate Authority (CA). The CA validates the application owner details and other identification details and issues a digital certificate. In Public Key Infrastructure (PKI) scheme a digital certificate is issued by a CA and it contains Distinguished Name(DN) /owner’s name/ subject, a serial number to uniquely identify the certificate, owner’s public key, issuing date, expiry date, Distinguished name of the CA, digital signature of the issuing authority (CA), signature algorithm which is used to create the signature. Digital certificates issued by the CA can be kept in registries so that the authenticating users can use the owner’s public key. The TCPWave IPAM ensures that secure communication takes place seamlessly and it also ensures that the SSL certificates do not expire. The TCPWave IPAM monitoring engine checks the expiration time of the SSL certificates and initiates the alerting mechanism if any SSL certificate is about to expire.

3. Enabling Rest Access

To generate an authentication token in the TCPWave IPAM, login to the TCPWave IPAM GUI and go to Session Tokens Management page by clicking on the Security Administration menu item in the Administration menu located at the top section the IPAM Interface. The Security Administration page is divided into two panes. The left pane consists of the menu items under the Administration menu including links to the Security Administration Tools. The Right pane displays the current view selected in the left pane. Click on the Session Tokens Management link to display the Session Tokens view in the right pane.

The Session Management grid displays the list of Session Tokens in the TCPWave IPAM. The grid also includes Session Token details like session token name, IP address, application, active, admin, generated from IP address, generated date and description.

To generate a new session token:

  1. Click on the Add button located on the top left corner of the session tokens grid.
  2. Generate Session Token window will appear
  3. Enter the Application name
  4. Enter the IP address
  5. Optionally enter the description
  6. Click on OK


Following are the examples to invoke REST API in the TCPWave IPAM.

Node based REST API invocation using client.js script file:
Each REST call is provided as an executable command file.
For example, addorg.cmd file as the information related to creation of an Organization.
$ cat addorg.cmd
{
"method":"POST",
"url":"/organization/add",
"data":
{
"name": "QAOrg",
"description": "QAOrg organization"
},
"enable_root_zone": 1
}
TCPWave IPAM follows the same structure for all the cmd files. "method" can take POST/GET, "url" is the variable portion of our REST API URL, and for POST commands "data" contains the JSON Body.
client.js takes the cmd file as an argument and executes the REST API defined in it. The "options" structure in the client.js contains the host and port information.
The client.js file will be provided to customers on request.

CURL commands based REST API invocation:
Once the certifcate validation is done at IPAM customers can use CURL commands to execute the REST calls and communicate with TCPWave IPAM.
For example, /network/add can be invoked using curl command.

curl -k -H "Content-Type:application/json" --cert 10.1.10.7.pem --key 10.1.10.7.key https://10.1.10.2:7443/tims/rest/network/add -X POST -d '{"addr1":"20","addr2":"0","addr3":"0","addr4":"0","mask_length":"16","organization_name":"Internal","name":"taiho","dmzVisible":"0", "description":""}'

The -k option is to disable server cert validation on the client side. We can always import the IPAM cert into the curl key store and remove that flag.

4. Resources

4.1. Acl Service

Description

This service provides API's to get list of Access Control List(ACL) present in the TCPWave IPAM, add Access Control List(ACL) , update Access Control List(ACL), delete Access Control List(ACL), search for an Access Control List(ACL) in the TCPWave IPAM.

4.1.1. ACL create

POST /acls/create
Description

This operation creates a new ACL in the TCPWave IPAM. This list controls DNS behavior when applied to the Allow-Notify, Allow-Query, Allow-Transfer, etc. If TCPWave IPAM does not manage the object(s) or subnet(s), or network(s), then the system restricts from creating the ACL.
Sample payload with mandatory parameters to add an ACL is listed below.
{"aclElementList":[{"exclude":0,"value":"10.2.3.5"}],"name":"test-client"}

Parameters
Type Name Description Schema Default

Body

body
required

ACL details

Access Control List(ACL)

Responses
HTTP Code Description Schema

500

TIMS-2002: ACL already exists, TIMS-2007: ACL name is not valid, TIMS-14049: Cannot create the ACL as managed object(s) or subnet(s) or network(s) with IP addresses <IP Address> are not available in IPAM, TIMS-2007: The ACL name is not valid : <ACL name>

No Content

Consumes
  • application/json

  • application/xml

4.1.2. Custom ACL List

GET /acls/customACLlist
Description

Obtains the list of Access Control List(ACL) defined and managed by the TCPWave IPAM that do not have mask length in the value which are used to control the behavior of DNS when applied to the also-notify.
The example listed below shows a sample request URL:
/tims/rest/acls/customACLlist

Responses
HTTP Code Description Schema

200

successful operation

< Access Control List(ACL) > array

500

TIMS-2001: ACL(s) not found

No Content

Produces
  • application/json

  • application/xml

4.1.3. ACL details

GET /acls/get
Description

This operation retrieves the details of specified ACLs defined and managed by the TCPWave IPAM, which controls DNS behavior when applied to the Allow-Notify, Allow-Query, Allow-Transfer, etc.
Example:
/tims/rest/acls/get?name=acl

Parameters
Type Name Description Schema Default

Query

name
required

ACL Name

string

Responses
HTTP Code Description Schema

200

successful operation

Access Control List(ACL)

500

TIMS-2001: ACL(s) not found

No Content

Produces
  • application/json

  • application/xml

4.1.4. ACL References

GET /acls/getreferences
Description

Provides the list references of ACL in Option Templates, Zone Templates and AD enabled Zones in the TCPWave IPAM which use specified Access Control List(ACL)
The example listed below shows a sample request URL:
/tims/rest/acls/getreferences?name=acl

Parameters
Type Name Description Schema Default

Query

name
required

ACL Name

string

Responses
HTTP Code Description Schema

200

successful operation

< string, < string > array > map

500

TIMS-12004: ACL Reference(s) not found.

No Content

Produces
  • application/json

  • application/xml

4.1.5. ACL list

GET /acls/list
Description

This operation retrieves the list of ACLs defined and managed by the TCPWave IPAM, which controls DNS behavior when applied to the Allow-Notify, Allow-Query, Allow-Transfer, etc.
Example:
/rest/acls/list?page=1&rows=20

Responses
HTTP Code Description Schema

200

successful operation

< Access Control List(ACL) > array

500

TIMS-2001: ACL(s) not found

No Content

Produces
  • application/json

  • application/xml

4.1.6. ACL Delete Multiple

POST /acls/multidelete
Description

Deletes multiple existing Access Control Lists(ACLs) from the TCPWave IPAM data repository. This action is audited.
Below example shows sample request JSON: ["test-client"]

Parameters
Type Name Description Schema Default

Body

body
required

List of ACL names

< string > array

Responses
HTTP Code Description Schema

500

TIMS-2001: ACL(s) not found,
TIMS-1307: Root zone(s) does(do) not exist.

No Content

Consumes
  • application/json

  • application/xml

4.1.7. ACL edit

POST /acls/update
Description

This operation updates an existing ACL in the TCPWave IPAM. If the TCPWave IPAM does not manage the object(s) or subnet(s), or network(s), then the system restricts from updating the ACL..
Example:
{"name":"test-client","newName":"new-test-client","description":"ACL added to the TCPWave IPAM by Professional Services","aclElementList":[{"value":"10.24.6.8","sequence":"1","exclude":"0"},{"value":"10.24.6.9","sequence":"2","exclude":"0"},{"value":"10.24.11.9","sequence":"3","exclude":"0"},{"value":"10.24.15.8","sequence":"4","exclude":"0"},{"value":"10.1.1.1","sequence":"5","exclude":"0"},{"refAclName":"localnets","sequence":"6","exclude":"0"}]}

Parameters
Type Name Description Schema Default

Body

body
required

ACL details

Access Control List(ACL)

Responses
HTTP Code Description Schema

500

TIMS-2001: ACL(s) not found,
TIMS-2002: ACL already exists,
TIMS-2006: ACL is not valid,
TIMS-14050: Cannot update the ACL as managed object(s) or subnet(s) or network(s) with IP addresses {0} are not available in IPAM
TIMS-1737: ACL object cannot be null.

No Content

Consumes
  • application/json

  • application/xml

4.2. Active Directory Service

Description

This service class provides REST API access to Create and Delete a mapping of existing Active Directory Domain Services (AD DS) User Principal Name (UPN) into the TCPWave IPAM.

4.2.1. Authenticate Active Directory User

POST /activedirectory/authenticate
Description

Validates authentication between the TCPWave DNS and Active Directory Domain Services (AD DS) using Kerberos authentication to use the interoperability features provided by the Kerberos Key Distribution Center (KDC) service.
Below example shows sample request JSON:
{"service_type":"DNS","principal_name":"DEV-DNSROOT-AUTH-001.plab.tcpwave.com","principal_type":"KRB5_NT_PRINCIPAL","realm":"TCPWAVE.COM","dnsIp":"10.1.10.187","encryption_type":"RC4-HMAC-NT","dc_ip":"10.1.10.170"}

Parameters
Type Name Description Schema Default

Body

body
required

ActiveDirectory details

Active Directory

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1207: Please select an Active Directory user principal name (UPN) for authentication,

No Content

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

4.2.2. Active Directory User Delete

POST /activedirectory/delete
Description

Removes mapping of existing Active Directory Domain Services (AD DS) User Principal Name (UPN) from the TCPWave IPAM. Below is the example
[{
"dnsIp": "192.168.0.215",
"encryption_type": "RC4-HMAC-NT",
"id": 8,
"principal_name": "TCPWave00001Remote.domain.com",
"principal_type": "KRB5_NT_PRINCIPAL",
"realm": "DOMAIN.COM",
"service_type": "LOCAL"
}]

Parameters
Type Name Description Schema Default

Body

body
required

List of ActiveDirectory details

< Active Directory > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation
TIMS-1203: Please select an Active Directory user principal (UPN) name to delete.

No Content

Consumes
  • application/json

  • application/xml

4.2.3. Delete the keytab principals

POST /activedirectory/editKerberosConf
Description

Deletes the keytab principals from the Authoritative DNS Appliance.

Parameters
Type Name Description Schema Default

Query

applianceIPs
required

DNS Appliance IP Addresses

string

Query

orgName
required

Organization Name

string

Body

body
optional

ADKerberosConfg

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.2.4. Active Directory Kerberos Configuration Details

GET /activedirectory/getkerberosconf
Description

Obtains the details of Kerberos configuration from the Authoritative DNS Appliance.

Parameters
Type Name Description Schema Default

Query

applianceIPs
required

DNS Appliance IP Addresses

string

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

ADKerberosConfg

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.2.5. Active Directory User Add

POST /activedirectory/useradd
Description

Creates a mapping of existing Active Directory Domain Services (AD DS) to User Principal Name (UPN) into the TCPWave IPAM. A UPN is the name of a system user in an e-mail address format.Example: username@user.associated.internet.domain.
Below example shows sample request JSON:
{"dc_ip":"10.1.2.3","dnsDomainName":"test.tcpwave.net","dnsIp":"10.1.2.4","dnsServerName":"server1","encryption_type":"RC4-HMAC-NT","file_data":"File Data","file_name":"filename","principal_name":""server1@domain.com","principal_type":"KRB5_NT_PRINCIPAL","realm":"TCPWAVE.COM","service_type":"ServerType""}

Parameters
Type Name Description Schema Default

Body

body
optional

Active Directory

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-1312: Duplicate entry.

No Content

Consumes
  • application/json

  • application/xml

  • multipart/form-data

4.2.6. Active Directory User list

GET /activedirectory/userlist
Description

Obtains a list of Active Directory Domain Services (AD DS) User Principal Name (UPN) which Obtains a List of all permissions associated with a given admin group. Functional Admin can list the permissions of any admin group. Rest of the Admins are restricted to the admin groups that belong to their organization. A UPN is the name of a system user in an e-mail address format. Example: username@user.associated.internet.domain.

Parameters
Type Name Description Schema Default

Query

applianceName
required

Appliance Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Active Directory > array

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.3. Admin Group Service

Description

This service provides API access to perform admin group operations. Operations include add an admin group, update an admin group , list admin group, delete an admin group, retrieve admin group permissions and update admin group permissions.

4.3.1. Admin Group Add

POST /admingroup/add
Description

This operation creates a new admin group. Functional and User admins have the privilege to create admin groups in any organization. The super admins can create only in the organization that they belong.
Example:
{ "*name":"QA Admin group", "*description":"Admin group" "*addedRoles":[{ "*organization_name":"Internal", "*name":"SADM"}] }

Parameters
Type Name Description Schema Default

Body

body
optional

Admin Group

Responses
HTTP Code Description Schema

500

TIMS-1101: Cannot find organization, TIMS-1100: Both organization name and id cannot be null, TIMS-1401: Admin group already defined

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.3.2. Admin Group Delete

POST /admingroup/delete
Description

This operation deletes an existing admin group. Functional and User admins have the privilege to delete an admin group belonging to any organization.
Example:
/rest/admingroup/delete?name=adminGroupName

Parameters
Type Name Description Schema Default

Query

id
optional

Admin Group ID

integer(int32)

Query

name
required

Admin Group Name

string

Responses
HTTP Code Description Schema

500

TIMS-1140: Both admin group id and name cannot be null, TIMS-1141: Admin group does not exist, TIMS-1143: Admin group cannot be deleted as it is associated with existing users.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.3.3. Admin Group Details

GET /admingroup/get
Description

This operation retrieves the details of the given admin group.
Example:
/rest/admingroup/get?admin_group_name=testAdmin

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

admin_group_id
optional

Admin Group ID

integer(int32)

Query

admin_group_name
required

Admin Group Name

string

Responses
HTTP Code Description Schema

200

successful operation

Admin Group

500

TIMS-1101: Cannot find organization.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.3.4. Admin Group list

GET /admingroup/list
Description

This operation displays the list of all admin groups defined and managed by the TCPWave IPAM.
Example:
/rest/admingroup/list?page=1&rows=20

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization Names

string

Responses
HTTP Code Description Schema

200

successful operation

< Admin Group > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.3.5. Admin Group List

GET /admingroup/list/admin
Description

This operation displays the list of all admin groups defined and managed by the TCPWave IPAM.
The following example shows a sample request URL:
/tims/rest/admingroup/list/admin

Responses
HTTP Code Description Schema

200

successful operation

< Admin Group > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.3.6. Organization List

GET /admingroup/list/adminroles
Description

This operation retrieves the list of admin roles associated with the given admin group(s).
The following example shows a sample request URL:
/rest/admingroup/list/adminroles?adminroles=1

Parameters
Type Name Description Schema Default

Query

group_id
optional

Admin Group ID

string

Responses
HTTP Code Description Schema

200

successful operation

< AdministratorRoles > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.3.7. Organization List

GET /admingroup/list/org
Description

This operation retrieves the list of associated organizations with the given admin group(s).
The following example shows a sample request URL:
/tims/rest/admingroup/list/org?group_id=1

Parameters
Type Name Description Schema Default

Query

group_id
optional

Admin Group ID

string

Responses
HTTP Code Description Schema

200

successful operation

< Organization > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.3.8. Roles List

GET /admingroup/selectedroles
Description

This operation retrieves the list of roles associated with the given admin group .
The following example shows a sample request URL:
/tims/rest/admingroup/list/selectedroles?group_name=groupName

Parameters
Type Name Description Schema Default

Query

group_name
optional

string

Responses
HTTP Code Description Schema

200

successful operation

< AdministratorRoles > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.3.9. Admin Group Modify

POST /admingroup/update
Description

This operation updates an existing admin group. Functional and User admins have the privilege to edit an admin group belonging to any organization.
Example:
{ "*name":"QA Admin group2", "description":"Admin group" "*addedRoles":[{ "*organization_name":"Internal", "*name":"TestRole2"}] "*oldName":"QA Admin group", "*deletedRoles":[{ "*organization_name":"Internal", "*name":"TestRole1"}] }

Parameters
Type Name Description Schema Default

Body

body
optional

Admin Group

Responses
HTTP Code Description Schema

500

TIMS-1101: Cannot find organization, TIMS-1100: Both organization name and id cannot be null, TIMS-1142: Admin group does not exist

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.4. Admin Preference Service

Description

This service provides the API to manage the Admin preferences in TCPWave IPAM.

4.4.1. Admin Preference Details

GET /preference/deleteByID
Description

Delete the specified grid preferences.

Parameters
Type Name Description Schema Default

Query

dtId
required

Datatable Id

string

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.4.2. Admin Preference Details

GET /preference/deleteByUser
Description

Delete the specified admin preferences.

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.4.3. Admin Preference Details

GET /preference/get
Description

Get the details of the specified admin preferences.
The example listed below shows a sample request URL:
/rest/preference/get

Parameters
Type Name Description Schema Default

Query

dtId
required

Datatable Id

string

Responses
HTTP Code Description Schema

200

successful operation

AdminPreference

500

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.4.4. Add/Update Admin Preference

POST /preference/update
Parameters
Type Name Description Schema Default

Body

body
required

AdminPreference

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.5. Administrator Roles Service

Description

This service provides APIs to add, edit, delete and get list of Administrator Roles in TCPWave IPAM.

4.5.1. Add Administrator Role

POST /adminroles/add
Description

Creates a new administrator role in the TCPWave IPAM.
Below example shows sample request JSON:
{"name":"roleName","description":"new desc""addedFunctions":[{"name":"Quick Tasks"},{"name":"Appliance Groups"}]}

Parameters
Type Name Description Schema Default

Body

body
required

Administrator role.

AdministratorRoles

Responses
HTTP Code Description Schema

500

An Administrator role with the given name already exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.5.2. Administrator Role Delete

GET /adminroles/delete
Description

Deletes the Administrator role present in the TCPWave IPAM. Functional Admin and User Admins can delete an Appliance group in any organization. Other Admins can delete the Appliance groups belonging to their organization only.
The example listed below shows a sample request URL:
/rest/adminrole/delete?name=roleName

Parameters
Type Name Description Schema Default

Query

name
required

Administrator role Name

string

Responses
HTTP Code Description Schema

500

TIMS-2051: Administrator role is not deleted as it is being used.

No Content

Consumes
  • text/plain

  • application/json

Produces
  • application/json

  • application/xml

4.5.3. Administrator Get

GET /adminroles/get
Description

Get the details of the Administrator role defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/adminroles/get?name=roleName

Parameters
Type Name Description Schema Default

Query

name
optional

string

Responses
HTTP Code Description Schema

200

successful operation

AdministratorRoles

500

TIMS-1425: Both Role id and Role name cannot be null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.5.4. List Administrator Roles

GET /adminroles/list
Description

Provides a list of Administrator roles present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/adminroles/list?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Administrator roles Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAdministratorRoles

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.5.5. List Functions

GET /adminroles/listfunctions
Description

Provides a list of functions present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/adminroles/listfunctions?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting functions Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListFunctions

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.5.6. Get List Of Functions Of A Role

GET /adminroles/listfunctionsdata
Description

Obtains a list of functions corresponding to a given role in the TCPWave IPAM
The example listed below shows a sample request URL:
/rest/adminroles/listfunctionsdata?create=YES&default_role=TRUE

Parameters
Type Name Description Schema Default

Query

name
required

Role Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Functions > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.5.7. Administrator Role Names List

GET /adminroles/listroles
Description

Obtains a list of Administrator Role names in the TCPWave IPAM
The example listed below shows a sample request URL:
/rest/adminroles/listroles

Responses
HTTP Code Description Schema

200

successful operation

< AdministratorRoles > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.5.8. Admin Role List

GET /adminroles/roles/list
Description

List all the admin roles. Lists all the possible Admin Roles in the system.
The example listed below shows a sample request URL:
rest/adminroles/roles/list

Parameters
Type Name Description Schema Default

Query

group_id
optional

string

Query

org_id
optional

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< Admin Role > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.5.9. Functions List

GET /adminroles/selectedfunctions
Description

List all the functions list for selected administrator roles .
The example listed below shows a sample request URL:
/rest/adminroles/selectedfunctions?role_name=SADM

Parameters
Type Name Description Schema Default

Query

role_name
optional

string

Responses
HTTP Code Description Schema

200

successful operation

< Functions > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.5.10. Edit Administration Roles

POST /adminroles/update
Description

Updates an existing administration role in the TCPWave IPAM. Functional and Super Admins can edit an Appliance group in any organization.
Below example shows sample request JSON:
{"name":"roleName","description":"new desc""addedFunctions":[{"name":"Quick Tasks"},{"name":"Appliance Groups"}]"deletedFunctions":[{"name":"DNS Domains"},{"name":"Appliance Groups"}]}

Parameters
Type Name Description Schema Default

Query

name
optional

string

Body

body
required

Administrator roles.

AdministratorRoles

Responses
HTTP Code Description Schema

500

An administration role with the given name already exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.6. Alarm Subscription Service

4.6.1. Add Alarm Subscriptions

POST /alarmSubscription/add
Description

Create alarm subscriptions in the TCPWave IPAM. Alarm Subscriptions are used to send email notifications to the subscribed users in the TCPWave IPAM.
Below example shows sample request JSON:

Parameters
Type Name Description Schema Default

Body

body
optional

Subscription List

< Alarm Subscription > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation,TIMS-8338: Alarm Subscription does not exist,8339 = TIMS-8339: Alarm Component type does not exist,8340 = TIMS-8340: Monitoring threshold does not exist.

No Content

Consumes
  • application/json

  • application/xml

4.6.2. Threshold Category List

GET /alarmSubscription/categoryList
Description

Obtains a list of monitored service categories to subscribe for email notifications in the TCPWave IPAM.
Below example shows sample request URL:
/rest/alarmSubscription/categoryList

Responses
HTTP Code Description Schema

200

successful operation

< string > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.6.3. List Alarm Subscription Components

GET /alarmSubscription/componentList
Description

Obtains a list of components such as Network, Subnet, Zone, IPAM etc for the given monitoring services in the TCPWave IPAM.
Below example shows sample request URL:
/rest/alarmSubscription/componentList?serviceList=TCPWAVE_NTP,CHECK_SSH&orgName=TCPWave

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

orgName
required

Organization name

string

Query

serviceList
required

Comma separated list of monitoring services

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Appliance Group Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListComponent

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.6.4. Delete Alarm Subscriptions

POST /alarmSubscription/delete
Description

Delete alarm subscriptions from the TCPWave IPAM. Alarm Subscriptions are used to send email notifications to the subscribed users in the TCPWave IPAM.
Below example shows sample request JSON:

Parameters
Type Name Description Schema Default

Body

body
required

List of alarm subscriptions

< Alarm Subscription > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation,TIMS-8338: Alarm Subscription does not exist,8339 = TIMS-8339: Alarm Component type does not exist.

No Content

Consumes
  • application/json

  • application/xml

4.6.5. Subscription List

GET /alarmSubscription/list
Description

Provides the list of all available subscriptions in the TCPWave IPAM. Subscriptions are used to send email notifications to the subscribed users in the TCPWave IPAM.
Below examples shows sample request URLs:
/rest/alarmSubscription/list?organizations=Internal&start=0&length=20
/rest/alarmSubscription/list?organizations=Internal&length=-1

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organizations

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Appliance Group Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAlarm Subscription

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.6.6. List Monitoring Services

GET /alarmSubscription/thresholdList
Description

Obtains a list of monitoring services for the given category to subscribe for alarm notifications in the TCPWave IPAM.
Below example shows sample request URL:
/rest/alarmSubscription/thresholdList?category=Appliance Components

Parameters
Type Name Description Schema Default

Query

category
required

Category

string

Responses
HTTP Code Description Schema

200

successful operation

< Monitor Information > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.7. Algorithm Service

Description

This service provides API's to get list of Algorithm present in the TCPWave IPAM and list of Transaction SIGnature(TSIG)Algorithm in the TCPWave IPAM.

4.7.1. Algorithm List

GET /algo/list
Description

Obtains a list of valid DNS signing algorithms in the TCPWave IPAM.
The example listed below shows a sample request URL:
rest/algo/list

Responses
HTTP Code Description Schema

200

successful operation

< Algorithm > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.7.2. Algorithm TSIG List

GET /algo/tsiglist
Description

Obtains a list of Transaction Signature(TSIG) key algorithms supported by the TCPWave IPAM.
The example listed below shows a sample request URL:
rest/algo/tsiglist

Responses
HTTP Code Description Schema

200

successful operation

< Algorithm > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.8. Appliance Group Service

Description

This service provides API access to perform appliance group related operations like add, edit and delete.

4.8.1. Add Appliance Group

POST /appliancegroup/add
Description

Creates a new appliance group in the TCPWave IPAM. Functional admins can add an appliance group in any organization. Super admins can add an appliance group in their own organization only.
Below example shows sample request JSON:
{"name":"applianceGroupName","organization_name":"Internal","description":"Appliance group"}

Parameters
Type Name Description Schema Default

Body

body
required

Group of appliances, using for patch.

Appliance Group

Responses
HTTP Code Description Schema

500

An appliance group with the given name already exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.8.2. Map of Appliance Group Hierarchy

GET /appliancegroup/agHierarchy
Description

Returns the hierarchy as a JSON string for the TCPWave IPAM GUI consumption.
The example listed below shows a sample request URL:
/rest/appliancegroup/agHierarchy?orgName=orgName

Parameters
Type Name Description Schema Default

Query

orgName
required

organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • application/json

4.8.3. Appliance Group Delete

GET /appliancegroup/delete
Description

Deletes the Appliance group present in the TCPWave IPAM. Functional Admins can delete an Appliance group in any organization. Other Admins can delete the Appliance groups belonging to their organization only.
The example listed below shows a sample request URL:
/rest/appliancegroup/delete?name=applianceGroupName&organization=orgName

Parameters
Type Name Description Schema Default

Query

name
required

Appliance Group Name

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

500

TIMS-2051: Appliance group is not deleted as it is being used.

No Content

Consumes
  • text/plain

  • application/json

Produces
  • application/json

  • application/xml

4.8.4. Deploy a Firmware Patch

GET /appliancegroup/deployfirmwarepatch
Description

Deploys a Firmware patch on the given appliance group.
The example listed below shows a sample request URL:
/rest/appliancegroup/deployfirmwarepatch?name=applianceGroupName&organization=orgName&patchName=patchNameValue

Parameters
Type Name Description Schema Default

Query

name
required

Appliances Group Name

string

Query

organization
required

Organization

string

Query

patchName
required

Patch Name

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.8.5. Edit Appliance Group

POST /appliancegroup/edit
Description

Updates an existing appliance group in the TCPWave IPAM. Functional and Users Admins can edit an Appliance group in any organization.
Below example shows sample request JSON:
{"name":"applianceGroupName","organization_name":"Internal""description":"Appliance group""prevAppGroupName":"app-group",}

Parameters
Type Name Description Schema Default

Body

body
required

Group of appliances, using for patch.

Appliance Group

Responses
HTTP Code Description Schema

500

A appliance group with the given name already exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.8.6. Details of Appliance Group

GET /appliancegroup/get
Description

Retrieves the details of an appliance group in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/appliancegroup/get?name=applianceGroupName&organization=orgName

Parameters
Type Name Description Schema Default

Query

name
optional

Appliance Group Name

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Appliance Group

500

TIMS-12074: Appliance group name cannot be null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.8.7. List Appliance Group

GET /appliancegroup/list
Description

Provides a list of Appliance groups present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/tims/rest/appliancegroup/list?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Comma Separated Organization Names

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Appliance Group Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAppliance Group

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.8.8. List appliance group by appliance type

GET /appliancegroup/listByType
Description

Provides a list of Appliance groups associated with specified appliance type in the TCPWave IPAM.
The example listed below shows a sample request URL:
rest/appliancegroup/listByType?applianceType=DNS
rest/appliancegroup/listByType?applianceType=DHCP
rest/appliancegroup/listByType?applianceType=IPAM

Parameters
Type Name Description Schema Default

Query

applianceType
required

Appliance Type. Takes either DNS, DHCP or IPAM

string

Responses
HTTP Code Description Schema

200

successful operation

< Appliance Group > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.8.9. Appliance Group List

GET /appliancegroup/listbyorg
Description

Provides a list of Appliance groups present in an organization.
The example listed below shows a sample request URL:
/rest/appliancegroup/listbyorg?organization=orgName&name=applianceGroupName

Parameters
Type Name Description Schema Default

Query

name
required

Appliance Group Name

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Appliance Group > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.8.10. References of Appliance Group

GET /appliancegroup/references
Description

Retrieves the list of appliances that are associated to the appliance group in the TCPWave IPAM.
The example listed below shows a sample request URL:
/tims/rest/appliancegroup/references?name=applianceGroupName&organization=orgName

Parameters
Type Name Description Schema Default

Query

name
optional

Appliance Group Name

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< MonitoringHierarchy > array

500

TIMS-12074: Appliance group name cannot be null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.8.11. Update root password

POST /appliancegroup/updateRootpassword
Description

Updates the root password for all the associated DNS and DHCP appliances.
Below example shows sample request JSON:
{"name":"applianceGroupName","organization_name":"Internal","appliance_root_password":"RootPassword!23"}

Parameters
Type Name Description Schema Default

Body

body
required

Appliance group entity with required fields for updating root password

Appliance Group

Responses
HTTP Code Description Schema

500

An appliance group with the given name does not exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.9. Appliance Sync Status Service

Description

This service provides API's to get the sync status for an existing DNS Appliance managed by TCPWave IPAM.

4.9.1. Appliance Sync Status GET

GET /serversync/get
Description

Provides the details of sync information for the given Appliance and Organization in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/serversync/get?address=10.1.10.183&orgName=QAOrg&serverType=BIND%20CACHE

Parameters
Type Name Description Schema Default

Query

address
required

Server IP Address

string

Query

isV6
optional

Boolean value to represent the IPv6 appliance or not

boolean

Query

orgName
required

Organization Name

string

Query

serverId
optional

Appliance Id

integer(int32)

Query

serverType
required

Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

Appliance Synchronization Status

500

TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-3091: Appliance does not exist.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.10. Asset Service

Description

This service provides the API to manage Assets in the TCPWave IPAM.

4.10.1. Add Asset

POST /asset/add
Description

Creates a new asset in the TCPWave IPAM. An asset can be associated to an object so that an IP Address can be associated to a service tag number for proper inventory reconciliation.
Below example shows sample request JSON:
{"service_tag":"Asset","serial_num":"12345","vendor":"CISCO","name":"EXAMPLE-ROUTER","model":"ASR10","acquisition_type":"Merger and Acquisition","cpu":"2","capacity":"unlimited","os_version":"IOS 11.0","maintenance_cost":"500","purchase_cost":"10000","city":"Trash","green_zone":"false","disposal_reason":"Salem","description":"Remove City or add country","purchase_dt":"2017-08-23T00:00:00.000Z","warranty_end_dt":"2017-08-23T00:00:00.000Z","disposal_dt":"2017-08-23T00:00:00.000Z"}

Parameters
Type Name Description Schema Default

Body

body
required

Asset details

Asset

Responses
HTTP Code Description Schema

500

TIMS-7777: Specified asset already exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.10.2. Delete Assets

POST /asset/deleteAll
Description

Deletes the given assets defined in the TCPWave IPAM. This API accepts the list of Asset names to delete.
Below example shows sample request JSON:
["Asset","Asset2"]

Parameters
Type Name Description Schema Default

Body

body
required

List of asset service tags

< string > array

Responses
HTTP Code Description Schema

500

TIMS-1703: Please select an asset to delete.
TIMS-7778: The Asset cannot be deleted as it is being referred from object(s): {0}
TIMS-7779: Invalid Asset specified: {0}

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.10.3. Update Asset

POST /asset/edit
Description

Updates an existing asset defined in the TCPWave IPAM. An asset can be associated to an object so that an IP Address can be associated to a service tag number for proper inventory reconciliation.
Below example shows sample request JSON:
{"service_tag":"Asset1","serial_num":"12345","vendor":"CISCO","name":"EXAMPLE-ROUTER","model":"ASR10","acquisition_type":"Merger and Acquisition","cpu":"2","capacity":"unlimited","os_version":"IOS 11.0","maintenance_cost":"500","purchase_cost":"10000","city":"Salem","green_zone":"false","disposal_reason":"Trash","description":"Remove City or add country","purchase_dt":"2017-08-23T00:00:00.000Z","warranty_end_dt":"2017-08-23T00:00:00.000Z","disposal_dt":"2017-08-23T00:00:00.000Z","previousAssetSerTag":"Asset"}

Parameters
Type Name Description Schema Default

Body

body
required

Asset details

Asset

Responses
HTTP Code Description Schema

500

TIMS-1701: Please select a single asset to edit.
TIMS-1702: Please select an asset to edit.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.10.4. Get Asset Details

GET /asset/get
Description

Provides the details of a given asset defined in the TCPWave IPAM. An asset can be associated to an object so that an IP Address can be associated to a service tag number for proper inventory reconciliation.
The example listed below shows a sample request URL:
/rest/asset/get?service_tag=assetServiceTagValue

Parameters
Type Name Description Schema Default

Query

service_tag
required

Asset Service Tag

string

Responses
HTTP Code Description Schema

200

successful operation

Asset

500

TIMS-7779: Invalid Asset specified: {0}.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.10.5. Asset List

GET /asset/list
Description

Obtains a list of assets defined and managed by the TCPWave IPAM. An asset can be associated to an object so that an IP Address can be associated to a service tag number for proper inventory reconciliation.
The example listed below shows a sample request URL:
/rest/asset/list?page=1&rows=20

Responses
HTTP Code Description Schema

200

successful operation

< Asset > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.11. Audit Logs And License Information

Description

This service provides the API to access the audit logs in the TCPWave IPAM and purge the audit records. This service also provides the API to access the IPAM license information and update the license key.

4.11.1. Audit Logging Configuration

GET /audit/auditLoggingConfigDetails
Description

Returns the current Audit Logging Configuration settings, including the different components in the TCPWave IPAM and their logging status.
Below example shows sample request URL:
rest/audit/auditLoggingConfigDetails

Responses
HTTP Code Description Schema

200

successful operation

< Audit Log Configuration for a component > array

Produces
  • application/json

  • application/xml

4.11.2. Update Audit Logging Configuration Information.

POST /audit/configUpdate
Description

Updates the Audit Logging Configuration to enable/disable audit logging for different components in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Body

body
required

List of Audit Logging Configurations

< Audit Log Configuration for a component > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-8602: Configuration type is empty, TIMS-8603: Configuration type does not exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.11.3. License Details

GET /audit/license
Description

Obtains the License information from the TCPWave IPAM. A new license key can be procured by contacting the TCPWave Customer Care team or a distributor or a reseller in your region.

Responses
HTTP Code Description Schema

200

successful operation

License Data

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.11.4. Update License

POST /audit/license/update
Description

Updates the TCPWave IPAM product License on the management appliance. Only Functional Admin can update the license information. A new license key can be procured by contacting the TCPWave Customer Care team or a distributor or a reseller in your region.
Below example shows sample request JSON:
"keyBytes":"h24fgdkfjdhk4hd8983shh85jkdjkh9"

Parameters
Type Name Description Schema Default

Query

address
required

Appliance Address

string

Query

name
required

Appliance Name

string

Body

body
optional

string

Responses
HTTP Code Description Schema

200

successful operation

License Data

500

TIMS-3901: Invalid License Key specified.

No Content

Consumes
  • application/json

Produces
  • application/json

  • application/xml

4.11.5. Audit Log List

GET /audit/page
Description

Obtains a list of audit logs from the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Query

description
optional

Description of each record

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

end_date
optional

End Date for fetching Records

string

Query

filterRules
optional

Filter String

string

Query

ipamIpAddress
optional

IPAM IP Address

string

Query

length
optional

Page Length

integer(int32)

Query

login_name
optional

Name of Admin

string

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

remote_ip
optional

IP Address

string

Query

session_id
optional

Session ID

string

Query

sort
optional

Sort String

string

Query

start
optional

Starting IPV4 Network Range

integer(int32)

Query

start_date
optional

Start Date for fetching Records

string

Query

success
optional

If operation is successful?(YES/NO)

boolean

Query

target
optional

Entity type(Network/Subnet/Object/Database)

string

Query

target_instance
optional

Entity(Network-192.168.1.10)

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Entry

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.11.6. Searches Change Tickets

GET /audit/search
Description

Lists searched Audit History data in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
optional

Ending Network Range

integer(int32)

Query

order
optional

Sorting Order(asc/desc)

string

Query

sort
optional

Sorting String

string

Query

start
optional

Starting Network Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAuditHistory

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12. Audit Report Service

Description

This service provides API access to perform admin group operations. Operations include add an admin group, update an admin group, list admin group, delete an admin group, retrieve admin group permissions and update admin group permissions.

4.12.1. DNS Appliance List

GET /auditreports/DNSLiveServerlist
Description

Provides a list of existing DNS Appliances and deleted DNS Appliances for auditing purposes.
Below is the example request:
/tims/rest/reports/DNSLiveServerlist?organization=Internal

Parameters
Type Name Description Schema Default

Query

organizations
required

Organization

string

Responses
HTTP Code Description Schema

200

successful operation

< Server Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.2. Action List

GET /auditreports/actionslist
Description

User can obtains Action list defined in the TCPWave IPAM .Example operation:add,operation: delete .
Below example shows sample request URL:
rest/auditreports/actionslist

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.3. Admin Role List

GET /auditreports/adminroleslist
Description

Obtains a list of administrator types (eg. FADM, SADM etc.) defined in the TCPWave IPAM. Please refer to the product documentation for additional information about the various administrator types.
Below example shows sample request URL:
/rest/auditreports/adminroleslist?page=1&rows=20

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.4. Admin List

GET /auditreports/adminslist
Description

Obtains a list of administrators defined in the TCPWave IPAM. Please refer to the product documentation for additional information about the various administrator types.
Below is the example request:
/tims/rest/auditreports/adminslist?actionType=active

Parameters
Type Name Description Schema Default

Query

actionType
required

Action Type

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.5. IPV4 Network List

GET /auditreports/auditnetworkslist
Description

Obtains a list of active networks or deleted networks for auditing purposes.
Below is the example request:
/tims/rest/auditreports/auditnetworkslist?actionType=active&org_id=1641&draw=1&start=0&length=10&filterRules=[{"field":"networkAddress","op":"contains","value":"2"}]

Parameters
Type Name Description Schema Default

Query

actionType
required

Network status - active/deleted

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Search Network

string

Query

length
required

Page Length

integer(int32)

Query

org_id
required

Organization ID

integer(int32)

Query

q
optional

Filter string

string

Query

start
required

Starting Page Number

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.6. Zone List

GET /auditreports/auditzoneslist
Description

Description: This operation returns a list of active or deleted DNS zones for auditing purposes.
Example:
/tims/rest/auditreports/auditzoneslist?actionType=active&reportType=Zone&org_id=1641&draw=1&start=0&length=10&filterRules=[{"field":"name","op":"contains","value":"m"}]

Parameters
Type Name Description Schema Default

Query

actionType
required

Zone status - active/deleted

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Search Zone

string

Query

length
required

Page Length

integer(int32)

Query

org_id
optional

Organization ID

integer(int32)

Query

org_name
required

Organization Name

string

Query

q
optional

Filter String

string

Query

reportType
optional

Report Type

string

Query

start
required

Starting Page Number

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.7. DHCP Appliance List

GET /auditreports/dhcpliveserverlist
Description

Provides a list of existing DHCP Appliances and deleted DHCP Appliances for auditing purposes.
Below is the example request:
/tims/rest/auditreports/dhcpliveserverlist?organization=Internal

Parameters
Type Name Description Schema Default

Query

organizations
required

Organization

string

Responses
HTTP Code Description Schema

200

successful operation

< Server Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.8. Lists all Columns for DHCP Query Report

GET /auditreports/dhcpqueryrpt
Description

Provides list of all Columns for DHCP Query Audit Report grid in the TCPWave IPAM.
Below are the sample query parameter values accepted:
/tims/rest/reports/dhcpqueryrpt?reportType=dhcpqueryrpt&organization=Internal&v4_ipaddress=10.0.0.2&fromDate=03/01/2019&toDate=03/06/2019&draw=1&start=0&length=20&q=[]&sort=[]

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

fromDate
required

Starting date for fetching records

string

Query

ip_address
required

Appliance IP Address

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

order param(asc/desc)

string

Query

organization
required

Organization

string

Query

q
optional

Filter String

string

Query

reportType
required

Report type)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Page Number

integer(int32)

Query

toDate
required

Ending date for fetching records

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListDHCP Appliance Statistics Details

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.9. Lists DNS Query Per Second Report

GET /auditreports/dnsquerypersecondrpt
Description

Provides details of DNS Query Per Second Report grid in the TCPWave IPAM.
Below are the sample query parameter values accepted:
/tims/rest/reports/dnsquerypersecondrpt?reportType=dnsquerypersecondrpt&organization=Internal&ip_address=10.0.0.2&period=dailyBased&fromDate=03/01/2019&toDate=03/06/2019&draw=1&start=0&length=20&q=[]&sort=[]

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

fromDate
required

Starting date for fetching records

string

Query

ip_address
required

Appliance IP Address

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

order param(asc/desc)

string

Query

organization
required

Organization

string

Query

period
required

Period of Date(Daily, weekly, Monthly)

string

Query

q
optional

Filter String

string

Query

reportType
required

Report type)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Page Number

integer(int32)

Query

toDate
required

Ending date for fetching records

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.10. Lists DNS Query Rate By Client Report

GET /auditreports/dnsqueryratebymember
Description

Provides details of DNS Query Rate By Client Report details in the TCPWave IPAM.
Below are the sample query parameter values accepted:
/tims/rest/reports/dnsqueryratebymember?reportType=dnsqueryratebymemberrpt&organization=Internal&ipAddress_domainName=10.0.0.2&fromDate=03/01/2019&toDate=03/06/2019

Parameters
Type Name Description Schema Default

Query

fromDate
required

Starting date for fetching records

string

Query

ipAddress_domainName
required

DNS Appliance IP Address

string

Query

organization
required

Organization

string

Query

reportType
required

Report type)

string

Query

server_name
optional

DNS Appliance Name

string

Query

toDate
required

Ending date for fetching records

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.11. Email Report

POST /auditreports/emailreport
Description

User can send the generated audit report to the email address of the subscribed contacts present in the TCPWave IPAM.
Below example shows sample request:
email_recipients:"abc@gmail.com,reportType:Network/Subnet/Object" etc,Name of Network Admin:twcadm,Role of Admin:FADM/SADM/UADM/RADM,Operation executed by Admin:active/deleted

Parameters
Type Name Description Schema Default

Query

action
required

Operation executed by Admin(active/deleted)

string

Query

adminName
required

Name of Network Admin

string

Query

adminRole
required

Role of Admin (FADM/SADM/UADM/RADM)

string

Body

body
optional

Audit Report

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-9312: Current selection exceeds the allowable email rows limit than the global option default page rows. Please modify your criteria or use CSV file download.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.12.12. IPv4 Network Mask Length

GET /auditreports/ipv4Network
Description

Obtains list of existing IPv4 networks mask lengths for auditing purposes.
Below example shows sample request URL:
rest/auditreports/ipv4Network

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.13. IPv4 Subnet Subnets mask lengths

GET /auditreports/ipv4Subnet
Description

Obtains a list of existing IPv4 Subnets mask lengths for auditing purposes.
Below example shows sample request URL:
rest/auditreports/ipv4Subnet

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.14. ccTLDs Grid List

GET /auditreports/ofaccountriesgridlist
Description

Obtains a list of existing ccTLDs for auditing purposes.

Responses
HTTP Code Description Schema

200

successful operation

< string > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.15. Report chart list

GET /auditreports/reportchartlist
Description

Obtains a list to display the chart for reports.
Below is the example request:
/tims/rest/auditreports/reportchartlist?actionType=active&org_id=1641&draw=1&start=0&length=10&filterRules=[{"field":"networkAddress","op":"contains","value":"2"}]

Parameters
Type Name Description Schema Default

Query

actionType
optional

Action type

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

fromDate
required

Starting date for fetching records

string

Query

ipAddress_domainName
optional

IP address or domain name

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

order param(asc/desc)

string

Query

org_id
optional

Organization ID

integer(int32)

Query

organization
required

Organization Name

string

Query

period
optional

period

string

Query

reportType
required

Report types (Network/subnet/object etc)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Page Number

integer(int32)

Query

toDate
required

Ending date for fetching records

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.16. Admin Audit

GET /auditreports/reportlist
Description

Obtains a list of reports in grid for the audit reports in the TCPWave IPAM.
Below are the sample query parameter values accepted:
Report Type:Network/subnet/object etc
Starting date for fetching records:02/22/2019
Ending date for fetching records :02/22/2019
Action type:active/deleted
IP Address or domain name:10.11.0.2/8 /domain.com
User:twcadm
domain name:domain.com
Source IP address: 10.11.0.3/8
Record type:AAA/SOA etc
Change Ticket:12345/abcd etc
Organization ID:1656
Proxy value:(0/1)
Page Draw Param:1
Starting Page Number:1
Page Length:20
Filter string:
Action performed:add/edit/delete etc
Sort String:
order param(asc/desc):
MAC Address:aa:bb:cc:dd:ee:ff
Organization Name:Internal
, ID:1234

Parameters
Type Name Description Schema Default

Query

action
optional

Action performed

string

Query

actionType
optional

Action type

string

Query

change_ticket
optional

Change Ticket

string

Query

domain
optional

domain name

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

fromDate
required

Starting date for fetching records

string

Query

id
optional

ID

string

Query

ipAddress_domainName
optional

IP address or domain name

string

Query

length
required

Page Length

integer(int32)

Query

mac
optional

MAC Address

string

Query

order
optional

order param(asc/desc)

string

Query

org_id
optional

Organization ID

integer(int32)

Query

organization
optional

Organization Name

string

Query

period
optional

period

string

Query

proxy
optional

Proxy value(0/1)

integer(int32)

Query

record_type
optional

Record type

string

Query

reportType
required

Report types (Network/subnet/object etc)

string

Query

sort
optional

Sort String

string

Query

source_ip
optional

Source IP address

string

Query

start
required

Starting Page Number

integer(int32)

Query

toDate
required

Ending date for fetching records

string

Query

user
required

User

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

500

TIMS-8059: Please select report start date. TIMS-8060: Please select report end date.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.17. IPV4 Network List

GET /auditreports/switchportutilizationrpt
Description

Obtains the utilization of the switch ports.
Below is the example request:
/tims/rest/auditreports/switchportutilizationrpt?reportType=switchPortUtilization&command_id=TDCE_2022041014&draw=1&start=0&length=10]

Parameters
Type Name Description Schema Default

Query

command_id
required

Command Id

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Search Switch Port

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

reportType
required

Report type

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Page Number

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.18. IPv4 Subnet Template List

GET /auditreports/v4SubnetTemplatelist
Description

Provides a list of existing Active IPv4 Subnet Template and deleted IPv4 Subnet Template for auditing purposes.
Below is the example request:
/tims/rest/auditreports/v4SubnetTemplatelist?actionType=active&organization=Internal

Parameters
Type Name Description Schema Default

Query

actionType
required

Action type(active/deleted)

string

Query

organization
required

Oraganization

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.19. Threat Intelligence Report List

GET /auditreports/zeekreport
Description

Provides DNS Threat Intelligence Report details in the TCPWave IPAM.
Below is the example request:
rest/reports/zeekreport?reportType=dnsuniquesubdomainrpt&server_name=testappliance&ipAddress_domainName=10.0.0.2&period=3

Parameters
Type Name Description Schema Default

Query

ipAddress_domainName
required

Appliance IPaddress

string

Query

period
optional

DNS Query Length

string

Query

reportType
required

Report Type

string

Query

server_name
required

Appliance Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.20. DNS Appliance List

GET /reports/DNSLiveServerlist
Description

Provides a list of existing DNS Appliances and deleted DNS Appliances for auditing purposes.
Below is the example request:
/tims/rest/reports/DNSLiveServerlist?organization=Internal

Parameters
Type Name Description Schema Default

Query

organizations
required

Organization

string

Query

reportType
required

Report Type

string

Responses
HTTP Code Description Schema

200

successful operation

< Server Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.21. DHCP Active Server List

GET /reports/DhcpLeaseServerlist
Description

Provides a list of existing DHCP Appliances and deleted DHCP Appliances for auditing purposes.
Below is the example request:
/tims/rest/reports/DhcpLeaseServerlist?reportType=DhcpLeaseAudit&serverIp=10.11.0.7

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.22. DHCP Appliance Subnet List

GET /reports/DhcpServerSubnetlist
Description

Provides a list of active DHCP Appliances and deleted DHCP Appliances for auditing purposes.
Below is the example request:
tims/rest/reports/dhcpserversubnetreportlist?&reportType=DhcpServerSubnetRpt&ipAddress_domainName=10.11.0.8&draw=1&start=0&length=20&filterRules=[{"field":"subnet_address","op":"contains","value":"d"}]

Parameters
Type Name Description Schema Default

Query

actionType
required

Action type(active/deleted)

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.23. DHCP Appliance List

GET /reports/DhcpServerlist
Description

Provides a list of existing DHCP Appliances and deleted DHCP Appliances for auditing purposes.
Below is the example request:
/tims/rest/reports/DhcpServerlist?actionType=active

Parameters
Type Name Description Schema Default

Query

actionType
required

Action type(active/deleted)

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.24. Parameter List

GET /reports/allparams
Description

Provides a list of all parameters in DHCP option template report for auditing purposes.
Below is the example request:
/tims/rest/reports/allparams?server_type_code=DHCP&entity_type_code=OPTION&draw=1&start=0&length=10&filterRules=[{"field":"display_name","op":"contains","value":"r"}]

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

entity_type_code
required

Entity type

string

Query

filterRules
optional

Search DHCP Options

string

Query

length
required

Page Length

integer(int32)

Query

q
optional

Filter String

string

Query

server_type_code
required

Server Type Code

string

Query

start
required

Starting Page Number

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.25. DNS Views List

GET /reports/auditviewslist
Description

Provides a list of existing and deleted DNS Views for auditing purposes.
Below is the example request:
tims/rest/reports/auditviewslist?actionType=active&org_id=1640&draw=1&start=0&length=10&filterRules=[{"field":"name","op":"contains","value":"g"}]

Parameters
Type Name Description Schema Default

Query

actionType
required

Action type

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

org_id
required

Organization ID

integer(int32)

Query

q
optional

Search String

string

Query

start
required

Starting Page Number

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.26. Object Type List

GET /reports/clientserverslist
Description

Provides a list of client IPs for RPZ Logs auditing purposes.
Below is the example request:
/tims/rest/reports/clientserverslist

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.27. Cloud Instance Provisioning Report

GET /reports/cloudreportlist
Description

This report displays the AWS, Azure and google cloud add,edit and delete details.
Below are the sample query parameter values accepted:
/tims/rest/reports/cloudreportlist?fromDate=03/01/2019&toDate=03/06/2019

Parameters
Type Name Description Schema Default

Query

fromDate
required

Starting date for fetching records

string

Query

reportType
required

Report Type

string

Query

toDate
required

Ending date for fetching records

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.28. CSV Report

POST /reports/csvreport
Description

Provides a csv file for audit reports present in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Body

body
optional

Audit Report

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-9314: Export to CSV failed.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.12.29. DHCP active leases audit report

GET /reports/dhcpActiveLeases
Description

Provides report details in grid for DHCP active leases audit report in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Query

fromDate
required

Starting date for fetching records

string

Query

page
required

Total pages

integer(int32)

Query

reportType
required

Report types (Network/subnet/object etc)

string

Query

rows
required

Rows per page

integer(int32)

Query

serverIp
required

IP of the Server

string

Query

toDate
required

Ending date for fetching records

string

Responses
HTTP Code Description Schema

200

successful operation

PagedListDHCPLeaseObject

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.30. DHCP Pool Utilization Report

GET /reports/dhcpAppliancePoolUtilized
Description

DHCP Pool Utilization Report provides the Scope Utilized based on the Appliances.
Below is the example request:
/tims/rest/reports/dhcpAppliancePoolUtilized?serverName=zxcv&ip_address=10.0.0.2&reportType=dhcpv6poolusagerpt

Parameters
Type Name Description Schema Default

Query

ip_address
required

Appliance Address

string

Query

reportType
required

Report Type

string

Query

serverName
required

Appliance Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.31. DHCP active leases Audit Report

GET /reports/dhcpLeaseCsvReport
Description

Provides a csv file for DHCP active leases audit report present in the TCPWave IPAM.
Below is the example request:
/tims/rest/reports/dhcpLeaseCsvReport?reportType=dhcpLeaseCsvReport&serverIp=10.16.0.7

Parameters
Type Name Description Schema Default

Query

page
optional

Starting Page Number

integer(int32)

Query

reportType
required

Report types (dhcpLeaseCsvReport)

string

Query

rows
optional

Page Length

integer(int32)

Query

serverIp
required

IP of the Appliance

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.32. DHCP IPv4 Daily Peak Hour LPS Report

GET /reports/dhcpdailypeakqueryRpt
Description

This report displays the DORA (Discover Offer Request Acknowledgement) packets with LPS (Lease Per Seconds) details for the peak hour of the day for the selected appliances and date range.
Below are the sample query parameter values accepted:
/tims/rest/reports/dhcpdailypeakqueryRpt?organization=Internal&ipAddress_domainName=10.0.0.1&fromDate=03/01/2019&toDate=03/06/2019

Parameters
Type Name Description Schema Default

Query

fromDate
required

Starting date for fetching records

string

Query

ipAddress_domainName
required

DHCP Appliance IP Address

string

Query

organization
required

Organization Name

string

Query

reportType
required

Report Type

string

Query

toDate
required

Ending date for fetching records

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.33. DHCP Option Template Report

GET /reports/dhcpoptionconfigreportlist
Description

Provides report details in grid for DHCP Option Template Report in the TCPWave IPAM.
Below is the example request:
tims/rest/reports/dhcpoptionconfigreportlist?config_name=subnet-mask&param_val=&reportType=DhcpOptionTemplConfigRpt&draw=1&start=0&length=20&filterRules=[{"field":"template_name","op":"contains","value":"c"}]

Parameters
Type Name Description Schema Default

Query

action
optional

Action performed

string

Query

config_name
required

Config Name

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

order param(asc/desc)

string

Query

param_val
optional

parameter value

string

Query

q
optional

Search String

string

Query

reportType
required

Report types (DhcpOptionTemplConfigRpt)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Page Number

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.34. DHCP Option Template List

GET /reports/dhcpoptiontemplassolist
Description

Provides a list of active DHCP option template and deleted DHCP option template for auditing purposes.
Below is the example request:
/tims/rest/reports/dhcpoptiontemplassolist?draw=1&start=0&length=10&filterRules=[]

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

org_id
optional

Organization ID

integer(int32)

Query

org_name
required

Organization Name

string

Query

q
optional

Search String

string

Query

start
required

Starting Page Number

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.35. DHCP Option Template List

GET /reports/dhcpoptiontemplauditlist
Description

Provides a list of existing DHCP option template and deleted DHCP option template for auditing purposes.
Below is the example request:
/tims/rest/reports/dhcpoptiontemplauditlist?actionType=active&draw=1&start=0&length=10&filterRules=[{"field":"name","op":"contains","value":"c"}]

Parameters
Type Name Description Schema Default

Query

actionType
required

Action type

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

q
optional

Search String

string

Query

start
required

Starting Report Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.36. DHCP Policy Template List

GET /reports/dhcppolicytemplauditlist
Description

Provides a list of active DHCP policy template and deleted DHCP policy template for auditing purposes.
Below is the example request:
/tims/rest/reports/dhcppolicytemplauditlist?actionType=active

Parameters
Type Name Description Schema Default

Query

actionType
required

Action type(active/deleted)

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.37. DHCP Appliance Association audit report

GET /reports/dhcpserversubnetreportlist
Description

Provides report details in grid for DHCP Appliance Association audit report in the TCPWave IPAM.
Below is the example request:
/tims/rest/reports/dhcpserversubnetreportlist?&reportType=DhcpServerSubnetRpt&ipAddress_domainName=10.0.3.4&draw=1&start=0&length=20&filterRules=[{"field":"subnet_name","op":"contains","value":"h"}]

Parameters
Type Name Description Schema Default

Query

action
optional

Action

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

ipAddress_domainName
required

IP Address

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

order param(asc/desc)

string

Query

q
optional

Search String

string

Query

reportType
required

Report types (DhcpServerSubnetRpt)

string

Query

server_type
required

Appliance Type

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Page Number

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.38. DHCP Option Template Association Report

GET /reports/dhcptemplassoreportgrid
Description

Provides report details in grid for DHCP Option Template Association Report in the TCPWave IPAM.
Below are the sample query parameter values accepted:
/tims/rest/reports/dhcptemplassoreportgrid?reportType=dhcpTemplAssoSubnet&optionTempl=Manual DHCP Option Template-1&asso_type=subnet&draw=1&start=0&length=20&filterRules=[{"field":"endip","op":"contains","value":"1"}]

Parameters
Type Name Description Schema Default

Query

action
required

Action performed

string

Query

asso_type
required

Type of association of Option Template with DHCP Appliance

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

optionTempl
required

Name of Option Template

string

Query

order
optional

order param(asc/desc)

string

Query

organization
optional

Organization Name

string

Query

q
optional

Search String

string

Query

reportType
required

Report types (dhcpTemplAssoSubnet/dhcpTemplAssoScope/dhcpTemplAssoObj)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Page Number

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.39. Provide the disk size

GET /reports/disksizestatus
Description

Provide the disk size Information.
No parameter values accepted:

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.12.40. DNS AUTH Appliance

GET /reports/dnsappliancebyviewlist
Description

Provides a list of DNS Auth appliance which has views.
Below is the example request:
/tims/rest/reports/dnsappliancebyviewlist?actionType=active&reportType=dnsappliancebyview&org_id=1655

Parameters
Type Name Description Schema Default

Query

actionType
required

Action type

string

Query

org_id
optional

Organization ID

integer(int32)

Query

organization
required

Organization

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.41. DNS BIND and CACHE List

GET /reports/dnsbindandcachelist
Description

Provides a list of DNS BIND and CACHE List for auditing purposes.
Below is the example request:
tims/rest/reports/dnsbindandcachelist?org_id=1640

Parameters
Type Name Description Schema Default

Query

org_id
required

Organization

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.42. DNS Cache Appliance List

GET /reports/dnscacheserverslist
Description

Provides a list of cache appliance for RPZ Logs auditing purposes.
Below is the example request:
/tims/rest/reports/dnscacheserverslist

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.43. DNS Clients By Query Type Grid

GET /reports/dnsclientbyquerytypegrid
Description

Provides report details of DNS Clients By Query Type in the TCPWave IPAM.
Below are the sample query parameter values accepted:
/tims/rest/reports/dnsclientbyquerytypegrid?organization=Internal&ipAddress_domainName=10.0.0.1&fromDate=03/01/2019&toDate=03/06/2019

Parameters
Type Name Description Schema Default

Query

fromDate
required

Starting date for fetching records

string

Query

ipAddress_domainName
required

DNS Appliance IP Address

string

Query

organization
required

Organization Name

string

Query

reportType
required

Report Type

string

Query

server_name
optional

DNS Appliance Name

string

Query

toDate
required

Ending date for fetching records

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.44. Top DNS Clients Querying MX Records Grid

GET /reports/dnsclientquerymxrcdrptgrid
Description

Provides report details of Top DNS Clients Querying MX Records in the TCPWave IPAM.
Below are the sample query parameter values accepted:
/tims/rest/reports/dnsclientbyquerytypegrid?organization=Internal&ipAddress_domainName=10.0.0.1&fromDate=03/01/2019&toDate=03/06/2019

Parameters
Type Name Description Schema Default

Query

fromDate
required

Starting date for fetching records

string

Query

ipAddress_domainName
required

DNS Appliance IP Address

string

Query

organization
required

Organization Name

string

Query

reportType
required

Report Type

string

Query

server_name
optional

DNS Appliance Name

string

Query

toDate
required

Ending date for fetching records

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.45. DNS Daily Peak Hour Query Rate By Appliances Report

GET /reports/dnsdailypeakqueryRpt
Description

Provides report details of DNS Daily Peak Hour Query Rate By Appliance in the TCPWave IPAM.
Below are the sample query parameter values accepted:
/tims/rest/reports/dnsdailypeakqueryRpt?organization=Internal&ipAddress_domainName=10.0.0.1&fromDate=03/01/2019&toDate=03/06/2019

Parameters
Type Name Description Schema Default

Query

fromDate
required

Starting date for fetching records

string

Query

ipAddress_domainName
required

DNS Appliance IP Address

string

Query

organization
required

Organization Name

string

Query

reportType
required

Report Type

string

Query

toDate
required

Ending date for fetching records

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.46. DNS and DHCP Appliance List

GET /reports/dnsdhcpserverslist
Description

Provides a list of existing DNS Appliances and DHCP Appliances for auditing purposes.
Below is the example request:
/tims/rest/reports/dnsdhcpserverslist

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.47. NTP Offset List

GET /reports/dnsinstattrafficrpt
Description

Provides DNS Instant Traffic information of DNS appliances defined in the TCPWave IPAM.
Below is the example request:
rest/reports/dnsinstattrafficrpt?reportType=dnstrafficrpt&server_name=testserver&ipAddress_domainName=10.0.0.2

Parameters
Type Name Description Schema Default

Query

fromDate
optional

Starting date for fetching records

string

Query

ipAddress_domainName
required

Appliance IPaddress

string

Query

reportType
required

Report Type

string

Query

server_name
required

Appliance Name

string

Query

toDate
optional

Ending date for fetching records

string

Responses
HTTP Code Description Schema

200

successful operation

ReportDNSTraffic

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.48. DNS option template List

GET /reports/dnsoptiontemplauditlist
Description

Provides a list of existing DNS option template and deleted DNS option template for auditing purposes.
Below is the example request:
/tims/rest/reports/dnsoptiontemplauditlist?actionType=active

Parameters
Type Name Description Schema Default

Query

actionType
required

Action type(active/deleted)

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.49. Lists all Columns for DNS Query Report

GET /reports/dnsqueryrpt
Description

Provides list of all Columns for DNS Query Audit Report grid in the TCPWave IPAM.
Below are the sample query parameter values accepted:
/tims/rest/reports/dnsqueryrpt?reportType=dnsqueryrpt&organization=Internal&v4_ipaddress=10.0.0.2&fromDate=03/01/2019&toDate=03/06/2019&draw=1&start=0&length=20&q=[]&sort=[]

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

fromDate
required

Starting date for fetching records

string

Query

ip_address
required

Appliance IP Address

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

order param(asc/desc)

string

Query

organization
required

Organization

string

Query

q
optional

Filter String

string

Query

reportType
required

Report type)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Page Number

integer(int32)

Query

toDate
required

Ending date for fetching records

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListDNS Appliance Statistics Details

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.50. DNS Servers List

GET /reports/dnsserverslist
Description

Provides a list of existing DNS servers and deleted DNS servers for auditing purposes.
Below is the example request:
/tims/rest/reports/dnsserverslist?actionType=active

Parameters
Type Name Description Schema Default

Query

actionType
required

Action type(active/deleted)

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.51. DNS SERVFAIL Responses Report Grid

GET /reports/dnsservfailresponsesRpt
Description

Provides Domain and SERVFAIL count details for DNS SERVFAIL Responses Report in the TCPWave IPAM.
Below are the sample query parameter values accepted:
/tims/rest/reports/dnsservfailresponsesRpt?organization=Internal&ipAddress_domainName=10.0.0.1&fromDate=03/01/2019&toDate=03/06/2019

Parameters
Type Name Description Schema Default

Query

fromDate
required

Starting date for fetching records

string

Query

ipAddress_domainName
required

DNS Appliance IP Address

string

Query

organization
required

Organization Name

string

Query

reportType
required

Report Type

string

Query

server_name
optional

DNS Appliance Name

string

Query

toDate
required

Ending date for fetching records

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.52. DNS SOA Report CSV

GET /reports/dnssoareportcsv
Description

Provides a csv file for DNS SOA report present in the TCPWave IPAM.
Below is the example request:
/tims/rest/reports/dnssoareportgrid?reportType=dnsSOAreport&serverIp=10.11.0.6&serverName=zxcv12&server_type=DNS PROXY

Parameters
Type Name Description Schema Default

Query

page
optional

Starting Page Number

integer(int32)

Query

reportType
required

Report types (Network/subnet/object etc)

string

Query

rows
optional

Page Length

integer(int32)

Query

serverIp
required

IP of the Appliance

string

Query

serverName
required

Name of the Appliance

string

Query

server_type
required

Type of the Appliance

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.53. DNS SOA Report Grids

GET /reports/dnssoareportgrid
Description

Provides report details in grid for DNS SOA report in the TCPWave IPAM.
Below is the example request:
/rest/reports/dnssoareportgrid?reportType=dnsSOAreport&serverIp=10.11.0.3&serverName=kna81-qrs01-sl0984&server_type=BIND AUTH

Parameters
Type Name Description Schema Default

Query

page
required

Starting Page Number

integer(int32)

Query

reportType
required

Report types (dnsSOAreport)

string

Query

rows
required

Page Length

integer(int32)

Query

serverIp
required

IP of the Appliance

string

Query

serverName
required

Name of the Appliance

string

Query

server_type
required

Type of the Appliance

string

Responses
HTTP Code Description Schema

200

successful operation

PagedListSOA

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.54. DNS Statistics Per Zone Report List

GET /reports/dnsstatisticsperzoneaudit
Description

Provides DNS Statistics Per Zone Report information of each zone defined in the TCPWave IPAM.
Below is the example request:
rest/reports/dnsstatisticsperzoneaudit?reportType=dnsStatsPerZoneRpt&server_name=testserver&ipAddress_domainName=10.0.0.2&zone_name=test.com

Parameters
Type Name Description Schema Default

Query

ipAddress_domainName
required

Appliance IP

string

Query

reportType
required

Report Type

string

Query

server_name
required

Appliance Name

string

Query

zone_name
required

Zone Name

string

Responses
HTTP Code Description Schema

200

successful operation

ReportDNSStatsPerZone

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.55. DNS Template List

GET /reports/dnstemplatelist
Description

Provides a list of active DNS templates and deleted DNS templates for auditing purposes.
Below is the example request:
/tims/rest/reports/dnstemplatelist?actionType=active

Parameters
Type Name Description Schema Default

Query

actionType
required

Action type(active/deleted)

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.56. DNS To talkers List

GET /reports/dnstoptalkersrpt
Description

Provides DNS Top talkers information of DNS appliances defined in the TCPWave IPAM.
Below is the example request:
rest/reports/dnstoptalkersrpt?reportType=dnsTopTalkersReport&server_name=testappliance&ipAddress_domainName=10.0.0.7

Parameters
Type Name Description Schema Default

Query

ipAddress_domainName
required

Appliance IPaddress

string

Query

reportType
required

Report Type

string

Query

server_name
required

Appliance Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.57. Large DNS Responses Report List

GET /reports/dnszeekrpt
Description

Provides Large DNS Responses Report information of DNS appliances defined in the TCPWave IPAM.
Below is the example request:
rest/reports/dnsresponsesrpt?reportType=dnsResponsesRpt&server_name=testappliance&ipAddress_domainName=10.0.0.7&length=50

Parameters
Type Name Description Schema Default

Query

ipAddress_domainName
required

Appliance IPaddress

string

Query

length
required

Query Length

string

Query

reportType
required

Report Type

string

Query

server_name
required

Appliance Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.58. DNS Zone list

GET /reports/dnszonebyviewlist
Description

Provides DNS Zone list.
Below is the example request:
/tims/rest/reports/dnszonebyviewlist?actionType=active&org_id=1655

Parameters
Type Name Description Schema Default

Query

actionType
required

Action type

string

Query

org_id
optional

Organization ID

integer(int32)

Query

organization
required

Organization

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.59. Email Report

POST /reports/emailreport
Description

User can send the generated audit report to the email address of the subscribed contacts present in the TCPWave IPAM.
Below example shows sample request JSON:
email_recipients:"abc@gmail.com,reportType:Network/Subnet/Object" etc,Name of Network Admin:twcadm,Role of Admin:FADM/SADM/UADM/RADM,Operation executed by Admin:active/deleted

Parameters
Type Name Description Schema Default

Body

body
optional

Audit Report

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-9312: Current selection exceeds the allowable Email size. Please modify your criteria or use CSV file download.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.12.60. Last 100 Event List

GET /reports/last100eventslist
Description

Provides a list of last 100 events performed in the TCPWave IPAM
Below is the example request:
/tims/rest/reports/last100eventslist?fromDate=3/6/2019&toDate=3/6/2019&reportType=Last100Events&ipAddress_domainName=null

Parameters
Type Name Description Schema Default

Query

filterRules
optional

Filter String

string

Query

fromDate
required

Starting date for fetching records

string

Query

ipAddress_domainName
optional

IP Address or domain name

string

Query

page
required

Starting Report Range

integer(int32)

Query

q
optional

Search String

string

Query

reportType
required

Report types (Last100Events)

string

Query

rows
required

Page Length

integer(int32)

Query

toDate
required

Ending date for fetching records

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.61. Subnet Groups List

GET /reports/listsubnetgroup
Description

Provides a list of existing subnet groups for auditing purposes.
Below is the example request:
/tims/rest/reports/listsubnetgroup?draw=1&start=0&length=10&filterRules=[{"field":"name","op":"contains","value":"c"}]

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Search Subnet Group

string

Query

length
required

Page Length

integer(int32)

Query

q
optional

Filter String

string

Query

start
required

Starting Page Number

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.62. Host List

GET /reports/monitoringhostslist
Description

Provides a list of existing hosts for monitoring purposes.
Below is the example request:
/tims/rest/reports/monitoringhostslist

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.63. Monitoring Service List

GET /reports/monitoringserviceslist
Description

Provides a list of existing services for monitoring purposes.
Below is the example request:
/tims/rest/reports/monitoringserviceslist?host_id=12345

Parameters
Type Name Description Schema Default

Query

host_id
required

Host ID(eg:12345)

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.64. Microsoft Active Users Report Grid

GET /reports/msactiveusersrptgrid
Description

Provides report details in grid for Microsoft Active Users Report in the TCPWave IPAM.
Below are the sample query parameter values accepted:
/tims/rest/reports/msactiveusersrptgrid?organization=Internal&ipAddress_domainName=10.1.10.121

Parameters
Type Name Description Schema Default

Query

ipAddress_domainName
required

Microsoft Appliance IP Address

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< MicrosoftActiveUsers > array

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.12.65. Microsoft DHCP Pool Utilization Report Grid

GET /reports/msdhcppoolusagerptgrid
Description

Provides report details in grid for Microsoft DHCP Pool Utilization Report in the TCPWave IPAM.
Below are the sample query parameter values accepted:
/tims/rest/reports/msdhcppoolusagerptgrid?reportType=msdhcppoolusageRpt=1&start=0&length=20&filterRules=[{"field":"endip","op":"contains","value":"1"}]

Parameters
Type Name Description Schema Default

Query

ipAddress_domainName
required

Microsoft DHCP Appliance IP Address

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.66. MS DHCP Appliance List

GET /reports/msdhcpserverlist
Description

Provides a list of existing Microsoft DHCP Appliances for auditing purposes.
Below is the example request:
/tims/rest/reports/msdhcpserverlist?organization=Internal

Parameters
Type Name Description Schema Default

Query

organization
required

Organization

string

Query

reportType
required

Report Type

string

Responses
HTTP Code Description Schema

200

successful operation

< Microsoft Server Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.67. Microsoft DNS Event Report Grid

GET /reports/msdnsserverauditreportgrid
Description

Provides report details in grid for Microsoft DNS Appliance Report in the TCPWave IPAM.
Below are the sample query parameter values accepted:
/tims/rest/reports/msdnsserverauditreportgrid?reportType=msDNSServerAuditRepor=1&start=0&length=20&filterRules=[{"field":"endip","op":"contains","value":"1"}]

Parameters
Type Name Description Schema Default

Query

fromDate
required

Starting date for fetching records

string

Query

ip_address
required

Microsoft Appliance IP Address

string

Query

org_id
required

Organization ID

integer(int32)

Query

toDate
required

Ending date for fetching records

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.68. MS DNS Appliance List

GET /reports/msdnsserverlist
Description

Provides a list of existing Microsoft DNS Appliances for auditing purposes.
Below is the example request:
/tims/rest/reports/msdnsserverlist?organization=Internal

Parameters
Type Name Description Schema Default

Query

org_id
required

Organization

integer(int32)

Query

reportType
required

Report Type

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.69. NTP Offset List

GET /reports/ntpoffsetlist
Description

Provides NTP offset information of IPAM, DNS or DHCP appliances defined in the TCPWave IPAM.
Below is the example request:
/tims/rest/reports/ntpoffsetlist?reportType=ntpoffsetRpt&server_type=DNS

Parameters
Type Name Description Schema Default

Query

reportType
required

Report Type

string

Query

server_type
required

Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.70. Object Type List

GET /reports/objecttypelist
Description

Provides a list of existing object types for auditing purposes.
Below is the example request:
/tims/rest/reports/objecttypelist

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.71. Report chart list

GET /reports/reportchartlist
Description

Obtains a list to display the chart for reports.
Below is the example request:
/tims/rest/auditreports/auditnetworkslist?actionType=active&org_id=1641&draw=1&start=0&length=10&filterRules=[{"field":"networkAddress","op":"contains","value":"2"}]

Parameters
Type Name Description Schema Default

Query

actionType
optional

Action type

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

fromDate
required

Starting date for fetching records

string

Query

ipAddress_domainName
optional

IP address or domain name

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

order param(asc/desc)

string

Query

org_id
optional

Organization ID

integer(int32)

Query

organization
optional

Organization Name

string

Query

period
optional

period

string

Query

reportType
required

Report types (Network/subnet/object etc)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Page Number

integer(int32)

Query

toDate
required

Ending date for fetching records

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.72. Lists all Reports

GET /reports/reportlist
Description

Provides report details in grid for the audit reports in the TCPWave IPAM .
Below are the sample query parameter values accepted:
Starting date for fetching records:02/22/2019
Ending date for fetching records:02/22/2019
Action type:active/deleted
IP Address or domain name:10.11.0.3/8 /domain.com
Organization ID:1656
Organization Name:Internal
Page Draw Param:1
Starting Page Number:1
Page Length:1
Filter string:
Action performed :add/edit/delete etc
Sort String:
Appliance IP String:10.11.0.2
MAC Address:aa:bb:cc:dd:ee:ff
Host Name:abcd
order param(asc/desc):

Parameters
Type Name Description Schema Default

Query

action
optional

Action performed

string

Query

actionType
required

Action type

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

fromDate
required

Starting date for fetching records

string

Query

host_name
optional

Host Name

string

Query

ipAddress_domainName
required

IP Address or domain name

string

Query

length
required

Page Length

integer(int32)

Query

macAddress
optional

MAC Address

string

Query

order
optional

order param(asc/desc)

string

Query

org_id
optional

Organization ID

integer(int32)

Query

organization
optional

Organization Name

string

Query

reportType
required

Report types (Network/subnet/object etc)

string

Query

serverIp
optional

Appliance IP String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Page Number

integer(int32)

Query

toDate
required

Ending date for fetching records

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.73. Lists all Columns for DNS RPZ Events By Appliance

GET /reports/rpzlogsgridlist
Description

Provides RPZ log report details in the TCPWave IPAM.
Below are the sample query parameter values accepted:
/tims/rest/reports/rpzlogsgridlist?reportType=rpzLogsRpt&draw=1&start=0&length=20&filterRules=[{"field":"cache_dns_server","op":"contains","value":"d"}]

Parameters
Type Name Description Schema Default

Query

action
optional

Action performed

string

Query

clientIp
required

Client IP

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

order param(asc/desc)

string

Query

q
optional

Search String

string

Query

reportType
required

Report type)

string

Query

serverIp
required

IP of DNS Cache server

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Page Number

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.74. Schedule Report Email

POST /reports/sched_emailreport
Description

User can Schedule the time to email the report in PDF format to the email address of the contacts present in the TCPWave IPAM.
Below example shows the sample request JSON:
{"reportType":"Zone","a1":"all","dropdown_status":"active","ipAddress_domainName":"test.com","fromDate":"08/20/2019","toDate":"08/23/2019","email_recipients":"Test@tcpwave.com"}

Parameters
Type Name Description Schema Default

Query

adminName
required

Name of Network Admin who is scheduling the email

string

Query

adminRole
required

Role of the Admin (FADM/SADM/UADM/RADM)

string

Query

day
required

Day of Execution of the scheduled operation

integer(int32)

Query

description
required

Description about the scheduled operation

string

Query

endtime
required

Ending time for executing the scheduled operation

string

Query

frequency
required

Frequency of the scheduled operation

string

Query

repeat
required

Occurrences of the scheduled operation

integer(int32)

Query

repeatCount
required

Count for repetition of scheduled operation

integer(int32)

Query

repeatInterval
required

Time duration between repetition of the scheduled operation

integer(int64)

Query

runtime
required

Execution time of the scheduled operation

string

Query

starttime
required

Starting time for executing the scheduled operation

string

Body

body
optional

Audit Report

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.12.75. Administrator List

GET /reports/scheduleadminauditlist
Description

Provides a list of existing administrator and deleted administrator for auditing purposes.
Below is the example request:
/tims/rest/reports/scheduleadminauditlist?actionType=active

Parameters
Type Name Description Schema Default

Query

actionType
required

Action type(active/deleted)

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.76. Schedule Events Audit Report

GET /reports/schedulereportlist
Description

Provides report details in grid for Schedule Events audit report in the TCPWave IPAM.
Below is the example request:
/tims/rest/reports/schedulereportlist?fromDate=03/01/2019&toDate=03/06/2019&reportType=ScheduleAuditRpt&ipAddress_domainName=Event,Script,Callback,Rest,Patch,&userId=2527&draw=1&start=0&length=20&filterRules=[{"field":"action_by","op":"contains","value":"s"}]

Parameters
Type Name Description Schema Default

Query

action
optional

Action performed

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

fromDate
required

Starting date for fetching records

string

Query

ipAddress_domainName
optional

Job Type

string

Query

jobId
optional

ID of the current Job

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

order param(asc/desc)

string

Query

q
optional

Search String

string

Query

reportType
required

Report types (ScheduleAuditRpt)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Page Number

integer(int32)

Query

toDate
required

Ending date for fetching records

string

Query

user
optional

ID of the active User

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.77. DNS Appliances List

GET /reports/serverConfigReportlist
Description

Provides a list of existing DNS Appliances for auditing purposes.
Below is the example request:
/tims/rest/reports/serverConfigReportlist

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.78. Appliance configuration audit report

GET /reports/serverConfigreportlist
Description

Provides report details in grid for Appliance configuration audit report in the TCPWave IPAM.
Below is the example request:
/tims/rest/reports/serverConfigreportlist?fromDate=03/01/2019&toDate=03/06/2019&reportType=serverConfigurationAuditRpt&ipAddress_domainName=10.11.0.2&server_type=Banner,NTP,SNMP,TACACS,ROUTING,ZEBRA,VIPS,NIC,SYSLOG,TIMEZONE,&draw=1&start=0&length=20&filterRules=[{"field":"action_type","op":"contains","value":"c"}]

Parameters
Type Name Description Schema Default

Query

action
optional

Action performed

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

fromDate
required

Starting date for fetching records

string

Query

ipAddress_domainName
required

IP Address of this domain

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

order param(asc/desc)

string

Query

q
optional

Search String

string

Query

reportType
required

Report types (Network/subnet/object etc)

string

Query

server_type
required

Type of the Server (DNS/DHCP)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Page Number

integer(int32)

Query

toDate
required

Ending date for fetching records

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.79. DNS Server to zone count result

GET /reports/servertozonecount
Description

Provides DNS Zone Allocation Chart in the TCPWave IPAM Dashboard.
Below are the sample query parameter values accepted:
/rest/reports/servertozonecount?organization_name=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization List

string

Responses
HTTP Code Description Schema

200

successful operation

PagedListAudit Report Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.80. Lists all Columns for DNS Views Report

GET /reports/viewsgridlist
Description

Provides list of all Columns for DNS Views Audit Report grid in the TCPWave IPAM.
Below are the sample query parameter values accepted:
/tims/rest/reports/viewsgridlist?fromDate=03/01/2019&toDate=03/06/2019&reportType=viewsAuditReport&view_name=dns_view&org_id=1655&draw=1&start=0&length=20&filterRules=[]

Parameters
Type Name Description Schema Default

Query

action
optional

Action performed

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Search DNS Views

string

Query

fromDate
required

Starting date for fetching records

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

order param(asc/desc)

string

Query

org_id
optional

Organization ID

integer(int32)

Query

q
optional

Filter String

string

Query

reportType
required

Report type)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Page Number

integer(int32)

Query

toDate
required

Ending date for fetching records

string

Query

view_name
required

Name of the View

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.12.81. Zone Template List

GET /reports/zonetemplauditlist
Description

Provides a list of existing zone templates and deleted zone templates for auditing purposes.
Below is the example request:
/tims/rest/reports/zonetemplauditlist?actionType=active

Parameters
Type Name Description Schema Default

Query

actionType
required

Action type(active/deleted)

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.13. Audit Data Backup Files Service

4.13.1. Audit Backup files List

GET /auditbackup/list
Description

Provides a list of audit backup files uploaded in the TCPWave IPAM.
Below example shows the sample request URL:
/rest/auditbackup/list

Responses
HTTP Code Description Schema

200

successful operation

< AuditBackup > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.13.2. Audit Backup files List

GET /auditbackup/listsearchbackupfiles
Description

Provides a list of audit backup files uploaded in the TCPWave IPAM.
Below example shows the sample request URL:
/rest/auditbackup/listsearchbackupfiles?searchVal=test.com

Parameters
Type Name Description Schema Default

Query

searchVal
required

search Value

string

Responses
HTTP Code Description Schema

200

successful operation

< AuditBackup > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.13.3. Backup Audit

GET /auditbackup/reportlistbydate
Description

Obtains a backup report in grid in the TCPWave IPAM.
Below are the sample query parameter values accepted:
Starting date for fetching records:02/22/2019
Ending date for fetching records :02/22/2019
Page Draw Param:1
Starting Page Number:1
Page Length:20
Filter string:
Sort String:
order param(asc/desc):

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

fromDate
required

Starting date for fetching records

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

order param(asc/desc)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Page Number

integer(int32)

Query

toDate
required

Ending date for fetching records

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

500

TIMS-8059: Please select report start date. TIMS-8060: Please select report end date.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.13.4. Audit Backup Report by file name

GET /auditbackup/reportlistbyfilename
Description

Provides a list of audit backup data from the uploaded backup file in the TCPWave IPAM.
Below example shows the sample request URL:
/rest/auditbackup/reportlistbyfilename?fileName=audit_history_attachment_backup_7_2019.csv&start=0&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

fileName
required

File Name

string

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

order param(asc/desc)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Page Number

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.14. Authentication Configuration Service

Description

This service provides the API to list and modify the current authentication configuration of the TCPWave IPAM. The information includes Minimum Password Length, Password Complexity ( 1- Alpha Numeric, 2 - Alpha Numeric with minimum one Capital Letter, 3 - Alpha Numeric with minimum one special character ), Allow Similar passwords as previous, Password Expiration time in days, Password reuse criteria, Maximum failed login attempts by the user before the account is locked, whether a newly created user has to change password during first login, and the idle time out for session etc.

4.14.1. Edit Authentication

POST /authconf/edit
Description

Modifies the TCPWave IPAM authentication configuration parameter values. Users can tune the behavior of the authentication mechanism to align with their organization security policy. Some of the parameters that can be modified from this interface includes - Minimum Password Length, Password Complexity ( 1- Alpha Numeric, 2 - Alpha Numeric with minimum one Capital Letter, 3 - Alpha Numeric with minimum one special character ), Allow Similar passwords as previous, Password Expiration time in days, Password reuse criteria, Maximum failed logins attempts by the user before the account is locked, whether a newly created user has to change password during first login and the idle time out for session. Please refer to the TCPWave IPAM Administration Reference Manual for additional information.
Below example shows sample request JSON:
{"min_password_length":"8","password_complexity":"2","allow_similar":"false","password_expiration":"60","password_reuse":"5","max_failed_attempts":"5","require_new_password":"false","session_timeout":"3600","warn_timeout":"3540"}

Parameters
Type Name Description Schema Default

Body

body
optional

Authentication Configuration

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.14.2. Get Authentication Configuration

GET /authconf/get
Description

Obtains the current authentication configuration parameter values. For a comprehensive list of the parameters and their significance, please refer to the TCPWave IPAM Administrator Reference Manual.
Below example shows sample request URL:
rest/authconf/get

Responses
HTTP Code Description Schema

200

successful operation

Authentication Configuration

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.15. Authentication Permission Service

Description

This service provides API's to add, edit, delete and get permission for Administrator/Administrator Groups in the TCPWave IPAM.

4.15.1. Create Administrator/Administrator Group’s Permission

POST /authPermission/create
Description

Create an authentication permission
Below example shows sample request JSON:
{"level":1,"privilege":4,"selectAll":0,"organizationID":1700,"organizationName":"Internal","functionName":"Appliance Groups","levelID":1014,"roleId":7,"role":"CADM","targetList":{"Appliance Groups":[118]}}

Parameters
Type Name Description Schema Default

Body

body
required

Administrator Permission Create

Permission

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation., TIMS-15077: Authorization function’s target list cannot be empty.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.15.2. Create Administrator Permission

POST /authPermission/create-entity-permission
Description

Create an authentication permission
Below example shows sample request JSON:
{"level":1,"privilege":4,"selectAll":0,"organizationID":1700,"organizationName":"Internal","functionName":"Appliance Groups","levelID":1014,"roleId":7,"role":"CADM","targetList":{"Appliance Groups":[118]}}

Parameters
Type Name Description Schema Default

Body

body
required

Auth Permission Create

< Permission > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.15.3. Delete Administrator Permission

POST /authPermission/delete
Description

Delete an authentication permission
{"id":118,"permissionLevel":"admin","level":0,"levelID":22327,"functionID":59,"targetID":null,"functionName":"IPv4 Objects","functionValue":"10.1.10.5","adminGroupName":null,"adminName":"nadm","privilege":2,"organizationName":"Internal","organizationID":1700,"selectAll":0,"roleId":7,"role":null,"targetList":null}

Parameters
Type Name Description Schema Default

Body

body
required

Auth Permission Delete

< Permission > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.15.4. Permissions List

GET /authPermission/entity/list
Description

Get the list of all the Administrator/Administrator Groups Permissions for specified function defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/authPermission/list/entity/list?fnName=functionName&fnValueIDs=fnValueIDs&org=orgName

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

fnName
required

Function Name

string

Query

fnValueIDs
required

Comma separated Function Value’s IDs

string

Query

org
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Permission > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.15.5. Permissions List

GET /authPermission/list
Description

Get the list of all the Administrator and Administrator Group Permissions defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/authPermission/list?start=1&length=20

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organization list

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Permission Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListPermission

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.15.6. Permission Search

GET /authPermission/search
Description

Searches for a given authentication permission in the TCPWave IPAM with giving input string.
The example listed below shows a sample request URL:
/rest/authPermission/search?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organization list

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Template Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListPermission

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.15.7. Update Administrator Permission

POST /authPermission/update
Description

Update an authentication permission{"id":118,"permissionLevel":"admin","level":0,"levelID":22327,"functionID":59,"targetID":null,"functionName":"IPv4 Objects","functionValue":"10.1.10.5","adminGroupName":null,"adminName":"nadm","privilege":"2","organizationName":"Internal","organizationID":1700,"selectAll":0,"roleId":7,"role":null,"targetList":null}

Parameters
Type Name Description Schema Default

Body

body
required

Authentication Permission Update

Permission

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.16. Authentication Token Management

Description

This service provides the API to list, generate, and deactivate authentication tokens in TCPWave IPAM. These tokens provide one way of securing the REST API to the TCPWave IPAM from third party applications.

4.16.1. Session Token Deactivate

POST /auth_token/deactivate
Description

Deactivates a Session Token in the TCPWave IPAM. Functional Admin can deactivate any token in the system where as other admins can revoke only the tokens generated by them. Once revoked, the REST API calls from the external application using this token will no longer be authorized.
Below example shows sample request JSON (session token):
["8ac763ea-6855-47a3-ac1d-5ebaf94cd066"]

Parameters
Type Name Description Schema Default

Body

body
optional

< string > array

Responses
HTTP Code Description Schema

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

4.16.2. Get Auth Token

POST /auth_token/get
Description

An internal service call used by the TCPWave IPAM to generate a Session Token based on the current logged in users credentials. This call works only if there is an HTTP Session associated that is generated through TIMS login mechanism and therefore not meant for external REST API integration.
Below example shows sample request JSON:
{"application":"Session-test","ip":"10.1.0.3","description":"session token"}

Parameters
Type Name Description Schema Default

Body

body
optional

Authentication Token

Responses
HTTP Code Description Schema

200

successful operation

Authentication Token Response

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.16.3. Session Token List

GET /auth_token/list
Description

Obtains a list of all the Session Tokens defined in the TCPWave IPAM. Functional Admin can list all the Session Tokens. Rest of the users can see only the session tokens that they generated.
The example listed below shows a sample request URL:
rest/auth_token/list

Responses
HTTP Code Description Schema

200

successful operation

< Authentication Token > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.17. Authentication Type

Description

This service provides the API to list the various authentication mechanisms supported by the TCPWave IPAM the and shows the current active mechanism selected. It also provides an interface to select a particular mechanism as the active authentication mechanism, provided the pre-conditions for that mechanism are satisfied.

4.17.1. Active Authentication Configuration

GET /authtype/getactive
Description

Gets the active authentication mechanism used by the TCPWave IPAM.
The example listed below shows a sample request URL:
/authtype/getactive

Responses
HTTP Code Description Schema

200

successful operation

Authentication Type

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.17.2. Authentication Configuration List

GET /authtype/list
Description

Obtains a list of Authentication mechanisms supported in the TCPWave IPAM . Currently supported mechanisms include Kerberos-Active Directory, LDAP, PAM, RADIUS, TACACS+, and TIMS internal authentication mechanism.
The example listed below shows a sample request URL:
/tims/rest/authtype/list

Responses
HTTP Code Description Schema

200

successful operation

< Authentication Type > array

500

TIMS-4061: TACACS+ Server is not configured. TIMS-4064: RADIUS Server is not configured. TIMS-4067: LDAP Server is not configured. TIMS-4070: KERBEROS Key Distribution Center (KDC) is not configured.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.17.3. Authentication Set Active

POST /authtype/setactive
Description

Sets a given authentication mechanism as active in the TCPWave IPAM. This property can be changed only by the UADM or a FADM. The call will succeed only if the necessary conditions for the authentication mechanism are defined in the global options and are functional. For comprehensive list of the supported authentication mechanisms, please refer to the TCPWave IPAM Administrator Reference Manual.
The example listed below shows a sample request URL:
/authtype/setactive?code=PAM

Parameters
Type Name Description Schema Default

Query

code
required

Authentication Code

string

Responses
HTTP Code Description Schema

500

TIMS-4000: Invalid authentication type code specified.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.18. Authorization Information

Description

This service provides the API to list and manage the permissions to network elements in the TCPWave IPAM.

4.18.1. Add permissions to an entity

POST /permission/add
Description

Manages the permissions on an Object, Subnet, Network or a Subnet Group for Admins and Admin Groups. Input is specified as AuthorizationInfo structure of the following format - target_type - Identifies the resource for which permissions are being granted. It is a single character that can take the following valid values -'N' (Network), 'S' (Subnet), 'O' (Object), and 'G' (Subnet Group) The instances of the entity for which the permissions are being granted are specified using either target_ids 'or' target_names. Using target_ids we can identify the instance using the internal database ID of the instance. This is generally used from the GUI where the ID information is already available. From CLI and External Applications target_names will be used to identify the instance. In case of Network and Subnet the start address is specified, for Object the address of the object is specified and in case of the Subnet Group the group name is specified. groups - List of Admin groups that are granted with the permissions, admins - List of admins that are granted with the permissions. The previous permissions on the resources are removed and permissions are granted to the specified admins and admin groups.
The example listed below shows a sample request URL:
/rest/permission/view?target_type=N&org_name=Internal

Parameters
Type Name Description Schema Default

Query

org_id
optional

organization ID

integer(int32)

Query

org_name
required

organization name

string

Body

body
optional

Permission Information

Responses
HTTP Code Description Schema

500

TIMS-4011: Target type is not valid, TIMS-4012: Admin group is not valid.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.18.2. Add permissions

POST /permission/addmultiple
Description

Add permissions to an entity in the TCPWave IPAM.
Below example shows sample request JSON:
[{ "admins":[ {"name":"jdoe", "level":"N", "authorized":"true"} ],"target_names":["10.1.10.2", "10.1.10.3"],"target_type":"N" }]

Parameters
Type Name Description Schema Default

Query

org_id
optional

organization ID

integer(int32)

Query

org_name
required

organization name

string

Body

body
optional

< Permission Information > array

Responses
HTTP Code Description Schema

500

TIMS-4011: Target type is not valid, TIMS-4012: Admin group is not valid.

No Content

Consumes
  • application/json

  • application/xml

4.18.3. Permissions List

GET /permission/list
Description

Obtains a list of permissions associated with an entity. Returns the list of users and admin groups from the organization that the entity belongs to and the permissions that the entity has in the TCPWave IPAM. This is used in the TCPWave IPAM GUI Edit Permissions screen to show the existing permissions and allow for a change of permissions. The permissions are marked if they are derived permissions - eg., permissions on an object inherited from the permission on a subnet or network, and if the permissions are granted to the individual admin or at a admin group level.
The example listed below shows a sample request URL:
/rest/permission/list?target_type=N&org_name=Internal&target_name=10.0.0.0

Parameters
Type Name Description Schema Default

Query

org_id
optional

organization ID

integer(int32)

Query

org_name
required

organization name

string

Query

target_id
optional

target entity id(i.e Network ID)

integer(int32)

Query

target_name
required

target entity name(i.e Network name)

string

Query

target_type
required

entity type N(network)/S(sub-net)/G(subnetgroup)/D(Domain)/O(object)

string

Responses
HTTP Code Description Schema

200

successful operation

Permission Information

500

TIMS-1100: Both Organization Id and Organization Name cannot be null, TIMS-1101: Cannot find organization, TIMS-1100: Both Target Id and Target Name cannot be null, TIMS-1100: Cannot find target.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.18.4. Permissions View

GET /permission/view
Description

Lists the Admins and Admin Groups that have permissions on the given entity. This is used in the TCPWave IPAM GUI to show read-only view of the permissions. The permissions are marked if they are derived permissions - eg., permissions on an object inherited from the permission on a subnet or network, and if the permissions are granted to the individual admin or at a admin group level.
The example listed below shows a sample request URL:
/rest/permission/view?target_type=N&org_name=Internal&target_name=10.0.0.0

Parameters
Type Name Description Schema Default

Query

org_id
optional

organization ID

integer(int32)

Query

org_name
required

organization name

string

Query

target_id
optional

entity id (i.e Network ID)

integer(int32)

Query

target_name
required

entity name (Name of the subnet group or address of Network/Subnet/Object/Domain)

string

Query

target_type
required

entity type N(network)/S(sub-net)/G(subnetgroup)/O(object)/N6(ipv6network)/S6(ipv6sub-net)/G6(ipv6 subnetgroup)/O6(ipv6 object)/D(Domain)

string

Responses
HTTP Code Description Schema

200

successful operation

Permission Information

500

TIMS-1100: Both Organization Id and Organization Name cannot be null, TIMS-1101: Cannot find organization, TIMS-1100: Both Target Id and Target Name cannot be null, TIMS-1100: Cannot find target

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.19. Autonomous System Number Service

4.19.1. Add Autonomous System Number

POST /asn/add
Description

This operation creates a new autonomous system number in the TCPWave IPAM.
Example:
{"name":"myasn","organization_name":"Internal","description":"test""as_number":"12345""email_id":""q@gmail.com","}

Parameters
Type Name Description Schema Default

Body

body
required

Autonomous System Number details.

Autonomous System Number

Responses
HTTP Code Description Schema

500

TIMS-1916: Organization name cannot be null. TIMS-1352: Organization does not exist: {0}, TIMS-15111: Autonomous System Number already exists: {0}.,TIMS-15112: Autonomous System Number does not exist: {0}.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.19.2. Delete Autonomous System Number

GET /asn/delete
Description

This operation deletes the autonomous system number present in the TCPWave IPAM.
Example:
/rest/asn/delete?name=myasn&organization=orgName

Parameters
Type Name Description Schema Default

Query

as_number
required

Provider Name

integer(int64)

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • text/plain

  • application/json

Produces
  • application/json

  • application/xml

4.19.3. Edit Autonomous System Number

POST /asn/edit
Description

This operation updates an existing autonomous system number in the TCPWave IPAM.
Example:
{"name":"myasn","organization_name":"Internal""as_number":"12345""oldName":"Test","email_id":""q@gmail.com","description":"Testing","}

Parameters
Type Name Description Schema Default

Body

body
required

Autonomous System Number details.

Autonomous System Number

Responses
HTTP Code Description Schema

500

TIMS-1916: Organization name cannot be null. TIMS-1352: Organization does not exist: {0}, TIMS-15111: Autonomous System Number already exists: {0}.,TIMS-15112: Autonomous System Number does not exist: {0}.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.19.4. Autonomous System Number details

GET /asn/get
Description

This operation retrieves the details of an autonomous system number in the TCPWave IPAM.
Example:
/rest/asn/get?name=asn&organization=orgName

Parameters
Type Name Description Schema Default

Query

as_number
required

AS Number

integer(int64)

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Autonomous System Number

500

TIMS-12074: Provider name cannot be null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.19.5. List AS Numbers

GET /asn/list
Description

This operation retrieves the list of autonomous system numbers present in the TCPWave IPAM.
Example:
/tims/rest/asn/list?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Comma Separated Organization Names

string

Query

sort
optional

Sort String

string

Query

start
required

Starting AS Number Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAutonomous System Number

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.20. Bookmark Service

Description

This service provides API's to obtain list of bookmarks defined in the TCPWave IPAM by the user and to create a new bookmark in the TCPWave IPAM.

4.20.1. Add bookmark

POST /bookmark/add
Description

Creates a new bookmark in the TCPWave IPAM. Bookmark is a shortcut created by user for easy navigation. These bookmarks are displayed in the left side navigation menu of the TCPWave IPAM GUI screens and will take the control to the bookmarked screen when clicked. Bookmarks can be placed on Networks, Subnets, and Objects and are created selecting create book mar menu item on the context-menu. Bookmarks are used from within TCPWave IPAM GUI.
Below example shows sample request JSON:
{"type":"ipamAppliance","value":"TIMS-125","queryString":"address=192.168.0.125&isEdit=true","user":"twcadm","orgName":null,"orgId":null}

Parameters
Type Name Description Schema Default

Body

body
required

Bookmark Details

Bookmark

Responses
HTTP Code Description Schema

500

TIMS-1025: Organization id is not valid: 59912018: Bookmarks limit has reached to maximum({0}) for the user as defined in global option. Please delete existing bookmarks or increase maximum limit of global option: Maximum Allowed Bookmarks.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.20.2. Delete Bookmark

POST /bookmark/delete
Description

Deletes a bookmark previously created in the TCPWave IPAM by the user.
Below example shows sample request url:
/bookmark/delete?queryString=10.1.10.0/24&type=Network

Parameters
Type Name Description Schema Default

Query

id
optional

ID of the selected record

integer(int32)

Query

queryString
required

Information of selected record (i.e. address=192.168.0.120&type=BIND AUTH&isClone=no)

string

Query

type
required

Type of the selected record (i.e. Network)

string

Responses
HTTP Code Description Schema

500

TIMS-1052: Please enter a valid query string.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.20.3. Delete All Bookmark

POST /bookmark/deleteAll
Description

Deletes all the bookmark defined in the TCPWave IPAM.
Below example shows the sample request URL:
rest/bookmark/deleteAll

Responses
HTTP Code Description Schema

500

TIMS-12063: There is no bookmark to remove

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.20.4. Delete Bookmark Section

POST /bookmark/deleteSection
Description

Deletes a bookmark section created in the TCPWave IPAM by the user.
Below example shows the sample request JSON:
/bookmark/deleteSection?type=Location

Parameters
Type Name Description Schema Default

Query

type
required

Type of the selected record (i.e. Network)

string

Responses
HTTP Code Description Schema

500

TIMS-12064: Both id and query string cannot be null.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.20.5. Get Bookmark List

GET /bookmark/list
Description

Obtains a list of bookmarks defined in the TCPWave IPAM by the user. Bookmark is a shortcut created by user for easy navigation.
Below example shows sample request URL:
rest/bookmark/list?page=1&rows=20

Parameters
Type Name Description Schema Default

Query

user
required

current logged-in User Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Tree Node > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.21. Central Logging Service

Description

This serivce provides the information related to the Central logging facility in the TCPWave IPAM.

4.21.1. Central Logging Configuration

GET /centralLogging/centralLoggingConfig
Description

Returns the current Central Logging Configuration settings in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/centralLogging/centralLoggingConfig

Responses
HTTP Code Description Schema

200

successful operation

CentralLoggingConfig

500

TIMS-8609: Configuration type is either null or empty.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.21.2. Central Logging Configuration

GET /centralLogging/centralLoggingFullConfig
Description

Returns the current Central Logging Configuration settings, including the different server types logging settings in the TCPWave IPAM.
Below example shows the sample request URL:
/rest/centralLogging/centralLoggingFullConfig

Responses
HTTP Code Description Schema

200

successful operation

CentralLoggingFullConfig

500

TIMS-8601: Configuration type is null, TIMS-8602: Configuration type is empty.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.21.3. Central Logging Server Logs

GET /centralLogging/centralLoggingServerLogConfig
Description

Returns the current Central Logging Configuration settings for a particular server type in the TCPWave IPAM.
Below example shows the sample request URL:
/rest/centralLogging/centralLoggingServerLogConfig?serverType=IPAMServer

Parameters
Type Name Description Schema Default

Query

serverType
required

Server Type

string

Responses
HTTP Code Description Schema

200

successful operation

< CentralLoggingServerLog > array

500

TIMS-8610: Server type is either null or empty. 8604: Server type is null. TIMS-8605: Server type is empty.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.21.4. Update Central Logging Configuration Information.

POST /centralLogging/fullConfigUpdate
Description

Updates the Central Logging Configuration in the TCPWave IPAM.
Below example shows the sample request JSON:
{"dnsLogs":[{"serverType":"DNS","logStatus":"Yes","logName":"DNS Log"}],"dhcpLogs":[{"serverType":"DHCP","logStatus":"Yes","logName":"DHCP Task Log"}],"ipamLogs":[{"serverType":"IPAM","logStatus":"Yes","logName":"TIMS Log"}],"centralLoggingConfigs":[ { "configStatus":"No", "configName":"AvroSink", "configType":"AvroSink", "configProperties":"{\"clog_host\":\"localhost\",\"clog_port\":\"9999\"}"},{ "configStatus":"Yes", "configName":"Splunk", "configType":"Splunk", "configProperties":"{\"clog_host\":\"10.1.10.178\",\"clog_port\":\"9997\"}"}, { "configName":"Elasticsearch", "configType":"Elasticsearch", "configStatus":"No"}]}

Parameters
Type Name Description Schema Default

Body

body
required

Central Logging Configuration details

CentralLoggingFullConfig

Responses
HTTP Code Description Schema

500

TIMS-8601: Configuration type is null, TIMS-8602: Configuration type is empty, TIMS-8603: Configuration type does not exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.21.5. Server Central Logging Setting

POST /centralLogging/serverCentralLoggingSetting
Description

The Central Logging Service provides the functionality to send different IPAM logs to a data collection server, like Flume Agent.
Below example shows the sample request URL:
rest/centralLogging/serverCentralLoggingSetting

Parameters
Type Name Description Schema Default

Body

body
optional

< Server Information > array

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-8611: Central Logging is not configured on the IPAM server. Please configure it first, TIMS-8612: Central Logging feature is not implemented.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

4.22. Certificate Management Service

Description

This class provides services related to Certificate management such as import, delete, list certificates in the TCPWave IPAM. It also provides validity related information of a certificate.

4.22.1. Get the number of days the server certificates are valid

GET /certmgmt/allcertValidDays
Description

Retrieve the number of days the server certificates are valid for in the TCPWave IPAM. Refer Administrator Reference document for more information.
Below example shows the sample request URL:
/rest/certmgmt/allcertValidDays

Responses
HTTP Code Description Schema

200

successful operation

< string > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.22.2. Certificate Delete

POST /certmgmt/certDelete
Description

Deletes a Secure Socket Layer (SSL) certificate from the TCPWave IPAM. SSL certificates are primarily used to secure the communication between two end points.

Parameters
Type Name Description Schema Default

Body

body
required

Certificate details

string

Responses
HTTP Code Description Schema

500

TIMS-8307: This certificate cannot be deleted as it is the only certificate in the keystore.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.22.3. Import Certificate

POST /certmgmt/certImport
Description

Imports a new Secure Socket Layer (SSL) certificate into the TCPWave IPAM. SSL certificates are primarily used to secure the communication between two end points.
Below example shows the sample request URL:
{"cfile":"cert.pem","alias":"win-bthbu90j7o8","storepass":""abc@123","trustCA":false,"kfile":"test.txt""}

Parameters
Type Name Description Schema Default

Body

body
required

Certificate details

string

Responses
HTTP Code Description Schema

500

TIMS-8317: Please enter Certificate file.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.22.4. Number of days Certificate is valid for

GET /certmgmt/certValidDays
Description

Provides the number of days that a Secure Socket Layer (SSL) certificates is valid for. SSL certificates are primarily used to secure the communication between two end points.
Below example shows the sample request URL:
/rest/certmgmt/certValidDays

Responses
HTTP Code Description Schema

200

successful operation

integer(int64)

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.22.5. Certificate validation

GET /certmgmt/certValidate
Description

Validates a given Secure Socket Layer (SSL) certificate defined in the TCPWave IPAM. SSL certificates are primarily used to secure the communication between two end points.
Below example shows the sample request URL:
/rest/certmgmt/certValidate?cfile=cfilevalue

Parameters
Type Name Description Schema Default

Query

cfile
required

Certificate File

string

Responses
HTTP Code Description Schema

200

successful operation

Certificate

500

TIMS-8304: Certificate is not valid.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.22.6. Lists Certificate

GET /certmgmt/certlist
Description

Obtains a list of all the Secure Socket Layer (SSL) certificates defined in the TCPWave IPAM. SSL certificates are primarily used to secure the communication between two end points.
Below example shows the sample request URL:
rest/certmgmt/certlist

Responses
HTTP Code Description Schema

200

successful operation

< Certificate > array

500

TIMS-8303: Certificate get list failed.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.22.7. Change Keystore Password

POST /certmgmt/changeKeystorePassword
Description

Change the Server keystore password in the TCPWave IPAM. For more information on managing the TCPWave Server Certificates, please refer to the Administrator Reference document.

Parameters
Type Name Description Schema Default

Body

body
required

Server keystore password details

string

Responses
HTTP Code Description Schema

500

TIMS-8308: An error has occurred while changing the certificate store password.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.22.8. Duplicate Alias check

POST /certmgmt/duplicateAlias
Description

Data Integrity check defined in the TCPWave IPAM to check if a Secure Socket Layer (SSL) certificate has a duplicate definition. SSL certificates are primarily used to secure the communication between two end points.
Below example shows the sample request URL:
/rest/certmgmt/duplicateAlias

Parameters
Type Name Description Schema Default

Body

body
required

Certificate details

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.22.9. Web Server Restart

POST /certmgmt/jettyRestart
Description

As a part of the certificate management logic, a restart of the Web server is required to put the property up certificate into use. This API call restarts the embedded web server.
The example listed below shows a sample request URL:
/rest/certmgmt/jettyRestart

Responses
HTTP Code Description Schema

500

TIMS-8102: Server address is empty, TIMS-8101: Service to restart jetty server is not defined.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.23. Chart Service

Description

This class is used to provide service to get statistics for rendering charts in the TCPWave IPAM.

4.23.1. Network Statistics

GET /chart/allocationpercent
Description

Get detailed statistics information of the current network in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/chart/allocationpercent?address=networkIpaddress

Parameters
Type Name Description Schema Default

Query

address
required

Network IP Address

string

Query

id
optional

Network ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

Network Stats

Consumes
  • text/plain

  • application/xml

Produces
  • application/json

  • application/xml

4.23.2. Object Allocation

GET /chart/objectAlloc
Description

Displays the number of objects allocated based on the object allocation type in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/chart/objectAlloc?id=4

Parameters
Type Name Description Schema Default

Query

id
optional

ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

Object Allocation

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.23.3. Object Type

GET /chart/objectType
Description

Displays the number of objects allocated based on the object type in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/chart/objectType?id=idValue

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

id
optional

ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< Object Type Chart > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.23.4. Network Statistics

GET /chart/top10subnets
Description

Get detailed statistics information of the current network in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/chart/top10subnets?address=networkIpaddress

Parameters
Type Name Description Schema Default

Query

address
required

Network IP Address

string

Query

id
optional

Network ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

Network Stats

Consumes
  • text/plain

  • application/xml

Produces
  • application/json

  • application/xml

4.23.5. Network Statistics

GET /chart/top10v6subnets
Description

Get top 10 subnets from the current IPv6 network in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/chart/top10v6subnets?orgName=orgName&address=networkIpaddress

Parameters
Type Name Description Schema Default

Query

address
required

Network IP Address

string

Query

id
optional

Network ID

integer(int32)

Query

org_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Network Stats

Consumes
  • text/plain

  • application/xml

Produces
  • application/json

  • application/xml

4.23.6. Network Statistics

GET /chart/v6allocationpercent
Description

Get object allocation details of the current IPv6 network in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/chart/v6allocationpercent?address=networkIpaddress&org_name=orgNameValue

Parameters
Type Name Description Schema Default

Query

address
required

Network IP Address

string

Query

id
optional

Network ID

integer(int32)

Query

org_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Network Stats

Consumes
  • text/plain

  • application/xml

Produces
  • application/json

  • application/xml

4.23.7. Object Allocation

GET /chart/v6objectAlloc
Description

Displays the percentage of objects allocated based on the object allocation type of current IPv6 subnet in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/chart/v6objectAlloc?id=idValue

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

id
optional

ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

Network Stats

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.23.8. Object Type

GET /chart/v6objectType
Description

Displays the number of objects allocated based on the object type of current IPv6 subnet in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/chart/v6objectType?id=idValue

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

id
optional

ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< Object Type Chart > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.23.9. Cumulative Charts Information

GET /newchart/cumulative
Description

Get the cumulative charts information present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/newchart/cumulative?type=DNS&duration=60

Parameters
Type Name Description Schema Default

Query

duration
required

Duration

string

Query

type
required

Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

< string, ChartsData > map

Consumes
  • text/plain

  • application/xml

Produces
  • application/json

  • application/xml

4.23.10. DHCP Charts Information

GET /newchart/dhcp
Description

Get the DHCP charts information present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/newchart/dhcp?ip=1.0.0.5&name=test&duration=60

Parameters
Type Name Description Schema Default

Query

duration
required

Duration

string

Query

ip
required

Appliance IP

string

Query

name
required

Appliance Name

string

Responses
HTTP Code Description Schema

200

successful operation

ChartsData

Consumes
  • text/plain

  • application/xml

Produces
  • application/json

  • application/xml

4.23.11. DNS Charts Information

GET /newchart/dns
Description

Get the DNS charts information present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/newchart/dns?ip=1.0.0.5&name=test&duration=60

Parameters
Type Name Description Schema Default

Query

duration
required

Duration

string

Query

ip
required

IP

string

Query

name
required

Name

string

Responses
HTTP Code Description Schema

200

successful operation

ChartsData

Consumes
  • text/plain

  • application/xml

Produces
  • application/json

  • application/xml

4.23.12. Charts Information

GET /newchart/dwm
Description

Get the charts information present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/newchart/dwm?ip=1.0.0.5&name=test&type=DNS&category=

Parameters
Type Name Description Schema Default

Query

category
required

Chart Category

string

Query

ip
required

Appliance IP

string

Query

name
required

Appliance Name

string

Query

type
required

Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

< string, ChartsData > map

Consumes
  • text/plain

  • application/xml

Produces
  • application/json

  • application/xml

4.23.13. Galera Charts Information

GET /newchart/galera
Description

Get the galera charts information present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/newchart/ipam?ip=1.0.0.5&name=test&duration=60

Parameters
Type Name Description Schema Default

Query

duration
required

Duration

string

Query

ip
required

IP

string

Query

name
required

Name

string

Responses
HTTP Code Description Schema

200

successful operation

ChartsData

Consumes
  • text/plain

  • application/xml

Produces
  • application/json

  • application/xml

4.23.14. Grouped Charts Information

GET /newchart/group
Description

Get the grouped charts information present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/newchart/group?ipList=1.0.0.5,1.0.0.6&duration=d&type=DNS&category=CPU

Parameters
Type Name Description Schema Default

Query

category
required

Chart Category

string

Query

duration
required

Duration

string

Query

ipList
required

Appliance IP List

string

Query

type
required

Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

< string, ChartsData > map

Consumes
  • text/plain

  • application/xml

Produces
  • application/json

  • application/xml

4.23.15. IPAM Charts Information

GET /newchart/ipam
Description

Get the IPAM charts information present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/newchart/ipam?ip=1.0.0.5&name=test&duration=60

Parameters
Type Name Description Schema Default

Query

duration
required

Duration

string

Query

ip
required

IP

string

Query

name
required

Name

string

Responses
HTTP Code Description Schema

200

successful operation

ChartsData

Consumes
  • text/plain

  • application/xml

Produces
  • application/json

  • application/xml

4.24. Checkouts Service Details

Description

This service provides REST API access to retrieve the TCPWave checkouts results in the IPAM. The TCPWave Checkouts operations are performed against the TCPWave IPAM and TCPWave remotes in scheduled intervals. The default schedule interval is 12 hours and this can be changed in the TCPWave Scheduler page. The checkouts results are stored centrally in the TCPWave IPAM appliance as json format files. These checkout results can be accessed from the TCPWave Web Interface.

4.24.1. Appliances Policy Compliance Information

GET /checkouts/list
Description

This operation retrieves the list of policy compliance information for DNS/DHCP/IPAM appliances.
To list the policy compliance information on a specific DNS appliance, users must specify server_type parameters as 'BIND AUTH', 'BIND CACHE', 'UNBOUND', 'NSD' or 'DNS PROXY'. To list the policy compliance information on all the DNS appliances or any particular appliance group or all the appliance groups, users must specify the server_type parameter as DNS. To list the policy compliance information on DHCP appliance(s), the server_type parameter must be specified as DHCP. To list the policy compliance information on IPAM appliance(s), the server_type parameter must be specified as IPAM.
The following examples shows a sample request URLs:

The following is the sample URL to list checkout information for a BIND AUTH type appliance.
rest/checkouts/list?server_type=BIND AUTH&server_ip=172.16.0.13&level=appliance&org_name=TCPWave

The following is the sample URL to list checkout information for all the DNS appliances.
rest/checkouts/list?server_type=DNS&level=appliance

The following is the sample URL to list checkout information for all the DNS appliances which are associated with any appliance group.
rest/checkouts/list?server_type=DNS&level=appliance_group&org_name=TCPWave

the following is the sample URL to list checkout information for all the DNS appliances which are associated with specified appliance group.
rest/checkouts/list?server_type=DNS&level=appliance_group&appliance_group=Group_Name&org_name=TCPWave

Parameters
Type Name Description Schema Default

Query

appliance_group
optional

Appliance Group Name

string

Query

draw
optional

Pagination Rendering Parameter

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

level
required

Level type. Takes either appliance or appliance_group

string

Query

order
optional

Sort Order(asc/desc)

string

Query

org_name
optional

Appliance Group organization

string

Query

q
optional

Search String

string

Query

server_id
optional

ID of the DNS/DHCP Appliance

integer(int32)

Query

server_ip
optional

IP Address of the IPAM/DNS/DHCP Appliance

string

Query

server_name
optional

Name of the DHCP Appliance

string

Query

server_type
required

Type of the Appliance

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Contact Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListPolicy Compliance Entity

500

TIMS-7003: You are not authorized to perform this operation, TIMS-3038: Appliance Type is not valid: {0}

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.24.2. Policy Compliance checks.

POST /checkouts/run
Description

This operation performs DNS/DHCP/IPAM Policy Compliance checks
To run policy compliance check on a specific DNS appliance, server_type parameter must be specified as 'BIND AUTH', 'BIND CACHE', 'UNBOUND', 'NSD' or 'DNS PROXY'.To run policy compliance check on all the DNS appliances or any particular appliance group or all the appliance groups, server_type parameter must be specified as DNS. To run policy compliance check on DHCP appliance(s), server_type parameter must be specified as DHCP. To run policy compliance check on IPAM appliance(s), server_type parameter must be specified as IPAM.
The following examples shows a sample request URLs:

The following is the sample URL to run checkout operation for a BIND CACHE type appliance.
rest/checkouts/run?server_type=BIND CACHE&server_ip=172.16.0.13&level=appliance&org_name=TCPWave

The following example is the sample URL to run checkout operation for all the DNS appliances.
rest/checkouts/run?server_type=DNS&level=appliance&org_name=TCPWave

The following is the sample URL to run checkout operation for all the DNS appliances which are associated with any appliance group.
rest/checkouts/run?server_type=DNS&level=appliance_group&org_name=TCPWave

The following is the sample URL to run checkout operation for all the DNS appliances which are associated with specified appliance group.
rest/checkouts/run?server_type=DNS&level=appliance_group&appliance_group=Group_Name&org_name=TCPWave

Parameters
Type Name Description Schema Default

Query

appliance_group
optional

Appliance Group Name

string

Query

level
required

Level type. Takes either appliance or appliance_group

string

Query

org_name
optional

Appliance Group organization

string

Query

server_ip
optional

IP Address of the DNS Appliance

string

Query

server_name
optional

Name of the DHCP Appliance

string

Query

server_type
required

Type of the Appliance

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-3038: Appliance Type is not valid: {0}

No Content

Consumes
  • text/plain

  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.25. Class Code Logo Service

Description

This service provides the logos for various object types in the TCPWave IPAM.

4.25.1. Class Code Logo List

GET /classCodeLogo/list
Description

Obtains a list of all the logos of the object types present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/classCodeLogo/list

Responses
HTTP Code Description Schema

200

successful operation

< Class Code Logo > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.26. Class Code Service

Description

This class provides services related to Object Type such as Add, Delete and Update Object type in the TCPWave IPAM. It also provides a list of all available Object types in the TCPWave IPAM.

4.26.1. Object Type Add

POST /classcode/add
Description

Creates a new object type in the TCPWave IPAM . These are used to create objects in the TCPWave IPAM.
Below example shows sample request JSON:
{"code":"qacode","description":"Object type added from rest call","prefix":"qa","suffix":"code","prefix_zeros":"no","initial_seq_num":"1","logo":"/img/custom-object-types/logo-3dsmax-render-server.png"}

Parameters
Type Name Description Schema Default

Body

body
required

Classcode details

Class Code

Responses
HTTP Code Description Schema

500

TIMS 2030: Object Type already exists.
TIMS-11012: Suffix field cannot be null
TIMS-11011: Prefix field cannot be null.
TIMS-9610: Prefix:{0} and Suffix:{1} combination already exists.
TIMS-11013: Invalid Initial sequence number specified, valid values are 1 to 99999
TIMS-11014: Prefix-Zeros should be 'yes' or 'no'

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.26.2. Object Type Delete

POST /classcode/delete
Description

Deletes an existing object type in the TCPWave IPAM.
Below example shows sample request JSON:
{"code":"qacode","description":"Object type added from rest call","logo":"/img/custom-object-types/logo-3dsmax-render-server.png","prefix":"qa123","suffix":"code45","prefix_zeros":"yes","initial_seq_num":1,"req_mul_names":1,"updated_seq_num":1}

Parameters
Type Name Description Schema Default

Body

body
required

Classcode details

Class Code

Responses
HTTP Code Description Schema

500

TIMS-2020: Object Type does not exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.26.3. Class Code Details

GET /classcode/getClassCodeDetails
Description

Obtains the details of a class code in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/classcode/getClassCodeDetails?classcodename=classcodename

Parameters
Type Name Description Schema Default

Query

classcodename
required

Name of the class code to get details.

string

Responses
HTTP Code Description Schema

200

successful operation

Class Code

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.26.4. Object Type List

GET /classcode/list
Description

Obtains a list of Object types available in the TCPWave IPAM. These are used to create objects in the TCPWave IPAM.
The example listed below shows a sample request URL:
rest/classcode/list?DHCP=TCPWave Remote&page=1&rows=20

Parameters
Type Name Description Schema Default

Query

DHCP
optional

List of the object types supported to create DHCP objects

string

Responses
HTTP Code Description Schema

200

successful operation

< Class Code > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.26.5. Object Name Auto generation

GET /classcode/nextautohostname
Description

Generates and returns a name to assign to the object based on the object type given.
The example listed below shows a sample request URL:
/rest/classcode/getClassCodeDetails?classCode=classcodename

Parameters
Type Name Description Schema Default

Query

classCode
required

Name of the class code

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

11017 = TIMS-11017: Object Type cannot be null.
2020 = TIMS-2020: Object Type does not exist: {0}.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.26.6. Object Type Update

POST /classcode/update
Description

Edits an existing object type in the TCPWave IPAM. These are used to create objects in the TCPWave IPAM.
Below example shows sample request JSON:
{"code":"qacode","description":"Object type added from rest call","prefix":"qa123","suffix":"code45","prefix_zeros":"yes","initial_seq_num":"1","logo":"/img/custom-object-types/logo-3dsmax-render-server.png","old_class_code":"qacode","user_defined":"Y"}

Parameters
Type Name Description Schema Default

Body

body
required

Classcode details

Class Code

Responses
HTTP Code Description Schema

500

TIMS-2020: Object Type does not exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.27. Cloud DNS Provider Service

Description

This service class provides services related to Cloud DNS Provider such as add/edit/del Cloud Provider, list Cloud Providers, list Cloud Provider Templates, list Cloud Provider Types, update Cloud Provider Templates in the TCPWave IPAM.

4.27.1. Add New Cloud Provider

POST /clouddnsprovider/add
Description

Add new Cloud Provider in the TCPWave IPAM. A cloud provider is an instance of the cloud provider type with the associated credentials to manage the data in the cloud. Please refer to the TCPWave IPAM Administrator Guide for a comprehensive list of cloud provider types supported. One Cloud Provider can be associated with multiple DNS Zone Templates.
Below example shows sample request JSON:{"user":"AKIAINLQMEG7EBWXMTOQ","api_key":"E52BxojR5f2hM802hG+Zl8Z4boxzlZRNcnPpaii+","region":"us-east-1","organization_name":"Internal","cloud_dns_provider_type_name":"AWS","name":"test_cloud_uc","description":"testing"}

Parameters
Type Name Description Schema Default

Body

body
optional

DNS Cloud Provider

Responses
HTTP Code Description Schema

500

TIMS-9411: Both Provider id and Zone Template id are null.

No Content

Consumes
  • application/json

Produces
  • application/json

  • application/xml

4.27.2. Add New Resource Role Mapping in AWS Cloud Provider

POST /clouddnsprovider/addresourcerolemapping
Description

Add new resource-role mapping in AWS cloud provider in the TCPWave IPAM.A resource such as Zone or VPC can be mapped to the IAM role and AWS account to be managed using the given account. The supported resource types are Zone and VPC.User can manage zones in multiple accounts by adding the resources. Similarly user can import virtual instances from multiple accounts from a single cloud provider.
Below example shows sample request JSON: { "cloud_provider_name": "AWSType",
"organization_name": "Internal",
"resource_type": "zone",
"resource_name": "test.com",
"account": "123457",
"iam_role": "Route53Access"
}

Parameters
Type Name Description Schema Default

Body

body
optional

CloudResourceWrapper

Responses
HTTP Code Description Schema

500

TIMS-9411: Both Organization and cloud provider name cannot be null.

No Content

Consumes
  • application/json

Produces
  • application/json

  • application/xml

4.27.3. Delete Cloud Provider

POST /clouddnsprovider/delete
Description

Delete existing Cloud Providers in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/clouddnsprovider/delete?name=AWS&org_name=Internal

Parameters
Type Name Description Schema Default

Query

name
required

Cloud Provider Name required to delete

string

Query

org_name
required

Organization Name

string

Responses
HTTP Code Description Schema

500

TIMS-9411: Both Provider id and Zone Template id are null. TIMS-9415: Provider is used in zone template(s). Please dissociate those template(s) from the provider and try again.

No Content

Produces
  • application/json

  • application/xml

  • text/plain

4.27.4. Delete Resource to role mapping in AWS Cloud Provider

POST /clouddnsprovider/deleteresourcerolemapping
Description

Deleting resource-role mapping in AWS cloud provider in the TCPWave IPAM.
Below example shows sample request JSON:{"cloud_provider_name": "AWSType",
"organization_name": "Internal",
"resource_type": "zone",
"resource_name": "test.com",
}

Parameters
Type Name Description Schema Default

Body

body
optional

CloudResourceWrapper

Responses
HTTP Code Description Schema

500

TIMS-9411: Both Organization and cloud provider name cannot be null.

No Content

Consumes
  • application/json

Produces
  • application/json

  • application/xml

4.27.5. Dis-associate Cloud Provider

POST /clouddnsprovider/disassociate
Description

Dis-associate the Cloud Provider from a DNS Zone template defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/clouddnsprovider/disassociate?cpname=google

Parameters
Type Name Description Schema Default

Query

cpid
optional

Cloud Provider Id required for dis-associating Cloud Provider from Zone

integer(int32)

Query

cpname
required

Cloud Provider Name required for dis-associating Cloud Provider from Zone

string

Query

cptype
optional

Cloud Provider Type required for dis-associating Cloud Provider from Zone

string

Query

org_id
optional

Organization Id required for dis-associating Cloud Provider from Zone

integer(int32)

Query

org_name
optional

Organization Name required for dis-associating Cloud Provider from Zone

string

Body

body
optional

< DNS Cloud Provider Template > array

Responses
HTTP Code Description Schema

500

TIMS-9411: Both Provider id and Zone Template id are null.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.27.6. Edit Cloud Provider

POST /clouddnsprovider/edit
Description

Edit existing Cloud Providers in the TCPWave IPAM. A cloud provider is an instance of the cloud provider type with the associated credentials to manage the data in the cloud.
Below example shows sample request JSON:
/clouddnsprovider/edit?oldname=aws_applet
{"name":"aws_applet_new","organization_name":"Internal","cloud_dns_provider_type_name":"AWS","description":"aws cloud provider","user":"AKIAINLQMEG7EBWXMTOO","api_key":"E52BxojR5f2hM802hG+Zl8Z4boxzlZRNcnPpaie+","region":"us-east-1"}

Parameters
Type Name Description Schema Default

Query

oldname
required

Cloud Provider Name required to modify existing Cloud Provider

string

Body

body
optional

DNS Cloud Provider

Responses
HTTP Code Description Schema

500

TIMS-9406: Both Provider name and id cannot be null. TIMS-9407: Provider name is not valid. TIMS-9408: Provider id is not valid. TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

Produces
  • application/json

  • application/xml

4.27.7. Edit existing Resource Role Mapping in AWS Cloud Provider

POST /clouddnsprovider/editresourcerolemapping
Description

Edit resource-role mapping in AWS cloud provider in the TCPWave IPAM.
Below example shows sample request JSON:{ "cloud_provider_name": "AWSType",
"organization_name": "Internal",
"cloud_provider_type":"AWS",
"old_resource_name":"c.com",
"resource_type": "zone",
"resource_name": "test.com",
"account": "123457",
"iam_role": "ZZZ"
}

Parameters
Type Name Description Schema Default

Body

body
optional

CloudResourceWrapper

Responses
HTTP Code Description Schema

500

TIMS-9411: Both Organization and cloud provider name cannot be null.

No Content

Consumes
  • application/json

Produces
  • application/json

  • application/xml

4.27.8. Cloud Provider Details

GET /clouddnsprovider/get
Description

Get the cloud provider details defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/clouddnsprovider/get?providerName=AWS&orgName=Internal

Parameters
Type Name Description Schema Default

Query

orgID
optional

Organization ID

integer(int32)

Query

orgName
required

Organization Name

string

Query

providerID
optional

Cloud Provider ID

integer(int32)

Query

providerName
required

Cloud Provider Name

string

Responses
HTTP Code Description Schema

200

successful operation

DNS Cloud Provider

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.27.9. Cloud Provider List

GET /clouddnsprovider/list
Description

Obtains a list of all the cloud providers defined in the TCPWave IPAM. A cloud provider is an instance of the cloud provider type with the associated credentials to manage the data in the cloud. Please refer to TCPWave IPAM Administrator Guide for a comprehensive list of cloud provider types supported.
The example listed below shows a sample request URL:
/rest/clouddnsprovider/list?orgName=Internal

Parameters
Type Name Description Schema Default

Query

orgName
required

Organization name required for listing all cloud providers associated with that Organization.

string

Query

org_id
optional

Organization Id required for listing all cloud providers.

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< DNS Cloud Provider > array

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1021: Organization name is not valid, TIMS-1025: Organization id is not valid, TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.27.10. Cloud Provider Templates

GET /clouddnsprovider/list_provider_templates
Description

Obtains mapping of the cloud providers to the DNS zone templates defined in the TCPWave IPAM. The information includes the cloud DNS provider name and associated DNS zone template name. This mapping is used by TCPWave IPAM DNS module to keep the data in sync in the selected cloud.
The example listed below shows a sample request URL:
/rest/clouddnsprovider/list_provider_templates?org_name=Internal&provider=providerName

Parameters
Type Name Description Schema Default

Query

org_id
optional

Organization ID required for listing all cloud providers templates

integer(int32)

Query

org_name
required

Organization name required for listing all cloud providers templates

string

Query

provider
required

Provider name required for listing all cloud providers template

string

Query

template
optional

Template name required for listing all cloud providers templates

string

Responses
HTTP Code Description Schema

200

successful operation

< DNS Cloud Provider Template > array

500

TIMS-9411: Both Provider id and Zone Template id are null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.27.11. Cloud Provider Types

GET /clouddnsprovider/list_provider_types
Description

Lists the Cloud Provider Types defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/clouddnsprovider/list_provider_types

Responses
HTTP Code Description Schema

200

successful operation

< DNS Cloud Provider Type > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.27.12. Cloud provider Search

GET /clouddnsprovider/search
Description

Searches for cloud providers present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/clouddnsprovider/search?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting IPV4 Object Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListDNS Cloud Provider

Consumes
  • text/plain

  • application/json

Produces
  • application/json

  • application/xml

4.27.13. Resource to role mapping Search

GET /clouddnsprovider/searchCrossRoles
Description

Searches for a given resource to role mapping for the AWS cloud provider in the TCPWave IPAM with giving input string.
The example listed below shows a sample request URL:
/rest/clouddnsprovider/searchCrossRoles?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Template Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListCloudResourceWrapper

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.27.14. Cloud Provider Templates Update

POST /clouddnsprovider/update_template
Description

Updates the mapping of cloud provider to the DNS zone templates defined in the TCPWave IPAM. The mapping includes the cloud DNS provider name and associated DNS zone template name.
The example listed below shows a sample request URL:
/rest/clouddnsprovider/update_template?org_name=Internal&name=testTemplate&type=templateType

Parameters
Type Name Description Schema Default

Query

name
required

Template name required to update the template

string

Query

org_id
optional

Organization Id required to update the template

integer(int32)

Query

org_name
required

Organization Name required to update the template

string

Query

type
required

Template type

string

Body

body
optional

< string > array

Responses
HTTP Code Description Schema

500

TIMS-9411: Both Provider id and Zone Template id are null. TIMS-9412: Provider name or Zone Template name is not valid.

No Content

Consumes
  • application/json

Produces
  • application/json

  • application/xml

4.28. Cloud Instance Service

Description

This service class provides services related to Cloud Instance such as add/edit/delete Cloud Instance Templates, list Cloud Templates and Instances in the TCPWave IPAM.

4.28.1. List AWS Images

GET /cloudCompute/awsImage/page
Description

This operation retrieves the list of AWS Images created by users in IPAM.
The following example shows a sample request URL:
rest/cloudCompute/awsImage/page?draw=3&start=26&length=26&orgName=Internal

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

orgName
required

Organization Name

string

Query

sort
optional

Sort String

string

Query

start
required

Starting AWS Images Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAmazon Machine Image

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.28.2. Create AWS Image

POST /cloudCompute/createAWSImage
Description

This operation creates AWS Image using the details of the cloud provider and Amazon machine Image ID.
The following example shows a sample request URL:
/rest/cloudCompute/createAWSImage?id=ami-0beea874&name=IMG-21&desc=test&cloudProviderName=AWS&orgName=EARTH

Parameters
Type Name Description Schema Default

Query

cloudProviderId
optional

Cloud Provider ID

integer(int32)

Query

cloudProviderName
required

Cloud Provider Name

string

Query

desc
optional

AWS Instance Description

string

Query

id
required

AWS Image ID

string

Query

name
required

AWS Image Name

string

Query

orgId
optional

Organization ID

integer(int32)

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.28.3. Delete AWS Image

POST /cloudCompute/deleteAWSImage
Description

This operation deletes the AWS Image of the given ID from the TCPWave IPAM.
The following example shows a sample request URL:
/rest/cloudCompute/deleteAWSImage?id=ami-0beea874&cloudProvider=AWS&orgName=EARTH

Parameters
Type Name Description Schema Default

Query

cloudProvider
required

Cloud Provider Name

string

Query

cloudProviderId
optional

Cloud provider ID

integer(int32)

Query

id
required

AWS Image ID

string

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.28.4. Get IAM Roles

GET /cloudCompute/getIAMRoles
Description

This operation retrieves the list of IAM roles defined in AWS for the given cloud provider.
The following example shows a sample request URL:
/rest/cloudCompute/getIAMRoles?cloudProvider=AWS&orgName=Internal

Parameters
Type Name Description Schema Default

Query

cloudProvider
required

Cloud Provider Name

string

Query

cloudProviderId
optional

Cloud Provider ID

integer(int32)

Query

orgId
optional

Organization ID

integer(int32)

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Role > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.28.5. Get Security Groups

GET /cloudCompute/getSecurityGroups
Description

This operation retrieves the list of Security Groups defined in AWS.
The following example shows a sample request URL:
/tims/rest/cloudCompute/getSecurityGroups?cloudProvider=AWS&orgName=EARTH

Parameters
Type Name Description Schema Default

Query

cloudProvider
required

Cloud Provider Name

string

Query

cloudProviderId
optional

Cloud Provider ID

integer(int32)

Query

orgId
optional

Organization ID

integer(int32)

Query

orgName
required

Organization Name

string

Query

vpcIds
optional

Comma separated list of VPC’s

string

Responses
HTTP Code Description Schema

200

successful operation

< SecurityGroup > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.28.6. Change Cloud Instance State

POST /cloudCompute/instance/changeState
Description

This operation changes the state of cloud instance in the respective cloud provider.
The following example shows a sample request URL:
/rest/cloudCompute/instance/changeState?objectAddress=10.0.0.3&orgName=Internal&action=stop

Parameters
Type Name Description Schema Default

Query

action
required

Action required to change the state of the cloud instance.

string

Query

objectAddress
required

Object address required to change the state of the cloud instance details.

string

Query

objectID
optional

Object ID required to change the state of the cloud instance.

integer(int32)

Query

orgName
required

Organization name required to change the state of the cloud instance details.

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

4.28.7. Check Cloud Instances

GET /cloudCompute/instance/checkInstances
Description

This operation checks if one of the objects is a cloud instance.
The following example shows a sample request URL:
/rest/cloudCompute/instance/checkInstances?ipList=10.0.0.3&orgName=Internal

Parameters
Type Name Description Schema Default

Query

ipList
required

IP Addresses of the Objects to be terminated

string

Query

orgName
required

Organization Name to which Subnet belongs

string

Responses
HTTP Code Description Schema

200

successful operation

boolean

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.28.8. Create Cloud Instance

POST /cloudCompute/instance/create
Description

This operation creates a cloud instance in the respective cloud provider.
The following example shows a sample request JSON:
{"objectName":"AWS172311623","objectAddress":"10.31.16.23","objectId":501,"subnetAddress":"10.31.16.0","templateId":101,"templateName":"AWS-Instance-Provisioning-Template","organizationId":1,"organizationName":"Internal","status":"RUNING","publicIP":"string","dnsName":"AWS172311623.test.com","providerTemplate":{"name":"AWS-Instance-Provisioning-Template","newName":"Default-AWS-Instance-Provisioning-Template","id":101,"organizationName":"Internal","organizationId":1,"cloudProviderType":"AWS","cloudProviderName":"AWS-Provider","cloudProviderId":21,"instanceTmplJsonStr":"'{"zone":"us-east1-b","machineType":"f1-micro","bootDiskImageFamily":"centos","bootDiskImage":"centos-6-v20180401","nonDepricatedImage":true,"bootDiskType":"pd-standard","bootDiskSize":"10","bootDiskAutoDelete":true,"allowHttpTraffic":true,"allowHttpsTraffic":true}'","description":"AWS Instance template test"}}

Parameters
Type Name Description Schema Default

Body

body
optional

Cloud Instance Bean

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

4.28.9. Get Cloud Instance Details

GET /cloudCompute/instance/get
Description

This operation retrieves the details of the cloud instance for the given IP address from the cloud provider.
The following example shows a sample request URL:
/rest/cloudCompute/instance/get?objectAddress=10.0.0.3&orgName=Internal

Parameters
Type Name Description Schema Default

Query

objectAddress
required

Object address required to get the cloud instance details.

string

Query

objectId
optional

Object ID required to get the cloud instance details.

integer(int32)

Query

orgName
required

Organization name required to get the cloud instance details.

string

Responses
HTTP Code Description Schema

200

successful operation

Cloud Instance Bean

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.28.10. Get Cloud Instance creation error

GET /cloudCompute/instance/getCreationError
Description

This operation retrieves the error that occurred while creating Cloud Instance.
The following example shows a sample request URL:
/rest/cloudCompute/instance/getCreationError

Parameters
Type Name Description Schema Default

Query

objectId
optional

ID of Object

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • text/plain

4.28.11. Cloud Instance State

GET /cloudCompute/instance/getState
Description

This operation retrieves the state of a cloud instance from the respective cloud provider.
The following example shows a sample request URL:
/rest/cloudCompute/instance/getState?objectAddress=10.0.0.2&orgName=Internal

Parameters
Type Name Description Schema Default

Query

objectAddress
required

Object address required to get the state of cloud instance.

string

Query

objectID
optional

Object ID required to get the state of cloud instance.

integer(int32)

Query

orgName
required

Organization name required to get the state of cloud instance.

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.28.12. Is Reserved IP Address

GET /cloudCompute/instance/isReservedIP
Description

This operation retrieves the value as true if the given IP address is a reserved IP address in the AWS subnet; else, it retrieves the value as false.
The following example shows a sample request URL:
/rest/cloudCompute/instance/isReservedIP?cloudProvider=AWS&orgName=Internal&ip=1.1.0.2&subnetIpaddress=1.1.0.0

Parameters
Type Name Description Schema Default

Query

cloudProvider
required

Cloud Provider Name

string

Query

cloudProviderId
optional

Cloud Provider ID

integer(int32)

Query

ip
required

IP Address

string

Query

orgId
optional

Organization ID

integer(int32)

Query

orgName
required

Organization Name

string

Query

subnetAddress
required

Subnet Address

string

Responses
HTTP Code Description Schema

200

successful operation

boolean

Consumes
  • text/plain

Produces
  • text/plain

4.28.13. Cloud Instance Recreate

POST /cloudCompute/instance/recreate
Description

This operation creates a cloud instance based on a cloud provisioning template.
The following example shows a sample request URL:
/rest/cloudCompute/instance/recreate?objectAddress=10.0.0.5&orgName=Internal

Parameters
Type Name Description Schema Default

Query

objectAddress
required

IP Addresses of the object

string

Query

orgName
required

Name of the organization to which object belongs

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

4.28.14. Terminate Cloud Instances

POST /cloudCompute/instance/terminate
Description

This operation terminates one or more cloud instances.
The following example shows a sample request URL:
/rest/cloudCompute/instance/terminate?ipList=10.0.0.3&orgName=Internal

Parameters
Type Name Description Schema Default

Query

cloudProviderId
optional

Cloud Provider ID mapped to Subnet

integer(int32)

Query

ipList
required

IP Addresses of the Objects to be terminated

string

Query

objectList
optional

ID’s of the Objects to be terminated

string

Query

orgName
required

Organization Name to which Subnet belongs

string

Query

subnetAddress
optional

Subnet Address

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.28.15. Cloud Instance Template Add

POST /cloudCompute/instanceTemplate/add
Description

Creates a cloud instance template in the TCPWave IPAM.
The following example shows a sample request JSON:
{"name":"AWS-Instance-Provisioning-Template","newName":"Default-AWS-Instance-Provisioning-Template","id":101,"organizationName":"Internal","organizationId":1,"cloudProviderType":"AWS","cloudProviderName":"AWS-Provider","cloudProviderId":21,"instanceTmplJsonStr":"'{"zone":"us-east1-b","machineType":"f1-micro","bootDiskImageFamily":"centos","bootDiskImage":"centos-6-v20180401","nonDepricatedImage":true,"bootDiskType":"pd-standard","bootDiskSize":"10","bootDiskAutoDelete":true,"allowHttpTraffic":true,"allowHttpsTraffic":true}'","description":"AWS Instance template test","created_by_name":"admin","updated_by":21,"updated_by_name":"admin","created_time_string":"2019-03-13 03:16:04","updated_time_string":"2019-03-16 05:26:05"}

Parameters
Type Name Description Schema Default

Body

body
optional

Cloud Instance Template

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-1352: Cannot find organization: <Organization Name>

No Content

Consumes
  • application/json

  • application/xml

4.28.16. Cloud Instance Template Delete

POST /cloudCompute/instanceTemplate/delete
Description

This operation deletes cloud instance template in the TCPWave IPAM.
The following example shows a sample request JSON:
{"name":"AWS-Instance-Provisioning-Template","newName":"Default-AWS-Instance-Provisioning-Template","id":101,"organizationName":"Internal","organizationId":1,"cloudProviderType":"AWS","cloudProviderName":"AWS-Provider","cloudProviderId":21,"instanceTmplJsonStr":"'{"zone":"us-east1-b","machineType":"f1-micro","bootDiskImageFamily":"centos","bootDiskImage":"centos-6-v20180401","nonDepricatedImage":true,"bootDiskType":"pd-standard","bootDiskSize":"10","bootDiskAutoDelete":true,"allowHttpTraffic":true,"allowHttpsTraffic":true}'","description":"AWS Instance template test"}

Parameters
Type Name Description Schema Default

Body

body
optional

Cloud Instance Template

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

4.28.17. Cloud Instance Template Update

POST /cloudCompute/instanceTemplate/edit
Description

This operation updates a Cloud Instance template in the TCPWave IPAM.
The following example shows a sample request JSON:
{"name":"AWS-Instance-Provisioning-Template","newName":"Default-AWS-Instance-Provisioning-Template","id":101,"organizationName":"Internal","organizationId":1,"cloudProviderType":"AWS","cloudProviderName":"AWS-Provider","cloudProviderId":21,"instanceTmplJsonStr":"'{"zone":"us-east1-b","machineType":"f1-micro","bootDiskImageFamily":"centos","bootDiskImage":"centos-6-v20180401","nonDepricatedImage":true,"bootDiskType":"pd-standard","bootDiskSize":"10","bootDiskAutoDelete":true,"allowHttpTraffic":true,"allowHttpsTraffic":true}'","description":"AWS Instance template test","created_by_name":"admin","updated_by":21,"updated_by_name":"admin","created_time_string":"2019-03-13 03:16:04","updated_time_string":"2019-03-16 05:26:05"}

Parameters
Type Name Description Schema Default

Body

body
optional

Cloud Instance Template

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-1352: Cannot find organization: <Organization Name>

No Content

Consumes
  • application/json

  • application/xml

4.28.18. Cloud Instance Template Details

GET /cloudCompute/instanceTemplate/get
Description

This operation retrieves the details of the cloud instance for the given IP address from the cloud provider.
The following example shows a sample request URL:
/rest/cloudCompute/instanceTemplate/get?templateName=templateNameValue&orgName=Internal

Parameters
Type Name Description Schema Default

Query

orgId
optional

Organization ID required to get the cloud instance templates.

integer(int32)

Query

orgName
required

Organization name required to get the cloud instance templates.

string

Query

templateId
optional

Instance template ID required to get the cloud instance templates.

integer(int32)

Query

templateName
required

Instance template name required to get the cloud instance templates.

string

Responses
HTTP Code Description Schema

200

successful operation

Cloud Instance Template

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.28.19. Cloud Instance Template List

GET /cloudCompute/instanceTemplate/list
Description

This operation retrieves the lists of the cloud instance templates defined in the TCPWave IPAM.
The following example shows a sample request URL:
/rest/cloudCompute//instanceTemplate/list?start=1&length=20&organizations=Internal

Parameters
Type Name Description Schema Default

Query

cloudProviderId
optional

Cloud provider ID required to get the cloud instance templates.

integer(int32)

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Search

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

order param(asc/desc)

string

Query

organizations
optional

Organization List

string

Query

providerType
optional

Cloud provider type required to get the cloud instance templates.

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Page Number

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListCloud Instance Template

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.28.20. List Volume Types

GET /cloudCompute/listAWSVolumeTypes
Description

This operation retrieves the list of AWS volume types.
The following example shows a sample request URL:
/rest/cloudCompute/listAWSVolumeTypes

Responses
HTTP Code Description Schema

200

successful operation

< AWS Volume Type > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.28.21. Azure Virtual Image Publisher’s Offer List

GET /cloudCompute/listAzureImageOffers
Description

This operation retrieves the list of all the offers from an azure virtual image publisher.
The following example shows a sample request URL:
/rest/cloudCompute/listAzureImageOffers?providerName=Azure&orgName=Internal&azureRegion=East US&publisher=Canonical

Parameters
Type Name Description Schema Default

Query

azureRegion
required

Azure region name required to get the Azure virtual machine image offers.

string

Query

orgName
required

Organization name required to get the cloud provider associated with that organization.

string

Query

providerName
required

Cloud provider name required to get the cloud provider details.

string

Query

publisher
required

Image publisher name required to get the Azure virtual machine image offers.

string

Responses
HTTP Code Description Schema

200

successful operation

< Utility Bean > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.28.22. Azure Virtual Image Publisher List

GET /cloudCompute/listAzureImagePublishers
Description

This operation retrieves the list of all the Azure virtual image publishers from the specified region.
The following example shows a sample request URL:
/rest/cloudCompute/listAzureImagePublishers?providerName=Azure&orgName=Internal&azureRegion=East US

Parameters
Type Name Description Schema Default

Query

azureRegion
required

Azure region required to get the Azure virtual image publishers.

string

Query

orgName
required

Organization name required to get the cloud provider associated with that organization.

string

Query

providerName
required

Cloud provider name required to get the cloud provider details.

string

Responses
HTTP Code Description Schema

200

successful operation

< Utility Bean > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.28.23. Azure Virtual Image Publisher Offer’s SKU List

GET /cloudCompute/listAzureImageSKUs
Description

This operation retrieves the list of all the SKUs from an Azure virtual image publisher offer.
The following example shows a sample request URL:
/rest/cloudCompute/listAzureImageSKUs?providerName=Azure&orgName=Internal&azureRegion=East US&publisher=Canonical&offer=0001-com-ubuntu-minimal-focal-daily

Parameters
Type Name Description Schema Default

Query

azureRegion
required

Azure region name required to get the Azure virtual machine image SKUs.

string

Query

offer
required

Image publisher’s offer name required to get the Azure virtual machine image SKUs.

string

Query

orgName
required

Organization name required to get the cloud provider associated with that organization.

string

Query

providerName
required

Cloud provider name required to get the cloud provider details.

string

Query

publisher
required

Image publisher name required to get the Azure virtual machine image SKUs..

string

Responses
HTTP Code Description Schema

200

successful operation

< Utility Bean > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.28.24. Azure Virtual Image Version List

GET /cloudCompute/listAzureImageVersions
Description

This operation retrieves the list of all the versions from an Azure virtual image publisher offer SKU.
The following example shows a sample request URL:
/rest/cloudCompute/listAzureImageVersions?providerName=Azure&orgName=Internal&azureRegion=East US&publisher=Canonical&offer=0001-com-ubuntu-minimal-focal-daily&SKU=minimal-20_04-daily-lts

Parameters
Type Name Description Schema Default

Query

SKU
required

Image SKU name required to get the Azure virtual image versions.

string

Query

azureRegion
required

Azure region required to get the Azure virtual machine image publishers.

string

Query

offer
required

Image publisher’s offer name required to get the Azure virtual machine image versions.

string

Query

orgName
required

Organization name required to get the cloud provider associated with that organization.

string

Query

providerName
required

Cloud provider name required to get the cloud provider details.

string

Query

publisher
required

Image publisher name required to get the Azure virtual machine image versions.

string

Responses
HTTP Code Description Schema

200

successful operation

< Utility Bean > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.28.25. Azure Region List

GET /cloudCompute/listAzureRegions
Description

This operation retrieves the list of all the azure cloud regions.
The following example shows a sample request URL:
/rest/cloudCompute/listAzureRegions?providerName=Azure&orgName=Internal

Parameters
Type Name Description Schema Default

Query

orgName
required

Organization name required to get the cloud provider associated with that organization.

string

Query

providerName
required

Cloud provider name required to get the cloud provider details.

string

Responses
HTTP Code Description Schema

200

successful operation

< Utility Bean > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.28.26. Azure Virtual Machines Size List

GET /cloudCompute/listAzureVMSizes
Description

This operation retrieves the list of all the Azure virtual machine sizes from the specified region.
The following example shows a sample request URL:
/rest/cloudCompute/listAzureVMSizes?providerName=Azure&orgName=Internal&azureRegion=East US

Parameters
Type Name Description Schema Default

Query

azureRegion
required

Azure region name required to get the available azure virtual machine sizes.

string

Query

orgName
required

Organization name required to get the cloud provider associated with that organization.

string

Query

providerName
required

Cloud provider name required to get the cloud provider details.

string

Responses
HTTP Code Description Schema

200

successful operation

< Utility Bean > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.28.27. List Cloud Providers

GET /cloudCompute/listCloudProviders
Description

This operation retrieves the list of Cloud Providers created by the users.
The following example shows a sample request URL:
/rest/cloudCompute/listCloudProviders?providerType=AWS&orgName=Internal

Parameters
Type Name Description Schema Default

Query

orgId
optional

Organization Id

integer(int32)

Query

orgName
optional

Organization Name

string

Query

providerType
optional

Provider Type

string

Responses
HTTP Code Description Schema

200

successful operation

< DNS Cloud Provider > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.28.28. Google Cloud Machine Type List

GET /cloudCompute/listGoogleMachines
Description

This operation retrieves the list of the google machine types for the given google cloud region.
The following example shows a sample request URL:
/rest/cloudCompute/listGoogleMachines?orgName=Internal&providerName=google&googleZone=us-east1-b

Parameters
Type Name Description Schema Default

Query

googleZone
required

Google Cloud Zone Name.

string

Query

orgName
required

Organization Name

string

Query

providerName
required

Cloud Provider Name

string

Responses
HTTP Code Description Schema

200

successful operation

< < string, object > map > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.28.29. Google Cloud OS Image List

GET /cloudCompute/listGoogleOsImages
Description

Obtains a list of all the Google cloud OS images.
The example listed below shows a sample request URL:
/rest/cloudCompute/listGoogleOsImages?orgName=Internal&providerName=google&imageType=centos

Parameters
Type Name Description Schema Default

Query

imageType
required

Google cloud OS Image Type

string

Query

orgName
required

Organization Name

string

Query

providerName
required

Cloud Provider Name

string

Responses
HTTP Code Description Schema

200

successful operation

< < string, object > map > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.28.30. Google Cloud Zone List

GET /cloudCompute/listGoogleZones
Description

This operation retrieves the list of all the Google cloud zones.
The following example shows a sample request URL:
/rest/cloudCompute/listGoogleZones?orgName=Internal&providerName=google

Parameters
Type Name Description Schema Default

Query

orgName
required

Organization Name

string

Query

providerName
required

Cloud Provider Name

string

Responses
HTTP Code Description Schema

200

successful operation

< < string, object > map > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.28.31. List Amazon Machine Images

GET /cloudCompute/listImages
Description

This operation retrieves the list of Amazon machine images added by users.
The following example shows a sample request URL:
/rest/cloudCompute/listImages

Parameters
Type Name Description Schema Default

Query

cloudProviderId
optional

Cloud Provider Id

integer(int32)

Query

cloudProviderName
optional

Cloud Provider Name

string

Query

orgId
optional

Organization Id

integer(int32)

Query

orgName
optional

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Amazon Machine Image > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.28.32. List AWS Instance Families

GET /cloudCompute/listInstanceFamilies
Description

This operation retrieves the list of AWS Instance Families.
The following example shows a sample request URL:
/rest/cloudCompute/listInstanceFamilies

Responses
HTTP Code Description Schema

200

successful operation

< AWS Instance Family Type > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.28.33. List Instance Types

GET /cloudCompute/listInstanceTypes
Description

This operation retrieves the list of AWS instance types.
The following example shows a sample request URL:
/rest/cloudCompute/listInstanceTypes?instanceFamily=General purpose

Parameters
Type Name Description Schema Default

Query

instanceFamily
required

Instance Family

string

Responses
HTTP Code Description Schema

200

successful operation

< AWS Instance Type > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.29. Cloud Network Service

Description

This service provides methods to add a VPC in cloud, delete a VPC in cloud and get next available VPC in cloud.

4.29.1. Create Network in Cloud

POST /cloudNetwork/createNetwork
Description

Create a Cloud Network.
Below example shows sample request JSON:
{"cloudProviderName":"AWS","fullAddress":"10.1.10.0","mask":24,"tenancy":"Dedicated","name":"Test","orgName":"Internal","dhcpOptionsSetId":"Test","series":"10","startIP":"10.0.0.1","endIP":"10.0.0.255"}

Parameters
Type Name Description Schema Default

Body

body
required

Create Network Request

Create Network Request

Responses
HTTP Code Description Schema

200

successful operation

Create Network Response

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.29.2. Delete Network in Cloud

POST /cloudNetwork/deleteNetwork
Description

Delete a Cloud Network.
Below example shows sample request JSON:
{"vpcId":"ERTFDFD54SDS6SDS","cloudProviderName":"AWS-Provider","orgName":"Internal"}

Parameters
Type Name Description Schema Default

Body

body
required

Delete Network Request

Delete Cloud Network Request

Responses
HTTP Code Description Schema

200

successful operation

boolean

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.29.3. Gets Next Available Network Address

GET /cloudNetwork/getNextAvailableNetwork
Description

Returns next available IP to create a VPC in the given cloud provider and given mask. If startIP and endIP are given, the next available network in that range will be returned. If series is given, the next available network in the below ranges will be returned. 10.0.0.0 - 10.255.255.255 or 172.16.0.0 - 172.31.255.255 or 192.168.0.0 - 192.168.255.255 according to the series given. Series accepts 10 or 172 or 192. If series is also not given, the above ranges will be checked in that order.
The example listed below shows a sample request URL:
/rest/cloudNetwork/getNextAvailableNetwork?cloudProviderName=AWS&organizationName=Internal&mask=8

Parameters
Type Name Description Schema Default

Query

cloudProviderName
required

Cloud Provider Name

string

Query

endIP
optional

endIP

string

Query

mask
required

Mask

integer(int32)

Query

organizationName
required

Organization Name

string

Query

series
optional

Series

string

Query

startIP
optional

StartIP

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • text/plain

4.29.4. Create the discovered cloud subnets

POST /cloudSubnet/createDiscoverdSubnets
Description

Creates discovered cloud subnets into IPAM.
Below example shows sample request JSON:

Parameters
Type Name Description Schema Default

Query

cmdId
required

Cloud subnet discovery command ID

integer(int32)

Body

body
optional

List of discovered cloud subnets

< Cloud Subnet Bean > array

Responses
HTTP Code Description Schema

200

successful operation

Cloud Subnets Creation Status in the IPAM

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.29.5. Create Subnet in Cloud

POST /cloudSubnet/createSubnet
Description

Create a Cloud Network.
Below example shows sample request JSON:
{"vpcId":"vpc-10","subnetFullAddress":"10.1.10.0/24","mask":24,"name":"Test","cloudProviderName":"AWS","orgName":"Internal","region":"us-east1","networkFullAddress":"10.1.10.0/24"}

Parameters
Type Name Description Schema Default

Body

body
required

Create Subnet Request

Create Subnet Request

Responses
HTTP Code Description Schema

200

successful operation

Create Subnet Response

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.29.6. Delete Subnet in Cloud

POST /cloudSubnet/deleteSubnet
Description

Delete a Cloud Subnet.
Below example shows sample request JSON:
{"addressList":"[192.168.20.0/24,192.168.32.0/24]","organizationName":"Internal","deletedBy":201,"isDeleterrsChecked":0}

Parameters
Type Name Description Schema Default

Body

body
required

Delete Subnet Request

Delete Cloud Subnet Request

Responses
HTTP Code Description Schema

200

successful operation

boolean

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

4.29.7. Discover cloud hosted subnets

POST /cloudSubnet/discover
Description

Discovers the cloud hosted subnets from the specified cloud providers.
Below example shows sample request JSON:

Parameters
Type Name Description Schema Default

Query

all
optional

Use all cloud providers

boolean

Body

body
required

List of cloud providers

< DNS Cloud Provider > array

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.29.8. Discard discovery results

POST /cloudSubnet/discovery/discardCmds
Description

Discard the cloud discovery results.
Below example shows sample request data:

Parameters
Type Name Description Schema Default

Body

body
required

Discovery commands

< integer(int32) > array

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.29.9. Discovery command

GET /cloudSubnet/discovery/getCmdStatus
Description

Obtain the status of a cloud subnet discovery command
The example listed below shows a sample request URL:
/rest/cloudSubnet/discovery/getCmdStatus?cmdId=1254

Parameters
Type Name Description Schema Default

Query

cmdId
required

Cloud subnet discovery command ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.29.10. Discovery commands

GET /cloudSubnet/discovery/getCmds
Description

Obtains a list of all cloud subnet discovery commands
The example listed below shows a sample request URL:
/rest/cloudSubnet/discovery/getCmds

Responses
HTTP Code Description Schema

200

successful operation

< DBDiscoveryCommand > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.29.11. Discovered cloud subnet list

GET /cloudSubnet/getDiscoveredSubnets
Description

Obtains a list of all discovered cloud subnets for a given discovery command.
The example listed below shows a sample request URL:
/rest/discovery/getDiscoveredSubnets?cmdId=cmdIdValue

Parameters
Type Name Description Schema Default

Query

cmdId
required

Cloud subnet discovery command ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< Cloud Subnet Bean > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.29.12. Gets Next Available Network Address

GET /cloudSubnet/getNextAvailableSubnet
Description

Returns next available IP to create a VPC in the given cloud provider and given mask.
The example listed below shows a sample request URL:
/rest/cloudSubnet/getNextAvailableSubnet?cloudProviderName=AWS&organizationName=Internal&mask=16&vpcId=vpcIdValue&networkAddress=10.1.10.0/24

Parameters
Type Name Description Schema Default

Query

cloudProviderName
required

Cloud Provider Name

string

Query

mask
required

Mask

integer(int32)

Query

networkAddress
required

Network Address

string

Query

organizationName
required

Organization Name

string

Query

vpcId
required

VPC Id. For Google cloud it is network name

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.30. Contact Service

Description

This service provides the information related to the Contacts associated with the TCPWave IPAM such as get, edit, delete, update and list contacts etc.

4.30.1. Contact Add

POST /contact/add
Description

Creates a new contact in the TCPWave IPAM. Only Functional Admin can create contacts in any organizations. Rest of the admins can create contacts only in the organizations that they belong to.
Below example shows the sample request JSON:
{"first_name":"john","last_name":"K","middle_name":"Edward","email_id":""john@tcpwave.com","phone_num":"+9856328","organization_name":"QAOrg""}

Parameters
Type Name Description Schema Default

Body

body
optional

Contacts Information

Responses
HTTP Code Description Schema

500

TIMS-1321: Both organization name and id cannot be null, TIMS-1322: Cannot find the organization, TIMS-1323: invalid email address specified.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.30.2. Contact List based on Roles

GET /contact/auditroleslist
Description

Obtains a list of all the Contacts based on selected user role defined and managed in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/contact/auditroleslist?roles=roleValue

Parameters
Type Name Description Schema Default

Query

roles
required

User Role required to list the contacts

string

Responses
HTTP Code Description Schema

200

successful operation

< Contacts Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.30.3. Contact Delete

POST /contact/delete
Description

Deletes an existing contact in the TCPWave IPAM. Functional Admin can delete contacts belonging to any organization. Rest of the admins can delete contacts belonging to their organization only.
Below example shows the sample request JSON:
{ "organization_name":"QAOrg","first_name":"john","last_name":"k","middle_name":"cena","email_id":""john@tcpwave.com","phone_num":"98563289354""}

Parameters
Type Name Description Schema Default

Body

body
optional

Contacts Information

Responses
HTTP Code Description Schema

500

TIMS-1331: Cannot find organization, TIMS-1332: Cannot find contact for the given criteria.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.30.4. Get Contact Information

POST /contact/get
Description

Provides the information of the contacts present in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Body

body
required

Contact Details

Contacts Information

Responses
HTTP Code Description Schema

200

successful operation

Contacts Information

500

TIMS-1352: Organization does not exist, TIMS-1202: Contact does not exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.30.5. Contact List

GET /contact/list
Description

Obtains a list of all the Contacts defined and managed by the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/contact/list

Responses
HTTP Code Description Schema

200

successful operation

< Contacts Information > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.30.6. Contact List

GET /contact/paged
Description

Obtains a list of all the Contacts defined and managed by the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/contact/paged?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Pagination Rendering Parameter

integer(int32)

Query

filterRules
optional

Filter String

string

Query

inEdit
optional

Edit operation

integer(int32)

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organization list

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Contact Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListContacts Information

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.30.7. Contact List for selected User Roles

GET /contact/roleslist
Description

Obtains a list of all the Contacts based on selected user role defined and managed by the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/contact/roleslist?roles=roleValue

Parameters
Type Name Description Schema Default

Query

roles
required

User Roles required to list the contacts

string

Responses
HTTP Code Description Schema

200

successful operation

< Contacts Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.30.8. Search Contacts

GET /contact/search
Description

Searches for the Contacts present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/contact/search?page=1&rows=20

Parameters
Type Name Description Schema Default

Query

organizations
required

Organization List

string

Query

page
optional

Total page

integer(int32)

Query

rows
optional

Rows per page/Page Size

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListContacts Information

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.30.9. Contact Update

POST /contact/update
Description

Edits an existing contact in the TCPWave IPAM. Only Functional Admin can modify contacts in any organizations. Rest of the admins can create contacts only in the organizations that they belong to.
Below example shows the sample request JSON:
{"first_name":"johnson","last_name":"K","middle_name":"Edward", "email_id":"john@tcpwave.com",
"phone_num":"+9856328","organization_name":"QAOrg"}

Parameters
Type Name Description Schema Default

Query

email
optional

Email Id

string

Query

first_name
optional

First Name

string

Query

last_name
optional

Last Name

string

Query

middle_name
optional

Middle Name

string

Body

body
required

Contact Details

Contacts Information

Responses
HTTP Code Description Schema

500

TIMS-1323: invalid email address specified.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.31. Contingency Service Details

4.31.1. Create Service

POST /contingency/service/add
Description

Creates a service in the TCPWave IPAM.
Below example shows the sample request JSON:
{"organizationName":"TCPWave","name":"Service1","description":"Service1 Description","cname":"www.tcpwave.com.","targets":[{"serviceMode":"LIVE","target":"prod.tcpwave.com."},{"serviceMode":"CONTINGENCY","target":"192.168.2.110"}]}

Parameters
Type Name Description Schema Default

Body

body
required

Service information

Service

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation., TIMS-1536: Service name cannot be null., TIMS-1537: Service already exists: <Service Name>, TIMS-1541: CNAME resource record with owner: <CNAME Record> does not exist., TIMS-1539: Service target does not exist: <Target>

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.31.2. Delete Service

POST /contingency/service/delete
Description

Deletes a service from TCPWave IPAM.,
Below example shows the sample request URL:
/rest/contingency/service/delete?service=Test_Service&orgName=TCPWave

Parameters
Type Name Description Schema Default

Query

orgName
required

Organization Name

string

Query

service
required

Service Name

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation., TIMS-1538: Service does not exist: <Service Name>

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.31.3. Dig CNAME record

GET /contingency/service/digCname
Description

Query associated CNAME record of the service by performing dig operation in the TCPWave IPAM.
Below example shows the sample request URL:
/rest/contingency/service/digCname?service=Test_Service&orgName=TCPWave

Parameters
Type Name Description Schema Default

Query

orgName
required

Organization Name

string

Query

service
required

Service Name

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7003: You are not authorized to perform this operation., TIMS-1538: Service does not exist: <Service Name>

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.31.4. Updated Service

POST /contingency/service/edit
Description

Updates a service in the TCPWave IPAM.
Below example shows the sample request JSON:
{"organizationName":"TCPWave","name":"Service1","description":"Description update","cname":"www.tcpwave.com.","targets":[{"serviceMode":"LIVE","target":"prod.tcpwave.com."},{"serviceMode":"CONTINGENCY","target":"192.168.2.110"}],"oldName":"Service1"}

Parameters
Type Name Description Schema Default

Body

body
required

Service

Service

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation., TIMS-1536: Service name cannot be null., TIMS-1538: Service does not exist: <Service Name>, TIMS-1537: Service already exists: <Service Name>, TIMS-1541: CNAME resource record with owner: <CNAME Record> does not exist., TIMS-1539: Service target does not exist: <Target>

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.31.5. Service Details

GET /contingency/service/get
Description

Get the details of a service defined in the TCPWave IPAM.
Below example shows the sample request URL:
/rest/contingency/service/get?service=Test_Service&orgName=TCPWave

Parameters
Type Name Description Schema Default

Query

orgName
required

Organization Name

string

Query

service
required

Service

string

Responses
HTTP Code Description Schema

200

successful operation

Service

500

TIMS-7003: You are not authorized to perform this operation., TIMS-1538: Service does not exist: <Service Name>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.31.6. Check Service Current Status

GET /contingency/service/getCurrentStatus
Description

Checks and return the current status of a service by performing dig operation in the TCPWave IPAM.
Below example shows the sample request URL:
/rest/contingency/service/getCurrentStatus?service=Test_Service&orgName=TCPWave

Parameters
Type Name Description Schema Default

Query

orgName
required

Organization Name

string

Query

service
required

Service Name

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7003: You are not authorized to perform this operation., TIMS-1538: Service does not exist: <Service Name>

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.31.7. List Services

GET /contingency/service/list
Description

List the services defined in the TCPWave IPAM.
Below example shows the sample request URL:
/rest/contingency/service/list?organizations=orgValue

Parameters
Type Name Description Schema Default

Query

organizations
optional

Comma Separated Organization Names

string

Responses
HTTP Code Description Schema

200

successful operation

< Service > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.31.8. Deletes Service Switch Schedule

POST /contingency/service/schedule/delete
Description

Delete Service Switch Schedules from the TCPWave IPAM.
Below example shows the sample request JSON:

Parameters
Type Name Description Schema Default

Body

body
required

Service Schedule

< Service Schedule > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.31.9. Execute Scheduled Service Switch

POST /contingency/service/schedule/execute
Description

Executes a scheduled service switch in the TCPWave IPAM.
Below example shows the sample request JSON:
{"organizationName":"TCPWave","serviceName":"Service2","serviceMode":"LIVE","schedTaskId":"service2_switch_live"}

Parameters
Type Name Description Schema Default

Body

body
required

Service Schedule

Service Schedule

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.31.10. List Service Switch Schedules

GET /contingency/service/schedule/list
Description

List the service switch schedules of a service defined in the TCPWave IPAM.
Below example shows the sample request URL:/rest/contingency/service/schedule/list?service=Service2&orgName=TCPWave

Parameters
Type Name Description Schema Default

Query

orgName
required

Organization Name

string

Query

service
required

Service Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Service Schedule > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.31.11. Switch Service Mode

POST /contingency/service/switch
Description

Perform switch mode operation for a service in the TCPWave IPAM.
Below example shows the sample request URL:/rest/contingency/service/switch?service=Service2&orgName=TCPWave&newMode=LIVE

Parameters
Type Name Description Schema Default

Query

newMode
required

New Mode

string

Query

orgName
required

Organization Name

string

Query

service
required

Service Name

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation., TIMS-1542: Service target: <Target> does not point to a valid 'A' or 'AAAA' resource record.TIMS-1540: Service mode: <Mode> has not been defined for service: <Service Name>

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.31.12. Switch Multiple Services Mode

POST /contingency/service/switchMultiple
Description

Perform switch mode operation for multiple services in the TCPWave IPAM.
The example listed below shows a sample request URL and JSON:
/rest/contingency/service/switchMultiple?newMode=LIVE

Parameters
Type Name Description Schema Default

Query

newMode
required

New Mode

string

Body

body
required

Service List

< Service > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.31.13. Create Service Mode

POST /contingency/serviceMode/add
Description

Creates a service mode in the TCPWave IPAM.
Below example shows the sample request JSON:
{"mode":"Test","description":"Test Service Mode"}

Parameters
Type Name Description Schema Default

Body

body
required

Service Mode information

Service Mode

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation., TIMS-1531: Service mode cannot be null., TIMS-1533: Service mode already exists: <Mode Name>

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.31.14. Delete Service Mode

POST /contingency/serviceMode/delete
Description

Deletes a service mode from the TCPWave IPAM.
Below example shows the sample request payload:
Test_Mode

Parameters
Type Name Description Schema Default

Body

body
required

Service Mode

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.,TIMS-1532: Service mode does not exist: <Mode Name>, TIMS-1535: Default service mode cannot be deleted.,TIMS-1544: Service mode cannot be deleted as it is associated with one or more contingency service(s).

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.31.15. Updated Service Mode

POST /contingency/serviceMode/edit
Description

Updates a service mode in the TCPWave IPAM.
Below example shows the sample request JSON:
{"mode":"Test-Mode","oldMode":"Test","description":"Test Service Mode"}

Parameters
Type Name Description Schema Default

Body

body
required

Service Mode

Service Mode

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation., TIMS-1534: Default service mode cannot be updated., TIMS-1532: Service mode does not exist: <Mode Name>, TIMS-1533: Service mode already exists: <Mode Name>

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.31.16. Get Service Mode Details

GET /contingency/serviceMode/get
Description

Gets the service mode information defined in the TCPWave IPAM.
Below example shows the sample request URL:
/rest/contingency/serviceMode/get?serviceMode=LIVE

Parameters
Type Name Description Schema Default

Query

serviceMode
required

Service Mode

string

Responses
HTTP Code Description Schema

200

successful operation

Service Mode

500

TIMS-7003: You are not authorized to perform this operation.,TIMS-1532: Service mode does not exist: <Mode Name>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.31.17. Service Mode List

GET /contingency/serviceMode/list
Description

Obtains a list of all the service modes defined in the TCPWave IPAM.
Below example shows the sample request URL:
/rest/contingency/serviceMode/list

Responses
HTTP Code Description Schema

200

successful operation

< Service Mode > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.32. Custom Dashboard Service

4.32.1. Add Dashboard

POST /custom/dashboard/add
Description

This operation creates a new dashboard in the TCPWave IPAM.
The following example shows a sample URL request:
/rest/custom/dashboard/add

The following example shows a sample JSON data:
{"name":"UserName","isDefault":1,"wList":"User Sessions","positions":"[{"w":4,"h":5,"content":"<div class='widget-body'><div class='widget-header'><span class='widget-title'>User Sessions</span><span class='delete-widget hide-btn-menu'><span class='dropdown-trigger' href='' data-target='User-Sessions_btn'><i class='fa fa-ellipsis-v' aria-hidden='true'></i></span><ul id='User-Sessions_btn' class='dropdown-content'><li id='User-Sessions_li_btn' onclick=deleteWidget('User-Sessions-Widget')><i class='fa fa-minus-circle' aria-hidden='true'></i> Remove</li></ul></span></div><div class='widget-content' id='User-Sessions-Widget'></div><div class='widget-updated-time' id='User-Sessions-updateTime'></div></div>"}]","configList":"[{"categoryName":"Executive","widgetName":"User Sessions","url":"rest/home/getActiveSessionsChart","chartType":"bar","queryParams":{"start_date":"2021-12-28","end_date":"2022-01-04"},"callType":"GET","gridType":null}]"}

Parameters
Type Name Description Schema Default

Body

body
required

Dashboard details

Dashboard

Responses
HTTP Code Description Schema

500

TIMS-16022: Dashboard name cannot be null.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.32.2. Dashboard List

GET /custom/dashboard/dashlist
Description

This operation retrieves the list of all the dashboards.
The following example shows a sample request URL:
/rest/custom/dashboard/dashlist

Responses
HTTP Code Description Schema

200

successful operation

< < string, string > map > array

500

TIMS-1351: User Id cannot be null.

No Content

Produces
  • application/json

  • application/xml

4.32.3. Dashboard Delete

GET /custom/dashboard/delete
Description

This operation deletes the existing dashboard.
The following example shows a sample URL request :
/rest/custom/dashboard/delete?name=dashboard1

Parameters
Type Name Description Schema Default

Query

name
required

Dashboard Name

string

Responses
HTTP Code Description Schema

500

TIMS-16022: Dashboard name cannot be null. TIMS-16000: Given dashboard name does not exist.: <name>. TIMS-16001: User cannot delete default dashboards.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.32.4. Edit Dashboard

POST /custom/dashboard/edit
Description

This operation edits the existing dashboard in the TCPWave IPAM.
The following example shows a sample URL request:
/rest/custom/dashboard/edit

The following example shows a sample JSON data:
{"name":"UserName","isDefault":1,"wList":"User Sessions,Total Objects","positions":"[{"w":4,"h":5,"content":"<div class='widget-body'><div class='widget-header'><span class='widget-title'>User Sessions</span><span class='delete-widget hide-btn-menu'><span class='dropdown-trigger' href='' data-target='User-Sessions_btn'><i class='fa fa-ellipsis-v' aria-hidden='true'></i></span><ul id='User-Sessions_btn' class='dropdown-content'><li id='User-Sessions_li_btn' onclick=deleteWidget('User-Sessions-Widget')><i class='fa fa-minus-circle' aria-hidden='true'></i> Remove</li></ul></span></div><div class='widget-content' id='User-Sessions-Widget'></div><div class='widget-updated-time' id='User-Sessions-updateTime'></div></div>"},{"w":4,"h":5,"content":"<div class='widget-body'><div class='widget-header'><span class='widget-title'>Total Objects</span><span class='delete-widget hide-btn-menu'><span class='dropdown-trigger' href='' data-target='Total-Objects_btn'><i class='fa fa-ellipsis-v' aria-hidden='true'></i></span><ul id='Total-Objects_btn' class='dropdown-content'><li id='Total-Objects_li_btn' onclick=deleteWidget('Total-Objects-Widget')><i class='fa fa-minus-circle' aria-hidden='true'></i> Remove</li></ul></span></div><div class='widget-content' id='Total-Objects-Widget'></div><div class='widget-updated-time' id='Total-Objects-updateTime'></div></div>"}]","configList":"[{"widgetName":"User Sessions","queryParams":{"end_date":"2022-01-04","start_date":"2021-12-28"},"gridType":null,"chartType":"bar","categoryName":"Executive","url":"rest/home/getActiveSessionsChart","callType":"GET"},{"categoryName":"Executive","widgetName":"Total Objects","url":"rest/home/getTotalObjectData","chartType":"line","queryParams":{"start_date":"2021-12-28","end_date":"2022-01-04","organizations":"Internal"},"callType":"GET","gridType":null}]","oldName":"UserName"}

Parameters
Type Name Description Schema Default

Body

body
required

Dashboard details

Dashboard

Responses
HTTP Code Description Schema

500

TIMS-16022: Dashboard name cannot be null.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.32.5. Dashboard List

GET /custom/dashboard/list
Description

This operation retrieves the list of all the dashboards.
The following example shows a sample request URL:
/rest/custom/dashboard/list

Parameters
Type Name Description Schema Default

Query

dashboardName
optional

Dashboard Name

string

Responses
HTTP Code Description Schema

200

successful operation

UserDashboards

500

TIMS-1351: User Id cannot be null.

No Content

Produces
  • application/json

  • application/xml

4.32.6. Rename Dashboard

GET /custom/dashboard/rename
Description

This operation rename the existing dashboard.
The following example shows a sample URL request:
/rest/custom/dashboard/rename?name=Green&oldName=Red

Parameters
Type Name Description Schema Default

Query

name
required

Dashboard Name

string

Query

oldName
required

Dashboard Old Name

string

Responses
HTTP Code Description Schema

500

TIMS-16022: Dashboard name cannot be null.TIMS-1351: User Id cannot be null.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.32.7. Dashboard Default

GET /custom/dashboard/updateDefault
Description

This operation updates the existing dashboard to default.
The following example shows a sample URL request:
/rest/custom/dashboard/updateDefault?name=Green&selected=1

Parameters
Type Name Description Schema Default

Query

name
required

Dashboard Name

string

Query

selected
required

isDefault

boolean

Responses
HTTP Code Description Schema

500

TIMS-16022: Dashboard name cannot be null.TIMS-1351: User Id cannot be null.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.32.8. Widget Category List

GET /custom/dashboard/widget/categorylist
Description

This operation retrieves the list of all the widget categories.
The following example shows a sample request URL:
/rest/custom/dashboard/widget/categorylist

Responses
HTTP Code Description Schema

200

successful operation

< < string, string > map > array

500

TIMS-1351: User Id cannot be null.TIMS-16000: Given dashboard name does not exist: <name>.TIMS-16000: Given dashboard name does not exist.TIMS-16022: Dashboard name cannot be null.

No Content

Produces
  • application/json

  • application/xml

4.32.9. Delete Widget

GET /custom/dashboard/widget/delete
Description

This operation deletes an existing widget from the dashboard.
The following example shows a sample URL request:
/rest/custom/dashboard/widget/delete?dName=Executive&wName=CPU Utilization

Parameters
Type Name Description Schema Default

Query

dName
required

Dashboard Name

string

Query

wName
required

Widget Name

string

Query

widgetId
optional

Widget ID

string

Responses
HTTP Code Description Schema

500

TIMS-16022: Dashboard name cannot be null.TIMS-1351: User Id cannot be null.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.32.10. Widget List

GET /custom/dashboard/widget/list
Description

This operation retrieves the list of all the widgets based on the category.
The following example shows a sample request URL:
/rest/custom/dashboard/widget/list?categoryName=Executive

Parameters
Type Name Description Schema Default

Query

categoryName
optional

WidgetCategory Name

string

Responses
HTTP Code Description Schema

200

successful operation

< < string, string > map > array

Produces
  • application/json

  • application/xml

4.33. DHCP Active Lease Service

Description

This service class provides Active Lease of a DHCP Server in the TCPWave IPAM.

4.33.1. Get Active Leases

GET /dhcpActiveLeases/getActiveLeases
Description

Provides all the Active Leases for a given IPv4 DHCP Appliances in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/dhcpActiveLeases/getActiveLeases?serverAddress=1.0.0.3

Parameters
Type Name Description Schema Default

Query

serverAddress
required

DHCP Appliance Address

string

Responses
HTTP Code Description Schema

200

successful operation

< DHCPLeaseObject > array

500

TIMS-4017: Auth token is not specified, TIMS-4016: Auth token has expired, TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.34. DHCP Appliance Service

Description

This service class provides services related to DHCP appliance such as add/edit/delete/configure/sync/list DHCP appliance in the TCPWave IPAM.

4.34.1. DHCP Appliance Create

POST /dhcpserver/add
Description

This operation creates an IPv4 Primary/Failover DHCP Appliance in TCPWave IPAM. You can configure appliance level attributes such as NTP and DNS Resolver, Monitoring, PAM Settings, etc.
Sample payloads with mandatory parameters to add a DHCP Appliance are listed below.
Create DHCP Appliance</br>{ "server": {"v4_ipaddress": "10.1.10.91","name": "TCPWave00005Remote","domain_name": "qa.com","timeZone": "GMT (GMT)","organization_name": "QAOrg","dhcp_policy_template_name": "policy-temp","dhcpd_interfaces": "eth0,eth1","resolverData": "{\"ns1\":\"10.1.10.16\"}","snmpConfig": { \"trapSink1\": \"10.1.10.17\", \"trapSink2\": \"10.1.10.18\", \"communityString\": \"public\", \"systemName\": \"test-dhcp-server.qa.com\", \"processes\": \"ntpd-1/dns-1/sshd-1/monit-1/syslogng-1/dhcpd-1 \ },"ntpConfig": "10.1.10.15","server_type": "DHCP"}}</br>Create DHCP Appliance with MAC Exclusion</br>{ "server": {"v4_ipaddress": "10.1.10.91","name": "TCPWave00005Remote","domain_name": "qa.com","timeZone": "GMT (GMT)","organization_name": "QAOrg","dhcp_policy_template_name": "policy-temp","resolverData": "{\"ns1\":\"10.1.10.16\"}","snmpConfig": { \"trapSink1\": \"10.1.10.17\", \"trapSink2\": \"10.1.10.18\", \"communityString\": \"public\", \"systemName\": \"test-dhcp-server.qa.com\", \"processes\": \"ntpd-1/dns-1/sshd-1/monit-1/syslogng-1/dhcpd-1 \ },"ntpConfig": "10.1.10.15","server_type": "DHCP"},"macExclusionArray":[{"macAddress":"aa:bb:cc:dd:ee:ff"}]}</br>Create DHCP Appliance with SNMPv3 Enabled</br>{ "server": {"v4_ipaddress": "10.1.10.91","name": "TCPWave00005Remote","domain_name": "qa.com","timeZone": "GMT (GMT)","organization_name": "QAOrg","dhcp_policy_template_name": "policy-temp","resolverData": "{\"ns1\":\"10.1.10.16\"}","enableSNMPv3":true,"snmpv3Users":"[{\"userName\":\"tcpwave\",\"password\":\"wxyz1234",\"authentication_protocol\":\"SHA\",\"encryption_protocol\":\"AES\"}]","snmpConfig": { \"trapSink1\": \"10.1.10.17\", \"trapSink2\": \"10.1.10.18\", \"communityString\": \"public\", \"systemName\": \"test-dhcp-server.qa.com\", \"processes\": \"ntpd-1/dns-1/sshd-1/monit-1/syslogng-1/dhcpd-1 \ },"ntpConfig": "10.1.10.15","server_type": "DHCP"}}

Parameters
Type Name Description Schema Default

Body

body
required

DHCP appliance details

DHCP Appliance

Responses
HTTP Code Description Schema

500

TIMS-3030: Both object id and IP Address cannot be null, TIMS-3033: An appliance already exists with the specified address, TIMS-3031: Specified object not found, TIMS-3036: Both DHCP Policy Template name and id cannot be null, TIMS-3037: Specified DHCP Policy Template not found, TIMS-3038: Invalid Appliance Type specified, TIMS-3039: Cannot create a appliance using a DHCP object.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.34.2. DHCP Appliance Delete

POST /dhcpserver/delete
Description

This operation deletes a given IPv4 DHCP appliance, provided it does not serve any references associated with the DHCP appliance.
The following example shows a sample request URL:
/rest/dhcpserver/delete?address=10.1.10.91

Parameters
Type Name Description Schema Default

Body

body
required

Appliance details

Appliance Information

Responses
HTTP Code Description Schema

500

TIMS-1368: Cannot delete the DHCP Appliance as it manages one or more subnets, TIMS-1369: Cannot delete the DHCP Appliance as it manages one or more scopes, TIMS-1370: Cannot delete the DHCP Appliance, as it’s a failover to a DHCP Appliance, TIMS-1371: Cannot delete the DHCP Appliance, as there are Manual-DHCP Objects associated to it, TIMS-1360: Specified appliance not found. <Server address>, TIMS-1359: Both appliance id and address cannot be null.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.34.3. DHCP Appliance Active Leases

GET /dhcpserver/dhcpActiveLeases
Description

This operation retrieves the list of IPv4 DHCP Appliance active leases defined and managed by the TCPWave IPAM.
The following example shows a sample request URL
/rest/dhcpserver/dhcpActiveLeases?serverIp=10.0.0.2

Parameters
Type Name Description Schema Default

Query

serverIp
required

Required Server’s IP address

string

Responses
HTTP Code Description Schema

200

successful operation

PagedListDHCPLeaseObject

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.34.4. DHCP Appliance Update

POST /dhcpserver/edit
Description

This operation edits an IPv4 Primary/Failover DHCP Appliance in TCPWave IPAM. You can configure appliance level attributes such as NTP and DNS Resolver, Monitoring, PAM Settings, etc.
The following example shows a sample request JSON:
{"server": { "serverPreference": "Primary","v4_ipaddress": "10.1.10.124","name":"Sales-Remote-125","domain_name":"adomain.com","appliance_group":"test Detroit","timeZone":"GMT (GMT)","dhcp_policy_template_name":"dhcp test","dhcpd_interfaces":"eth0,eth1","description":"","monitoringService":"yes","old_address":"10.1.10.125","banner":"","setFailoverFlag": false,"option":"no","snmpConfig":
{
"trapSink1":"10.1.10.126","trapSink2":"10.1.10.127","communityString":"10.1.10.128","systemContact":"","systemName":"Sales-Remote-125.adomain.com","processes":"ntpd-1/dns-1/sshd-1/monit-1/syslogng-1/dhcpd-1"}, "resolverData":{"ns1":"110.1.10.129","ns2":"","ns3":"","ns4":"","search1":"","search2":"","search3":"","search4":"","search5":"","search6":""}, "syslogConfig":[{"action":"/var/log/messages","active":"yes","selector":".info;mail.none;authpriv.none;cron.none","type":"File"}, {"action":"/var/log/secure","active":"yes","selector":"authpriv.","type":"File"},{"action":"-/var/log/maillog","active":"yes","selector":"mail.","type":"File"},{"action":"/var/log/cron","active":"yes","selector":"cron.","type":"File"},{"action":":omusrmsg:*","active":"yes","selector":".emerg","type":"DefaultType"},{"action":"/var/log/spooler","active":"yes","selector":"uucp,news.crit","type":"File"},{"action":"/var/log/boot.log","active":"yes","selector":"local7.","type":"File"} ],"ntpConfig":"10.1.10.130","idracSnmpCommunity":"no-@--@--@-","server_type":"DHCP"},"macExclusionArray":[{"macAddress":"AA:BB:CC:DD:EE:FF","macDescription":""}]}

Parameters
Type Name Description Schema Default

Body

body
required

DHCP appliance details

DHCP Appliance

Responses
HTTP Code Description Schema

500

TIMS-3030: Both object id and IP Address cannot be null. TIMS-3031: Specified object is not found. TIMS-3036: Both DHCP Policy Template name and id cannot be null. TIMS-3037: Specified DHCP Policy Template not found.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.34.5. Form a cluster with 2 remote appliances

POST /dhcpserver/formCluster
Parameters
Type Name Description Schema Default

Body

body
required

Remote Cluster details

Remote Cluster Server Information

Responses
HTTP Code Description Schema

500

TIMS-3009: Object does not exist.
TIMS-3033: An Appliance already exists with the 10.1.10.10

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.34.6. Generate appliance Configuration for sync

GET /dhcpserver/generateConfig
Description

This operation generates adhoc IPv4 DHCP, other miscellaneous appliance level configurations and syncs the appliance with the latest data. Configuration generation is subjected to a sanity check process that validates the syntax of the DHCP Configuration to ensure that erroneous configuration is not sent to the appliance.
The following example shows a sample request URL
/rest/dhcpserver/generateConfig?address=10.0.0.2&organization_name=QAOrg&servername=srver1

Parameters
Type Name Description Schema Default

Query

address
required

Required Server’s IP address

string

Query

organization_name
required

Required Organization Name

string

Query

servername
required

Required Appliance Name

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.34.7. DHCP Appliance Heartbeat

GET /dhcpserver/heartbeat
Description

This operation retrieves the heartbeat status of any IPv4 DHCP appliance in the TCPWave IPAM
The example listed below shows a sample request URL:
rest/dhcpserver/heartbeat?server_ip=10.0.0.2&server_type=dhcpServer

Parameters
Type Name Description Schema Default

Query

server_ip
required

Required Server’s IP address

string

Query

server_type
required

Required Server’s type

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.34.8. DHCP Appliance List

GET /dhcpserver/list
Description

This operation retrieves the list of all the IPv4 DHCP Appliances configured in the TCPWave IPAM.
The following example shows a sample request URL:
/rest/dhcpserver/list?organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Server Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.34.9. DHCP Appliance List

GET /dhcpserver/page
Description

This operation retrieves the list of the paginated DHCP appliances defined in the TCPWave IPAM.
The following example shows a sample request url:
/tims/rest/dnsserver/page/?draw=1&start=0&length=20&sort=name&order=asc&filterRules=[]

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

customFilterRules
optional

Custom Filter String

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organization Names

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting DHCP Appliance Range

integer(int32)

Responses
HTTP Code Description Schema

200

Success

Server Information

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.34.10. Reset remote cluster

POST /dhcpserver/resetCluster
Parameters
Type Name Description Schema Default

Body

body
required

Remote Cluster IP

string

Responses
HTTP Code Description Schema

500

TIMS-3009: Object does not exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.34.11. Appliance Configuration

GET /dhcpserver/server-configuration/{server_address}
Description

This operation retrieves the DHCP appliance configuration of a given object address in the TCPWave IPAM.
The following example shows a sample request URL
/rest/dhcpserver/server-configuration?server_address=10.0.0.2

Parameters
Type Name Description Schema Default

Path

server_address
required

Required Server IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

DHCP Appliance

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.34.12. Appliance Subnet References

GET /dhcpserver/server-subnet-references
Description

This operation retrieves the list of subnet references associated with an IPv4 DHCP Appliance in the TCPWave IPAM.
The following example shows a sample request URL
/rest/dhcpserver/server-subnet-references?address=10.0.0.2

Parameters
Type Name Description Schema Default

Query

address
required

IP address of the selected Server

string

Responses
HTTP Code Description Schema

200

successful operation

< Subnet Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.34.13. DHCP Appliance IP Count

GET /dhcpserver/serverIPCount
Description

This operation retrieves the total count of Dynamic DHCP IP addresses managed by each IPv4 DHCP Appliance in the TCPWave IPAM.
The following example shows a sample request URL
/rest/dhcpserver/serverIPCount?organizations=QAOrg

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization List

string

Responses
HTTP Code Description Schema

200

successful operation

< string > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.34.14. Execute Command on DHCP Appliance

GET /dhcpserver/subsys
Description

This operation retrieves information about the execution output of a given command number from an IPv4 DHCP appliance.
The example listed below shows a sample request URL
rest/dhcpserver/subsys?server_name=TCPWave00005Remote&server_ip=10.0.0.0&argc=2
Note: Below are the arc values should be use in argc based on the command:
/opt/tcpwave/scripts/timsdhcpRestart.sh =0
/usr/bin/sudo /sbin/service snmpd restart =1
sudo /bin/timeout 5s /usr/sbin/tcpdump -nn -i eth0 udp port 67 or tcp port 68 -c 200 -tttt =2
/usr/bin/sudo /sbin/service snmpd restart =3
/usr/bin/sudo /sbin/service dhcpd restart =4
/usr/bin/sudo /sbin/service monit restart =5
/usr/bin/sudo /sbin/service ntpd restart =6
/usr/bin/sudo /sbin/service sshd restart =7
/opt/tcpwave/scripts/powerCycle =8
/opt/tcpwave/scripts/powerOff =9
disable dhcp service =10
restart dhcp service =11
enable dhcp service =12

Parameters
Type Name Description Schema Default

Query

argc
required

argc

integer(int32)

Query

server_ip
required

Required Server’s IP address

string

Query

server_name
required

Required Server’s Name

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.34.15. Sync DHCP Active Leases

POST /dhcpserver/syncActiveLease
Description

This operation synchronizes all the active leases data for the defined and managed appliance by the TCPWave IPAM and publishes the DDNS updates.
The example listed below shows a sample request URL
/rest/dhcpserver/syncActiveLease?serverAddress=192.168.0.158&subnetAddress=192.168.0.0&dhcpType=DHCP&orgName=Internal&type=subnet

Parameters
Type Name Description Schema Default

Query

dhcpType
required

Required Appliance type

string

Query

orgName
required

Organization

string

Query

serverAddress
required

Required Appliance IP address

string

Query

subnetAddress
required

Subnet IP address

string

Query

type
required

Type

string

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.34.16. Generate Appliance Configuration for sync of all servers

POST /dhcpserver/syncall
Description

This operation generates Adhoc IPv4 DHCP and other miscellaneous appliance level configurations and syncs all the appliances with the latest data. Configuration generation is subjected to a sanity check process that validates the syntax of the DHCP Configuration to ensure that erroneous configuration is not sent to the appliance.
The following example shows a sample request JSON:
[{"name":"sit-remote-001","v4_address":"10.1.10.186","organization_name":"EARTH"},{"name":"sit-remote-002","v4_address":"10.1.10.187","organization_name":"EARTH"}]

Parameters
Type Name Description Schema Default

Query

organization_name
required

Required Organization Name

string

Body

body
required

List of DHCP appliance details

< Server Basic Information > array

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.34.17. Update remote cluster settings

POST /dhcpserver/updateCluster
Parameters
Type Name Description Schema Default

Body

body
required

Remote Cluster details

Remote Cluster Server Information

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.34.18. View Configuration

GET /dhcpserver/viewconfig
Description

This operation downloads the latest IPv4 DHCP Appliance configuration defined and managed by the TCPWave IPAM.
The following example shows a sample request URL
/rest/dhcpserver/viewconfig?address=10.0.0.2&organization_name=QAOrg

Parameters
Type Name Description Schema Default

Query

address
required

IP address of the selected Server

string

Query

organization_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.35. DHCP Class Service

Description

This service class provides facility to add, modify, delete, list DHCP Client class in the TCPWave IPAM.

4.35.1. Create DHCP Class

POST /dhcpclass/add
Description

This operation creates DHCP Client, User, and Vendor classes in the TCPWave IPAM.
The following example shows the sample request JSON:
{"name":"user-class","match_expression":"option user-class = userclass;","description":"DHCP class added from REST API","entity_type":"USER"}

Parameters
Type Name Description Schema Default

Body

body
required

DHCP class details

DHCP Class

Responses
HTTP Code Description Schema

500

TIMS-2027: DHCP class with the given match expression already exists, TIMS-2028: DHCP class with the given name already exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.35.2. DHCP Classes Delete

POST /dhcpclass/delete
Description

This operation deletes the DHCP class definition, provided there are no references associated with it.
The following example shows the sample request URL:
/dhcpclass/delete?name=client8&entityType=CLIENT

Parameters
Type Name Description Schema Default

Query

entityType
required

Required Entity Type

string

Query

id
optional

Required DHCP Class Id

integer(int32)

Query

name
required

DHCP Class Name

string

Responses
HTTP Code Description Schema

500

TIMS-1371: Cannot delete this class as it is being used by one or more scopes, TIMS-7003: You are not authorized to perform this operation, TIMS-1371: Cannot delete this class as it is being used by one or more scopes.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.35.3. DHCP Class Edit

POST /dhcpclass/edit
Description

This operation edits a given DHCP class, and the class name, the match expression can be edited.
The following example shows a sample request JSON:
{"name":"Client1","match_expression":"option dhcp-client-identifier = client;","description":"testing","entity_type":"CLIENT","previous_name":"Client11"}

Parameters
Type Name Description Schema Default

Body

body
required

DHCP class details

DHCP Class

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-2027: DHCP class with the given match expression already exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.35.4. DHCP Class List

GET /dhcpclass/get
Description

This operation retrieves the list of all the DHCP class definitions defined in the TCPWave IPAM.
The following example shows a sample request URL:
rest/dhcpclass/get?entityType=VENDOR&name=nameValue

Parameters
Type Name Description Schema Default

Query

entityType
required

Entity Type

string

Query

name
required

Class Name

string

Responses
HTTP Code Description Schema

200

successful operation

< DHCP Class > array

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.35.5. DHCP Class List

GET /dhcpclass/list
Description

This operation retrieves the paginated list of all the DHCP class definitions defined in the TCPWave IPAM.
The following example shows a sample request URL:
/rest/dhcpclass/list?entityType=VENDOR

Parameters
Type Name Description Schema Default

Query

entityType
required

Entity Type

string

Responses
HTTP Code Description Schema

200

successful operation

< DHCP Class > array

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.35.6. Find DHCP Class References

GET /dhcpclass/references
Description

This operation retrieves the list of DHCP class references like scope, DHCP manual objects in the TCPWave IPAM.
The following example shows the sample request URL:
/rest/dhcpclass/references?tables=tableName

Parameters
Type Name Description Schema Default

Query

count
optional

Count Flag

string

Query

id
optional

Reference Id

string

Query

page
optional

Page Number

integer(int32)

Query

rows
optional

Number of rows

integer(int32)

Query

tables
required

Table

string

Responses
HTTP Code Description Schema

200

successful operation

Reference Results

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.36. DHCP Defaults Service

Description

This service provides API's to get and update DHCP defaults in the TCPWave IPAM.

4.36.1. Get Global DHCP Elevated Privileges

GET /DHCPDefaults/get
Description

Provides the details of Global DHCP Elevated Privileges

Responses
HTTP Code Description Schema

200

successful operation

DHCPApplianceDefaults

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.36.2. Get Global DHCP Syslog-ng Configuration

GET /DHCPDefaults/getSyslogngConfig
Description

Provides the details of Global DHCP Syslog-ng Configuration

Responses
HTTP Code Description Schema

200

successful operation

DHCPApplianceDefaults

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.36.3. Get Global DHCP TACACS+ Configuration

GET /DHCPDefaults/getTacacsConfig
Description

Provides the details of Global DHCP TACACS+ Configuration

Responses
HTTP Code Description Schema

200

successful operation

DHCPApplianceDefaults

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.37. DHCP Failover Service

Description

This service class provides services related to DHCP Failover peer such as add/update/delete/list/get for DHCP failover peer defined in the TCPWave IPAM.

4.37.1. Failover Peer Add

POST /dhcpfailoverpeer/add
Description

This operation creates the DHCP IPv4 failover peers based on peer properties such as primary, failover ports, split, etc., in the TCPWave IPAM.
The following example shows a sample request JSON:
{"organizationName":"Internal","name":"Post peer","primaryServerAddress":"10.1.10.3","failoverServerAddress":"10.1.10.5","primary_port":"647","failover_port":"647","mclt":"1800","max_response_delay":"30","max_unacked_updates":"30","load_balance_max_secs":"3","sso_interval":"","split":"50","description":"","dhcp_type":"dhcp"}

Parameters
Type Name Description Schema Default

Body

body
optional

DHCP Failover

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.37.2. Failover Peer Delete

POST /dhcpfailoverpeer/delete
Description

This operation deletes the DHCP IPv4 Failover Peers from the TCPWave IPAM provided there are no references associated with it.
The following example shows a sample request JSON:
{"primaryServerAddress":"10.1.10.3","failoverServerAddress":"10.1.10.5","organizationName":"Earth","name":"Post peer"}

Parameters
Type Name Description Schema Default

Body

body
optional

DHCP Failover

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.37.3. Failover Peer Details

GET /dhcpfailoverpeer/get
Description

This operation retrieves the peer configuration properties for the given Failover Peer name from the TCPWave IPAM.
The following example shows a sample request URL:
/rest/dhcpfailoverpeer/get?peerName=test

Parameters
Type Name Description Schema Default

Query

peerName
optional

string

Responses
HTTP Code Description Schema

200

successful operation

DHCP Failover

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.37.4. Failover Peer List

GET /dhcpfailoverpeer/list
Description

This operation retrieves the list of all the defined DHCP IPv4 Failover Peers in the TCPWave IPAM .
The following example shows a sample request URL:
/rest/dhcpfailoverpeer/list?serverAddress=1.0.0.3&organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organizations

string

Query

serverAddress
optional

string

Responses
HTTP Code Description Schema

200

successful operation

< DHCP Failover > array

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.37.5. Failover Peer List

GET /dhcpfailoverpeer/listrows
Description

This operation retrieves the paginated list of all the DHCP IPv4 Failover Peers from the TCPWave IPAM.
The following example shows a sample request URL:
/rest/dhcpfailoverpeer/listrows?serverAddress=1.0.0.5&organizations=Internal&start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

length
required

Page Length

integer(int32)

Query

organizations
optional

Organizations

string

Query

serverAddress
optional

string

Query

start
required

Starting Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListDHCP Failover

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.37.6. Failover Peer Edit

POST /dhcpfailoverpeer/update
Description

This operation edits the DHCP IPv4 failover peers based on peer properties such as primary, failover ports, split, etc., and updates the latest information to the appliances in the TCPWave IPAM.
The following example shows a sample request JSON:
{"organizationName":"Earth","name":"Post peer","primaryServerAddress":"10.1.10.3","failoverServerAddress":"10.1.10.6","primary_port":"647","failover_port":"647","mclt":"1800","max_response_delay":"30","max_unacked_updates":"30","load_balance_max_secs":"3","sso_interval":"","split":"50","description":"","dhcp_type":"dhcp","id":21,"oldName":"Post peer"}

Parameters
Type Name Description Schema Default

Body

body
optional

DHCP Failover

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.38. DHCP Option Space

4.38.1. DHCP option space add

POST /dhcpOptionSpace/create
Description

This operation creates DHCP option space in the TCPWave IPAM.
The following example shows a sample request JSON:
{ "DHCPOptionSpace": {"optionSpaceName": "optionPXE","vendorClassName": "DELL","description": "DHCP option space",}}

Parameters
Type Name Description Schema Default

Body

body
optional

DHCP Option Space

Responses
HTTP Code Description Schema

500

TIMS-4001: DHCP option space already exits with name <name>

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.38.2. DHCP option space delete

POST /dhcpOptionSpace/delete
Description

This operation deletes the given DHCP option space provided there are no references like DHCP IPv4 option template, etc., associated with it.
The following example shows a sample request URL:
/rest/dhcpOptionSpace/delete?optionSpaceName=Test

Parameters
Type Name Description Schema Default

Query

optionSpaceName
required

Option Sequence

string

Responses
HTTP Code Description Schema

500

TIMS-3938: DHCP option space does not exist with name <name>

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.38.3. Option Space List

GET /dhcpOptionSpace/list
Description

This operation retrieves the list of DHCP option spaces defined and managed by the TCPWave IPAM.
The following example shows a sample request URL:
/rest/dhcpOptionSpace/list

Responses
HTTP Code Description Schema

200

successful operation

< DHCP Option Space > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.38.4. User Defined sub options list

GET /dhcpOptionSpace/list-sub-options
Description

This operation retrieves the list of all sub-options defined within option space in the TCPWave IPAM.
The following example shows a sample request URL:
/rest/dhcpOptionSpace/list-sub-options?optionSpaceName=Test

Parameters
Type Name Description Schema Default

Query

optionSpaceName
required

DHCP Option Space name

string

Responses
HTTP Code Description Schema

200

successful operation

< Parameters Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.38.5. DHCP option space update

POST /dhcpOptionSpace/update
Description

This operation updates DHCP option space data in the TCPWave IPAM.
The following example shows a sample request JSON:
{ "DHCPOptionSpace": {"optionSpaceName": "optionPXE","vendorClassName": "DELL","prevoptionSpaceName": "optionTest","description": "DHCP option space",}}

Parameters
Type Name Description Schema Default

Body

body
optional

DHCP Option Space

Responses
HTTP Code Description Schema

500

TIMS-3946: DHCP option space cannot be update as the sub options defined in it are used in the option template(s).,TIMS-3943: DHCP option space already exists with name <name>

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.39. DNS Analytics Service

Description

This service provides API's such as get anomalous domains, to whitelist or block the domains, retrain "

4.39.1. Block Domains

POST /dnsanalytics/blockdomains
Description

Block the given domains through RPZ.
Below example shows sample request:
domain.com,tcpwave.com,internal.com

Parameters
Type Name Description Schema Default

Body

body
optional

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

4.39.2. Delete anomalous Domains

POST /dnsanalytics/deletedomains
Description

Delete the given anomalous domains from the database. This operation does not effect the domains which are whitelisted or blocked already.
Below example shows sample request:
domain.com, tcpwave.com, internal.com

Parameters
Type Name Description Schema Default

Body

body
optional

string

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • text/plain

4.39.3. Get Domains Reputation Data

GET /dnsanalytics/getanomalousdomains
Description

Gets the anomalous domains that are detected during DNS tunnel detection and the domains repuration data imported by the user and the information about the state of the domains if they are whitelisted or blocked.
The example listed below shows a sample request URL:
/rest/dnsanalytics/getanomalousdomains

Responses
HTTP Code Description Schema

200

successful operation

< AnomalousDomain > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.39.4. Get DNS Analytics Rules

GET /dnsanalytics/getrules
Description

Gets various rules defined to analyze DNS traffic.
Below example shows the sample request URL:
/rest/dnsanalytics/getrules

Responses
HTTP Code Description Schema

200

successful operation

DNSAnalyticsRules

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.39.5. Import Domains Reputation Data

POST /dnsanalytics/importdomains
Description

Imports domains with the reputational information such as whitelisted or blocked or none.
Below example shows sample request JSON:
/file/txt

Parameters
Type Name Description Schema Default

Body

body
optional

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

4.39.6. Retrain DNS Tunnel Detection ML Model

POST /dnsanalytics/retraintunneldetectionmodel
Description

Retrains the DNS tunnel detection machine learning model with the DNS whitelisted reputation data on all live DNS appliances.It accepts a file with header as dns.qry.name and values as the whitelisted queries. ML model will perform well if the number of rows are between 5000 to 10000.
Below example shows sample request JSON:
string

Parameters
Type Name Description Schema Default

Body

body
optional

string

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • text/plain

4.39.7. Update DNS Analytics Rules

POST /dnsanalytics/updaterules
Description

Updates DNS Analytics Rules in TIMS database and also send configuration to each live DNS remote.
Below example shows the sample request JSON:
{"queryCountPerDomainThreshold":"20","queryCountPerHostThreshold":"20","fqdnLengthThreshold":"20","subdomainLengthThreshold":"40","intPercentThreshold":"80"}

Parameters
Type Name Description Schema Default

Body

body
optional

DNSAnalyticsRules

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.39.8. Whitelist Domains

POST /dnsanalytics/whitelistdomains
Description

Whitelist the given domains.
Below example shows sample request:
domain.com, tcpwave.com, internal.com

Parameters
Type Name Description Schema Default

Body

body
optional

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

4.40. DNS Appliance Service

Description

This service provides API's to get list of DNS Appliances present in the TCPWave IPAM, add DNS Appliances, update DNS Appliances, delete DNS Appliances, download configuration for DNS Appliances, dig a DNS Appliance, search for a DNS Appliance in the TCPWave IPAM.

4.40.1. Add DNS Appliance

POST /dnsserver/add
Description

Creates DNS Appliance that can be used to service the DNS requests. This remote Appliance is configured, maintained and managed by the IPAM.
The allowed Appliance types are (1) ISC Bind Authoritative Appliance (2) ISC Bind Cache Appliance (3) NSD Authoritative Appliance (4) Unbound Cache Appliance (5) DNS Proxy Appliance

Sample payload to add a DNS BIND AUTH Appliance is listed below.
Create DNS Appliance
{"server_type":"BIND AUTH","stealthServer":0,"authAsCache":"no","internal_cache_server":1,"dmzVisible":0,"autoDNSDR":null, "autoRestoreConf":0, "enableDnsOverTLS":"no", "v4_ipaddress":"42.0.0.11", "name":"TCPWave00007Remote", "timeZone":"GMT (GMT)", "dns_server_template_name":"DNS PROXY Default Server Template", "dns_options_template_name":"DNS PROXY Default Template", "nsm_template":"test_template_1", "organization_name":"Internal", "snmpConfig":"{"trapSink1":"42.0.0.11","trapSink2":"42.0.0.12","communityString":"zxcv","systemContact":"","systemName":"TCPWave00007Remote.kiran.com","processes":"ntpd-00/dns-0/sshd-0/monit-0/syslog-ng-0/dhcpd-1"}", "enableSNMPv3":false,"monitoringService":"yes", "banner":"The default value of Banner configuration for DNS and DHCP appliances.","ldapSSHConfig":"{"enable":false}", "ntpConfig":"42.0.0.11", "resolverData":"{"ns1":"42.0.0.12","ns2":"","ns3":"","ns4":"","search1":"","search2":"","search3":"","search4":"","search5":"","search6":""}"}

Parameters
Type Name Description Schema Default

Body

body
required

DNS appliance details

Server Information

Responses
HTTP Code Description Schema

500

TIMS-3009: Object does not exist.
TIMS-3030: Both object id and IP Address cannot be null
TIMS-3031: Object is not deleted as it is associated with a zone
TIMS-3038: Appliance Type is not valid:{0}
TIMS-3033: An Appliance already exists with the : {0}
TIMS-3034: Both DNS Appliance Template name and id cannot be null
TIMS-3035: Specified DNS Appliance Template not found
TIMS-3036: Both DNS Options Template name and id cannot be null
TIMS-3037: Specified DNS Options Template not found
TIMS-3039: Cannot create an Appliance using a DHCP object
TIMS-1335: DNS Internal Cache Appliance cannot be created as there is no root zone defined in this organization
TIMS-3079: Both DNS Options Template name and id cannot be null
TIMS-3080: DNS Options Template does not exist
TIMS-10102: Both view id and view name cannot be null
TIMS-10103: DNS View does not exist for name

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.40.2. Check Non-Managed Name Servers

GET /dnsserver/checkNonManagedNS
Description

Checks whether Non-Managed Name servers exists with the given IP address in the IPAM.
The example listed below shows a sample request URL:
/rest/dnsserver/checkNonManagedNS?ip_address=10.1.10.191&org_name=EARTH

Parameters
Type Name Description Schema Default

Query

ip_address
required

Appliance IP address

string

Query

org_name
required

Organization name

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.
TIMS-15006: Both appliance IP and name cannot be null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.40.3. Virtual IP Address Validation

GET /dnsserver/checkVIP
Description

Validates Virtual IP Address
The example listed below shows a sample request URL:
/rest/dnsserver/checkVIP?vip=applianceIpaddress

Parameters
Type Name Description Schema Default

Query

orgName
optional

Appliance Type Code

string

Query

subnet
optional

Appliance Type Code

string

Query

vip
required

Appliance IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3050: Both Appliance id and address cannot be null.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.40.4. Check DNS Appliance Association with Proxy Root Zone

GET /dnsserver/check_if_server_is_associated
Description

Checks if a DNS Appliance is associated with any Proxy Root Zone or not in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/dnsserver/check_if_server_is_associated?server_ip=10.0.0.2&org_name=QAOrg&old_server_type=BIND AUTH&new_server_type=BIND CACHE

Parameters
Type Name Description Schema Default

Query

new_server_type
optional

New Appliance type

string

Query

old_server_type
required

Old Appliance type

string

Query

org_name
required

Organization Name

string

Query

server_ip
required

Appliance IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

boolean

500

TIMS-1020: Both Organization name and id cannot be null
TIMS-1352: Organization does not exist
TIMS-3020: Both Appliance type and id cannot be null
TIMS-3088: Appliance IP Address is null
TIMS-8085: Cannot change Appliance type of BIND AUTH as it is used by one or more zones as Master
TIMS-8086: Cannot change Appliance type of NSD to {0} as it is used by one or more zones as Slave
TIMS-8121: Appliance Type cannot be modified as it is used by proxy root zone.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.40.5. DNS Appliance Delete

POST /dnsserver/delete
Description

Deletes an existing DNS Appliance that is used to service the DNS requests. A DNS Appliance cannot be deleted when it is actively servicing any forward zone or a reverse zone.
The example listed below shows a sample request URL:
dnsserver/delete?address=10.1.10.87

Parameters
Type Name Description Schema Default

Body

body
required

Appliance details

Appliance Information

Responses
HTTP Code Description Schema

500

TIMS-3050: Both Appliance id and address cannot be null
TIMS-3052: Appliance is not deleted as other zone(s) are using it. Please remove the referencing zone(s) and retry
TIMS-3053: Appliance is not deleted as other zone template(s) are using it. Please remove the referencing zone template(s) and retry
TIMS-3055: Appliance is not deleted as other network(s) are using it. Please remove the referencing network(s) and retry
TIMS-3092: Appliance does not exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.40.6. Appliance Dig

GET /dnsserver/digserver
Description

Performs a basic name resolution for a given resource record using the target DNS Appliance on which the check is to be executed in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/dnsserver/digserver?server_name=TCPWave00002Remote&server_ip=10.0.0.2&server_type=BIND CACHE&record_fqdn=&record_type=A

Parameters
Type Name Description Schema Default

Query

record_fqdn
required

Record’s Fully Qualified Domain Name

string

Query

record_type
required

Record Type

string

Query

server_ip
required

Appliance IP Address

string

Query

server_name
required

Appliance Name

string

Query

server_type
required

Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1369: Request timed out from DNS Appliance.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.40.7. Flush operation on appliance

POST /dnsserver/dnsflush
Description

Performs flush operation on the DNS remote appliances. If the appliance is of type UNBOUND, then domain name must be provided.

Below example shows sample request JSON:
To perform DNS flush on complete appliance
{"organization_name": "Internal","server_ip": "10.1.10.1","flush_type":"complete"}
To perform DNS flush on UNBOUND appliance
{"organization_name":"Internal","server_ip":"10.1.1.10","domain_name":"domain.com","flush_type":"hostname"}

Parameters
Type Name Description Schema Default

Body

body
optional

DNS Appliance Tool

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-15001: Domain/Record should be specified for the DNS flush operation on the appliance: {0} of type: {1}.
TIMS-15002: Flush operation cannot be performed on the appliance: {0} of type: {1} as recursion is not enabled.
TIMS-15003: Flush operation can be performed only on cache appliance, but the appliance: {0} is of type: {1}.
TIMS-15005: Please provide the resource record type of name: {0}.
TIMS-15006: Both appliance IP and name cannot be null.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

4.40.8. DNS Appliance Edit

POST /dnsserver/edit
Description

Edits a DNS appliance that is used to service the DNS requests. This remote appliance is configured, maintained and managed by the IPAM.
Below example shows sample request JSON:
{"server_type": "BIND AUTH","stealthServer": 0,"internal_cache_server": 1,"dmzVisible": 0,"autoDNSDR": null,"autoRestoreConf": 0,"dns_server_template_name": "BIND AUTH Default Server Template","dns_options_template_name": "BIND AUTH Default Template", "nsm_template":"test_template_1", "v4_ipaddress": "10.1.10.190","name": "DEV-DNSROOT-AUTH-004","appliance_group": "","timeZone": "GMT (GMT)","description": "testing QA","organization_name": "Internal","snmpConfig": "{"trapSink1":"10.1.10.191","trapSink2":"10.1.10.192","communityString":"sph1nkx5","systemContact":"","systemName":"DEV-DNSROOT-AUTH-004.plab.tcpwave.com","processes":"ntpd-1/dns-1/sshd-1/monit-1/syslogng-1/dhcpd-1"}","monitoringService": "yes","banner": "Testing 12345678","tacacsConfig": "0-@-10.1.10.1/10.1.10.2/10.1.10.3/10.1.10.4|abc123","ntpConfig": "10.1.10.193/10.1.10.194/10.1.10.195/10.1.10.196", "syslogConfig":"[{"action":"/var/log/messages","active":"yes","selector":".info;mail.none;authpriv.none;cron.none","type":"File"},{"action":"/var/log/secure","active":"yes","selector":"authpriv.","type":"File"},{"action":"-/var/log/maillog","active":"yes","selector":"mail.","type":"File"},{"action":"/var/log/cron","active":"yes","selector":"cron.","type":"File"},{"action":":omusrmsg:*","active":"yes","selector":".emerg","type":"DefaultType"},{"action":"/var/log/spooler","active":"yes","selector":"uucp,news.crit","type":"File"},{"action":"/var/log/boot.log","active":"yes","selector":"local7.","type":"File"},{"action":"/var/log/test","active":"yes","selector":"auth,authpriv.debug;","type":"File"}]","mgmtIP":"10.1.10.197","dns64List": [],"idracSnmpCommunity": "no-@--@--@-","resolverData": "{"ns1":"10.1.10.198","ns2":"","ns3":"","ns4":"","search1":"","search2":"","search3":"","search4":"","search5":"","search6":""}","old_address": "10.1.10.199","domain_name": "plab.tcpwave.com"}

Parameters
Type Name Description Schema Default

Body

body
required

DNS appliance details

Server Information

Responses
HTTP Code Description Schema

500

TIMS-3030: Both object id and IP Address cannot be null
TIMS-3031: Object is not deleted as it is associated with a zone
TIMS-3038: Appliance Type is not valid:{0}
TIMS-3033: An Appliance already exists with the specified address
TIMS-3034: Both DNS Appliance Template name and id cannot be null
TIMS-3035: Specified DNS Appliance Template not found
TIMS-3036: Both DNS Options Template name and id cannot be null
TIMS-3037: Specified DNS Options Template not found
TIMS-3039: Cannot create an Appliance using a DHCP object
TIMS-10102: Both view id and view name cannot be null
TIMS-10103: DNS View does not exist for name
TIMS-5033: Appliance Template does not exist
TIMS-3050: Both Appliance id and address cannot be null
TIMS-3091: Appliance does not exist
TIMS-1336: DNS Appliance cannot be changed to Internal DNS Cache Appliance as there is no root zone defined in this organization
TIMS-5009: Option Template does not exist
TIMS-3079: Both DNS Options Template name and id cannot be null
TIMS-3009: Object does not exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.40.9. Form a cluster with 2 remote appliances

POST /dnsserver/formCluster
Parameters
Type Name Description Schema Default

Body

body
required

Remote Cluster details

Remote Cluster Server Information

Responses
HTTP Code Description Schema

500

TIMS-3009: Object does not exist.
TIMS-3033: An Appliance already exists with the : {0}

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.40.10. Add Forwarders

POST /dnsserver/forwarders/add
Description

Adds a new DNS forwarder that is used to resolve DNS zones that are not managed by the TCPWave IPAM. For additional information about the cache only DNS Appliances and the configuration of the forwarders, please refer to the product documentation.
Sample payload with mandatory parameters to add DNS Forwarder is listed below.
[{"zoneName":"myzone1.com","forward":"only","forwardersIPv4":"10.1.0.1","forwardersIPv6":"2000::","serverType":"BIND CACHE","serverV4Addr":"10.1.10.2"}]

Parameters
Type Name Description Schema Default

Body

body
required

List of forwarders details

< Appliance Forwarder > array

Responses
HTTP Code Description Schema

500

TIMS-1425: Both Appliance id and Appliance IP address cannot be null
TIMS-1426:DNS Internal Cache Appliance does not exist
TIMS-1427: Forward only zone: {0} already exists in the DNS Appliance
TIMS-1429: Cannot create a forward only zone: {0} as it is already managed by IPAM.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.40.11. Delete Forwarders

POST /dnsserver/forwarders/delete
Description

Deletes a DNS forwarder that is used to resolve DNS zones that are not managed by the TCPWave IPAM. For additional information about the cache only DNS Appliances and the configuration of the forwarders, please refer to the product documentation.
The example listed below shows a sample request URL:
/rest/dnsforwarders/forwarders/delete?category_name=dnsforwarder

Parameters
Type Name Description Schema Default

Body

body
required

List of forwarders details

< Appliance Forwarder > array

Responses
HTTP Code Description Schema

500

TIMS-1425: Both Appliance id and Appliance IP address cannot be null
TIMS-1426:DNS Internal Cache Appliance does not exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.40.12. Forwarders List

GET /dnsserver/forwarders/list
Description

Obtains a list of forwarding DNS Appliance addresses defined in the cache only DNS Appliance properties. For additional information about the cache only DNS Appliances and the configuration of the forwarders, please refer to the product documentation.
The example listed below shows a sample request URL:
/rest/dnsserver/forwarders/list?address=10.0.0.8

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Query

id
optional

Appliance Id

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< Appliance Forwarder > array

500

TIMS-1425: Both Appliance id and Appliance IP address cannot be null
TIMS-1426: DNS Internal Cache Appliance does not exist.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.40.13. Update Forwarders

POST /dnsserver/forwarders/update
Description

Updates the DNS forwarder that is used to resolve DNS zones that are not managed by the TCPWave IPAM. For additional information about the cache only DNS Appliances and the configuration of the forwarders, please refer to the product documentation.
Below example shows sample request JSON:
{"name":"dnsforwarder","addedForwarders":[{"zoneName":"zone.com","forward":"only","forwardersIPv4":"10.0.0.3","forwardersIPv6":"1000::","isPresent":true}],"deletedForwarders":[{"zoneName":"zone.com","forward":"only","forwardersIPv4":"10.0.0.0","forwardersIPv6":"1000::","isPresent":true}]}

Parameters
Type Name Description Schema Default

Body

body
required

List of forwarders details

< Appliance Forwarder > array

Responses
HTTP Code Description Schema

500

TIMS-1425: Both Appliance id and Appliance IP address cannot be null
TIMS-1426:DNS Internal Cache Appliance does not exist
TIMS-1428: Forward only zone: {given forwarders} does not exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.40.14. Generate Configuration

GET /dnsserver/genconfig
Description

From the data repository, a list of configuration files is generated and various data integrity checks are done. The files are securely transferred to the remote. Compression is used during the final transfer. On the remote, the compressed configuration files expanded and put into appropriate places and the service is refreshed or restarted depending on the global option defined for file synchronization.
The example listed below shows a sample request URL:
/rest/dnsserver/genconfig?server_type_code=BIND AUTH&address=10.0.0.2&organization_name=orgNameValue

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Query

force_sync
optional

Force Sync Appliance

string

Query

organization_name
required

Organization Name

string

Query

server_type_code
required

DNS Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1349: DNS Configuration sync failed with error
TIMS-9212: A sync is currently in progress initiated by {0} from {1}. Please wait until it is completed
TIMS-9213: A download config is currently in progress initiated by {0} from {1}. Please wait until it is completed.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.40.15. DNS Appliance Details

GET /dnsserver/get
Description

Get DNS Appliance Detail. Functional Admin gets the list of all Appliances. Rest of the Admins get only the list of Appliances associated with the organization that they belong to.Functional Admin gets the list of all Appliances. Rest of the Admins get only the list of Appliances associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/dnsserver/get?serverTypeCode=BIND AUTH&serverIp=10.0.0.8

Parameters
Type Name Description Schema Default

Query

serverIp
required

Appliance IP Address

string

Query

serverTypeCode
optional

Appliance Type Code

string

Responses
HTTP Code Description Schema

200

successful operation

Server Information

500

TIMS-3050: Both Appliance id and address cannot be null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.40.16. Dnstap Logs

GET /dnsserver/getDnstapLogs
Description

Obtains a list of dnstap logs in the IPAM.
The example listed below shows a sample request URL:
/rest/dnsserver/getDnstapLogs?ip=10.1.10.191&type=BIND CACHE

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

ip
optional

Appliance IP Address

string

Query

name
optional

Appliance name

string

Query

type
optional

Appliance type

string

Responses
HTTP Code Description Schema

200

successful operation

< DnstapLogs > array

500

TIMS-7003: You are not authorized to perform this operation.
TIMS-15006: Both appliance IP and name cannot be null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.40.17. Get Pending External DDNS Updates Count

GET /dnsserver/getPendingExternalUpdatesCount
Description

Gets the pending external DDNS updates count on the given TCPWave DNS appliance.
The example listed below shows a sample request URL:
/rest/dnsserver/getPendingExternalUpdatesCount?ip_address=10.1.10.191

Parameters
Type Name Description Schema Default

Query

ip_address
required

Appliance IP address

string

Responses
HTTP Code Description Schema

200

successful operation

integer(int32)

500

TIMS-7003: You are not authorized to perform this operation.
TIMS-15006: Both appliance IP and name cannot be null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.40.18. Appliance Heartbeat Check

GET /dnsserver/heartbeat
Description

Checks the heartbeat for the specified Appliance. Performs a check if the remote DNS Appliance is having a heartbeat communication with the management Appliance.
The example listed below shows a sample request URL:
/rest/dnsserver/heartbeat?server_ip=10.0.0.8&server_type=dnsServer

Parameters
Type Name Description Schema Default

Query

server_ip
required

Appliance IP Address

string

Query

server_type
required

Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3088: Appliance IP address is null
TIMS-8230: Appliance type is null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.40.19. DNS Cache Appliance List

GET /dnsserver/internal_cache_list
Description

Obtains a list of all the DNS Cache and DNS Auth (recursion enabled only) Appliances defined in the TCPWave IPAM for a given Organization.
The example listed below shows a sample request URL:
/rest/dnsserver/internal_cache_list?orgName=orgNameValue

Parameters
Type Name Description Schema Default

Query

orgName
required

Organization name

string

Responses
HTTP Code Description Schema

200

successful operation

< Server Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.40.20. DNS Appliance List

GET /dnsserver/list
Description

Obtains a list of all the DNS Appliances defined in the TCPWave IPAM. Functional Admin gets the list of all Appliances. Rest of the Admins get only the list of Appliances associated with the organization that they belong to.
The example listed below shows a sample request URL:
rest/dnsserver/list?organizations=orgNameValue

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization List

string

Responses
HTTP Code Description Schema

200

successful operation

< Server Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.40.21. DNS Appliance List

GET /dnsserver/page
Description

Obtains a list of all the DNS Appliances defined in the TCPWave IPAM. Functional Admin gets the list of all Appliances. Rest of the Admins get only the list of Appliances associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/dnsserver/page/?draw=1&start=0&length=20&sort=name&order=asc&filterRules=[]

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

customFilterRules
optional

Custom Filter String

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organization Names

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting DNS Appliance Range

integer(int32)

Responses
HTTP Code Description Schema

200

Success

Server Information

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.40.22. DNS Configuration Update

GET /dnsserver/reconfig
Description

Updates the DNS configuration on the specified remote.
The example listed below shows a sample request URL:
/rest/dnsserver/reconfig?server_type_code=BIND AUTH&address=10.0.0.2&organization_name=orgNameValue

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Query

organization_name
required

Organization Name

string

Query

server_type_code
required

DNS Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1349: DNS Configuration sync failed with error
TIMS-9212: A sync is currently in progress initiated by {0} from {1}. Please wait until it is completed
TIMS-9215: A DNS config update is currently in progress initiated by {0} from {1}. Please wait until it is completed.
TIMS-9213: A download config is currently in progress initiated by {0} from {1}. Please wait until it is completed.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.40.23. Reset remote cluster

POST /dnsserver/resetCluster
Parameters
Type Name Description Schema Default

Body

body
required

Remote Cluster IP

string

Responses
HTTP Code Description Schema

500

TIMS-3009: Object does not exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.40.24. Appliance Configuration

GET /dnsserver/server-configuration/{server_address}/{server_type}
Description

Lists the configuration type and configuration data for an specified appliance in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/dnsserver/server-configuration/10.0.0.3/BIND AUTH/BIND CACHE/UNBOUND/NSD/DNS PROXY

Parameters
Type Name Description Schema Default

Path

server_address
required

Appliance IP Address

string

Path

server_type
required

Appliance Type Code

string

Responses
HTTP Code Description Schema

200

successful operation

Server Information

500

TIMS-3038: Appliance Type is not valid:<Appliance Type Code>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.40.25. Appliance References in Zone Template

GET /dnsserver/server-references
Description

Obtains the list of all the zone templates which are associated with the specified DNS Appliance. For additional information about the DNS zone templates, please refer to the product documentation.
The example listed below shows a sample request URL:
/rest/dnsserver/server-references?address=10.0.0.8

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Query

id
optional

Appliance Id

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3050: Both Appliance id and address cannot be null.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.40.26. Appliance Command

GET /dnsserver/subsys
Description

Executes a remote DNS Appliance process controlling command that is audited and can only be invoked by the management system.
The example listed below shows a sample request URL:
/rest/dnsserver/subsys?server_name=TCPWave00001Remote&server_ip=10.0.0.8&level=&argc=12&argv=

Parameters
Type Name Description Schema Default

Query

argc
required

argc

integer(int32)

Query

argv
required

argv

string

Query

level
required

Level Number

integer(int32)

Query

server_ip
required

Appliance IP Address

string

Query

server_name
required

Appliance Name

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1369: Request timed out from DNS Appliance.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.40.27. Synchronize DNS Appliances

POST /dnsserver/syncAll
Description

From the data repository a list of configuration files are generated and various data integrity checks are done. The files are securely transferred to the remote. Compression is used during the final transfer. On the remote, the compressed configuration files expanded and put into appropriate places and the service is refreshed or restarted depending on the global option defined for file synchronization.
Below example shows sample request JSON:
[{"name":"DEV-CDNS-EXT-001","organization_name":"Internal","v4_address":"10.1.10.183","server_type":"BIND AUTH"},{"name":"DEV-CDNS-INT-001","organization_name":"Internal","v4_address":"10.1.10.185","server_type":"BIND CACHE"},{"name":"DEV-CDNS-INT-EXTFW-002","organization_name":"Internal","v4_address":"10.1.10.186","server_type":"BIND CACHE"},{"name":"DEV-CDNS-XDHCP-001","organization_name":"Internal","v4_address":"10.1.10.191","server_type":"BIND AUTH"},{"name":"DEV-DNS-PROXY-001","organization_name":"Internal","v4_address":"10.1.10.182","server_type":"DNS PROXY"},{"name":"nusgtdc-qrs01-sl0984","organization_name":"Internal","v4_address":"10.171.98.71","server_type":"BIND AUTH"},{"name":"nusruth-qrs01-sl0984","organization_name":"EARTH","v4_address":"10.193.1.50","server_type":"BIND AUTH"},{"name":"nusswdc-cxsqrs01-sl0984","organization_name":"Internal","v4_address":"10.189.0.3","server_type":"BIND AUTH"}]

Parameters
Type Name Description Schema Default

Query

fasterSync
optional

boolean

Body

body
optional

< Server Basic Information > array

Responses
HTTP Code Description Schema

500

TIMS-1349: DNS Configuration sync failed with error

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.40.28. Form a cluster with 2 remote appliances

POST /dnsserver/updateCluster
Parameters
Type Name Description Schema Default

Body

body
required

Remote Cluster details

Remote Cluster Server Information

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.40.29. View Configuration of DNS Appliance

GET /dnsserver/viewconfig
Description

View the configuration file for the specified DNS Appliance in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/dnsserver/viewconfig?server_type_code=BIND AUTH&address=10.0.0.2&organizationName=orgNameValue

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Query

organizationName
required

Appliance Organization name

string

Query

server_type_code
required

DNS Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1349: DNS Configuration sync failed with error

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.40.30. DNS Appliance Zone List

GET /dnsserver/zonelist
Description

Obtains a list of DNS zones that are actively being serviced on a given DNS Appliance. This list includes forward zones and reverse zones.
The example listed below shows a sample request URL:
/rest/dnsserver/zonelist?name=TCPWave00005Remote&revZone=0/1

Parameters
Type Name Description Schema Default

Query

allZones
optional

Both forward and reverse zones

boolean

Query

id
optional

Appliance Id

integer(int32)

Query

name
required

Appliance Name

string

Query

revZone
optional

If Reverse Zone

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< ServerZone > array

500

TIMS-3090: Both Appliance id and name cannot be null, TIMS-3092: Appliance does not exist.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.41. DNS Appliance Template Service

Description

This service provides API's to get list of DNS Appliance Templates present in the TCPWave IPAM, add DNS Appliance Templates , update DNS Appliance Templates, delete DNS Appliance Templates, search for a DNS Appliance Template in the TCPWave IPAM.

4.41.1. DNS Appliance Template Add

POST /dnsserver_template/add
Description

Creates a new DNS appliance template by checking if it overlaps with the existing DNS appliance template defined in the TCPWave IPAM. Functional Admin can create a new Appliance Template for any organization. Rest of the admins can create a new appliance template only for the organizations that they are associated with. Refer to the Administrator reference documentation for additional information about the DNS appliance template.
Below example shows sample request JSON:
{"server_type_code":"BIND AUTH","name":"temp-11","email_id":"{"code":"HMAC-SHA1","bitSize":"8","dnssec":false,"mandatory":false,"min":1,"max":160},"loggers":[{"category":{"category":"client","description":"Processing["admin@gmail.com","enable_dynamic_updates":true,"description":"test","algos":[{"code":"HMAC-SHA1","bitSize":"8","dnssec":false,"mandatory":false,"min":1,"max":160}],"loggers":[{"category":{"category":"client","description":"Processing"] of client requests."},"channels":[{"channel":"default_syslog","type":1,"type_string":"SYSLOG","versions":0,"size":0,"severity":0,"print_time":false,"print_severity":false,"print_category":false,"special_channel":true,"debug_level":0}]}],"enable_dnssec":true}

Parameters
Type Name Description Schema Default

Body

body
optional

DNS Appliance Template

Responses
HTTP Code Description Schema

500

TIMS-3026: A template with the specified name already exists, TIMS-3020: Both Appliance type and id cannot be null, TIMS-5029: Template name is not specified, TIMS-3038: Appliance Type is not valid: <Appliance type code>, TIMS-2003: ACLs are not valid, TIMS-2010: Algorithm is not valid: <Algorithm Code>, TIMS-3022: Bit size should be between <Min Algo code> and <Max Algo code> for algorithm <Algorithm code>, TIMS-3023: Logger is not valid.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.41.2. DNS Appliance Template Edit

POST /dnsserver_template/edit
Description

Updates an existing appliance template in the TCPWave IPAM. Functional Admin can update an appliance template for any organization. Rest of the admins can update an appliance template only for the organizations that they are associated with.
Below example shows sample request JSON:
{"server_type_code":"BIND CACHE","name":"temp-1","email_id":""admin@gmail.com","enable_dynamic_updates":false,"description":"testing","new_name":"temp-1133","algos":[],"loggers":[{"category":{"category":"database","description":"Messages" relating to the databases used internally by the name server to store zone and cache data."},"channels":[{"channel":"default_debug","type":0,"type_string":"FILE","versions":0,"size":0,"severity":0,"print_time":false,"print_severity":false,"print_category":false,"special_channel":true,"debug_level":0}]}],"enable_dnssec":true}

Parameters
Type Name Description Schema Default

Body

body
optional

DNS Appliance Template

Responses
HTTP Code Description Schema

500

TIMS-5020: Template does not exist:<Template Name>, TIMS-5031: Both template name and id cannot be null, TIMS-5028: Template does not exist, TIMS-3020: Both Appliance type and id cannot be null, TIMS-3026: A template with the specified name already exists, TIMS-3038: Appliance Type is not valid: <Appliance Type Code>, TIMS-2003: ACLs are not valid, TIMS-2010: Algorithm is not valid: <Algorithm Code>, TIMS-3022: Bit size should be between <Min Algo code> and <Max Algo code> for algorithm <Algorithm code>, TIMS-3023: Logger is not valid.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.41.3. DNS Appliance Template Details

GET /dnsserver_template/get
Description

Lists all the Appliance Templates associated with an organization in the TCPWave IPAM. Functional Admin can list the Appliance Templates for any organization. Rest of the admins can list the Appliance Templates only for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/dnsserver_template/get?name=NSD Default Server Template

Parameters
Type Name Description Schema Default

Query

id
optional

Template Id

integer(int32)

Query

name
required

Template Name

string

Responses
HTTP Code Description Schema

200

successful operation

DNS Appliance Template

500

TIMS-5020: Template does not exist:<Template Name>, TIMS-5031: Both template name and id cannot be null.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.41.4. DNS Appliance Template List

GET /dnsserver_template/list
Description

Lists all the Appliance templates defined in the TCPWave IPAM. These are used to create a DNS Appliance in the TCPWave IPAM.Functional Admin gets the list of all Appliance templates. Rest of the Admins get only the list of Appliance templates associated with the organization that they belong to.
The example listed below shows a sample request URL:
/tims/rest/dnsserver_template/list/server_type_code=serverTypeCodeValue

Parameters
Type Name Description Schema Default

Query

server_type_code
required

Appliance Type Code

string

Query

server_type_id
optional

Appliance Type Id

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< DNS Appliance Template > array

500

TIMS-3038: Appliance Type is not valid: <Appliance Type Code>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.41.5. Appliance Template References

GET /dnsserver_template/references
Description

Obtains a list of DNS Appliances that have references to the DNS Appliance Templates for which DNS Appliances associations have been defined.
The example listed below shows a sample request URL:
/rest/dnsserver_template/references?tables=tableName

Parameters
Type Name Description Schema Default

Query

count
optional

Count Flag

string

Query

id
optional

Appliance Id

string

Query

page
optional

Page Number

integer(int32)

Query

rows
optional

Number of Rows

integer(int32)

Query

tables
required

Tables

string

Responses
HTTP Code Description Schema

200

successful operation

Reference Results

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.41.6. Appliance Template Search

GET /dnsserver_template/search
Description

Provides the list of searched Appliance Templates on search screen in the TCPWave IPAM. Functional Admin gets the list of searched Appliance Templates for any organization. Rest of the Admins gets only the list of searched Appliance Templates associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/dnsserver_template/search?page=1&rows=20

Parameters
Type Name Description Schema Default

Query

page
optional

Page Number

integer(int32)

Query

rows
optional

Number of Rows

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListDNS Appliance Template

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.42. DNS Defaults Service

Description

This service provides API's to get and update DNS defaults in the TCPWave IPAM.

4.42.1. Get Global DNS Elevated Privileges

GET /DNSDefaults/get
Description

Provides the details of Global DNS Elevated Privileges

Responses
HTTP Code Description Schema

200

successful operation

DNSApplianceDefaults

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.42.2. Get Global DNS Syslog-ng Configuration

GET /DNSDefaults/getSyslogngConfig
Description

Provides the details of Global DNS Syslog-ng Configuration

Responses
HTTP Code Description Schema

200

successful operation

DNSApplianceDefaults

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.42.3. Get Global DNS TACACS+ Configuration

GET /DNSDefaults/getTacacsConfig
Description

Provides the details of Global DNS TACACS+ Configuration

Responses
HTTP Code Description Schema

200

successful operation

DNSApplianceDefaults

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.43. DNS External Root Hints Service

Description

This service provides API's to get list of DNS External Root Hints present in the TCPWave IPAM, add DNS External Root Hints , update DNS External Root Hints, delete DNS External Root Hints, search for a DNS External Root Hints in the TCPWave IPAM.

4.43.1. Add DNS External Root Hint

POST /externalRootHints/add
Description

Adds a new DNS External Root Hint to appliance template that is used to resolve DNS zones that are not managed by the TCPWave IPAM. For additional information about the DNS External Root Hints, please refer to the product documentation.
Below example shows sample request JSON:
{"ns_fqdn":"ns1.tcpwave.com.","ns_ipv4Address":"10.1.10.10","ttl":1200,"appliance_template_id":3,"appliance_template_name":"ApplianceTemplate1"}

Parameters
Type Name Description Schema Default

Body

body
optional

DNS External Root Hints

Responses
HTTP Code Description Schema

500

TIMS-1547: DNS External Root Hint: {0} with IP: {1} already exists in the specified DNS appliance template.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.43.2. DNS External Root Hints List

GET /externalRootHints/getExternalRootHints
Description

Obtains a list of DNS External Root Hints defined in the given appliance template.
The example listed below shows a sample request URL:
rest/externalRootHints/getExternalRootHints?appliance_template_name=ApplianceTemplate1

Parameters
Type Name Description Schema Default

Query

appliance_template_id
optional

Appliance Template Id

integer(int32)

Query

appliance_template_name
required

Appliance Template Name

string

Responses
HTTP Code Description Schema

200

successful operation

< DNS External Root Hints > array

500

TIMS-5031: Both template name and id cannot be null., TIMS-5020: Template does not exist: {0}

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.43.3. Delete External Root Hints

POST /externalRootHints/multiDelete
Description

Deletes a DNS External Root Hints that are used to resolve DNS zones that are not managed by the TCPWave IPAM. For additional information about the cache only DNS External Root Hints, please refer to the product documentation.
Below example shows sample request JSON:
[{"ns_fqdn":"ns1.tcpwave.com.","ns_ipv4Address":"10.1.10.10","ttl":1200,"appliance_template_id":3,"appliance_template_name":"ApplianceTemplate1"},{"ns_fqdn":"ns2.tcpwave.com.","ns_ipv4Address":"10.1.10.20","ttl":1200,"appliance_template_id":3,"appliance_template_name":"ApplianceTemplate1"}]

Parameters
Type Name Description Schema Default

Body

body
optional

< DNS External Root Hints > array

Responses
HTTP Code Description Schema

500

TIMS-5031: Both template name and id cannot be null., TIMS-5020: Template does not exist: {0}, TIMS-1548: DNS External Root Hint: {0} with IP: {1} does not exist in the specified DNS appliance template.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.43.4. Sync DNS Internal Caches with DNS External Root Hints

GET /externalRootHints/syncAppliances
Description

Does the full sync on all the internal cache appliances with external root hints.
The example listed below shows a sample request URL:
rest/externalRootHints/syncAppliances?appliance_template_name=ApplianceTemplate1

Parameters
Type Name Description Schema Default

Query

appliance_template_id
optional

Appliance Template Id

integer(int32)

Query

appliance_template_name
required

Appliance Template Name

string

Responses
HTTP Code Description Schema

500

TIMS-5031: Both template name and id cannot be null., TIMS-5020: Template does not exist: {0}

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.43.5. Update DNS External Root Hint

POST /externalRootHints/update
Description

Updates the existing DNS External Root Hint that is used to resolve DNS zones that are not managed by the TCPWave IPAM. For additional information about the DNS External Root Hints, please refer to the product documentation.
Below example shows sample request JSON:
{"ns_fqdn":"ns1.tcpwave.com.","ns_ipv4Address":"10.1.10.10","ttl":1200,"appliance_template_id":3,"appliance_template_name":"ApplianceTemplate1"}

Parameters
Type Name Description Schema Default

Body

body
optional

DNS External Root Hints

Responses
HTTP Code Description Schema

500

TIMS-1548: DNS External Root Hint: {0} with IP: {1} does not exist in the specified DNS appliance template.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.44. DNS Forwarders Service

Description

This service provides API's to get list of DNS Forwarders present in the TCPWave IPAM.

4.44.1. Add Forwarders

POST /forwarders/dnsforwarders/add
Description

Adds a new DNS forwarder that is used to resolve DNS zones that are not managed by the TCPWave IPAM. For additional information about the cache only DNS Appliances and the configuration of the forwarders, please refer to the product documentation.
Below example shows sample request JSON:
[{"zoneName":"myzone1.com","forward":"only","forwardersIPv4":"10.11.0.1","forwardersIPv6":"2000::","description":"testing qa","serverType":"BIND CACHE","serverV4Addr":"10.11.0.2"}]

Parameters
Type Name Description Schema Default

Body

body
optional

DNSForwardersList

Responses
HTTP Code Description Schema

500

TIMS-1427: Forward only zone: <Zone Name> already exists in the DNS Appliance, TIMS-1429: Cannot create a forward only zone: <Zone Name> as it is already managed by IPAM.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.44.2. Forwarders List

GET /forwarders/dnsforwarders/associateForwarders
Description

Obtains a list of Servers associated for the DNS Forwarder, please refer to the product documentation.
The example listed below shows a sample request URL:
/rest/forwarders/dnsforwarders/associateForwarders?category_Id=1

Parameters
Type Name Description Schema Default

Query

category_Id
optional

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< AssociativeServersForForwarders > array

500

TIMS-1425: Both Appliance id and Appliance IP address cannot be null, TIMS-1426: DNS Internal Cache Appliance does not exist.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.44.3. Delete Forwarders Category

GET /forwarders/dnsforwarders/delete
Description

Deletes a DNS forwarder that is used to resolve DNS zones that are not managed by the TCPWave IPAM. For additional information about the cache only DNS Appliances and the configuration of the forwarders, please refer to the product documentation.
Below example shows sample request JSON:
"/rest/forwarders/dnsforwarders/delete?category_name=categoryNameValue"[{"category_name":"google","testing qa",}]

Parameters
Type Name Description Schema Default

Query

category_Id
optional

integer(int32)

Query

category_name
required

Forwarder category name

string

Responses
HTTP Code Description Schema

500

TIMS-1425: Both Appliance id and Appliance IP address cannot be null, TIMS-1426:DNS Internal Cache Appliance does not exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.44.4. Forwarders List

GET /forwarders/dnsforwarders/list
Description

Obtains a list of forwarding DNS Appliance addresses defined in the cache only DNS Appliance properties. For additional information about the cache only DNS Appliances and the configuration of the forwarders, please refer to the product documentation.
The example listed below shows a sample request URL:
/rest/forwarders/dnsforwarders/list?category_Id=1

Parameters
Type Name Description Schema Default

Query

category_Id
optional

Forwarder category id

integer(int32)

Query

category_name
required

Forwarder category name

string

Responses
HTTP Code Description Schema

200

successful operation

DNSForwardersList

500

TIMS-1425: Both Appliance id and Appliance IP address cannot be null, TIMS-1426: DNS Internal Cache Appliance does not exist.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.44.5. Forwarders List

GET /forwarders/dnsforwarders/majorlist
Description

Obtains a list of forwarding DNS Appliance addresses defined in the cache only DNS Appliance properties. For additional information about the cache only DNS Appliances and the configuration of the forwarders, please refer to the product documentation.
The example listed below shows a sample request URL:
rest/forwarders/dnsforwarders/majorlist

Responses
HTTP Code Description Schema

200

successful operation

< ForwardersCategory > array

500

TIMS-1425: Both Appliance id and Appliance IP address cannot be null, TIMS-1426: DNS Internal Cache Appliance does not exist.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.44.6. DNS Forwarders Search

GET /forwarders/dnsforwarders/search
Description

Searches for a given DNS Forwarders in the TCPWave IPAM with giving input string.
The example listed below shows a sample request URL:
/rest/forwarders/dnsforwarders/search?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Template Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListForwardersCategory

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.44.7. Update Forwarders

POST /forwarders/dnsforwarders/update
Description

Updates the existing DNS forwarder that is used to resolve DNS zones that are not managed by the TCPWave IPAM. For additional information about the cache only DNS Appliances and the configuration of the forwarders, please refer to the product documentation.
Below example shows sample request JSON:
/rest/forwarders/dnsforwarders/update?category_Id=1

Parameters
Type Name Description Schema Default

Query

category_Id
optional

Forwarder category id

integer(int32)

Query

category_name
required

Forwarder category name

string

Body

body
optional

DNSForwardersList

Responses
HTTP Code Description Schema

500

TIMS-1427: Forward only zone: <Zone Name> already exists in the DNS Appliance, TIMS-1429: Cannot create a forward only zone: <Zone Name> as it is already managed by IPAM.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.45. DNS TSIG (Transaction Signatures) Keys Service

4.45.1. TSIG Key Create

POST /tsigkeys/create
Description

Creates a new TSIG Key in the TCPWave IPAM. This list is used to control the behavior of DNS when applied to the Allow-Notify, Allow-Transfer etc.
Sample payload with mandatory parameters to add a TSIG Key is listed below.
{"name":"key1", "algoName":"HMAC-SHA512", "secretKey":"wTrdaq6SHatfVkfYQ7sQ33dD/xVDURiF6eSBmBufGrmcr9arTy6RfMatCpI481hLaebqgq4mrzUKMF55B1gv/Q=="}

Parameters
Type Name Description Schema Default

Body

body
required

TSIG Key details

DNS TSIG (Transaction Signatures) Keys

Responses
HTTP Code Description Schema

500

TIMS-2117: TSIG key name cannot be null., TIMS-2118: TSIG key algorithm cannot be null., TIMS-2119: TSIG key name already exists: <keyname>., TIMS-2120: TSIG key algorithm does not exist: <algo name>.

No Content

Consumes
  • application/json

  • application/xml

4.45.2. TSIG Key Details

GET /tsigkeys/get
Description

Provides the values of TSIG Key in the TCPWave IPAM which are used to control the behavior of DNS when applied to the Allow-Notify, Allow-Transfer etc.
The example listed below shows a sample request URL:
/rest/tsigkeys/get?name=key1

Parameters
Type Name Description Schema Default

Query

name
required

TSIG Key Name

string

Responses
HTTP Code Description Schema

200

successful operation

DNS TSIG (Transaction Signatures) Keys

500

TIMS-2123: TSIG key(s) not found, TIMS-2121: TSIG key name does not exist: <keyname>.

No Content

Produces
  • application/json

  • application/xml

4.45.3. TSIG Key References

GET /tsigkeys/getreferences
Description

Provides the list references of TSIG Keys in DNS ACLs in the TCPWave IPAM which use specified TSIG Key
The example listed below shows a sample request URL:
/tims/rest/tsigkeys/getreferences?name=key1

Parameters
Type Name Description Schema Default

Query

name
required

TSIG Key Name

string

Responses
HTTP Code Description Schema

200

successful operation

< string, < string > array > map

500

TIMS-2126: TSIG Key Reference(s) not found.

No Content

Produces
  • application/json

  • application/xml

4.45.4. TSIG Keys List

GET /tsigkeys/list
Description

Obtains the list of TSIG Keys defined and managed by the TCPWave IPAM which are used to control the behavior of DNS when applied to the Allow-Notify, Allow-Transfer etc.
The example listed below shows a sample request URL:
/rest/tsigkeys/list

Responses
HTTP Code Description Schema

200

successful operation

< DNS TSIG (Transaction Signatures) Keys > array

500

TIMS-2123: TSIG key(s) not found

No Content

Produces
  • application/json

  • application/xml

4.45.5. TSIG Key Delete Multiple

POST /tsigkeys/multidelete
Description

Deletes multiple existing TSIG keys from the TCPWave IPAM data repository. This action is audited.
Below example shows sample request JSON: ["key1", "key2"]

Parameters
Type Name Description Schema Default

Body

body
required

List of TSIG key names

< string > array

Responses
HTTP Code Description Schema

500

TIMS-2122: TSIG keys cannot be deleted as some of the specified keys does not exist in IPAM., TIMS-2125: TSIG Key(s) cannot be delete as there are one or more DNS ACLs are associated with this.

No Content

Consumes
  • application/json

  • application/xml

4.45.6. TSIG Keys Search

GET /tsigkeys/search
Description

Searches for TSIG Keys in the TCPWave IPAM with given input string.
The example listed below shows a sample request URL:
/rest/tsigkeys/search&start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Template Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListDNS TSIG (Transaction Signatures) Keys

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.45.7. TSIG Key Edit

POST /tsigkeys/update
Description

Updates an existing TSIG Key in the TCPWave IPAM.
Below example shows sample request JSON:
{"name":"key1", "newName":"key2", "algoName":"HMAC-SHA512", "secretKey":"wTrdaq6SHatfVkfYQ7sQ33dD/xVDURiF6eSBmBufGrmcr9arTy6RfMatCpI481hLaebqgq4mrzUKMF55B1gv/Q=="}

Parameters
Type Name Description Schema Default

Body

body
required

TSIG Key details

DNS TSIG (Transaction Signatures) Keys

Responses
HTTP Code Description Schema

500

TIMS-2117: TSIG key name cannot be null., TIMS-2118: TSIG key algorithm cannot be null. TIMS-2120: TSIG key algorithm does not exist: <algo name>., TIMS-2121: TSIG key name does not exist: <keyname>.

No Content

Consumes
  • application/json

  • application/xml

4.46. DNS Tools Service

Description

This service provides API's to perform a basic name resolution for a given resource record upon the targeted DNS Server present in the TCPWave IPAM, to synchronize the DNS Server data for a given Server by fetching all the configuration specified from the TCPWave data repository.

4.46.1. Resource Record Converge

POST /dnstools/converge
Description

Resource record look up in remote DNS Appliance.Performs a basic name resolution for a given resource record using the target DNS Appliance on which the check is to be executed in the TCPWave IPAM.Below example shows the sample request JSON:
{"rr_name":"record",
"domain_name":"domain.com",
"rr_type":"A"
"organization_name":"Org"
}

Parameters
Type Name Description Schema Default

Body

body
required

DNS tool details

DNS Appliance Tool

Responses
HTTP Code Description Schema

200

successful operation

< DNS Appliance Tool > array

500

TIMS-1020: Both Organization name and id cannot be null
TIMS-1352: Organization does not exist:{0}
TIMS-1422: TIMS-1422: Zone does not exist:{0}
TIMS-12062: Given IP address is not found in the network range for the selected reverse zone.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.46.2. IDN Converter

POST /dnstools/idnconverter
Description

Converts either from IDN to Punycode or from Punycode to IDN.
Below example shows the sample request:
{toIDN:true,
name:domain.com
}

Parameters
Type Name Description Schema Default

Body

body
required

IDN details

Idn

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

4.46.3. Resource Record Sync

POST /dnstools/sync
Description

Synchronize the Resource Record of IPAM with DNS Appliance. Synchronizes the DNS Appliance data for a given Appliance by fetching all the configuration specified from the TCPWave data repository. The DNS Appliance files are constructed as per the TCPWave Product Engineering’s specifications with various integrity checks embedded into them. The files are then compressed and transmitted to the remote using an encrypted T-Message secure tunnel. The compressed files are uncompressed on the remote and the DNS process on the remote is signaled to read the updated contents. The administrator performing this action is required to have a sync permission. This action is audited.
The example listed below shows a sample request URL:
/rest/dnstools/sync?serverip=1.0.0.2&servertype=serverTypeValue&recordname=abc&recordtype=A&domainname=xyz.com

Parameters
Type Name Description Schema Default

Query

domainname
required

Domain Name

string

Query

recordname
required

Record Name

string

Query

recordtype
required

Record Type

string

Query

serverip
required

Appliance IP Address

string

Query

servertype
required

Appliance Type Code

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1455: Given domain is not a valid domain name. Please give a valid domain name
TIMS-1456: Invalid record type specified
TIMS-3204: Invalid resource record specified
TIMS-3050: Both Appliance id and address cannot be null
TIMS-3088: Appliance IP address is null
TIMS-8230: Appliance type is null
TIMS-3050: Both Appliance id and address cannot be null

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.46.4. Resource Record Traverse

POST /dnstools/traverseRR
Description

Resource record look up in remote DNS Server.Performs a basic name resolution for a given resource record using the target DNS server on which the check is to be executed in the TCPWave IPAM.
Below example shows the sample request:
{"rr_name":"aaaaa.m.","domain_name":"aaaaa.m","organization_name":"TcpWave","rr_type":"A","dnssec_enabled":false,"isProxy":0}

Parameters
Type Name Description Schema Default

Body

body
required

DNS tool details

DNS Appliance Tool

Responses
HTTP Code Description Schema

200

successful operation

< DNS Appliance Tool > array

500

TIMS-1020: Both Organization name and id cannot be null
TIMS-1352: Organization does not exist:{0}, TIMS-1422: TIMS-1422: Zone does not exist:{0}

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.47. DNSViz Service

Description

This service provides API's to get the DNSSEC delegation for a given DNSSEC enabled zone on a give DNS cache appliance.

4.47.1. DNSViz as HTML

GET /dnsviz/getDNSVizHTML
Description

This service provides API’s to get the DNSSEC delegation as a HTML string for a given DNSSEC enabled zone on a given DNS cache appliance.
The example listed below shows a sample request URL:
/rest/dnsviz/getDNSVizHTML?zoneName=text.com&orgName=Internal&cacheApplianceIp=1.0.0.3

Parameters
Type Name Description Schema Default

Query

cacheApplianceIp
required

IP address of the cache appliance where DNSSEC validation will be performed.

string

Query

orgName
required

Name of the organization.

string

Query

zoneName
required

DNSSEC enabled zone name.

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1211: Unable to generate DNSViz HTML for a given DNSSEC enabled zone: {0} on a given DNS Cache Appliance: {1}. Please check the IPAM logs or contact the TCPWave Customer Support. TIMS-1213: Unable to generate DNSViz Text for a given DNSSEC enabled zone: {0} on a given DNS Cache Appliance: {1}. Please check the IPAM logs or contact TCPWave Customer Support.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.47.2. DNSViz as PNG

GET /dnsviz/getDNSVizPNG
Description

This service provides API’s to get the DNSSEC delegation as a PNG image for a given DNSSEC enabled zone on a given DNS cache appliance.
The example listed below shows a sample request URL:
/rest/dnsviz/getDNSVizPNG?zoneName=text.com&orgName=Internal&cacheApplianceIp=1.0.0.3

Parameters
Type Name Description Schema Default

Query

cacheApplianceIp
required

IP address of the cache appliance where DNSSEC validation will be performed.

string

Query

orgName
required

Name of the organization.

string

Query

zoneName
required

DNSSEC enabled zone name.

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1212: Unable to generate DNSViz PNG for a given DNSSEC enabled zone: {0} on a given DNS Cache Appliance: {1}. Please check the IPAM logs or contact the TCPWave Customer Support.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.48. Database Service

Description

This service class provides services related to Database such as dump, back-up, snapshot, restore, delete snapshot etc in the TCPWave IPAM. TCPWave IPAM supports storing database backup on AWS-S3 and restoring database from AWS-S3.

4.48.1. Apply Binlog for Database

POST /db/apply-binlog
Description

Loads the database incremental changes into a recovery database in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Body

body
required

Details of database incremental changes

Apply Binlog Request

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.48.2. Apply Snapshot on Database

POST /db/apply-snapshot
Description

Loads a database snapshot into a recovery database in the TCPWave IPAM.
Below example shows sample request JSON:{"databases":"test","snapshotDir":"/tmp/hostName_11.30P7_2020Mar15_1500.bak"}

Parameters
Type Name Description Schema Default

Body

body
optional

Apply DB Snapshot Request

Responses
HTTP Code Description Schema

500

TIMS-9555: Error occurred while making tar.gz file of database snapshots.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.48.3. Backup Binlog for Database

POST /db/backup-binlog
Description

Performs a backup of the incremental changes in the TCPWave IPAM.

Responses
HTTP Code Description Schema

default

successful operation

No Content

Produces
  • application/json

  • application/xml

4.48.4. Uploads Backup Database to AWS S3

POST /db/backupdbtoaws
Description

Takes Backup of IPAM Database and Uploads it to AWS S3.

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.48.5. Delete Database Snapshot

POST /db/deletedbsnapshot
Description

Deletes the database snapshot in the TCPWave IPAM. This action is audited.

Parameters
Type Name Description Schema Default

Body

body
required

Database snapshot details

Apply Binlog Request

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.48.6. Export DB Snapshot zip file

GET /db/download
Description

Exports the db snapshot data into a zip file.

Parameters
Type Name Description Schema Default

Query

fileName
required

Zip file name

string

Responses
HTTP Code Description Schema

500

DB Snapshot data cannot be exported.

No Content

Produces
  • application/octet-stream

4.48.7. Downloads AWS S3 File

POST /db/downloadawss3file
Description

Downloads a specified backup file from AWS S3 bucket in the TCPWave IPAM. Bucket name is obtained from the global option of the TCPWave IPAM.
Below example shows sample request JSON:{"bucketName":"test-bucket","fileName":"dbsnapshot_2019_03_13_12_00_00.tar.gz"}

Parameters
Type Name Description Schema Default

Body

body
optional

AWS S3 File

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.48.8. Dump Database

POST /db/dumpdb
Description

Captures a backup database snapshot of the existing data in the TCPWave IPAM . Response contains the directory where the dump snapshot is located.

Responses
HTTP Code Description Schema

200

successful operation

Dump DB Response

500

TIMS-9554: Failed to dump the database.

No Content

Produces
  • application/json

  • application/xml

4.48.9. Export Organization Data

GET /db/dumpexport
Description

Exports the db snapshot data into a zip file.

Parameters
Type Name Description Schema Default

Query

fileName
required

DB Snapshot name

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • text/plain

4.48.10. Lists s3 backup files

GET /db/lists3files
Description

Obtains a list of all uploaded backup files from AWS S3 bucket. Bucket name is obtained from the global option of the TCPWave IPAM.

Responses
HTTP Code Description Schema

200

successful operation

< AWS S3 File > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.48.11. Delete Backup Files

POST /db/multideletes3files
Description

Deletes the specified backup files from AWS S3 bucket.
Below example shows sample request JSON:{"bucketName":"test-bucket","fileName":"dbsnapshot_2019_03_13_12_00_00.tar.gz"}

Parameters
Type Name Description Schema Default

Body

body
optional

< AWS S3 File > array

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.48.12. Restores Database

POST /db/restoredb
Description

Restores the database from a given snapshot in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Body

body
optional

Apply Binlog Request

Responses
HTTP Code Description Schema

500

TIMS-9101: Error while restoring database. Please check the logs for details.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.48.13. Restore Database from an AWS S3 backup file

POST /db/restoredbwithawss3
Description

Restores the database from an AWS S3 backup file downloaded in the TCPWave IPAM.
Below example shows sample request JSON:{"bucketName":"test-bucket","fileName":"dbsnapshot_2019_03_13_12_00_00.tar.gz"}

Parameters
Type Name Description Schema Default

Body

body
optional

AWS S3 File

Responses
HTTP Code Description Schema

500

TIMS-9101: Error while restoring database. Please check the logs for details.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.48.14. Validates DB Snapshot zip file

GET /db/validateDumpFile
Description

Validates the db snapshot zip file.

Parameters
Type Name Description Schema Default

Query

fileName
required

Zip file name

string

Responses
HTTP Code Description Schema

500

DB Snapshot data cannot be exported.

No Content

Produces
  • application/octet-stream

4.49. Device Discovery Details Service

4.49.1. Add Discovery Devices

POST /discovery/device/add
Description

Creates a new discovery device in the TCPWave IPAM. Functional admins can add an device in any organization. Super admins can add device in their own organization only.
Below example shows sample request JSON:
{"ipAddress":"1.0.0.0","deviceName":"Router-name","deviceType":"Router","statusName":"Router-name""vendor":"cisco""platform":"ios""descriptio":"Cisco router"}

Parameters
Type Name Description Schema Default

Body

body
required

Discovered Devices, to be added to IPAM.

Device Details

Responses
HTTP Code Description Schema

500

An Device with the given IP already exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.49.2. Deletes switch results

GET /discovery/device/delete
Description

This service call deletes device information.
Below example shows sample request JSON:
/rest/devicedisco/deleteDevice?ip=1.0.0.0&name=Router-1"

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command Id

string

Query

deviceType
required

Device Type

string

Query

ip
required

Device IP Address

string

Query

name
required

Device Name

string

Responses
HTTP Code Description Schema

500

TIMS-3501: Unable to delete the discovery device.

No Content

Consumes
  • application/json

4.49.3. Device Details

GET /discovery/device/list
Description

Lists all the devices discovered in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/devicedisco/discopage?start=1&length=20

Parameters
Type Name Description Schema Default

Query

cmdId
optional

Command Id

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organizations

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Device Discovery Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListDevice Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.50. Discovery Agent Command Service

4.50.1. Set Accept Status of Discovery Command

POST /discovery_agent_task/accept
Description

This service call takes a list of discovery command Ids and sets the status of each of these to "ACCEPTED". If the update discovery results global flag is set TCPWave IPAM updates the objects in the database with the discovered information. If the object is not already present it is created, otherwise updated in the database.

Parameters
Type Name Description Schema Default

Query

name
required

Page Name

string

Body

body
optional

< string > array

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3501: Unable to retrieve the discovery commands list.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.50.2. Accepts discovery command’s data

POST /discovery_agent_task/acceptCmd
Description

This service call takes a list of discovery command Ids and accepts the command Id’s data. If the update discovery results global flag is set TCPWave IPAM updates the objects in the database with the discovered information. If the object is not already present it is created, otherwise updated in the database.

Parameters
Type Name Description Schema Default

Body

body
optional

< string > array

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3501: Unable to retrieve the discovery commands list.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

4.50.3. Accept Discovery Device

POST /discovery_agent_task/acceptDevice
Description

This rest call takes a list of discovery devices and sets the status of each of these to "ACCEPTED". If the update discovery results global flag is set TCPWave IPAM updates the objects in the database with the discovered information. If the object is not already present it is created, otherwise updated in the database.

Parameters
Type Name Description Schema Default

Query

commandId
required

Command ID

string

Body

body
optional

< Device Details > array

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3501: Unable to retrieve the discovery commands list.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

4.50.4. Accept Firewall Subnet

POST /discovery_agent_task/acceptFirewallSubnet
Description

This rest call takes a list of firewall subnets, command id, device name and IP Address of a device. It sets the status of each of these to "ACCEPTED". If the update discovery results global flag is set TCPWave IPAM updates the objects in the database with the discovered information. If the object is not already present it is created, otherwise updated in the database.

Parameters
Type Name Description Schema Default

Query

commandId
required

Command ID

string

Query

deviceName
required

Device Name

string

Query

ipAddress
required

Device IP

string

Body

body
optional

< Firewall Subnet > array

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3501: Unable to retrieve the discovery commands list.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

4.50.5. Accept Router Subnet

POST /discovery_agent_task/acceptRouterSubnet
Description

This rest call takes a list of router subnets, command id, device name and IP Address of a device. It sets the status of each of these to "ACCEPTED". If the update discovery results global flag is set TCPWave IPAM updates the objects in the database with the discovered information. If the object is not already present it is created, otherwise updated in the database.

Parameters
Type Name Description Schema Default

Query

commandId
required

Command ID

string

Query

deviceName
required

Device Name

string

Query

ipAddress
required

Device IP

string

Body

body
optional

< Router Subnet > array

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3501: Unable to retrieve the discovery commands list.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

4.50.6. Accept Switch VLAN Subnet

POST /discovery_agent_task/acceptSwitchSubnet
Description

This rest call takes a list of switch VLAN subnets, command Id, device name and IP Address of a device. It sets the status of each of these to "ACCEPTED". If the update discovery results global flag is set TCPWave IPAM updates the objects in the database with the discovered information. If the object is not already present it is created, otherwise updated in the database.

Parameters
Type Name Description Schema Default

Query

commandId
required

Command ID

string

Query

deviceName
required

Device Name

string

Query

ipAddress
required

Device IP

string

Body

body
optional

< Vlan Subnet Details > array

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3501: Unable to retrieve the discovery commands list.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

4.50.7. Accept VRF

POST /discovery_agent_task/acceptVrf
Description

This rest call takes a list of VRF, command id, device name and device IP Address. It sets the status of each of these to "ACCEPTED". If the update discovery results global flag is set TCPWave IPAM updates the objects in the database with the discovered information. If the object is not already present it is created, otherwise updated in the database.

Parameters
Type Name Description Schema Default

Query

commandId
required

Command ID

string

Query

deviceName
required

Device Name

string

Query

ipAddress
required

Device IP

string

Body

body
optional

< VRF > array

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3501: Unable to retrieve the discovery commands list.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

4.50.8. Configurations Differences

GET /discovery_agent_task/getConfigDifference
Description

Lists the difference between the two commands configurations presented in the TCPWave IPAM.
Below example shows sample request JSON:
/rest/discovery_agent_task/getConfigDifference?firstCmdId=TDCE_20220106&secondCmdId=TDCE_20220105&applIp=1.0.0.0&applName=TCPWaveAgent

Parameters
Type Name Description Schema Default

Query

applIp
required

Agent IP

string

Query

applName
required

Agent Name

string

Query

firstCmdId
required

First Command Id

string

Query

secondCmdId
required

Second Command Id

string

Responses
HTTP Code Description Schema

200

successful operation

< Device Details > array

500

No Content

Consumes
  • text/plain

  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.50.9. Command Differences

GET /discovery_agent_task/getDifference
Description

Lists the difference between the two commands presented in the TCPWave IPAM.
Below example shows sample request JSON:
/rest/discovery_agent_task/getDifference?firstCmdId=TDCE_20220106&secondCmdId=TDCE_20220105&applIp=1.0.0.0&applName=TCPWaveAgent

Parameters
Type Name Description Schema Default

Query

applIp
required

Agent IP

string

Query

applName
required

Agent Name

string

Query

firstCmdId
required

First Command Id

string

Query

secondCmdId
required

Second Command Id

string

Responses
HTTP Code Description Schema

200

successful operation

< Device Details > array

500

No Content

Consumes
  • text/plain

  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.50.10. Add Discovery Agent Tasks

POST /discovery_agent_task/multiadd
Description

Creates new discovery agent tasks in TCPWave IPAM.
Below example shows sample request JSON:
[{"commandId":"TDCE_20210921162330","applianceIp":"192.168.56.10","status":2,"startTime":"2021-09-21 16:23:30.934","endTime":"2021-09-21 16:23:30.989"}]

Parameters
Type Name Description Schema Default

Query

applianceIp
required

Discovery Appliance IP

string

Body

body
required

Discovery Agent Tasks List

< DiscoveryAgentCommand > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.50.11. Delete Discovery Agent Tasks

POST /discovery_agent_task/multidelete
Description

Deletes new discovery agent tasks from the TCPWave IPAM.
Below example shows sample request JSON:
[{"commandId":"TDCE_20210921162330","commandId":"TDCE_2021092164451"}]

Parameters
Type Name Description Schema Default

Body

body
required

Discovery Agent command id list

< string > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.51. Discovery Agent Service

4.51.1. Router Details

GET /discovery_agent/agentMap
Description

Gets the map details for a switch discovered in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Query

commandId
required

Command ID

string

Query

isNeighbor
required

Neighbour View

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • text/plain

4.51.2. Discovery Map

GET /discovery_agent/agentMap2
Description

Gets the map details for the discovered devices in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Query

agentIp
required

Agent IP

string

Query

commandId
required

Command ID

string

Query

organization
required

Organization

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • text/plain

4.51.3. Get Device Details

GET /discovery_agent/device/get
Description

Get the device details for the selected discovered device in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_agent/device/get?commandId=TDC_20220422121&orgName=Internal&deviceIp=10.1.0.0&deviceType=Router

Parameters
Type Name Description Schema Default

Query

commandId
required

Command ID

string

Query

deviceIp
required

Device IP Address

string

Query

deviceType
required

Device Type

string

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Device Details

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.51.4. Device DIscovery

POST /discovery_agent/discover/device
Description

Discover the device from the discovery agent.
The example listed below shows a sample request URL:
/rest/discover/device?agentIp=10.0.0.0&deviceIp=10.1.0.0&deviceType=Router&isTopology=false

Parameters
Type Name Description Schema Default

Query

agentIp
required

Agent IP

string

Query

deviceIp
required

Device IP Address

string

Query

deviceType
required

Device Name

string

Query

isTopology
required

From Topology

boolean

Body

body
optional

< DiscoveryRouters > array

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

4.51.5. VRF

POST /discovery_agent/discover/subnets
Description

Fetching VRF from the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_agent/vrf/get?id=1245

Parameters
Type Name Description Schema Default

Body

body
optional

< DiscoveryElementDTO > array

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

4.51.6. Element Details

GET /discovery_agent/elementpage
Description

Lists all the elements discovered for the selected switch in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_agent/elementpage?start=1&length=20&firewallIP=20.0.0.3

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command Id

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

firewallIP
required

Switch IPAddress

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Switch Element Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListFirewall Element Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.51.7. Firewall Configurations

GET /discovery_agent/firewall-configurations
Description

Obtains firewall configurations discovered by the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_agent/firewall-configurations?firewallr_ip=1.1.1.0

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command ID

string

Query

firewall_ip
required

Firewall IPAddress

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.51.8. Add Firewalls

POST /discovery_agent/firewall/multiadd
Description

Creates new firewalls in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Body

body
required

Firewalls List

< Firewall > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.51.9. Add Firewall NAT Pool

POST /discovery_agent/firewall/natpool_multiadd
Description

Creates new firewall NAT Pools in TCPWave IPAM.

Parameters
Type Name Description Schema Default

Body

body
required

Firewall NAT Pool List

< Firewall NAT Pool Details > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.51.10. Router Details

GET /discovery_agent/firewalldetails
Description

Gets the Router details for a switch discovered in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_agent/routerdetails?firewall_ip=10.0.0.3

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command ID

string

Query

firewall_ip
required

Firewall IP

string

Responses
HTTP Code Description Schema

200

successful operation

Firewall

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.51.11. Add Firewall Elements

POST /discovery_agent/firewallelement/multiadd
Description

Creates new firewall elements in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Body

body
required

Firewall Element List

< Firewall Element Details > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.51.12. Add Firewall Interfaces

POST /discovery_agent/firewallinterface/multiadd
Description

Creates new firewall Interfaces in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Body

body
required

Firewall Interfaces List

< Firewall Interface > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.51.13. Add Firewall Neighbors

POST /discovery_agent/firewallneighbor/multiadd
Description

Creates new firewall Neighbors in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Body

body
required

Firewall Neighbors List

< Firewall Neighbor > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.51.14. Add Firewall Subnets

POST /discovery_agent/firewallsubnet/multiadd
Description

Creates new firewall subnets in TCPWave IPAM.
Below example shows sample request JSON:
[{"firewallIP":"1.0.0.2","interfaceName":"loopback0","subnetIP":"1.0.0.0","subnetMask":"255.255.255.0","subnetMaskLength":"24","nextHop":"","isVrf":"false","isLocal":"false"}]

Parameters
Type Name Description Schema Default

Body

body
required

Firewall Subnets List

< Firewall Subnet > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.51.15. VRFs List

GET /discovery_agent/firewallvrf/list
Description

Obtains a list of vrfs discovered by Firewall in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_agent/firewallvrf/list?firewall_ip=1.1.1.0&cmdId=TDCE_20220422123

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command ID

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

firewall_ip
required

Router IPAddress

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Router Element Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListVRF

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.51.16. Add Firewall VRFs

POST /discovery_agent/firewallvrf/multiadd
Description

Creates new firewall VRFs in TCPWave IPAM.
Below example shows sample request JSON:
[{"firewallIp":"1.0.0.2","name":"VRF","route_distinguisher":"10.1.10.15","vrf_interface":"f0/0.82","commandId":"TDCE_202204290123"}]

Parameters
Type Name Description Schema Default

Body

body
required

Firewall VRFs List

< VRF > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.51.17. Neighbor Device Details

GET /discovery_agent/getNeighbors
Description

Gets the neighbor device details for a device discovered in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/router_subnet/getNeighbors?commandId=TDC_20220422121&applIp=10.0.0.0&orgName=Internal&deviceIp=10.1.0.0&deviceType=Router

Parameters
Type Name Description Schema Default

Query

applIp
required

Agent IP Address

string

Query

commandId
required

Command ID

string

Query

deviceIp
required

Device IP Address

string

Query

deviceType
required

Device Type

string

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.51.18. GET /discovery_agent/getSnmpDetails

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • application/json

  • text/plain

4.51.19. Subnet Details of a Device

GET /discovery_agent/getSubnetsByDevice
Description

Gets the subnet for the selected discovered device in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/router_subnet/getSubnetsByDevice?commandId=TDC_20220422121&applIp=10.0.0.0&orgName=Internal&deviceIp=10.1.0.0&deviceType=Router

Parameters
Type Name Description Schema Default

Query

applIp
required

Agent IP Address

string

Query

commandId
required

Command ID

string

Query

deviceIp
required

Device IP Address

string

Query

deviceType
required

Device Type

string

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Device Details Map > array

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.51.20. Discovered Subnet elements List

GET /discovery_agent/getsubnet_elements
Description

Fetches the list of discovered subnet elements list.
The example listed below shows a sample request URL:
/rest/discovery_agent/getsubnet_elements?device_ip=10.0.0.3&subnet_ip=10.1.10.1&mask=24

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command ID

string

Query

device_ip
required

Firewall IPAddress

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

mask
required

Subnet Mask

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Router Element Range

integer(int32)

Query

subnet_ip
required

Subnet IPAddress

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListFirewallSubnetElement

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.51.21. Subnet Details

GET /discovery_agent/getsubnets
Description

Lists all the subnets discovered for the selected firewall in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_agent/getsubnets?start=1&length=20&firewall_ip=20.0.0.3

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command ID

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

firewall_ip
required

Router IPAddress

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Router Element Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListFirewall Subnet

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.51.22. Discovered VMWare elements List

GET /discovery_agent/getvmware_elements
Description

Fetches the list of discovered VMWare elements list in TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_agent/getvmware_elements?device_ip=10.0.0.3&cmdId=TDCE_2022040701

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command ID

string

Query

device_ip
required

VMWare IP Address

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Router Element Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListVMWare Discovery Element Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.51.23. Interfaces List

GET /discovery_agent/interfaces
Description

Obtains a list of interfaces discovered by firewall in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_agent/getinterfaces?firewall_ip=1.1.1.0

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command ID

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

firewall_ip
required

Firewall IPAddress

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Router Element Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListFirewall Interface

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.51.24. NAT Pool Details

GET /discovery_agent/natpoolList
Description

Lists all the NAT Pools discovered for the selected device in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_agent/natpoolList?start=1&length=20&firewallIP=20.0.0.3&cmdId=TDCE_20220331012

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command Id

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

firewallIP
required

Switch IPAddress

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Switch Element Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListFirewall NAT Pool Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.51.25. Interfaces List

GET /discovery_agent/neighbours
Description

Obtains a list of interfaces discovered by Firewall in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_agent/neighbours?firewall_ip=1.1.1.0

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command ID

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

firewall_ip
required

Router IPAddress

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Router Element Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListFirewall Neighbor

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.51.26. Subnet Details

GET /discovery_agent/object/get
Description

Returns the Subnet details that has the DHCP Profile, Primary Router, Subnet Group, VLAN and Domain information for a given subnet for discovery.
The example listed below shows a sample request URL:
/rest/discovery_agent/subnet/get?address=10.0.0.0&organizationName=Internal

Parameters
Type Name Description Schema Default

Query

address
required

Subnet Address

string

Query

organizationName
required

Organization Name

string

Query

subnet_id
optional

Subnet ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

TIMS Object

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.51.27. Subnet Agent Map

GET /discovery_agent/subnet/agentMap
Description

Fetching subnet agent from the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_agent/subnet/agentMap?ipAddress=192.168.0.0/24&organizationName=Internal&type=network

Parameters
Type Name Description Schema Default

Query

ipAddress
required

Subnet IP

string

Query

organizationName
required

Organization Name

string

Query

type
required

Type

string

Responses
HTTP Code Description Schema

200

successful operation

< string, string > map

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.51.28. Subnet Details

GET /discovery_agent/subnet/get
Description

Returns the Subnet details that has the DHCP Profile, Primary Router, Subnet Group, VLAN and Domain information for a given subnet for discovery.
The example listed below shows a sample request URL:
/rest/discovery_agent/subnet/get?address=10.0.0.0&organizationName=Internal

Parameters
Type Name Description Schema Default

Query

address
required

Subnet Address

string

Query

organizationName
required

Organization Name

string

Query

subnet_id
optional

Subnet ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

Subnet Information

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.51.29. Add Firewall Subnet elements

POST /discovery_agent/subnetelement/multiadd
Description

Creates new firewall subnet elements in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Body

body
required

Firewall Subnets List

< FirewallSubnetElement > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.51.30. Add VMware

POST /discovery_agent/vmware/multiadd
Description

Creates new VMware in TCPWave IPAM.

Parameters
Type Name Description Schema Default

Body

body
required

VMWare List

< Discovery Agent VMWare > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.51.31. Add VMware elements

POST /discovery_agent/vmware_element/multiadd
Description

Creates new VMware elements in TCPWave IPAM.

Parameters
Type Name Description Schema Default

Body

body
required

VMWare Element List

< VMWare Discovery Element Details > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.51.32. VRF

GET /discovery_agent/vrf/get
Description

Fetching VRF from the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_agent/vrf/get?id=1245

Parameters
Type Name Description Schema Default

Query

name
required

VRF Name

string

Query

organizationName
required

Organization Name

string

Query

vrf_id
optional

VRF ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

VRF

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.52. Discovery Appliance Service

4.52.1. Add Discovery Agent

POST /discovery_appliance/add
Description

Creates a new discovery agent that can be used to discover a network or subnet in the TCPWave IPAM.
Below example shows sample request JSON:
{"applianceIP":"3.0.0.20","organizationName":"Test","templateName":"Default Discovery Template","description":"Discovery Agent","threadPoolSize":10}

Parameters
Type Name Description Schema Default

Body

body
required

Discovery Agent Details

Discovery Appliance

Responses
HTTP Code Description Schema

500

TIMS-1916: Organization name cannot be null. TIMS-1352: Organization does not exist: {0}, TIMS-14000: Remote appliance is not valid: {0}, TIMS-3051: Appliance address cannot be null., TIMS-15106: Discovery template cannot be null.,TIMS-15108: Discovery appliance is not valid.,TIMS-15109: Discovery appliance: {0} already exists.

No Content

Consumes
  • application/json

  • application/xml

4.52.2. Discovery Events List

GET /discovery_appliance/agent/events/list
Description

Fetches the list of discovery events list.
The example listed below shows a sample request URL:
/rest/discovery_appliance/agent/events/list?organizations=Test&cmdId=TDCE_20220422123

Parameters
Type Name Description Schema Default

Query

cmdId
optional

CommandId

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organizations

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Router Element Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListDiscoveryEvents

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.52.3. Discovery Agent Task List

GET /discovery_appliance/agent/tasks/list
Description

Fetches the list of discovery agent tasks present in TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_appliance/agent/tasks/list?organizations=Test&applianceIP=10.0.0.2

Parameters
Type Name Description Schema Default

Query

applianceIP
optional

Agent IP

string

Query

organizations
optional

Organizations

string

Responses
HTTP Code Description Schema

200

successful operation

< DiscoveryAgentCommand > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.52.4. Delete Discovery Agent

POST /discovery_appliance/delete
Description

Deletes a discovery agent in TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_appliance/delete?applIp=3.0.0.20&orgName=Test

Parameters
Type Name Description Schema Default

Query

applIp
required

Agent IP

string

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

500

TIMS-1916: Organization name cannot be null. TIMS-1352: Organization does not exist: {0}, TIMS-14000: Remote appliance is not valid: {0}, TIMS-3051: Appliance address cannot be null.

No Content

Consumes
  • application/json

  • application/xml

4.52.5. Gets Discovery Agent Details

GET /discovery_appliance/details
Description

Gets discovery agent details present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_appliance/details?applIp=3.0.0.10&orgName=Test

Parameters
Type Name Description Schema Default

Query

applIp
required

Agent IP

string

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Discovery Appliance

500

TIMS-1916: Organization name cannot be null. TIMS-1352: Organization does not exist: {0}, TIMS-14000: Remote appliance is not valid: {0}, TIMS-3051: Appliance address cannot be null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.52.6. Discovery Devices list

GET /discovery_appliance/discovery_device/list
Description

Lists all the device credentials for the discovery agent in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_appliance/discovery_device/list?start=1&length=20&applIp=20.0.0.3&orgName=Internal

Parameters
Type Name Description Schema Default

Query

applIp
required

Appliance IP Address

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

orgName
required

Organization Name

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Router Element Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListDiscoveryRouters

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.52.7. Add Discovery Device

POST /discovery_appliance/discovery_device/multiadd
Description

Creates new discovery device credentials in TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_appliance/discovery_device/multiadd?orgName=Test&applIp=10.0.0.2

Parameters
Type Name Description Schema Default

Query

applIp
required

Discovery Agent

string

Query

orgName
required

Organization Id

string

Body

body
required

Discovery device credentials List

< DiscoveryRouters > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.52.8. Delete Discovery Device

POST /discovery_appliance/discovery_device/multidelete
Description

Deletes the discovery device in TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_appliance/discovery_device/multidelete?orgName=Test&applIp=10.0.0.2

Parameters
Type Name Description Schema Default

Query

applIp
required

Discovery Agent

string

Query

orgName
required

Organization Id

string

Body

body
required

Discovery device credentials List

< DiscoveryRouters > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.52.9. Update Discovery Device

POST /discovery_appliance/discovery_device/update
Description

Updates the discovery device in TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_appliance/discovery_device/update?orgName=Test&applIp=10.0.0.2

Parameters
Type Name Description Schema Default

Query

applIp
required

Discovery Agent

string

Query

orgName
required

Organization Id

string

Body

body
required

Discovery device credentials List

DiscoveryRouters

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.52.10. Discovery Devices list

GET /discovery_appliance/discovery_exclusion/list
Description

Lists all the device exclusions for the discovery agent in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_appliance/discovery_exclusion/list?start=1&length=20&applIp=10.0.0.3&orgName=Internal

Parameters
Type Name Description Schema Default

Query

applIp
required

Appliance IP Address

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

orgName
required

Organization Name

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Router Element Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListDiscovery Exclusions

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.52.11. Add Discovery Device

POST /discovery_appliance/discovery_exclusion/multiadd
Description

Creates new discovery exclusions in TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_appliance/discovery_exclusion/multiadd?orgName=Test&applIp=10.0.0.2

Parameters
Type Name Description Schema Default

Query

applIp
required

Discovery Agent

string

Query

orgName
required

Organization Name

string

Body

body
required

Discovery exclusion List

< Discovery Exclusions > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.52.12. Delete Discovery Device

POST /discovery_appliance/discovery_exclusion/multidelete
Description

Deletes the discovery exclusions in TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_appliance/discovery_exclusion/multidelete?orgName=Test&applIp=10.0.0.2

Parameters
Type Name Description Schema Default

Query

applIp
required

Discovery Agent

string

Query

orgName
required

Organization Name

string

Body

body
required

Discovery Exclusion List

< Discovery Exclusions > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.52.13. Update Discovery Device

POST /discovery_appliance/discovery_exclusion/update
Description

Updates the discovery exclusions in TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_appliance/discovery_exclusion/update?orgName=Test&applIp=10.0.0.2

Parameters
Type Name Description Schema Default

Query

applIp
required

Discovery Agent

string

Query

orgName
required

Organization Name

string

Body

body
required

Discovery device credentials List

Discovery Exclusions

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.52.14. Initiate Discovery on the agent

GET /discovery_appliance/initiate
Description

Initiates discovery on the agent.
The example listed below shows a sample request URL:
/rest/discovery_appliance/initiate?applianceIp=10.0.0.1&organizationName=Test

Parameters
Type Name Description Schema Default

Query

applianceIp
optional

Agent IP

string

Query

organizationName
optional

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.52.15. Checks for Discovery Agent

GET /discovery_appliance/isExists
Description

Checks discovery agent is exist or not in TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_appliance/isExists?applianceIp=3.0.0.10&orgName=Test

Parameters
Type Name Description Schema Default

Query

applianceIp
required

Agent IP

string

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

boolean

500

TIMS-1916: Organization name cannot be null. TIMS-1352: Organization does not exist: {0}, TIMS-14000: Remote appliance is not valid: {0}, TIMS-3051: Appliance address cannot be null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.52.16. Discovery Agents List

GET /discovery_appliance/list
Description

Fetches the list of discovery agents.
The example listed below shows a sample request URL:
/rest/discovery_appliance/list?organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organizations

string

Responses
HTTP Code Description Schema

200

successful operation

< Discovery Appliance > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.52.17. Reset Discovery on the Agent

GET /discovery_appliance/reset
Description

Reset the discovery on the agent

Parameters
Type Name Description Schema Default

Query

applianceIp
optional

Appliance IP

string

Query

organizationName
optional

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7003: You are not authorized to perform this operation.
The example listed below shows a sample request URL:
/rest/discovery_appliance/reset?applianceIp=10.0.0.1&organizationName=Test

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.52.18. Agent Configuration

GET /discovery_appliance/server-configuration
Description

Lists the configuration type and configuration data for an specified agent in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_appliance/server-configuration?server_address=10.0.0.3

Parameters
Type Name Description Schema Default

Query

server_address
required

Agent IP

string

Responses
HTTP Code Description Schema

200

successful operation

Discovery Appliance

500

TIMS-3038: Appliance Type is not valid:<Appliance Type Code>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.52.19. Sync Discovery Agent

GET /discovery_appliance/sync
Description

Updates the discovery agent details.
The example listed below shows a sample request URL:
/rest/discovery_appliance/sync?applianceIp=192.168.0.10&organizationName=Internal

Parameters
Type Name Description Schema Default

Query

applianceIp
optional

Agent IP

string

Query

organizationName
optional

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.52.20. Discovery Agent List

GET /discovery_appliance/testcert
Description

Fetches the list of discovery agents.
The example listed below shows a sample request URL:
/rest/discovery_appliance/testcert?ip=10.0.0.5

Parameters
Type Name Description Schema Default

Query

ip
optional

ip

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.52.21. Update Discovery Agent

POST /discovery_appliance/update
Description

Updates an existing discovery agent that can be used to discover a network or subnet in the TCPWave IPAM.
Below example shows sample request JSON:
{"applianceIP":"3.0.0.20","organizationName":"Etemp","templateName":"Default Discovery Template","description":"Test","oldApplianceIP":"3.0.0.10","oldOrganizationName":"Test","oldTemplateName":"Test Discovery Template","threadPoolSize":"10"}

Parameters
Type Name Description Schema Default

Body

body
required

Discovery Appliance Details

Discovery Appliance

Responses
HTTP Code Description Schema

500

TIMS-1916: Organization name cannot be null. TIMS-1352: Organization does not exist: {0}, TIMS-14000: Remote appliance is not valid: {0}, TIMS-3051: Appliance address cannot be null., TIMS-15106: Discovery template cannot be null.,TIMS-15107: Discovery template is not valid: {0},TIMS-15108: Discovery appliance is not valid.,TIMS-15109: Discovery appliance: {0} already exists.

No Content

Consumes
  • application/json

  • application/xml

4.52.22. Updates Heartbeat for Discovery Agent

GET /discovery_appliance/update_heartbeat
Description

Updates Heartbeat for Discovery Agent present in TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/discovery_appliance/update_heartbeat?applianceIp=3.0.0.10&orgName=Test&status=alive

Parameters
Type Name Description Schema Default

Query

applianceIp
required

Agent IP

string

Query

orgName
required

Organization Name

string

Query

status
required

Heartbeat Status

string

Responses
HTTP Code Description Schema

500

TIMS-1916: Organization name cannot be null. TIMS-1352: Organization does not exist: {0}, TIMS-14000: Remote appliance is not valid: {0}, TIMS-3051: Appliance address cannot be null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.53. Discovery Event Service

4.53.1. Add Discovery Events

POST /discovery_event/multiadd
Description

Creates new discovery events in the TCPWave IPAM.
Below example shows sample request JSON:
[{"commandId":"TDCE_20210921162330","applianceIp":"192.168.56.10","category":"",}]

Parameters
Type Name Description Schema Default

Body

body
required

Discovery Events List

< DiscoveryEvents > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.53.2. Delete Discovery Events

POST /discovery_event/multidelete
Description

Deletes the discovery events from the TCPWave IPAM.
Below example shows sample request JSON:
[{"commandId":"TDCE_20210921162330","commandId":"TDCE_2021092164451"}]

Parameters
Type Name Description Schema Default

Body

body
required

Discovery Events id list

< integer(int32) > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.54. Discovery Service

Description

This service provides the APIs to the discovery engine of the TCPWave IPAM. The interfaces include discovery of subnets, objects, switches etc., and list the discovered information and set the status on the discovery command. TCPWave's discovery uses SNMP, PING, NetBIOS scan, VMWare Scan, Amazon AWS scan, Microsoft Azure scan, Google Cloud Engine scan, ARP table scan using a fast algorithm that has been optimized for performance. The discovery engine has the ability to automatically update the TCPWave IPAM with the data obtained from discovery.

4.54.1. Accept Discovered Elements

POST /discovery/acceptelements
Description

This service call takes a list of discovered elements and adds to IPAM. If the update discovery results global flag is set the TCPWave IPAM updates the objects in the database with the discovered information. If the object is not already present it is created, otherwise updated in the database.

Parameters
Type Name Description Schema Default

Query

isExternalUser
required

External User

boolean

Body

body
optional

< Accept Elements Request > array

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3501: Unable to retrieve the discovery commands list.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.54.2. Discover IP Information

POST /discovery/discover_element
Description

Discovers information related to the specified IP. besides the information discovered during a subnet discovery for the same IP, as part of this call a deep discovery is done to get the open ports information.

Parameters
Type Name Description Schema Default

Body

body
optional

string

Responses
HTTP Code Description Schema

500

TIMS-3151: Error occurred during discovery, Please check the logs.

No Content

Consumes
  • application/json

Produces
  • application/json

  • application/xml

4.54.3. Discover Subnets

POST /discovery/discover_multiple_subnets
Description

Discovers the specified subnets. Uses ping, nmap, netbios, snmp, and reverse DNS lookup to gather information for all the IPs in the specified subnet.

Parameters
Type Name Description Schema Default

Body

body
required

Discovery Request Details

Discovery Request

Responses
HTTP Code Description Schema

500

TIMS-2086: Please select a subnet to discover, TIMS-3151: Error occurred during discovery, Please check the logs.

No Content

Consumes
  • application/json

Produces
  • application/json

  • application/xml

4.54.4. Discover Subnets

POST /discovery/discover_reclaimable_subnets
Description

Discovers the specified subnets. Uses ping, nmap, netbios, snmp, and reverse DNS lookup to gather information for all the IPs in the specified subnet.
Below example shows sample request JSON:
{"reqs":[{"address":"192.168.0.0/24""organization":"Internal"}],"type":"S"}

Parameters
Type Name Description Schema Default

Body

body
required

Discovery Request Details

Discovery Request

Responses
HTTP Code Description Schema

200

successful operation

< TIMS Object > array

500

TIMS-2086: Please select a subnet to discover, TIMS-3151: Error occurred during discovery, Please check the logs.

No Content

Consumes
  • application/json

Produces
  • application/json

  • application/xml

4.54.5. Discover Subnet of Router

POST /discovery/discover_router_subnets
Description

Scans the entire network, starting with seed routers, discovers the next hop elements, the subnets discovered in each of the routers discovered, and further discovers the IPs in the subnets discovered.

Parameters
Type Name Description Schema Default

Body

body
optional

Discovery Command Data

Responses
HTTP Code Description Schema

500

TIMS-3151: Error occurred during discovery, Please check the logs.

No Content

Consumes
  • application/json

Produces
  • application/json

  • application/xml

4.54.6. Discover Subnet

POST /discovery/discover_subnet
Description

Discovers the specified subnets. Uses ping, nmap, netbios, snmp, and reverse DNS lookup to gather information for all the IPs in the specified subnet.

Parameters
Type Name Description Schema Default

Body

body
optional

Discovery Request

Responses
HTTP Code Description Schema

500

TIMS-2086: Please select a subnet to discover, TIMS-3151: Error occurred during discovery, Please check the logs.

No Content

Consumes
  • application/json

Produces
  • application/json

  • application/xml

4.54.7. Discover Subnet

POST /discovery/discover_switch
Description

Discovers the specified subnets. Uses ping, nmap, netbios, snmp, and reverse DNS lookup to gather information for all the IPs in the specified subnet.

Parameters
Type Name Description Schema Default

Body

body
optional

< string > array

Responses
HTTP Code Description Schema

500

TIMS-2086: Please select a subnet to discover, TIMS-3151: Error occurred during discovery, Please check the logs.

No Content

Consumes
  • application/json

Produces
  • application/json

  • application/xml

4.54.8. Discovery Commands List

GET /discovery/getcmds
Description

Gets the list of discovery commands and their status. Used internally by the TCPWave IPAM to show the current discovery status in GUI and CLI.

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization Names

string

Query

status
optional

string

Query

subnetIP
optional

Subnet IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

< DBDiscoveryCommand > array

500

TIMS-3501: Unable to retrieve the discovery commands list.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.54.9. Discover Subnet Element List

GET /discovery/getdiscoveredsubnetelements
Description

For the specified discovery command gets the list of elements discovered. The information includes the last seen time, discovered name, mac, location, device, vendor, port information etc., and the information for the same IP from the TCPWave IPAM database if the object is already defined in IPAM.

Parameters
Type Name Description Schema Default

Query

cmdId
optional

integer(int32)

Responses
HTTP Code Description Schema

500

TIMS-2086: Please select a subnet to discover.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.54.10. Discover Subnet Element List

POST /discovery/getsubnetelements
Description

For the specified discovery command gets the list of elements discovered. The information includes the last seen time, discovered name, mac, location, device, vendor, port information etc., and the information for the same IP from the TCPWave IPAM database if the object is already defined in IPAM.

Parameters
Type Name Description Schema Default

Body

body
optional

< integer(int32) > array

Responses
HTTP Code Description Schema

500

TIMS-2086: Please select a subnet to discover.

No Content

Consumes
  • application/json

Produces
  • application/json

  • application/xml

4.54.11. Discover Subnet Element List

POST /discovery/getswitchelements
Description

For the specified discovery command gets the list of elements discovered. The information includes the last seen time, discovered name, mac, location, device, vendor, port information etc., and the information for the same IP from the TCPWave IPAM database if the object is already defined in IPAM.

Parameters
Type Name Description Schema Default

Body

body
optional

< Switch Details > array

Responses
HTTP Code Description Schema

500

TIMS-2086: Please select a subnet to discover.

No Content

Consumes
  • application/json

Produces
  • application/json

  • application/xml

4.54.12. Object Discovery Update

POST /discovery/handle_object_discovery_update
Description

This is an internal service call that the discovery engine invokes after a subnet discovery is complete. Based on if the auto discovery and auto discovery update flags are set in the global options, The TCPWave IPAM automatically sets the accept status on the discovery command and updates the database with the newly discovered information.

Parameters
Type Name Description Schema Default

Body

body
optional

integer

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

Produces
  • application/json

  • application/xml

4.54.13. Subnet Discovery Update

POST /discovery/handle_subnet_discovery_update
Description

This is an internal service call that the discovery engine invokes after a subnet is discovered as part of the router/subnet discovery. The TCPWave IPAM check if the subnet is already defined in IPAM and verifies if the discovered information matches with that of the provisioned information and generates alarms in cases of a mismatch.

Parameters
Type Name Description Schema Default

Body

body
optional

< string > array

Responses
HTTP Code Description Schema

500

TIMS-3507: An error occurred during retrieval of discovered data.

No Content

Consumes
  • application/json

Produces
  • application/json

  • application/xml

4.54.14. Set Accept Status of Discovery Command

POST /discovery/setacceptstatus
Description

This service call takes a list of discovery command Ids and sets the status of each of these to "ACCEPTED". If the update discovery results global flag is set the TCPWave IPAM updates the objects in the database with the discovered information. If the object is not already present it is created, otherwise updated in the database.

Parameters
Type Name Description Schema Default

Query

isExternalUser
required

External User

boolean

Body

body
optional

< integer(int32) > array

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3501: Unable to retrieve the discovery commands list.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.54.15. Set Discard Status of Discovery Command

POST /discovery/setdiscardstatus
Description

This service call takes a list of discovery command Ids and set the status to discarded. The discovered information is deleted from the database and the discovery commands are removed from the list of commands displayed in the GUI.

Parameters
Type Name Description Schema Default

Body

body
required

List of discovery command IDs

< integer(int32) > array

Responses
HTTP Code Description Schema

500

TIMS-3501: Unable to retrieve the discovery commands list.

No Content

Consumes
  • application/json

4.54.16. Updates Object discovery data

POST /discovery/updateObjectDiscoveryData
Description

Update Object Discovery Data with Switch name, Port and Duplex.

Parameters
Type Name Description Schema Default

Body

body
required

Object Discovery Data

Object Discovery Data

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

Produces
  • application/json

  • application/xml

4.55. Discovery Template Service

Description

This service provides API's to manage Discovery Templates in the TCPWave IPAM.

4.55.1. Add Discovery Template

POST /discovery_template/add
Description

Creates a new Discovery Template that can be used during network or subnet discovery in TCPWave IPAM.
Below example shows sample request JSON:
{ "name":"discotemp","organizationName":"QAOrg","discoveryPreferences":"SNMP,NMAP,Reverse DNS,NetBios,Switch,VMWare","maxSNMPReqRetries":"2","snmpResTimeout":"2000","revDNSLookupTimeout":"2000","addNonConflictingObjects":false,"conflictingObjPreference":"Flag For Manual Reconciliation","description":"test"}

Parameters
Type Name Description Schema Default

Body

body
required

Discovery Template Details

Discovery Template

Responses
HTTP Code Description Schema

500

TIMS-1020: Organization does not exist, TIMS-7003: You are not authorized to perform this operation, TIMS-5006: Template already exists: {Template Name}, TIMS-11057: Invalid router option specified.

No Content

Consumes
  • application/json

  • application/xml

4.55.2. Delete Discovery Template

POST /discovery_template/delete
Description

Deletes the discovery template.
The example listed below shows a sample request URL:
/discovery_template/delete?name=discotemp1&org_name=QAOrg

Parameters
Type Name Description Schema Default

Query

name
required

Name

string

Query

org_name
required

Organization Name

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

  • application/json

Produces
  • application/json

  • application/xml

4.55.3. Discovery Template References

POST /discovery_template/deletereferences
Description

Provides the list of networks and subnets in the TCPWave IPAM which use specific Discovery Template.
The example listed below shows a sample request URL:
/discovery_template/deletereferences?

Parameters
Type Name Description Schema Default

Body

body
required

Template References To Be Deleted

Template References To Be Deleted

Responses
HTTP Code Description Schema

500

TIMS-12004: Discovery Template Reference(s) not found.

No Content

Consumes
  • application/json

  • application/xml

4.55.4. Get discovery template details

GET /discovery_template/details
Description

Fetches the details of a discovery template.
The example listed below shows a sample request URL:
/rest/discovery_template/details?org_name=Internal&name=templateName

Parameters
Type Name Description Schema Default

Query

name
required

Name

string

Query

org_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Discovery Template

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.55.5. Update Discovery Template

POST /discovery_template/edit
Description

Updates an existing Discovery Template that can be used during network and subnet discovery in the TCPWave IPAM.
Below example shows sample request JSON:
{"oldName":"discotemp","name":"discotemp1","organizationName":"QAOrg","discoveryPreferences":"SNMP,NMAP,Reverse DNS,NetBios,Switch,VMWare","maxSNMPReqRetries":"2","snmpResTimeout":"2000","revDNSLookupTimeout":"2000","addNonConflictingObjects":false,"conflictingObjPreference":"Flag For Manual Reconciliation","description":"test"}

Parameters
Type Name Description Schema Default

Body

body
required

Discovery Template

Discovery Template

Responses
HTTP Code Description Schema

500

TIMS-1020: Organization does not exist, TIMS-7003: You are not authorized to perform this operation, TIMS-5006: Template already exists: {Template Name}, TIMS-11057: Invalid router option specified.

No Content

Consumes
  • application/json

  • application/xml

4.55.6. Get discovery template details by network or subnet address

GET /discovery_template/getdiscoverypreferences
Description

Fetches the details of discovery template associated with network or subnet.
The example listed below shows a sample request URL:
/rest/discovery_template/getdiscoverypreferences?org_name=Internal&address=1.0.0.&type=

Parameters
Type Name Description Schema Default

Query

address
required

Address

string

Query

org_name
required

Organization Name

string

Query

type
required

Type

string

Responses
HTTP Code Description Schema

200

successful operation

Discovery Template

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.55.7. Discovery Template References

GET /discovery_template/getreferences
Description

Provides the list of networks and subnets in the TCPWave IPAM which use specific Discovery Template.
The example listed below shows a sample request URL:
/discovery_template/getreferences?template_name=templateNameValue&organization_name=QAOrg

Parameters
Type Name Description Schema Default

Query

organization_id
optional

Organization Id

integer(int32)

Query

organization_name
required

Organization Name

string

Query

template_name
required

Discovery Template Name

string

Responses
HTTP Code Description Schema

200

successful operation

< string, < string > array > map

500

TIMS-12004: Discovery Template Reference(s) not found.

No Content

Consumes
  • application/json

  • application/xml

4.55.8. Discovery Template List

GET /discovery_template/list
Description

Fetches the list of discovery templates.
The example listed below shows a sample request URL:
/rest/discovery_template/list?organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organizations

string

Responses
HTTP Code Description Schema

200

successful operation

< Discovery Template > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.55.9. Discovery Template List by Organization

GET /discovery_template/p_listbyorg
Description

Obtains a list of all discovery templates that are associated to a specified Organization.
The example listed below shows a sample request URL:
/discovery_template/p_listbyorg?start=1&length=20&org_name=QAOrg

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Ending Discovery Template Range

integer(int32)

Query

order
optional

Sorting Order(asc/desc)

string

Query

org_id
optional

Organization Id

integer(int32)

Query

org_name
required

Organization Name

string

Query

q
required

Match Value

string

Query

sort
optional

Sorting String

string

Query

start
required

Starting Discovery Template Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListDiscovery Template

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist:<Organization Name>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.56. Domain Service

Description

This service provides API's to get list of Domains present in the TCPWave IPAM, add Domains, update Domains, delete Domains, search for a Domain in the TCPWave IPAM.

4.56.1. Domain Add

POST /domain/add
Description

Creates a new Domain by checking if it overlaps with the existing Domain defined in the TCPWave IPAM. Functional Admin can create a new Domain for any organization. Rest of the admins can create a new Domain only for the organizations that they are associated with.Refer to the Administrator reference documentation for additional information about the Domain.
Below example shows sample request JSON:
{"<strong>name</strong>":"qa.com","description":"Domain added using Rest API","<strong>organization_name</strong>":"QAOrganization"}

Parameters
Type Name Description Schema Default

Body

body
optional

Domain

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist: <Organization Name>, TIMS-7003: You are not authorized to perform this operation, TIMS-1300: Domain already exists: {Domain Name}, TIMS-1431: Cannot create a domain: <Domain Name> as there is a forward only zone already exists with this name.

No Content

Consumes
  • application/json

  • application/xml

4.56.2. Domain List By Organization

GET /domain/adzonelistbyorg
Description

Obtains a list of all domains that are associated to a specified Organization.
The example listed below shows a sample request URL:
/rest/domain/adzonelistbyorg?start=1&length=20&org_name=Internal&zone_name=abc.com&q=matchValue

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

inSubnetEdit
required

In Subnet Edit

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

org_id
optional

Organization Id

integer(int32)

Query

org_name
required

Organization Name

string

Query

q
required

Match Value

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Domain Range

integer(int32)

Query

zone_name
required

Zone Name

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListDomain

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist:<Organization Name>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.56.3. Domain Details

GET /domain/get
Description

Gets the detail of the domain.
The example listed below shows a sample request URL:
/rest/domain/get?name=test.tcpwave.net&org_name=Internal

Parameters
Type Name Description Schema Default

Query

id
optional

Domain Id

integer(int32)

Query

name
required

Domain Name

string

Query

org_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Domain

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.56.4. Domain List

GET /domain/hierarchy
Description

List all domains defined in the TCPWave IPAM. Functional Admin gets the list of all domains. Rest of the Admins get only the list of domains associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/domain/hierarchy

Responses
HTTP Code Description Schema

200

successful operation

< DomainNode > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.56.5. Domain List

GET /domain/list
Description

List all domains defined in the TCPWave IPAM. Functional Admin gets the list of all domains. Rest of the Admins get only the list of domains associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/domain/list?organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization Names

string

Responses
HTTP Code Description Schema

200

successful operation

< Domain > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.56.6. List the restricted domains in the organization.

GET /domain/listRestrictedDomains
Description

List the restricted domain(s) in the given organization in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/domain/listRestrictedDomains?orgName=Internal&name=domain.com

Parameters
Type Name Description Schema Default

Query

name
optional

Domain Name

string

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Domain > array

500

TIMS-7003: You are not authorized to perform this operation
TIMS-1916: Organization name cannot be null.
TIMS-1352: Organization does not exist: {0}
TIMS-15044: Restricted domain {0} does not exist in the organization {1}.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.56.7. Domain List By Organization

GET /domain/listalldomainsbyorg
Description

Obtains a list of all domains that are associated to a specified Organization.
The example listed below shows a sample request URL:
/rest/domain/listalldomainsbyorg?page=1&org_name=Internal

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

inSubnetEdit
required

In Subnet Edit

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

org_id
optional

Organization Id

integer(int32)

Query

org_name
required

Organization Name

string

Query

q
required

Match Value

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Domain Range

integer(int32)

Query

with_restricted
optional

With Restricted

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListDomain

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist:<Organization Name>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.56.8. Domain List By Organization

GET /domain/listbyorg
Description

Obtains a list of all domains that are associated to a specified Organization.
The example listed below shows a sample request URL:
/rest/domain/listbyorg?page=1&org_name=Internal

Parameters
Type Name Description Schema Default

Query

inSubnetEdit
required

In Subnet Edit

string

Query

org_id
optional

Organization Id

integer(int32)

Query

org_name
required

Organization Name

string

Query

page
required

Total pages

integer(int32)

Query

q
required

Match Value

string

Query

rows
required

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListDomain

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist:<Organization Name>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.56.9. Domain Multidelete

POST /domain/multidelete
Description

Delete the current list of DNS domains in the TCPWave IPAM. All the Appliance, subnet and object associated with the current domain have to be removed before deleting the current domain. An active directory enabled domain cannot be deleted.
Below example shows sample request JSON:
[ {"name":"updateqa.com","organization_name":"QAOrg"} ]

Parameters
Type Name Description Schema Default

Body

body
optional

< Domain > array

Responses
HTTP Code Description Schema

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist:<Organization Name>, TIMS-1422: TIMS-1422: Zone does not exist:<Zone Name>

No Content

Consumes
  • application/json

  • application/xml

4.56.10. Domain List By Organization

GET /domain/p_listbyorg
Description

Obtains a list of all domains that are associated to a specified Organization.
The example listed below shows a sample request URL:
/rest/domain/p_listbyorg?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

inSubnetEdit
required

In Subnet Edit

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

org_id
optional

Organization Id

integer(int32)

Query

org_name
required

Organization Name

string

Query

q
required

Match Value

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Domain Range

integer(int32)

Query

with_restricted
optional

With Restricted

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListDomain

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist:<Organization Name>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.56.11. Reverse Zone List By Organization

GET /domain/p_revzonelistbyorg
Description

Obtains a list of all Reverse Zones that are associated to a specified Organization.
The example listed below shows a sample request URL:
/rest/domain/p_revzonelistbyorg?start=1&length=20&org_name=Internal&inSubnetEdit=

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

inSubnetEdit
required

In Subnet Edit

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

org_id
optional

Organization Id

integer(int32)

Query

org_name
required

Organization Name

string

Query

q
required

Match Value

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Domain Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListDomain

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist:<Organization Name>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.56.12. Domain List

GET /domain/paged
Description

Provides a paginated list of Domains defined in the TCPWave IPAM. Functional Admin gets the list of all domains. Rest of the Admins get only the list of domains associated with the organization that they belong to.
Below example shows sample request url:
/tims/rest/domain/paged?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sorting Order(asc/desc)

string

Query

organizations
optional

Organization Names

string

Query

sort
optional

Sorting String

string

Query

start
required

Start Page Number

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListDomain

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.56.13. Domain Search

GET /domain/search
Description

Provides the list of searched Domains on search screen in the TCPWave IPAM. Functional Admin gets the list of searched Domains for any organization. Rest of the Admins gets only the list of searched Domains associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/domain/search?page=1&rows=20

Parameters
Type Name Description Schema Default

Query

organizations
required

Organization List

string

Query

page
optional

Page Number

integer(int32)

Query

rows
optional

Number of rows

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListDomain

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.56.14. List of Secondary domains

GET /domain/secondaryDomains
Description

Obtains a list of all secondary domains that are associated to a specified Subnet.
The example listed below shows a sample request URL:
/rest/domain/secondaryDomains?subnetAddress=10.1.10.0&organizationName=Internal

Parameters
Type Name Description Schema Default

Query

organizationName
required

Organization Name

string

Query

subnetAddress
required

Subnet Address

string

Responses
HTTP Code Description Schema

200

successful operation

< Domain > array

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist:<Organization Name>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.56.15. Domain Update

POST /domain/update
Description

Updates an existing domain in the TCPWave IPAM. Functional Admin can update a domain for any organization. Rest of the admins can update a domain only for the organizations that they are associated with.
Below example shows sample request JSON:
{"<strong>organization_name</strong>":"QAOrganization","<strong>name</strong>":"qa.com","<strong>old_name</strong>":"qa.com","description":"Updated domain using Rest API"}

Parameters
Type Name Description Schema Default

Body

body
optional

Domain

Responses
HTTP Code Description Schema

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist:<Organization Name>, TIMS-1422: TIMS-1422: Zone does not exist:<Zone Name>, TIMS-1321: Domain does not exist: <Domain Name>, TIMS-7003: You are not authorized to perform this operation, TIMS-1300: Domain already exists: {Domain Name}, TIMS-1431: Cannot create a domain: <Domain Name> as there is a forward only zone already exists with this name.

No Content

Consumes
  • application/json

  • application/xml

4.57. Dropdown Service

Description

This service provides a dropdown list functionality on UI interface for the TCPWave IPAM.

4.57.1. GET /dropdown/selectValueByID

Parameters
Type Name Description Schema Default

Query

fieldValue
required

integer(int32)

Query

tableName
required

string

Responses
HTTP Code Description Schema

200

successful operation

Dropdown Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.58. Export Compliance Management Service

Description

This service provides API's to get list of Office Of Foreign Assets Control (OFAC) Prohibited Countries present in the TCPWave IPAM, User can add country code top-level domain(ccTLD), add Office Of Foreign Assets Control (OFAC) Prohibited Country name and description.User can delete single or multiple records(ccTLDs, OFAc name) from the grid in the TCPWave IPAM.

4.58.1. Domain Add

POST /exportComplianceMgmt/add
Description

Creates a new ccTLD by checking if it overlaps with the existing ccTLD defined in the TCPWave IPAM. Functional Admin can add a new ccTLD for any country. Refer to the Administrator reference documentation for additional information about the OFAC Countries .
Below example shows sample request JSON:
"{"countryname":"North Korea","cctld":"nk"}"

Parameters
Type Name Description Schema Default

Body

body
optional

OFAC Country

Responses
HTTP Code Description Schema

500

TIMS-1352: TIMS-7003: You are not authorized to perform this operation, TIMS-12090: This ccTLD is already exist.

No Content

Consumes
  • application/json

  • application/xml

4.58.2. ccTLD Multidelete

POST /exportComplianceMgmt/multidelete
Description

Delete the current list of ccTLDs in the TCPWave IPAM.
Below example shows sample request JSON:
"[{"countryname":"North Korea","cctld":"nk"}]"

Parameters
Type Name Description Schema Default

Body

body
optional

< OFAC Country > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.58.3. OFAC Country name and ccTLDs List

GET /exportComplianceMgmt/ofaccountriesgridlist
Description

Obtains a list of existing ccTLDs for auditing purposes.
The example listed below shows a sample request URL:
/rest/exportComplianceMgmt/ofaccountriesgridlist

Responses
HTTP Code Description Schema

200

successful operation

< OFAC Country > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.59. Export Service

Description

This service provides facility to export data in CSV or PDF format from TCPWave IPAM.

4.59.1. Supported Export Types

GET /export/supported_types
Description

Supported export entity types from the TCPWave IPAM such as Admin Group, Permission, ACL, DHCP Appliance etc.
The example listed below shows a sample request URL:
/rest/export/supported_types

Responses
HTTP Code Description Schema

200

successful operation

< Import Type Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.59.2. Export

POST /export/{type}
Description

Export data from TCPWave IPAM into CSV files.
The example listed below shows a sample request URL:
/rest/export/{type}?organization=Internal

Parameters
Type Name Description Schema Default

Path

type
required

Required File type to export

string

Query

adminname
optional

Admin Name

string

Query

organization
required

Organization Name

string

Body

body
optional

string

Responses
HTTP Code Description Schema

200

successful operation

Export Response Information

Consumes
  • application/json

Produces
  • application/json

  • application/xml

4.60. File Distribution Management Service

Description

This service provides APIs to add, edit, delete and get list of file sets managed by TCPWave IPAM.

4.60.1. Create FileSet

POST /fileset/add
Description

Creates a new Fileset containing set of folders and files with list of DHCP appliances present in a particular organization, please consult the product documentation.
Below example shows sample request JSON:
{"name": "FilesetTest","protocol": "TFTP","organization_name": "Internal","description": "Test purpose only","filesetData":"[{"description": "new folder","isFolder": "true,name": "Folder1","parent_name"": "","path": "null"}{"description": "new folder2","isFolder": "true","name": "Folder2","parent_name": "Folder1","path": "Folder1"}{"content": "FilesetTest_Internal/Folder1/Folder2/File.txt","description": "file","isFolder": "false","name": +"File.txt","parent_name": "Folder1/Folder2","path": "Folder1/Folder2/"}]","filesetappliances" :"[{"applianceType": "DHCP","applianceIp":"10.16.0.7","applianceName": "QA-SDNS-FDHCP-001"}]"}

Parameters
Type Name Description Schema Default

Body

body
optional

File Set

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.60.2. Delete File Set

GET /fileset/delete
Description

Deletes selected file set present in the TCPWave IPAM. Functional Admins can delete a file set in any organization. Super Admins can delete the file set that belongs to the organization they are assigned to.
The example listed below shows a sample request URL:
/rest/fileset/delete?organization=Internal&name=filesetName

Parameters
Type Name Description Schema Default

Query

name
optional

File Set Name

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.60.3. Delete Folder

POST /fileset/deletefolder
Description

Deletes Folder.
The example listed below shows a sample request URL:
/rest/fileset/deletefolder?fileset_name=Test&org_name=Internal

Parameters
Type Name Description Schema Default

Query

fileset_name
optional

string

Query

org_name
required

Organization Name

string

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.60.4. Edit FileSet

POST /fileset/edit
Description

Updates an existing file set in the TCPWave IPAM. Functional Admins can edit file sets in any organization.
Below example shows sample request JSON:
{"name": "FilesetTest","protocol": "TFTP","organization_name": "Internal","description": "Test purpose only","filesetData":"[{"description": "new folder","isFolder": "true,name": "Folder1","parent_name"": "","path": "null"}{"description": "new folder2","isFolder": "true","name": "Folder2","parent_name": "Folder1","path": "Folder1"}{"content": "FilesetTest_Internal/Folder1/Folder2/File.txt","description": "file","isFolder": "false","name": +"File.txt","parent_name": "Folder1/Folder2","path": "Folder1/Folder2/"}]","filesetappliances" :"[{"applianceType": "DHCP","applianceIp":"10.16.0.7","applianceName": "QA-SDNS-FDHCP-001"}]"}

Parameters
Type Name Description Schema Default

Body

body
optional

File Set

Responses
HTTP Code Description Schema

500

TIMS 1955: A file set with the given name already exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.60.5. Details of FileSet

GET /fileset/get
Description

Retrieves the details of a FileSet in the TCPWave IPAM.
Below example shows the sample request URL:
/rest/fileset/get?name=Test&organization=Internal

Parameters
Type Name Description Schema Default

Query

name
optional

FileSet Name

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

File Set

500

1950 = TIMS-1950: File Set cannot be null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.60.6. Get File Set List

GET /fileset/list
Description

Provides a list of file sets present in the TCPWave IPAM.
Below example shows the sample request URL:
/rest/fileset/list?draw=2&start=0&length=20&sort=name&order=asc&organizations=Internal

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
required

Organizations

string

Query

sort
optional

Sort String

string

Query

start
required

Starting File Set Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListFile Set

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.60.7. Primary DHCP Appliance List

GET /fileset/primary-servers-list
Description

Obtains a list of available primary DHCP Appliances defined and managed by the TCPWave IPAM.
Below example shows the sample request URL:
/rest/fileset/primary-servers-list?org_name=Internal

Parameters
Type Name Description Schema Default

Query

org_name
required

Required Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Server Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.60.8. FileSet Sync Operation

POST /fileset/sync
Description

Generates Adhoc IPv4 DHCP Configuration and syncs the servers with the latest configuration.
Below example shows sample request JSON:
{"name": "FilesetTest","organization_name": "Earth"}

Parameters
Type Name Description Schema Default

Body

body
optional

< File Set > array

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.61. File Upload Service

Description

This service provides facility to upload a CSV file from specified location in the TCPWave IPAM.

4.61.1. Binary Upload

POST /files/binaryupload/{file_name}
Description

Uploads Binary File.
The example listed below shows a sample request URL:
/rest/files/binaryupload/{file_name}

Parameters
Type Name Description Schema Default

Path

file_name
required

File Name

string

Body

body
optional

string

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • multipart/form-data

4.61.2. Upload File

POST /files/upload/{file_name}
Description

Uploads a new File from specified location into the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/files/upload/{file_name}

Parameters
Type Name Description Schema Default

Path

file_name
required

File Name

string

Body

body
optional

string

Responses
HTTP Code Description Schema

500

TIMS-8228: The file type is not valid.

No Content

Consumes
  • text/plain

4.62. Firewall Service

Description

This service provides the API to manage stateful firewall template definitions in the TCPWave IPAM.

4.62.1. Add Firewall Template

POST /firewall/template/add
Description

Creates a new firewall template which has a user defined set of rules in the TCPWave IPAM. These rules are applied to DNS Appliances managed by TCPWave IPAM.
Below example shows sample request JSON:
{ "name":"trem1","organization_name":"QAOrg","description":"tertse","rules":[{"name":"ret","action":"ACCEPT","chain":"INPUT","protocol":"all","source":"","invertSource":true,"sourcePort":"","invertSourcePort":false,"destination":"","invertDestination":true,"destinationPort":"","invertDestinationPort":false,"incomingInterface":"","outgoingInterface":"","ethernetAddress":"","fragmentation":true,"dns":true,"dnsQuery":true,"dnsResponse":true,"queryType":"A","edns0":false,"stringMatch":false,"matchString":"","extensionString":""},{"name":"etrr","action":"LOG","chain":"INPUT","protocol":"all","source":"","invertSource":true,"sourcePort":"","invertSourcePort":false,"destination":"","invertDestination":false,"destinationPort":"","invertDestinationPort":false,"incomingInterface":"","outgoingInterface":"","ethernetAddress":"","fragmentation":false,"dns":false,"dnsQuery":false,"dnsResponse":false,"queryType":"ANY","edns0":true,"stringMatch":false,"matchString":"","extensionString":""}]}

Parameters
Type Name Description Schema Default

Body

body
required

Firewall template details

Firewall Template

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.62.2. Firewall Template List associated with the DNS Appliances

GET /firewall/template/assoc/list
Description

Displays the list of Firewall Templates that are associated with the DNS servers managed by the TCPWave IPAM.
Below example shows the sample request URL:
/rest/firewall/template/assoc/list?org_name=Internal&address=firewallTemplateAddress&template_name=firewallTemplateNameValue

Parameters
Type Name Description Schema Default

Query

address
required

Firewall Template Address

string

Query

org_name
required

organization name associated with Firewall Template

string

Query

template_name
required

Firewall Template Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Firewall Template Association > array

500

TIMS-1021: Organization name is not valid, TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.62.3. Modify Firewall Template

POST /firewall/template/assoc/update
Description

Updates Firewall Template Association that are associated with the DNS Appliances managed by the TCPWave IPAM.
Below example shows the sample request URL:
/rest/firewall/template/assoc/update?address=firewallTemplateAddress&template_name=firewallTemplateNameValue

Parameters
Type Name Description Schema Default

Query

address
required

Firewall Template Address

string

Query

template_name
required

Firewall Template Name

string

Responses
HTTP Code Description Schema

500

TIMS-4302: Server and Template do not belong to the same Organization, TIMS-4301: Appliance does not exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.62.4. Firewall Template Delete

POST /firewall/template/delete
Description

Deletes the specified firewall template in the TCPWave IPAM . This action is audited.
Below example shows sample request JSON:
{ "name":"trem2" }

Parameters
Type Name Description Schema Default

Query

name
required

Firewall Template Name

string

Responses
HTTP Code Description Schema

500

TIMS-5020: Template does not exist, TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.62.5. Firewall Template List

GET /firewall/template/get
Description

Lists all the Firewall Templates defined in the TCPWave IPAM. A firewall has a set of rules which are applied to DNS Servers managed by the TCPWave IPAM.DNS Firewall prevents connected devices from becoming infected with malware and blocks their activity by enabling recursive DNS Appliances to stop or redirect queries from clients that want to access domains and/or IPs known to be malicious.
The example listed below shows a sample request URL parameters:
/rest/firewall/template/get?name=trem&org_name=Internal

Parameters
Type Name Description Schema Default

Query

for_select
optional

Indicates if the firewall template list is to display in the dropdown in UI

boolean

Query

name
required

template name associated with Firewall Template

string

Query

org_name
required

organization name associated with Firewall Template

string

Responses
HTTP Code Description Schema

200

successful operation

Firewall Template

500

TIMS-1352: Organization does not exist.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.62.6. Firewall Template List

GET /firewall/template/list
Description

Lists all the Firewall Templates defined in the TCPWave IPAM. A firewall has a set of rules which are applied to DNS Servers managed by the TCPWave IPAM.DNS Firewall prevents connected devices from becoming infected with malware and blocks their activity by enabling recursive DNS Appliances to stop or redirect queries from clients that want to access domains and/or IPs known to be malicious.
Below example shows the sample request URL:
/rest/firewall/template/list?organizations=Internal

Parameters
Type Name Description Schema Default

Query

for_select
optional

Indicates if the firewall template list is to display in the dropdown in UI

boolean

Query

organizations
optional

organizations

string

Responses
HTTP Code Description Schema

200

successful operation

< Firewall Template > array

500

TIMS-1352: Organization does not exist.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.62.7. Firewall Template Edit

POST /firewall/template/modify
Description

Updates the firewall template configuration in the TCPWave IPAM.
Below example shows sample request JSON:
{"name":"trem1","description":"testing","new_name":"trem2","rules":[{"name":"rule1","action":"ACCEPT","chain":"FORWARD","protocol":"all","source":"","invertSource":true,"sourcePort":"","invertSourcePort":false,"destination":"","invertDestination":true,"destinationPort":"","invertDestinationPort":false,"incomingInterface":"","outgoingInterface":"","ethernetAddress":"","fragmentation":false,"dns":false,"dnsQuery":false,"dnsResponse":false,"queryType":"A","edns0":false,"stringMatch":false,"matchString":"","extensionString":""},{"action":"LOG","chain":"INPUT","protocol":"all","invertProtocol":false,"source":"","invertSource":true,"destination":"","invertDestination":false,"sourcePort":"","invertSourcePort":false,"destinationPort":"","invertDestinationPort":false,"incomingInterface":"","invertIncomingInterface":false,"outgoingInterface":"","invertOutgoingInterface":false,"ethernetAddress":"","fragmentation":false,"dns":false,"dnsQuery":false,"dnsResponse":false,"edns0":true,"queryType":"ANY","stringMatch":false,"matchString":"","extensionString":"","name":"rule-2"}]}

Parameters
Type Name Description Schema Default

Body

body
required

Firewall template details

Firewall Template

Responses
HTTP Code Description Schema

500

TIMS-5001: Template already exists, TIMS-5002: Template name already exists in DNS Option Templates, TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.63. Firmware Patch Service

Description

This service provides API's to upload a patch and get list of Firmware patches present in the TCPWave IPAM.

4.63.1. Delete Patch

POST /ospatch/delete
Description

Deletes a patch file managed by the TCPWave IPAM. For additional information about the cache only DNS Appliances and the configuration of the forwarders, please refer to the product documentation.
The example listed below shows a sample request URL:
/rest/ospatch/delete?patch_name=test.exe
Below example shows sample request JSON:
[{"patch_id":"21","patch_name":"test.exe"}]

Parameters
Type Name Description Schema Default

Query

patch_id
optional

integer(int32)

Query

patch_name
required

patch name

string

Responses
HTTP Code Description Schema

500

TIMS-1425: Both Appliance id and Appliance IP address cannot be null, TIMS-1426:DNS Internal Cache Appliance does not exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.63.2. Deploy a Firmware Patch

GET /ospatch/deploy
Description

Deploys a Firmware patch on the given remote.
The example listed below shows a sample request URL:
/rest/ospatch/deploy?patchName=test.exe&appliances=1.0.0.2&server_type=DNS

Parameters
Type Name Description Schema Default

Query

appliances
required

Appliances IP Addresses

string

Query

patchName
required

Patch Name

string

Query

server_type
required

Appliances Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.63.3. Firmware Patch List

GET /ospatch/list
Description

Provides a list of Firmware patches uploaded in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/ospatch/list

Responses
HTTP Code Description Schema

200

successful operation

< OSPatch > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.63.4. Firmware Patch List

GET /ospatch/serverpatchinfo
Description

Provides a list of Firmware patches uploaded in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/ospatch/serverpatchinfo?patch_name=test.exe

Parameters
Type Name Description Schema Default

Query

patch_name
required

patch name

string

Responses
HTTP Code Description Schema

200

successful operation

< OSPatchStatus > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.63.5. Patch Upload

POST /ospatch/upload
Description

Uploads a new Firmware patch by checking if it overlaps with the existing Firmware patch defined in the TCPWave IPAM.
Below example shows sample request JSON:
{ "patchName": "DB_patch1", "patchType": "dellhardware", "patchSize": 1000, "patchChecksum": 1, "patchFolderPath": "/tmp/patches", "patchLevel": "string", "patchVersion": "string"}

Parameters
Type Name Description Schema Default

Body

body
required

Firmware patch details

OSPatch

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-14024: Firmware patch cannot be uploaded as there is already a patch exists with same Name: {0}, Type: {1}, Size: {2} and Checksum: {3}

No Content

Consumes
  • application/json

  • application/xml

4.64. Function Service

Description

This service provides API's to add, edit, delete and get functions in the TCPWave IPAM.

4.64.1. Granular Function List

GET /function/granularFunctionList
Description

Get granular function list
The example listed below shows a sample request URL:
/rest/function/granularFunctionList?level=1&id=adminGroupId&role=SADM/FADM/NADM/UADM

Parameters
Type Name Description Schema Default

Query

id
required

Admin/Admin group ID

integer(int32)

Query

level
required

Level

string

Query

role
required

Admin Role

string

Responses
HTTP Code Description Schema

200

successful operation

< Function > array

Consumes
  • application/json

  • text/plain

Produces
  • application/json

  • application/xml

4.64.2. Function List

GET /function/list
Description

Get the list of all the granular and non-granular functions defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/function/list?start=1&length=20

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Function Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListFunction

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.65. Global Options Service

Description

This service class provides Global Options related operation in the TCPWave IPAM such as list all Global Policies, Update Global Policy etc.

4.65.1. Get Global Option

GET /globals/getGlobalOption
Description

Provides specified Global Option details in the TCPWave IPAM.These policies control the behavior of the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/globals/getGlobalOption?option_name=globalOptionName

Parameters
Type Name Description Schema Default

Query

option_name
required

Global option name

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-4102: Global Option name is null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • text/plain

4.65.2. Global Policies List

GET /globals/list
Description

Obtains a list of all the Global policies defined and managed by TCPWave IPAM. These policies control the behavior of the TCPWave IPAM.
Below example shows the sample request URL:
/rest/globals/list

Responses
HTTP Code Description Schema

200

successful operation

< Global Options List > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.65.3. Update Global Policies

POST /globals/update
Description

Updates the value of a global policy in the TCPWave IPAM. Only Functional Admin has the privileges to update a global policy. Rest of the admins will get permission error.
Below example shows the sample request JSON:
{"pId":4217,"pName":"ENABLE_DNS_VIEWS","pValue":"No","pCat":"DNS","pType":"BOOLEAN"}

Parameters
Type Name Description Schema Default

Body

body
required

Global option details

Global Policy Management(GPM)

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7003: You are not authorized to perform this operation, TIMS-4100: No Global Option exist by name : '<global policy name>.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.65.4. Update Global Policies

POST /globals/updatefadmaccess
Description

Enable FADM access in the TCPWave IPAM. Only UADM Admin has the privileges to update the FADM access.
Below example shows the sample request JSON:
/rest/globals/updatefadmaccess?option=Yes

Parameters
Type Name Description Schema Default

Query

option
required

Option Value

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.66. Hierarchy Service

Description

This service provides the API to manage Network Hierarchy in the TCPWave IPAM.

4.66.1. Delete Address Block

POST /hierarchy/address_block/delete
Description

Deletes an existing address block.
The example listed below shows a sample request URL:
/rest/hierarchy/address_block/delete?org_name=Internal
Below example shows sample request JSON:
"{"parentSpace":"Address_block1","address":"10.0.1.0","mask":"24"}"

Parameters
Type Name Description Schema Default

Query

org_name
required

organization name associated with the address block

string

Query

preserve_child
optional

Specifies if the child nodes should be moved to the parent block

boolean

Body

body
required

Address block details

AddressBlock

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.66.2. List of Address Blocks

GET /hierarchy/address_block/list
Description

Returns the list of address blocks.
The example listed below shows a sample request URL:
/rest/hierarchy/address_block/list?organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organizations

string

Responses
HTTP Code Description Schema

200

successful operation

< AddressBlock > array

Consumes
  • text/plain

Produces
  • application/json

4.66.3. Address Block Network List

GET /hierarchy/address_block/network/list
Description

Gets the networks within the range of specified address block.
The example listed below shows a sample request URL:
/rest/hierarchy/address_block/network/list?organization=Internal&space=Internal-Space&address=192.168.0.0&mask=24

Parameters
Type Name Description Schema Default

Query

address
required

Block Address

string

Query

mask
required

Mask

integer(int32)

Query

organization
required

Organization

string

Query

space
required

Address Space

string

Responses
HTTP Code Description Schema

200

successful operation

< Network Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.66.4. Add Address Space

POST /hierarchy/address_space/add
Description

Creates a new address space.
Below example shows sample request JSON:
"{"orgName":"Internal","name":"Address_block1","contact":"","registry":"","description":""}"

Parameters
Type Name Description Schema Default

Body

body
optional

Address Space

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.66.5. Delete Address Space

POST /hierarchy/address_space/delete
Description

Deletes an existing address space.
Below example shows sample request JSON:
"{"orgName":"Internal","name":"Address_block1"}"

Parameters
Type Name Description Schema Default

Body

body
optional

Address Space

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.66.6. List of Address Spaces

GET /hierarchy/address_space/list
Description

Returns the list of address spaces.
The example listed below shows a sample request URL:
/rest/hierarchy/address_space/list?organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

organizations

string

Responses
HTTP Code Description Schema

200

successful operation

< Address Space > array

Produces
  • application/json

4.66.7. Update Address Space

POST /hierarchy/address_space/update
Description

Updates an existing address space.
The example listed below shows a sample request URL:
/rest/hierarchy/address_space/update?name=test
Below example shows sample request JSON:
"{"orgName":"Internal","name":"Address_block1","contact":""test@gmail.com\",\"registry\":&#34;AFRINIC\",\"description&#x22;:\"testing\"}""

Parameters
Type Name Description Schema Default

Query

name
required

name of the existing address space

string

Body

body
optional

Address Space

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.66.8. List of Networks at the given node

GET /hierarchy/block/bnlist
Description

Returns the list of networks that are at the given node level.
The example listed below shows a sample request URL:
/rest/hierarchy/block/bnlist?org_name=Internal&space=Internal-Space&address=192.168.0.0

Parameters
Type Name Description Schema Default

Query

address
required

Address of the block

string

Query

organization
required

Organization name associated with the block

string

Query

space
required

Address space name associated with the block

string

Responses
HTTP Code Description Schema

200

successful operation

< BlocksAndNetworks > array

Consumes
  • text/plain

Produces
  • application/json

4.66.9. Add Child Block

POST /hierarchy/child_block/add
Description

Creates a new child block./rest/hierarchy/child_block/add?org_name=Internal
Below example shows sample request JSON:
"{"parent":"10.0.1.0/24","address":"10.0.1.0","name":"testChild","description":"","mask":"30","parentSpace":"Address_block1"}"

Parameters
Type Name Description Schema Default

Query

adjust_hierarchy
optional

Specifies if the hierarchy should be adjusted for conflicting child nodes

boolean

Query

org_name
required

organization name associated with the address block

string

Body

body
required

Address block details

AddressBlock

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.66.10. Add Multiple Child Blocks

POST /hierarchy/child_block/add_multi
Description

Creates a new child blocks./rest/hierarchy/child_block/add_multi?org_name=Internal
Below example shows sample request JSON:
{"name":"test","description":"test description","address":"string","mask":0,"parentFullAddress":"10.1.10.0","start":0,"end":0,"isV6":true,"childBlocks":[null],"parentSpace":"Internal Space"}

Parameters
Type Name Description Schema Default

Query

adjust_hierarchy
optional

Specifies if the hierarchy should be adjusted for conflicting child nodes

boolean

Query

org_name
required

organization name associated with the address block

string

Body

body
required

List of blocks

< AddressBlock > array

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.66.11. Update Child Block

POST /hierarchy/child_block/update
Description

Updates an existing child block./rest/hierarchy/child_block/update?org_name=Internal&space=addressSpaceAssociated
Below example shows sample request JSON:
"{"parent":"10.0.1.0/24","address":"10.0.1.0","name":"testChild","description":"","mask":"30","parentSpace":"Address_block1"}"

Parameters
Type Name Description Schema Default

Query

adjust_hierarchy
optional

Specifies if the hierarchy should be adjusted for conflicting child nodes

boolean

Query

org_name
required

organization name associated with the address block

string

Query

space
required

Address space associated with the seed block

string

Body

body
required

Address block details

AddressBlock

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.66.12. Map of Network Hierarchy

GET /hierarchy/map
Description

Returns the hierarchy as a JSON string for the TCPWave IPAM GUI consumption.
The example listed below shows a sample request URL:
/rest/hierarchy/map

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization List

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • application/json

4.66.13. List of Networks at the given node

GET /hierarchy/network/list
Description

Returns the list of networks that are at the given node level.
The example listed below shows a sample request URL:
/rest/hierarchy/network/list?org_name=Internal&space=Internal-Space&address=192.168.0.0

Parameters
Type Name Description Schema Default

Query

address
required

Address of the block

string

Query

org_name
required

organization name associated with the block

string

Query

space
required

Address space name associated with the block

string

Responses
HTTP Code Description Schema

200

successful operation

< string > array

Consumes
  • text/plain

Produces
  • application/json

4.66.14. Address Block

POST /hierarchy/next_free/block
Description

Returns the next free address block./rest/hierarchy/next_free/block?org_name=Internal&mask=10
Below example shows sample request JSON:
{"name":"test","description":"string","address":"string","mask":0,"parentFullAddress":"10.1.10.0","start":0,"end":0,"isV6":true,"childBlocks":[null],"parentSpace":"Internal Space"}

Parameters
Type Name Description Schema Default

Query

mask
required

New mask

integer(int32)

Query

org_name
required

organization name associated with the block

string

Body

body
required

Address block details

AddressBlock

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

4.66.15. Address Block

POST /hierarchy/next_free/block/add
Description

Returns the next free address block./rest/hierarchy/next_free/block/add?org_name=Internal&mask=10&name=name
Below example shows sample request JSON:
{"name":"test","description":"string","address":"string","mask":0,"parentFullAddress":"10.1.10.0","start":0,"end":0,"isV6":true,"childBlocks":[null],"parentSpace":"Internal Space"}

Parameters
Type Name Description Schema Default

Query

mask
required

New mask

integer(int32)

Query

name
required

Name

string

Query

org_name
required

organization name associated with the block

string

Body

body
required

Address block details

AddressBlock

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

4.66.16. List of Address Blocks

POST /hierarchy/next_free/blocklist
Description

Returns the list of address blocks./rest/hierarchy/next_free/blocklist?org_name=Internal&mask=10
Below example shows sample request JSON:
{"name":"string","description":"string","address":"string","mask":0,"parentFullAddress":"10.1.10.0","start":0,"end":0,"isV6":true,"childBlocks":[null],"parentSpace":"Internal Space"}

Parameters
Type Name Description Schema Default

Query

mask
required

New mask

integer(int32)

Query

org_name
required

organization name associated with the block

string

Body

body
required

Address block details

AddressBlock

Responses
HTTP Code Description Schema

200

successful operation

< string > array

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.66.17. List of Address Blocks

POST /hierarchy/next_free/network
Description

Returns the list of address blocks./rest/hierarchy/next_free/network?org_name=Internal&mask=10
Below example shows sample request JSON:
{"name":"test","description":"string","address":"string","mask":0,"parentFullAddress":"10.1.10.0","start":0,"end":0,"isV6":true,"childBlocks":[null],"parentSpace":"Internal Space"}

Parameters
Type Name Description Schema Default

Query

mask
required

New mask

integer(int32)

Query

org_name
required

organization name associated with the block

string

Body

body
required

Address block details

AddressBlock

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

4.66.18. List of Address Blocks

POST /hierarchy/next_free/networklist
Description

Returns the list of address blocks./rest/hierarchy/next_free/split?networklist=Internal&mask=10
Below example shows sample request JSON:
{"name":"test","description":"string","address":"string","mask":0,"parentFullAddress":"10.1.10.0","start":0,"end":0,"isV6":true,"childBlocks":[null],"parentSpace":"Internal Space"}

Parameters
Type Name Description Schema Default

Query

mask
required

New mask

integer(int32)

Query

org_name
required

organization name associated with the block

string

Body

body
required

Address block details

AddressBlock

Responses
HTTP Code Description Schema

200

successful operation

< string > array

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.66.19. Add Address Space

POST /hierarchy/seed_block/add
Description

Creates a new address space.
The example listed below shows a sample request URL:
/rest/hierarchy/seed_block/add?org_name=Internal
Below example shows sample request JSON:
"{"parent":null,"address":"10.0.1.0","name":"child_block_1","description":"","mask":"24","parentSpace":"Address_block1"}"

Parameters
Type Name Description Schema Default

Query

org_name
required

organization name associated with the seed block

string

Body

body
required

Address block details

AddressBlock

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.66.20. Split Seed Block

POST /hierarchy/seed_block/split
Description

Splits the existing seed block./rest/hierarchy/seed_block/split?org_name=Internal&mask=10
Below example shows sample request JSON:
{"name":"seedblock1","description":"string","address":"string","mask":0,"parentFullAddress":"10.1.10.08","start":0,"end":0,"isV6":true,"childBlocks":[null],"parentSpace":"Internal Space"}

Parameters
Type Name Description Schema Default

Query

mask
required

New mask

integer(int32)

Query

org_name
required

organization name associated with the seed block

string

Body

body
required

Address block details

AddressBlock

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.66.21. Update Seed Block

POST /hierarchy/seed_block/update
Description

Updates an existing seed block./rest/hierarchy/seed_block/update?org_name=Internal&space=addressSpaceAssociated
Below example shows sample request JSON:
"{"parent":null,"address":"10.0.1.0","name":"child_block_1","description":"demo","mask":"24","parentSpace":"Address_block1"}"

Parameters
Type Name Description Schema Default

Query

adjust_hierarchy
optional

Specifies if the hierarchy should be adjusted for conflicting child nodes

boolean

Query

org_name
required

organization name associated with the seed block

string

Query

space
required

Address space associated with the seed block

string

Body

body
required

Address block details

AddressBlock

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.67. History Tab Service

Description

This service provides execution history of Specified scheduled job executed in the TCPWave IPAM.

4.67.1. List of Execution History

GET /historytab/historylist
Description

Obtains a list of execution history of Specified scheduled job executed since specified time in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/historytab/historylist?start=1&length=20&organization=Internal

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

id
optional

ID of the schedule job

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organization
required

Organization Name

string

Query

sort
optional

Sort String

string

Query

start
required

Starting IPV4 Network Range

integer(int32)

Query

type
required

Type of the schedule job

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

Consumes
  • text/plain

4.68. Home Service

Description

This service provides alerts and current active sessions summary in the TCPWave IPAM. It also provides audit log data, audit trend data, log messages, license data, widget and chart data in the TCPWave IPAM.

4.68.1. Admin roles information

GET /home/adminRoles
Description

Displays the number of administrators in each Admin role(SADM, FADM, UADM, PADM, RADM).
The example listed below shows a sample request URL:
/rest/home/adminRoles&organization_name=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization List

string

Responses
HTTP Code Description Schema

200

successful operation

< Home > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.2. Get all appliances status

GET /home/applianceStatus
Description

Provides the status of all IPAM components and overall status of DNS and DHCP Appliances in the TCPWave IPAM.
Below example shows sample request JSON:
/rest/home/applianceStatus?server_name=test&ip=1.0.0.8

Parameters
Type Name Description Schema Default

Query

ip
required

string

Query

server_name
required

string

Responses
HTTP Code Description Schema

200

successful operation

< Module > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.3. Audit Logs Data

GET /home/auditLogData
Description

Gets the audit logs data of IPAM appliance.
The example listed below shows a sample request URL:
/rest/home/auditLogData?ip=1.0.0.7&type=DNS/DHCP&server_name=testappliance&argc=&logstart=2020-10-8&logend=2020-10-9

Parameters
Type Name Description Schema Default

Query

argc
required

argc

integer(int32)

Query

filterRules
optional

Filter String

string

Query

ip
required

string

Query

logend
required

Log end Date

string

Query

logstart
required

Log Start Date

string

Query

server_name
required

server name

string

Query

type
required

type

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Log Entry in CEF Format > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.4. Audit Logs

GET /home/auditLogDataNew
Description

Gets the audit logs from TCPWave IPAM appliance.
The example listed below shows a sample request URL:
/rest/home/auditLogDataNew?applianceIp=1.0.0.7&applianceType=DNS/DHCP/IPAM&applianceName=testappliance&argc=0&logstart=2020-10-8&logend=2020-10-9

Parameters
Type Name Description Schema Default

Query

applianceIp
required

Appliances ip

string

Query

applianceName
required

Appliances name

string

Query

applianceType
required

Appliance type

string

Query

argc
required

argc

integer(int32)

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

logend
required

Log end Date

string

Query

logstart
required

Log Start Date

string

Query

q
optional

Search String

string

Query

start
required

Starting IPV4 Network Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Log Entry In CEF Format

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.5. Audit Summary

GET /home/auditSummary
Description

Retrieves the detailed list of information of the recently executed commands in the TCPWave IPAM. NOTE:- This method returns Map with Widget Name as Key and Array List of Objects as Value.

Responses
HTTP Code Description Schema

200

successful operation

Audit Entry

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.6. Network classification

GET /home/classnetworks
Description

Displays the number of networks in each class
The example listed below shows a sample request URL:
/rest/home/classnetworks?organization_name=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization List

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.68.7. Admin roles information

GET /home/cloudProvidersCount
Description

Displays the number of administrators in each Admin role(SADM, FADM, UADM, PADM, RADM).
The example listed below shows a sample request URL:
/rest/home/cloudProvidersCount?organization_name=Internal

Parameters
Type Name Description Schema Default

Query

organization_name
optional

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Home > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.8. Delete alarms

POST /home/deletenotification
Description

Deletes the selected one or more alarms.
Below example shows sample request JSON:
[{"host_address":"192.168.56.100","host_name":"TestAppliance1","host_type":"IPAMServerAlert","category":"IPAM_LICENSE","service":"IPAM_LICENSE"}]

Parameters
Type Name Description Schema Default

Body

body
optional

< Notification Details > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.68.9. Get the details of an IP Address

GET /home/determineIPDetails/{ipAddress}
Description

Provides the details of an IP Address defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/home/determineIPDetails/{ipAddress}

Parameters
Type Name Description Schema Default

Path

ipAddress
required

IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

integer(int32)

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.10. DHCP Appliances classification

GET /home/dhcpcount
Description

Displays the number of primary DHCP Appliances,secondary DHCP Appliances
The example listed below shows a sample request URL:
/rest/home/dhcpcount?organization_name=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization List

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.68.11. DNS tunnel detection data

GET /home/dnsTunnelDetectionData
Description

Fetches the DNS tunnel detection information of an appliance
The example listed below shows a sample request URL:
/rest/home/dnsTunnelDetectionData?ip=1.0.0.8&type=DNS/DHCP

Parameters
Type Name Description Schema Default

Query

ip
required

IP Address of DNS server

string

Query

type
required

Type of DNS server

string

Responses
HTTP Code Description Schema

200

successful operation

< string, string > map

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.12. DNS Servers classification

GET /home/dnscount
Description

Displays the number of Authoritative DNS Appliances,Cache DNS Appliances
The example listed below shows a sample request URL:
/rest/home/dnscount?organization_name=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization List

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.68.13. Export to CSV

GET /home/exporttoptalkerstocsv
Description

The example listed below shows a sample request URL:
/rest/home/exporttoptalkerstocsv?type=DNS/DHCP&ip=1.0.0.3&duration=10

Parameters
Type Name Description Schema Default

Query

duration
required

integer(int32)

Query

ip
required

string

Query

type
required

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.68.14. Export to CSV

GET /home/exportversionstocsv
Description

The example listed below shows a sample request URL:
/rest/home/exportversionstocsv?serverType=DNS/DHCP

Parameters
Type Name Description Schema Default

Query

serverType
required

Type of server (DNS/DHCP)

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.68.15. Get the notifications of appliances status by service name

GET /home/faultMgmt
Description

Provides the notifications of appliances defined in the TCPWave IPAM as CRITICAL/WARNING/OK based on service category.
The example listed below shows a sample request URL:
/rest/home/faultMgmt?server_name=serverNameValue&ip=1.0.0.3&fault_level=2&start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

fault_level
required

Severity Level of Fault

integer(int32)

Query

filterRules
optional

Filter String

string

Query

ip
required

IP Address

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

server_name
required

Server Name

string

Query

server_type
required

Server Type

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Notification Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListHome

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.16. Get the notifications of appliances status by host name

GET /home/faultMgmtHosts
Description

Provides the notifications of appliances defined in the TCPWave IPAM as CRITICAL/WARNING/OK based on the Host Address.
Below example shows sample request JSON:
/rest/home/faultMgmtHosts?server_name=test&ip=1.0.0.8&fault_level=2&server_type=BIND AUTH

Parameters
Type Name Description Schema Default

Query

fault_level
required

Fault Level

integer(int32)

Query

ip
required

IP Address

string

Query

server_name
required

Server Name

string

Query

server_type
required

Server Type

string

Responses
HTTP Code Description Schema

200

successful operation

< Home > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.17. Get Fault Management Service History

GET /home/faultMgmtServiceHistory
Description

Provides the monitoring information of DNS and DHCP appliances defined in the TCPWave IPAM. NOTE:- This method returns Map with Widget Name as Key and Array List of Objects as Value.

Parameters
Type Name Description Schema Default

Query

end_date
required

End Date

string

Query

fault_level
required

Fault level

integer(int32)

Query

id
optional

Server ID

integer(int32)

Query

page_no
required

Number of pages

integer(int32)

Query

page_size
required

Page size

integer(int32)

Query

selectdb
required

Selected Database

integer(int32)

Query

server_name
required

Server Name

string

Query

start_date
required

Start Date

string

Responses
HTTP Code Description Schema

200

successful operation

Home

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.18. Get the notifications of appliances status by service name

GET /home/faultMgmtp
Description

Provides the notifications of appliances defined in the TCPWave IPAM as CRITICAL/WARNING/OK based on service category.
Below example shows sample request JSON:
/rest/home/faultMgmtp?start=1&length=20&server_name=test&ip=1.0.0.8&fault_level=2&server_type=BIND AUTH

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

fault_level
required

Severity Level of Fault

integer(int32)

Query

filterRules
optional

Filter String

string

Query

ip
required

IP Address

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

server_name
required

Server Name

string

Query

server_type
required

Server Type

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Notification Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListHome

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.19. Get AMQ Topics Stats

GET /home/getAMQTopicStats
Description

Get the TIMS message queue statistics. NOTE:- This method returns Map with Widget Name as Key and Array List of Objects as Value.

Parameters
Type Name Description Schema Default

Query

end_date
required

string

Query

page_no
required

integer(int32)

Query

page_size
required

integer(int32)

Query

start_date
required

string

Query

topic_name
required

string

Responses
HTTP Code Description Schema

200

successful operation

IPAMTopicStats

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.20. Get active sessions information

GET /home/getActiveSessions
Description

Provides sessions information on the IPAM server to display on dashboard.
The example listed below shows a sample request URL:
/rest/home/getActiveSessions?page=1&rows=20&start_date=2020-10-12&end_date=2020-10-13

Parameters
Type Name Description Schema Default

Query

end_date
required

ending date

string

Query

page
required

total pages

integer(int32)

Query

rows
required

rows per page

integer(int32)

Query

start_date
required

starting date

string

Responses
HTTP Code Description Schema

200

successful operation

PagedListHome

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.21. Get top ten sessions

GET /home/getActiveSessionsChart
Description

Gets the top ten active sessions for charting the active sessions chart
The example listed below shows a sample request URL:
/rest/home/getActiveSessionsChart?start_date=2020-10-15&end_date=2020-10-16

Parameters
Type Name Description Schema Default

Query

end_date
required

End date

string

Query

start_date
required

Start date

string

Responses
HTTP Code Description Schema

200

successful operation

< Home > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.22. Active Sessions Information Summary

GET /home/getActiveSessionsSnapshotSummary
Description

Gets the summary of top sessions to display on the dashboard.
The example listed below shows a sample request URL:
/rest/home/getActiveSessionsSnapshotSummary

Responses
HTTP Code Description Schema

200

successful operation

< Home > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.23. Active Sessions Summary

GET /home/getActiveSessionsSummary
Description

Provides the summary of all sessions to display on the dashboard.
The example listed below shows a sample request URL:
/rest/home/getActiveSessions?page=1&rows=20&start_date=2020-10-12&end_date=2020-10-13

Parameters
Type Name Description Schema Default

Query

page
required

total Pages

integer(int32)

Query

rows
required

Rows per page

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListHome

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.24. Get Audit Trend Data

GET /home/getAuditTrendData
Description

Gets the commands success/fail information on the IPAM server. NOTE:- This method returns Map with Widget Name as Key and Array List of Objects as Value.

Parameters
Type Name Description Schema Default

Query

date_style
required

date style

string

Query

end_date
required

ending date

string

Query

ipamIpAddress
optional

IPAM IP Address

string

Query

start_date
required

starting date

string

Query

success
required

success param

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

Home

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.25. Get CPU,Memory,Disk Usage

GET /home/getCMDStats
Description

This API provides to get the CPU,Memory,Disk Usage statistics.
Below example shows sample request JSON:
/rest/home/getCMDStats

Responses
HTTP Code Description Schema

200

successful operation

< string, integer(int32) > map

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.26. Get the notifications of appliances status by service name

GET /home/getCurrentAlarms
Description

Provides the notifications of appliances defined in the TCPWave IPAM as CRITICAL/WARNING/OK based on service category.
The example listed below shows a sample request URL:
/rest/home/getCurrentAlarms?server_name=serverNameValue&ip=1.0.0.3&fault_level=2&start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

fault_level
required

Severity Level of Fault

integer(int32)

Query

filterRules
optional

Filter String

string

Query

ip
required

IP Address

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

server_name
required

Server Name

string

Query

server_type
required

Server Type

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Notification Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListMonitoring Service Information

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.27. DHCP Appliance List

GET /home/getDHCPServerList
Description

Displays the monitoring service enabled DHCP Appliances list
The example listed below shows a sample request URL:
/rest/home/getDHCPServerList?orgName=Internal

Parameters
Type Name Description Schema Default

Query

orgName
required

Organization List

string

Responses
HTTP Code Description Schema

200

successful operation

< DNS/DHCP Appliance information > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.28. Get Total DNS traffic

GET /home/getDHCPTafficByServer
Description

This API provides data to display cumulative DNS traffic chart by number of queries per record type and appliance.
Below example shows sample request JSON:
/rest/home/getDHCPTafficByServer

Responses
HTTP Code Description Schema

200

successful operation

< DHCPTrafficChart > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.29. Get Total DHCP traffic

GET /home/getDHCPTraffic
Description

This API provides data to display DHCP traffic trend by number of queries per record type.
Below example shows sample request JSON:
/rest/home/getDHCPTraffic

Responses
HTTP Code Description Schema

200

successful operation

< DHCPTrafficChart > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.30. list of DNS and DHCP Appliances

GET /home/getDNSDHCPServerList
Description

Obtains a list of monitoring enabled DNS and DHCP appliances to display on dashboard.
The example listed below shows a sample request URL:
/rest/home/getDNSDHCPServerList

Responses
HTTP Code Description Schema

200

successful operation

< Home Subnet List Tree > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.31. Server Last Sync Status

GET /home/getDNSLastSync
Description

Displays the monitoring service enabled DNS Appliances list
The example listed below shows a sample request URL:
/rest/home/getDNSLastSync?orgName=Internal&type=DNS/DHCP

Parameters
Type Name Description Schema Default

Query

orgName
required

organization Name

string

Query

type
required

Type of server(DNS/DHCP)

string

Responses
HTTP Code Description Schema

200

successful operation

< Last sync status > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.32. DNS Server List

GET /home/getDNSServerList
Description

Displays the monitoring service enabled DNS Appliances list
The example listed below shows a sample request URL:
/rest/home/getDNSServerList?orgName=Internal

Parameters
Type Name Description Schema Default

Query

orgName
required

Organization List

string

Responses
HTTP Code Description Schema

200

successful operation

< DNS/DHCP Appliance information > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.33. Get IPAM Search Details

GET /home/getIPAMSearchDetails
Description

NOTE:- This method returns Map with Widget Name as Key and Array List of Objects as Value.

Parameters
Type Name Description Schema Default

Query

name
required

Name

string

Query

search
required

search string

string

Responses
HTTP Code Description Schema

200

successful operation

Home

500

No Content

Consumes
  • application/json

  • text/plain

Produces
  • application/json

  • application/xml

4.68.34. Get the IPAM server information

GET /home/getIPAMServerInfo
Description

Provides the IPAM kernel information and uptime of IPAM server.
The example listed below shows a sample request URL:
/rest/home/getIPAMServerInfo

Responses
HTTP Code Description Schema

200

successful operation

< Home > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.35. Get CPU, Memory, Disk Usage and other information.

GET /home/getIPAMSystemInfo
Description

This API provides to get the CPU, Memory, Disk Usage statistics and other information of an IPAM appliance.
Below example shows sample request JSON:
/rest/home/getIPAMSystemInfo

Responses
HTTP Code Description Schema

200

successful operation

string

500

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.68.36. Get IPAM server alerts

GET /home/getIpamAlerts
Description

Provides the list of IPAM appliance monitoring alerts to display on the dashboard.
The example listed below shows a sample request URL:
/rest/home/getIpamAlerts?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

end_date
optional

ending date

string

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting IPV4 Network Range

integer(int32)

Query

start_date
optional

starting date

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListHome

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.37. Get IPAM server alerts Summary

GET /home/getIpamAlertsSummary
Description

Provides the count of TCPWave IPAM events grouped by event type.
The example listed below shows a sample request URL:
/rest/home/getIpamAlertsSummary

Responses
HTTP Code Description Schema

200

successful operation

< Home > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.38. Remote Logs

GET /home/getLogs
Description

Gets the logs related data from IPAM and Remote appliances.
The example listed below shows a sample request URL:
/rest/home/getLogs?applianceIp=1.0.0.8&applianceName=test&applianceType=DNS/DHCP&applianceCode=12&argc=0&start=0&length=20&logstart=2020-10-09&logend=2020-10-10

Parameters
Type Name Description Schema Default

Query

applianceCode
required

Appliance code

string

Query

applianceIp
required

Appliances ip

string

Query

applianceName
required

Appliances name

string

Query

applianceType
required

Appliance type

string

Query

argc
required

argc

integer(int32)

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

logend
required

Log end Date

string

Query

logstart
required

Log Start Date

string

Query

q
optional

Search String

string

Query

start
required

Starting IPV4 Network Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListLogs Information

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.39. DHCP Server List

GET /home/getMSDHCPServerList
Description

Displays the monitoring service enabled DHCP Appliances list
The example listed below shows a sample request URL:
/rest/home/getMSDHCPServerList?orgName=Internal

Parameters
Type Name Description Schema Default

Query

orgName
required

Organization List

string

Responses
HTTP Code Description Schema

200

successful operation

< DNS/DHCP Appliance information > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.40. DNS Server List

GET /home/getMSDNSServerList
Description

Displays the monitoring service enabled DNS Appliances list
The example listed below shows a sample request URL:
/rest/home/getMSDNSServerList?orgName=Internal

Parameters
Type Name Description Schema Default

Query

orgName
required

Organization List

string

Responses
HTTP Code Description Schema

200

successful operation

< DNS/DHCP Appliance information > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.41. Get MySQL charts data

GET /home/getMYSQLCharts
Description

Provides the monitoring statistics of IPAM Database.
The example listed below shows a sample request URL:
/rest/home/getMYSQLCharts?address=1.0.0.7

Parameters
Type Name Description Schema Default

Query

address
required

IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

No Content

Consumes
  • text/plain

Produces
  • text/html

4.68.42. Get mask length list

GET /home/getMaskLength/{name}
Description

Gets the defined mask lengths of networks and subnets.
The example listed below shows a sample request URL:
/rest/home/getMaskLength/networktest

Parameters
Type Name Description Schema Default

Path

name
required

Name (subnet /network/ v6network/ v6subnet)

string

Responses
HTTP Code Description Schema

200

successful operation

< Mask Length > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.43. Gets IPAM Metrics

GET /home/getMetrics
Description

Gets IPAM Metrics such as object distribution, top 10 zones, zone distribution across appliances, critical monitoring engine alerts, IPAM, DNS and DHCP checkouts.
The example listed below shows a sample request URL:
/rest/home/getMetrics

Responses
HTTP Code Description Schema

200

successful operation

string

Produces
  • application/json

  • application/xml

4.68.44. Monitored device statistics

GET /home/getMonitoredDeviceStats
Description

Displays the number of thresholds,current alerts,number of traps sent by the remote server
The example listed below shows a sample request URL:
/rest/home/getMonitoredDeviceStats?type=DNS/DHCP&organizations=Internal

Parameters
Type Name Description Schema Default

Query

draw
optional

Pagination Rendering Parameter

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organization Names

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Service Range

integer(int32)

Query

type
optional

Type of server(DNS/DHCP)

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListMonitored Devices

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.45. Get Information of all Appliances

GET /home/getMonitoringRRDCharts
Description

Provides the information for all appliances load,memory,swap,ping,query,response information to display on the dashboard.
The example listed below shows a sample request URL:
/rest/home/getMonitoringRRDCharts?ip=1.0.0.8&type=DNS/DHCP

Parameters
Type Name Description Schema Default

Query

ip
required

IP Address of DNS/DHCP server

string

Query

type
required

Type of server (DNS/DHCP)

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.46. Get network details by IPAddress

GET /home/getNetworkDetails/{ipAddress}
Description

Provides the details of a Network defined in the TCPWave IPAM based on the IP Address of the Network.
The example listed below shows a sample request URL:
/rest/home/getNetworkDetails/{ipAddress}

Parameters
Type Name Description Schema Default

Path

ipAddress
required

IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

< Network Information > array

500

TIMS-2024: This subnet does not correspond to any of the existing networks.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.47. Get object details by IP Address/Subnet ID

GET /home/getObjectDetails
Description

Provides the details of Object defined in the TCPWave IPAM based on the IP Address of the Object.
The example listed below shows a sample request URL:
/rest/home/getObjectDetails?ipAddress=1.0.0.8

Parameters
Type Name Description Schema Default

Query

ipAddress
required

Object IP Address

string

Query

subnet_id
optional

Subnet ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< TIMS Object > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.48. GET /home/getRRDDNSInd

Description

Displays the number of objects allocated based on the object allocation type in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/home/getRRDDNSInd?type=DNS/DHCP&ip=1.0.0.5&service=CPU/MEMORY/DISK

Parameters
Type Name Description Schema Default

Query

ip
required

IP Address of DNS/DHCP server

string

Query

service
required

Service name(CPU/MEMORY/DISK)

string

Query

type
required

Type of the appliance (DNS/DHCP)

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

No Content

Consumes
  • text/plain

Produces
  • text/html

4.68.49. Get chart data

GET /home/getRRDDNSLoad
Description

Provides the appliance load,memory,swap,ping,query,response information to display on the dashboard.
The example listed below shows a sample request URL:
/rest/home/getRRDDNSLoad?service=CPU/MEMORY/DISK

Parameters
Type Name Description Schema Default

Query

service
required

Service name(CPU/MEMORY/DISK)

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

No Content

Consumes
  • text/plain

Produces
  • text/html

4.68.50. Get the appliance load ,memory and disk charts data

GET /home/getRRdImageLoad
Description

Provides the appliance load, memory and disk usage data to display on the dashboard.
The example listed below shows a sample request URL:
/rest/home/getRRdImageLoad?cpu_check=&mem_check=&disk_check=

Parameters
Type Name Description Schema Default

Query

cpu_check
required

Load chart flag.

string

Query

disk_check
required

Disk chart flag

string

Query

mem_check
required

Memory chart flag

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

No Content

Consumes
  • text/plain

Produces
  • text/html

4.68.51. Get CPU, Memory, Disk Usage and other information.

GET /home/getRemoteSystemInfo
Description

This API provides to get the CPU, Memory, Disk Usage statistics and other information of a DNS/DHCP appliance.
Below example shows sample request JSON:
/rest/home/getRemoteSystemInfo?applianceIP=1.0.0.2&applianceName=test&applianceType=BIND AUTH

Parameters
Type Name Description Schema Default

Query

applianceIP
required

Appliance IP

string

Query

applianceName
required

Appliance Name

string

Query

applianceType
required

Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.68.52. Remote server versions

GET /home/getRemoteVersions
Description

Displays the remote DNS and DHCP server versions
The example listed below shows a sample request URL:
/rest/home/getRemoteVersions?type=DNS/DHCP&organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization List

string

Query

type
required

Type of server(DNS/DHCP)

string

Responses
HTTP Code Description Schema

200

successful operation

< Server Entity Version > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.53. Get server hardware information

GET /home/getServerHardwareInfo
Description

Provides the information regarding the DNS and DHCP appliance hardware defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/home/getServerHardwareInfo?server_type=BIND AUTH&server_id=2

Parameters
Type Name Description Schema Default

Query

server_id
required

Server ID

integer(int32)

Query

server_type
required

Sever type

string

Responses
HTTP Code Description Schema

200

successful operation

< Home > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.54. DNS appliance log paths

GET /home/getServerLogPaths
Description

Gets the DNS appliance log paths information based on appliance IP address and server type.
The example listed below shows a sample request URL:
/rest/home/getServerLogPaths?ip=1.0.0.7&scode=

Parameters
Type Name Description Schema Default

Query

ip
required

Server IP Address

string

Query

scode
required

Server Code

string

Responses
HTTP Code Description Schema

200

successful operation

< Home > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.55. Subnet details by IP Address

GET /home/getSubnetDetails/{ipAddress}
Description

Provides the details of a Subnet defined in the TCPWave IPAM based on the IP Address of the Subnet.
The example listed below shows a sample request URL:
/rest/home/getSubnetDetails/{ipAddress}

Parameters
Type Name Description Schema Default

Path

ipAddress
required

subnet IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

< Subnet Information > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.56. Server Top talker List

GET /home/getToptalkers
Description

Fetches the top talker information of server
The example listed below shows a sample request URL:
/rest/home/getToptalkers?ip=1.0.0.3&type=DNS/DHCP&duration=&table=1

Parameters
Type Name Description Schema Default

Query

duration
required

Duration filter

integer(int32)

Query

ip
required

IP Address of DNS/DHCP server

string

Query

table
required

This value indicates if the request is for grid information or chart. Value 0 indicates chart and value 1 indicates grid.

integer(int32)

Query

type
required

Type of server(DNS/DHCP)

string

Responses
HTTP Code Description Schema

200

successful operation

< Top talker > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.57. Get the IPAM statistics

GET /home/getTotalIPAMStats
Description

Provides the IPAM statistics like number of networks,subnets,objects,zones,servers,scopes,dnssec zones for displaying on the dashboard.
The example listed below shows a sample request URL:
/rest/home/getTotalIPAMStats?organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Comma Separated Organization List

string

Responses
HTTP Code Description Schema

200

successful operation

IPAM statistics

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.58. Get Object Line Chart Data

GET /home/getTotalObjectData
Description

Provides the information related to objects add/delete for displaying on the dashboard. NOTE:- This method returns Map with Widget Name as Key and Array List of Objects as Value.

Parameters
Type Name Description Schema Default

Query

end_date
required

End date

string

Query

organizations
optional

Organization List

string

Query

range
required

string

Query

start_date
required

Start date

string

Responses
HTTP Code Description Schema

200

successful operation

Object Chart

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.59. Get Total DNS traffic

GET /home/getTotalTaffic
Description

This API provides data to display DNS traffic trend by number of queries per record type.
Below example shows sample request JSON:
/rest/home/getTotalTaffic

Responses
HTTP Code Description Schema

200

successful operation

< DNSTotalTrafficChart > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.60. Get Total DNS traffic

GET /home/getTotalTafficByServer
Description

This API provides data to display cumulative DNS traffic chart by number of queries per record type and appliance.
Below example shows sample request JSON:
/rest/home/getTotalTafficByServer

Responses
HTTP Code Description Schema

200

successful operation

< DNSTotalTrafficChart > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.61. Get user last login information

GET /home/getUserLastLogin
Description

Provides the login user information to display on the dashboard.
The example listed below shows a sample request URL:
/rest/home/getUserLastLogin?user_name=sadm

Parameters
Type Name Description Schema Default

Query

user_id
optional

Logged in user id

integer(int32)

Query

user_name
required

Logged in user name

string

Responses
HTTP Code Description Schema

200

successful operation

< Home > array

500

No Content

Consumes
  • text/plain

  • application/json

Produces
  • application/json

  • application/xml

4.68.62. Data about Top ten Zones

GET /home/getZoneDistChart
Description

Gets data related to the top ten zones defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/home/getZoneDistChart?organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Zone Statistics for Charting > array

500

No Content

Consumes
  • text/plain

4.68.63. Get chart data

GET /home/getdhcpgroupedcharts
Description

Provides the appliance load,memory,swap,ping,query,response information to display on the dashboard.
The example listed below shows a sample request URL:
/rest/home/getdhcpgroupedcharts?service=CPU/MEMORY/DISK

Parameters
Type Name Description Schema Default

Query

service
required

Service name(CPU/MEMORY/DISK)

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

No Content

Consumes
  • text/plain

Produces
  • text/html

4.68.64. DHCP scope utilization summary

GET /home/getdhcpscopes
Description

Displays the summary of DHCP scope utilization.
The example listed below shows a sample request URL:
/rest/home/getdhcpscopes?start=1&length=20&orgName=Internal

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter Rules

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

orgName
required

organization Name

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Scope Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListHome Scopes

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.65. Remote server configuration

GET /home/getdnsApplianceSummary
Description

Displays the server configuration settings defined on remote DNS/DHCP server
The example listed below shows a sample request URL:
/rest/home/getdnsApplianceSummary?type=DNS/DHCP&organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization List

string

Query

type
required

Type of server(DNS/DHCP)

string

Responses
HTTP Code Description Schema

200

successful operation

< Server Entity Version > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.66. IPAM configuration list

GET /home/getipamconfiglist
Description

Displays IPAM configuration settings defined in global options
The example listed below shows a sample request URL:
/rest/home/getipamconfiglist

Responses
HTTP Code Description Schema

200

successful operation

< IPAM subcomponents version > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.67. IPAM subcomponents versions

GET /home/getipamsubversion
Description

Displays all IPAM subcomponents versions
The example listed below shows a sample request URL:
/rest/home/getipamsubversion?organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization List

string

Responses
HTTP Code Description Schema

200

successful operation

< IPAM Sub Versions > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.68. Get Long Queries

GET /home/getlongqueries
Description

Fetches the top 10 long DNS queries information on the given DNS appliance.
The example listed below shows a sample request URL:
/rest/home/getlongqueries?ip=1.0.0.8&type=DNS/DHCP

Parameters
Type Name Description Schema Default

Query

ip
required

IP Address of DNS server

string

Query

type
required

Type of DNS server

string

Responses
HTTP Code Description Schema

200

successful operation

< string > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.69. DNS Servers classification

GET /home/getndstats
Description

Displays the number of Authoritative DNS Appliances,Cache DNS Appliances
The example listed below shows a sample request URL:
/rest/home/getndstats?id=17820

Parameters
Type Name Description Schema Default

Query

id
required

Network ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.68.70. Get Suspicious Queries

GET /home/getsuspiciousqueries
Description

Fetches the Suspicious queries information on the given DNS appliance.
The example listed below shows a sample request URL:
/rest/home/getsuspiciousqueries?ip=1.0.0.8&type=DNS/DHCP

Parameters
Type Name Description Schema Default

Query

ip
required

IP Address of DNS server

string

Query

type
required

Type of DNS server

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.68.71. HA IPAM Appliances List

GET /home/haList
Description

Gets the HA IPAM appliances List
The example listed below shows a sample request URL:
/rest/home/haList

Responses
HTTP Code Description Schema

200

successful operation

< HA IPAM > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.72. Get values for health index scores

GET /home/healthindices
Description

Provides the details of services and hosts as CRITICAL/WARNING/OK for displaying health index scores .
Below example shows sample request JSON:
/rest/home/healthindices

Responses
HTTP Code Description Schema

200

successful operation

HealthIndices

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.73. Network heat map

GET /home/heatmapdata
Description

Displays the network heat map
The example listed below shows a sample request URL:
/rest/home/heatmapdata?id=17025&ip=2.0.0.0&nstart=1.0.0.0.0&nend=4.0.0.0&orgName=Internal

Parameters
Type Name Description Schema Default

Query

id
required

Network ID

integer(int32)

Query

ip
required

Network’s IP Address

string

Query

nend
required

Network’s Ending IP

integer(int64)

Query

nstart
required

Network’s starting IP

integer(int64)

Query

orgName
required

Network Organization

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.68.74. HA Configuration status

GET /home/isHAConfigured
Description

Gets the status of HA configuration.
The example listed below shows a sample request URL:
/rest/home/isHAConfigured

Responses
HTTP Code Description Schema

200

successful operation

boolean

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.75. License validation Information

GET /home/licenseExpWarnInfo
Description

Gets the License validation information of IPAM server.
The example listed below shows a sample request URL:
/rest/home/licenseExpWarnInfo

Responses
HTTP Code Description Schema

200

successful operation

< Home > array

500

No Content

Consumes
  • text/plain

4.68.76. Remote Logs

GET /home/logData
Description

Gets the logs related data from IPAM and Remote appliances.
The example listed below shows a sample request URL:
/rest/home/logData?ip=1.0.0.7&type=DNS/DHCP&argc=1&server_name=testappliance&scode=&noOfLine=&logstart=2020-10-12&logend=2020-10-13

Parameters
Type Name Description Schema Default

Query

argc
required

argc

integer(int32)

Query

filterRules
optional

Filter String

string

Query

ip
required

appliances ip

string

Query

logend
required

Log end Date

string

Query

logstart
required

Log Start Date

string

Query

noOfLine
required

line number in logs

integer(int32)

Query

scode
required

input code

string

Query

server_name
required

appliances name

string

Query

type
required

server type

string

Responses
HTTP Code Description Schema

200

successful operation

< Logs Information > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.77. Get the monitoring status

GET /home/monitoringServices
Description

Provides the overall monitoring status of DNS and DHCP appliances defined in the TCPWave IPAM.
Below example shows sample request JSON:
/rest/home/monitoringServices?server_name=test&ip=1.0.0.8

Parameters
Type Name Description Schema Default

Query

ip
optional

IP Address

string

Query

server_name
optional

Server Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Monitoring Details > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.78. Object Allocation

GET /home/objectAlloc
Description

Displays the number of objects allocated based on the object allocation type in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/home/objectAlloc&organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization List

string

Responses
HTTP Code Description Schema

200

successful operation

Object Allocation

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.79. Object Type

GET /home/objectType
Description

Displays the number of objects allocated based on the object type in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/home/objectType&organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization List

string

Responses
HTTP Code Description Schema

200

successful operation

< Object Type Chart > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.80. Object classification

GET /home/objectcount
Description

Displays the number of pingable and non pingable objects
The example listed below shows a sample request URL:
/rest/home/objectcount

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.68.81. Audit Logs Data

GET /home/omreport
Description

Gets the audit logs data of IPAM appliance.
The example listed below shows a sample request URL:
/rest/home/omreport?ip=1.0.0.7&type=DNS/DHCP&server_name=testappliance&scode=&ip=1.0.0.7

Parameters
Type Name Description Schema Default

Query

ip
required

appliances ip

string

Query

scode
required

input code

string

Query

server_name
required

server name

string

Query

type
required

type

string

Responses
HTTP Code Description Schema

200

successful operation

< Logs Information > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.82. PDF Report

GET /home/pdfreport
Description

Provides PDF format for the audit report in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/home/pdfreport?report=&ip=ipaddress&type=DNS/DHCP&duration=

Parameters
Type Name Description Schema Default

Query

duration
optional

integer(int32)

Query

ip
optional

string

Query

report
optional

string

Query

type
optional

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS:1201 Export to PDF failed

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.68.83. Object classification

GET /home/schedjobcount
Description

Displays the scheduled job density
The example listed below shows a sample request URL:
/rest/home/schedjobcount

Responses
HTTP Code Description Schema

200

successful operation

< Home > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.84. Object classification

GET /home/schedjobcountgraph
Description

Displays the scheduled job density chart
The example listed below shows a sample request URL:
/rest/home/schedjobcountgraph?start_time=2020-10-09

Parameters
Type Name Description Schema Default

Query

start_time
required

Start time

string

Responses
HTTP Code Description Schema

200

successful operation

< Home > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.85. Search Admin Group

GET /home/searchlogs
Description

Search all logs in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/home/searchlogs?start=0&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Logs Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListLog

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.86. Remote appliances list

GET /home/serverDetailList
Description

Gets the Remote appliances versions and configuration data.
The example listed below shows a sample request URL:
/rest/home/serverDetailList?type=DNS/DHCP&rows=1&page=2&order=asce

Parameters
Type Name Description Schema Default

Query

filterRules
optional

Filter String

string

Query

order
required

string

Query

page
required

Page Length

integer(int32)

Query

rows
required

Starting Appliance Range

integer(int32)

Query

sort
optional

Sort String

string

Query

type
required

Server type

string

Responses
HTTP Code Description Schema

200

successful operation

PagedListServer Entity Version

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.87. DNS zone allocation chart

GET /home/servertozonecount
Description

Provides report details in grid for Zone Data audit report in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/home/servertozonecount

Responses
HTTP Code Description Schema

200

successful operation

PagedListAudit Report Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.68.88. Subnet classification

GET /home/subnetscount
Description

Displays the number of DHCP enabled and DHCP disabled subnets
The example listed below shows a sample request URL:
/rest/home/subnetscount?organization_name=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization List

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.68.89. Recent Command’s Time

GET /home/subsys
Description

Retrieves time series data of all the recent commands executed in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/home/subsys?argc=1&argv=1&arga=1&ip=10.0.0.5

Parameters
Type Name Description Schema Default

Query

arga
required

arga

string

Query

argc
required

argc

integer(int32)

Query

argv
required

argv

string

Query

ip
required

ip

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.68.90. Full/Underutilized Networks and Subnets

POST /home/top10WidgetData
Description

Get top 10 percentage full and Underutilized Network and Subnet data. 1. widget_name - option can be specified with one of the 4 following names: - networksByPercentFullDiv, networksByFreeSpaceDiv, subnetsByPercentageFullDiv, subnetByFreeSpaceDiv, top10ScopesGrid 2. mask_length - option can be specified with Integers 8-32 except when requested for top10ScopesGrid. 3. widget name - parameter will be the input widget_name you provided. 4. name - parameter will hold either network_name or subnet_name based on the request except when requested for top10ScopesGrid. 5. percentage_full - parameter will provide either the percentage full or underutilized percentage based on the request except when requested for top10ScopesGrid. NOTE:- This method returns Map with Widget Name as Key and Array List of Objects as Value.

Parameters
Type Name Description Schema Default

Body

body
optional

Home

Responses
HTTP Code Description Schema

200

successful operation

Home

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.68.91. Full/Underutilized Networks and Subnets

POST /home/top10v6WidgetData
Description

Get top 10 most utilized and Underutilized IPv6 Networks and Subnets data. 1. widget_name - option can be specified with one of the 4 following names: - v6networksByPercentFullDiv, v6networksByFreeSpaceDiv, v6subnetsByPercentageFullDiv, v6subnetByFreeSpaceDiv, 2. mask_length - option can be specified with Integers 28-64 3. widget name - parameter will be the input widget_name you provided.4.This method returns Map with Widget Name as Key and Array List of Objects as Value.

Parameters
Type Name Description Schema Default

Body

body
optional

Home

Responses
HTTP Code Description Schema

200

successful operation

Home

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.68.92. Zone classification

GET /home/zonecount
Description

Displays the number of forward zones,reverse zones,DNSSEC enabled zones,DNSSEC disabled zones,AD enabled zones,AD disabled zones
The example listed below shows a sample request URL:
/rest/home/zonecount?organization_name=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization List

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.69. Host Naming Policy

Description

This class is used to provide service to Add,Edit,Delete and get List for Host Naming Policies in the TCPWave IPAM.

4.69.1. Host Naming Policy Add

POST /hostnamingpolicy/add
Description

Creates a new host naming policy in the TCPWave IPAM .
Below example shows sample request JSON:
{ "policy_name":"policy","policy_value":"value","policy_type":"Contains","policy_description":"description" }

Parameters
Type Name Description Schema Default

Body

body
required

Host name restriction details

Host Naming Policies

Responses
HTTP Code Description Schema

500

TIMS-11030: Policy Name field cannot be null
TIMS-11031: Policy Value field cannot be null
TIMS-11032: Policy Type field cannot be null
TIMS-9706: Policy Name: {0} already exists

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.69.2. Host Name Restriction

GET /hostnamingpolicy/checkPolicy
Description

Restricts the Host name based on the Policies in the TCPWave IPAM. If the return value is greater than zero then the name is restricted. If the return value is zero then the name is a valid hostname. It returns zero if the global policy is set to 'No'.
The example listed below shows a sample request URL:
/rest/hostnamingpolicy/checkPolicy?name=test

Parameters
Type Name Description Schema Default

Query

name
required

Name of hostname restriction

string

Responses
HTTP Code Description Schema

200

successful operation

integer(int32)

500

TIMS-3005: Object name is null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.69.3. Host Naming Policy delete

POST /hostnamingpolicy/delete
Description

Delete the selected Host Naming policies from the TCPWave IPAM.
Below example shows sample request JSON:

Parameters
Type Name Description Schema Default

Body

body
required

List of hostname restrictions to be deleted

< Host Naming Policies > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

4.69.4. Host Naming Policy Edit

POST /hostnamingpolicy/edit
Description

Creates a new host naming policy in the TCPWave IPAM .
Below example shows sample request JSON:
{ "old_policy_name":"policy","policy_name":"policy1","policy_type":"Contains","policy_value":"value","policy_description":"description" }

Parameters
Type Name Description Schema Default

Body

body
required

Hostnaming policy object

Host Naming Policies

Responses
HTTP Code Description Schema

500

TIMS-9707: Policy Name: {0} does not exist
TIMS-9706: Policy Name: {0} already exists,

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.69.5. Host Name Policy Name Get

GET /hostnamingpolicy/getdetails
Description

Gets the details of the Host Name Policy.
The example listed below shows a sample request URL:
/rest/hostnamingpolicy/getdetails?name=test

Parameters
Type Name Description Schema Default

Query

name
required

Host name restriction name

string

Responses
HTTP Code Description Schema

200

successful operation

Host Naming Policies

500

An exception has occurred while checking policies.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.69.6. Host Naming policies List

GET /hostnamingpolicy/list
Description

Obtains a list of Host Naming Policies available in the IPAM.
The example listed below shows a sample request URL:
/rest/hostnamingpolicy/list

Responses
HTTP Code Description Schema

200

successful operation

< Host Naming Policies > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.70. IPAM Appliance Service

Description

This service provides API's to get list of IPAM Appliances present in the TCPWave Cluster, "

4.70.1. Create IPAM Appliance

POST /ipamAppliance/create
Description

Create the IPAM appliance
Below example shows sample request JSON:
{"v4_ipaddress":"192.168.0.54","name":"Test-IPAM","appliance_template_id":null,"description":"This is a test IPAM appliance.","nicsConfig":{"nics":"[]","syncStatus":0},"appliance_template":"","rtTablesJson":"[]","ipamTemplate":{"banner":"This is a Production Server. All actions are audited. Please do not make any unauthorized changes.","banner_color":"red","applianceType":"Production","ntpConfig":"10.253.10.253","snmpConfig":"{"sendToThirdParty":"yes","trapSink1":"10.1.10.1","trapSink2":"10.1.10.2","communityString":"sph1nkx5","systemLocation":"","systemContact":"","processes":"ntpd-1/sshd-1/de-1/cli-1/search-1/tims-1/timsscheduler-1/mysql-1"}","enableSNMPv3":false,"dnsResolverConfig":"{"ns1":"10.0.0.4","ns2":"","ns3":"","ns4":"","search1":"","search2":"","search3":"","search4":"","search5":"","search6":""}","tacacsConfig":"{"appliance":"10.1.10.174","enable":false,"pass_key":"abc123"}","rootConfig":"","idracConfig":"{"enable":false,"address":"","snmp_community_string":"","password":""}","sysLogNgConfig":{"globalOptions":"{"timewaitdead":"70","timetoidle":"78","messagetoBuffer":"60","twstatic":"600","noofMsg":"1000","maxSize":"65536","logtime":"true"}","sourcesData":[{"name":"s_sys","allSources":[{"type":"internal","filePath":null,"fileName":null,"address":null,"port":null,"protocol":null},{"type":"system","filePath":null,"fileName":null,"address":null,"port":null,"protocol":null}],"sourceTypes":"internal, system"}],"filtersData":[{"name":"f_default","condition":"level(info..emerg) and not (facility(mail) or facility(authpriv) or facility(cron))","category":"complex"}],"destinationData":[{"name":"d_mesg","typeSNG":"File","logDestGivenValSNG":"/var/log/messages","syncAfterEachMsg":false}],"targetsData":[{"source":"s_sys","logdestination":"d_mesg","filter":"f_default"}]},"systemResources":"{"for_1min":"4","for_5min":"2","for_user":"70","for_system":"30","for_wait":"20","system_memory_usage":"75"}"}}

Parameters
Type Name Description Schema Default

Body

body
required

IPAM Appliance Details

IPAMAppliance

Responses
HTTP Code Description Schema

500

TIMS-1104: Both Target name and id cannot be null.TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.70.2. Appliance Debug Setting

GET /ipamAppliance/debug-setting
Description

Debugs the existing appliance setting.Changes debug log level to Enable/Disable Remote Debugging in IPAM appliances.
The example listed below shows a sample request URL:
/rest/ipamappliance/debug-setting?address=1.0.0.5&debugPref=

Parameters
Type Name Description Schema Default

Query

address
required

Server IP Address

string

Query

debugPref
required

Debug preference

string

Responses
HTTP Code Description Schema

500

TIMS-3088: Appliance IP address is null

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.70.3. IPAM Appliance delete

POST /ipamAppliance/delete
Description

Delete the IPAM appliance by giving id or address.
Below example shows sample request JSON:
{"id":121,"address":"192.168.0.135","v4_address":"192.168.0.135"}

Parameters
Type Name Description Schema Default

Body

body
required

Appliance details

Appliance Information

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.70.4. IPAM Template List

GET /ipamAppliance/get
Description

Provides the list of IPAM Templates
The example listed below shows a sample request URL:
/rest/ipamappliance/get?id=1&address=1.0.0.3

Parameters
Type Name Description Schema Default

Query

address
required

Appliance Address

string

Query

id
optional

Appliance ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

IPAMAppliance

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.70.5. GET Appliance Name

GET /ipamAppliance/getApplianceName
Description

Provides the IPAM name for the given IP address in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/ipamappliance/getApplianceName?address=1.0.0.3

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3091: Appliance does not exist.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.70.6. Configured type either HA or DR

GET /ipamAppliance/getConfiguredType
Description

GET the Configured type.
The example listed below shows a sample request URL:
/rest/ipamappliance/getConfiguredType

Responses
HTTP Code Description Schema

200

successful operation

string

4.70.7. Localhost IP address

GET /ipamAppliance/getLocalhostIP
Description

GET the localhost IP address.
The example listed below shows a sample request URL:
/rest/ipamappliance/getLocalhostIP

Responses
HTTP Code Description Schema

200

successful operation

string

4.70.8. Object Details

GET /ipamAppliance/getObjectDetails
Description

Get the object details.
The example listed below shows a sample request URL:
/rest/ipamappliance/getObjectDetails?address=1.0.0.3

Parameters
Type Name Description Schema Default

Query

address
required

Object Address

string

Responses
HTTP Code Description Schema

200

successful operation

< TIMS Object > array

500

TIMS-3010: Object does not exist.TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.70.9. Get number of Processors

GET /ipamAppliance/getProcessorsCount
Description

Provides the number of processors for the given Appliance IP address in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/ipamappliance/getProcessorsCount?address=1.0.0.3

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3091: Appliance does not exist.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.70.10. Get root access management details. The example listed below shows a sample request URL: /rest/ipamappliance/getRootAccessDtls

GET /ipamAppliance/getRootAccessDtls
Responses
HTTP Code Description Schema

200

successful operation

string

4.70.11. IPAM Appliance Services Status

POST /ipamAppliance/getStatus
Description

Method to get services status of IPAM Appliances.

Parameters
Type Name Description Schema Default

Body

body
required

List of IPAM appliances and their services

< IPAMServices > array

Responses
HTTP Code Description Schema

200

successful operation

< IPAMServices > array

500

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.70.12. Appliance Status GET

GET /ipamAppliance/getSyncStatus
Description

Provides the details of sync information for the given Appliance in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/ipamappliance/getSyncStatus&address=1.0.0.3

Parameters
Type Name Description Schema Default

Query

address
required

Server IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

Appliance Synchronization Status

500

TIMS-3091: Appliance does not exist.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.70.13. Get Live IPAM Traffic

GET /ipamAppliance/ipamtraffic
Description

Gets live IPAM traffic for the selected TCPWave IPAM appliance.
The example listed below shows a sample request URL:
/rest/ipamappliance/ipamtraffic&server_name=test&server_ip=1.0.0.3&argc=0

Parameters
Type Name Description Schema Default

Query

argc
required

argc

integer(int32)

Query

server_ip
required

IPAM appliance IP address

string

Query

server_name
required

IPAM appliance Name

string

Responses
HTTP Code Description Schema

200

successful operation

< IPAMApplianceTrafficData > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.70.14. IPAM Appliance List

GET /ipamAppliance/list
Description

Obtain a List of all the IPAM Appliances defined in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organization Names

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting IPAM Appliance Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListIPAMAppliance

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.70.15. Manage Appliance Services

POST /ipamAppliance/manage
Description

Method to Start/Stop/Restart services on Remote Appliance.
Below example shows sample request JSON:
{"appliances":"[{"name":"COMMONDEVELOPERIPAM","v4_ipaddress":"10.1.10.240","v6_ipaddress":null,"organization_id":null,"organization_name":null,"ntp":"Active","ssh":"Active","snmp":"Active","cron":"Active","cli":"Active","mysql":"Active","tims":"Active","timsmonitor":null,"timsscheduler":"Active","dbreplicator":"Active","search":"Active","de":"Active","iptables":"Inactive"}]","operation":"start","services":"ntpd,sshd,snmpd,cliserver","operationMethod":"sequential"}

Parameters
Type Name Description Schema Default

Body

body
required

List of IPAM appliances and their services

IPAMServicesInfo

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.70.16. Get object associated organizations list

GET /ipamAppliance/objectAssociatedOrgList
Description

Provides the object associated organizations list for the given Appliance IP address in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/ipamappliance/objectAssociatedOrgList?address=1.0.0.3

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

< TIMS Object > array

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.70.17. IPAM Appliance Search

GET /ipamAppliance/search
Description

Searches for a given IPAM appliance in the TCPWave IPAM with giving input string.
The example listed below shows a sample request URL:
/rest/ipamappliance/search&start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organization list

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Template Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListIPAMAppliance

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.70.18. POST /ipamAppliance/syncAll

Parameters
Type Name Description Schema Default

Body

body
required

List of IPAM appliances

< IPAMAppliance > array

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.70.19. Update IPAM Appliance

POST /ipamAppliance/update
Description

Update the IPAM appliance
Below example shows sample request JSON:
{"v4_ipaddress":"192.168.0.54","name":"Test-IPAM","appliance_template_id":null,"description":"This is a test IPAM appliance.","nicsConfig":{"nics":"[]","syncStatus":"0"},"mgmtIP":"192.168.0.54","appliance_template":"","rtTablesJson":"[]","ipamTemplate":{"banner":"This is a Development Server. All actions are audited. Please do not make any unauthorized changes.","banner_color":"green","applianceType":"Development","ntpConfig":"172.16.172.253","snmpConfig":"{"sendToThirdParty":"yes","trapSink1":"10.1.10.1","trapSink2":"10.1.10.2","communityString":"sph1nkx5","systemLocation":"","systemContact":"","processes":"ntpd-1/sshd-1/de-1/cli-1/search-1/tims-1/timsscheduler-1/mysql-1"}","enableSNMPv3":false,"dnsResolverConfig":"{"ns1":"10.0.0.3","ns2":"","ns3":"","ns4":"","search1":"","search2":"","search3":"","search4":"","search5":"","search6":""}","tacacsConfig":"{"appliance":"10.1.10.174","enable":false,"pass_key":"abc123"}","rootConfig":"","idracConfig":"{"enable":false,"address":"","snmp_community_string":"","password":""}","sysLogNgConfig":{"globalOptions":"{"timewaitdead":"70","timetoidle":"78","messagetoBuffer":"60","twstatic":"600","noofMsg":"1000","maxSize":"65536","logtime":"true"}","sourcesData":[{"name":"s_sys","allSources":[{"type":"internal","filePath":null,"fileName":null,"address":null,"port":null,"protocol":null},{"type":"system","filePath":null,"fileName":null,"address":null,"port":null,"protocol":null}],"sourceTypes":"internal, system"}],"filtersData":[{"name":"f_kernel","condition":"facility(kern)","category":"complex"},{"name":"f_default","condition":"level(info..emerg) and not (facility(mail) or facility(authpriv) or facility(cron))","category":"complex"},{"name":"f_auth","condition":"facility(authpriv)","category":"complex"},{"name":"f_mail","condition":"facility(mail)","category":"complex"},{"name":"f_emergency","condition":"level(emerg)","category":"complex"},{"name":"f_news","condition":"facility(uucp) or (facility(news) and level(crit..emerg))","category":"complex"},{"name":"f_boot","condition":"facility(local7)","category":"complex"},{"name":"f_cron","condition":"facility(cron)","category":"complex"}],"destinationData":[{"name":"d_cons","typeSNG":"File","logDestGivenValSNG":"/dev/console","syncAfterEachMsg":false},{"name":"d_mesg","typeSNG":"File","logDestGivenValSNG":"/var/log/messages","syncAfterEachMsg":false},{"name":"d_auth","typeSNG":"File","logDestGivenValSNG":"/var/log/secure","syncAfterEachMsg":false},{"name":"d_mail","typeSNG":"File","logDestGivenValSNG":"/var/log/maillog","syncAfterEachMsg":false},{"name":"d_spol","typeSNG":"File","logDestGivenValSNG":"/var/log/spooler","syncAfterEachMsg":false},{"name":"d_boot","typeSNG":"File","logDestGivenValSNG":"/var/log/boot.log","syncAfterEachMsg":false},{"name":"d_cron","typeSNG":"File","logDestGivenValSNG":"/var/log/cron","syncAfterEachMsg":false},{"name":"d_kern","typeSNG":"File","logDestGivenValSNG":"/var/log/kern","syncAfterEachMsg":false},{"name":"d_mlal","typeSNG":"LoggedUsers","logDestGivenValSNG":"*","syncAfterEachMsg":false}],"targetsData":[{"source":"s_sys","logdestination":"d_kern","filter":"f_kernel"},{"source":"s_sys","logdestination":"d_mesg","filter":"f_default"},{"source":"s_sys","logdestination":"d_auth","filter":"f_auth"},{"source":"s_sys","logdestination":"d_mail","filter":"f_mail"},{"source":"s_sys","logdestination":"d_mlal","filter":"f_emergency"},{"source":"s_sys","logdestination":"d_spol","filter":"f_news"},{"source":"s_sys","logdestination":"d_boot","filter":"f_boot"},{"source":"s_sys","logdestination":"d_cron","filter":"f_cron"}]},"systemResources":"{"for_1min":"4","for_5min":"2","for_user":"70","for_system":"30","for_wait":"20","system_memory_usage":"75"}"}}}

Parameters
Type Name Description Schema Default

Body

body
required

IPAM Appliance Details

IPAMAppliance

Responses
HTTP Code Description Schema

500

TIMS-1104: Both Target name and id cannot be null.TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.70.20. Create IPAM Appliance

POST /v6ipamAppliance/create
Description

Create the IPAM appliance
Below example shows sample request JSON:
{"v4_ipaddress":"192.168.0.54","name":"Test-IPAM","appliance_template_id":null,"description":"This is a test IPAM appliance.","nicsConfig":{"nics":"[]","syncStatus":0},"appliance_template":"","rtTablesJson":"[]","ipamTemplate":{"banner":"This is a Production Server. All actions are audited. Please do not make any unauthorized changes.","banner_color":"red","applianceType":"Production","ntpConfig":"10.253.10.253","snmpConfig":"{"sendToThirdParty":"yes","trapSink1":"10.1.10.1","trapSink2":"10.1.10.2","communityString":"sph1nkx5","systemLocation":"","systemContact":"","processes":"ntpd-1/sshd-1/de-1/cli-1/search-1/tims-1/timsscheduler-1/mysql-1"}","enableSNMPv3":false,"dnsResolverConfig":"{"ns1":"10.0.0.4","ns2":"","ns3":"","ns4":"","search1":"","search2":"","search3":"","search4":"","search5":"","search6":""}","tacacsConfig":"{"appliance":"10.1.10.174","enable":false,"pass_key":"abc123"}","rootConfig":"","idracConfig":"{"enable":false,"address":"","snmp_community_string":"","password":""}","sysLogNgConfig":{"globalOptions":"{"timewaitdead":"70","timetoidle":"78","messagetoBuffer":"60","twstatic":"600","noofMsg":"1000","maxSize":"65536","logtime":"true"}","sourcesData":[{"name":"s_sys","allSources":[{"type":"internal","filePath":null,"fileName":null,"address":null,"port":null,"protocol":null},{"type":"system","filePath":null,"fileName":null,"address":null,"port":null,"protocol":null}],"sourceTypes":"internal, system"}],"filtersData":[{"name":"f_default","condition":"level(info..emerg) and not (facility(mail) or facility(authpriv) or facility(cron))","category":"complex"}],"destinationData":[{"name":"d_mesg","typeSNG":"File","logDestGivenValSNG":"/var/log/messages","syncAfterEachMsg":false}],"targetsData":[{"source":"s_sys","logdestination":"d_mesg","filter":"f_default"}]},"systemResources":"{"for_1min":"4","for_5min":"2","for_user":"70","for_system":"30","for_wait":"20","system_memory_usage":"75"}"}}

Parameters
Type Name Description Schema Default

Body

body
required

IPAM Appliance Details

V6IPAMAppliance

Responses
HTTP Code Description Schema

500

TIMS-1104: Both Target name and id cannot be null.TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.70.21. IPAM Appliance delete

POST /v6ipamAppliance/delete
Description

Delete the IPAM appliance by giving id or address.
Below example shows sample request JSON:
{"id":121,"address":"9000::2","v4_address":"9000::2"}

Parameters
Type Name Description Schema Default

Body

body
required

Appliance Delete

Appliance Information

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.70.22. IPv6 IPAM Template List

GET /v6ipamAppliance/get
Description

Provides the list of IPv6 IPAM Templates
The example listed below shows a sample request URL:
/rest/v6ipamappliance/get?id=1&address=1.0.0.3

Parameters
Type Name Description Schema Default

Query

address
required

Appliance Address

string

Query

id
optional

Appliance ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

V6IPAMAppliance

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.70.23. Configured type either HA or DR

GET /v6ipamAppliance/getConfiguredType
Description

GET the Configured type.
The example listed below shows a sample request URL:
/rest/ipamappliance/getConfiguredType

Responses
HTTP Code Description Schema

200

successful operation

string

4.70.24. Localhost IP address

GET /v6ipamAppliance/getLocalhostIP
Description

GET the localhost IP address.
The example listed below shows a sample request URL:
/rest/ipamappliance/getLocalhostIP

Responses
HTTP Code Description Schema

200

successful operation

string

4.70.25. Object Details

GET /v6ipamAppliance/getObjectDetails
Description

Get the object details.
The example listed below shows a sample request URL:
/rest/v6ipamappliance/getObjectDetails?address=5000::

Parameters
Type Name Description Schema Default

Query

address
required

Object Address

string

Responses
HTTP Code Description Schema

200

successful operation

< IPv6 object > array

500

TIMS-3010: Object does not exist.TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.70.26. Appliance Status GET

GET /v6ipamAppliance/getSyncStatus
Description

Provides the details of sync information for the given Appliance in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/ipamappliance/getSyncStatus&address=4000::1

Parameters
Type Name Description Schema Default

Query

address
required

Server IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

Appliance Synchronization Status

500

TIMS-3091: Appliance does not exist.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.70.27. Get Live IPAM Traffic

GET /v6ipamAppliance/ipamtraffic
Description

Gets live IPAM traffic for the selected TCPWave IPAM appliance.
The example listed below shows a sample request URL:
/rest/ipamappliance/ipamtraffic&server_name=test&server_ip=1.0.0.3&argc=0

Parameters
Type Name Description Schema Default

Query

argc
required

argc

integer(int32)

Query

server_ip
required

IPAM appliance IP address

string

Query

server_name
required

IPAM appliance Name

string

Responses
HTTP Code Description Schema

200

successful operation

< IPAMApplianceTrafficData > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.70.28. IPAM Appliance List

GET /v6ipamAppliance/list
Description

Obtain a List of all the IPV6 IPAM Appliances defined in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organization Names

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting IPAM Appliance Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListV6IPAMAppliance

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.70.29. Manage Appliance Services

POST /v6ipamAppliance/manage
Description

Method to Start/Stop/Restart services on Remote Appliance.
Below example shows sample request JSON:
{"appliances":"[{"name":"COMMONDEVELOPERIPAM","v6_ipaddress":"2000:1::","v4_ipaddress":null,"organization_id":null,"organization_name":null,"ntp":"Active","ssh":"Active","snmp":"Active","cron":"Active","cli":"Active","mysql":"Active","tims":"Active","timsmonitor":null,"timsscheduler":"Active","dbreplicator":"Active","search":"Active","de":"Active","iptables":"Inactive"}]","operation":"start","services":"ntpd,sshd,snmpd,cliserver","operationMethod":"sequential"}

Parameters
Type Name Description Schema Default

Body

body
required

List of IPAM appliances and their services

V6IPAMServicesInfo

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.70.30. Get object associated organizations list

GET /v6ipamAppliance/objectAssociatedOrgList
Description

Provides the object associated organizations list for the given Appliance IP address in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/v6ipamappliance/objectAssociatedOrgList?address=1.0.0.3

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

< IPv6 object > array

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.70.31. IPv6 IPAM Appliance Search

GET /v6ipamAppliance/search
Description

Searches for a given IPv6 IPAM appliance in the TCPWave IPAM with giving input string.
The example listed below shows a sample request URL:
/rest/v6ipamappliance/search&start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organization list

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Template Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListV6IPAMAppliance

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.70.32. POST /v6ipamAppliance/syncAll

Parameters
Type Name Description Schema Default

Body

body
required

List of IPAM appliances

< V6IPAMAppliance > array

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.70.33. Update IPAM Appliance

POST /v6ipamAppliance/update
Description

Update the IPAM appliance
Below example shows sample request JSON:
{"v4_ipaddress":"192.168.0.54","name":"Test-IPAM","appliance_template_id":null,"description":"This is a test IPAM appliance.","nicsConfig":{"nics":"[]","syncStatus":"0"},"mgmtIP":"192.168.0.54","appliance_template":"","rtTablesJson":"[]","ipamTemplate":{"banner":"This is a Development Server. All actions are audited. Please do not make any unauthorized changes.","banner_color":"green","applianceType":"Development","ntpConfig":"172.16.172.253","snmpConfig":"{"sendToThirdParty":"yes","trapSink1":"10.1.10.1","trapSink2":"10.1.10.2","communityString":"sph1nkx5","systemLocation":"","systemContact":"","processes":"ntpd-1/sshd-1/de-1/cli-1/search-1/tims-1/timsscheduler-1/mysql-1"}","enableSNMPv3":false,"dnsResolverConfig":"{"ns1":"10.0.0.3","ns2":"","ns3":"","ns4":"","search1":"","search2":"","search3":"","search4":"","search5":"","search6":""}","tacacsConfig":"{"appliance":"10.1.10.174","enable":false,"pass_key":"abc123"}","rootConfig":"","idracConfig":"{"enable":false,"address":"","snmp_community_string":"","password":""}","sysLogNgConfig":{"globalOptions":"{"timewaitdead":"70","timetoidle":"78","messagetoBuffer":"60","twstatic":"600","noofMsg":"1000","maxSize":"65536","logtime":"true"}","sourcesData":[{"name":"s_sys","allSources":[{"type":"internal","filePath":null,"fileName":null,"address":null,"port":null,"protocol":null},{"type":"system","filePath":null,"fileName":null,"address":null,"port":null,"protocol":null}],"sourceTypes":"internal, system"}],"filtersData":[{"name":"f_kernel","condition":"facility(kern)","category":"complex"},{"name":"f_default","condition":"level(info..emerg) and not (facility(mail) or facility(authpriv) or facility(cron))","category":"complex"},{"name":"f_auth","condition":"facility(authpriv)","category":"complex"},{"name":"f_mail","condition":"facility(mail)","category":"complex"},{"name":"f_emergency","condition":"level(emerg)","category":"complex"},{"name":"f_news","condition":"facility(uucp) or (facility(news) and level(crit..emerg))","category":"complex"},{"name":"f_boot","condition":"facility(local7)","category":"complex"},{"name":"f_cron","condition":"facility(cron)","category":"complex"}],"destinationData":[{"name":"d_cons","typeSNG":"File","logDestGivenValSNG":"/dev/console","syncAfterEachMsg":false},{"name":"d_mesg","typeSNG":"File","logDestGivenValSNG":"/var/log/messages","syncAfterEachMsg":false},{"name":"d_auth","typeSNG":"File","logDestGivenValSNG":"/var/log/secure","syncAfterEachMsg":false},{"name":"d_mail","typeSNG":"File","logDestGivenValSNG":"/var/log/maillog","syncAfterEachMsg":false},{"name":"d_spol","typeSNG":"File","logDestGivenValSNG":"/var/log/spooler","syncAfterEachMsg":false},{"name":"d_boot","typeSNG":"File","logDestGivenValSNG":"/var/log/boot.log","syncAfterEachMsg":false},{"name":"d_cron","typeSNG":"File","logDestGivenValSNG":"/var/log/cron","syncAfterEachMsg":false},{"name":"d_kern","typeSNG":"File","logDestGivenValSNG":"/var/log/kern","syncAfterEachMsg":false},{"name":"d_mlal","typeSNG":"LoggedUsers","logDestGivenValSNG":"*","syncAfterEachMsg":false}],"targetsData":[{"source":"s_sys","logdestination":"d_kern","filter":"f_kernel"},{"source":"s_sys","logdestination":"d_mesg","filter":"f_default"},{"source":"s_sys","logdestination":"d_auth","filter":"f_auth"},{"source":"s_sys","logdestination":"d_mail","filter":"f_mail"},{"source":"s_sys","logdestination":"d_mlal","filter":"f_emergency"},{"source":"s_sys","logdestination":"d_spol","filter":"f_news"},{"source":"s_sys","logdestination":"d_boot","filter":"f_boot"},{"source":"s_sys","logdestination":"d_cron","filter":"f_cron"}]},"systemResources":"{"for_1min":"4","for_5min":"2","for_user":"70","for_system":"30","for_wait":"20","system_memory_usage":"75"}"}}}

Parameters
Type Name Description Schema Default

Body

body
required

IPAM Appliance Details

V6IPAMAppliance

Responses
HTTP Code Description Schema

500

TIMS-1104: Both Target name and id cannot be null.TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.71. IPAM Template Service

Description

This service provides API's to get list of IPAM Templates present in the TCPWave IPAM, add Templates, update Templates, delete Templates.

4.71.1. IPAM Template List

GET /IPAMTemplate/get
Description

Provides the list of IPAM Templates
The example listed below shows a sample request URL:
/rest/IPAMTemplate/get

Responses
HTTP Code Description Schema

200

successful operation

IPAMTemplate

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.72. IPAM Version Service

Description

This service provides version information related to Servers in the TCPWave IPAM.

4.72.1. Get IPAM server version information

GET /ipam/version
Description

Gets IPAM server version information. Version information includes MajorVersion, BuildString, PatchLevel, MinorVersion, ServerType
The example listed below shows a sample request URL:
/rest/ipam/version

Responses
HTTP Code Description Schema

200

successful operation

IPAMVersion

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.73. IPV6 Block Service

4.73.1. Add IPv6 Block

POST /ipv6block/add
Description

Creates a new IPv6 Block in TCPWave IPAM. It checks if it is overlapping with any existing block or not.
Below example shows sample request JSON:
{ "address":"5000::", "mask_length":"48", "name":"tcpwave-block", "description":"", "zoneTemplateId":null, "dmzVisible":"yes", "dnssec_enable":"yes", "nsec_option":"NSEC3", "serialFormat":"DATE", "zoneTemplateName":null, "percentageFull":90, "email_check":0, "snmp_check":0, "log_check":0, "rrs":[], "created_by":"2189", "organization_name":"QAOrg" }

Parameters
Type Name Description Schema Default

Body

body
required

IPV6 Block details

IPv6 Network Details

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist, TIMS-1020: Both Organization name and id cannot be null, TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.73.2. Delete IPV6 Block

POST /ipv6block/delete
Description

Deletes the specified IPV6 Block present in the TCPWave IPAM . Functional Admin can delete networks belonging to any organization. Rest of the admins can delete networks belonging to their organization only.
Below example shows sample request JSON:
{ "address":"5000::","ipv6FullAddress":"50000000000000000000000000000000","organization_name":"QAOrg"}

Parameters
Type Name Description Schema Default

Body

body
required

IPv6 block details

IPv6 Network Details

Responses
HTTP Code Description Schema

500

TIMS-2008 - Both Block address and id cannot be null.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.73.3. Update IPv6 Block

POST /ipv6block/edit
Description

Updates the existing IPv6 Block details in the TCPWave IPAM. These actions are audited.
Below example shows sample request JSON:
{ "address":"5000::","mask_length":null,"name":"tcpwave-block","description":"test","zoneTemplateId":null,"dmzVisible":"yes","dnssec_enable":"yes","nsec_option":"NSEC","serialFormat":"DATE","zoneTemplateName":null,"percentageFull":90,"email_check":0,"snmp_check":0,"log_check":0,"rrs":[{"domain_id":150328,"owner":"tcp.test.com","ttl":"1200","rrclass":"IN","rrtype":"PTR","data":"5000::1","description":"","name":"tcp"}],"oldName":"tcpwave-block","organization_name":"QAOrg","ipv6FullAddress":"50000000000000000000000000000000" }

Parameters
Type Name Description Schema Default

Body

body
required

IPv6 block details

IPv6 Network Details

Responses
HTTP Code Description Schema

500

TIMS-2008 - Both Block address and id cannot be null. TIMS-7003 - You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.73.4. IPv6 Block list

GET /ipv6block/paged
Description

Lists all the IPv6 Blocks available in the TCPWave IPAM. Functional Admin gets the list of all Blocks.Rest of the Admins get only the list of networks to the organization that they belong to.

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

block_addr
optional

Network Address

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Order parameter

string

Query

org_name
optional

Comma Separated Organization Names

string

Query

pool_addr
required

Network Address

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting IPV6 Block Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListIPv6 Network Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.73.5. Search IPv6 Blocks

GET /ipv6block/search
Description

Searches for all IPv6 blocks available in the TCPWave IPAM . The results can be seen on the search screen of the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Query

organizations
required

Organization List

string

Query

page
required

Page

integer(int32)

Query

rows
required

Rows

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListIPv6 Network Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.74. IPV6 DHCP Appliance Service

Description

This service class provides REST API access to Add,Edit and delete DHCPv6 Appliances into the TCPWave IPAM.

4.74.1. Add IPv6 DHCP Appliance

POST /v6dhcpserver/add
Description

Creates an IPv6 DHCP Appliance in the TCPWave IPAM. The user will have the ability to define and configure Time Zone, Banner, NTP, SNMP, Tacacs, Syslog-ng and MAC Exclusions to it .
Below example shows sample request JSON:
{ "server": {"banner": "Test Banner","dhcp_policy_template_name": "policy-temp","monitoringService": "yes","domain_name": "test.com","ntpConfig": "10.1.10.15","option": "no","organization_name": "QAOrg","resolverData": "ns1":"10.1.10.16","server_type": "DHCP","serverPreference": "Primary","snmpConfig": { "trapSink1": "10.1.10.17", "trapSink2": "10.1.10.18", "communityString": "public", "systemName": "test-dhcp-server.test.com", "processes": "ntpd-1/dns-1/sshd-1/monit-1/syslogng-1/dhcpd-1", },"timeZone": "GMT (GMT)","v6ShortHandAddress": "2018:2018::10""v6_ipaddress": "20182018000000000000000000000010"" setFailoverFlag": false "associated_v4_ipaddress": "10.1.10.91"}}

Parameters
Type Name Description Schema Default

Body

body
required

IPv6 DHCP appliance details

DHCP Appliance

Responses
HTTP Code Description Schema

500

TIMS-3030: Both object id and IP Address cannot be null, TIMS-3031: Object does not exist, TIMS-3033: An appliance already exists with the specified address, TIMS-3036: Both DHCP Policy Template name and id cannot be null, TIMS-3037: DHCP Policy Template does not exist, TIMS-3039: Server cannot be created using a DHCP object.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.74.2. Delete DHCP Appliance

POST /v6dhcpserver/delete
Description

Deletes a given IPv6 DHCP Appliance, provided it does not serve any DHCP enabled subnets.
Below example shows sample request JSON:
{"id":121,"address":"192.168.0.135","v4_address":"192.168.0.135"}

Parameters
Type Name Description Schema Default

Body

body
required

Appliance details

Appliance Information

Responses
HTTP Code Description Schema

500

TIMS-3059: Server id and address both cannot be null, TIMS-3092: Server does not exist, TIMS-3060: DHCP Appliance is not deleted as it manages subnets, TIMS-3061: DHCP Appliance is not deleted as it manages scopes. TIMS-3062: DHCP Appliance is not deleted as it is a failover to a DHCP server.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.74.3. Update DHCP Appliance

POST /v6dhcpserver/edit
Description

Edits an IPv6 DHCP Appliance in the TCPWave IPAM. The user will have the ability to edit and configure Time Zone, Banner, NTP, SNMP, Tacacs, Syslog-ng and MAC Exclusions to it.
Below example shows sample request JSON:
{ "server": {"banner": "Test Banner","dhcp_policy_template_name": "policy-temp","monitoringService": "yes","domain_name": "test.com","ntpConfig": "10.1.10.15","option": "no","organization_name": "QAOrg","resolverData": "ns1":"10.1.10.16","server_type": "DHCP","serverPreference": "Primary","snmpConfig": { "trapSink1": "10.1.10.17", "trapSink2": "10.1.10.18", "communityString": "public", "systemName": "test-dhcp-server.test.com", "processes": "ntpd-1/dns-1/sshd-1/monit-1/syslogng-1/dhcpd-1", },"timeZone": "GMT (GMT)","v6ShortHandAddress": "2018:2018::20""v6_ipaddress": "20182018000000000000000000000020"" setFailoverFlag": false "associated_v4_ipaddress": "10.1.10.91"}}

Parameters
Type Name Description Schema Default

Body

body
required

IPv6 DHCP appliance details

DHCP Appliance

Responses
HTTP Code Description Schema

500

TIMS-3059: Appliance id and address both cannot be null, TIMS-3091: Server does not exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.74.4. Generate Configuration

GET /v6dhcpserver/generateConfig
Description

Generates Adhoc IPv6 DHCP Configuration and syncs the server with the latest configuration. Configuration generation is subjected to a sanity check process that validates the syntax of the DHCP Configuration to ensure that erroneous configuration is not sent to the server.
The example listed below shows a sample request URL:
/rest/v6dhcpserver/generateConfig?v6Address=1500::2&serverName=test&v4Address=13.0.0.3&organization_name=Internal

Parameters
Type Name Description Schema Default

Query

organization_name
required

organization Name associated with the Server

string

Query

serverName
required

Name of the DHCP Appliance

string

Query

v4Address
required

IP Address of the specified Server

string

Query

v6Address
required

IPv6 Address of the DHCP Appliance

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-9212: A sync is currently in progress. Please wait until it is completed.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.74.5. DHCP Appliance List

GET /v6dhcpserver/list
Description

Obtains a list of all the IPv6 DHCP Appliances configured in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/v6dhcpserver/list?orgName=Internal

Parameters
Type Name Description Schema Default

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Server Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.74.6. DHCP Appliance List

GET /v6dhcpserver/listbyorg
Description

Obtains a list of all the IPv6 DHCP Appliances configured in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/v6dhcpserver/listbyorg?organization_name=Internal

Parameters
Type Name Description Schema Default

Query

organization_name
required

Organization name

string

Responses
HTTP Code Description Schema

200

successful operation

< Server Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.74.7. IPv6 DHCP Appliance List

GET /v6dhcpserver/page
Description

This operation retrieves the list of the paginated IPv6 DHCP appliances defined in the TCPWave IPAM.
The following example shows a sample request url:
/tims/rest/v6dhcpserver/page/?draw=1&start=0&length=20&sort=name&order=asc&filterRules=[]

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

customFilterRules
optional

Custom Filter String

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organization Names

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting DHCP Appliance Range

integer(int32)

Responses
HTTP Code Description Schema

200

Success

Server Information

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.74.8. Server Search

GET /v6dhcpserver/search
Description

Searches for the DNS Servers in the TCPWave IPAM. The search results will be displayed in the search window categorized based on where they occur in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/v6dhcpserver/search

Parameters
Type Name Description Schema Default

Query

organizations
required

Organization List

string

Query

page
optional

Page Number

integer(int32)

Query

rows
optional

Number of rows

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListServer Information

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.74.9. Configuration information

GET /v6dhcpserver/server-configuration
Description

Provides configuration information of a DHCP Appliance defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/v6dhcpserver/server-configuration?address=1.0.0.2

Parameters
Type Name Description Schema Default

Query

address
required

DHCP Appliance Address

string

Responses
HTTP Code Description Schema

200

successful operation

DHCP Appliance

500

TIMS-3083: DHCP Appliance does not exist.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.74.10. Subnet Reference

GET /v6dhcpserver/server-subnet-references
Description

Obtains a list of subnet references that are associated with an IPv6 DHCP Appliance in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/v6dhcpserver/server-subnet-references?address=1.0.0.2

Parameters
Type Name Description Schema Default

Query

address
required

IPv6 DHCP appliance address

string

Responses
HTTP Code Description Schema

200

successful operation

< Subnet Information > array

500

TIMS-1358: Location already exists.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.74.11. Execute Command on DHCP Appliance

GET /v6dhcpserver/subsys
Description

Executing a Command for DHCP Appliance in the TCPWave IPAM.Provides execution status of a given command number.
The example listed below shows a sample request URL
rest/dhcpserver/subsys?server_name=TCPWave00005Remote&server_ip=10.0.0.0&argc=2
Note: Below are the arc values should be use in argc based on the command:
/opt/tcpwave/scripts/timsdhcpRestart.sh =0
/usr/bin/sudo /sbin/service snmpd restart =1
sudo /bin/timeout 5s /usr/sbin/tcpdump -nn -i eth0 udp port 67 or tcp port 68 -c 200 -tttt =2
/usr/bin/sudo /sbin/service snmpd restart =3
/usr/bin/sudo /sbin/service dhcpd6 restart =4
/usr/bin/sudo /sbin/service monit restart =5
/usr/bin/sudo /sbin/service ntpd restart =6
/usr/bin/sudo /sbin/service sshd restart =7
/opt/tcpwave/scripts/powerCycle =8
/opt/tcpwave/scripts/powerOff =9

Parameters
Type Name Description Schema Default

Query

argc
required

argc

integer(int32)

Query

server_ip
required

Required Server’s IP address

string

Query

server_name
required

Required Server’s Name

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.74.12. Generate Configuration

POST /v6dhcpserver/syncall
Description

Generates Adhoc IPv6 DHCP Configuration and syncs the servers with the latest configuration. Configuration generation is subjected to a sanity check process that validates the syntax of the DHCP Configuration to ensure that erroneous configuration is not sent to the server.
The example listed below shows a sample request URL:
/rest/v6dhcpserver/syncall?organization_name=EARTH
Below example shows sample request JSON:
[{"id":121,"name":"nusartx-est015-sl09113","organization_id":990,"organization_name":"EARTH","v4_address":"192.1.10.200","server_type":"BIND_AUTH","v6_address":"7000::1","associated_v4_ipaddress":"7000::1"}]

Parameters
Type Name Description Schema Default

Query

organization_name
required

Required Organization Name

string

Body

body
required

List of IPv6 DHCP appliance details

< Server Basic Information > array

Responses
HTTP Code Description Schema

500

TIMS-9212: A sync is currently in progress. Please wait until it is completed.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.74.13. DHCPv6 Appliance Active Leases

GET /v6dhcpserver/v6dhcpActiveLeases
Description

Get the list of active leases on a given IPv6 DHCP Appliance defined and managed by the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/v6dhcpserver/v6dhcpActiveLeases?v6serverIp=1500:5&serverIp=1.0.0.2

Parameters
Type Name Description Schema Default

Query

serverIp
required

Required Server’s IP address

string

Query

v6serverIp
required

DHCP IPv6 appliance address

string

Responses
HTTP Code Description Schema

200

successful operation

PagedListDHCPLeaseObject

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.74.14. Get Configuration

GET /v6dhcpserver/viewconfig
Description

Provides a view configuration of an IPv6 DHCP Appliance defined and managed by the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/v6dhcpserver/viewconfig?organization_name=Internal&address=1200::64

Parameters
Type Name Description Schema Default

Query

address
required

Server Address

string

Query

organization_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.75. IPV6 DNS Appliance Service

4.75.1. Add DNS IPv6 Appliance

POST /v6dnsserver/add
Description

Creates DNS IPv6 Appliance that can be used to service the DNS requests. This remote Appliance is configured, maintained and managed by the IPAM.
The allowed Appliance types are (1) ISC Bind Authoritative Appliance (2) ISC Bind Cache Appliance (3) NSD Authoritative Appliance (4) Unbound Cache Appliance (5) DNS Proxy Appliance

Sample payload to add a DNS BIND AUTH Appliance is listed below.
Create DNS Appliance
{"server_type":"BIND AUTH","stealthServer":0,"authAsCache":"no","internal_cache_server":1,"dmzVisible":0,"autoDNSDR":null, "autoRestoreConf":0, "enableDnsOverTLS":"no", "v4_ipaddress":"42.0.0.11", "name":"TCPWave00007Remote", "timeZone":"GMT (GMT)", "dns_server_template_name":"DNS PROXY Default Server Template", "dns_options_template_name":"DNS PROXY Default Template", "nsm_template":"test_template_1", "organization_name":"Internal", "snmpConfig":"{"trapSink1":"42.0.0.11","trapSink2":"42.0.0.12","communityString":"zxcv","systemContact":"","systemName":"TCPWave00007Remote.kiran.com","processes":"ntpd-00/dns-0/sshd-0/monit-0/syslog-ng-0/dhcpd-1"}", "enableSNMPv3":false,"monitoringService":"yes", "banner":"The default value of Banner configuration for DNS and DHCP appliances.","ldapSSHConfig":"{"enable":false}", "ntpConfig":"42.0.0.11", "resolverData":"{"ns1":"42.0.0.12","ns2":"","ns3":"","ns4":"","search1":"","search2":"","search3":"","search4":"","search5":"","search6":""}"}

Parameters
Type Name Description Schema Default

Body

body
required

DNS IPv6 appliance details

Server Information

Responses
HTTP Code Description Schema

500

TIMS-3009: Object does not exist.
TIMS-3030: Both object id and IP Address cannot be null
TIMS-3031: Object is not deleted as it is associated with a zone
TIMS-3038: Appliance Type is not valid:{0}
TIMS-3033: An Appliance already exists with the : {0}
TIMS-3034: Both DNS Appliance Template name and id cannot be null
TIMS-3035: Specified DNS Appliance Template not found
TIMS-3036: Both DNS Options Template name and id cannot be null
TIMS-3037: Specified DNS Options Template not found
TIMS-3039: Cannot create an Appliance using a DHCP object
TIMS-1335: DNS Internal Cache Appliance cannot be created as there is no root zone defined in this organization
TIMS-3079: Both DNS Options Template name and id cannot be null
TIMS-3080: DNS Options Template does not exist
TIMS-10102: Both view id and view name cannot be null
TIMS-10103: DNS View does not exist for name

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.75.2. DNS IPv6 Appliance Delete

POST /v6dnsserver/delete
Description

Deletes an existing DNS IPv6 Appliance that is used to service the DNS requests. A DNS Appliance cannot be deleted when it is actively servicing any forward zone or a reverse zone.
The example listed below shows a sample request URL:
v6dnsserver/delete?address=2000:100::2

Parameters
Type Name Description Schema Default

Body

body
required

Appliance details

Appliance Information

Responses
HTTP Code Description Schema

500

TIMS-3050: Both Appliance id and address cannot be null
TIMS-3052: Appliance is not deleted as other zone(s) are using it. Please remove the referencing zone(s) and retry
TIMS-3053: Appliance is not deleted as other zone template(s) are using it. Please remove the referencing zone template(s) and retry
TIMS-3055: Appliance is not deleted as other network(s) are using it. Please remove the referencing network(s) and retry
TIMS-3092: Appliance does not exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.75.3. DNS IPv6 Appliance Edit

POST /v6dnsserver/edit
Description

Edits a DNS IPv6 appliance that is used to service the DNS requests. This remote appliance is configured, maintained and managed by the IPAM.
Below example shows sample request JSON:
{"server_type": "BIND AUTH","stealthServer": 0,"internal_cache_server": 1,"dmzVisible": 0,"autoDNSDR": null,"autoRestoreConf": 0,"dns_server_template_name": "BIND AUTH Default Server Template","dns_options_template_name": "BIND AUTH Default Template", "nsm_template":"test_template_1", "v6_ipaddress": "5000::2","name": "DEV-DNSROOT-AUTH-004","appliance_group": "","timeZone": "GMT (GMT)","description": "testing QA","organization_name": "Internal","snmpConfig": "{"trapSink1":"5000::3","trapSink2":"5000::4","communityString":"sph1nkx5","systemContact":"","systemName":"DEV-DNSROOT-AUTH-004.plab.tcpwave.com","processes":"ntpd-1/dns-1/sshd-1/monit-1/syslogng-1/dhcpd-1"}","monitoringService": "yes","banner": "Testing 12345678","tacacsConfig": ""0-@-10.1.10.1/10.1.10.2/10.1.10.3/10.1.10.4|abc123","ntpConfig"": "3000::2/3000::3/3000::4/3000::5", "syslogConfig":"[{"action":"/var/log/messages","active":"yes","selector":".info;mail.none;authpriv.none;cron.none","type":"File"},{"action":"/var/log/secure","active":"yes","selector":"authpriv.","type":"File"},{"action":"-/var/log/maillog","active":"yes","selector":"mail.","type":"File"},{"action":"/var/log/cron","active":"yes","selector":"cron.","type":"File"},{"action":":omusrmsg:*","active":"yes","selector":".emerg","type":"DefaultType"},{"action":"/var/log/spooler","active":"yes","selector":"uucp,news.crit","type":"File"},{"action":"/var/log/boot.log","active":"yes","selector":"local7.","type":"File"},{"action":"/var/log/test","active":"yes","selector":"auth,authpriv.debug;","type":"File"}]","mgmtIP":"10.1.10.197","dns64List": [],"idracSnmpCommunity": "no-@--@--@-","resolverData": "{"ns1":"4000::2","ns2":"","ns3":"","ns4":"","search1":"","search2":"","search3":"","search4":"","search5":"","search6":""}","old_address": "5000::4","domain_name": "plab.tcpwave.com"}

Parameters
Type Name Description Schema Default

Body

body
required

DNS IPv6 appliance details

Server Information

Responses
HTTP Code Description Schema

500

TIMS-3030: Both object id and IP Address cannot be null
TIMS-3031: Object is not deleted as it is associated with a zone
TIMS-3038: Appliance Type is not valid:{0}
TIMS-3033: An Appliance already exists with the specified address
TIMS-3034: Both DNS Appliance Template name and id cannot be null
TIMS-3035: Specified DNS Appliance Template not found
TIMS-3036: Both DNS Options Template name and id cannot be null
TIMS-3037: Specified DNS Options Template not found
TIMS-3039: Cannot create an Appliance using a DHCP object
TIMS-10102: Both view id and view name cannot be null
TIMS-10103: DNS View does not exist for name
TIMS-5033: Appliance Template does not exist
TIMS-3050: Both Appliance id and address cannot be null
TIMS-3091: Appliance does not exist
TIMS-1336: DNS Appliance cannot be changed to Internal DNS Cache Appliance as there is no root zone defined in this organization
TIMS-5009: Option Template does not exist
TIMS-3079: Both DNS Options Template name and id cannot be null
TIMS-3009: Object does not exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.75.4. Generate Configuration

GET /v6dnsserver/genconfig
Description

From the data repository, a list of configuration files is generated and various data integrity checks are done. The files are securely transferred to the remote. Compression is used during the final transfer. On the remote, the compressed configuration files expanded and put into appropriate places and the service is refreshed or restarted depending on the global option defined for file synchronization.
The example listed below shows a sample request URL:
/rest/dnsserver/genconfig?server_type_code=BIND AUTH&address=10.0.0.2&organization_name=orgNameValue

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Query

force_sync
optional

Force Sync Appliance

string

Query

organization_name
required

Organization Name

string

Query

server_type_code
required

DNS Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1349: DNS Configuration sync failed with error
TIMS-9212: A sync is currently in progress initiated by {0} from {1}. Please wait until it is completed
TIMS-9213: A download config is currently in progress initiated by {0} from {1}. Please wait until it is completed.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.75.5. DNS IPv6 Appliance Details

GET /v6dnsserver/get
Description

Get DNS IPv6 Appliance Detail. Functional Admin gets the list of all Appliances. Rest of the Admins get only the list of Appliances associated with the organization that they belong to.Functional Admin gets the list of all Appliances. Rest of the Admins get only the list of Appliances associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/v6dnsserver/get?serverTypeCode=BIND AUTH&serverIp=10.0.0.8

Parameters
Type Name Description Schema Default

Query

serverIp
required

Appliance IPv6 Address

string

Query

serverTypeCode
optional

Appliance Type Code

string

Responses
HTTP Code Description Schema

200

successful operation

Server Information

500

TIMS-3050: Both Appliance id and address cannot be null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.75.6. Appliance Sync Status GET

GET /v6dnsserver/getdnslastsyncstatus
Description

Provides the details of sync information for the given Appliance and Organization in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/serversync/get?address=10.1.10.183&orgName=QAOrg&serverType=BIND%20CACHE

Parameters
Type Name Description Schema Default

Query

address
required

Server IP Address

string

Query

isV6
optional

Boolean value to represent the IPv6 appliance or not

boolean

Query

orgName
required

Organization Name

string

Query

serverId
optional

Appliance Id

integer(int32)

Query

serverType
required

Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

Appliance Synchronization Status

500

TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-3091: Appliance does not exist.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.75.7. Enable or Disable Monitoring

POST /v6dnsserver/multimonitoring
Description

Enable or disable monitoring for the current TCPWave Remote in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Body

body
optional

< Server Information > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.75.8. DNS IPV6 Appliance List

GET /v6dnsserver/page
Description

Obtains a list of all the DNS IPV6 Appliances defined in the TCPWave IPAM. Functional Admin gets the list of all Appliances. Rest of the Admins get only the list of Appliances associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/v6dnsserver/page/?draw=1&start=0&length=20&sort=name&order=asc&filterRules=[]

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

customFilterRules
optional

Custom Filter String

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organization Names

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting DNS Appliance Range

integer(int32)

Responses
HTTP Code Description Schema

200

Success

Server Information

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.75.9. IPv6 DNS Configuration Update

GET /v6dnsserver/reconfig
Description

Updates the DNS configuration on the specified IPv6 DNS remote.
The example listed below shows a sample request URL:
/rest/v6dnsserver/reconfig?server_type_code=BIND AUTH&v6address=5000::2&organization_name=orgNameValue

Parameters
Type Name Description Schema Default

Query

organization_name
required

Organization Name

string

Query

server_type_code
required

IPv6 DNS Appliance Type

string

Query

v6address
required

IPv6 Appliance IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1349: DNS Configuration sync failed with error
TIMS-9212: A sync is currently in progress initiated by {0} from {1}. Please wait until it is completed
TIMS-9215: A DNS config update is currently in progress initiated by {0} from {1}. Please wait until it is completed.
TIMS-9213: A download config is currently in progress initiated by {0} from {1}. Please wait until it is completed.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.75.10. Appliance Configuration

GET /v6dnsserver/server-configuration/{server_address}/{server_type}
Description

Lists the configuration type and configuration data for an specified appliance in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/v6dnsserver/server-configuration/2000:100::2/BIND AUTH/BIND CACHE/UNBOUND/NSD/DNS PROXY

Parameters
Type Name Description Schema Default

Path

server_address
required

Appliance IPv6 Address

string

Path

server_type
required

Appliance Type Code

string

Responses
HTTP Code Description Schema

200

successful operation

Server Information

500

TIMS-3038: Appliance Type is not valid:<Appliance Type Code>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.75.11. Appliance References in Zone Template

GET /v6dnsserver/server-references
Description

Obtains the list of all the zone templates which are associated with the specified DNS IPv6 Appliance. For additional information about the DNS zone templates, please refer to the product documentation.
The example listed below shows a sample request URL:
/rest/v6dnsserver/server-references?address=2000:100::2

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IPv6 Address

string

Query

id
optional

Appliance Id

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3050: Both Appliance id and address cannot be null.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.75.12. Synchronize DNS Appliances

POST /v6dnsserver/syncAll
Description

From the data repository a list of configuration files are generated and various data integrity checks are done. The files are securely transferred to the remote. Compression is used during the final transfer. On the remote, the compressed configuration files expanded and put into appropriate places and the service is refreshed or restarted depending on the global option defined for file synchronization.
Below example shows sample request JSON:
[{"name":"DEV-CDNS-EXT-001","organization_name":"Internal","v6_address":"5000::1","server_type":"BIND AUTH"},{"name":"DEV-CDNS-INT-001","organization_name":"Internal","v6_address":"5000::1","server_type":"BIND CACHE"},{"name":"DEV-CDNS-INT-EXTFW-002","organization_name":"Internal","v6_address":"5000::1","server_type":"BIND CACHE"},{"name":"DEV-CDNS-XDHCP-001","organization_name":"Internal","v6_address":"5000::1","server_type":"BIND AUTH"},{"name":"DEV-DNS-PROXY-001","organization_name":"Internal","v6_address":"5000::1","server_type":"DNS PROXY"},{"name":"nusgtdc-qrs01-sl0984","organization_name":"Internal","v6_address":"5000::1","server_type":"BIND AUTH"},{"name":"nusruth-qrs01-sl0984","organization_name":"EARTH","v6_address":"5000::1","server_type":"BIND AUTH"},{"name":"nusswdc-cxsqrs01-sl0984","organization_name":"Internal","v6_address":"5000::1","server_type":"BIND AUTH"}]

Parameters
Type Name Description Schema Default

Query

fasterSync
optional

boolean

Body

body
optional

< Server Basic Information > array

Responses
HTTP Code Description Schema

500

TIMS-1349: DNS Configuration sync failed with error

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.75.13. View Configuration of DNS Appliance

GET /v6dnsserver/viewconfig
Description

View the configuration file for the specified DNS Appliance in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/dnsserver/viewconfig?server_type_code=BIND AUTH&address=10.0.0.2&organizationName=orgNameValue

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Query

organizationName
required

Appliance Organization name

string

Query

server_type_code
required

DNS Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1349: DNS Configuration sync failed with error

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.76. IPV6 Object Service

Description

This service class provides REST API access to Add, Edit and Delete an IPv6 object from the TCPWave IPAM.

4.76.1. Object Duplicate Name Checker

GET /ipv6object/IPv6duplicateNameChecker
Description

Check for the occurrence of an IPv6 object with the same name.

Parameters
Type Name Description Schema Default

Query

domain_name
required

Domain Name

string

Query

ip_addr
required

IP Address

string

Query

name
required

Object Name

string

Query

org_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • text/plain

4.76.2. Add IPv6 Object

POST /ipv6object/add
Description

Adds a new IPv6 object in the TCPWave IPAM. It is highly recommended to execute the object duplicate name checker and the A-CNAME conflict checker REST API calls to validate the data before executing this call.
Below example shows sample request JSON:
{"v6addr":3000::1,"alloc_type":1,"class_code":"3G Phone", "domain_name":"demo.com","organization_name":"QAOrg","name":"3G55071Phone","ttl":1200, "subnet_address":"300::","update_ns_aaaa": true, "update_ns_ptr": true, "dyn_update_rrs_aaaa": true, "dyn_update_rrs_cname": true, "dyn_update_rrs_ptr": true, "dyn_update_rrs_mx": true}

Parameters
Type Name Description Schema Default

Body

body
required

IPv6Object Details

IPv6 object

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.76.3. Delete IPv6 Objects

POST /ipv6object/delete-multiple
Description

Deletes a selection of IPv6 objects at a time in the TCPWave IPAM.
Below example shows sample request JSON:
{"addressArray":["3000::1"],"isDeleterrsChecked":0,"organization_name":"QAOrg"}

Parameters
Type Name Description Schema Default

Body

body
required

List Of IPv6Object Details

IPv6 object

Responses
HTTP Code Description Schema

200

successful operation

< Resource Record > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.76.4. Update IPv6 Object

POST /ipv6object/edit
Description

Updates the existing IPv6 object details in the TCPWave IPAM. It is highly recommended to execute the object duplicate name checker and the A-CNAME conflict checker REST API calls to validate the data before executing this call.
Below example shows sample request JSON:
{"v6addr":3000::1,"alloc_type":1,"class_code":"3G Phone", "domain_name":"demo.com","organization_name":"QAOrg","name":"3G55071Phone","ttl":1200, "subnet_address":"300::","update_ns_aaaa": true, "update_ns_ptr": true, "dyn_update_rrs_aaaa": true, "dyn_update_rrs_cname": true, "dyn_update_rrs_ptr": true, "dyn_update_rrs_mx": true}

Parameters
Type Name Description Schema Default

Body

body
required

IPv6 Object Details

IPv6 object

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.76.5. Get IPv6 Object

GET /ipv6object/get
Description

Provides the details of a given IPv6 object in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Query

id
optional

Object ID

integer(int32)

Query

object_addr
required

Object Address

string

Query

org_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

IPv6 object

500

TIMS-7003: You are not authorized to perform this operation
TIMS-1354: Organization does not exist.
TIMS-3010: Object does not exist<IPv6 object address>

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.76.6. Object DHCP Details

GET /ipv6object/getDHCPDetails
Description

Get the DHCP Properties configured for a Dynamic/Manual DHCP Object. Depending on the repeat parameters setting, some of the optional URL params will be required.

Parameters
Type Name Description Schema Default

Query

address
required

Object Address

string

Query

id
optional

Object ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

Object DHCP Details

500

TIMS-7002: Permission information cannot be retrieved. TIMS-3010: Object does not exist:

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.76.7. Get the next available free IP in a given subnet.

GET /ipv6object/getNextFreeIPV6IP
Description

Gets the next available free IP in a given subnet.
The example listed below shows a sample request URL:
/rest/object/getNextFreeIP?subnet_addr=2000::1&org_name=Internal

Parameters
Type Name Description Schema Default

Query

org_name
required

Organization Name

string

Query

range_end_addr
optional

Range End Address

string

Query

range_start_addr
optional

Range Start Address

string

Query

subnet_addr
required

Subnet Address

string

Query

subnet_id
optional

Subnet ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • text/plain

  • application/json

  • application/xml

4.76.8. IPV6 object list

GET /ipv6object/page
Description

Displays ipv6 object list for associated ipv6 subnet.
The example listed below shows a sample request URL:
/rest/ipv6object/page?organization=Internal&start=1&length=20&subnet_address=1200::

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Order parameter

string

Query

org_name
required

Organization Name

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting IPV6 Object Range

integer(int32)

Query

subnet_addr
required

subnet address

string

Query

subnet_id
optional

subnet id

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListIPv6 Object

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.76.9. Network Resource Record Add

POST /ipv6object/rr/add
Description

Add resource records to a network in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Body

body
optional

Resource Record

Responses
HTTP Code Description Schema

500

TIMS-7002: Permission information cannot be retrieved, TIMS-9561: Old owner of the resource record cannot be null, TIMS-9564: Old data of the resource record cannot be null, TIMS-1352: Cannot find organization: <Organization Name>, TIMS-7003: You are not authorized to perform this operation, TIMS-3006: Object address cannot be null, TIMS-3009: Object does not exist, TIMS-3015: Resource record does not exist, TIMS-12030: CNAME does not refer to a valid AAAA record, TIMS-12031: No AAAA record found for given owner name:<Owner Name> Please enter a valid AAAA record name, TIMS-3025: Resource Records already exist

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.76.10. Resource Record Delete

POST /ipv6object/rr/delete
Description

Deletes a Resource Record

Parameters
Type Name Description Schema Default

Body

body
optional

Resource Record

Responses
HTTP Code Description Schema

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.76.11. Schedule Object Job

POST /ipv6object/schedObjectOperation
Description

Schedules an Object job.
The example listed below shows a sample request URL:
/rest/ipv6object/schedObjectOperation?jobId=64

Parameters
Type Name Description Schema Default

Body

body
required

Id of scheduled object operation

string

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.76.12. Scheduled object add operation.

POST /ipv6object/sched_add
Description

Schedule an Object Creation Operation. Depending on the repeat parameters setting, some of the optional URL params will be required.
The example listed below shows a sample request URL:
/rest/ipv6object/sched_add?jobId=64

Parameters
Type Name Description Schema Default

Query

day
required

Operation Day

integer(int32)

Query

description
required

Operation Description String

string

Query

endtime
required

Operation Endtime

string

Query

frequency
required

Operation Frequency

string

Query

jobId
required

Job Id

string

Query

repeat
required

Operation Occurrence

integer(int32)

Query

repeatCount
required

Operation repeatCount

integer(int32)

Query

repeatInterval
required

Operation repeatInterval

integer(int64)

Query

runtime
required

Operation Runtime

string

Query

starttime
required

Operation Starttime

string

Body

body
required

Object details

TIMS Object

Responses
HTTP Code Description Schema

500

TIMS-6105: Object cannot be created as license limit of maximum objects reached.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.76.13. Search Objects

GET /ipv6object/search
Description

Provides list of Objects.

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
required

Organization List

string

Query

sort
optional

Sort String

string

Query

start
required

Starting IPV6 Object Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListIPv6 Object

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.76.14. Ping IPv6 Address

GET /ipv6object/tools/ping
Description

Pings available IPv6 address.

Parameters
Type Name Description Schema Default

Query

ip
required

IPv6 Address

string

Responses
HTTP Code Description Schema

200

successful operation

Ping Data

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.76.15. Trace Route Object

GET /ipv6object/tools/traceroute
Description

Traces the IPv6 object and shows the routers in between the IPAM and the IPv6 object from the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Query

ip
required

IPv6 Address

string

Responses
HTTP Code Description Schema

200

successful operation

Ping Data

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.76.16. Resource Record Traverse

POST /ipv6object/traverse
Description

Resource record look up in remote IPv6 DNS Server.Performs the basic name resolution for a given resource record using the target DNS server on which the check is to be executed in the TCPWave IPAM.
Sample payloads with mandatory parameters to traverse object are listed below.
{"rr_name": "3G251Phone","domain_name": "addzone.com","organization_name": "Internal","rr_value": "5000::","rev_zone_name": "0.0.0.0.0.0.0.0.0.0.0.0.0.5.ip6.arpa","obj_type": "IPv6","dnssec_enabled": false}

Parameters
Type Name Description Schema Default

Body

body
optional

DNS Appliance Tool

Responses
HTTP Code Description Schema

200

successful operation

< DNS Appliance Tool > array

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist:<Organization Name>, TIMS-1422: TIMS-1422: Zone does not exist:<Zone Name>

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.76.17. IPv6 Resource Record Check CNAME Conflict

POST /ipv6object/v6rr/checkAAAAtoCNAMEconflict
Description

Checks AAAA to CNAME Resource Record(RR) conflict in the TCPWave IPAM. It is mandatory to have a different name for a A RR than that of existing CNAME RR and vice-versa.
The example listed below shows a sample request URL:
/rest/zone/v6rr/checkAAAAtoCNAMEconflict?ownerName=1tcp.com.test.com.&org_name=Internal&recordType=CNAME&data=server.test.com.

Parameters
Type Name Description Schema Default

Query

data
required

Resource Record Data

string

Query

org_id
optional

Organization Id

integer(int32)

Query

org_name
required

Organization Name

string

Query

ownerName
required

Resource Record owner name

string

Query

recordType
required

Resource Record Type

string

Query

view_names
optional

Resource Record View Names

string

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-1020: Both Organization name and id cannot be null, TIMS-3072: A or CNAME <Given Record Name> record already exists for an Object: <Object Name>, TIMS-1420: A or CNAME <Given Record Name> record already exists in Zone: <Zone Name>

No Content

Consumes
  • application/json

  • application/xml

4.77. IPV6 Pool Service

4.77.1. Add IPV6 Pool

POST /ipv6pool/add
Description

Creates a new IPv6 Pool in the TCPWave IPAM. It checks if it is overlapping with any existing network or not.
Below example shows sample request JSON:
{ "address":"5000::", "mask_length":"48", "name":"tcpwave-network", "description":"", "zoneTemplateId":null, "dmzVisible":"yes", "dnssec_enable":"yes", "nsec_option":"NSEC3", "serialFormat":"DATE", "zoneTemplateName":null, "percentageFull":90, "email_check":0, "snmp_check":0, "log_check":0, "rrs":[], "created_by":"2189", "organization_name":"QAOrg" }

Parameters
Type Name Description Schema Default

Body

body
required

IPV6 Pool details

IPv6 Network Details

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist, TIMS-1020: Both Organization name and id cannot be null, TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.77.2. Delete IPV6 Pool

POST /ipv6pool/delete
Description

Deletes the specified IPV6 Pool present in the TCPWave IPAM . Functional Admin can delete networks belonging to any organization. Rest of the admins can delete networks belonging to their organization only.
Below example shows sample request JSON:
{ "address":"5000::","ipv6FullAddress":"50000000000000000000000000000000","organization_name":"QAOrg"}

Parameters
Type Name Description Schema Default

Body

body
required

IPv6 pool details

IPv6 Network Details

Responses
HTTP Code Description Schema

500

TIMS-2008 - Both Pool address and id cannot be null.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.77.3. Update IPv6 Pool

POST /ipv6pool/edit
Description

Updates the existing IPv6 Pool details in the TCPWave IPAM. These actions are audited.
Below example shows sample request JSON:
{ "address":"5000::","mask_length":null,"name":"tcpwave-network","description":"test","zoneTemplateId":null,"dmzVisible":"yes","dnssec_enable":"yes","nsec_option":"NSEC","serialFormat":"DATE","zoneTemplateName":null,"percentageFull":90,"email_check":0,"snmp_check":0,"log_check":0,"rrs":[{"domain_id":150328,"owner":"tcp.test.com","ttl":"1200","rrclass":"IN","rrtype":"PTR","data":"5000::1","description":"","name":"tcp"}],"oldName":"tcpwave-network","organization_name":"QAOrg","ipv6FullAddress":"50000000000000000000000000000000" }

Parameters
Type Name Description Schema Default

Body

body
required

IPv6 pool details

IPv6 Network Details

Responses
HTTP Code Description Schema

500

TIMS-2008 - Both Pool address and id cannot be null. TIMS-7003 - You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.77.4. IPv6 Pool list

GET /ipv6pool/page
Description

Lists all the IPv6 Pools available in the TCPWave IPAM. Functional Admin gets the list of all Pools.Rest of the Admins get only the list of networks to the organization that they belong to.

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Order parameter

string

Query

organizations
optional

Comma Separated Organization Names

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting IPV6 Pool Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedList_dIPv6 Network Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.77.5. Search Pools

GET /ipv6pool/search
Description

Searches for all IPv6 pools available in the TCPWave IPAM . The results can be seen on the search screen of the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Query

organizations
required

Organization List

string

Query

page
required

Page

integer(int32)

Query

rows
required

Rows

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListIPv6 Network Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.78. IPV6 Scope Service

Description

This service class provides REST API access to Create, Modify and Delete a DHCPv6 scope in the TCPWave IPAM.

4.78.1. Scope Create

POST /v6scope/autoprovision
Description

Creates DHCP Scopes by validating if the given start IP and end IP span through a valid free IP address in a subnet. The logic also checks if the DHCP Option Template associated to the scope has a valid Router and Subnet Mask that match with the subnet profile.
Below example shows sample request JSON:
{ "update_ns_a": true, "update_ns_ptr": true, "dyn_update_rrs_a": true, "dyn_update_rrs_cname": true, "dyn_update_rrs_ptr": true, "dyn_update_rrs_mx": true, "ttl": "1200", "v6Scope": { "class_code": "3G Phone", "description": "", "organization_name": "QAOrg", "primary_dhcp_server": "QA-Remote", "count": "2", "size": "2", "allocation_type": "dynamic", "template_name": "option-temp", "allowClassesArray": [], "denyClassesArray": [], "subnetAddress": "3000::" } }

Parameters
Type Name Description Schema Default

Body

body
required

Create Scope Request

Create Scope Request

Responses
HTTP Code Description Schema

500

TIMS-1259: Object address range does not belong to any network
TIMS-1262: Subnet does not have a primary router defined and the template has the option router defined
TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.78.2. IPv6 Scope Delete

POST /v6scope/delete
Description

Delete one or more IPv6 DHCP Scopes.
Below example shows sample request JSON:
[{ "addressRange": "3000::4-3000::5","subnetAddress": "3000::","organization_name": "QAOrg" }]

Parameters
Type Name Description Schema Default

Body

body
required

List of IPv6 scopes

< Delete Scope Request > array

Responses
HTTP Code Description Schema

500

TIMS-1261: Scope does not exist for object range: start ip - end ip

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.78.3. List IPv6 DHCP Scopes

GET /v6scope/list
Description

Provides a paginated list of IPv6 DHCP Scope Definitions in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

org_name
required

Organization name

string

Query

sort
optional

Sort String

string

Query

start
required

Starting IPV6 Scope Range

integer(int32)

Query

subnet_address
optional

Subnet address of the scope

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListIPV6 Scope

500

TIMS-7003: You are not authorized to perform this operation
TIMS-2015: Subnet does not exist.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.78.4. IPv6 Scope Delete

POST /v6scope/singledelete
Description

Delete one or more IPv6 DHCP Scopes.

Parameters
Type Name Description Schema Default

Body

body
required

Scope delete details

< Delete Scope Request > array

Responses
HTTP Code Description Schema

500

TIMS-1261: Scope does not exist for object range: start ip - end ip

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.78.5. Scope Validation Request

GET /v6scope/validate_request
Description

Provides the subnet address, DHCP Option Template and DHCP Appliance for a given scope. The start IP and end IP of a scope are the inputs for this REST Call.

Parameters
Type Name Description Schema Default

Query

organizationName
required

Organization Name

string

Query

subAdr
required

Subnet Address

string

Responses
HTTP Code Description Schema

200

successful operation

Scope Validate Request Data

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.79. IPV6 Subnet Group Service

Description

This service provides a list of subnet groups with IPv6 subnets listed in each group. Grouping of IPv6 subnets is usually desirable when allocating write permissions to normal administrators belonging to a business unit. It is more efficient to manage permissions when Admin Groups have appropriate access to Subnet Groups. When a single administrator joins or leaves the firm or if a new IPv6 subnet is added / modified / deleted, permissions become easier to manage with the grouping logic mentioned above.

4.79.1. IPv6 Subnet Group Add

POST /ipv6subnetgroup/add
Description

Adds new IPv6 Subnet Group in the TCPWave IPAM.
Below example shows sample request JSON:
{ "name":"tcp-grp","description":"test" }

Parameters
Type Name Description Schema Default

Body

body
required

IPv6 subnet group details

Subnet Group

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation
TIMS-1352: Organization does not exist:<Organization Name>
TIMS-2014: Subnet group already exists

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.79.2. IPV6 Subnet Group Delete All

POST /ipv6subnetgroup/deleteAll
Description

Deletes multiple IPv6 subnet groups by dis-associating the subnets referring to them or without dis-associating subnets referring to them. Functional Admins can delete all the subnet groups in any organization. Other Admins can delete the subnet groups belonging to their organization only.
Below example shows sample request JSON:
{"subnetGroupList":[{"name":"subGroup2","organization_name":"QAOrg"},{"name":"tcp-sg1","organization_name":"Internal"}],"deleteWithReferences":"false"}

Parameters
Type Name Description Schema Default

Body

body
required

Multiple IPv6 subnet group details

Subnet Group Delete Request

Responses
HTTP Code Description Schema

200

successful operation

Subnet Group References

500

TIMS-7003: You are not authorized to perform this operation
TIMS-2015: Subnet does not exist

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.79.3. Disassociate Subnet

POST /ipv6subnetgroup/disassociate
Description

Dis-associates Subnet from the Subnet Group. This action is audited.

Parameters
Type Name Description Schema Default

Query

fullAddress
required

Subnet address

string

Query

org_name
required

Organization Id

string

Responses
HTTP Code Description Schema

500

Subnet does not exist.

No Content

Consumes
  • application/json

  • application/xml

4.79.4. IPV6 Subnet Group Get

GET /ipv6subnetgroup/get
Parameters
Type Name Description Schema Default

Query

id
optional

Id of the subnet group

string

Query

name
required

Name of the subnet group

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Subnet Group

500

TIMS-2015: Subnet does not exist

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.79.5. IPV6 Subnet Group List

GET /ipv6subnetgroup/list
Parameters
Type Name Description Schema Default

Query

organizations
optional

organizations

string

Responses
HTTP Code Description Schema

200

successful operation

< Subnet Group > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.79.6. List Subnets present in the given Subnet Group

GET /ipv6subnetgroup/listSubnets
Description

Returns a list of Subnets present in the given Subnet Group.

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

org_name
required

Organization Name

string

Query

sort
optional

Sort String

string

Query

start
required

Starting IPV6 Subnet Group Range

integer(int32)

Query

subnet_grp_id
required

Subnet Group Id

integer(int32)

Query

subnet_grp_name
required

Subnet Group Name

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListSubnet Information

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.79.7. IPV6 Subnet Group Organization List

GET /ipv6subnetgroup/listbyorg
Parameters
Type Name Description Schema Default

Query

organization_name
optional

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Subnet Group > array

500

TIMS-7003: You are not authorized to perform this operation
TIMS-1352: Organization does not exist: <Organization name>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.79.8. IPV6 Subnet Group Update

POST /ipv6subnetgroup/update
Description

Updates the subnet groups present in the TCPWave IPAM. Functional Admins can update a subnet group in any organization. Other Admins can update the subnet groups in their own organization only.
Below example shows sample request JSON:
{"name":"v6Subgroup","description":"","organization_name":"QAOrg","oldName":"Subgroupv6" }

Parameters
Type Name Description Schema Default

Body

body
required

IPv6 subnet group details

Subnet Group

Responses
HTTP Code Description Schema

500

TIMS-2014: Subnet group already exists:<Subnet group name>

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.80. IPV6 Subnet Service

Description

This service class provides REST API access to Create, Modify and Delete an IPv6 subnet in the TCPWave IPAM.

4.80.1. List Active Leases

GET /ipv6subnet/activeLeases
Description

Lists all the DHCP Objects that are holding an active lease in the given subnet that is defined in the TCPWave IPAM.
Below example shows sample request JSON:
{"serverAddress":"20000000000000000000000000000009","v4serverAddress":"192.168.56.162","subnetAddress":"2000::","organization_name":"Internal"}

Parameters
Type Name Description Schema Default

Query

organizationName
required

Organization Name

string

Query

page
optional

Page

integer(int32)

Query

rows
optional

Rows

integer(int32)

Query

serverAddress
required

Server Address

string

Query

subnetAddress
required

Subnet Address

string

Responses
HTTP Code Description Schema

200

successful operation

PagedListDHCPLeaseObject

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.80.2. IPv6 Subnet Add

POST /ipv6subnet/add
Description

Creates a new IPv6 subnet by checking if it overlaps with the existing subnets defined in the TCPWave IPAM.
Below example shows sample request JSON:
{ "name":"tcp-subnet","fullAddress":"5000:0:0:b::","mask_length":64, "primary_domain":"test.com","routerAddress":"5000:0:0:b::1","description":"", "network_address":"5000::","organization_name":"QAOrg" }

Parameters
Type Name Description Schema Default

Body

body
required

IPv6 subnet details

IPv6 Subnet

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-3101: Network does not exist: network_address

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.80.3. Subnet Add All

POST /ipv6subnet/addall
Description

Creates all the possible subnets in a given block by taking all the existing subnets into consideration.
The allowed subnet types are (1)Non-DHCP (2)DHCP Enabled (3)Cloud Hosted
Non-DHCP subnet type can be used to create static objects. DHCP Enabled subnet type is used to create DHCP objects along with static objects and Cloud Hosted subnet type is used to create cloud instances.
When Non-DHCP subnet type is selected, the parameters primary_domain and routerAddress are mandatory.
When DHCP Enabled subnet type is selected,primary_domain, routerAddress, template_name and primary_dhcp_server are mandatory.
When Enable Discovery is yes, Objects present in the subnet will be eligible for discovery.If Enable Discovery is yes then discovery_template is mandatory field.
When Enable Reclaim is set to yes,The objects present in the subnet will be eligible for reclaim validation and the objects that are not pingable in the reclaim period from the current time will be eligible for reclaim.
Sample payloads with mandatory parameters to add a subnet are listed below.
Create NON-DHCP Subnet:
{ "nw_mask_length":8,"mask_length":10,"network_address":"10.0.0.0","subnet":{"router_option":"First IP in the subnet","organization_name":"QAOrg","primary_domain":"test.com"}}
Create DHCP-Enabled Subnet:
{ "nw_mask_length":8","mask_length":10,"network_address":"10.0.0.0","subnet":{"router_option":"First IP in the subnet","organization_name":"QAOrg","primary_domain":"test.com", "template_name":"dhcp_option_template","primary_dhcp_server":"TCPWave00002Remote"}}
Create Cloud Hosted Subnet:
{ "nw_mask_length":8","mask_length":10,"network_address":"10.0.0.0","subnet":{"router_option":"First IP in the subnet","organization_name":"QAOrg","primary_domain":"test.com", "cloudProviderName":"cloudflare" }}
Create subnet with Enable Discovery:
{ "nw_mask_length":8","mask_length":10,"network_address":"10.0.0.0","subnet":{"router_option":"First IP in the subnet","organization_name":"QAOrg","primary_domain":"test.com", "enable_discovery":"yes", "discovery_template":"Default Discovery Template"}}
Create subnet with Enable Reclaim:
{ "nw_mask_length":8","mask_length":10,"network_address":"10.0.0.0","subnet":{"router_option":"First IP in the subnet","organization_name":"QAOrg","primary_domain":"test.com", "reclaim_objects":"yes", "discovery_template":"Default Discovery Template"}}

Parameters
Type Name Description Schema Default

Body

body
required

Multiple subnets add operation

Multi Subnet Request

Responses
HTTP Code Description Schema

500

TIMS-2008: Both Block address and id cannot be null, TIMS-3101: Block does not exist: <Network Address>, TIMS-1355: Organization id is null, TIMS-1321: Domain does not exist: <Domain Name>, TIMS-1449: Cannot associate a restricted domain : <Domain Name> to the subnet, TIMS-5001: Template already exists, TIMS-2018: Subnet group information does not exist, TIMS-1505: Location information does not exist, TIMS-5035: DHCP Template does not exist: <DHCP Template Name>, TIMS-3058: DHCP Appliance does not exist: <DHCP Appliance Name>, TIMS-7004: Please select a DHCP Template.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.80.4. Deletes IPv6 subnets

POST /ipv6subnet/delete
Description

Deletes one or more IPv6 subnets, provided there are no DNS/DHCP Appliances defined in them.
Below example shows sample request JSON:
[{"fullAddress":"500000000000000B0000000000000000","ipv6Address":"5000:0:0:b::","mask_length":64}]

Parameters
Type Name Description Schema Default

Query

org_name
required

Organization Name

string

Body

body
required

List of IPv6 subnet details

< IPv6 Subnet > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.80.5. IPv6 Subnet Edit

POST /ipv6subnet/edit
Description

Edits the IPv6 subnet and modifies various attributes corresponding to the subnet.
Below example shows sample request JSON:
{ "subnet":{ "name":"tcp-subnet", "fullAddress":"5000:0:0:a::", "ipv6Address":"5000:0:0:a::", "mask_length":null, "primary_domain":"test.com", "routerAddress":"5000:0:0:a::1", "street1":"1416 Sugar Camp Road", "city":"Spring Grove", "state":"MN", "country":"Minnesota", "zip":55974, "primary_dhcp_server":"None", "description":"testing", "template_name":"None" }}

Parameters
Type Name Description Schema Default

Body

body
required

IPv6 subnet details

Multi IPv6 Subnet Request

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.80.6. IPv6 Subnet Details

GET /ipv6subnet/getIpv6SubnetDetails
Description

Provides the details of a specified IPv6 subnet in a network defined in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Query

org_name
required

Required Organization name

string

Query

subnet_address
required

Required Subnet’s Address

string

Responses
HTTP Code Description Schema

200

successful operation

IPv6 Subnet

500

TIMS-7002: Permission information cannot be retrieved., TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.80.7. Get Subnet

GET /ipv6subnet/ip/{address}/{organization_name}
Description

Retrieves the parent subnet information of the current IP address specified in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Path

address
required

Network IP Address

string

Path

organization_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

IPv6 Subnet

500

TIMS-2016: Subnet does not exist: <Subnet Address>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.80.8. Subnet List Page

GET /ipv6subnet/listv6subnet
Description

Returns a JSON list of subnets defined in an IPv6 network.

Parameters
Type Name Description Schema Default

Query

filterRules
optional

Filter String

string

Query

network_ip
required

IP of the Network

string

Query

order
optional

Order (asc/desc)

string

Query

org_name
required

Organization Name

string

Query

page
required

Starting IPv6 Subnet Range

integer(int32)

Query

q
optional

Search String

string

Query

rows
required

Ending IPv6 Subnet Range

integer(int32)

Query

sort
optional

Sort String

string

Responses
HTTP Code Description Schema

200

successful operation

PagedListIPv6 Subnet

500

TIMS-7002: Permission information cannot be retrieved, TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.80.9. Subnet Add Multiple

POST /ipv6subnet/multiadd
Description

Creates multiple subnets by checking if they overlap with the existing subnets in the TCPWave IPAM.
The allowed subnet types are (1)Non-DHCP (2)DHCP Enabled (3)Cloud Hosted
Non-DHCP subnet type can be used to create static objects. DHCP Enabled subnet type is used to create DHCP objects along with static objects and Cloud Hosted subnet type is used to create cloud instances.
When Non-DHCP subnet type is selected, the parameters primary_domain and routerAddress are mandatory.
When DHCP Enabled subnet type is selected,primary_domain, routerAddress, template_name and primary_dhcp_server are mandatory.
When Enable Discovery is set to yes,The Objects present in the subnet will be eligible for discovery.If Enable Discovery is yes then discovery_template is mandatory field.
When Enable Reclaim is set to yes,The objects present in the subnet will be eligible for reclaim validation and the objects that are not pingable in the reclaim period from the current time will be eligible for reclaim.
Sample payloads with mandatory parameters to add a subnet are listed below.
Create NON-DHCP Subnet:
{ "address":["2001:dc0::","2001:dd0::"],"block_mask_length":24,"subnet":{"block_address":"2001:dc0::", "mask_length":"12","organization_name":"QAOrg", "router_option":"First IP in the subnet","primary_domain":"test.com"}}
Create DHCP-Enabled Subnet:
{ "address":[ "2001:dc0::","2001:dd0::"],"block_mask_length":24,"subnet":{"block_address":"10.0.0.0", "mask_length":"12","organization_name":"QAOrg", "router_option":"First IP in the subnet","primary_domain":"test.com", "template_name":"dhcp_option_template","primary_dhcp_server":"TCPWave00002Remote"}}
Create Cloud Hosted Subnet:
{ "address":[ "2001:dc0::","2001:dd0::" ],"block_mask_length":24,"subnet":{"block_address":"10.0.0.0", "mask_length":"12","organization_name":"QAOrg", "router_option":"First IP in the subnet","primary_domain":"test.com", "cloudProviderName":"cloudflare" }}
Create subnet with Enable Discovery:
{ "address":[ "2001:dc0::","2001:dd0::" ],"block_mask_length":24,"subnet":{"block_address":"2001:dd0::", "mask_length":"12","organization_name":"QAOrg", "router_option":"First IP in the subnet","primary_domain":"test.com", "enable_discovery":"yes", "discovery_template":"Default Discovery Template"}}
Create subnet with Enable Reclaim:
{ "address":[ "2001:dc0::","2001:dd0::" ],"block_mask_length":24,"subnet":{"block_address":"2001:dd0::", "mask_length":"12","organization_name":"QAOrg", "router_option":"First IP in the subnet","primary_domain":"test.com", "reclaim_objects":"yes", "discovery_template":"Default Discovery Template"}}

Parameters
Type Name Description Schema Default

Body

body
required

Multiple subnets details

Multi Subnet Request

Responses
HTTP Code Description Schema

500

TIMS-2008: Both Block address and id cannot be null, TIMS-3101: Block does not exist: <Network Address>, TIMS-1355: Organization id is null, TIMS-1321: Domain does not exist: <Domain Name>, TIMS-1449: Cannot associate a restricted domain : <Domain Name> to the subnet, TIMS-5001: Template already exists, TIMS-2018: Subnet group information does not exist, TIMS-1505: Location information does not exist, TIMS-5035: DHCP Template does not exist: <DHCP Template Name>, TIMS-3058: DHCP Appliance does not exist: <DHCP Appliance Name>, TIMS-7004: Please select a DHCP Template.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.80.10. Subnet list page

GET /ipv6subnet/paged
Description

Retrieves the detailed list of subnets of the current network in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

block_addr
required

Network Address

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Order String

string

Query

org_name
required

Organization Name

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting IPv6 Subnet Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListIPv6 Subnet

500

TIMS-3001: An object exists at the given address. Please select an unallocated address, TIMS-3004: Cannot add an object at subnet boundary.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.80.11. Subnet Search

GET /ipv6subnet/search
Description

Search an specified subnet or list of Subnets from search screen in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Query

organizations
required

Organization List

string

Query

page
required

Page

integer(int32)

Query

rows
required

Rows

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListIPv6 Subnet

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.80.12. IPv6 Subnet Split

POST /ipv6subnet/split
Description

Splits a given ipv6 subnet and creates two or more smaller ipv6 subnets of a desired mask length. Note: The DHCP Definitions of the subnet that is being split are removed after the split is effective.
Sample payload with mandatory parameters to split a subnet is listed below.
{ "mask_length":"16", "router_option":"First IP in the subnet","organization_name":"QAOrg", "Address":"5000::"}

Parameters
Type Name Description Schema Default

Body

body
required

Subnet entity for split operation

IPv6 Subnet

Responses
HTTP Code Description Schema

500

TIMS-3088: Server IP address is null, TIMS-2015: Subnet does not exist, TIMS-2017: Choose a mask length greater than <Mask Length>

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.81. IPV6 Template Service

Description

This service class provides REST API access to Create, Modify and Delete an IPv6 DHCP Option Templates in the TCPWave IPAM.

4.81.1. Add IPv6 DHCP Option Template

POST /v6templates/create
Description

Creates a IPv6 DHCP Option Template by performing a sanity check on parameters configured in the template.
Below example shows sample request JSON:
{"template_name":"option-temp","description":"","organization_name":"QAOrg","array_params":[{"display_name":"RAPID COMMIT","value":"yes"},{"display_name":" NIS DOMAIN NAME","value":"tcpwave.com"}]}

Parameters
Type Name Description Schema Default

Body

body
required

IPv6 option template details

Template

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

4.81.2. List Configured Options Of IPv6 DHCP Option Template

GET /v6templates/list-params
Description

Provides a list of IPv6 DHCP Options configured in a given Option Template as well as all the DHCP Options supported by the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Query

organization_name
required

Organization Name

string

Query

template_id
optional

Id of the template

integer(int32)

Query

template_name
required

IPv6 DHCP option template

string

Query

viewAll
required

List of all the option parameters of template

string

Responses
HTTP Code Description Schema

200

successful operation

Template

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.81.3. List IPv6 DHCP Option Templates

GET /v6templates/option-template-list
Description

Obtains a list of all IPv6 DHCP Option Templates defined and managed by the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Query

filterRules
optional

Filter String

string

Query

organizations
optional

Organizations

string

Query

page
required

Starting IPv6 DHCP Option Templates Range

integer(int32)

Query

q
required

match value

string

Query

rows
required

Page Length

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListTemplate

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.81.4. Template Page

GET /v6templates/page/{server_type_code}/{entity_type_code}
Description

Lists all the Templates with pagination for the given Server type code and Entity type code associated with an organization in the TCPWave IPAM. Functional Admin can list the Templates for any organization. Rest of the admins can list the Templates only for the organizations that they are associated with.

Parameters
Type Name Description Schema Default

Path

entity_type_code
required

Entity Type Code

string

Path

server_type_code
required

Server Type Code

string

Query

filterRules
optional

Filter String

string

Query

inEdit
required

In Edit

integer(int32)

Query

organization_name
required

Organization Name

string

Query

page
optional

Starting IPV6 Template Range

integer(int32)

Query

q
optional

Match Value

string

Query

reference_id
optional

Reference Id

integer(int32)

Query

reference_type
required

Reference Type

string

Query

rows
optional

Page Length

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListTemplate Selection Data

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.81.5. Updates IPv6 DHCP Option Template

POST /v6templates/update
Description

Updates a IPv6 DHCP Option Template and performs a sanity check to make sure that the options defined in the template have valid values in it Failing which, the update will be discarded by the TCPWave IPAM. On success, An incremental update is sent to all the DHCP Appliances that have scopes and Manual DHCP Objects associated to the template.
Below example shows sample request JSON:
{"template_name":"option-temp","description":"","organization_name":"QAOrg","old_template_name":"option-template","array_params":[{"display_name":"RAPID COMMIT","value":"yes"},{"display_name":" NIS DOMAIN NAME","value":"tcpwave.com"}]}

Parameters
Type Name Description Schema Default

Body

body
required

IPv6 DHCP option template details

Template

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

4.81.6. IPv6 Template Parameter Name Search

GET /v6templates/v6params-name/search
Description

Searches for DNS/DHCP Template Parameter Names in the TCPWave IPAM based on the given text input.

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Template Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListTemplate

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.81.7. IPv4 Template Parameter Value Search

GET /v6templates/v6params-value/search
Description

Searches for DNS/DHCP IPv6 Template Parameter Value in the TCPWave IPAM based on the given text input.

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Template Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListTemplate

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.82. IPv6 Audit Report Service

Description

This class contains information related to all IPv6 reports. The class includes grid functionality, download reports in CSV format, PDF format, send reports via email to the selected contacts in PDF format , schedules email in a specific time and provides list of all dropdowns for all audit reports.

4.82.1. CSV Report

POST /v6auditreports/csvreport
Description

Provides a CSV file for audit reports present in the TCPWave IPAM.
Below example shows sample request JSON:
"string"

Parameters
Type Name Description Schema Default

Query

action
required

Operation executed by Admin

string

Body

body
optional

Audit Report

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-9314: Export to CSV failed.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.82.2. Email Report

POST /v6auditreports/emailreport
Description

User can send the generated audit report to the email address of the contacts present in the TCPWave IPAM.
Below example shows sample request JSON:
{ "userId": 1224, "serverName": "TCPWave00002Remote", "serverIp": "10.0.0.5", "clientIp": "127.0.0.2", "mask": 24, "patch": "string", "admin_jobs": "Rest", "execution_status": "success/failure", "execution_time": "2019-02-04 05:24:00", "adminName": "john", "adminRole": "FADM", "action": "create/modify/delete", "vlan_id": "2456", "email_recipients": "abc@def.com", "server_type": "BIND AUTH/DHCP", "service_name": "abcservice", "host_address": "10.1.10.241", "host_name": "abcd", "network_status": "active/deleted", "dropdown_status": "active/deleted", "config_name": "abc", "param_val": "abc", "optionTempl": "optiontemplate", "asso_type": "abc", "param_domainName": "abc", "organization": "Earth", "subnet_group": "subnetgrp", "actionType": "success/failure", "obj_count": 12, "zone_name": "abc.com", "rows": 12, "stealth_server": 12, "internal_cache_server": 12, "dmz_visible": "0/1", "monitoring_service": "CHECK_MONIT", "subnet_id": 1241, "view_name": "abcview", "host_id": 1241, "domain": "abc.com", "record_type": "SOA", "source_ip": "10.1.10.241", "login_time": "2019-02-01 05:06:14", "logout_time": "2019-02-01 05:06:14", "ip_address": "10.1.10.241", "name": "abc", "proxy": 12, "macAddress": "65:e1:44:a6:85:7b", "change_ticket": "abc123", "contact_first_name": "string", "contact_last_name": "string", "mailsHeading": "string", "xmlFileName": "string", "fileName": "audit_history_attachment_backup_4_2019.csv"}

Parameters
Type Name Description Schema Default

Body

body
optional

Audit Report

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-9312: Current selection exceeds the allowable Email size. Please modify your criteria or use CSV file download.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.82.3. IPv6 Network List (Audit Report)

GET /v6auditreports/ipv6Network
Description

Obtains a list of existing IPv6 networks and deleted IPv6 networks for auditing purposes.
The example listed below shows a sample request URL:
/rest/v6auditreports/ipv6Network

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.82.4. IPv6 Subnet List (Audit Report)

GET /v6auditreports/ipv6Subnet
Description

Obtains a list of existing IPv6 networks and deleted IPv6 networks for auditing purposes.
The example listed below shows a sample request URL:
/rest/v6auditreports/ipv6Subnet

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.82.5. IPv6 DHCP Appliance List

GET /v6auditreports/ipv6dhcpserverlist
Description

Provides a list of existing IPv6 DHCP Appliances and deleted IPv6 DHCP Appliances for auditing purposes.
Below is the example request:
/tims/rest/v6auditreports/ipv6dhcpserverlist?actionType=active

Parameters
Type Name Description Schema Default

Query

actionType
required

Action type(active/deleted)

string

Query

organization
required

Organization

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.82.6. IPv6 Subnet Template List

GET /v6auditreports/ipv6subnetTemplatelist
Description

Provides a list of existing IPv6 Subnet Templates and deleted IPv6 Subnet Templates for auditing purposes.
Below is the example request:
/tims/rest/v6auditreports/ipv6subnetTemplatelist?actionType=active

Parameters
Type Name Description Schema Default

Query

actionType
required

Action type(active/deleted)

string

Query

organization
required

Oraganization

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.82.7. DHCP IPv6 Appliance List

GET /v6auditreports/livev6appliancelist
Description

Provides a list of existing DHCP IPv6 Appliance List.
Below is the example request:
/tims/rest/v6auditreports/livev6appliancelist?organization=Internal

Parameters
Type Name Description Schema Default

Query

organizations
required

Organization

string

Responses
HTTP Code Description Schema

200

successful operation

< Server Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.82.8. PDF Report

POST /v6auditreports/pdfreport
Description

Provides a PDF format report for the audit report in the TCPWave IPAM.
Below example shows sample request JSON:
{ "userId": 1224, "serverName": "TCPWave00002Remote", "serverIp": "10.0.0.5", "clientIp": "127.0.0.2", "mask": 24, "patch": "string", "admin_jobs": "Rest", "execution_status": "success/failure", "execution_time": "2019-02-04 05:24:00", "adminName": "john", "adminRole": "FADM", "action": "create/modify/delete", "vlan_id": "2456", "email_recipients": "abc@def.com", "server_type": "BIND AUTH/DHCP", "service_name": "abcservice", "host_address": "10.1.10.241", "host_name": "abcd", "network_status": "active/deleted", "dropdown_status": "active/deleted", "config_name": "abc", "param_val": "abc", "optionTempl": "optiontemplate", "asso_type": "abc", "param_domainName": "abc", "organization": "Earth", "subnet_group": "subnetgrp", "actionType": "success/failure", "obj_count": 12, "zone_name": "abc.com", "rows": 12, "stealth_server": 12, "internal_cache_server": 12, "dmz_visible": "0/1", "monitoring_service": "CHECK_MONIT", "subnet_id": 1241, "view_name": "abcview", "host_id": 1241, "domain": "abc.com", "record_type": "SOA", "source_ip": "10.1.10.241", "login_time": "2019-02-01 05:06:14", "logout_time": "2019-02-01 05:06:14", "ip_address": "10.1.10.241", "name": "abc", "proxy": 12, "macAddress": "65:e1:44:a6:85:7b", "change_ticket": "abc123", "contact_first_name": "string", "contact_last_name": "string", "mailsHeading": "string", "xmlFileName": "string", "fileName": "audit_history_attachment_backup_4_2019.csv"}

Parameters
Type Name Description Schema Default

Body

body
optional

Audit Report

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-9313: Current selection exceeds the allowable PDF rows limit than the global option default page rows. Please modify your criteria or use CSV file download.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.82.9. IPv6 Report chart list

GET /v6auditreports/reportchartlist
Description

Obtains a list to display the chart for reports.
Below is the example request:
/tims/rest/v6auditreports/reportchartlist?actionType=active&org_id=1641&draw=1&start=0&length=10&filterRules=[{"field":"networkAddress","op":"contains","value":"2"}]

Parameters
Type Name Description Schema Default

Query

actionType
optional

Action type

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

fromDate
required

Starting date for fetching records

string

Query

ipAddress_domainName
optional

IP address or domain name

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

order param(asc/desc)

string

Query

org_id
optional

Organization ID

integer(int32)

Query

organization
optional

Organization Name

string

Query

period
optional

period

string

Query

reportType
required

Report types (Network/subnet/object etc)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Page Number

integer(int32)

Query

toDate
required

Ending date for fetching records

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.82.10. IPv6 Audit

GET /v6auditreports/reportlist
Description

Obtains a list of IPv6 reports in grid for the audit reports in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/v6auditreports/reportlist?reportType=Network&fromDate=2020/10/22&toDate=2020/11/22&ipAddress_domainName=domain.com&org_id=1400&organization=Internal&draw=1&start=1&length=20&action=active&filterRules=

Parameters
Type Name Description Schema Default

Query

action
required

Action performed

string

Query

actionType
optional

Action Type(active/deleted)

string

Query

draw
required

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

fromDate
required

From Date

string

Query

ipAddress_domainName
required

Domain name

string

Query

length
required

Page Length

integer(int32)

Query

mask_length
optional

Mask Length

integer(int32)

Query

order
optional

order param(asc/desc)

string

Query

org_id
required

Organization ID

integer(int32)

Query

organization
required

Organization Name

string

Query

reportType
required

Report types (Network/subnet/object etc)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Report Range

integer(int32)

Query

toDate
required

Up to Date

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

500

TIMS-8059: Please select report start date. TIMS-8060: Please select report end date.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.82.11. Schedule Report Email

POST /v6auditreports/sched_emailreport
Description

User can Schedule the time to email the report in PDF format to the email address of the contacts present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/v6auditreports/sched_emailreport?repeat=1&frequency=1&runtime=2029-12-01 05:06:14&starttime=2029-12-01 04:06:14&endtime=2029-12-01 06:06:14&day=2&description=test&repeatInterval=12546&repeatCount=2&adminName=admin&adminRole=SADM
Below example shows sample request JSON:
{ "userId": 1224, "serverName": "TCPWave00002Remote", "serverIp": "10.0.0.5", "clientIp": "127.0.0.2", "mask": 24, "patch": "string", "admin_jobs": "Rest", "execution_status": "success/failure", "execution_time": "2019-02-04 05:24:00", "adminName": "john", "adminRole": "FADM", "action": "create/modify/delete", "vlan_id": "2456", "email_recipients": "abc@def.com", "server_type": "BIND AUTH/DHCP", "service_name": "abcservice", "host_address": "10.1.10.241", "host_name": "abcd", "network_status": "active/deleted", "dropdown_status": "active/deleted", "config_name": "abc", "param_val": "abc", "optionTempl": "optiontemplate", "asso_type": "abc", "param_domainName": "abc", "organization": "Earth", "subnet_group": "subnetgrp", "actionType": "success/failure", "obj_count": 12, "zone_name": "abc.com", "rows": 12, "stealth_server": 12, "internal_cache_server": 12, "dmz_visible": "0/1", "monitoring_service": "CHECK_MONIT", "subnet_id": 1241, "view_name": "abcview", "host_id": 1241, "domain": "abc.com", "record_type": "SOA", "source_ip": "10.1.10.241", "login_time": "2019-02-01 05:06:14", "logout_time": "2019-02-01 05:06:14", "ip_address": "10.1.10.241", "name": "abc", "proxy": 12, "macAddress": "65:e1:44:a6:85:7b", "change_ticket": "abc123", "contact_first_name": "string", "contact_last_name": "string", "mailsHeading": "string", "xmlFileName": "string", "fileName": "audit_history_attachment_backup_4_2019.csv"}

Parameters
Type Name Description Schema Default

Query

adminName
required

Name of Network Admin who is scheduling the email

string

Query

adminRole
required

Role of the Admin (FADM/SADM/UADM/RADM)

string

Query

day
required

Day of Execution of the scheduled operation

integer(int32)

Query

description
required

Description about the scheduled operation

string

Query

endtime
required

Ending time for executing the scheduled operation

string

Query

frequency
required

Frequency of the scheduled operation

string

Query

repeat
required

Occurrences of the scheduled operation

integer(int32)

Query

repeatCount
required

Count for repetition of scheduled operation

integer(int32)

Query

repeatInterval
required

Time duration between repetition of the scheduled operation

integer(int64)

Query

runtime
required

Execution time of the scheduled operation

string

Query

starttime
required

Starting time for executing the scheduled operation

string

Body

body
optional

Audit Report

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.82.12. IPv6 Block List

GET /v6auditreports/v6blocklist
Description

Obtains a list of existing IPv6 block and deleted IPv6 block for auditing purposes in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/v6auditreports/v6blocklist?org_id=1544&actionType=active&q=abc

Parameters
Type Name Description Schema Default

Query

actionType
required

Action type

string

Query

org_id
optional

Organization ID

integer(int32)

Query

page
optional

Total pages

integer(int32)

Query

q
required

Search string

string

Query

rows
optional

Rows per page

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListAudit Report Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.82.13. IPv6 Option Template List (Audit Report)

GET /v6auditreports/v6dhcpoptiontmpllist
Description

Obtains a list of existing DHCP IPv6 Option Templates and deleted DHCP IPv6 Option Templates for auditing purposes.
The example listed below shows a sample request URL:
/rest/v6auditreports/v6dhcpoptiontmpllist

Parameters
Type Name Description Schema Default

Query

actionType
required

Action type(active/deleted)

string

Query

organization
required

Organization

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.82.14. IPv6 DNS Servers List

GET /v6auditreports/v6dnsserverslist
Description

Provides a list of existing IPv6 DNS servers and deleted IPv6 DNS servers for auditing purposes.
Below is the example request:
/tims/rest/v6auditreports/v6dnsserverslist?actionType=active&organization=Internal

Parameters
Type Name Description Schema Default

Query

actionType
required

Action type(active/deleted)

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.82.15. IPv6 Network List

GET /v6auditreports/v6networkslist
Description

Obtains a list of existing IPv6 networks and deleted IPv6 networks for auditing purposes in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/v6auditreports/v6networkslist?actionType=active&q=abc

Parameters
Type Name Description Schema Default

Query

actionType
required

Action type

string

Query

org_id
optional

Organization ID

integer(int32)

Query

page
optional

Total pages

integer(int32)

Query

q
required

Search string

string

Query

rows
optional

Rows per page

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListAudit Report Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.82.16. IPv6 Reverse Zones List

GET /v6auditreports/v6revzonelist
Description

Provides a list of existing IPv6 Reverse Zones and deleted IPv6 Reverse zones for auditing purposes.
Below is the example request:
/tims/rest/v6auditreports/v6revzonelist?actionType=active&organization=Internal

Parameters
Type Name Description Schema Default

Query

actionType
required

Action type(active/deleted)

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Audit Report Details > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.82.17. IPv6 Subnet Group List (Audit Report)

GET /v6auditreports/v6subnetgrplist
Description

Obtains a list of existing IPv6 subnet groups and deleted IPv6 subnet groups for auditing purposes.
The example listed below shows a sample request URL:
/rest/v6auditreports/v6subnetgrplist?rows=10&page=1&q=abc

Parameters
Type Name Description Schema Default

Query

org_id
optional

Organization ID

integer(int32)

Query

page
required

Total pages

integer(int32)

Query

q
required

Search string

string

Query

rows
required

Rows per page

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListAudit Report Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.83. IPv6 IPAM Template Service

4.83.1. IPAM Template List

GET /v6IPAMTemplate/get
Description

Provides the list of IPv6 IPAM Templates
The example listed below shows a sample request URL:
/rest/v6IPAMTemplate/get

Responses
HTTP Code Description Schema

200

successful operation

V6IPAMTemplate

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.84. IPv6 Policy Compliance Service Details

4.84.1. IPv6 Appliances Policy Compliance Information

GET /v6policyCompliance/list
Description

This operation retrieves the list of IPv6 policy compliance information for DNS/DHCP/IPAM appliances.
To list the policy compliance information on a specific DNS appliance, users must specify server_type parameters as 'BIND AUTH', 'BIND CACHE', 'UNBOUND', 'NSD' or 'DNS PROXY'. To list the policy compliance information on all the DNS appliances or any particular appliance group or all the appliance groups, users must specify the server_type parameter as DNS. To list the policy compliance information on DHCP appliance(s), the server_type parameter must be specified as DHCP. To list the policy compliance information on IPAM appliance(s), the server_type parameter must be specified as IPAM.
The following examples shows a sample request URLs:

The following is the sample URL to list checkout information for a BIND AUTH type appliance.
rest/checkouts/list?applianceType=BIND AUTH&applianceAddress=172.16.0.13&level=appliance&orgName=TCPWave

The following is the sample URL to list checkout information for all the DNS appliances.
rest/v6policyCompliance/list?applianceType=DNS&level=appliance

The following is the sample URL to list checkout information for all the DNS appliances which are associated with any appliance group.
rest/v6policyCompliance/list?applianceType=DNS&level=appliance_group&orgName=TCPWave

the following is the sample URL to list checkout information for all the DNS appliances which are associated with specified appliance group.
rest/v6policyCompliance/list?applianceType=DNS&level=appliance_group&applianceGroup=Group_Name&orgName=TCPWave

Parameters
Type Name Description Schema Default

Query

applianceAddress
optional

IP Address of the IPAM/DNS/DHCP Appliance

string

Query

applianceGroup
optional

Appliance Group Name

string

Query

applianceId
optional

ID of the DNS/DHCP Appliance

integer(int32)

Query

applianceName
optional

Name of the DHCP Appliance

string

Query

applianceType
required

Type of the Appliance

string

Query

draw
optional

Pagination Rendering Parameter

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

level
required

Level type. Takes either appliance or appliance_group

string

Query

order
optional

Sort Order(asc/desc)

string

Query

orgName
optional

Appliance Group organization

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Contact Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListPolicy Compliance Entity

500

TIMS-7003: You are not authorized to perform this operation, TIMS-3038: Appliance Type is not valid: {0}

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.84.2. Policy Compliance checks.

POST /v6policyCompliance/run
Description

This operation performs DNS/DHCP/IPAM Policy Compliance checks
To run policy compliance check on a specific DNS appliance, server_type parameter must be specified as 'BIND AUTH', 'BIND CACHE', 'UNBOUND', 'NSD' or 'DNS PROXY'.To run policy compliance check on all the DNS appliances or any particular appliance group or all the appliance groups, server_type parameter must be specified as DNS. To run policy compliance check on DHCP appliance(s), server_type parameter must be specified as DHCP. To run policy compliance check on IPAM appliance(s), server_type parameter must be specified as IPAM.
The following examples shows a sample request URLs:

The following is the sample URL to run checkout operation for a BIND CACHE type appliance.
rest/v6policyCompliance/run?applianceType=BIND CACHE&applianceAddress=172.16.0.13&level=appliance&orgName=TCPWave

The following example is the sample URL to run checkout operation for all the DNS appliances.
rest/v6policyCompliance/run?applianceType=DNS&level=appliance&orgName=TCPWave

The following is the sample URL to run checkout operation for all the DNS appliances which are associated with any appliance group.
rest/v6policyCompliance/run?applianceType=DNS&level=appliance_group&orgName=TCPWave

The following is the sample URL to run checkout operation for all the DNS appliances which are associated with specified appliance group.
rest/v6policyCompliance/run?applianceType=DNS&level=appliance_group&applianceGroup=Group_Name&orgName=TCPWave

Parameters
Type Name Description Schema Default

Query

applianceAddress
optional

IP Address of the DNS Appliance

string

Query

applianceGroup
optional

Appliance Group Name

string

Query

applianceName
optional

Name of the DHCP Appliance

string

Query

applianceType
required

Type of the Appliance

string

Query

level
required

Level type. Takes either appliance or appliance_group

string

Query

orgName
optional

Appliance Group organization

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-3038: Appliance Type is not valid: {0}

No Content

Consumes
  • text/plain

  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.85. IPv6 Subnet Template Service

Description

This service provides API's to manage Ipv6 Subnet Templates in the TCPWave IPAM.

4.85.1. IPv6 Subnet Template Add

POST /v6subnet_template/add
Description

Creates a new IPv6 Subnet Template that can be used during creation of IPv6 subnets in TCPWave IPAM.
Below example shows sample request JSON:
{"name":"v6_subnet_template_1","organizationName":"Internal","primaryDomain":"Domainpostman","dhcpServerName":"","dhcpOptionTemplateName":"","subnetType":"1","routerOption":"first","description":"","addressAllocationList":[{"v6StartOffset":"10","v6EndOffset":"20","domain":"Domainpostman","classCode":"3G Phone","allocationType":"1","clientClassAllow":"","clientClassDeny":"","userClassAllow":"","userClassDeny":"","vendorClassAllow":"","vendorClassDeny":"","ttl":"1200"}]}

Parameters
Type Name Description Schema Default

Body

body
required

IPv6 Subnet Template details.

Subnet Template

Responses
HTTP Code Description Schema

500

TIMS-1020: Organization does not exist, TIMS-7003: You are not authorized to perform this operation, TIMS-5006: Template already exists: {Template Name}, TIMS-11057: Invalid router option specified.

No Content

Consumes
  • application/json

  • application/xml

4.85.2. IPv6 Subnet Template Delete

POST /v6subnet_template/delete
Description

Deletes the specified IPv6 subnet template.
The example listed below shows a sample request URL:
/v6subnet_template/delete?name=v6_subnet_template_1&org_name=Internal

Parameters
Type Name Description Schema Default

Query

name
required

Name

string

Query

org_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Subnet Template

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

  • application/json

Produces
  • application/json

  • application/xml

4.85.3. IPv6 Subnet Template Get

GET /v6subnet_template/details
Description

Fetches the details of an IPv6 subnet template.
The example listed below shows a sample request URL:
/rest/v6subnet_template/details?org_name=Internal&name=testTemplate

Parameters
Type Name Description Schema Default

Query

name
required

Name

string

Query

org_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Subnet Template

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.85.4. Update IPv6 Subnet Template

POST /v6subnet_template/edit
Description

Update an existing IPv6 Subnet Template that can be used during creation of IPv6 subnets in TCPWave IPAM.
Below example shows sample request JSON:
{"oldName":"v6_subnet_template_1","name":"v6_subnet_template_1","organizationName":"Internal","primaryDomain":"Domainpostman","dhcpServerName":"","dhcpOptionTemplateName":"","subnetType":"1","routerOption":"first","description":"Subnet Template Edit","addressAllocationList":[{"v6StartOffset":10,"v6EndOffset":20,"classCode":"3G Phone","allocationType":1,"domain":"Domainpostman","ttl":1200}]}

Parameters
Type Name Description Schema Default

Body

body
required

IPv6 Subnet Template details.

Subnet Template

Responses
HTTP Code Description Schema

500

TIMS-1020: Organization does not exist, TIMS-7003: You are not authorized to perform this operation, TIMS-5006: Template already exists: {Template Name}, TIMS-11057: Invalid router option specified.

No Content

Consumes
  • application/json

  • application/xml

4.85.5. IPv6 Subnet Template List

GET /v6subnet_template/list
Description

Fetches the list of IPv6 subnet templates.
The example listed below shows a sample request URL:
/rest/v6subnet_template/list?organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

organizations

string

Responses
HTTP Code Description Schema

200

successful operation

< Subnet Template > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.85.6. IPv6 Subnet Template List By Organization

GET /v6subnet_template/p_listbyorg
Description

Obtains a list of all IPv6 subnet templates that are associated to a specified Organization.
The example listed below shows a sample request URL:
/v6subnet_template/p_listbyorg?start=1&length=20&org_name=Internal

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

inSubnetEdit
optional

In Subnet Edit

string

Query

length
required

Ending Subnet Template Range

integer(int32)

Query

order
optional

Sorting Order(asc/desc)

string

Query

org_id
optional

Organization Id

integer(int32)

Query

org_name
required

Organization Name

string

Query

q
required

Match Value

string

Query

sort
optional

Sorting String

string

Query

start
required

Starting Subnet Template Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListSubnet Template

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist:<Organization Name>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.85.7. List of IPv6 Subnet Template Search Elements

GET /v6subnet_template/search
Description

Returns a list of IPv6 subnet template searched by User in the TCPWave IPAM.
The example listed below shows a sample request URL:
/v6subnet_template/search?start=1&length=20

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Subnet_Template Object Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListSubnet Template

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.86. Import Cloud Service

Description

This Service avails facility of Importing entities such as Subnet, Object etc in the TCPWave IPAM.

4.86.1. Import from cloud

POST /importcloud/import
Description

Import subnets or objects from cloud
Below example shows sample request JSON:
[{"cloudProvider":101,"orgName":"Internal"}]

Parameters
Type Name Description Schema Default

Body

body
optional

< Import Instances From Cloud Subnet > array

Responses
HTTP Code Description Schema

200

successful operation

Import Cloud Response

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.86.2. Page

GET /importcloud/subnet/page
Description

The example listed below shows a sample request URL:
/rest/importcloud/subnet/page?organization=Internal

Parameters
Type Name Description Schema Default

Query

draw
optional

Pagination Rendering Parameter

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organization
optional

Organization Name

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Service Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListCloud Hosted Subnet

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.86.3. updateAutoImportSubnets

POST /importcloud/updateAutoImportSubnets
Description

Below example shows sample request JSON:
"["string"]"

Parameters
Type Name Description Schema Default

Body

body
optional

< string > array

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.87. Import Service

Description

This service provides facility to import data from CSV files in the TCPWave the IPAM.

4.87.1. Comma Separated Files Name

GET /import/checkAndDeleteExistingFile
Description

Check files existence. /tmp/acl.out,/tmp/acl.err,/tmp/failed-acl.csv

Parameters
Type Name Description Schema Default

Query

files
required

Comma Separated Files Name

string

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.87.2. Download the file

GET /import/downloadFile
Description

Download the file from /tmp directory from UI

Parameters
Type Name Description Schema Default

Query

fileName
required

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.87.3. Import Field’s Type

GET /import/fields
Description

Supported Import Fields in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/import/fields?type=remote_license

Parameters
Type Name Description Schema Default

Query

type
required

Supported Field Types

string

Responses
HTTP Code Description Schema

200

successful operation

< Column Metadata > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.87.4. Supported Import File Types

GET /import/supported_types
Description

Supported Import File types in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/import/supported_types

Responses
HTTP Code Description Schema

200

successful operation

< Import Type Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.87.5. Import

POST /import/{type}
Description

Import data from csv files into the TCPWave IPAM.{"input_file":"string","output_file":"string","error_file":"string","max_permissible_errors":0,"failed_entries_file":"string"}

Parameters
Type Name Description Schema Default

Path

type
required

Import File Type

string

Body

body
optional

Import Command

Responses
HTTP Code Description Schema

200

successful operation

Import Response Information

Consumes
  • application/json

Produces
  • application/json

  • application/xml

4.88. Internet Root Hints Service

Description

This service provides API's to list, add, update and delete the names and addresses of root DNS servers available in the root hint file in the TCPWave IPAM.

4.88.1. Internet Root Hint Edit

POST /roothints/edit
Description

Updates the names and address of root DNS Appliances that are defined in the root hint file available in the TCPWave IPAM.
Below example shows sample request JSON:
{"id":23,"zoneName":".","ttl":3600000,"ns":"A.ROOT-SERVERS.NET.","ipv4":"198.41.0.4","ipv6":"2001:503:ba3e::2:30","description":"FORMERLY NS.INTERNIC.NET"}

Parameters
Type Name Description Schema Default

Body

body
optional

Internet Root Hint

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-1318: Both Internet Root Hints id and NS should not be null, TIMS-1319: Internet Root Hints id cannot find for given NS: <The given NS>.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.88.2. Internet Root Hint List

GET /roothints/list
Description

List all the Internet Root Hint.Lists the names and addresses of root DNS Appliances available in the root hint file of the TCPWave IPAM. It contains the names and addresses of root DNS Appliances.
The example listed below shows a sample request URL:
/rest/roothints/list

Responses
HTTP Code Description Schema

200

successful operation

< Internet Root Hint > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.88.3. Internet Root Hints Sync

GET /roothints/sync
Description

Synchronizes the names and address of root DNS Appliances defined in the root hint file with the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/roothints/sync

Responses
HTTP Code Description Schema

200

successful operation

< InternetRootHints Sync > array

500

TIMS-7003: You are not authorized to perform this operation, TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist: <Given Organization ID>, TIMS-3050: Both server id and address cannot be null, TIMS-5013: Template Name is null, TIMS-3090: Both server id and name cannot be null, TIMS-3092: Server does not exist: <Given server>.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.89. Location Service

Description

Provides the information that is relevant to a location such as the street, address, city, state , zip code etc.

4.89.1. Add Location

POST /location/add
Description

Creates a new Location. Functional Admin can create a location for any organization. Rest of the admins can create locations only for the organizations that they are associated with.
Below example shows sample request JSON:
{ "organization_name":"QAOrg", "street1":"1416 Sugar Camp Road", "street2":"","city":"Spring Grove", "state":"MN", "zip":"55974", "country":"Minnesota" }

Parameters
Type Name Description Schema Default

Body

body
optional

Locations

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist, TIMS-1020: Both Organization name and id cannot be null.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.89.2. Delete Location

POST /location/delete
Description

Deletes an existing Location in the TCPWave IPAM. Functional Admin can delete a location for any organization. Rest of the admins can create locations only for the organizations that they are associated with.
Below example shows sample request JSON:
{"organization_name":"QAOrg","street1":"1417 Sugar Camp Road","street2":"","city":"Spring Grove","state":"MN","zip":"55974","country":"Minnesota","full_location":"1417 Sugar Camp Road, Spring Grove, MN, Minnesota, 55974"}

Parameters
Type Name Description Schema Default

Body

body
optional

Locations

Responses
HTTP Code Description Schema

500

TIMS-1504: Location does not exist, TIMS-1354: Organization does not exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.89.3. Get Location

POST /location/get
Description

Lists the locations associated with an organization in the TCPWave IPAM.
Below example shows sample request JSON:
{ "organization_name": "QAOrg1","street1" : "1416 Sugar Camp Road","street2" : "","city" : "Spring Grove", "state" : "MN","country" : "Minnesota","zip" : "55974" }

Parameters
Type Name Description Schema Default

Body

body
optional

Locations

Responses
HTTP Code Description Schema

200

successful operation

Locations

500

TIMS-1504: Location does not exist. TIMS-1354: Organization does not exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.89.4. Get Location

GET /location/getFullLocations
Description

Provides the properties of a specified IPv6 network in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/location/getFullLocations?page=1&rows=20&q=abc

Parameters
Type Name Description Schema Default

Query

draw
required

Page Draw Param

integer(int32)

Query

inEdit
required

If edit location is enabled

integer(int32)

Query

length
required

Size

integer(int32)

Query

organization_id
optional

ID of the Organization

string

Query

organization_name
optional

Name of the Organization

string

Query

page
required

Total pages

integer(int32)

Query

q
required

Search String to get Location

string

Query

rows
required

integer(int32)

Query

start
required

Start

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListLocations

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.89.5. Location List References

POST /location/locationReferences
Description

Lists all the Locations which are referenced in the TCPWave IPAM.
Below example shows sample request JSON:
{"id":22,"organization_id":3401,"organization_name":"QAOrg","street1":"22 Main street","street2":"Opp. white mall","city":"WARNERTOWN","state":"Sydney","zip":"5540","country":"Australia","new_street1":"32 Main street","new_street2":"Opp. Red Bungalow","new_city":"Toronto","new_state":"Ontario","new_zip":"6580","new_country":"Canada","full_location":"22 Main street, Opp. white mall, WARNERTOWN, Sydney, Australia-5540"}

Parameters
Type Name Description Schema Default

Body

body
optional

Locations

Responses
HTTP Code Description Schema

200

successful operation

< Location References > array

Consumes
  • application/json

  • text/plain

Produces
  • application/json

  • application/xml

4.89.6. Location List References

GET /location/references
Description

Lists all the Locations which are referenced in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/location/references?tables=1&id=20&count=abc

Parameters
Type Name Description Schema Default

Query

count
required

Total Count param

string

Query

id
required

Reference ID

string

Query

page
optional

Page

integer(int32)

Query

rows
optional

Rows

integer(int32)

Query

tables
required

Reference Table

string

Responses
HTTP Code Description Schema

200

successful operation

Reference Results

Consumes
  • application/json

  • text/plain

Produces
  • application/json

  • application/xml

4.89.7. Search Location

GET /location/search
Description

Provides the list of searched locations on search screen in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/location/search?page=1&rows=20

Parameters
Type Name Description Schema Default

Query

organizations
required

Organization List

string

Query

page
required

Total page

integer(int32)

Query

rows
required

Rows per page

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListLocations

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.89.8. Edit Location

POST /location/update
Description

Updates an existing location in the TCPWave IPAM.Functional Admin can edit a location for any organization. Rest of the admins can create locations only for the organizations that they are associated with.
Below example shows sample request JSON:
{ "street1":"1416 Sugar Camp Road street","street2":"","city":"Spring Grove City","state":"MN","zip":"55874","country":"Minnesota" }

Parameters
Type Name Description Schema Default

Body

body
optional

Locations

Responses
HTTP Code Description Schema

500

TIMS-1360: No changes detected to update, TIMS-1501: Please select a single location to edit.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.90. Log Category Service

Description

This Service provides Logger Category information. The information includes the Id, Name and its description.

4.90.1. Log Categories List

GET /logcat/list
Description

Obtains a list of all the Log Categories defined and managed by the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/logcat/list

Responses
HTTP Code Description Schema

200

successful operation

< Logger Category > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.91. Log Channel Service

Description

This Service class provides information about Log Channel. This includes log channel name, type, version, severity and debug level etc.

4.91.1. Add Log Channel

POST /logchannel/add
Description

Creates a new log channel in the TCPWave IPAM.
Below example shows sample request JSON:
{ "id": 21, "channel": "named", "type": 0, "type_string": "SYSLOG", "versions": 6, "size": 1024000, "facility": "syslog", "severity": 1, "print_time": true, "print_severity": true, "print_category": true, "special_channel": false, "severity_text": "debug", "debug_level": 0, "file_path": "/var/named/log/named.log"}

Parameters
Type Name Description Schema Default

Body

body
optional

Logger Channel

Responses
HTTP Code Description Schema

500

TIMS-1304: Log channel already exists: <Channel Name>

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.91.2. Delete Log Channels

POST /logchannel/delete
Description

Deletes an existing log channel defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/logchannel/delete?channel=test

Parameters
Type Name Description Schema Default

Query

channel
required

Channel Name

string

Query

id
optional

Channel ID

integer(int32)

Responses
HTTP Code Description Schema

500

TIMS-1305: Log channel in use. Please remove the references from DNS Appliances and retry: <channel name>

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.91.3. Delete Multiple Log Channels

POST /logchannel/deleteAll
Description

Deletes the specified log channels defined in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Body

body
optional

< string > array

Responses
HTTP Code Description Schema

500

TIMS-1301: Both channel Id and Name cannot be null. TIMS-1302: Specified log channel not found <channel name>. TIMS-1303: Cannot delete special channel <channel name>. TIMS-1305: Log channel in use. Please remove the references from DNS Appliances and retry: <channel name>
Below example shows sample request:
"[logchannel]"

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.91.4. Update Log Channels

POST /logchannel/edit
Description

Updates an existing log channel defined in the TCPWave IPAM.
Below example shows sample request JSON:
{ "id": 21, "channel": "named", "type": 0, "type_string": "SYSLOG/FILE/STDERR/ NULL", "versions": 6, "size": 1024000, "facility": "syslog", "severity": 1, "print_time": true, "print_severity": true, "print_category": true, "special_channel": false, "severity_text": "debug", "debug_level": 0, "file_path": "/var/named/log/named.log"}

Parameters
Type Name Description Schema Default

Body

body
optional

Logger Channel

Responses
HTTP Code Description Schema

500

TIMS-1304: Log channel already exists: <Channel Name>

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.91.5. Get Log Channel

GET /logchannel/get
Description

Provides the details of the specified log channel defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/logchannel/get?channel=test

Parameters
Type Name Description Schema Default

Query

channel
required

channel name

string

Responses
HTTP Code Description Schema

200

successful operation

Logger Channel

500

TIMS-1302: Log channel does not exist, TIMS-1301: Both channel name and id cannot be null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.91.6. List of Log Channel

GET /logchannel/list
Description

Provides the list of all Log Channels defined in the TCPWave IPAM. Functional Admin gets the list of all log channels. Rest of the Admins get only the list of log channels associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/logchannel/list?organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization Names

string

Responses
HTTP Code Description Schema

200

successful operation

< Logger Channel > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.91.7. Log Channel References

GET /logchannel/references
Description

Finds the list of Log Channels that are referenced in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/logchannel/references?page=1&rows=20&tables=tableName&id=tableId&count=25

Parameters
Type Name Description Schema Default

Query

count
required

total records found

string

Query

id
required

reference ID

string

Query

page
required

total pages

integer(int32)

Query

rows
required

rows per page

integer(int32)

Query

tables
required

reference table

string

Responses
HTTP Code Description Schema

200

successful operation

Reference Results

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.91.8. Search Log Channels

GET /logchannel/search
Description

Searches for a DNS Log Channels defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/logchannel/search?page=1&rows=20

Parameters
Type Name Description Schema Default

Query

page
required

total pages

integer(int32)

Query

rows
required

rows per page

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListLogger Channel

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.92. Manage Appliance Services

Description

This service provides API's to Start/Stop/Restart services on Remote Appliance.

4.92.1. Appliance Status

POST /services/getStatus
Description

Method to get status of services on multiple Remote Appliances.
Below example shows sample request JSON:
[ { "id": 21, "is_primary": "0/1", "object_id": 101, "name": "Test-appliance", "organization_id": 101, "organization_name": "Internal", "v4_ipaddress": "192.168.0.101", "server_type": "DHCP/BIND AUTH/BIND CACHE/NSD", "dhcpd": "yes/no", "dns": "yes/no", "monit": "yes/no", "bgpd": "yes/no", "ospfd": "yes/no", "zebra": "yes/no", "snmpd": "yes/no", "ntpd": "yes/no", "sshd": "yes/no", "timsdns": "yes/no", "named": "yes/no", "unbound": "yes/no", "nsd": "yes/no", "timsdhcp": "yes/no", "tftp": "yes/no", "stunnel": "yes/no", "zeek": "yes/no", "suricata": "yes/no", "anomalydetection": "yes/no" }]

Parameters
Type Name Description Schema Default

Body

body
optional

< ApplianceService > array

Responses
HTTP Code Description Schema

200

successful operation

< ApplianceService > array

500

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.92.2. Manage Appliance Services

POST /services/manage
Description

Method to Start/Stop/Restart services on Remote Appliance.

Parameters
Type Name Description Schema Default

Body

body
optional

Server Information

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.93. Message Certificate Management Service

Description

Certificate class service represents an SSL certificate in the TCPWave IPAM. It holds the information related to SSL certificate including the serial number, issuer, validity, signature and other information.

4.93.1. Get number of days all certificates are valid

GET /msgcertmgmt/allcertValidDays
Description

Retrieve the number of days the message certificates are valid for in the TCPWave IPAM. Refer Administrator Reference document for more information.

Responses
HTTP Code Description Schema

200

successful operation

< string > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.93.2. Delete Certificate

POST /msgcertmgmt/certDelete
Description

Delete the current SSL/TLS certificate from the TCPWave Secure Message Channel keystore in the TCPWave IPAM. For more information on managing the TCPWave Secure Channel certificates, please refer the Administrator Reference document.

Parameters
Type Name Description Schema Default

Body

body
required

Certificate details

string

Responses
HTTP Code Description Schema

500

TIMS-8307: This certificate cannot be deleted as it is the only certificate in the keystore.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.93.3. Validation Certificate

GET /msgcertmgmt/certValidate
Description

Validate the current SSL/TLS certificate before uploading in the TCPWave IPAM. Refer the Administrator Reference document for more information.

Parameters
Type Name Description Schema Default

Query

cfile
required

Certificate File

string

Responses
HTTP Code Description Schema

200

successful operation

MsgCert

500

TIMS-8304: Certificate is not valid.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.93.4. List Certificate

GET /msgcertmgmt/certlist
Description

Retrieves the list of SSL/TLS certificates available in the TIMS IPAM, along with their details. TCPWave IPAM uses SSL/TLS certificates for secure communication with the remotes.

Responses
HTTP Code Description Schema

200

successful operation

< MsgCert > array

500

TIMS-8303: Certificate get list failed.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.93.5. Change Keystore Password

POST /msgcertmgmt/changeKeystorePassword
Description

Change the TCPWave Secure Message Channel keystore password in the TCPWave IPAM. For more information on managing the TCPWave Secure Channel certificates, please refer the Administrator Reference document.

Parameters
Type Name Description Schema Default

Body

body
optional

string

Responses
HTTP Code Description Schema

500

TIMS-8308: An error has occurred while changing the certificate store password.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.93.6. Create and Import a Self-Signed Message Certificate

POST /msgcertmgmt/createSelfSignedCert
Description

Create a self-signed certificate for messaging sub-system. For more information on managing the TCPWave Secure Message certificates, please refer to the Administrator Reference document.

Parameters
Type Name Description Schema Default

Body

body
optional

string

Responses
HTTP Code Description Schema

500

TIMS-8317: Please enter Certificate file.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.93.7. Duplicate Alias check

POST /msgcertmgmt/duplicateAlias
Description

Check if the current SSL/TLS certificate is already available in the TCPWave IPAM SSL certificate repository. Refer the Administrator Reference document for more information.

Parameters
Type Name Description Schema Default

Body

body
optional

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.93.8. Restart Jetty Server

POST /msgcertmgmt/jettyRestart
Description

Put a request to restart the TIMS IPAM Web application, after successfully publishing a SSL/TLS certificate in the TCPWave IPAM. After the restart, TCPWave IPAM will use the recently published SSL/TLS certificate.

Responses
HTTP Code Description Schema

500

TIMS-8102: Server address is empty. TIMS-8101: Service to restart jetty server is not defined.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.93.9. Validate Keystore

POST /msgcertmgmt/keystoreValidate
Description

Validate the current SSL/TLS certificate keystore before uploading in the TCPWave IPAM. Refer the Administrator Reference document for more information.

Parameters
Type Name Description Schema Default

Body

body
optional

string

Responses
HTTP Code Description Schema

200

successful operation

MsgCert

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.93.10. Import Message Certificate

POST /msgcertmgmt/msgcertImport
Description

Import a certificate for messaging sub-system. For more information on managing the TCPWave Secure Message certificates, please refer to the Administrator Reference document.

Parameters
Type Name Description Schema Default

Body

body
required

Certificate details

string

Responses
HTTP Code Description Schema

500

TIMS-8317: Please enter Certificate file.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.93.11. Download Truststore

GET /msgcertmgmt/truststoreDownload
Description

Retrieve the TCPWave Secure Message Channel truststore file. For more information on managing the TCPWave Secure Channel certificates, please refer to the Administrator Reference document.

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-8313: An error has occurred while retrieving the truststore.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.93.12. Publish Truststore

POST /msgcertmgmt/truststorePublish
Description

Publish the current TCPWave Secure Message truststore to the TCPWave Remote Appliances. For more information on managing the TCPWave Secure Channel certificates, please refer the Administrator Reference document.

Responses
HTTP Code Description Schema

500

TIMS-8313: An error has occurred while publishing the truststore to remote appliances.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.94. Microsoft AD Sites Service

4.94.1. Add Microsoft AD site

POST /adsites/add
Description

This operation creates a Microsoft AD site in the TCPWave IPAM.
Example:
{ "sites": {"organization_name": "QAOrg","name": "AD appliance","server_ip": "10.1.10.91","description": "Microsoft AD Sites."}}

Parameters
Type Name Description Schema Default

Query

orgname
required

Organization Name

string

Query

serverIp
required

Microsoft AD Appliance IP

string

Body

body
required

Microsoft AD Site Details

ADSites Information

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist: {0}
TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.94.2. List subnets

GET /adsites/associatedsub
Description

This operation retrieves a list of subnets present in the given subnet group.
Example:
/rest/subnetgroup/listSubnets?subnet_grp_name=subnetGroupName&org_name=Internal&length=20&start=1

Parameters
Type Name Description Schema Default

Query

org_name
required

Organization Name

string

Query

subnet_grp_name
required

Subnet Group Name

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListSubnet Information

500

An exception has occurred while deleting the Microsoft AD sites.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.94.3. Microsoft AD site delete

POST /adsites/delete
Description

This operation deletes the selected Microsoft AD site from the TCPWave IPAM.
Example:
/rest/adsites/delete?name=TestSite&serverIp=10.1.10.91

Parameters
Type Name Description Schema Default

Query

name
required

Microsoft AD Site Name

string

Query

serverIp
required

Microsoft AD Appliance IP

string

Responses
HTTP Code Description Schema

500

An exception has occurred while deleting the Microsoft AD sites.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.94.4. Microsoft AD sites edit

POST /adsites/edit
Description

This operation updates the Microsoft AD site in the TCPWave IPAM. Functional admins can edit the Microsoft AD site for any organization. The rest of the admins can update the Microsoft AD site for the organizations they are associated with.
Example:
{ "adsite": {"name": "ADSite","subent": "subnetGrp","description": "Microsoft AD Site."}}

Parameters
Type Name Description Schema Default

Query

orgname
required

Organization Name

string

Query

serverIp
required

IP Address

string

Body

body
required

Microsoft appliance details

ADSites Information

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist:{0}
TIMS-7003: You are not authorized to perform this operation
TIMS-1916: Organization name cannot be null

No Content

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

  • application/json

4.94.5. Microsoft AD site details

GET /adsites/getdetails
Description

This operation retrieves the details of the Microsoft AD site.
Example:
/rest/adsites/getdetails?name=test&serverIp=10.1.10.91

Parameters
Type Name Description Schema Default

Query

name
required

Microsoft AD Site Name

string

Query

serverIp
required

Microsoft AD Appliance IP

string

Responses
HTTP Code Description Schema

200

successful operation

ADSites Information

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.94.6. Microsoft AD sites list

GET /adsites/page
Description

This operation retrieves the list of the Microsoft AD sites and services defined in the TCPWave IPAM. Functional admins has the privilege to fetch the list of all the Microsoft AD sites and services.
Example:
/rest/adsites/page?serverIp=10.1.10.91&orgname=TCPWave

Parameters
Type Name Description Schema Default

Query

mode
required

Operation Mode

string

Query

orgname
required

Organization Name

string

Query

serverIp
required

Microsoft AD Appliance IP

string

Responses
HTTP Code Description Schema

200

successful operation

< ADSites Information > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.94.7. Add Microsoft AD appliances

POST /windowsadsites/add
Description

This operation creates the Microsoft AD appliances in the TCPWave IPAM.
Example:
{ "windowsadsites": {"organization_name": "QAOrg","server_name": "AD appliance","user_name": "administrator","server_ip": "10.1.10.91","password": "abc123","description": "Microsoft AD Appliance."}}

Parameters
Type Name Description Schema Default

Body

body
required

Microsoft appliance details

Microsoft Server Information

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist: {0}
TIMS-7003: You are not authorized to perform this operation
TIMS-1025: Organization id is not valid:{0}
TIMS-15089: The Microsoft AD appliance name cannot be null
TIMS-15090: The Microsoft AD appliance {0} cannot be created, as an object of type Microsoft Remote does not exist
TIMS-15091: The Microsoft AD appliance with IP address {0} is already being managed by the TCPWave IPAM.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.94.8. Microsoft AD appliance delete

POST /windowsadsites/delete
Description

This operation deletes the selected Microsoft AD appliances from the TCPWave IPAM.
Example:
/rest/windowsadsites/delete?ip=192.168.0.45

Parameters
Type Name Description Schema Default

Query

ip
required

Required Server’s IP Address

string

Responses
HTTP Code Description Schema

500

An exception has occurred while deleting the Microsoft AD appliance.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.94.9. Microsoft AD appliances edit

POST /windowsadsites/edit
Description

This operation updates the Microsoft AD appliances in the TCPWave IPAM. Functional admin has the privilege to update the new or existing Microsoft AD appliance for any organization. The rest of the admins can update the Microsoft AD appliance associated with the respective organization.
Example:
{ "windowsadsites": {"organization_name": "QAOrg","server_name": "AD appliance","user_name": "administrator","server_ip": "10.1.10.91","description": "Microsoft AD appliance."}}

Parameters
Type Name Description Schema Default

Body

body
required

Microsoft appliance details

Microsoft Server Information

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist:{0}
TIMS-7003: You are not authorized to perform this operation
TIMS-1916: Organization name cannot be null
TIMS-15092: The Microsoft AD appliance with IP address {0} does not exist
TIMS-15093: The Microsoft AD appliance {0} cannot be updated, as an object of type Microsoft Remote does not exist
TIMS-15091: The Microsoft AD appliance with IP address {0} is already being managed by the TCPWave IPAM.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

  • application/json

4.94.10. Microsoft AD appliances

GET /windowsadsites/getdetails
Description

This operation retrieves the Microsoft AD appliance details present in the TCPWave IPAM.
Example:
/rest/windowsadsites/getdetails?ip=10.0.0.3

Parameters
Type Name Description Schema Default

Query

ip
required

Server IP

string

Query

orgname
optional

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Microsoft Server Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.94.11. Microsoft AD appliances

GET /windowsadsites/page
Description

This operation retrieves the list of the Microsoft AD appliances defined in the TCPWave IPAM. Functional admins have the privilege to fetch the list of all the Microsoft AD appliances. The rest of the admins can fetch the Microsoft AD appliances associated with the respective organization.
Example:
/rest/windowsdns/page?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Size

integer(int32)

Query

order
optional

Sorting Order(asc/desc)

string

Query

organizations
optional

Organization name

string

Query

sort
optional

Sorting String

string

Query

start
required

Starting Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListMicrosoft Server Information

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.95. Microsoft DHCP Appliance Service

Description

This service provides APIs related to "

4.95.1. Microsoft DHCP Appliance Add

POST /v6wsdhcpserver/add
Description

Creates an IPv4 Microsoft DHCP Appliance in the TCPWave IPAM.IPAM can connect to the appliance though HTTP/HTTPS protocol. Please refer the Admin document for the steps to configure winRm listener either in HTTPS or HTTP mode.
Below example shows sample request JSON:
{ "WindowsServer": {"organization_name": "QAOrg","server_name": "DHCP appliance","user_name": "administrator","server_ip": "5000::2","macExclusionArray": [{"macAddress": "aa:bb:cc:dd:ee:45", macDescription: "blocked list"}],"password": "abc123","httpsEnabled": 0,"description": "Microsoft DHCP appliance."}}

Parameters
Type Name Description Schema Default

Body

body
required

Microsoft DHCP appliance details

Microsoft Server Information

Responses
HTTP Code Description Schema

500

TIMS-3033: An appliance already exists with the specified address, TIMS-1917: Organization name and id cannot be null, TIMS-3009: Object does not exist, TIMS-3906: Microsoft DHCP appliance already exist with specified IP address

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.95.2. Microsoft DHCP Appliance Delete

POST /v6wsdhcpserver/delete
Description

Deletes the given IPv4 DHCP Appliance. Reference checks will take place while deleting the appliance.
The example listed below shows a sample request URL:
/rest/wsdhcpserver/delete?address=5000::2

Parameters
Type Name Description Schema Default

Query

address
required

IP Address of the selected DHCP Appliance

string

Query

orgName
optional

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-3917: Microsoft DHCP Appliance address cannot be null, TIMS-3919: Microsoft DHCP Appliance is not deleted as it manages scopes,TIMS-3918: Microsoft DHCP Appliance is not deleted as it manages subnets

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.95.3. Get DHCP Appliances Active Leases

GET /v6wsdhcpserver/dhcpActiveLeases
Description

Obtains list of active leases from the given Microsoft IPv4 DHCP Appliance.
The example listed below shows a sample request URL:
/rest/wsdhcpserver/dhcpActiveLeases?serverIp=1.0.0.3&organization_name=Internal

Parameters
Type Name Description Schema Default

Query

organization_name
optional

Organization name

string

Query

serverIp
required

IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

PagedListDHCPLeaseObject

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.95.4. Get Appliance Configuration

GET /v6wsdhcpserver/getdetails
Description

Provides Microsoft DHCP appliance configuration details of the given IP Address in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/wsdhcpserver/getdetails?ip=5000::2&orgname=Internal

Parameters
Type Name Description Schema Default

Query

ip
required

Appliance IP Address

string

Query

orgname
optional

Organization

string

Responses
HTTP Code Description Schema

200

successful operation

Microsoft Server Information

500

TIMS-3905: Microsoft DHCP appliance does not exist with specified IP address <IP Address>

No Content

Consumes
  • text/plain

Produces
  • application/json

4.95.5. Microsoft DHCP appliance list

GET /v6wsdhcpserver/list
Description

Obtains a list of all Microsoft IPV4 DHCP appliances configured in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/wsdhcpserver/list?org_name=Internal

Parameters
Type Name Description Schema Default

Query

org_name
required

Required Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Microsoft Server Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.95.6. Microsoft DHCP Appliance List

GET /v6wsdhcpserver/page
Description

Obtains a list of all the Microsoft DHCP appliances defined and managed by the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/wsdhcpserver/page?start=1&length=20

Parameters
Type Name Description Schema Default

Query

customFilterRules
optional

Custom Filter String

string

Query

draw
optional

Pagination Rendering Parameter

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organization Name

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting appliance Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListMicrosoft Server Information

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.95.7. Microsoft DHCP Appliance Update

POST /v6wsdhcpserver/update
Description

Updates the selected IPv4 Microsoft DHCP Appliance in the TCPWave IPAM.IPAM can connect to the appliance though HTTP/HTTPS protocol. Please refer the Admin document for the steps to configure winRm listener either in HTTPS or HTTP mode.
Below example shows sample request JSON:
{ "WindowsServer": {"organization_name": "QAOrg","server_name": "DHCP appliance","user_name": "administrator","server_ip": "5000::2","httpsEnabled": 0,"macExclusionArray": [{"macAddress": "aa:bb:cc:dd:ee:45", macDescription: "blocked list"}],"description": "Microsoft DHCP appliance.","old_server_ip": "5000::2"}}

Parameters
Type Name Description Schema Default

Body

body
required

Microsoft DHCP appliance details

Microsoft Server Information

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-3906: Microsoft DHCP appliance already exist with specified IP address, TIMS-3905: Microsoft DHCP appliance does not exist with specified IP address

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.95.8. Microsoft DHCP Appliance Add

POST /wsdhcpserver/add
Description

This operation creates an IPv4 Microsoft DHCP appliance in the TCPWave IPAM.IPAM can connect to the appliance through HTTP/HTTPS protocol based on the defined configurations.
The following example shows a sample request JSON:
{ "WindowsServer": {"organization_name": "QAOrg","server_name": "DHCP appliance","user_name": "administrator","server_ip": "10.1.10.91","macExclusionArray": [{"macAddress": "aa:bb:cc:dd:ee:45", macDescription: "blocked list"}],"password": "abc123","httpsEnabled": 0,"description": "Microsoft DHCP appliance."}}

Parameters
Type Name Description Schema Default

Body

body
required

Microsoft DHCP appliance details

Microsoft Server Information

Responses
HTTP Code Description Schema

500

TIMS-3033: An appliance already exists with the specified address, TIMS-1917: Organization name and id cannot be null, TIMS-3009: Object does not exist, TIMS-3906: Microsoft DHCP appliance already exist with specified IP address

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.95.9. Microsoft DHCP Appliance Delete

POST /wsdhcpserver/delete
Description

This operation deletes the given IPv4 Microsoft DHCP appliance provided the appliance should not have any references associated with it.
The following example shows a sample request URL:
/rest/wsdhcpserver/delete?address=10.1.10.91

Parameters
Type Name Description Schema Default

Query

address
required

IP Address of the selected DHCP Appliance

string

Query

orgName
optional

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-3917: Microsoft DHCP Appliance address cannot be null, TIMS-3919: Microsoft DHCP Appliance is not deleted as it manages scopes,TIMS-3918: Microsoft DHCP Appliance is not deleted as it manages subnets

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.95.10. Get DHCP Appliances Active Leases

GET /wsdhcpserver/dhcpActiveLeases
Description

This operation retrieves the list of active leases from the given IPv4 Microsoft DHCP appliance.
The following example shows a sample request URL:
/rest/wsdhcpserver/dhcpActiveLeases?serverIp=1.0.0.3&organization_name=Internal

Parameters
Type Name Description Schema Default

Query

organization_name
optional

Organization name

string

Query

serverIp
required

IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

PagedListDHCPLeaseObject

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.95.11. Get Appliance Properties

GET /wsdhcpserver/getdetails
Description

This operation provides IPv4 Microsoft DHCP appliance details of the given IP address in the TCPWave IPAM.
The following example shows a sample request URL:
/rest/wsdhcpserver/getdetails?ip=192.168.0.34&orgname=Internal

Parameters
Type Name Description Schema Default

Query

ip
required

Appliance IP Address

string

Query

orgname
optional

Organization

string

Responses
HTTP Code Description Schema

200

successful operation

Microsoft Server Information

500

TIMS-3905: Microsoft DHCP appliance does not exist with specified IP address <IP Address>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.95.12. Microsoft DHCP appliance list

GET /wsdhcpserver/list
Description

This operation retrieves the list of all Microsoft IPV4 DHCP appliances configured in the TCPWave IPAM.
The following example shows a sample request URL:
/rest/wsdhcpserver/list?org_name=Internal

Parameters
Type Name Description Schema Default

Query

org_name
required

Required Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Microsoft Server Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.95.13. Microsoft DHCP Appliance List

GET /wsdhcpserver/page
Description

This operation retrieves the paginated list of all the IPv4 Microsoft DHCP appliances defined and managed by the TCPWave IPAM.
The following example shows a sample request URL:
/rest/wsdhcpserver/page?start=1&length=20

Parameters
Type Name Description Schema Default

Query

customFilterRules
optional

Custom Filter String

string

Query

draw
optional

Pagination Rendering Parameter

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organization Name

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting appliance Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListMicrosoft Server Information

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.95.14. Restart DHCP Service on Microsoft DHCP Appliance

POST /wsdhcpserver/restartService
Description

This operation executes a command on the Microsoft DHCP appliance to restart the dhcp service.
The following example shows a sample request URL:
/rest/wsdhcpserver/restartService?server_ip=1.0.0.3

Parameters
Type Name Description Schema Default

Query

org_name
optional

Organization

string

Query

server_ip
required

IP address

string

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.95.15. Generate Appliance Configuration for Sync

GET /wsdhcpserver/syncConfig
Description

This operation generates IPv4 DHCP configuration XML and imports the latest DHCP configuration details.
The following example shows a sample request URL:
/rest/wsdhcpserver/syncConfig?address=10.0.0.5&organization_name=Internal

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Query

organization_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7003: You are not authorized to perform this operation, TIMS-9212: A sync is currently in progress initiated by <User name> from <Login user IP Address>. Please wait until it is completed.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.95.16. Microsoft DHCP Appliance Update

POST /wsdhcpserver/update
Description

This operation updates the selected IPv4 Microsoft DHCP appliance properties in the TCPWave IPAM.
The following example shows a sample request JSON:
{ "WindowsServer": {"organization_name": "QAOrg","server_name": "DHCP appliance","user_name": "administrator","server_ip": "10.1.10.91","httpsEnabled": 0,"macExclusionArray": [{"macAddress": "aa:bb:cc:dd:ee:45", macDescription: "blocked list"}],"description": "Microsoft DHCP appliance.","old_server_ip": "10.1.10.92"}}

Parameters
Type Name Description Schema Default

Body

body
required

Microsoft DHCP appliance details

Microsoft Server Information

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-3906: Microsoft DHCP appliance already exist with specified IP address, TIMS-3905: Microsoft DHCP appliance does not exist with specified IP address

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.96. Microsoft DHCP Exclusion Range Service

4.96.1. Add Exclusion Range

POST /wsExclusion/add
Description

This operation creates IPv4 Microsoft DHCP exclusion ranges by validating the given start IP and end IP range. The system allows ranges within the available scope of a given subnet.
The following example shows a sample request JSON:
{ "description": "", "organization_name": "QAOrg", "primary_dhcp_server": "QA-Remote", "addressRanges": [{ "startIP": "10.1.10.55", "endIP": "10.1.10.60"}], "subnetAddress": "10.1.10.0" }

Parameters
Type Name Description Schema Default

Body

body
required

Exclusion range details

Microsoft DHCP Exclusion range Information

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.96.2. Exclusion Range Delete

POST /wsExclusion/delete
Description

This operation deletes one or more IPv4 Microsoft DHCP exclusion ranges defined in the TCPWave IPAM.
The following example shows a sample request JSON:
{ "organization_name": "QAOrg", "addressRanges": [{ "startIP": "10.1.10.55", "endIP": "10.1.10.60"}], "subnetAddress": "10.1.10.0" }

Parameters
Type Name Description Schema Default

Body

body
required

List of exclusion range details

Microsoft DHCP Exclusion range Information

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.96.3. Exclusion Range List

GET /wsExclusion/page
Description

This operation retrieves the paginated list of IPv4 Microsoft DHCP exclusion ranges in the TCPWave IPAM for a given subnet.
The following example shows a sample request URL:
/rest/wsExclusion/list?page=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Pagination Rendering Parameter

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

orgName
optional

Organization(s) list

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting exclusion Range

integer(int32)

Query

subnetAddress
optional

Subnet address of exclusion range

string

Responses
HTTP Code Description Schema

200

successful operation

PagedListMicrosoft DHCP Exclusion Range Information

500

TIMS-7003: You are not authorized to perform this operation,TIMS-2015: Subnet does not exist.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.97. Microsoft DNS Appliance Service

Description

This service provides API's to get list of the Microsoft DNS appliances present in the TCPWave IPAM"

4.97.1. Add Microsoft DNS Appliance

POST /v6windowsdns/add
Description

Creates an IPv4 Microsoft DNS Appliance in the TCPWave IPAM. IPAM can connect to the appliance though HTTP/HTTPS protocol. Please refer the Admin document for the steps to configure winRm listener either in HTTPS or HTTP mode.
Below example shows sample request JSON:
{ "windowsserver": {"organization_name": "QAOrg","server_name": "DNS appliance","user_name": "administrator","server_ip": "5000::2","password": "abc123","httpsEnabled": 0,"description": "Microsoft DNS appliance.","is_auto_sync_enabled":"yes","auto_sync_interval":"10","read_write_option":"1"}}

Parameters
Type Name Description Schema Default

Body

body
required

Microsoft appliance details

Microsoft Server Information

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist: {0}
TIMS-7003: You are not authorized to perform this operation
TIMS-1025: Organization id is not valid:{0}
TIMS-1704: The Microsoft DNS appliance name cannot be null
TIMS-1722: The Microsoft appliance {0} cannot be created, as an object of type Microsoft Remote does not exist
TIMS-1708: The Microsoft DNS appliance with IP address {0} is already being managed by the TCPWave IPAM.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.97.2. The Microsoft DNS appliance delete

POST /v6windowsdns/delete
Description

Delete the selected Microsoft DNS appliance from the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/windowsdns/delete?ip=5000::2

Parameters
Type Name Description Schema Default

Query

ip
required

Required Server’s IP Address

string

Responses
HTTP Code Description Schema

500

An exception has occurred while deleting the Microsoft DNS IPv6 appliance.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.97.3. The Microsoft DNS appliance Edit

POST /v6windowsdns/edit
Description

Updates the Microsoft DNS appliance in the TCPWave IPAM. Functional Admin can update the new Microsoft DNS appliance for any organization. Rest of the admins can update the Microsoft DNS appliance only for the organizations that they are associated with.IPAM can connect to the appliance though HTTP/HTTPS protocol. Please refer the Admin document for the steps to configure winRm listener either in HTTPS or HTTP mode.
Below example shows sample request JSON:
{ "windowsserver": {"organization_name": "QAOrg","server_name": "DNS appliance","user_name": "administrator","server_ip": "5000::2","httpsEnabled": 0,"description": "Microsoft DNS appliance."}}

Parameters
Type Name Description Schema Default

Body

body
required

Microsoft appliance details

Microsoft Server Information

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist:{0}
TIMS-7003: You are not authorized to perform this operation
TIMS-1916: Organization name cannot be null
TIMS-1709: The Microsoft DNS appliance with IP address {0} does not exist
TIMS-1723: The Microsoft appliance {0} cannot be updated, as an object of type Microsoft Remote does not exist
TIMS-1708: The Microsoft DNS appliance with IP address {0} is already being managed by the TCPWave IPAM.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

  • application/json

4.97.4. Object Details

GET /v6windowsdns/get
Description

Get the object details.
The example listed below shows a sample request URL:
/rest/server/get?address=5000::2&organization=Internal

Parameters
Type Name Description Schema Default

Query

address
required

Object Address

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

IPv6 object

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.97.5. Server Configuration

GET /v6windowsdns/getdetails
Description

Provides the Microsoft DNS appliance details of the given IP Address present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/windowsdns/getdetails?ip=5000::2

Parameters
Type Name Description Schema Default

Query

ip
required

Server IP

string

Query

orgname
optional

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Microsoft Server Information > array

Consumes
  • text/plain

Produces
  • application/json

4.97.6. Server Configuration

GET /v6windowsdns/getdetailsbyorg
Description

Provides the Microsoft DNS appliance details present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/windowsdns/getdetailsbyorg?orgName=Internal

Parameters
Type Name Description Schema Default

Query

orgId
optional

Organization Id

integer(int32)

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Microsoft Server Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.97.7. The Microsoft DNS IPv6 Appliance List

GET /v6windowsdns/page
Description

Provides a paginated list of the Microsoft DNS appliances defined in the TCPWave IPAM. Functional Admin gets the list of all the Microsoft DNS appliances. Rest of the Admins get only the list of the Microsoft DNS appliances associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/windowsdns/page?start=1&length=20

Parameters
Type Name Description Schema Default

Query

customFilterRules
optional

Custom Filter String

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Size

integer(int32)

Query

order
optional

Sorting Order(asc/desc)

string

Query

organizations
optional

Organization name

string

Query

sort
optional

Sorting String

string

Query

start
required

Starting Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListMicrosoft Server Information

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.97.8. Microsoft Appliance References In Zones

GET /v6windowsdns/references
Description

Obtains a list of DNS zones that have references to the Microsoft DNS Appliance for which DNS Zone associations have been defined.
The example listed below shows a sample request URL:
/rest/windowsdns/references?tables=tableName

Parameters
Type Name Description Schema Default

Query

count
optional

Count Flag

string

Query

id
optional

Appliance Reference Id

string

Query

page
optional

Page Number

integer(int32)

Query

rows
optional

Number of rows

integer(int32)

Query

tables
required

Tables

string

Responses
HTTP Code Description Schema

200

successful operation

Reference Results

500

TIMS-3050: Both Appliance id and address cannot be null, TIMS-3092: Appliance does not exist: <given IP Address>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.97.9. Appliance Search

GET /v6windowsdns/search
Description

Searches for the Microsoft DNS Appliances in the TCPWave IPAM. The search results will be displayed in the search window categorized as Microsoft Appliance. Zone references for the appliances will be displayed in the references page.
The example listed below shows a sample request URL:
/rest/windowsdns/search

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization list

string

Query

page
optional

Page Number

integer(int32)

Query

rows
optional

Number of rows

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListMicrosoft Server Information

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.97.10. Add Microsoft DNS Appliance

POST /windowsdns/add
Description

Creates an IPv4 Microsoft DNS Appliance in the TCPWave IPAM. IPAM can connect to the appliance though HTTP/HTTPS protocol. Please refer the Admin document for the steps to configure winRm listener either in HTTPS or HTTP mode.
Below example shows sample request JSON:
{ "windowsserver": {"organization_name": "QAOrg","server_name": "DNS appliance","user_name": "administrator","server_ip": "10.1.10.91","password": "abc123","httpsEnabled": 0,"description": "Microsoft DNS appliance.","is_auto_sync_enabled":"yes","auto_sync_interval":"10","read_write_option":"1"}}

Parameters
Type Name Description Schema Default

Body

body
required

Microsoft appliance details

Microsoft Server Information

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist: {0}
TIMS-7003: You are not authorized to perform this operation
TIMS-1025: Organization id is not valid:{0}
TIMS-1704: The Microsoft DNS appliance name cannot be null
TIMS-1722: The Microsoft appliance {0} cannot be created, as an object of type Microsoft Remote does not exist
TIMS-1708: The Microsoft DNS appliance with IP address {0} is already being managed by the TCPWave IPAM.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.97.11. The Microsoft DNS appliance delete

POST /windowsdns/delete
Description

Delete the selected Microsoft DNS appliance from the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/windowsdns/delete?ip=192.168.0.45

Parameters
Type Name Description Schema Default

Query

ip
required

Required Server’s IP Address

string

Responses
HTTP Code Description Schema

500

An exception has occurred while deleting the Microsoft DNS appliance.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.97.12. The Microsoft DNS appliance Edit

POST /windowsdns/edit
Description

Updates the Microsoft DNS appliance in the TCPWave IPAM. Functional Admin can update the new Microsoft DNS appliance for any organization. Rest of the admins can update the Microsoft DNS appliance only for the organizations that they are associated with.IPAM can connect to the appliance though HTTP/HTTPS protocol. Please refer the Admin document for the steps to configure winRm listener either in HTTPS or HTTP mode.
Below example shows sample request JSON:
{ "windowsserver": {"organization_name": "QAOrg","server_name": "DNS appliance","user_name": "administrator","server_ip": "10.1.10.91","httpsEnabled": 0,"description": "Microsoft DNS appliance."}}

Parameters
Type Name Description Schema Default

Body

body
required

Microsoft appliance details

Microsoft Server Information

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist:{0}
TIMS-7003: You are not authorized to perform this operation
TIMS-1916: Organization name cannot be null
TIMS-1709: The Microsoft DNS appliance with IP address {0} does not exist
TIMS-1723: The Microsoft appliance {0} cannot be updated, as an object of type Microsoft Remote does not exist
TIMS-1708: The Microsoft DNS appliance with IP address {0} is already being managed by the TCPWave IPAM.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

  • application/json

4.97.13. Server Configuration

GET /windowsdns/getassociatedmicrosoftappliances
Description

Provides the Microsoft DNS appliance details associated with the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/windowsdns/getassociatedmicrosoftappliances?orgname=Internal&templateName=testtemplate

Parameters
Type Name Description Schema Default

Query

orgname
optional

Organization Name

string

Query

templateName
required

Template Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Microsoft Server Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.97.14. Server Configuration

GET /windowsdns/getdetails
Description

Provides the Microsoft DNS appliance details of the given IP Address present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/windowsdns/getdetails?ip=10.0.0.3

Parameters
Type Name Description Schema Default

Query

ip
required

Server IP

string

Query

orgname
optional

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Microsoft Server Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.97.15. Server Configuration

GET /windowsdns/getdetailsbyorg
Description

Provides the Microsoft DNS appliance details present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/windowsdns/getdetailsbyorg?orgName=Internal

Parameters
Type Name Description Schema Default

Query

orgId
optional

Organization Id

integer(int32)

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Microsoft Server Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.97.16. The Microsoft DNS Appliance List

GET /windowsdns/page
Description

Provides a paginated list of the Microsoft DNS appliances defined in the TCPWave IPAM. Functional Admin gets the list of all the Microsoft DNS appliances. Rest of the Admins get only the list of the Microsoft DNS appliances associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/windowsdns/page?start=1&length=20

Parameters
Type Name Description Schema Default

Query

customFilterRules
optional

Custom Filter String

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Size

integer(int32)

Query

order
optional

Sorting Order(asc/desc)

string

Query

organizations
optional

Organization name

string

Query

sort
optional

Sorting String

string

Query

start
required

Starting Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListMicrosoft Server Information

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.97.17. The Microsoft DNS appliance ping and port availability check

POST /windowsdns/pingPortCheck
Description

Checks if the IP Address is reachable or not and checks the port 53 availability for the IPAM - Microsoft DNS appliance communication.
Below example shows sample request JSON:
{ "windowsserver": {"organization_name": "QAOrg","server_name": "DNS appliance","user_name": "administrator","server_ip": "10.1.10.91""password": "*""description": "Microsoft DNS appliance."}}

Parameters
Type Name Description Schema Default

Body

body
optional

Microsoft Server Information

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1352: Organization does not exist: <Organization Name>

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.97.18. Microsoft Appliance References In Zones

GET /windowsdns/references
Description

Obtains a list of DNS zones that have references to the Microsoft DNS Appliance for which DNS Zone associations have been defined.
The example listed below shows a sample request URL:
/rest/windowsdns/references?tables=tableName

Parameters
Type Name Description Schema Default

Query

count
optional

Count Flag

string

Query

id
optional

Appliance Reference Id

string

Query

page
optional

Page Number

integer(int32)

Query

rows
optional

Number of rows

integer(int32)

Query

tables
required

Tables

string

Responses
HTTP Code Description Schema

200

successful operation

Reference Results

500

TIMS-3050: Both Appliance id and address cannot be null, TIMS-3092: Appliance does not exist: <given IP Address>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.97.19. Appliance Search

GET /windowsdns/search
Description

Searches for the Microsoft DNS Appliances in the TCPWave IPAM. The search results will be displayed in the search window categorized as Microsoft Appliance. Zone references for the appliances will be displayed in the references page.
The example listed below shows a sample request URL:
/rest/windowsdns/search

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization list

string

Query

page
optional

Page Number

integer(int32)

Query

rows
optional

Number of rows

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListMicrosoft Server Information

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.97.20. Server Configuration

GET /windowsdns/sync
Description

Provides the Microsoft DNS appliance details associated with the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/windowsdns/sync?orgname=Internal

Parameters
Type Name Description Schema Default

Query

ip
optional

Server IP Address

string

Query

orgid
optional

Organization ID

integer(int32)

Query

orgname
optional

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.98. Microsoft DNS Charts

4.98.1. Get CPU usage

GET /ms-charts/cpu
Description

Get The total CPU usage for a Microsoft DNS Appliance.
Below example shows sample request URL:
/rest/ms-charts/cpu/?appliance_ip=1.0.0.0

Parameters
Type Name Description Schema Default

Query

appliance_ip
required

Appliance IP address

string

Query

duration
required

Duration

string

Query

name
required

Name

string

Responses
HTTP Code Description Schema

200

successful operation

ChartsData

500

TIMS-1425: Both Appliance id and Appliance IP address cannot be null

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.98.2. Get CPU usage

GET /ms-charts/dhcpcharts
Description

Get The charts for a Microsoft DHCP Appliance.
Below example shows sample request URL:
/rest/ms-charts/dhcpcharts/?appliance_ip=1.0.0.0

Parameters
Type Name Description Schema Default

Query

appliance_ip
required

Appliance IP address

string

Query

duration
required

Duration

string

Query

name
required

Name

string

Responses
HTTP Code Description Schema

200

successful operation

ChartsData

500

TIMS-1425: Both Appliance id and Appliance IP address cannot be null

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.98.3. Get Query Logs

GET /ms-charts/querylogs
Description

Get The query logs for a Microsoft DNS Appliance.
Below example shows sample request URL:
/rest/ms-charts/memory/?appliance_ip=1.0.0.0

Parameters
Type Name Description Schema Default

Query

appliance_ip
required

Appliance IP address

string

Responses
HTTP Code Description Schema

200

successful operation

< MS DNS Logs Wrapper > array

500

TIMS-1425: Both Appliance id and Appliance IP address cannot be null

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.99. Mirrored Zone Service

4.99.1. Add Mirrored Zones

POST /mirroredzone/add
Description

Creates mirrored zones for the given zone in the TCPWave IPAM. Below example shows the sample JSON: {"zone_name":"domain.com",
"mirrored_zone_list":"mirror.com,local.com",
"org_name":"Org",
"description":"This is the description of the mirrored zone."
}

Parameters
Type Name Description Schema Default

Body

body
required

Mirrored zone details

Mirrored Zones

Responses
HTTP Code Description Schema

500

TIMS-1020: Both Organization name and id cannot be null
TIMS-1352: Organization does not exist: {0}
TIMS-12050: Both Zone id and Zone name cannot be null, TIMS-1422: Zone does not exist:{0}
TIMS-1421: Both Domain name and id cannot be null
TIMS-12055: Mirrored Zone name cannot be null
TIMS-12058: Mirrored Zones cannot be created as it is exceeding maximum limit {0} defined in the global options for the zone {1}
TIMS-12057: Duplicate Mirrored Zone name entry for {0}
TIMS-3007: Object already exists: {0}
TIMS-12052: The name: {0} conflicts with an existing Mirrored Zone
TIMS-12051: A resource record with the Owner name: {0} already exists

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.99.2. Delete Mirrored Zone

POST /mirroredzone/delete
Description

Deletes the selected mirrored zones from the TCPWave IPAM.
Below example shows sample request JSON:
[ { "zone_id": 10, "org_id": 12, "zone_name": "zone.com", "org_name": "Org", "mirror_name": "zone.com", "old_mirror_name": "zone.com", "old_description": "This is the mirrored zone for the zone domain.com.", "mirrored_zone_list": "example.com,mirror.com", "description": "Description of Mirrored Zones.}]

Parameters
Type Name Description Schema Default

Body

body
required

List of mirrored zones

< Mirrored Zones > array

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist: {0}
TIMS-1422: Zone does not exist: {0}
TIMS-12056: Mirrored Zone does not exist.

No Content

Consumes
  • application/json

  • application/xml

4.99.3. Edit Mirrored Zone

POST /mirroredzone/edit
Description

Updates the given mirrored zone.Below is the example that show the sample JSON: {
"zone_name":"domain.com",
"org_name":"Org",
"description":"This is the edit of the mirrored zone.",
"old_mirror_name":"mirror.com",
"mirror_name":"newmirror.com"
}

Parameters
Type Name Description Schema Default

Body

body
required

Mirrored zone details

Mirrored Zones

Responses
HTTP Code Description Schema

500

TIMS-1020: Both Organization name and id cannot be null
TIMS-12065: Both ID and name of Mirrored Zone cannot be null
TIMS-12056: Mirrored Zone does not exist
TIMS-12052: The name: {0} conflicts with an existing mirrored zone.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.99.4. Get Mirrored Zone Details

GET /mirroredzone/getdetails
Description

Gets the details of the mirrored zone for the given name.
The example listed below shows a sample request URL:
/rest/mirroredzone/getdetails?name=zoneabc.com

Parameters
Type Name Description Schema Default

Query

id
optional

Zone ID

integer(int32)

Query

name
required

Zone Name

string

Responses
HTTP Code Description Schema

200

successful operation

Mirrored Zones

500

An exception has occurred while checking Mirrored Zones.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.99.5. Mirrored Zones List

GET /mirroredzone/listbypage
Description

Obtains a list of Mirrored Zones available in the IPAM.
The example listed below shows a sample request URL:
/rest/mirroredzone/listbypage?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organization List

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Mirrored Zone Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListMirrored Zones

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.100. Monitor Service

Description

This service class provides REST API access to Edit existing monitoring services based on host types which are managed by the TCPWave IPAM.

4.100.1. Monitoring Service

POST /monitor/edit
Description

Edits an existing Monitoring Service.
Below example shows sample request JSON:
{ "serviceId": 1, "serviceName": "SYSTEM_CPU", "serviceDescription": "Monitor the % CPU of all host types", "category": "Appliance Components", "bindAuth": "true/false", "bindCache": "true/false", "unboundCache": "true/false", "nsdAuth": "1", "dhcp": "true/false", "ipam": "true/false", "enableFlapping": "1", "enableAlertAck": "1", "enableCritical": "1", "enableWarning": "1", "enableUnknown": "0", "scheduledDownTime": "10/1/2021 12:00:00", "criticalThresholdVal": "70", "warningThresholdVal": "50", "disableAlertFromString": "10/1/2021 12:00:00", "disableAlertToString": "12/1/2021 12:00:00", "userScriptPath": "string"}

Parameters
Type Name Description Schema Default

Body

body
optional

Monitor Information

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.100.2. Monitoring Service Details

GET /monitor/getServiceDetails
Description

get monitoring services details in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/monitor/getServiceDetails?service_name=test

Parameters
Type Name Description Schema Default

Query

service_name
required

Service name

string

Responses
HTTP Code Description Schema

200

successful operation

Monitor Information

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.100.3. Monitoring Services History

GET /monitor/history
Description

Obtains monitored service history on the remote host group for DNS and DHCP Appliances defined and managed by the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/monitoring/history?service_name=test&start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

service_name
required

Service Name

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Monitoring History Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListNotification Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.100.4. List Monitoring Services

GET /monitor/listconfig
Description

Obtains a list of services to be monitored on the remote host group for DNS and DHCP Appliances defined and managed by the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/monitor/listconfig

Parameters
Type Name Description Schema Default

Query

draw
optional

Pagination Rendering Parameter

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Service Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListMonitor Information

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.100.5. IPAM System Maintenance Information

GET /monitor/maintenance_list
Description

Obtains list of maintenance operations in progress.
The example listed below shows a sample request URL:
/rest/monitoring/maintenance_list

Responses
HTTP Code Description Schema

200

successful operation

< string > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.100.6. Enable or Disable Monitoring

POST /monitor/monitoring
Description

Enable or disable monitoring for the current TCPWave Remote in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Body

body
optional

Server Information

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.100.7. Enables or Disables Monitoring on specified resources

POST /monitor/monitoringUpdate
Description

Enables or disables monitoring for the specified resources in the TCPWave IPAM.
Below example shows sample request JSON:
[ { "name": "Network-1", "type": "network", "ip": "network", "organization": "network", "monitor": true, "stype": "DHCP" }]

Parameters
Type Name Description Schema Default

Body

body
optional

< MonitoringUpdateRequest > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.100.8. Monitoring Hierarchy Details

GET /monitor/monitoring_hierarchy
Description

Get monitoring hierarchy details in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/monitor/monitoring_hierarchy?orgName=Internal

Parameters
Type Name Description Schema Default

Query

orgName
required

organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< MonitoringHierarchy > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.100.9. Enable or Disable Monitoring

POST /monitor/multimonitoring
Description

Enable or disable monitoring for the current TCPWave Remote in the TCPWave IPAM.

Parameters
Type Name Description Schema Default

Body

body
optional

< Server Information > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.100.10. Re-check An Alert

POST /monitor/recheckAlert
Description

Manually checks the specified alert in the TCPWave IPAM.
Below example shows sample request JSON:
{"host_address":"192.168.1.12","host_name":"remote12.tcpwave.com","host_type":"IPAMDHCPAlert","category":"RESPONSE_TIME","service":"RESPONSE_TIME","output":"CRITICAL - ICMP to remote12.tcpwave.com has failed."}

Parameters
Type Name Description Schema Default

Body

body
optional

Notification Details

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, 14102 = TIMS-14102: Force re-check is not supported for the specified alert., 14100 = TIMS-14100: Alert error message cannot be null or empty., 14101 = TIMS-14101: Alert category value cannot be null or empty.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.100.11. Update Monitoring Service

POST /monitor/update
Description

Update monitoring services configuration in the TCPWave IPAM.
Below example shows sample request JSON:
[ { "serviceId": 1, "serviceName": "SYSTEM_CPU", "serviceDescription": "Monitor the % CPU of all host types", "category": "Appliance Components", "bindAuth": "true/false", "bindCache": "true/false", "unboundCache": "true/false", "nsdAuth": "1", "dhcp": "true/false", "ipam": "true/false", "enableFlapping": "1", "enableAlertAck": "1", "enableCritical": "1", "enableWarning": "1", "enableUnknown": "0", "scheduledDownTime": "10/1/2019 12:00:00", "criticalThresholdVal": "70", "warningThresholdVal": "50", "disableAlertFromString": "10/1/2019 12:00:00", "disableAlertToString": "12/1/2019 12:00:00", "userScriptPath": "string" }]

Parameters
Type Name Description Schema Default

Body

body
optional

< Monitor Information > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

4.100.12. Monitoring Service

POST /monitor/updateServiceStatus
Description

Enables/disables an existing monitoring service.
The example listed below shows a sample request URL:
/rest/monitoring/updateServiceStatus?status=1
Below example shows sample request JSON:
[ { "serviceId": 1, "serviceName": "SYSTEM_CPU", "serviceDescription": "Monitor the % CPU of all host types", "category": "Appliance Components", "bindAuth": "true/false", "bindCache": "true/false", "unboundCache": "true/false", "nsdAuth": "1", "dhcp": "true/false", "ipam": "true/false", "enableFlapping": "1", "enableAlertAck": "1", "enableCritical": "1", "enableWarning": "1", "enableUnknown": "0", "scheduledDownTime": "10/1/2019 12:00:00", "criticalThresholdVal": "70", "warningThresholdVal": "50", "disableAlertFromString": "10/1/2019 12:00:00", "disableAlertToString": "12/1/2019 12:00:00", "userScriptPath": "string" }]

Parameters
Type Name Description Schema Default

Query

status
required

Monitoring Service status

integer(int32)

Body

body
optional

< Monitor Information > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.101. Network Security Monitoring Service

4.101.1. Delete NSM Domain

POST /nsm/domain/delete
Description

This operation deletes single or multiple domains based on the whitelisted or blacklisted category associated with the NSM templates.
The following example shows a sample request URL:
/rest/nsm/domain/delete?name=templateName&organization=Internal

Parameters
Type Name Description Schema Default

Query

name
optional

Template Name

string

Query

organization
required

Organization Name

string

Body

body
required

NSM Domains

< Whitelist and Blacklist domain > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.101.2. NSM Domains

GET /nsm/domain/get
Description

This operation retrieves the list of all the whitelisted and blacklisted domains defined in the NSM template.
The following example shows a sample request URL:
/rest/nsm/domain/get?name=test&organization=Internal

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

name
optional

Template Name

string

Query

order
optional

Sort Order(asc/desc)

string

Query

organization
required

Organization Name

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Start Page Number

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListWhitelist And Blacklist Domain

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.101.3. Update Domains

POST /nsm/domain/update
Description

This operation updates the whitelisted or blacklisted domains associated with the NSM template.
The following example shows a sample request URL:
/rest/nsm/domain/update?name=templateName&organization=Internal

Parameters
Type Name Description Schema Default

Query

name
optional

Template Name

string

Query

organization
required

Organization Name

string

Body

body
required

NSM Domain

< Whitelist and Blacklist domain > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.101.4. Update IPS Rules

POST /nsm/ipsRule/changeStatus
Description

This operation updates the IPS rule on the DNS Appliance.
The following example shows a sample request URL:
/rest/nsm/ipsRule/changeStatus?name=templateName&organization=Internal

Parameters
Type Name Description Schema Default

Query

name
optional

Template Name

string

Query

organization
required

Organization Name

string

Body

body
required

IPS Rule

< Intrusion Provision System Rule > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.101.5. Delete IPS Rules

POST /nsm/ipsRule/delete
Description

This operation deletes the IPS rules associated with the NSM template.
The following example shows a sample request URL:
/rest/nsm/ipsRule/delete?name=test&organization=Internal

Parameters
Type Name Description Schema Default

Query

name
optional

Template Name

string

Query

organization
required

Organization Name

string

Body

body
required

IPS Rule

< Intrusion Provision System Rule > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.101.6. Delete IPS Rules

POST /nsm/ipsRule/deleteFromAppliance
Description

This operation deletes the IPS rules associated with the NSM template.
The following example shows a sample request URL:
/rest/nsm/ipsRule/deleteFromAppliance?name=test&organization=Internal

Parameters
Type Name Description Schema Default

Query

name
optional

Template Name

string

Query

organization
required

Organization Name

string

Body

body
required

IPS Rule

< Intrusion Provision System Rule > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.101.7. IPS Rules

GET /nsm/ipsRule/get
Description

This operation retrieves the list of IPS rules associated with the NSM template.
The following example shows a sample request URL:
/rest/nsm/ipsRule/get?name=test&organization=Internal

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

name
optional

Template Name

string

Query

order
optional

Sort Order(asc/desc)

string

Query

organization
required

Organization Name

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Start Page Number

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListIntrusion Provision System Rule

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.101.8. Update IPS Rules

POST /nsm/ipsRule/update
Description

This operation updates the IPS rules with the latest configurations such as signature ID, class category, etc.
The following example shows a sample request URL:
/rest/nsm/ipsRule/update?name=templateName&organization=Internal

Parameters
Type Name Description Schema Default

Query

name
optional

Template Name

string

Query

organization
required

Organization Name

string

Body

body
required

IPS Rule

< Intrusion Provision System Rule > array

Responses
HTTP Code Description Schema

200

successful operation

< Intrusion Provision System Rule > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.101.9. Create NSM Template

POST /nsm/template/create
Description

This operation creates the NSM template with configurations such as organization, network interface, rule variables, etc.
The following example shows a sample request JSON:
{"name":"NSM_TEMPLATE_TEST","description":"Testing template","organizationId":"1690","configuration":"{"interface":"eth0","enable_anomaly_detection":true,"enable_intrusion_prevention":true,"ml_model":"3"}","ipsRuleVariables":"[{"name":"TEST_HOME_VARIABLE","value":"test"}]","ipsRuleList":[{"ruleDefinition":"Test Rule","status":true}]}

Parameters
Type Name Description Schema Default

Body

body
required

NSM Template Configuration

Network Security Monitoring Template

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.101.10. NSM Template Delete

POST /nsm/template/delete
Description

This operation deletes the NSM template defined in the TCPWave IPAM, provided it should not have the DNS appliances references.
The following example shows a sample request URL:
/rest/nsm/template/delete?name=test&organization=Internal

Parameters
Type Name Description Schema Default

Query

name
required

NSM Template Name

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

500

TIMS-5020: Template does not exist, TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.101.11. NSM Template Dropdown List

GET /nsm/template/dropdown/list
Description

This operation retrieves the list of all the Network Security Monitoring (NSM) templates defined in the TCPWave IPAM.
The following example shows a sample request URL:
/rest/nsm/template/dropdown/list?organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization Names

string

Responses
HTTP Code Description Schema

200

successful operation

< Network Security Monitoring Template > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.101.12. NSM Template

GET /nsm/template/get
Description

This operation retrieves the NSM template details such as network interface, organization, etc.
The following example shows a sample request URL:
/rest/nsm/template/get?name=test&organization=Internal

Parameters
Type Name Description Schema Default

Query

name
optional

Template Name

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Network Security Monitoring Template

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.101.13. Get Appliances

GET /nsm/template/get-associated-appliance
Description

This operation retrieves the list of the appliances associated with the NSM template.
The following example shows a sample request URL:
/rest/nsm/template/get-associated-appliance?name=test&organization=Internal

Parameters
Type Name Description Schema Default

Query

name
optional

Template Name

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Server Information > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.101.14. TCPWave’s Default IPS Rules

GET /nsm/template/getDefaultIPSRules
Description

This operation retrieves the list of the default IPS rules defined in the TCPWave IPAM.
The following example shows a sample request URL:
/rest/nsm/template/getDefaultIPSRules

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • text/plain

4.101.15. NSM Template List

GET /nsm/template/list
Description

This operation retrieves the list of all the Network Security Monitoring (NSM) templates defined in the TCPWave IPAM.
The following example shows a sample request URL:
/rest/nsm/template/list?organization=Internal

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

customFilterRules
optional

Custom Filter String

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
optional

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organization Names

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
optional

Starting Template Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListNetwork Security Monitoring Template

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.101.16. Update NSM Template

POST /nsm/template/update
Description

This operation updates the NSM template with the latest configurations such as network interface, rule variables, machine learning models such KNN, Random Forests, etc.
The following example shows a sample request JSON:
{"name":"nsm_template_1","description":"Network Security Monitoring Template ","organizationId":"1690","configuration":"{"interface":"eth0","enable_anomaly_detection":true,"enable_intrusion_prevention":true,"ml_model":"3"}","ipsRuleVariables":"[{"name":"HOME_NET","value":"[192.168.0.0/16,10.0.0.0/8,172.16.0.0/12]"},{"name":"EXTERNAL_NET","value":"!$HOME_NET"},{"name":"TEST","value":"TEST_VALUE"}]","ipsRuleList":[{"id":1,"ruleDefinition":"Test Rule","status":true},{"id":12,"ruleDefinition":"Test Rule10","status":false}],"oldName":"nsm_template_1","id":1}

Parameters
Type Name Description Schema Default

Body

body
required

NSM Template Configuration

Network Security Monitoring Template

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.102. Network Service

Description

This service class provides REST API access to Create, Modify and Delete a Network in the TCPWave IPAM.

4.102.1. Network Add

POST /network/add
Description

Creates a new IPv4 Network in the TCPWave IPAM. The API checks if the specified network is overlapping with any existing network or not.
Sample payload with mandatory parameters to add a network are listed below.
Create network
{ "addr1":10,"addr2":0,"addr3":0,"addr4":2,"mask_length":"16","name":"test","organization_name":"QAOrg"}
Create network with zone template:
{"addr1":10,"addr2":0,"addr3":0,"addr4":2,"mask_length":"16","name":"test","organization_name":"QAOrg","zoneTemplateName":"z_t"}
Create network with DMZ Visiblity:
{"addr1":10,"addr2":0,"addr3":0,"addr4":2,"mask_length":"16","name":"test","organization_name":"QAOrg","zoneTemplateName":"z_t","dmzVisible":"yes"}
Create network with DNSSEC Enabled:
{"addr1":10,"addr2":0,"addr3":0,"addr4":2,"mask_length":"16","name":"test","organization_name":"QAOrg","zoneTemplateName":"z_t","dmzVisible":"no","dnssec_enable":"yes"}
Create network with Monitoring Enabled:
{"addr1":10,"addr2":0,"addr3":0,"addr4":2,"mask_length":"16","name":"test","organization_name":"QAOrg","zoneTemplateName":"z_t","dmzVisible":"no","dnssec_enable":"no","monitoringService":"yes"}
Create network with Discovery Enabled:
{"addr1":10,"addr2":0,"addr3":0,"addr4":2,"mask_length":"16","name":"test", "organization_name":"QAOrg","zoneTemplateName":"z_t","dmzVisible":"no","dnssec_enable":"no","monitoringService":"no","enable_discovery":"yes","discovery_template":"dt"}

Parameters
Type Name Description Schema Default

Body

body
optional

Network Information

Responses
HTTP Code Description Schema

500

TIMS-1100 - If both organization id and organization name are not specified in the input, TIMS-1101 If organization doesn’t exist with the given organization name in the input, TIMS-7003 If the admin does not have necessary permissions to create a network.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.102.2. Network Add

POST /network/add_next
Description

Creates network at the next available space in a given mask.
The example listed below shows a sample request URL
/rest/network/add_next?name=ntw&org_name=Internal&zone_template=zt&mask=24

Parameters
Type Name Description Schema Default

Query

mask
required

New mask

integer(int32)

Query

name
required

name of the network

string

Query

org_name
required

organization name associated with the block

string

Query

zone_template
required

name of the reverse zone template

string

Body

body
optional

AddressBlock

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1100 - If both organization id and organization name are not specified in the input, TIMS-1101 If organization doesn’t exist with the given organization name in the input, TIMS-7003 If the admin does not have necessary permissions to create a network.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

4.102.3. Associated Servers Check

POST /network/associated-servers-check
Description

Checks all the associated servers defined in a specified IPv4 Network in the TCPWave IPAM.
Sample payload with mandatory parameters to check the associated server with the network is listed below.
{"address":"10.0.0.0","organization_name":"QAOrg"}

Parameters
Type Name Description Schema Default

Body

body
optional

Network Information

Responses
HTTP Code Description Schema

200

successful operation

Network Information

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.102.4. Network Delete

POST /network/delete
Description

Deletes the specified IPv4 Network present in the TCPWave IPAM. Functional Admin can delete networks belonging to any organization. Rest of the admins can delete networks belonging to their organization only.
Sample payload with mandatory parameters to delete network is listed below:
{"address":"10.1.10.0","organization_name":"QAOrg"}

Parameters
Type Name Description Schema Default

Body

body
optional

Network Information

Responses
HTTP Code Description Schema

500

TIMS-2008 - Both Network address and id cannot be null. TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.102.5. Network Details by IP

GET /network/detailsByIP
Description

Provides Network details of the specified network based on the Network IP in the TCPWave IPAM.
The example listed below shows a sample request URL
/rest/network/detailsByIP?addr1=10&addr2=0&addr3=0&addr4=0&organizationName=Internal

Parameters
Type Name Description Schema Default

Query

addr1
required

First bit of IP

integer(int32)

Query

addr2
required

Second bit of IP

integer(int32)

Query

addr3
required

Third bit of IP

integer(int32)

Query

addr4
required

Fourth bit of IP

integer(int32)

Query

organizationName
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Network Information

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.102.6. Edit Network

POST /network/edit
Description

Updates the existing IPv4 Network details in the TCPWave IPAM.
Below example shows sample request JSON:
{"address":"10.1.10.0","mask_length":"24","name":"test", "description":"testing qa","dmzVisible":"no","dnssec_enable":"no", "nsec_option":"NSEC3","enable_discovery":"no","discovery_template":"", "zoneTemplateName":"z_t","addr1":"10","addr2":"1","addr3":"10", "addr4":"0","oldName":"test","organization_name":"QAOrg"}

Parameters
Type Name Description Schema Default

Body

body
optional

Network Information

Responses
HTTP Code Description Schema

500

TIMS-3101: Network does not exist, TIMS-2008: Both Network address and id cannot be null.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.102.7. Get next available network

GET /network/getNextAvailableNetwork
Description

Returns next available network in an Organization. If startIP and endIP are given, the next available networkin that range will be returned. If series is given, the next available network in the below ranges will be returned. 10.0.0.0 - 10.255.255.255 or 172.16.0.0 - 172.31.255.255 or 192.168.0.0 - 192.168.255.255 according to the series given. Series accepts 10 or 172 or 192. If series is also not given, the above ranges will be checked in that order.
The example listed below shows a sample request URL
/rest/network/getNextAvailableNetwork?mask=24&orgName=Internal

Parameters
Type Name Description Schema Default

Query

endIP
optional

End IP

string

Query

mask
required

Mask length

integer(int32)

Query

orgId
optional

Organization Id

integer(int32)

Query

orgName
required

Organization name

string

Query

series
optional

Series

string

Query

startIP
optional

Start IP

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • text/plain

4.102.8. Network List

GET /network/list
Description

Provides the list of all available networks in the TCPWave IPAM. Networks are used to define subnets and objects in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/network/list?page=1&rows=20

Parameters
Type Name Description Schema Default

Query

page
required

Start Page Number

integer(int32)

Query

rows
required

Total Length

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< Network Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.102.9. Network Details

GET /network/paged
Description

Lists all the IPv4 Networks available in the TCPWave IPAM. Functional Admin gets the list of all Networks. Rest of the Admins get only the list of networks to the organization that they belong to.
The example listed below shows a sample request URL
/rest/network/paged?start=0&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Comma Separated Organization Names

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Start Page Number

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListNetwork Information

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.102.10. Network Property Finder

GET /network/propertyFinder/ip/{network_address}
Description

Provides the properties of a specified IPv4 network in the TCPWave IPAM.
Below are the sample query parameter values accepted:

The example listed below shows a sample request URL
/rest/network/propertyFinder/ip/10.0.0.2?organizationName=Internal

Parameters
Type Name Description Schema Default

Path

network_address
required

network address

string

Query

organizationName
required

Organization

string

Responses
HTTP Code Description Schema

200

successful operation

Network Information

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.102.11. Network Statistics

GET /network/stats
Description

Get detailed statistics information of the specified network in the TCPWave IPAM.

The example listed below shows a sample request URL
/rest/network/stats?address=10.0.0.2&id=1234

Parameters
Type Name Description Schema Default

Query

address
required

Network IP Address

string

Query

id
optional

Network ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

Network Stats

Consumes
  • text/plain

  • application/xml

Produces
  • application/json

  • application/xml

4.102.12. Subnet Property Finder

GET /network/subnets/ip/{subnet_address}/{organization_name}
Description

Provides the properties of IPv4 network based on subnet address and organization in the TCPWave IPAM.
The example listed below shows a sample request URL
/rest/network/subnets/ip/10.0.0.2/Internal

Parameters
Type Name Description Schema Default

Path

organization_name
required

Organization Name

string

Path

subnet_address
required

Subnet Address

string

Responses
HTTP Code Description Schema

200

successful operation

Network Information

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.103. Non-Managed DNS Masters Service

Description

This service provides API's to get list of Non-Managed DNS Masters present in the TCPWave IPAM, add Non-Managed DNS Masters, update Non-Managed DNS Masters, delete Non-Managed DNS Masters, search for a Non-Managed DNS Masters in the TCPWave IPAM.

4.103.1. Non-Managed DNS Master Add

POST /externaldnsmasters/add
Description

Creates a new Non-Managed DNS master in the TCPWave IPAM .
Below example shows sample request JSON:
{ "name":"server.example.com","ipv4_address":"10.1.1.1","masterType":"PDNS","user_name":"john","password":"password","description":"Description for the External DNS Master" }
{ "name":"server.example.com","ipv4_address":"10.1.1.1","masterType":"XDNS","tsig_name":"key_name","tsig_algo":"HMAC-SHA512","secret_key":"skshHGFKHGHSF&=–KDJFsdbjsj","description":"Description for the External DNS Master" }

Parameters
Type Name Description Schema Default

Body

body
required

External DNS Master Details

External DNS Master

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist: {0}., TIMS-7003: You are not authorized to perform this operation., 1738 = TIMS-1738: {0} Master cannot be created as there is a TCPWave Remote already exist with the same IPv4 address: {1}., 1739 = TIMS-1739: {0} Master cannot be created as there is a Microsoft Windows Remote already exist with the same IPv4 address: {1}., 1740 = TIMS-1740: {0} Master cannot be created as there is a IPAM Appliance already exist with the same IPv4 address: {1}., 1741 = TIMS-1741: {0} Master already exist with the same IPv4 address: {1}., 1742 = TIMS-1742: {0} Master already exist with the same name: {1}.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.103.2. Non-Managed DNS Master Details

GET /externaldnsmasters/delete
Description

Delete the Non-Managed DNS Master defined on the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/externaldnsmasters/delete?organization_name=Internal&master_type=External DNS/Power DNS&ip=10.0.0.6

Parameters
Type Name Description Schema Default

Query

id
optional

Non-Managed DNS Master Id

integer(int32)

Query

ip
required

Non-Managed DNS Master IPv4 Address

string

Query

master_type
required

Master Type

string

Query

organization_id
optional

Organization Id

integer(int32)

Query

organization_name
required

Organization name

string

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist: {0}., TIMS-7003: You are not authorized to perform this operation.,1744 = TIMS-1744: Both DNS Master Id and IPv4 Address cannot be null., 1745 = TIMS-1745: {0} Master cannot be deleted as there are one or more external DNS zones defined in it.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.103.3. Non-Managed DNS Master Edit

POST /externaldnsmasters/edit
Description

Updates a Non-Managed DNS master in the TCPWave IPAM .
Below example shows sample request JSON:
{ "name":"server.example.com","ipv4_address":"10.1.1.1","organization_name":"Org""masterType":"PDNS","user_name":"john","description":"Description for the External DNS Master" }
{ "name":"server.example.com","ipv4_address":"10.1.1.1","organization_name":"Org""masterType":"XDNS","tsig_name":"key_name","tsig_algo":"HMAC-SHA512","secret_key":"skshHGFKHGHSF&=–KDJFsdbjsj","description":"Description for the External DNS Master" }

Parameters
Type Name Description Schema Default

Body

body
required

External DNS Master Details

External DNS Master

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist: {0}., TIMS-7003: You are not authorized to perform this operation., 1742 = TIMS-1742: {0} Master already exist with the same name: {1}., 1743 = TIMS-1743: {0} Master does not exists in the IPAM with the IPv4 Address: {1}.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.103.4. Non-Managed DNS Master Details

GET /externaldnsmasters/get
Description

Gets the details of an Non-Managed DNS Master defined on the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/externaldnsmasters/get?organization_name=Internal&master_type=External DNS/Power DNS

Parameters
Type Name Description Schema Default

Query

id
optional

Non-Managed DNS Master Id

integer(int32)

Query

ip
required

Non-Managed DNS Master IPv4 Address

string

Query

master_type
required

Master Type

string

Query

organization_id
optional

Organization Id

integer(int32)

Query

organization_name
required

Organization name

string

Responses
HTTP Code Description Schema

200

successful operation

External DNS Master

500

TIMS-1020: Both Organization name and id cannot be null., TIMS-1352: Organization does not exist: {0}., 1743 = TIMS-1743: {0} Master does not exists in the IPAM with the IPv4 Address: {1}., 1744 = TIMS-1744: Both DNS Master Id and IPv4 Address cannot be null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.103.5. Non-Managed/PowerDNS master Details

GET /externaldnsmasters/getepdnslist
Description

Lists all the Non-Managed/PowerDNS defined in the organization.
The example listed below shows a sample request URL:
/rest/externaldnsmasters/getepdnslist?orgName=Internal

Parameters
Type Name Description Schema Default

Query

masterType
optional

Master type

string

Query

orgId
optional

Organization Id

integer(int32)

Query

orgName
optional

Organization name

string

Responses
HTTP Code Description Schema

200

successful operation

< External DNS Master > array

500

TIMS-1352: Organization does not exist: {0}

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.103.6. Non-Managed DNS Masters List

GET /externaldnsmasters/page
Description

Obtains a list of all the Non-Managed DNS Masters defined in the TCPWave IPAM. Functional admin gets the list of all Non-Managed DNS Masters. Rest of the admins get only the list of Non-Managed DNS Masters associated with the organization that they belong to.
The example listed below shows a sample request URL:
/tims/rest/externaldnsmasters/page?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organization Names

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting DNS Appliance Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListExternal DNS Master

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.103.7. Non-Managed DNS master Sync

POST /externaldnsmasters/sync
Description

Performs Sync operations on the Non-Managed DNS Masters.
Below example shows sample sync URL:
/rest/externaldnsmasters/sync?organization_name=Internal&masterType=External DNS/Power DNS&ip=10.0.0.8

Parameters
Type Name Description Schema Default

Query

ip
required

Master IP Address

string

Query

masterType
required

Master type

string

Query

organization_id
optional

Organization Id

integer(int32)

Query

organization_name
required

Organization name

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1352: Organization does not exist: {0}

No Content

Consumes
  • application/json

  • text/plain

4.103.8. Non-Managed DNS Master Add

POST /v6externaldnsmasters/add
Description

Creates a new Non-Managed DNS master in the TCPWave IPAM .
Below example shows sample request JSON:
{ "name":"server.example.com","ipv4_address":"10.1.1.1","masterType":"PDNS","user_name":"john","password":"password","description":"Description for the External DNS Master" }
{ "name":"server.example.com","ipv4_address":"10.1.1.1","masterType":"XDNS","tsig_name":"key_name","tsig_algo":"HMAC-SHA512","secret_key":"skshHGFKHGHSF&=–KDJFsdbjsj","description":"Description for the External DNS Master" }

Parameters
Type Name Description Schema Default

Body

body
required

External DNS Master Details

External DNS Master

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist: {0}., TIMS-7003: You are not authorized to perform this operation., 1738 = TIMS-1738: {0} Master cannot be created as there is a TCPWave Remote already exist with the same IPv6 address: {1}., 1739 = TIMS-1739: {0} Master cannot be created as there is a Microsoft Windows Remote already exist with the same IPv6 address: {1}., 1740 = TIMS-1740: {0} Master cannot be created as there is a IPAM Appliance already exist with the same IPv6 address: {1}., 1741 = TIMS-1741: {0} Master already exist with the same IPv6 address: {1}., 1742 = TIMS-1742: {0} Master already exist with the same name: {1}.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.103.9. Non-Managed DNS Master Details

GET /v6externaldnsmasters/delete
Description

Delete the Non-Managed DNS Master defined on the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/externaldnsmasters/delete?organization_name=Internal&master_type=External DNS/Power DNS&ip=10.0.0.6

Parameters
Type Name Description Schema Default

Query

id
optional

Non-Managed DNS Master Id

integer(int32)

Query

ip
required

Non-Managed DNS Master IPv4 Address

string

Query

master_type
required

Master Type

string

Query

organization_id
optional

Organization Id

integer(int32)

Query

organization_name
required

Organization name

string

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist: {0}., TIMS-7003: You are not authorized to perform this operation.,1744 = TIMS-1744: Both DNS Master Id and IPv4 Address cannot be null., 1745 = TIMS-1745: {0} Master cannot be deleted as there are one or more external DNS zones defined in it.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.103.10. Non-Managed DNS Master Edit

POST /v6externaldnsmasters/edit
Description

Updates a Non-Managed DNS master in the TCPWave IPAM .
Below example shows sample request JSON:
{ "name":"server.example.com","ipv4_address":"10.1.1.1","organization_name":"Org""masterType":"PDNS","user_name":"john","description":"Description for the External DNS Master" }
{ "name":"server.example.com","ipv4_address":"10.1.1.1","organization_name":"Org""masterType":"XDNS","tsig_name":"key_name","tsig_algo":"HMAC-SHA512","secret_key":"skshHGFKHGHSF&=–KDJFsdbjsj","description":"Description for the External DNS Master" }

Parameters
Type Name Description Schema Default

Body

body
required

External DNS Master Details

External DNS Master

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist: {0}., TIMS-7003: You are not authorized to perform this operation., 1742 = TIMS-1742: {0} Master already exist with the same name: {1}., 1743 = TIMS-1743: {0} Master does not exists in the IPAM with the IPv4 Address: {1}.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.103.11. Non-Managed DNS Master Details

GET /v6externaldnsmasters/get
Description

Gets the details of an Non-Managed DNS Master defined on the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/externaldnsmasters/get?organization_name=Internal&master_type=External DNS/Power DNS

Parameters
Type Name Description Schema Default

Query

id
optional

Non-Managed DNS Master Id

integer(int32)

Query

ip
required

Non-Managed DNS Master IPv4 Address

string

Query

master_type
required

Master Type

string

Query

organization_id
optional

Organization Id

integer(int32)

Query

organization_name
required

Organization name

string

Responses
HTTP Code Description Schema

200

successful operation

External DNS Master

500

TIMS-1020: Both Organization name and id cannot be null., TIMS-1352: Organization does not exist: {0}., 1743 = TIMS-1743: {0} Master does not exists in the IPAM with the IPv4 Address: {1}., 1744 = TIMS-1744: Both DNS Master Id and IPv4 Address cannot be null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.103.12. Non-Managed/PowerDNS master Details

GET /v6externaldnsmasters/getepdnslist
Description

Lists all the Non-Managed/PowerDNS defined in the organization.
The example listed below shows a sample request URL:
/rest/externaldnsmasters/getepdnslist?orgName=Internal

Parameters
Type Name Description Schema Default

Query

masterType
optional

Master type

string

Query

orgId
optional

Organization Id

integer(int32)

Query

orgName
optional

Organization name

string

Responses
HTTP Code Description Schema

200

successful operation

< External DNS Master > array

500

TIMS-1352: Organization does not exist: {0}

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.103.13. Non-Managed DNS IPv6 Masters List

GET /v6externaldnsmasters/page
Description

Obtains a list of all the Non-Managed DNS IPv6 Masters defined in the TCPWave IPAM. Functional admin gets the list of all Non-Managed DNS IPv6 Masters. Rest of the admins get only the list of Non-Managed DNS IPv6 Masters associated with the organization that they belong to.
The example listed below shows a sample request URL:
/tims/rest/v6externaldnsmasters/page?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organization Names

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting DNS Appliance Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListExternal DNS Master

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.103.14. Non-Managed DNS master Sync

POST /v6externaldnsmasters/sync
Description

Performs Sync operations on the Non-Managed DNS Masters.
Below example shows sample sync URL:
/rest/externaldnsmasters/sync?organization_name=Internal&masterType=External DNS/Power DNS&ip=10.0.0.8

Parameters
Type Name Description Schema Default

Query

ip
required

Master IP Address

string

Query

masterType
required

Master type

string

Query

organization_id
optional

Organization Id

integer(int32)

Query

organization_name
required

Organization name

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1352: Organization does not exist: {0}

No Content

Consumes
  • application/json

  • text/plain

4.104. Non-Managed DNS Zones Service

Description

This service provides API's to get list of Non-Managed DNS Zones present in the TCPWave IPAM, add Non-Managed DNS Zones, update Non-Managed DNS Zones, delete Non-Managed DNS Zones, search for a Non-Managed DNS Zones in the TCPWave IPAM.

4.104.1. Non-Managed DNS Zone Add

POST /externaldnszone/add
Description

Creates a new Non-Managed DNS zone in the TCPWave IPAM .
Below example shows sample request JSON:
{ "zoneName":"example.com","externalDNSMasterIPs":["10.1.1.1"],"masterType":"PDNS","description":"Description for the External DNS Zone","orgName":"Organization" }
{ "zoneName":"example.com","externalDNSMasterIPs":["10.1.1.1"],"internalDNSSlaveIPs":["10.1.1.2"]"masterType":"XDNS","tsig_name":"key_name","tsig_algo":"HMAC-SHA512","secret_key":"skshHGFKHGHSF&=–KDJFsdbjsj","description":"Description for the External DNS Zone","orgName":"Organization" }

Parameters
Type Name Description Schema Default

Body

body
required

External DNS Zone Details

External DNS Zone

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.
TIMS-1352: Organization does not exist: {0}
TIMS-1746: Invalid master type specified, master type as Power DNS or External DNS.
TIMS-1747: Non-Managed DNS Zone cannot be created as there is a TCPWave managed zone already exist with the name: {0}.
TIMS-1748: Non-Managed DNS Zone cannot be created as there is a TCPWave managed object already exist with the name: {0}.
TIMS-1749: Non-Managed DNS Zone cannot be created as there is a TCPWave managed resource record already exist with the name: {0}.
TIMS-1750: Non-Managed DNS Zone cannot be created as there is a TCPWave managed IPv6 object already exist with the name: {0}.
TIMS-1751: Non-Managed DNS Zone cannot be created as there is a TCPWave managed appliance level forwarder zone already exist with the name: {0}.
TIMS-1752: Non-Managed DNS Zone cannot be created as there is a TCPWave managed appliance template level forwarder zone already exist with the name: {0}.
TIMS-1753: Non-Managed DNS Zone cannot be created as there is no TCPWave managed DNS appliance defined with IPv4 address: {0}.
TIMS-1755: Non-Managed DNS Zone already exist with the same name: {0}.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.104.2. Non-Managed DNS Zone Delete

POST /externaldnszone/delete
Description

Deletes Non-Managed DNS Zones in the TCPWave IPAM. Functional Admin can Delete Zones for any organization. Rest of the admins can Delete Zones only for the organizations that they are associated with.
Below example shows sample request JSON:
{ "zone_name":"test.com","organization_name":"QAOrg","masterType":"PDNS"}

Parameters
Type Name Description Schema Default

Body

body
optional

External DNS Zone

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-1352: Organization does not exist: {0}
TIMS-1756: Non-Managed DNS zone name cannot be null.
TIMS-1754: Non-Managed DNS Zone does not exists in the IPAM with the name: {0}.

No Content

Consumes
  • application/json

  • application/xml

4.104.3. Non-Managed DNS Zone Edit

POST /externaldnszone/edit
Description

Updates an existing Non-Managed DNS Zone in the TCPWave IPAM .
Below example shows sample request JSON:
{"zoneName":"example.com","orgName":"Organization","externalDNSMasterIPs":["10.1.1.1"],"masterType":"PDNS","description":"Description for the External DNS Zone" }
{ "zoneName":"example.com","externalDNSMasterIPs":["10.1.1.1"],"internalDNSSlaveIPs":["10.1.1.2"]"masterType":"XDNS","tsig_name":"key_name","tsig_algo":"HMAC-SHA512","secret_key":"skshHGFKHGHSF&=–KDJFsdbjsj","description":"Description for the External DNS Zone","orgName":"Organization" }

Parameters
Type Name Description Schema Default

Body

body
required

Non-Managed DNS Zone Details

External DNS Zone

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist: {0}
TIMS-7003: You are not authorized to perform this operation.
TIMS-1754: Non-Managed DNS Zone does not exists in the IPAM with the name: {0}.
TIMS-1743: {0} Master does not exists in the IPAM with the IPv4 Address: {1}.
TIMS-1753: Non-Managed DNS Zone cannot be created as there is no TCPWave managed DNS appliance defined with IPv4 address: {0}.
TIMS-1746: Invalid master type specified, master type as Power DNS or External DNS.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.104.4. Non-Managed DNS Zone Force Sync

POST /externaldnszone/forcesync
Description

Performs force sync operation on Non-Managed DNS Zones in the TCPWave IPAM.
Below example shows sample request JSON:
{ "zone_name":"test.com","organization_name":"QAOrg","masterType":"PDNS"}

Parameters
Type Name Description Schema Default

Body

body
optional

External DNS Zone

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-1352: Organization does not exist: {0}
TIMS-1756: Non-Managed DNS zone name cannot be null.
TIMS-1754: Non-Managed DNS Zone does not exists in the IPAM with the name: {0}.

No Content

Consumes
  • application/json

  • application/xml

4.104.5. Non-Managed DNS Zone Details

GET /externaldnszone/get
Description

Details of the Non-Managed DNS Zone defined on the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/externaldnszone/get?name=zoneabc.com&master_type=Power DNS/External DNS

Parameters
Type Name Description Schema Default

Query

master_type
required

Master Type

string

Query

name
required

Zone name

string

Query

organization_id
optional

Organization ID

integer(int32)

Query

organization_name
optional

Organization name

string

Responses
HTTP Code Description Schema

200

successful operation

External DNS Zone

500

TIMS-1020: Both Organization name and id cannot be null.
TIMS-1352: Organization does not exist: {0}
TIMS-1746: Invalid master type specified, master type as Power DNS or External DNS.
TIMS-1756: Non-Managed DNS zone name cannot be null.
TIMS-1754: Non-Managed DNS Zone does not exists in the IPAM with the name: {0}.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.104.6. Non-Managed DNS Zone List

GET /externaldnszone/page
Description

Obtains a list of all the Non-Managed DNS Zones defined in the TCPWave IPAM. Functional Admin gets the list of all Non-Managed DNS Zones. Rest of the Admins get only the list of Non-Managed DNS Zones associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/externaldnszone/page?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organization List

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting DNS Appliance Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListExternal DNS Zone

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.104.7. Resource Records List By Zone

GET /externaldnszone/rrsByZone
Description

Obtains a list of all the resource records by Non-Managed DNS Zones defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/externaldnszone/rrsByZone?start=1&length=20&zoneName=zonetest.com

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting DNS Appliance Range

integer(int32)

Query

zoneName
required

Zone Name

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListResource Record

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.105. Object Service

Description

This service class provides REST API access to Create, Modify and Delete an Object in the TCPWave IPAM.

4.105.1. Object Add

POST /object/add
Description

Adds an Object in the specified subnet. Its highly recommended to execute the object duplicate name checker (/object/duplicateNameChecker) REST API call to validate Object name duplicates, A record duplicate, A to CNAME conflicts and Mirrored zone conflicts.
The allowed allocation types are Static(1), DHCP-Manual(2), DHCP-Auto(3), DHCP-Dynamic(4) and Reserved(5).Static objects denote fixed IP addresses which cannot be used in DHCP scopes. Reserved objects are used to reverse the IP addresses for future use. When DHCP-* allocation type is selected, the parameters option_template_name(DHCP Option Template) and dhcp_server(DHCP appliance name) are mandatory. User can also specify DHCP Classes(allowClassesArray and denyClassesArray) for the DHCP objects.When the allocation type is reserved, then user can give optional reservation expiry date(rsrv_exp_dt) with the format 07/31/2019.
If Name Services(update_ns_a and update_ns_ptr) are not checked, object A and PTR resource records will not be propagated to DNS on DNS full sync. If Dynamic DNS Update(dyn_update_rrs_a, dyn_update_rrs_ptr, dyn_update_rrs_cname, dyn_update_rrs_mx) are not given while creating an object, DDNS updates for this object will not be propagated to the DNS.
If the object type(class_code) is either of AWS Instance, Azure Instance or GCE Instance and the subnet is cloud hosted, user can execute the rest API rest/cloudCompute/instance/create to create VM in the cloud. If the object type is either of VMWare ESXi or VMWare vCenter, the attributes vmware_port, vmware_user_name and vmware_password are mandatory. This object can be used in VMware discovery.
Extension values can be added to the object. Object level resource records will be added if they are given in the payload. Extension attribute values at resource record level also are supported.
Sample payloads with mandatory parameters to add an object are listed below.
Add Static Object:
{"addr1":10,"addr2":0,"addr3":0,"addr4":0,"name":"3G00014Phone","alloc_type":1,"class_code":"CRM Server", "domain_name":"demo.com","organization_name":"QAOrg","subnet_address":"10.0.0.0"}
Add Static Object with DDNS Updates Flags:
{"addr1":10,"addr2":0,"addr3":0,"addr4":0,"name":"3G00014Phone","alloc_type":1,"class_code":"CRM Server", "domain_name":"demo.com","organization_name":"QAOrg","subnet_address":"10.0.0.0","update_ns_a": true,"update_ns_ptr": true,"dyn_update_rrs_a": true,"dyn_update_rrs_ptr": true,"dyn_update_rrs_cname": true,"dyn_update_rrs_mx": true}
Add Static Object with Object Level Resource Records:
{"addr1":10,"addr2":0,"addr3":0,"addr4":0,"name":"3G00014Phone","alloc_type":1,"class_code":"CRM Server", "domain_name":"demo.com","organization_name":"QAOrg","subnet_address":"10.0.0.0","update_ns_a": true,"update_ns_ptr": true,"dyn_update_rrs_a": true,"dyn_update_rrs_ptr": true,"dyn_update_rrs_cname": true,"dyn_update_rrs_mx": true,"rrs": [{"owner": "demo1.demo.com.","rrclass": "IN","rrtype": "A","ttl": "1200","description": "","data": "10.0.0.2"}]}
Add Object with Extensions:
Use the API rest/xtn/attr_val to add an extension value for an extension attribute to an existing object. Below is the sample payload.
{"type":"object","key":"10.0.0.2","values":[{"name":"objXtn","value":"testVal"}]}
Add DHCP Dynamic Object:
{"name": "3G00049Phone","class_code": "3G Phone","alloc_type": "4","option_template_name": "DHCP Option Template","dhcp_server": "DHCP-appliance-1","update_ns_a": true,"update_ns_ptr": true,"dyn_update_rrs_a": true,"dyn_update_rrs_ptr": true,"dyn_update_rrs_cname": true,"dyn_update_rrs_mx": true,"addr1": "10","addr2": "0","addr3": "0","addr4": "7","subnet_address": "10.0.0.0","domain_name": "demo.com","organization_name": "QAOrg"}

Parameters
Type Name Description Schema Default

Body

body
required

Object details

TIMS Object

Responses
HTTP Code Description Schema

500

TIMS-3007: object already exists
TIMS-3021: Cannot find subnet for object address:{0}
TIMS-3022: Cannot find organization information
TIMS-3023: Both domain id and domain name cannot be null
TIMS-1401: Cannot find domain
TIMS-3024: Cannot create an object as the MAC address needs to be unique
TIMS-1266: Cannot find the DHCP class for the name
TIMS-3025: Resource Records already exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.105.2. Association list of the object’s IP address.

GET /object/associationList
Description

This operation retrieves the association list of the object’s IP address.
The example listed below shows a sample request URL:
/rest/object/associationList?ip_address=1.0.0.0&org=Internal&subnet_addr=1.0.0.0/8

Parameters
Type Name Description Schema Default

Query

ip_address
required

Object IP Address

string

Query

org
required

Organization

string

Query

subnet_addr
required

Subnet IP address with mask

string

Responses
HTTP Code Description Schema

200

successful operation

< Resource Record > array

Consumes
  • text/plain

Produces
  • text/plain

  • application/json

  • application/xml

4.105.3. Object Resource Record Update

POST /object/changeReference
Description

Updates the references of resources records which point to a specific IP address with new IP address in the TCPWave IPAM. It updates only A and PTR resource records. After update, it performs sync operation for all the zones whose resource records have been updated.
The example listed below shows a sample request URL:
/rest/object/changeReference?existingIP=10.0.0.5&newIP=10.0.0.6&organizationName=Internal

Parameters
Type Name Description Schema Default

Query

existingIP
required

Existing IP address of the object

string

Query

newIP
required

New IP address of the object

string

Query

organizationName
required

Name of the organization to which object belongs

string

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.105.4. Domain Controller Objects

GET /object/dcobjectlist
Description

Provides Domain Controller Object list
The example listed below shows a sample request URL:
/rest/object/dcobjectlist?organization_name=Internal

Parameters
Type Name Description Schema Default

Query

organization_id
optional

Organization ID

integer(int32)

Query

organization_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< TIMS Object > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.105.5. DC object List by Domain

GET /object/dcobjectlistbydomain
Description

Provides Domain Controller Object list in a Domain.
The example listed below shows a sample request URL:
/rest/object/dcobjectlistbydomain?organization_name=Internal&domain_name=domain.com&organization_id=1700

Parameters
Type Name Description Schema Default

Query

domain_name
required

domain name

string

Query

organization_id
required

organization id

integer(int32)

Query

organization_name
required

organization name

string

Responses
HTTP Code Description Schema

200

successful operation

< TIMS Object > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.105.6. Object Delete

POST /object/delete-multiple
Description

Delete a selection of objects.
Sample payloads with mandatory parameters to delete multiple objects are listed below
{"addressArray":["10.0.0.2"],"isDeleterrsChecked":0,"organization_name":"QAOrg"}

Parameters
Type Name Description Schema Default

Body

body
optional

TIMS Object

Responses
HTTP Code Description Schema

200

successful operation

Resource Record

500

TIMS-3010: Cannot find object
TIMS-3027: Cannot delete the object. As it is associated with an Appliance.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.105.7. Delete Active DHCP Lease

POST /object/deleteDHCPLease
Description

Delete active leases for the selected objects.
Sample payloads with mandatory parameters to delete leases for multiple objects
{"addressArray":["10.0.0.2","10.0.0.3"],"dhcp_server_IP":"10.0.0.50"}

Parameters
Type Name Description Schema Default

Body

body
required

TIMS Object

Responses
HTTP Code Description Schema

200

successful operation

string

500

Response time out while deleting the lease. Active DHCP Lease for <IP> cannot be deleted. Reason: <Exception>

No Content

Consumes
  • text/plain

  • application/json

  • application/xml

Produces
  • text/plain

  • application/json

  • application/xml

4.105.8. Object Duplicate Name Checker

GET /object/duplicateNameChecker
Description

Checks for the occurrence of an object with the same name.
The example listed below shows a sample request URL:
/rest/object/duplicateNameChecker?name=3G00014Phone&domain_name=domain.com&org_name=Internal&ip_addr=10.0.0.2

Parameters
Type Name Description Schema Default

Query

domain_name
required

Domain Name

string

Query

ip_addr
required

IP Address

string

Query

name
required

Object Name

string

Query

org_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • application/json

  • text/plain

4.105.9. Object Edit

POST /object/edit
Description

Edit the Object. It is highly recommended to execute the object duplicate name checker and the A-CNAME conflict checker REST API calls to validate the data before executing this call.User can also add/modify/delete object level resource records using this API by updating the resource records array in the Data Params Section.
Below example shows sample request JSON:
{"address":"10.1.10.87","name":"QA-Remote-87","class_code":"TCPWave Remote", "alloc_type":"1","mac":"aa:bb:cc:dd:ee","ttl":"1000","rsrv_exp_dt":null, "objectview":"","option_template_name":"","dhcp_server":"","update_ns_a":true, "update_ns_ptr":true,"dyn_update_rrs_a":true,"dyn_update_rrs_ptr":true,"dyn_update_rrs_cname":true, "dyn_update_rrs_mx":true,"cloudInstanceTemplate":"","description":"","change_control_team":"", "end_of_life":"","room":"","floor":"","location_name":"","terminal_server_kvm":"", "switch_name":"","port_name":"","duplex_name":"","serial_num":"","contact_id":"", "managed_by":"","monitored_by":"","vmware_port":"","vmware_user_name":"","vmware_password":"*", "addr1":"10","addr2":"1","addr3":"10","addr4":"87","subnet_address":"10.1.10.0", "organization_name":"QAOrg","domain_name":"qa.com"}

Parameters
Type Name Description Schema Default

Body

body
required

Object details

TIMS Object

Responses
HTTP Code Description Schema

500

TIMS-3010: Cannot find object
TIMS-3021: Cannot find subnet for object address:{0}
TIMS-3022: Cannot find organization information
TIMS-1402: cannot find domain:{0}
TIMS-1054: Cannot find location information
TIMS-3026: Cannot change the allocation type as object is a server
TIMS-3024: Cannot update the object as the MAC address needs to be unique
TIMS-3017: Cannot change the Dynamic DNS update options for this object as it belongs to a DHCP Scope.Cannot change the Name Service update options for this object as it belongs to a DHCP Scope
TIMS-3019: Cannot change the DHCP Option Template for this object as it belongs to a DHCP Scope
TIMS-3020: Cannot change the DHCP Appliance for this object as it belongs to a DHCP Scope
TIMS 3025: Resource Records already exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.105.10. Get Object References

POST /object/get-referenced-rrs
Description

Gets the RRs referring to object or A type RR of object.
Below example shows sample request JSON:
/rest/object/get-referenced-rrs?addressList=10.0.0.2,10.0.0.3&organization_name=Internal

Parameters
Type Name Description Schema Default

Query

addressList
required

comma separated list of object IPs

string

Query

organization_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Resource Record

500

TIMS-3010: Cannot find object.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.105.11. Object DHCP Details

GET /object/getDHCPDetails
Description

Gets the DHCP Properties configured for a Dynamic/Manual DHCP Object.
The example listed below shows a sample request URL:
/rest/object/getDHCPDetails?address=10.0.0.2&orgName=Internal

Parameters
Type Name Description Schema Default

Query

address
required

Object Address

string

Query

id
optional

Object ID

integer(int32)

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Object DHCP Details

500

TIMS-7002: Permission information cannot be retrieved. TIMS-3010: Object does not exist:

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.105.12. Object Discovered Details

GET /object/getDiscoveredData
Description

Gets the Object discovered properties.
The example listed below shows a sample request URL:
/rest/object/getDiscoveredData?id=15769

Parameters
Type Name Description Schema Default

Query

id
required

Discovered Object ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

Discovered Object

500

TIMS-3010: Object does not exist:

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.105.13. Get Active and Expired Lease Counts

GET /object/getLeaseCounts
Description

Gets Active and Expired Lease Counts
The example listed below shows a sample request URL:
/rest/object/getLeaseCounts?organization_name=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization List

string

Responses
HTTP Code Description Schema

200

successful operation

DHCP active lease count

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.105.14. Get the next available free IP in a given subnet.

GET /object/getNextFreeIP
Description

Gets the next available free IP in a given subnet.
The example listed below shows a sample request URL:
/rest/object/getNextFreeIP?subnet_addr=10.0.0.0&org_name=Internal

Parameters
Type Name Description Schema Default

Query

org_name
required

Organization Name

string

Query

range_end_addr
optional

Range End Address

string

Query

range_start_addr
optional

Range Start Address

string

Query

subnet_addr
required

Subnet Address

string

Query

subnet_id
optional

Subnet ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • text/plain

  • application/json

  • application/xml

4.105.15. Get the next available free IP in a given subnet.

GET /object/getNextFreeIPandAllocate
Description

Gets the next available free IP in a given subnet.
The example listed below shows a sample request URL:
/rest/object/getNextFreeIPandAllocate?subnet_addr=1.0.0.0&org_name=Internal&domain=abc.com&name=Sample Object

Parameters
Type Name Description Schema Default

Query

domain
required

Domain Name

string

Query

name
required

Object Name

string

Query

org_name
required

Organization Name

string

Query

range_end_addr
optional

Range End Address

string

Query

range_start_addr
optional

Range Start Address

string

Query

subnet_addr
required

Subnet Address

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • text/plain

  • application/json

  • application/xml

4.105.16. Subnet Address

GET /object/getSnAddr
Description

Retrieves subnet Address based on the specified network address.
The example listed below shows a sample request URL:
/rest/object/getSnAddr?address=10.0.0.0

Parameters
Type Name Description Schema Default

Query

address
required

Network Address

string

Responses
HTTP Code Description Schema

200

successful operation

Subnet Information

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.105.17. Subnet Details

GET /object/getSubnetByObjectIP
Description

Retrieves subnet present in the IPAM for the specified allocated, unallocated or reserved object IP address in the specified organization.
The example listed below shows a sample request URL:
/rest/object/getSubnetByObjectIP?address=10.0.0.3&organization=Internal

Parameters
Type Name Description Schema Default

Query

address
required

Object IP Address

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Subnet Information

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.105.18. Get IP Address

GET /object/getip
Description

Obtains the IPv4 Object Address based on the given FQDN and Organization.
The example listed below shows a sample request URL:
/rest/object/getip?fqdn=3G00049Phone.domain.com.&organization_name=Internal

Parameters
Type Name Description Schema Default

Query

fqdn
required

FQDN

string

Query

organization_name
required

Organization

string

Responses
HTTP Code Description Schema

200

successful operation

< string > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.105.19. Object List

GET /object/list
Description

Lists the object that belong to a subnet.
The example listed below shows a sample request URL:
/rest/object/list?subnet_address=10.0.0.0&organization_name=Internal&page=1&rows=20

Parameters
Type Name Description Schema Default

Query

organization_name
required

Organization

string

Query

page
required

Start Page Number

integer(int32)

Query

rows
required

Total Length

integer(int32)

Query

subnet_address
required

Subnet Address

string

Query

subnet_id
optional

Subnet ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< TIMS Object > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.105.20. Unused Object List

GET /object/list/unused
Description

Provides the list of unused objects belong to a subnet.
The example listed below shows a sample request URL:
/rest/object/list/unused?subnet_address=10.0.0.0&organization_name=Internal

Parameters
Type Name Description Schema Default

Query

organization_name
required

Organization

string

Query

subnet_address
required

Subnet Address

string

Query

subnet_id
optional

Subnet ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< string > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.105.21. Object List

GET /object/listByMAC
Description

Provides the lists of objects based on the specified MAC address.
The example listed below shows a sample request URL:
/rest/object/listByMAC?mac=aa:bb:cc:dd:ee:ff&organization_name=QAOrg

Parameters
Type Name Description Schema Default

Query

mac
required

MAC Address

string

Query

organization_name
required

Organization

string

Responses
HTTP Code Description Schema

200

successful operation

< TIMS Object > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.105.22. Object List by Criteria

GET /object/listCriteria
Description

Provides Object List by Criteria.
The example listed below shows a sample request URL:
/rest/object/listCriteria?subnet_address=10.0.0.0&class_code=3G Phone&alloc_type=1&page=1&rows=20

Parameters
Type Name Description Schema Default

Query

alloc_type
required

Allocated Type

integer(int32)

Query

class_code
required

Class Code

string

Query

page
required

Start Page Number

integer(int32)

Query

rows
required

Total length

integer(int32)

Query

subnet_address
required

Subnet Address

string

Query

subnet_id
optional

Subnet ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListTIMS Object

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.105.23. MultiObject Edit

POST /object/multiedit
Description

Edit Multiple Objects.
Below example shows sample request JSON:
{"objectKeyList": [{ "address": "10.0.0.2"},{ "address": "10.0.0.3"}], "class_code":"3G Phone", "domain_name":"demo.com","organization_name":"QAOrg", "ttl":1200}

Parameters
Type Name Description Schema Default

Body

body
required

Multiple object details

Object Basic Information

Responses
HTTP Code Description Schema

500

TIMS-3010: Cannot find object. TIMS-3021: Cannot find subnet for object address:<object address>. TIMS-3022: Cannot find organization information. TIMS-1402: cannot find domain:<domain name>. TIMS-1054: Cannot find location information. TIMS-3026: Cannot change the allocation type as object is a server. TIMS-3024: Cannot update the object as the MAC address needs to be unique. TIMS-3017: Cannot change the Dynamic DNS update options for this object as it belongs to a DHCP Scope.Cannot change the Name Service update options for this object as it belongs to a DHCP Scope.TIMS-3019: Cannot change the DHCP Option Template for this object as it belongs to a DHCP Scope. TIMS-3020: Cannot change the DHCP Appliance for this object as it belongs to a DHCP Scope. TIMS 3025: Resource Records already exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.105.24. Next Free IP

GET /object/nextfreeip
Description

Gets the range of IP addresses that are free to be allocated.
The example listed below shows a sample request URL:
/rest/object/nextfreeip?subnet_address=10.0.0.0&organization_name=Internal

Parameters
Type Name Description Schema Default

Query

organization_name
required

Organization Name

string

Query

subnet_address
required

Subnet Address

string

Responses
HTTP Code Description Schema

200

successful operation

< Address Block > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.105.25. Check if object name exists in the Organization

GET /object/objectNameCheck
Description

Checks if object name is used in the given organization in the TCPWave IPAM. It returns the object details and CNAME resource records of the matching objects.
The example listed below shows a sample request URL:
/rest/object/objectNameCheck?orgName=Internal&name=objectname

Parameters
Type Name Description Schema Default

Query

name
required

Object Name

string

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Basic Object Info > array

500

TIMS-7003: You are not authorized to perform this operationTIMS-1916: Organization name cannot be null.
TIMS-3005: Object name is null.
TIMS-1352: Organization does not exist: {0}
TIMS-3010: Object does not exist: {0}

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.105.26. Object List

GET /object/paged
Description

Provides Object details based on specified subnet address and organization.
The example listed below shows a sample request URL:
/rest/object/paged?subnet_address=10.0.0.0&orgName=Internal&draw=1&start=0&length=20&sort=name&order=asc&filterRules=[]

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

orgName
required

Organization Name

string

Query

sort
optional

Sort String

string

Query

start
required

Start Page Number

integer(int32)

Query

subnet_address
required

Subnet Address

string

Query

subnet_id
optional

Subnet ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListTIMS Object

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.105.27. Ping before create

GET /object/pingcheck
Description

Pings available IP before creating an Object.
The example listed below shows a sample request URL:
/rest/object/pingcheck?address=10.0.0.2

Parameters
Type Name Description Schema Default

Query

address
required

IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.105.28. Objects Reclaim

POST /object/reclaimObjects
Description

Reclaims the static and dynamic objects, static objects will be deleted completely and dynamic objects will be deleted only from DNS and will be return to the pool of available addresses.
Sample payloads with mandatory parameters to reclaim object are listed below.
{"addressArray":["10.0.0.2"],"isDeleterrsChecked":0,"organization_name":"Internal"}

Parameters
Type Name Description Schema Default

Body

body
optional

TIMS Object

Responses
HTTP Code Description Schema

200

successful operation

Resource Record

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.105.29. Object Resource Record Add

POST /object/rr/add
Description

Add resource records to an Object,Zone,Reverse Zone or Proxy Root Zone in TCPWave IPAM.
Sample payloads with mandatory parameters to add resource record are listed below.
{"owner":"tcp.QAZone1.com.","rrclass":"IN","rrtype":"A","ttl":1200,"data":"10.1.10.3","ipAddr":"10.1.10.3","is_ad_rr":0,"organization_name":"QAOrg"}

Parameters
Type Name Description Schema Default

Body

body
required

Resource record details

Resource Record

Responses
HTTP Code Description Schema

500

TIMS-7002: Permission information cannot be retrieved.
TIMS-9561: Old owner of the resource record cannot be null.
TIMS-9564: Old data of the resource record cannot be null.
TIMS-1352: Cannot find organization: {0}.
TIMS-7003: You are not authorized to perform this operation.
TIMS-3006: Object address cannot be null.
TIMS-3009: Object does not exist.
TIMS-3015: Resource record does not exist.
TIMS-3012: CNAME does not refer to a valid A record.
TIMS-3254: No A record found for given owner name:{0} Please enter a valid A record name.
TIMS-3025: Resource Records already exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.105.30. Resource Record Delete

POST /object/rr/delete
Description

Deletes a Resource Record
Sample payloads with mandatory parameters to delete resource record are listed below.
{"owner":"tcp.QAZone1.com.","rrclass":"IN","rrtype":"A","ttl":1200,"data":"10.1.10.3","ipAddr":"10.1.10.3","is_ad_rr":0,"organization_name":"QAOrg"}

Parameters
Type Name Description Schema Default

Body

body
optional

Resource Record

Responses
HTTP Code Description Schema

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.105.31. Object Resource Record Update

POST /object/rr/edit
Description

Update Object, Root Zone and Proxy Root Zone resource record in TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/zone/rr/edit?existingOwner=k5.com.&existingData=10.1.0.4
Sample payloads parameters to edit Zone or Proxy Root Zone are listed below
{"owner":"k5.com.","rrclass":"IN","rrtype":"A","ttl":"1200","data":"6.0.0.0","extensions":[],"zoneName":".","organization_name":"Internal","is_external_rr":1}

Parameters
Type Name Description Schema Default

Body

body
optional

Resource Record

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.105.32. Get RR List

GET /object/rrlist
Description

Lists the RRs for the given object in the TCPWave IPAM. Functional Admin can list RR of a object in any organization. Rest of the Admins gets this provision for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/object/rrlist?address=10.1.10.36&orgName=Internal

Parameters
Type Name Description Schema Default

Query

address
required

Object Address

string

Query

draw
optional

Pagination Rendering Parameter

integer(int32)

Query

filterRules
optional

Filter String

string

Query

id
optional

Id of the object

integer(int32)

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

orgName
required

Name of the Organization in which zone exist

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListResource Record

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.105.33. Sync Objects

GET /object/sync
Description

Sync Object(s) into DNS.
The example listed below shows a sample request URL:
/rest/object/sync?objectIps=10.0.0.5&organization_name=Internal

Parameters
Type Name Description Schema Default

Query

objectIps
required

Object IP Addresses

string

Query

organization_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

boolean

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.105.34. Ping IP Address

GET /object/tools/ping
Description

Pings the specified IP address.
The example listed below shows a sample request URL:
/rest/object/tools/ping?ip=10.0.0.1

Parameters
Type Name Description Schema Default

Query

ip
required

IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

Ping Data

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.105.35. Ping IP Address

POST /object/tools/ping-multiple
Description

Pings the specified IP addresses.
The example listed below shows a sample request URL:
/rest/object/tools/ping-multiple
Below example shows sample request JSON:
["1.1.1.1", "2.2.2.2", "3.3.3.3"]

Parameters
Type Name Description Schema Default

Body

body
optional

< string > array

Responses
HTTP Code Description Schema

200

successful operation

< Ping Data > array

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.105.36. Trace Route Object

GET /object/tools/traceroute
Description

Traces the object and shows the route in between the IPAM and the object from the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/object/tools/traceroute?ip=10.0.0.2

Parameters
Type Name Description Schema Default

Query

ip
required

IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

Ping Data

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.105.37. Resource Record Traverse

POST /object/traverse
Description

Resource record look up in remote DNS Server.Performs the basic name resolution for a given resource record using the target DNS server on which the check is to be executed in the TCPWave IPAM.
Sample payloads with mandatory parameters to traverse object are listed below.
{"rr_name": "3G251Phone","domain_name": "addzone.com","organization_name": "Internal","rr_value": "10.0.0.5","rev_zone_name": "1.1.in-addr.arpa","obj_type": "IPv4","dnssec_enabled": false}

Parameters
Type Name Description Schema Default

Body

body
optional

DNS Appliance Tool

Responses
HTTP Code Description Schema

200

successful operation

< DNS Appliance Tool > array

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist:<Organization Name>, TIMS-1422: TIMS-1422: Zone does not exist:<Zone Name>

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.105.38. Validate VMWare Object

POST /object/validatevmwareobject
Description

Validates VMWare authentication details.
The example listed below shows a sample request URL:
/rest/object/validatevmwareobject?objectIP=10.0.0.2&domainName=domain.com&objectName=3G00014Phone
Sample payloads with mandatory parameters to validate VMWare are listed below
{"objectIPType": "V4","authType": "BASIC","host": "10.1.2.6","port": "4","userName": "root","password": "abc123","ignoreCerts": true}

Parameters
Type Name Description Schema Default

Query

domainName
required

Domain Name

string

Query

objectIP
required

Object IP Address

string

Query

objectName
required

Object Name

string

Body

body
required

VMWare Authentication Source

VMWareAuthenticationSource

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.106. Organization ImportExport Service

4.106.1. Export Organization Data

GET /orgbulkops/download
Description

Exports the organization data into a zip file.
The example listed below shows a sample request URL:
/rest/orgbulkops/download?fileName=filenamevalue

Parameters
Type Name Description Schema Default

Query

fileName
required

Zip file name

string

Responses
HTTP Code Description Schema

500

Organization data cannot be exported.

No Content

Produces
  • application/octet-stream

4.106.2. Export Organization Data

GET /orgbulkops/export
Description

Exports the organization data into a zip file.
The example listed below shows a sample request URL:
/rest/orgbulkops/export?name=Internal

Parameters
Type Name Description Schema Default

Query

name
required

Organization name

string

Responses
HTTP Code Description Schema

500

Organization data cannot be exported.

No Content

Produces
  • application/octet-stream

4.106.3. GET /orgbulkops/getProgressAllStatus

Description

TIMS-7003: You are not authorized to perform this operation.
The example listed below shows a sample request URL:
/rest/orgbulkops/getProgressAllStatus

Parameters
Type Name Description Schema Default

Query

operationCode
optional

Operation Code

string

Responses
HTTP Code Description Schema

200

successful operation

< string, Progress Status Information > map

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.106.4. Get the IPAM statistics

GET /orgbulkops/getProgressStatus
Description

The example listed below shows a sample request URL:
/rest/orgbulkops/getProgressStatus

Parameters
Type Name Description Schema Default

Query

operationCode
optional

Operation Code

string

Responses
HTTP Code Description Schema

200

successful operation

Progress Status Information

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.106.5. Import Organization Data

POST /orgbulkops/import
Description

Import data from zip file of formatted CSV files into the TCPWave IPAM.
Below example shows sample request JSON:
{ "input_file": "string", "output_file": "string", "error_file": "string", "max_permissible_errors": 0, "failed_entries_file": "string"}

Parameters
Type Name Description Schema Default

Body

body
optional

Import Command

Responses
HTTP Code Description Schema

200

successful operation

< Import Response Information > array

Consumes
  • application/json

Produces
  • application/json

  • application/xml

4.106.6. Export Organization Data

GET /orgbulkops/orgexport
Description

Exports the organization data into a zip file.
The example listed below shows a sample request URL:
/rest/orgbulkops/orgexport?name=Internal

Parameters
Type Name Description Schema Default

Query

name
required

Organization name

string

Responses
HTTP Code Description Schema

200

successful operation

Export Response Information

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.107. Organization Service

Description

This service class provides REST API access to Create, Modify and Delete an Organization in the TCPWave IPAM.

4.107.1. Organization Add

POST /organization/add
Description

Create a new Organization. Only Functional Admin has the privileges to create an organization. Rest of the admins will get permission error TIMS-7003.
Below example shows sample request JSON:
{"<strong>name</strong>":"QAOrg","description":"QAOrg organization","enable_root_zone": 1 }

Parameters
Type Name Description Schema Default

Body

body
optional

Organization

Responses
HTTP Code Description Schema

500

TIMS-1341: An Organization with the given name already exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.107.2. Organization Delete

POST /organization/delete
Description

Delete an existing Organization. Only Functional Admin has the privileges to delete an organization. Rest of the admins get permission violation error, TIMS-7003.
Below example shows sample request JSON:
{ "name":"QAOrg1" }

Parameters
Type Name Description Schema Default

Body

body
optional

Organization

Responses
HTTP Code Description Schema

500

TIMS-1346: Cannot find organization: <name>. TIMS-1347: Cannot delete Organization. Please delete dependent network elements within this organization and retry.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.107.3. Enable Root Zone

POST /organization/enablerootzone
Description

Enables Root zone for an Organization in the TCPWave IPAM.
Below example shows sample request JSON:
{"name":"terra","enable_root_zone":1,"description":"testing org delete","oldName":"terra"}

Parameters
Type Name Description Schema Default

Body

body
optional

< Organization > array

Responses
HTTP Code Description Schema

500

TIMS-1100: Both Organization Id and Organization Name cannot be null. TIMS-1101: Cannot find organization: <Organization Name>

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.107.4. Get Organization

GET /organization/get
Description

Provides an Organization details.
The example listed below shows a sample request URL:
/rest/organization/get?name=Internal

Parameters
Type Name Description Schema Default

Query

name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Organization

500

TIMS-1021: Organization name is not valid.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.107.5. Is Root Zone Enabled

GET /organization/isrootzoneenabled
Description

Check if root zone is enabled for user associated organization.
The example listed below shows a sample request URL:
/rest/organization/isrootzoneenabled

Responses
HTTP Code Description Schema

200

successful operation

integer(int32)

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.107.6. Organization List

GET /organization/list
Description

List All Organizations. Functional Admin gets the list of all organizations. Rest of the Admins get only one entry corresponding to the organization that they belong to.
The example listed below shows a sample request URL:
/rest/organization/list?orgName=Internal

Parameters
Type Name Description Schema Default

Query

orgName
optional

string

Responses
HTTP Code Description Schema

200

successful operation

< Organization > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.107.7. Root Zone Enabled List

GET /organization/rootzoneenabledlist
Description

List all root zone enabled organizations.
The example listed below shows a sample request URL:
/rest/organization/rootzoneenabledlist

Parameters
Type Name Description Schema Default

Query

orgName
optional

string

Responses
HTTP Code Description Schema

200

successful operation

< Organization > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.107.8. Search Organization

GET /organization/search
Description

Searches Organization from search screen.
The example listed below shows a sample request URL:
/rest/organization/search?page=1&rows=20

Parameters
Type Name Description Schema Default

Query

organizations
required

Organization List

string

Query

page
required

Page

integer(int32)

Query

rows
required

Rows

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListOrganization

500

TIMS-1020: Both Organization name and id cannot be null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.107.9. Organization Edit

POST /organization/update
Description

Edit an existing Organization. Only Functional Admin has the privileges update any organization. Super Admins and Power Admins will get permission error TIMS-7003 if they try to edit an organization that they are not part of.
Below example shows sample request JSON:
{"<strong>name</strong>":"QAOrganization","oldName":"QAOrganization","description":"TCPWave Organization","enable_root_zone": 1 }

Parameters
Type Name Description Schema Default

Body

body
optional

Organization

Responses
HTTP Code Description Schema

500

TIMS-1103: An organization with the given name already exists: <org name>

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.108. Params Service

Description

This service provides API's to create and update user defined DHCP Options in the TCPWave IPAM. It also provide API's create, update and delete DHCP Custom Folder in the TCPWave IPAM.

4.108.1. Create Custom Folder

POST /params/custom-folder-create
Description

Creates a DHCP custom folder in the TCPWave IPAM. Custom folders are used to group various user-defined DHCP options for better accessibility.
Below example shows sample request JSON:
{"group_name":"folder-1"}

Parameters
Type Name Description Schema Default

Body

body
required

DHCP custom folder details

Parameters Information

Responses
HTTP Code Description Schema

500

TIMS-5018: A Folder with this name already exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.108.2. Delete Custom Folder

POST /params/custom-folder-delete
Description

Deletes a DHCP custom folder defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/params/custom-folder-delete?folder_name=my-folder

Parameters
Type Name Description Schema Default

Query

folder_name
required

Name of Folder

string

Responses
HTTP Code Description Schema

500

TIMS-5038: This folder has some options defined in it. Please delete/move them and try again.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.108.3. Edit Custom Folder

POST /params/custom-folder-update
Description

Updates an existing user defined DHCP custom folder in the TCPWave IPAM.
Below example shows sample request JSON:
{"old_group_name":"folder-1","group_name":"my-folder"}

Parameters
Type Name Description Schema Default

Body

body
required

DHCP custom folder details

Parameters Information

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.108.4. User Defined DHCP Options Create

POST /params/dhcp-option-custom-create
Description

Creates user defined DHCP Options in the TCPWave IPAM. This feature allows the user to define a desired variant of an option from the specified range.
Below example shows sample request JSON:
{"entity_type_code":"OPTION","server_type_code":"DHCP","array_params":[{"display_name":"option78","data_type":"IP ADDRESS","group_name":"DHCPCustomGroup","name":"option 132"}] }

Parameters
Type Name Description Schema Default

Body

body
required

DHCP custom defined option details

Parameters Information

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.108.5. User Defined DHCP Options Delete

POST /params/dhcp-option-custom-delete
Description

Deletes the user defined options defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/params/dhcp-option-custom-delete?name=dhcpOptionName

Parameters
Type Name Description Schema Default

Query

groupName
optional

Group Name

string

Query

name
required

DHCP Option Name

string

Query

subOption
optional

DHCP sub option

boolean

Responses
HTTP Code Description Schema

500

TIMS-5036: Parameter cannot be deleted as it is being used in option template(s).

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.108.6. User Defined DHCP Options Edit

POST /params/dhcp-option-custom-update
Description

Updates an existing user defined DHCP Option in the TCPWave IPAM.
Below example shows sample request JSON:
{"data_type":"IP ADDRESS","display_name":"option78", "group_name":"DCGroup","name":"option 78"}

Parameters
Type Name Description Schema Default

Body

body
required

DHCP custom defined option details

Parameters Information

Responses
HTTP Code Description Schema

500

TIMS-5025: Parameter cannot be edited as it is being used in option template(s).

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.108.7. Custom Folders List

GET /params/groupsList
Description

Provides a list of DHCP Custom folders defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/params/groupsList

Responses
HTTP Code Description Schema

200

successful operation

< Parameters Information > array

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.108.8. Custom Folders Search List

GET /params/search
Description

Searches a list of DHCP Custom folders defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/params/search

Parameters
Type Name Description Schema Default

Query

page
optional

Page Number

integer(int32)

Query

rows
optional

Number of rows

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListParameters Information

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.108.9. IPV6 Param List

GET /params/v6ParamsList
Description

Lists all IPV6 Params.
The example listed below shows a sample request URL:
/rest/params/v6ParamsList

Responses
HTTP Code Description Schema

200

successful operation

< Parameters Information > array

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.109. Quick Move Service

4.109.1. Bulk Object Move

POST /qmove/bulkobject
Description

Moves Objects from one subnet to other subnet.
Below example shows sample request JSON:

Parameters
Type Name Description Schema Default

Body

body
required

Details required to move multiple objects from one subnet to another subnet.

< Quick Move > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.109.2. Bulk Object Move

POST /qmove/bulkobjectcheck
Description

Moves Objects from one subnet to other subnet.
Below example shows sample request JSON:
{"destinationSubnetAddress":"192.168.0.0","currentSubnetAddress":"10.0.0.0","organizationName":"Internal","currentObjectList":["10.0.0.6","10.0.0.7","10.0.0.8"],"destinationObjectList":[]}

Parameters
Type Name Description Schema Default

Body

body
required

Details required to check the possibility of moving multiple objects.

Quick Move

Responses
HTTP Code Description Schema

200

successful operation

< Quick Move > array

500

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.109.3. Object Move

POST /qmove/object
Description

Moves an Object from one IP Address to other IP Address.
Below example shows sample request JSON:
{"currentAddress":"10.0.3.4","destinationAddress":"10.0.3.5","organizationName":"Internal"}

Parameters
Type Name Description Schema Default

Body

body
required

Details needed to move an object to different IP Address/name/domain.

Quick Move

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.109.4. Object Move

POST /qmove/objectSchedChecks
Description

Moves an Object from one IP Address to other IP Address.
Below example shows sample request JSON:

Parameters
Type Name Description Schema Default

Body

body
required

Details needed to schedule an operation to move an object to different IP Address/name/domain.

< Quick Move > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.110. RPZ Service

Description

This class implements the REST service calls related to the Response Policy Zone (RPZ) management aspects of IPAM. The rest calls include the RPZ template and RPZ Policy File related calls.

4.110.1. Delete RPZ policy file

POST /rpz/policy/deletepolicyfile
Description

Delete the Response Zone Policy(RPZ) rules file in the TCPWave IPAM.
Below example shows sample request JSON:
{ "pfile":"tcp-policy" }

Parameters
Type Name Description Schema Default

Query

pfile
required

Policy File name

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.110.2. Empty policy rule table

POST /rpz/policy/emptypolicyrulestable
Description

Clear the temporary Response Policy Zone(RPZ) rules table.
The example listed below shows a sample request URL:
/rest/rpz/policy/emptypolicyrulestable

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.110.3. List the Response Policy Zone (RPZ) rules files. The example listed below shows a sample request URL: /rest/rpz/policy/fileslist

GET /rpz/policy/fileslist
Responses
HTTP Code Description Schema

200

successful operation

< Response Policy Zone(RPZ) Policy File > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.110.4. List the Response Policy Zone (RPZ) rules from the temporary table. The example listed below shows a sample request URL: /rest/rpz/policy/getpolicyfilerules?page=1&rows=2

GET /rpz/policy/getpolicyfilerules
Parameters
Type Name Description Schema Default

Query

page
required

Page number

integer(int32)

Query

rows
required

Rows per page

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListResponse Policy Zone(RPZ) Rule File

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.110.5. Load the Response Policy Zone(RPZ) policy rules from specified file into the temporary table. The example listed below shows a sample request URL: /rest/rpz/policy/loadpolicyfilerules?policyFile=testfile

POST /rpz/policy/loadpolicyfilerules
Parameters
Type Name Description Schema Default

Body

body
required

Rules in the policy file.

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.110.6. Import the Response Policy Zone (RPZ) policy rules file.

POST /rpz/policy/policyfileImport
Description

Import RPZ Policy file. For more information on managing RPZ Policy Files, please refer to the Administrator Reference document.
Below example shows sample request JSON:
"string"

Parameters
Type Name Description Schema Default

Body

body
required

Policy file details

string

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.110.7. Download the Response Policy Zone (RPZ) rules file.

GET /rpz/policy/policyfiledownload
Description

Retrieves the selected policy file.
The example listed below shows a sample request URL:
/rest/rpz/policy/policyfiledownload?pfile=testfile

Parameters
Type Name Description Schema Default

Query

pfile
required

Policy File name

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-8818: An error has occurred while retrieving the policy file.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.110.8. Validate the RPZ rules in the file.

GET /rpz/policy/policyfilevalidate
Description

Validates the selected policy file.
The example listed below shows a sample request URL:
/rest/rpz/policy/policyfilevalidate?pfile=testfile

Parameters
Type Name Description Schema Default

Query

pfile
required

Policy File name

string

Responses
HTTP Code Description Schema

200

successful operation

A generic response

500

TIMS-8813: An error has occurred while validating the policy file.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.110.9. Delete the Response Zone Policy(RPZ) rules file Below example shows sample request JSON: { "policy_trigger":"yahoo1.com", "policy_rr":"CNAME", "policy_rhvalue":"xen.tcpwave.com." }

POST /rpz/policy/policyruleDelete
Parameters
Type Name Description Schema Default

Body

body
required

RPZ policy rule details

Response Policy Zone(RPZ) Rule File

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.110.10. Reset the exclusive edit mode lock. The example listed below shows a sample request URL: /rest/rpz/policy/reseteditmode

POST /rpz/policy/reseteditmode
Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.110.11. POST /rpz/policy/updatePolicyRule

Description

Add or Update the Response Policy Zone (RPZ) policy rule in the temporary table in the TCPWave IPAM.
Below example shows sample request JSON:
{ "policy_trigger":"yahoo1.com", "policy_rr":"CNAME", "policy_rhvalue":"xen.tcpwave.com." }

Parameters
Type Name Description Schema Default

Body

body
required

RPZ policy rule details

Response Policy Zone(RPZ) Rule File

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.110.12. Update RPZ policy file

POST /rpz/policy/updatepolicyfile
Description

Update the Response Policy Zone(RPZ) policy file with the contents of the temporary rules table in the TCPWave IPAM.
Below example shows sample request JSON:
{ "policy_file":"rpz-file-1" }

Parameters
Type Name Description Schema Default

Body

body
required

RPZ policy file details

Response Policy Zone(RPZ) Policy File

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.110.13. Add DNS Response Zone Policy(RPZ) Template

POST /rpz/template/add
Description

Add the current DNS Response Zone Policy(RPZ) template in the TCPWave IPAM. Refer Administrator Reference document to know more information about managing DNS RPZ.
Below example shows sample request JSON:
{ "name":"rpz-1", "description":"test", "policy_file":"rpz-file-1", "zone_name":"tcp.in", "organization_name":"QAOrg", "server_ip":"", "server_keyname":"", "server_keyvalue":"", "isZoneTransfer":false }
Below example shows create RPZ template when external feed is selelcted:
{ "name":"rpz-2", "description":"test", "getExt_feed_provider":"spamhaus", "zone_name":"tcp.in,test.com", "organization_name":"QAOrg", "server_ip":"1.2.3.4,5.6.7.8", "server_keyname":"", "server_keyvalue":"", "isZoneTransfer":false }

Parameters
Type Name Description Schema Default

Body

body
required

RPZ policy template details

RPZTemplate

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.110.14. List DNS Remote Association with RPZ Template

GET /rpz/template/assoc/list
Description

Retrieve the list of DNS Remote instances associated with the current DNS Response Zone Policy(RPZ) template in the TCPWave IPAM. Refer Administrator Reference document to know more information about DNS RPZ.
The example listed below shows a sample request URL:
/rpz/template/assoc/list?template_name=rpz-1&address=1.0.0.3&org_name=Internal

Parameters
Type Name Description Schema Default

Query

address
required

server address

string

Query

org_name
required

organization name

string

Query

template_name
required

template name

string

Responses
HTTP Code Description Schema

200

successful operation

< Response Policy Zone(RPZ) Template association information with DNS Server > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.110.15. Update DNS Remote Instances Associated with Template

POST /rpz/template/assoc/update
Description

Update the list of DNS Remote instances associated with the current DNS Response Policy Zone(RPZ) template in the TCPWave IPAM. Refer Administrator Reference document to know more information about DNS RPZ.
The example listed below shows a sample request URL:
/rpz/template/assoc/update?template_name=rpz-1&address=1.0.0.3

Parameters
Type Name Description Schema Default

Query

address
required

server address

string

Query

template_name
required

template name

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.110.16. Delete DNS Response Zone Policy(RPZ) Template

POST /rpz/template/delete
Description

Delete the current DNS Response Zone Policy(RPZ) template in the TCPWave IPAM. Refer Administrator Reference document to know more information about managing DNS RPZ.
The example listed below shows a sample request URL:
/rpz/template/delete?name=rpz-1

Parameters
Type Name Description Schema Default

Query

name
required

template name

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.110.17. Get DNS Response Policy Zone(RPZ) Template

GET /rpz/template/get
Description

Retrieve the detailed information of the current DNS Response Zone Policy RPZ) template defined in the TCPWave IPAM. Refer Administrator Reference document to know more information about DNS RPZ.
The example listed below shows a sample request URL:
/rpz/template/get?name=rpz-1

Parameters
Type Name Description Schema Default

Query

name
required

template name

string

Responses
HTTP Code Description Schema

200

successful operation

RPZTemplate

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.110.18. List DNS Response Zone Policy(RPZ) templates

GET /rpz/template/list
Description

Retrieve the detailed list of DNS Response Zone Policy(RPZ) templates defined in the TCPWave IPAM. Refer Administrator Reference document to know more information about DNS RPZ.
The example listed below shows a sample request URL:
/rest/rpz/template/list?org_name=Internal

Parameters
Type Name Description Schema Default

Query

org_name
required

organization name

string

Responses
HTTP Code Description Schema

200

successful operation

< RPZTemplate > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.110.19. List Master Server IPS for TCPWave Secondaries

GET /rpz/template/listassociatedappliances
Description

Retrieve the masters list for tcpwave secondaries defined in the TCPWave IPAM. Refer Administrator Reference document to know more information about DNS RPZ.
The example listed below shows a sample request URL:
/rest/rpz/template/listassociatedappliances

Parameters
Type Name Description Schema Default

Query

name
required

template name

string

Responses
HTTP Code Description Schema

200

successful operation

< Server Information > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.110.20. List Master Server IPS for TCPWave Secondaries

GET /rpz/template/listmasterservers
Description

Retrieve the masters list for tcpwave secondaries defined in the TCPWave IPAM. Refer Administrator Reference document to know more information about DNS RPZ.
The example listed below shows a sample request URL:
/rest/rpz/template/listmasterservers

Responses
HTTP Code Description Schema

200

successful operation

< string > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.110.21. Edit DNS Response Zone Policy(RPZ) Template

POST /rpz/template/modify
Description

Update the current DNS Response Zone Policy(RPZ) template in the TCPWave IPAM. Refer Administrator Reference document to know more information about managing DNS RPZ.
Below example shows sample request JSON:
{ "new_name":"rpz-1", "description":"qa testing", "zone_name":"tcp.in.co", "policy_file":"rpz-file-1", "organization_name":"QAOrg", "server_ip":"", "server_keyname":"", "server_keyvalue":"", "isZoneTransfer":false, "name":"rpz-1" }
Below example shows update RPZ template when external feed is selelcted:
{ "name":"rpz-2", "description":"test", "getExt_feed_provider":"spamhaus", "zone_name":"tcp.in,test.com", "organization_name":"QAOrg", "server_ip":"1.2.3.4,5.6.7.8", "server_keyname":"", "server_keyvalue":"", "isZoneTransfer":false }

Parameters
Type Name Description Schema Default

Body

body
required

RPZ template details

RPZTemplate

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.111. Reverse Zone Service

Description

This service provides API's to get list of Reverse Zones present in the TCPWave IPAM and add, update, delete Reverse Zones in the TCPWave IPAM.

4.111.1. Reverse Zone Add

POST /ipv6revzone/add
Description

Creates a new Reverse Zone by checking if it overlaps with the existing zones defined in the TCPWave IPAM. Functional Admin can create a new Zone for any organization. Rest of the admins can create a new Zone only for the organization that they are associated with. Refer to the Administrator reference documentation for additional information about the Zones.
Below example shows sample request JSON:
{ "name":"10.in-addr.arpa", "networkAddress":"10.0.0.0", "networkMask":"24", ", "description":"Testing REST API", "dmzVisible":"no", "dnssec_enable":"no", "organization_name":"QAOrg", "serial_format":"DATE", "template_name":"QA Standard Template", "zoneRR":[] }Create Zone with Non Managed Name Servers
{ "name":"zone.com","template_name":"z_t","organization_name":"QAOrg","nonmanagedNS":[{"ns_fqdn":"nameserver.domain.com","ns_ip":"10.1.10.12"},{"ns_fqdn":"nameserver1.domain.com","ns_ip":"31.1.1.12"}],"is_tsig":1}

Parameters
Type Name Description Schema Default

Body

body
required

Zone details

Zone

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation
TIMS-1352: Cannot find organization:{0}
TIMS-5031: Both template name and id cannot be null
TIMS-5020: Template does not exist: {0}
TIMS-5039: Template does not exist for organization
TIMS-1356: Zone already exists: {0}
TIMS-3209: Zone {0} is already delegated in the root zone(organization:{1}). Cannot add it as a managed zone in the TCPWave IPAM
TIMS-1430: Cannot create a zone: {0} as there is a forward only zone already exists with this name
TIMS-1349: DNS Configuration sync failed with error: {0}
TIMS-3025: Resource Records already exist.

No Content

Consumes
  • application/json

  • application/xml

4.111.2. Child Reverse Zones Add

POST /ipv6revzone/addChildZones
Description

Creates new child Reverse Zones using the specified parent details by checking if it overlaps with the existing zones defined in the TCPWave IPAM. Functional Admin can create a new Zone for any organization. Rest of the admins can create a new Zone only for the organization that they are associated with. Refer to the Administrator reference documentation for additional information about the Zones.
Below example shows sample request JSON:
{ "name":"10.in-addr.arpa", "networkAddress":"10.0.0.0", "networkMask":"8", ", "description":"Testing REST API", "dmzVisible":"no", "dnssec_enable":"no", "organization_name":"QAOrg", "serial_format":"DATE", "template_name":"QA Standard Template", "zoneRR":[] }"childRevZones":[{"name":"1.10.in-addr.arpa", "networkAddress":"10.1.0.0", "networkMask":"16"},{"name":"2.10.in-addr.arpa", "networkAddress":"10.2.0.0", "networkMask":"16"}]

Parameters
Type Name Description Schema Default

Body

body
required

Zone details

Zone

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation
TIMS-1352: Cannot find organization:{0}
TIMS-5031: Both template name and id cannot be null
TIMS-5020: Template does not exist: {0}
TIMS-5039: Template does not exist for organization
TIMS-1356: Zone already exists: {0}
TIMS-3209: Zone {0} is already delegated in the root zone(organization:{1}). Cannot add it as a managed zone in the TCPWave IPAM
TIMS-1430: Cannot create a zone: {0} as there is a forward only zone already exists with this name
TIMS-1349: DNS Configuration sync failed with error: {0}

No Content

Consumes
  • application/json

  • application/xml

4.111.3. IPv6 Reverse Zone Force Sync

GET /ipv6revzone/forcesynczones
Description

Synchronizes the IPv6 DNS reverse zone data for a given zone or a subset of zones by fetching all the resource records specified from the TCPWave data repository. The DNS zone files are constructed as per the TCPWave Product Engineering’s specifications with various integrity checks embedded into them. The files are then compressed and transmitted to the remote using an encrypted T-Message secure tunnel. The compressed files are uncompressed on the remote and the DNS process on the remote is signaled to read the updated contents. The administrator performing this action is required to have a sync permission. This action is audited.
The example listed below shows a sample request URL:
/rest/revzone/forcesynczones?zoneOrgNames=Internal

Parameters
Type Name Description Schema Default

Query

zoneOrgNames
required

Reverse Zone Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Zone Force Sync > array

500

TIMS-1020: Both Organization name and id cannot be null
TIMS-1352: Organization does not exist:{0}
TIMS-1422: Zone does not exist:{0}

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.111.4. Get RR List

GET /ipv6revzone/get
Description

Lists the RRs for the given Reverse Zone in the TCPWave IPAM. Functional Admin can list RR of a Reverse Zone in any organization. Rest of the Admins gets this provision for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/revzone/get?revZoneName=10.in-addr.arpa&orgName=Internal

Parameters
Type Name Description Schema Default

Query

orgName
required

Name of the Organization in which zone exist

string

Query

revZoneId
optional

Id of the reverse zone

integer(int32)

Query

revZoneName
required

Name of the reverse zone

string

Responses
HTTP Code Description Schema

200

successful operation

< Resource Record > array

500

TIMS-1352: Cannot find organization: {0}
TIMS-1403: Zone id cannot be null

No Content

Consumes
  • text/plain

Produces
  • application/json

4.111.5. Get Network Full Address and Mask For a Subnet

GET /ipv6revzone/getNetworkMask
Description

Gets the network full address and mask (With delimiter <NetworkFulladdress>-@-<networkMask>) for a given subnet in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/revzone/getNetworkMask?orgId=1745&orgName=Internal

Parameters
Type Name Description Schema Default

Query

address
optional

Subnet Address

string

Query

orgId
required

Id of the Organization in which subnet exist

integer(int32)

Query

orgName
required

Name of the Organization in which subnet exist

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1352: Cannot find organization: {0}

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.111.6. Reverse Zone Get

POST /ipv6revzone/getRevZone
Description

Gets the reverse zone information associated with an organization in the TCPWave IPAM.
Below example shows sample request JSON:
{ "name":"10.in-addr.arpa", "organization_name":"QAOrg" }

Parameters
Type Name Description Schema Default

Body

body
optional

Zone

Responses
HTTP Code Description Schema

200

successful operation

Zone

500

TIMS-1020: Both Organization name and id cannot be null
TIMS-1352: Organization does not exist: {0},
TIMS-1422: Zone does not exist: {0}

No Content

Consumes
  • application/json

  • application/xml

4.111.7. Reverse Zone Delete Multiple

POST /ipv6revzone/multidelete
Description

Deletes Multiple Reverse Zones in the TCPWave IPAM. Functional Admin can Delete Multiple Reverse Zones for any organization. Rest of the admins can Delete Multiple Reverse Zones only for the organization that they are associated with.
Below example shows sample request JSON:
{ "name":"10.in-addr.arpa","organization_name":"Internal"}

Parameters
Type Name Description Schema Default

Body

body
optional

< Zone > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation
TIMS-1352: Cannot find organization: {0}
TIMS-1406: Reverse Zone(s) does(do) not exist.

No Content

Consumes
  • application/json

  • application/xml

4.111.8. Reverse Zone List

GET /ipv6revzone/page
Description

Provides a paginated list of Reverse Zones Defined in the TCPWave IPAM. Functional Admin gets the list of all zones. Rest of the Admins get only the list of zones associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/revzone/page?start=1&length=20

Parameters
Type Name Description Schema Default

Query

customFilterRules
optional

Custom Filter String

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Size

integer(int32)

Query

order
optional

Sorting Order(asc/desc)

string

Query

organizations
optional

Organization List

string

Query

sort
optional

Sorting String

string

Query

start
required

Starting Zone Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListZone

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.111.9. Reverse Zone Resource Record Add

POST /ipv6revzone/rr/add
Description

Adds a new Resource Record in the revzone to the TCPWave IPAM).
Below example shows sample request JSON:
{ "name":"www", "rrclass": "IN", "rrtype": "PTR", "ttl": 1200, "data": "10.1.10.5", "description": "Reverse zone RR", "ipAddr": "10.1.10.0", "domain": "test.com", "organization_name": "QAOrg", "networkAddress": "10.1.10.0","mask": "24" }

Parameters
Type Name Description Schema Default

Body

body
optional

Resource Record

Responses
HTTP Code Description Schema

500

TIMS-1023: Host does not exist, Please provide a correct host name or IP address.
TIMS-14093: Reverse zone does not exits: <Name> with the given mask.
TIMS-1354: Organization does not exist.
TIMS-1321: Domain does not exist: <Domain name>
TIMS-3206: Resource record with type:<Type>, owner:<Owner> and data:<Data> already exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.111.10. Delete Resource Records

POST /ipv6revzone/rr/delete
Description

Deletes the Resource Record of Reverse zone in the TCPWave IPAM.
Below example shows sample request JSON:
{"owner":"ftp.tcpwave.com.","rrclass":"IN","rrtype":"PTR","ttl":1200,"data":"10.1.0.1","organization_name":"Internal",networkAddress":"10.1.0.0","mask":"24"}

Parameters
Type Name Description Schema Default

Body

body
optional

Resource Record

Responses
HTTP Code Description Schema

500

TIMS-14093: Reverse zone does not exits: <Name> with the given mask.
TIMS-1354: Organization does not exist.
TIMS-1321: Domain does not exist: <Domain name>
TIMS-3206: Resource record with type:<Type>, owner:<Owner> and data:<Data> already exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.111.11. Reverse Zone Resource Record Update

POST /ipv6revzone/rr/edit
Description

Updates a Resource Record of Reverse zone in the TCPWave IPAM.
Below example shows sample request JSON:
{"owner":"www.test.com","rrclass":"IN","rrtype":"PTR","ttl":5000,"description":"Updated TTL and Host name","domain":inter.com,"organization_name":"Internal","networkAddress":"10.1.0.0","mask":"28"}

Parameters
Type Name Description Schema Default

Query

existingData
required

Data of the resource record to be updated

string

Query

existingOwner
required

Owner of the resource record to be updated

string

Body

body
optional

Resource Record

Responses
HTTP Code Description Schema

500

TIMS-7002: Permission information cannot be retrieved
TIMS-9561: Existing owner of the resource record cannot be null
TIMS-9564: Existing data of the resource record cannot be null
TIMS-1352: Cannot find organization: <Organization Name>
TIMS-7003: You are not authorized to perform this operation
TIMS-3101: Network does not exist: <IP Address>
TIMS-3015: Resource record does not exist
TIMS-1321: Domain does not exist: <Domain Name>

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.111.12. Reverse Zone Search

GET /ipv6revzone/search
Description

Provides the list of reverse zones for a given search string in the TCPWave IPAM. Functional Admin can see the list of reverse zones for all organizations. Rest of the Admins can see only the list of reverse zones associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/revzone/search?page=1&rows=20

Parameters
Type Name Description Schema Default

Query

page
required

Page Number

integer(int32)

Query

rows
required

Number of rows

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListZone

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.111.13. Reverse Zone Edit

POST /ipv6revzone/update
Description

Updates an existing Reverse Zone in the TCPWave IPAM. Functional Admin can update a Zone for any organization. Rest of the admins can update a Zone only for the organizations that they are associated with.
Below example shows sample request JSON:
{ "addedRRs": [{"data":"test.demo.com.", "owner":"10.0.0.10.in-addr.arpa.", "rrclass":"IN", "rrtype":"PTR","status":1, "ttl":1200 }] , "deletedRRS":[],"description":"Testing REST API Updates","dmzVisible":0, "dnssec_enable":"no","monitoringService":"yes","name":"10.in-addr.arpa", "networkAddress":"10.0.0.11", "networkMask":"24", "serial_format":"DATE", "template_name":"qa-zone-template","organization_name":"QAOrg" }

Parameters
Type Name Description Schema Default

Body

body
optional

Zone

Responses
HTTP Code Description Schema

500

TIMS-1352: Cannot find organization: {0}
TIMS-7003: You are not authorized to perform this operation
TIMS-1415: Zone or Domain already exists:{0}
TIMS-1430: Cannot create a zone: {0} as there is a forward only zone already exists with this name
TIMS-1422: Zone does not exist: {0}
TIMS-5020: Template does not exist: {0}
TIMS-1349: DNS Configuration sync failed with error:{0}
TIMS-5039: Template does not exist for organization
TIMS-3025: Resource Records already exist

No Content

Consumes
  • application/json

  • application/xml

4.111.14. Reverse Zone Add

POST /revzone/add
Description

Creates a new Reverse Zone by checking if it overlaps with the existing zones defined in the TCPWave IPAM. Functional Admin can create a new Zone for any organization. Rest of the admins can create a new Zone only for the organization that they are associated with. Refer to the Administrator reference documentation for additional information about the Zones.
Below example shows sample request JSON:
{ "name":"10.in-addr.arpa", "networkAddress":"10.0.0.0", "networkMask":"24", ", "description":"Testing REST API", "dmzVisible":"no", "dnssec_enable":"no", "organization_name":"QAOrg", "serial_format":"DATE", "template_name":"QA Standard Template"}Create Zone with Non Managed Name Servers
{ "name":"zone.com","template_name":"z_t","organization_name":"QAOrg","nonmanagedNS":[{"ns_fqdn":"nameserver.domain.com","ns_ip":"10.1.10.12"},{"ns_fqdn":"nameserver1.domain.com","ns_ip":"31.1.1.12"}],"is_tsig":1}

Parameters
Type Name Description Schema Default

Body

body
required

Zone details

Zone

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation
TIMS-1352: Cannot find organization:{0}
TIMS-5031: Both template name and id cannot be null
TIMS-5020: Template does not exist: {0}
TIMS-5039: Template does not exist for organization
TIMS-1356: Zone already exists: {0}
TIMS-3209: Zone {0} is already delegated in the root zone(organization:{1}). Cannot add it as a managed zone in the TCPWave IPAM
TIMS-1430: Cannot create a zone: {0} as there is a forward only zone already exists with this name
TIMS-1349: DNS Configuration sync failed with error: {0}
TIMS-3025: Resource Records already exist.

No Content

Consumes
  • application/json

  • application/xml

4.111.15. Child Reverse Zones Add

POST /revzone/addChildZones
Description

Creates new child Reverse Zones using the specified parent details by checking if it overlaps with the existing zones defined in the TCPWave IPAM. Functional Admin can create a new Zone for any organization. Rest of the admins can create a new Zone only for the organization that they are associated with. Refer to the Administrator reference documentation for additional information about the Zones.
Below example shows sample request JSON:
{ "name":"10.in-addr.arpa", "networkAddress":"10.0.0.0", "networkMask":"8", ", "description":"Testing REST API", "dmzVisible":"no", "dnssec_enable":"no", "organization_name":"QAOrg", "serial_format":"DATE", "template_name":"QA Standard Template", "zoneRR":[] }"childRevZones":[{"name":"1.10.in-addr.arpa", "networkAddress":"10.1.0.0", "networkMask":"16"},{"name":"2.10.in-addr.arpa", "networkAddress":"10.2.0.0", "networkMask":"16"}]

Parameters
Type Name Description Schema Default

Body

body
required

Zone details

Zone

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation
TIMS-1352: Cannot find organization:{0}
TIMS-5031: Both template name and id cannot be null
TIMS-5020: Template does not exist: {0}
TIMS-5039: Template does not exist for organization
TIMS-1356: Zone already exists: {0}
TIMS-3209: Zone {0} is already delegated in the root zone(organization:{1}). Cannot add it as a managed zone in the TCPWave IPAM
TIMS-1430: Cannot create a zone: {0} as there is a forward only zone already exists with this name
TIMS-1349: DNS Configuration sync failed with error: {0}

No Content

Consumes
  • application/json

  • application/xml

4.111.16. Reverse Zone Force Sync

GET /revzone/forcesynczones
Description

Synchronizes the DNS reverse zone data for a given zone or a subset of zones by fetching all the resource records specified from the TCPWave data repository. The DNS zone files are constructed as per the TCPWave Product Engineering’s specifications with various integrity checks embedded into them. The files are then compressed and transmitted to the remote using an encrypted T-Message secure tunnel. The compressed files are uncompressed on the remote and the DNS process on the remote is signaled to read the updated contents. The administrator performing this action is required to have a sync permission. This action is audited.
The example listed below shows a sample request URL:
/rest/revzone/forcesynczones?zoneOrgNames=Internal

Parameters
Type Name Description Schema Default

Query

zoneOrgNames
required

Reverse Zone Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Zone Force Sync > array

500

TIMS-1020: Both Organization name and id cannot be null
TIMS-1352: Organization does not exist:{0}
TIMS-1422: Zone does not exist:{0}

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.111.17. Get RR List

GET /revzone/get
Description

Lists the RRs for the given Reverse Zone in the TCPWave IPAM. Functional Admin can list RR of a Reverse Zone in any organization. Rest of the Admins gets this provision for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/revzone/get?revZoneName=10.in-addr.arpa&orgName=Internal

Parameters
Type Name Description Schema Default

Query

orgName
required

Name of the Organization in which zone exist

string

Query

revZoneId
optional

Id of the reverse zone

integer(int32)

Query

revZoneName
required

Name of the reverse zone

string

Responses
HTTP Code Description Schema

200

successful operation

< Resource Record > array

500

TIMS-1352: Cannot find organization: {0}
TIMS-1403: Zone id cannot be null

No Content

Consumes
  • text/plain

Produces
  • application/json

4.111.18. Get Network Full Address and Mask For a Subnet

GET /revzone/getNetworkMask
Description

Gets the network full address and mask (With delimiter <NetworkFulladdress>-@-<networkMask>) for a given subnet in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/revzone/getNetworkMask?orgId=1745&orgName=Internal

Parameters
Type Name Description Schema Default

Query

address
optional

Subnet Address

string

Query

orgId
required

Id of the Organization in which subnet exist

integer(int32)

Query

orgName
required

Name of the Organization in which subnet exist

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1352: Cannot find organization: {0}

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.111.19. Reverse Zone Get

POST /revzone/getRevZone
Description

Gets the reverse zone information associated with an organization in the TCPWave IPAM.
Below example shows sample request JSON:
{ "name":"10.in-addr.arpa", "organization_name":"QAOrg" }

Parameters
Type Name Description Schema Default

Body

body
optional

Zone

Responses
HTTP Code Description Schema

200

successful operation

Zone

500

TIMS-1020: Both Organization name and id cannot be null
TIMS-1352: Organization does not exist: {0},
TIMS-1422: Zone does not exist: {0}

No Content

Consumes
  • application/json

  • application/xml

4.111.20. Reverse Zone Delete Multiple

POST /revzone/multidelete
Description

Deletes Multiple Reverse Zones in the TCPWave IPAM. Functional Admin can Delete Multiple Reverse Zones for any organization. Rest of the admins can Delete Multiple Reverse Zones only for the organization that they are associated with.
Below example shows sample request JSON:
{ "name":"10.in-addr.arpa","organization_name":"Internal"}

Parameters
Type Name Description Schema Default

Body

body
optional

< Zone > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation
TIMS-1352: Cannot find organization: {0}
TIMS-1406: Reverse Zone(s) does(do) not exist.

No Content

Consumes
  • application/json

  • application/xml

4.111.21. Reverse Zone List

GET /revzone/page
Description

Provides a paginated list of Reverse Zones Defined in the TCPWave IPAM. Functional Admin gets the list of all zones. Rest of the Admins get only the list of zones associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/revzone/page?start=1&length=20

Parameters
Type Name Description Schema Default

Query

customFilterRules
optional

Custom Filter String

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Size

integer(int32)

Query

order
optional

Sorting Order(asc/desc)

string

Query

organizations
optional

Organization List

string

Query

sort
optional

Sorting String

string

Query

start
required

Starting Zone Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListZone

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.111.22. Reverse Zone Resource Record Add

POST /revzone/rr/add
Description

Adds a new Resource Record in the revzone to the TCPWave IPAM).
Below example shows sample request JSON:
{ "name":"www", "rrclass": "IN", "rrtype": "PTR", "ttl": 1200, "data": "10.1.10.5", "description": "Reverse zone RR", "ipAddr": "10.1.10.0", "domain": "qa.com", "organization_name": "QAOrg", "networkAddress": "10.1.10.0","mask": "24" }

Parameters
Type Name Description Schema Default

Body

body
optional

Resource Record

Responses
HTTP Code Description Schema

500

TIMS-1023: Host does not exist, Please provide a correct hostname or IP address.
TIMS-14093: Reverse zone does not exits: <Name> with the given mask.
TIMS-1354: Organization does not exist.
TIMS-1321: Domain does not exist: <Domain name>
TIMS-3206: Resource record with type:<Type>, owner:<Owner> and data:<Data> already exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.111.23. Delete Resource Records

POST /revzone/rr/delete
Description

Deletes the Resource Record of Reverse zone in the TCPWave IPAM.
Below example shows sample request JSON:
{"owner":"ftp.tcpwave.com.","rrclass":"IN","rrtype":"PTR","ttl":1200,"data":"10.1.0.1","organization_name":"Internal",networkAddress":"10.1.0.0","mask":"24"}

Parameters
Type Name Description Schema Default

Body

body
optional

Resource Record

Responses
HTTP Code Description Schema

500

TIMS-14093: Reverse zone does not exits: <Name> with the given mask.
TIMS-1354: Organization does not exist.
TIMS-1321: Domain does not exist: <Domain name>
TIMS-3206: Resource record with type:<Type>, owner:<Owner> and data:<Data> already exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.111.24. Reverse Zone Resource Record Update

POST /revzone/rr/edit
Description

Updates a Resource Record of Reverse zone in the TCPWave IPAM.
Below example shows sample request JSON:
{"owner":"www.test.com","rrclass":"IN","rrtype":"PTR","ttl":5000,"description":"Updated TTL and Host name","domain":inter.com,"organization_name":"Internal","networkAddress":"10.1.0.0","mask":"28"}

Parameters
Type Name Description Schema Default

Query

existingData
required

Data of the resource record to be updated

string

Query

existingOwner
required

Owner of the resource record to be updated

string

Query

existingType
required

Type of the resource record to be updated

string

Body

body
optional

Resource Record

Responses
HTTP Code Description Schema

500

TIMS-7002: Permission information cannot be retrieved
TIMS-9561: Existing owner of the resource record cannot be null
TIMS-9564: Existing data of the resource record cannot be null
TIMS-1352: Cannot find organization: <Organization Name>
TIMS-7003: You are not authorized to perform this operation
TIMS-3101: Network does not exist: <IP Address>
TIMS-3015: Resource record does not exist
TIMS-1321: Domain does not exist: <Domain Name>

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.111.25. Get RR List

GET /revzone/rrlist
Description

Lists the RRs for the given Reverse Zone in the TCPWave IPAM. Functional Admin can list RR of a Reverse Zone in any organization. Rest of the Admins gets this provision for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/revzone/get?revZoneName=10.in-addr.arpa&orgName=Internal

Parameters
Type Name Description Schema Default

Query

draw
optional

Pagination Rendering Parameter

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

orgName
required

Name of the Organization in which zone exist

string

Query

revZoneId
optional

Id of the reverse zone

integer(int32)

Query

revZoneName
required

Name of the reverse zone

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListResource Record

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.111.26. Reverse Zone Search

GET /revzone/search
Description

Provides the list of reverse zones for a given search string in the TCPWave IPAM. Functional Admin can see the list of reverse zones for all organizations. Rest of the Admins can see only the list of reverse zones associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/revzone/search?page=1&rows=20

Parameters
Type Name Description Schema Default

Query

page
required

Page Number

integer(int32)

Query

rows
required

Number of rows

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListZone

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.111.27. Reverse Zone Edit

POST /revzone/update
Description

Updates an existing Reverse Zone in the TCPWave IPAM. Functional Admin can update a Zone for any organization. Rest of the admins can update a Zone only for the organizations that they are associated with.
Below example shows sample request JSON:
{ "description":"Testing REST API Updates","dmzVisible":0, "dnssec_enable":"no","monitoringService":"yes","name":"10.in-addr.arpa", "networkAddress":"10.0.0.11", "networkMask":"24", "serial_format":"DATE", "template_name":"qa-zone-template","organization_name":"QAOrg" }

Parameters
Type Name Description Schema Default

Body

body
optional

Zone

Responses
HTTP Code Description Schema

500

TIMS-1352: Cannot find organization: {0}
TIMS-7003: You are not authorized to perform this operation
TIMS-1415: Zone or Domain already exists:{0}
TIMS-1430: Cannot create a zone: {0} as there is a forward only zone already exists with this name
TIMS-1422: Zone does not exist: {0}
TIMS-5020: Template does not exist: {0}
TIMS-1349: DNS Configuration sync failed with error:{0}
TIMS-5039: Template does not exist for organization
TIMS-3025: Resource Records already exist

No Content

Consumes
  • application/json

  • application/xml

4.112. Role Service

Description

This class provides services related to admin such as create, Delete, Modify etc in the TCPWave IPAM.

4.112.1. Admin Role List

GET /role/list
Description

List all the admin roles. Lists all the possible Admin Roles in the system.
The example listed below shows a sample request URL:
/rest/role/list

Responses
HTTP Code Description Schema

200

successful operation

< Admin Role > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.113. Root Access Management Service

Description

This service class provides services related to supported Vault types in the TCPWave IPAM such as CyberArk, Hashicorp and Native. It provides an api to get/configure/list the Vault types in the TCPWave IPAM.

4.113.1. Configure root access authentication on appliances

POST /rootaccessmgmt/configure
Description

All remote appliances and IPAM and DR appliances will be set up and configured according to the vault type selected by the user.
Below example shows sample request JSON:
{ "vaultType": "Native", "vaultServerHost": "10.1.2.3", "vaultServerPort": 8200, "useSSL": true, "vaultServerCertPath": "/tmp/cert.crt"}

Parameters
Type Name Description Schema Default

Body

body
required

Root Access Management Details

Root Access Management Details

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.113.2. Get Vault preferences

GET /rootaccessmgmt/get
Description

Gets vault preferences for root access management.
The example listed below shows a sample request URL:
/rest/rootaccessmgmt/get

Responses
HTTP Code Description Schema

200

successful operation

Root Access Management Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.113.3. Supported Vault Types

GET /rootaccessmgmt/list_vault_types
Description

Lists the supported vault types for root access management.
The example listed below shows a sample request URL:
/rest/rootaccessmgmt/list_vault_types

Responses
HTTP Code Description Schema

200

successful operation

< Vault Type > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.114. Router Subnet Service

4.114.1. Add Discovery Agent Subnet Elements

POST /router_subnet/da_subnet/element/multiadd
Description

Creates one or more discovery agent subnet elements in TCPWave IPAM.
Below example shows sample request JSON:
[{"subnetIp":"1.0.0.2","commandId":"TDCE_20220422124","name":"SubnetElement1", "ip_address":"10.0.0.0", "subnetMaskLength":8}]

Parameters
Type Name Description Schema Default

Body

body
required

Discovery Agent Subnet Elements List

< Subnet Elements > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.114.2. Add Discovered Subnets

POST /router_subnet/da_subnet/multiadd
Description

Creates one or more discovered subnets in TCPWave IPAM.
Below example shows sample request JSON:
[{"subnetIp":"1.0.0.2","commandId":"TDCE_20220422124","name":"SubnetElement1", "ip_address":"10.0.0.0", "subnetMaskLength":8}]

Parameters
Type Name Description Schema Default

Body

body
required

Discovered subnets List

< Subnet > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.114.3. Element Details

GET /router_subnet/elementpage
Description

Lists all the elements discovered for the selected router in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/router_subnet/elementpage?start=1&length=20&router_ip=20.0.0.3&cmdId=TDCE_20220422123

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command Id

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

router_ip
required

Router IPAddress

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Router Element Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListRouter Element Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.114.4. Discovered Subnet elements List

GET /router_subnet/getda_subnetelements
Description

Fetches the list of discovered subnet elements list.
The example listed below shows a sample request URL:
/rest/router_subnet/getsubnet_elements?device_ip=10.0.0.3&address=10.1.10.1&mask=24&cmdId=TDCE_20220422123

Parameters
Type Name Description Schema Default

Query

address
required

Subnet IPAddress

string

Query

cmdId
required

Command ID

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Router Element Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListSubnet Elements

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.114.5. Discovered Subnet elements List

GET /router_subnet/getsubnet_elements
Description

Fetches the list of discovered subnet elements list.
The example listed below shows a sample request URL:
/rest/router_subnet/getsubnet_elements?device_ip=10.0.0.3&subnet_ip=10.1.10.1&mask=24&cmdId=TDCE_20220422231

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command ID

string

Query

device_ip
required

Router IPAddress

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

mask
required

Subnet Mask

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Router Element Range

integer(int32)

Query

subnet_ip
required

Subnet IPAddress

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListRouterSubnetElement

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.114.6. Subnet Details

GET /router_subnet/getsubnets
Description

Lists all the subnets discovered for the selected router in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/router_subnet/getsubnets?start=1&length=20&router_ip=20.0.0.3&cmdId=TDCE_20220422123

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command ID

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

router_ip
required

Router IPAddress

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Router Element Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListRouter Subnet

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.114.7. Interfaces List

GET /router_subnet/interfaces
Description

Obtains a list of interfaces discovered by Router in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/router_subnet/getinterfaces?router_ip=1.1.1.0&cmdId=TDCE_20220422123

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command ID

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

router_ip
required

Router IPAddress

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Router Element Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListRouter Interface

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.114.8. Interfaces List

GET /router_subnet/neighbours
Description

Obtains a list of interfaces discovered by Router in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/router_subnet/neighbours?router_ip=1.1.1.0&cmdId=TDCE_20220422123

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command ID

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

router_ip
required

Router IPAddress

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Router Element Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListRouter Neighbor

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.114.9. Add Subnet

POST /router_subnet/network-subnet/add
Description

Creates new Subnet in TCPWave IPAM.
Below example shows sample request JSON:
[+ "{ "addr1":10,"addr2":0,"addr3":0,"addr4":0,"mask_length":24,"
+ ""name":"Demo Subnet 1", "routerAddress":"10.0.0.1","
+ ""organization_name":"QAOrg", "
+ ""network_address":"10.0.0.0","primary_domain":"qa.com"}]

Parameters
Type Name Description Schema Default

Body

body
required

Network and Subnet creation

Subnet Information

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.114.10. Router Details

GET /router_subnet/rmap
Description

Gets the map details for a switch discovered in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/files/upload/{file_name}?commandId=TDC_20220422121&isNeighbor=1

Parameters
Type Name Description Schema Default

Query

commandId
required

Command ID

string

Query

isNeighbor
required

Neighbour View

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< DiscoveryMap > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.114.11. Router Configurations

GET /router_subnet/router-configurations
Description

Obtains router configurations discovered by TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/router_subnet/router-configurations?router_ip=1.1.1.0&cmdId=TDCE_202220422123

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command ID

string

Query

router_ip
required

Router IPAddress

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.114.12. Add Routers

POST /router_subnet/router/multiadd
Description

Creates multiple new routers in TCPWave IPAM.
Below example shows sample request JSON:
[{"ip":"1.0.0.2","sys_uptime":"2022-04-22 10:29:24","mac":"00:00:5e:00:53:af","commandId":"TDCE_2022042112","vendor":"CISCO","platform":"IOS","version":"5"}]

Parameters
Type Name Description Schema Default

Body

body
required

Routers List

< Router > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.114.13. Router Details

GET /router_subnet/routerdetails
Description

Gets the Router details for a switch discovered in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/router_subnet/routerdetails?router_ip=10.0.0.3&cmdId=TDCE_20220422123

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command ID

string

Query

router_ip
required

Router IP

string

Responses
HTTP Code Description Schema

200

successful operation

Router

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.114.14. Add Router Elements

POST /router_subnet/routerelement/multiadd
Description

Creates one or more router elements in TCPWave IPAM.
Below example shows sample request JSON:
[{"routerIP":"1.0.0.2","interfaceName":"loopback0","macAddress":"2C:54:91:88:C9:E3","description":"Router Element","ipAddress":"10.1.10.120","commandId":"TDCE_20220221021"}]

Parameters
Type Name Description Schema Default

Body

body
required

Router Elements List

< Router Element Details > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.114.15. Add Router Interfaces

POST /router_subnet/routerinterface/multiadd
Description

Creates multiple new router Interfaces in TCPWave IPAM.
Below example shows sample request JSON:
[{"routerIp":"1.0.0.2","interfaceIp":"10.0.0.15","commandId":"TDCE_20220422124","interfaceName":"f0/0.82","ipVersion":5}]

Parameters
Type Name Description Schema Default

Body

body
required

Router Interfaces List

< Router Interface > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.114.16. Add Router Neighbors

POST /router_subnet/routerneighbor/multiadd
Description

Creates multiple new router Neighbors in TCPWave IPAM.
Below example shows sample request JSON:
[{"routerIp":"1.0.0.2","neighbor_interface":"loopback01","commandId":"TDCE_20220422124","local_interface":"f0/0.82","ipVersion":5, "system_description":"Neighbor Router"}]

Parameters
Type Name Description Schema Default

Body

body
required

Router Neighbors List

< Router Neighbor > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.114.17. Add Router Subnets

POST /router_subnet/routersubnet/multiadd
Description

Creates one or more router subnets in TCPWave IPAM.
Below example shows sample request JSON:
[{"routerIP":"1.0.0.2","interfaceName":"loopback0","subnetIP":"1.0.0.0","subnetMask":"255.255.255.0","subnetMaskLength":"24","nextHop":"","isVrf":"false","isLocal":"false"}]

Parameters
Type Name Description Schema Default

Body

body
required

Router Subnets List

< Router Subnet > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.114.18. Add Router and Switch

POST /router_subnet/routerswitch/multiadd
Description

Creates multiple discovered Routers and Switches in TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/files/upload/{file_name}?commandId=TDC_20220422121&routerIp=10.0.0.25&switchIp=10.0.0.15

Parameters
Type Name Description Schema Default

Body

body
required

Routers and switches List

< Router Switch > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.114.19. Add Router VRFs

POST /router_subnet/routervrf/multiadd
Description

Creates one or more router VRFs in TCPWave IPAM.
Below example shows sample request JSON:
[{"routerIp":"1.0.0.2","name":"VRF","route_distinguisher":"10.1.10.15","vrf_interface":"f0/0.82"}]

Parameters
Type Name Description Schema Default

Body

body
required

Router VRFs List

< VRF > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.114.20. Add Router Subnet elements

POST /router_subnet/subnetelement/multiadd
Description

Creates one or more router subnet elements in TCPWave IPAM.
Below example shows sample request JSON:
[{"routerIp":"1.0.0.2","name":"subnetElement1","commandId":"TDCE_20220422124","vendor":"CISCO", "ip_address":"10.0.0.0", "domainName":"tcp.com", "organizationName":"Test", "maskLength":8}]

Parameters
Type Name Description Schema Default

Body

body
required

Router Subnets List

< RouterSubnetElement > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.114.21. Switch Configurations

GET /router_subnet/switch-configurations
Description

Obtains switch configurations discovered by TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/router_subnet/switch-configurations?router_ip=1.1.1.0&cmdId=TDCE_20220422123

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command ID

string

Query

switch_ip
required

Switch IPAddress

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.114.22. Add Switches

POST /router_subnet/switch/multiadd
Description

Creates one or more switches in TCPWave IPAM.
Below example shows sample request JSON:
[{"ipAddress":"1.0.0.2","sysName":"TCPWaveSwitch","commandId":"TDCE_20220422124","sysLocation":"USA","neighborIp":10.1.10.15", "sysDesc":"Switch", "vendor":"CISCO", "platform":"IOS", "version":"5"}]

Parameters
Type Name Description Schema Default

Body

body
required

Switch List

< Switch Details > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.114.23. Add Switch Ports

POST /router_subnet/switch/vlansubnetelement/multiadd
Description

Creates one or more switch vlan elements in TCPWave IPAM.
Below example shows sample request JSON:
[{"subnetIP":"1.0.0.2","switchIP":"10.1.10.25","macAddress":"2C:54:91:88:C9:E3","description":"Switch VLAN Subnet","ipAddress":"10.1.10.120","commandId":"TDCE_20220221021"}]

Parameters
Type Name Description Schema Default

Body

body
required

Switch VLAN Subnet Element List

< Switch VLAN Subnet Element Details > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.114.24. Switch Neighbors List

GET /router_subnet/switch_neighbours
Description

Obtains a list of switch neighbours discovered by Switch in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/router_subnet/neighbours?router_ip=1.1.1.0&cmdId=TDCE_20220422123

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command ID

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Router Element Range

integer(int32)

Query

switch_ip
required

Switch IPAddress

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListSwitch Neighbor

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.114.25. Add Switch Ports

POST /router_subnet/switchelement/multiadd
Description

Creates multiple new switch ports in TCPWave IPAM.
Below example shows sample request JSON:
[{"switchIP":"1.0.0.2","vlanName":"VLAN","commandId":"TDCE_20220422124","portName":"Port12", "ipAddress":"10.0.0.15"}]

Parameters
Type Name Description Schema Default

Body

body
required

Switch Element List

< Switch Element Details > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.114.26. Add Switch Neighbors

POST /router_subnet/switchneighbor/multiadd
Description

Creates multiple new Switch Neighbors in TCPWave IPAM.
Below example shows sample request JSON:
[{"switch_ip":"1.0.0.2","neighbor_interface":"loopback01","commandId":"TDCE_20220422124","local_interface":"f0/0.82","management_ip":10.1.10.15", "system_description":"Neighbor Router"}]

Parameters
Type Name Description Schema Default

Body

body
required

Switch Neighbors List

< Switch Neighbor > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.114.27. Add Switch Ports

POST /router_subnet/switchport/multiadd
Description

Creates one or more switch ports in TCPWave IPAM.
Below example shows sample request JSON:
[{"switchIP":"1.0.0.2","vlan":"VLAN","commandId":"TDCE_20220422124","name":"Port12"}]

Parameters
Type Name Description Schema Default

Body

body
required

Switch Port List

< Port Details > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.114.28. Add Switch Vlans

POST /router_subnet/switchvlan/multiadd
Description

Creates one or more switch vlans in TCPWave IPAM.
Below example shows sample request JSON:
[{"switchIP":"1.0.0.2","name":"VLAN","commandId":"TDCE_20220422124","status":"up"}]

Parameters
Type Name Description Schema Default

Body

body
required

Switch Vlan List

< Vlan Details > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.114.29. Upload File

POST /router_subnet/upload/{file_name}
Description

Uploads a new File from specified location into TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/files/upload/{file_name}?commandId=TDC_20220422121&deviceIp=10.0.0.25&deviceType=Router

Parameters
Type Name Description Schema Default

Path

file_name
required

File Name

string

Query

agentIp
required

Agent IP

string

Query

commandId
required

Command ID

string

Query

deviceIp
required

Device IP

string

Query

deviceType
required

Device Type

string

Body

body
optional

string

Responses
HTTP Code Description Schema

500

TIMS-8228: The file type is not valid.

No Content

Consumes
  • text/plain

4.114.30. Add Switch Vlan Subnets

POST /router_subnet/vlansubnets/multiadd
Description

Creates multiple new switch vlan subnets in TCPWave IPAM.
Below example shows sample request JSON:
[{"switchIp":"1.0.0.2",,"commandId":"TDCE_20220422124","vlanName":"VLAN", "subnetIP":"10.0.0.0", "domain_name":"tcp.com", "organization_name":"Test", "subnetMaskLength":8}]

Parameters
Type Name Description Schema Default

Body

body
required

Switch vlan subnets List

< Vlan Subnet Details > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

4.114.31. VRFs List

GET /router_subnet/vrfs
Description

Obtains a list of vrfs discovered by Router in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/router_subnet/neighbours?router_ip=1.1.1.0&cmdId=TDCE_20220422123

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command ID

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

router_ip
required

Router IPAddress

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Router Element Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListVRF

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.115. Schedule Handler Service

Description

This service provides methods to Schedule an operation based on the settings provided and Execute the operation at the scheduled time.

4.115.1. Schedule Object Job

POST /schedhandler/execute
Description

Schedules an Object job.
Below example shows sample request JSON:
"objectjobname"

Parameters
Type Name Description Schema Default

Body

body
optional

string

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.115.2. Schedule an operation

POST /schedhandler/schedule
Description

Depending on the repeat parameters setting, some of the optional URL params will be required.
The example listed below shows a sample request URL:
/rest/schedhandler/schedule?repeat=1&frequency=12&runtime=3/18/2019 4:37&starttime=3/18/2019 4:37&endtime=4/18/2019 4:37&day=1&description=test&repeatInterval=23456&repeatCount==2&jobId=20
Below example shows sample request JSON:
{ "data": "string", "entity": "zone", "operation": "true", "extensiondata": "string"}

Parameters
Type Name Description Schema Default

Query

day
required

Operation Day

integer(int32)

Query

description
required

Operation Description String

string

Query

endtime
required

Operation Endtime

string

Query

frequency
required

Operation Frequency

string

Query

jobId
required

Job Id

string

Query

repeat
required

Operation Occurrence

integer(int32)

Query

repeatCount
required

Operation repeatCount

integer(int32)

Query

repeatInterval
required

Operation repeatInterval

integer(int64)

Query

runtime
required

Operation Runtime

string

Query

starttime
required

Operation Starttime

string

Body

body
optional

Job data for scheduling operation.

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.116. Scheduled Audit Report Service

Description

This class contains information related to all canned reports scheduling. The class includes the schedule email functionality for Daily /weekly /Monthly canned reports.

4.116.1. Scheduled Audit Report List

GET /Scheduledreports/Scheduledreportlist
Description

The example listed below shows a sample request URL:
/rest/Scheduledreports/Scheduledreportlist?reportType=1&start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

reportType
required

Type of the report

string

Query

start
required

Starting Report Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListAudit Report Details

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.116.2. Audit Report Delete

POST /Scheduledreports/delete
Description

The example listed below shows a sample request URL:
/rest/Scheduledreports/delete?reportType=1&ids=

Parameters
Type Name Description Schema Default

Query

ids
required

string

Query

reportType
required

string

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.116.3. Subscribe Audit Report

POST /Scheduledreports/subscribe
Description

The example listed below shows a sample request URL:
/rest/Scheduledreports/subscribe?reportType=1&period=
Below example shows sample request JSON:
[ { "organization_name": "string", "first_name": "string", "last_name": "string", "middle_name": "string", "email_id": "string", "phone_num": "string", "full_name": "string", "old_first_name": "string", "old_last_name": "string", "old_middle_name": "string", "old_email_id": "string", "roles": "string" }]

Parameters
Type Name Description Schema Default

Query

period
required

string

Query

reportType
required

string

Body

body
optional

< Contacts Information > array

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.117. Scheduled Job Executor Status Service

Description

This class implements the REST service calls related to the scheduled jobs status management, such as adding a scheduled jobs execution status or retrieving all the previous execution status of a particular job.

4.117.1. Add Schedule Job Execution Status

POST /sched/execstatus/add
Description

Adds a scheduled job’s execution status record to the database.
Below example shows sample request JSON:
{ "jobType": "rest", "jobData": "Executed at 15:20 AM", "scheduleType": "Daily", "execution_time": "3/18/2016 3:39", "operation": "Add", "execution_time_string": "3/18/2016 3:39"}

Parameters
Type Name Description Schema Default

Body

body
required

Status of the scheduled job

Scheduled job execution status information

Responses
HTTP Code Description Schema

500

TIMS-8068: type jobs cannot be executed using this option.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.117.2. Get Job Execution status

GET /sched/execstatus/after/{exectime}
Description

Retrieve the execution status of the current scheduled job in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/sched/execstatus/after/125

Parameters
Type Name Description Schema Default

Path

exectime
required

job execution time

integer(int64)

Responses
HTTP Code Description Schema

200

successful operation

< Scheduled job execution status information > array

500

TIMS-8011: Job Execution Time is null.

No Content

Produces
  • application/json

  • application/xml

4.117.3. Get Scheduled Jobs

GET /sched/execstatus/{id}
Description

Retrieve the list scheduled jobs in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/sched/execstatus/125?page=1&rows=20

Parameters
Type Name Description Schema Default

Path

id
required

Job ID

string

Query

page
required

Page number

integer(int32)

Query

rows
required

Rows per page

integer(int32)

Query

utcdiff
optional

UTC Time Difference

string

Responses
HTTP Code Description Schema

200

successful operation

PagedListScheduled Job Execution Status Information

500

TIMS-8001: JobId is null. TIMS-8007: Job Id is empty.

No Content

Produces
  • application/json

  • application/xml

4.117.4. Delete All Job Execution status

DELETE /sched/execstatus/{id}
Description

Deletes request for all job execution status with jobId in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/sched/execstatus/after/125

Parameters
Type Name Description Schema Default

Path

id
required

job ID

string

Responses
HTTP Code Description Schema

500

TIMS-8001: JobId is null. TIMS-8007: Job Id is empty.

No Content

Produces
  • application/json

  • application/xml

  • text/plain

4.118. Scheduled Job Service

Description

This class provides the services related to scheduled jobs such as listing all Scheduled jobs, retrieves a scheduled job, modifying a scheduled job, executing a scheduled job in the TCPWave IPAM.

4.118.1. Schedule Job Add

POST /sched/job/add
Description

Creates a Schedule Job in the TCPWave IPAM. The information about the schedule jobs are maintained in IPAM. Similarly, the execution status of the scheduled jobs will be maintained in IPAM server
Below example shows sample request JSON:
{ "jobType": "string", "jobData": "string", "scheduleType": "string", "runDay": 0, "repeatInterval": 0, "repeatCount": 0, "description": "string", "startDate": "3/18/2019 4:37", "endDate": "4/18/2019 4:37", "operation": "Add", "target_instance": "Object", "sysjob": 112, "jobpaused": 0, "startDateString": "3/18/2016 4:50", "endDateString": "3/18/2017 4:50", "runTimeString": "string", "runDayDisplayString": "string", "repeatIntervalString": "string"}

Parameters
Type Name Description Schema Default

Body

body
optional

Tims Scheduled Job Information

Responses
HTTP Code Description Schema

500

TIMS-8001: JobId is null, TIMS-8007: Job Id is empty.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.118.2. Currently Available Scheduled Tasks List

GET /sched/job/displayList
Description

Shows the list of all currently available Scheduled Jobs in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/sched/job/displayList?utcdiff=330

Parameters
Type Name Description Schema Default

Query

utcdiff
required

UTC Time Difference

string

Responses
HTTP Code Description Schema

200

successful operation

< Tims Scheduled Job Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.118.3. Scheduled Job Edit

POST /sched/job/edit
Description

Update the current scheduled job in the TCPWave IPAM. TCPWave IPAM default scheduled jobs cannot be edited.
Below example shows sample request JSON:
{ "jobType": "string", "jobData": "string", "scheduleType": "string", "runDay": 0, "repeatInterval": 0, "repeatCount": 0, "description": "string", "startDate": "3/18/2019 4:37", "endDate": "4/18/2019 4:37", "operation": "Add", "target_instance": "Object", "sysjob": 112, "jobpaused": 0, "startDateString": "3/18/2016 4:50", "endDateString": "3/18/2017 4:50", "runTimeString": "string", "runDayDisplayString": "string", "repeatIntervalString": "string"}

Parameters
Type Name Description Schema Default

Body

body
optional

Tims Scheduled Job Information

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.118.4. Scheduled Job Execution

POST /sched/job/execute
Description

Executes the Scheduled Job based on the time interval defined by the user
Below example shows sample request JSON:
"ExternalDNSZonesGet"

Parameters
Type Name Description Schema Default

Body

body
optional

string

Responses
HTTP Code Description Schema

500

TIMS-8051: JobId does not exist, TIMS-8021: Job handler is not defined.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.118.5. Execute Scheduled Job Now

POST /sched/job/executeNow
Description

Execute the current scheduled job in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/sched/job/executeNow?jid=ExternalDNSZonesGet

Parameters
Type Name Description Schema Default

Query

jid
required

job ID

string

Responses
HTTP Code Description Schema

500

TIMS-8069: DNS Server name is not specified for the sync operation, TIMS-8051: JobId does not exist, TIMS-8021: Job handler is not defined.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.118.6. Scheduled Appliance Sync Details

GET /sched/job/getserversyncscheduledetails
Description

Gets the details of the appliance scheduled syncs.
The example listed below shows a sample request URL:
/rest/sched/job/getserversyncscheduledetails

Parameters
Type Name Description Schema Default

Query

entity
optional

string

Query

ip
optional

string

Responses
HTTP Code Description Schema

200

successful operation

< Tims Scheduled Job Information > array

500

An exception has occurred while retrieving sync schedule details.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.118.7. Scheduled Job Add

POST /sched/job/ipamAdd
Description

Add the current scheduled job in the TCPWave IPAM. Repetitive and one time schedule jobs can be added in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/sched/job/ipamAdd?repeat=2&frequency=2&runTime=3/18/2019 4:37&starttime=3/18/2019 4:37&endtime=4/18/2019 4:37&day=1&description=test&repeatInterval=1235&repeatCount=1245&jid=124&jtype=Script&jdata=abc&jarg=1&utcdiff=330

Parameters
Type Name Description Schema Default

Query

day
required

Day of Scheduled Job

integer(int32)

Query

description
required

Description of Scheduled Job

string

Query

endtime
required

End Time

string

Query

frequency
required

Frequency of Scheduled Job

string

Query

jarg
required

Scheduled Job Argument

string

Query

jdata
required

Scheduled Job Data

string

Query

jid
required

Scheduled Job ID

string

Query

jtype
required

Scheduled Job Type

string

Query

repeat
required

Repeat Number

integer(int32)

Query

repeatCount
required

Total Repetition Count

integer(int32)

Query

repeatInterval
required

Repeat Interval

integer(int64)

Query

runtime
required

Execution Time

string

Query

starttime
required

Start Time

string

Query

utcdiff
required

UTC Difference

string

Responses
HTTP Code Description Schema

500

TIMS-1022: Admin role is not valid.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.118.8. Current Scheduled Job Delete

DELETE /sched/job/ipamDelete/{id}
Description

Delete the current scheduled job in the TCPWave IPAM. TCPWave IPAM default scheduled jobs cannot be deleted.
The example listed below shows a sample request URL:
/rest/sched/job/ipamDelete/12351

Parameters
Type Name Description Schema Default

Path

id
required

job ID

string

Responses
HTTP Code Description Schema

500

TIMS-1022: Admin role is not valid, TIMS-8014: Job Id does not exist in the scheduler.

No Content

Produces
  • application/json

  • application/xml

  • text/plain

4.118.9. Scheduled Job Edit

POST /sched/job/ipamEdit
Description

Update the current scheduled job in the TCPWave IPAM.
Below example shows sample request JSON:
{ "jobType": "string", "jobData": "string", "scheduleType": "string", "runDay": 0, "repeatInterval": 0, "repeatCount": 0, "description": "string", "startDate": "3/18/2019 4:37", "endDate": "4/18/2019 4:37", "operation": "Add", "target_instance": "Object", "sysjob": 112, "jobpaused": 0, "startDateString": "3/18/2016 4:50", "endDateString": "3/18/2017 4:50", "runTimeString": "string", "runDayDisplayString": "string", "repeatIntervalString": "string"}

Parameters
Type Name Description Schema Default

Query

day
required

Day of Scheduled Job

integer(int32)

Query

description
required

Description of Scheduled Job

string

Query

endtime
required

End Time

string

Query

frequency
required

Frequency of Scheduled Job

string

Query

repeat
required

Repeat Number

integer(int32)

Query

repeatCount
required

Total Repetition Count

integer(int32)

Query

repeatInterval
required

Repeat Interval

integer(int64)

Query

runtime
required

Execution Time

string

Query

starttime
required

Start Time

string

Query

utcdiff
required

UTC Difference

string

Body

body
optional

Tims Scheduled Job Information

Responses
HTTP Code Description Schema

500

TIMS-8013: Scheduler connection error, TIMS-8014: JobId ID does not exist in the scheduler, TIMS-8016: Scheduler internal error.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.118.10. Update the job state

POST /sched/job/jobStateUpdate
Description

Update the scheduled job’s status in TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/sched/job/jobStateUpdate?jid=1234&jstate=1

Parameters
Type Name Description Schema Default

Query

jid
required

job ID

string

Query

jstate
required

job State

integer(int32)

Responses
HTTP Code Description Schema

500

TIMS-8051: JobId does not exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.118.11. List Scheduled Jobs Type

GET /sched/job/jobTypeList
Description

Retrieves the types of scheduled jobs.
The example listed below shows a sample request URL:
/rest/sched/job/jobTypeList

Responses
HTTP Code Description Schema

200

successful operation

< Scheduled Job Type > array

500

TIMS-8033: JobType is not valid, TIMS-8034: JobId is either null or empty, TIMS-8035: JobId cannot start with Rest_ or Patch_ and followed by digits.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.118.12. Update the job state

POST /sched/job/jobTypeUpdate
Description

Update the scheduled job’s status in TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/sched/job/jobTypeUpdate?jid=1234&jstate=1

Parameters
Type Name Description Schema Default

Query

jid
required

job ID

string

Query

jtype
required

job Type

integer(int32)

Responses
HTTP Code Description Schema

500

TIMS-8051: JobId does not exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.118.13. Scheduled Tasks List

GET /sched/job/list
Description

List All Scheduled Tasks defined in the TCPWave IPAM. Functional Admin and Super Admin get the list of all the scheduled jobs. Rest of the Admins get the list of the jobs scheduled by them.
The example listed below shows a sample request URL:
/rest/sched/job/list

Responses
HTTP Code Description Schema

200

successful operation

< Tims Scheduled Job Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.118.14. Scheduled job multi delete

POST /sched/job/multipleDelete
Description

Delete the current list of scheduled jobs in the TCPWave IPAM. TCPWave IPAM default scheduled jobs cannot be deleted.
Below example shows sample request JSON:
[ "ExternalDNSZonesGet"]

Parameters
Type Name Description Schema Default

Body

body
optional

< string > array

Responses
HTTP Code Description Schema

500

TIMS-8001: JobId is null, TIMS-8007: Job Id is empty.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.118.15. Purge Job

POST /sched/job/purgeJobs
Description

Delete the current list of scheduled jobs in the TCPWave IPAM. TCPWave IPAM default scheduled jobs cannot be deleted.
Below example shows sample request JSON:
[ "ExternalDNSZonesGet"]

Parameters
Type Name Description Schema Default

Body

body
optional

string

Responses
HTTP Code Description Schema

500

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.118.16. Get Scheduled Job

GET /sched/job/{id}
Description

Retrieves a Scheduled Job.
The example listed below shows a sample request URL:
/rest/sched/job/1533

Parameters
Type Name Description Schema Default

Path

id
required

Job ID

string

Responses
HTTP Code Description Schema

200

successful operation

Tims Scheduled Job Information

500

No Content

Produces
  • application/json

  • application/xml

  • text/plain

4.118.17. Delete Scheduled Job

DELETE /sched/job/{id}
Description

Deletes a Scheduled Job.
The example listed below shows a sample request URL:
/rest/sched/job/1533

Parameters
Type Name Description Schema Default

Path

id
required

Scheduled Job ID

string

Responses
HTTP Code Description Schema

500

No Content

Produces
  • application/json

  • application/xml

  • text/plain

Description

This class implements the miscellaneous REST service calls related to the scheduler.

4.119.1. Get Job Info

GET /sched/opers/jobinfo
Description

Retrieves the needed job information.
The example listed below shows a sample request URL:
/rest/sched/opers/jobinfo?jid=12458

Parameters
Type Name Description Schema Default

Query

jid
required

job ID

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1201: Error in obtaining the job information.

No Content

Produces
  • application/json

  • application/xml

  • text/plain

4.119.2. Get Debug level

GET /sched/opers/loginfo
Description

Retrieves the IPAM’s debug level setting.
The example listed below shows a sample request URL:
/rest/sched/opers/loginfo

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1201: Error in getting the log level.

No Content

Produces
  • application/json

  • application/xml

  • text/plain

4.120. Scope Service

Description

This class provides services related to DHCPv4 Scopes. TCPWave IPAM supports adding a scope, deleting a scope, listing all objects in a scope, validating a object in the scope etc.

4.120.1. Scope Create

POST /scope/create
Description

Creates DHCP Scopes by validating if the given start IP and end IP span through a valid free IP address in a subnet. The logic also checks if the DHCP Option Template associated to the scope has a valid Router and Subnet Mask that match with the subnet profile.
Below example shows sample request JSON:
{ "update_ns_a": true, "update_ns_ptr": true, "dyn_update_rrs_a": true, "dyn_update_rrs_cname": true, "dyn_update_rrs_ptr": true, "dyn_update_rrs_mx": true, "ttl": "1200", "scope": { "class_code": "3G Phone", "description": "", "organization_name": "QAOrg", "primary_dhcp_server": "QA-Remote", "allocation_type": "dynamic", "template_name": "option-temp", "allowClassesArray": [], "denyClassesArray": [], "addressRanges": [{ "startIP": "10.1.10.55", "endIP": "10.1.10.60" }] }, "subnetAddress": "10.1.10.0" }
Below example shows sample request JSON with multiple DHCP classes associated to scope:
{ "update_ns_a": true, "update_ns_ptr": true, "dyn_update_rrs_a": true, "dyn_update_rrs_cname": true, "dyn_update_rrs_ptr": true, "dyn_update_rrs_mx": true, "ttl": "1200", "scope": { "class_code": "3G Phone", "description": "", "organization_name": "QAOrg", "primary_dhcp_server": "QA-Remote", "allocation_type": "dynamic", "template_name": "option-temp", "allowClassesArray": [client class1,client class2,Userclass1], "denyClassesArray": [client class2,client class3,Userclass2], "addressRanges": [{ "startIP": "10.1.10.55", "endIP": "10.1.10.60" }] }, "subnetAddress": "10.1.10.0" }

Parameters
Type Name Description Schema Default

Body

body
required

DHCP scope details

Create Scope Request

Responses
HTTP Code Description Schema

500

TIMS-1259: Object address range does not belong to any network, TIMS-1256: Scope already exists for this object range, TIMS-1257: Object address range overlaps with an existing object address range, TIMS-1258: Object address range exceeds the subnet range, TIMS-1260: Object address range already has non-dynamic objects, TIMS-1262: Subnet does not have a primary router defined and the template has the option router defined, TIMS-1263: Subnet does not have primary router

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.120.2. Scope Delete

POST /scope/delete
Description

Deletes one or a more scopes defined in the TCPWave IPAM.
Below example shows sample request JSON:
[{ "addressRange": "10.0.0.16-10.0.0.18","subnetAddress": "10.0.0.19","organization_name": "QAOrg" }]

Parameters
Type Name Description Schema Default

Body

body
required

List of scopes details

< Delete Scope Request > array

Responses
HTTP Code Description Schema

500

TIMS-1261: Scope does not exist for object range: start ip - end ip

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.120.3. Delete active leases

POST /scope/delete-active-leases
Description

Delete active leases of the given scope defined in the TCPWave IPAM.
Below example shows sample request :
/rest/scope/delete-active-leases?startAddr=10.0.0.2&endAddr=10.0.0.50&organizationName=Internal

Parameters
Type Name Description Schema Default

Query

endAddr
required

End Address of Scope

string

Query

organizationName
required

Organization Name

string

Query

startAddr
required

Start Address of Scope

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3966: Scope does not exist for object range: scope-range in organization.TIMS-3968: Cannot delete the active leases for the Microsoft DHCP enabled scope.

No Content

Consumes
  • application/json

  • text/plain

Produces
  • application/json

  • text/plain

4.120.4. Scope List

GET /scope/list
Description

Provides a paginated list of DHCP Scope Definitions in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/scope/list?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter Rule

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

orgName
optional

Organization name

string

Query

serverType
optional

DHCP appliance type

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Scope Range

integer(int32)

Query

subnetAddress
optional

Subnet address of scope

string

Responses
HTTP Code Description Schema

200

successful operation

PagedListScope Information

500

TIMS-7003: You are not authorized to perform this operation,TIMS-2015: Subnet does not exist.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.120.5. Scope Validation Request

GET /scope/validate_request
Description

Provides the subnet address, DHCP Option Template and DHCP Appliance for a given scope. The start IP and end IP of a scope are the inputs for this REST Call.
The example listed below shows a sample request URL:
/rest/scope/validate_request?min_addr=1.0.0.2&1.0.0.5&organizationName=Internal

Parameters
Type Name Description Schema Default

Query

max_addr
required

Ending Address in Scope

string

Query

min_addr
required

Starting Address in Scope

string

Query

organizationName
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Scope Validate Request Data

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.121. Search Service

Description

This service provides API's to get IPAM search details and to rebuild search indexes on the tables.

4.121.1. Rebuild Search Index

POST /search/rebuildIndex
Description

Rebuilds search index and restarts the DB replicator in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/search/rebuildIndex

Responses
HTTP Code Description Schema

500

Index rebuild operation is already in progress. Please try after some time.

No Content

Consumes
  • application/json

  • text/plain

Produces
  • application/json

  • application/xml

4.121.2. Entity Global Search

GET /search/search
Description

Performs a global search with the string provided by the user and returns list of entities present in the IPAM which satisfy the search criteria. Allowed search types are Text, Wildcard, Regex and Match.
Allowed characters for Text search and Match search string: a-z, A-Z, 0-9, _, @, ., *, #, -, /, ? and space
Allowed characters for Wildcard search string: a-z, A-Z, 0-9, _, @, ., *, #, +, -, :, /, (, ), ? and space
Allowed characters for Regex search string: a-z, A-Z, 0-9, ., @, *, #, -, +, /, (, ), ?, &, [, ], {, }, |, ~, <, > and space

The example listed below shows a sample request URL:

/rest/search/search?page=1&rows=20&search_term=test&search_type=Text&entity_type=network

Parameters
Type Name Description Schema Default

Query

entity_type
required

Enter entity type value. Ex: network, subnet, object etc.
Allowed values: network, subnet, object, v6network, v6subnet, v6object, domain, custom_groups, organization, contact, location, admin, acl, resource_record, template, dns_server_template, admin_groups, v6_dhcp_server, server, subnet_group, v6_subnet_group, log_channel, scope, v6_scope, zone, root_zone, proxy_root_zone, dns64, appliance_group, subnet_template, cloud_dns_provider, tea_extension, params, tempate_params, v6_params, v6_template_params, tea_network, tea_subnet, tea_admin, tea_object, tea_zone, ipam_appliance, windows_servers, reverse_zone, tea_rr, dns_forwarders, tea_reverse_zone, dhcp_class, dhcp_pollers, discovery_template, admin_permissions

string

Query

field_name
optional

Field name which represents the column name in the database table.
Note: Field name is mandatory when search type is Wildcard, Regex or Match.

Allowed values along with descriptions: object_full_address(IPv4/IPv6(Expanded) Object Address), network_full_address(IPv4 Network Address (Without Mask Length)), subnet_full_address(IPv4 Subnet Address (Without Mask Length)), v4_ipaddress(IPv4 Remote Appliance), v6_ipaddress(IPv6 Remote Appliance), ip_short(IPv6 Compressed Subnet/Network), ip_full(IPv6 Expanded Subnet/Network), object_short_address(IPv6 Compressed Object Address), name(Name), server_name(Microsoft Appliance Name), server_ip(Microsoft Appliance IPv4 Address), data(Resource Record Data), owner(Resource Record Owner), display_name(Template Parameter Name), value(Value), email_id(Email Address), first_name(First Name), phone_num(Phone Number), last_name(Last Name), middle_name(Middle Name), full_location(Location), end_of_life(End Of Life), monitored_by(Monitored By), type(Resource Record Type), lease_info(DHCP Lease Information), lease_time(DHCP Lease Time), managed_by(Managed By), model_type(Model Type), description(Description), class_code(Object Type), vlan_id(VLAN ID), switch(Switch Name), port(Switch Port), duplex(Port Duplex)

string

Query

page
optional

Page

integer(int32)

Query

rows
optional

Rows

integer(int32)

Query

search_term
required

Search string

string

Query

search_type
required

Search type. Allowed values are Text, Wildcard, Regex and Match.

string

Responses
HTTP Code Description Schema

200

successful operation

PagedListObject

Consumes
  • text/plain

  • application/json

Produces
  • application/json

  • application/xml

4.122. Security Group Service

4.122.1. Add Security Group

POST /securitygroup/add
Description

Creates a new security group in the TCPWave IPAM.
Below example shows sample request JSON:
{"name":"SecurityGroupName","organization_name":"Internal","cloud_provider":"AWS","vpc_id":"23523egrgfggsggrg","description":"Security group"}

Parameters
Type Name Description Schema Default

Body

body
required

AWS Security groups.

Security Group

Responses
HTTP Code Description Schema

500

An Security group with the given name already exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.122.2. Security Group Delete

GET /securitygroup/delete
Description

Deletes the Security group present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/securitygroup/delete?name=securityGroupName&organization=orgName

Parameters
Type Name Description Schema Default

Query

cloud_provider
required

Provider Name

string

Query

name
required

Security Group Name

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

500

TIMS-2051: Security group is not deleted as it is being used.

No Content

Consumes
  • text/plain

  • application/json

Produces
  • application/json

  • application/xml

4.122.3. Edit Security Group

POST /securitygroup/edit
Description

Updates an existing security group in the TCPWave IPAM. Functional and Users Admins can edit an security group in any organization.
Below example shows sample request JSON:
{"name":"securityGroupName","organization_name":"Internal""description":"Security group""prevAppGroupName":"app-group",}

Parameters
Type Name Description Schema Default

Body

body
required

AWS Security groups.

Security Group

Responses
HTTP Code Description Schema

500

A security group with the given name already exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.122.4. Details of Security Group

GET /securitygroup/get
Description

Retrieves the details of an security group in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/securitygroup/get?name=securityGroupName&organization=orgName

Parameters
Type Name Description Schema Default

Query

name
optional

Security Group Name

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Security Group

500

TIMS-12074: Security group name cannot be null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.122.5. List Security Group

GET /securitygroup/list
Description

Provides a list of Security groups present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/tims/rest/securitygroup/list?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Comma Separated Organization Names

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Security Group Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListSecurity Group

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.122.6. Cloud Provider List

GET /securitygroup/listcloudproviders
Description

Obtains a list of all the cloud providers defined in the TCPWave IPAM. A cloud provider is an instance of the cloud provider type with the associated credentials to manage the data in the cloud. Please refer to TCPWave IPAM Administrator Guide for a comprehensive list of cloud provider types supported.
The example listed below shows a sample request URL:
/rest/securitygroup/list?orgName=Internal

Parameters
Type Name Description Schema Default

Query

orgName
required

Organization name required for listing all cloud providers associated with that Organization.

string

Query

org_id
optional

Organization Id required for listing all cloud providers.

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< DNS Cloud Provider > array

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1021: Organization name is not valid, TIMS-1025: Organization id is not valid, TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.122.7. Cloud Provider List

GET /securitygroup/listvpcs
Description

Obtains a list of all the cloud providers defined in the TCPWave IPAM. A cloud provider is an instance of the cloud provider type with the associated credentials to manage the data in the cloud. Please refer to TCPWave IPAM Administrator Guide for a comprehensive list of cloud provider types supported.
The example listed below shows a sample request URL:
/rest/securitygroup/listvpc?orgName=Internal&cloudProvider=AWS

Parameters
Type Name Description Schema Default

Query

cloud_provider
required

Cloud Provider name required for listing all AWS VPC’s.

string

Query

orgName
required

Organization name required for listing all listing all AWS VPC’s.

string

Responses
HTTP Code Description Schema

200

successful operation

< AWS VPC’s > array

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1021: Organization name is not valid, TIMS-1025: Organization id is not valid, TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.123. Server License Service

Description

This service provides API's to get list of Server licenses present in the TCPWave IPAM, add license key information for a TCPWave Remote instance in the TCPWave IPAM, check whether license is valid or not for a specified DNS Remote in the TCPWave IPAM and update remote license which is valid for a certain period of time based on the type of License chosen at the time of purchase.

4.123.1. License Add

POST /server_license/add
Description

Add license key information for a TCPWave Remote instance in the TCPWave IPAM. TCPWave IPAM validates the license key and restarts the TCPWave Remote agent.
Below example shows sample request JSON:
{ "server_id": 123, "server_name": "DHCP-100", "server_v4ip": "10.0.0.0", "organization_name": "TCPWAVE", "server_type_code": "string", "server_license_id": "8EB8AB85DFF74B0B492BB9618375DA11", "is_valid": false, "days_valid": 100, "license_ip": "10.0.0.0", "license_service_tag": "2", "customer": "Ericson Ltd.", "customer_id": "987", "server_type": "BIND", "status": "Valid/Invalid", "last_checked": "12/10/2016", "server_current_status": "0 (for License valid)/ 1 (for License Invalid) ", "isPermanent": true, "isHaLicense": true, "maxIps": 0, "majorVersion": "string", "minorVersion": "string"}

Parameters
Type Name Description Schema Default

Body

body
optional

Server License

Responses
HTTP Code Description Schema

500

TIMS-6103: License not valid for this server. Please contact support, TIMS-6107: Import failed as the license limit of maximum objects exceeded.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.123.2. Check Valid license

GET /server_license/check
Description

Checks whether license is valid or not for a specified DNS Remote in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/server_license/check

Responses
HTTP Code Description Schema

200

successful operation

boolean

500

TIMS-3901: License Key is not valid.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.123.3. Server license List

GET /server_license/list
Description

Provides a list of Server licenses present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/server_license/list?server_type=DHCP

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization List

string

Query

server_type
required

Server Type

string

Responses
HTTP Code Description Schema

200

successful operation

< Server License > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.123.4. Remote license Update

GET /server_license/update_remote
Description

TCPWave IPAM supports the feature to update remote license which is valid for a certain period of time based on the type of License chosen at the time of purchase.
The example listed below shows a sample request URL:
/rest/server_license/update_remote?address=10.0.0.2&license=234567ddrthgbnsdbsd&server_type=DNS&server_name=3GPhone

Parameters
Type Name Description Schema Default

Query

address
required

Appliance Address

string

Query

license
required

Appliance License Key

string

Query

server_name
required

Appliance Name

string

Query

server_type
required

Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

LicenseData

500

TIMS-9503: The server did not respond for license update.Please check if the appliance is up and running.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.123.5. License Add

POST /v6server_license/add
Description

Add license key information for a TCPWave Remote instance in the TCPWave IPAM. TCPWave IPAM validates the license key and restarts the TCPWave Remote agent.
Below example shows sample request JSON:
{ "server_id": 123, "server_name": "DHCP-100", "server_v4ip": "10.0.0.0", "organization_name": "TCPWAVE", "server_type_code": "string", "server_license_id": "8EB8AB85DFF74B0B492BB9618375DA11", "is_valid": false, "days_valid": 100, "license_ip": "10.0.0.0", "license_service_tag": "2", "customer": "Ericson Ltd.", "customer_id": "987", "server_type": "BIND", "status": "Valid/Invalid", "last_checked": "12/10/2016", "server_current_status": "0 (for License valid)/ 1 (for License Invalid) ", "isPermanent": true, "isHaLicense": true, "maxIps": 0, "majorVersion": "string", "minorVersion": "string"}

Parameters
Type Name Description Schema Default

Body

body
optional

Server License

Responses
HTTP Code Description Schema

500

TIMS-6103: License not valid for this server. Please contact support, TIMS-6107: Import failed as the license limit of maximum objects exceeded.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

4.123.6. Check Valid license

GET /v6server_license/check
Description

Checks whether license is valid or not for a specified DNS Remote in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/server_license/check

Responses
HTTP Code Description Schema

200

successful operation

boolean

500

TIMS-3901: License Key is not valid.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.123.7. Server license List

GET /v6server_license/list
Description

Provides a list of Server licenses present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/server_license/list?server_type=DHCP

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization List

string

Query

server_type
required

Server Type

string

Responses
HTTP Code Description Schema

200

successful operation

< Server License > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.123.8. Remote license Update

GET /v6server_license/update_remote
Description

TCPWave IPAM supports the feature to update remote license which is valid for a certain period of time based on the type of License chosen at the time of purchase.
The example listed below shows a sample request URL:
/rest/server_license/update_remote?address=10.0.0.2&license=234567ddrthgbnsdbsd&server_type=DNS&server_name=3GPhone

Parameters
Type Name Description Schema Default

Query

address
required

Appliance Address

string

Query

license
required

Appliance License Key

string

Query

server_name
required

Appliance Name

string

Query

server_type
required

Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

LicenseData

500

TIMS-9503: The server did not respond for license update.Please check if the appliance is up and running.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.124. Server Service

Description

This service provides API's to changes debug log level to Enable/Disable Remote Debugging in DNS appliances managed by the TCPWave IPAM and to clone a DNS/DHCP server that takes an exact copy of an existing server configuration in the TCPWave IPAM.

4.124.1. Update the value of NIC from CLI

POST /ipv6dnsserver/changeRemoteNIC
Description

Update network interface configuration the given IPAM managed by TCPWave.
The example listed below shows a sample request URL:
/rest/server/changeRemoteNIC?appliance=1.0.0.3,1.0.0.5&syncStatus=0/1

Parameters
Type Name Description Schema Default

Query

appliance
required

Appliances

string

Query

syncStatus
required

Sync Status

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • application/json

  • application/xml

4.124.2. Check Objects

POST /ipv6dnsserver/checkObjectsInSameSubnet
Description

Checks given objects belongs to the same subnet or not.
The example listed below shows a sample request URL:
/rest/server/checkObjectsInSameSubnet?nicType=Remote

Parameters
Type Name Description Schema Default

Query

nicType
required

NIC Type: Remote or IPAM

string

Body

body
optional

< NICObject > array

Responses
HTTP Code Description Schema

200

successful operation

boolean

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.124.3. Server Debug Setting

POST /ipv6dnsserver/debug-setting
Description

Debugs the existing server setting.Changes debug log level to Enable/Disable Remote Debugging in DNS appliances managed by the TCPWave IPAM.
Below example shows sample request JSON:
/rest/v6server/debug-setting

Parameters
Type Name Description Schema Default

Body

body
optional

< Server Information > array

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3088: Server IP address is null

No Content

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

  • application/json

  • application/xml

4.124.4. Enable/Disable DNS Tunnel Detection

POST /ipv6dnsserver/dnstunneldetection
Description

Enables/Disables DNS tunnel detection on the selected DNS recursive enabled appliance managed by the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/server/dnstunneldetection?address=1.0.0.3&applianceType=DNS&detect=yes/no

Parameters
Type Name Description Schema Default

Query

address
required

Server IP Address

string

Query

detect
required

Tunnel Detection Value

string

Query

serverType
required

Server Type

string

Responses
HTTP Code Description Schema

500

TIMS-14082: DNS tunnel detection cannot be enabled on DNS Proxy, NSD and Bind Auth without recursion enabled appliance.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • text/plain

4.124.5. Object Details

GET /ipv6dnsserver/get
Description

Get the object details.
The example listed below shows a sample request URL:
/rest/server/get?address=1.0.0.3&organization=Internal

Parameters
Type Name Description Schema Default

Query

address
required

Object Address

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

TIMS Object

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.124.6. GET Attached Network Interfaces

GET /ipv6dnsserver/getAttachedNics
Description

Provides the attached network interfaces for the given Appliance IP address in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/server/getAttachedNics?address=1.0.0.3&applianceType=DNS&nicType=Remote/IPAM

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Query

applianceType
required

Appliance Type

string

Query

nicType
required

NIC Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3091: Appliance does not exist.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.124.7. Server Get Clone Configuration

GET /ipv6dnsserver/getCloneConfiguration
Description

Cloning a DNS/DHCP server takes an exact copy of an existing server configuration in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/server/getCloneConfiguration?address=1.0.0.3&organization=Internal

Parameters
Type Name Description Schema Default

Query

address
required

Server IP Address

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Server Information

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.124.8. Get NIC duplex settings

GET /ipv6dnsserver/getDuplexSettings
Description

Gets given network interface’s duplex settings.
The example listed below shows a sample request URL:
/rest/server/getDuplexSettings?device=test&nicType=Remote&address=1.0.0.3&applianceType=DNS

Parameters
Type Name Description Schema Default

Query

address
required

IP address

string

Query

applianceType
required

Appliance Type

string

Query

device
required

Network interface Name

string

Query

nicType
required

NIC Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.124.9. Object Details

GET /ipv6dnsserver/getObjectDetailsForNIC
Description

Get the object details.
The example listed below shows a sample request URL:
/rest/server/getObjectDetailsForNIC?nicType=Remote&organization=Internal&address=1.0.0.3

Parameters
Type Name Description Schema Default

Query

address
required

Object Address

string

Query

device
optional

NIC Name

string

Query

nicType
required

NIC Type: Remote or IPAM

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Network Interface

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.124.10. Get patch deployment history

GET /ipv6dnsserver/getPatchHistory
Description

Provides the patch deployment history for the given Appliance in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/server/getPatchHistory?address=1.0.0.3&applianceType=DNS

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Query

applianceType
required

Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

< Patch deployment details in a Server. > array

500

TIMS-3091: Appliance does not exist.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.124.11. Get number of Processors

GET /ipv6dnsserver/getProcessorsCount
Description

Provides the number of processors for the given appliance IP address in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/server/getProcessorsCount?address=1.0.0.3&applianceType=DNS

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Query

applianceType
required

Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3091: Appliance does not exist.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.124.12. Get Routes of Network

GET /ipv6dnsserver/getRoutes
Description

Gets routes of the network setup in a given appliance.
The example listed below shows a sample request URL:
/rest/server/getRoutes?nicType=Remote&address=1.0.0.3&applianceType=DNS

Parameters
Type Name Description Schema Default

Query

address
required

IP Address

string

Query

applianceType
required

Appliance Type

string

Query

nicType
required

NIC Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.124.13. Get Routing Tables

GET /ipv6dnsserver/getRtTables
Description

Gets routing tables of the network interfaces in a given appliance.
The example listed below shows a sample request URL:
/rest/server/getRtTables?nicType=Remote&address=1.0.0.3&applianceType=DNS

Parameters
Type Name Description Schema Default

Query

address
required

IP address

string

Query

applianceType
required

Appliance Type

string

Query

nicType
required

NIC Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.124.14. DNS, DHCP and Both

GET /ipv6dnsserver/isDNSDHCP
Description

Checks given IP address associated with DNS, DHCP and both.
The example listed below shows a sample request URL:
/rest/server/isDNSDHCP?address=1.0.0.3

Parameters
Type Name Description Schema Default

Query

address
required

Object Address

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.124.15. DNS Server List

GET /ipv6dnsserver/list
Description

Obtain a List of all the DNS Servers defined in the TCPWave IPAM. Functional Admin gets the list of all servers. Rest of the Admins get only the list of servers associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/server/list?serverType=DNS

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

serverType
required

Server Type

string

Responses
HTTP Code Description Schema

200

successful operation

< string > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.124.16. Sync Network Interfaces

GET /ipv6dnsserver/syncNics
Description

Sync network interfaces for the given Appliance IP address in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/server/syncNics?address=1.0.0.3&applianceType=DNS&syncStatus=0/1

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Query

applianceType
required

Appliance Type

string

Query

syncStatus
required

Sync Status

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3091: Appliance does not exist.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.124.17. Update the default syslog-ng configuration

POST /ipv6dnsserver/updateDefaultSyslogNgConfig
Description

Updates default syslog-ng configuration without wiping out user defined syslog-ng configuration.
The example listed below shows a sample request URL:
/rest/server/updateDefaultSyslogNgConfig

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

4.124.18. Server Central Logging Setting

POST /ipv6dnsserver/v6serverCentralLoggingSetting
Description

The Central Logging Service provides the functionality to send different IPAM logs to a data collection server, like Flume Agent.
Below example shows the sample request URL:
rest/v6server/v6serverCentralLoggingSetting

Parameters
Type Name Description Schema Default

Body

body
optional

< Server Information > array

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-8611: Central Logging is not configured on the IPAM server. Please configure it first, TIMS-8612: Central Logging feature is not implemented.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

  • application/json

  • application/xml

4.124.19. Update the value of NIC from CLI

POST /server/changeRemoteNIC
Description

Update network interface configuration the given IPAM managed by TCPWave.
The example listed below shows a sample request URL:
/rest/server/changeRemoteNIC?appliance=1.0.0.3,1.0.0.5&syncStatus=0/1

Parameters
Type Name Description Schema Default

Query

appliance
required

Appliances

string

Query

syncStatus
required

Sync Status

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • application/json

  • application/xml

4.124.20. Check Objects

POST /server/checkObjectsInSameSubnet
Description

Checks given objects belongs to the same subnet or not.
The example listed below shows a sample request URL:
/rest/server/checkObjectsInSameSubnet?nicType=Remote

Parameters
Type Name Description Schema Default

Query

nicType
required

NIC Type: Remote or IPAM

string

Body

body
optional

< NICObject > array

Responses
HTTP Code Description Schema

200

successful operation

boolean

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.124.21. Server Debug Setting

POST /server/debug-setting
Description

Debugs the existing server setting.Changes debug log level to Enable/Disable Remote Debugging in DNS appliances managed by TCPWave IPAM.
Below example shows sample request JSON:
/rest/server/debug-setting

Parameters
Type Name Description Schema Default

Body

body
optional

< Server Information > array

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3088: Server IP address is null

No Content

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

  • application/json

  • application/xml

4.124.22. Enable/Disable DNS Tunnel Detection

POST /server/dnstunneldetection
Description

Enables/Disables DNS tunnel detection on the selected DNS recursive enabled appliance managed by the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/server/dnstunneldetection?address=1.0.0.3&applianceType=DNS&detect=yes/no

Parameters
Type Name Description Schema Default

Query

address
required

Server IP Address

string

Query

detect
required

Tunnel Detection Value

string

Query

serverType
required

Server Type

string

Responses
HTTP Code Description Schema

500

TIMS-14082: DNS tunnel detection cannot be enabled on DNS Proxy, NSD and Bind Auth without recursion enabled appliance.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • text/plain

4.124.23. Object Details

GET /server/get
Description

Get the object details.
The example listed below shows a sample request URL:
/rest/server/get?address=1.0.0.3&organization=Internal

Parameters
Type Name Description Schema Default

Query

address
required

Object Address

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

TIMS Object

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.124.24. GET Attached Network Interfaces

GET /server/getAttachedNics
Description

Provides the attached network interfaces for the given Appliance IP address in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/server/getAttachedNics?address=1.0.0.3&applianceType=DNS&nicType=Remote/IPAM

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Query

applianceType
required

Appliance Type

string

Query

nicType
required

NIC Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3091: Appliance does not exist.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.124.25. Server Get Clone Configuration

GET /server/getCloneConfiguration
Description

Cloning a DNS/DHCP server takes an exact copy of an existing server configuration in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/server/getCloneConfiguration?address=1.0.0.3&organization=Internal

Parameters
Type Name Description Schema Default

Query

address
required

Server IP Address

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Server Information

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.124.26. Remote Cluster Configuration

GET /server/getClusterInfo
Description

Get remote cluster configuration.
The example listed below shows a sample request URL:
/rest/server/getClusterInfo?vipType=BIND AUTH&vipIP=10.0.0.8&orgName=DemoOrg

Parameters
Type Name Description Schema Default

Query

vipIP
required

Remote Cluster IP

string

Query

vipOrgName
required

Organization Name

string

Query

vipType
required

Remote Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

Remote Cluster Server Information

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.124.27. Remote Cluster Status

GET /server/getClusterStatus
Description

Get remote cluster status.
The example listed below shows a sample request URL:
/rest/server/getClusterInfo?serverTypeCode=BIND AUTH&vipIP=10.0.0.8

Parameters
Type Name Description Schema Default

Query

vipIP
required

Remote Cluster IP

string

Query

vipOrgName
required

Organization Name

string

Query

vipType
required

Remote Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

RemoteClusterState

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.124.28. Get NIC duplex settings

GET /server/getDuplexSettings
Description

Gets given network interface’s duplex settings.
The example listed below shows a sample request URL:
/rest/server/getDuplexSettings?device=test&nicType=Remote&address=1.0.0.3&applianceType=DNS

Parameters
Type Name Description Schema Default

Query

address
required

IP address

string

Query

applianceType
required

Appliance Type

string

Query

device
required

Network interface Name

string

Query

nicType
required

NIC Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.124.29. Object Details

GET /server/getObjectDetailsForNIC
Description

Get the object details.
The example listed below shows a sample request URL:
/rest/server/getObjectDetailsForNIC?nicType=Remote&organization=Internal&address=1.0.0.3

Parameters
Type Name Description Schema Default

Query

address
required

Object Address

string

Query

device
optional

NIC Name

string

Query

nicType
required

NIC Type: Remote or IPAM

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Network Interface

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.124.30. Get patch deployment history

GET /server/getPatchHistory
Description

Provides the patch deployment history for the given Appliance in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/server/getPatchHistory?address=1.0.0.3&applianceType=DNS

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Query

applianceType
required

Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

< Patch deployment details in a Server. > array

500

TIMS-3091: Appliance does not exist.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.124.31. Get number of Processors

GET /server/getProcessorsCount
Description

Provides the number of processors for the given appliance IP address in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/server/getProcessorsCount?address=1.0.0.3&applianceType=DNS

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Query

applianceType
required

Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3091: Appliance does not exist.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.124.32. Get Routes of Network

GET /server/getRoutes
Description

Gets routes of the network setup in a given appliance.
The example listed below shows a sample request URL:
/rest/server/getRoutes?nicType=Remote&address=1.0.0.3&applianceType=DNS

Parameters
Type Name Description Schema Default

Query

address
required

IP Address

string

Query

applianceType
required

Appliance Type

string

Query

nicType
required

NIC Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.124.33. Get Routing Tables

GET /server/getRtTables
Description

Gets routing tables of the network interfaces in a given appliance.
The example listed below shows a sample request URL:
/rest/server/getRtTables?nicType=Remote&address=1.0.0.3&applianceType=DNS

Parameters
Type Name Description Schema Default

Query

address
required

IP address

string

Query

applianceType
required

Appliance Type

string

Query

nicType
required

NIC Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.124.34. DNS, DHCP and Both

GET /server/isDNSDHCP
Description

Checks given IP address associated with DNS, DHCP and both.
The example listed below shows a sample request URL:
/rest/server/isDNSDHCP?address=1.0.0.3

Parameters
Type Name Description Schema Default

Query

address
required

Object Address

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.124.35. DNS Server List

GET /server/list
Description

Obtain a List of all the DNS Servers defined in the TCPWave IPAM. Functional Admin gets the list of all servers. Rest of the Admins get only the list of servers associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/server/list?serverType=DNS

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

serverType
required

Server Type

string

Responses
HTTP Code Description Schema

200

successful operation

< string > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.124.36. Sync Network Interfaces

GET /server/syncNics
Description

Sync network interfaces for the given Appliance IP address in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/server/syncNics?address=1.0.0.3&applianceType=DNS&syncStatus=0/1

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Query

applianceType
required

Appliance Type

string

Query

syncStatus
required

Sync Status

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3091: Appliance does not exist.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.124.37. Update the default syslog-ng configuration

POST /server/updateDefaultSyslogNgConfig
Description

Updates default syslog-ng configuration without wiping out user defined syslog-ng configuration.
The example listed below shows a sample request URL:
/rest/server/updateDefaultSyslogNgConfig

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

4.124.38. Windows Server List

GET /server/windowsServerslist
Description

Obtain a List of all the Windows Servers defined in the TCPWave IPAM. Functional Admin gets the list of all servers. Rest of the Admins get only the list of servers associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/server/windowsServerslist

Parameters
Type Name Description Schema Default

Query

OrgName
required

Server Type

string

Responses
HTTP Code Description Schema

200

successful operation

< Microsoft Server Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.124.39. Update the value of NIC from CLI

POST /v6server/changeRemoteNIC
Description

Update network interface configuration the given IPAM managed by TCPWave.
The example listed below shows a sample request URL:
/rest/server/changeRemoteNIC?appliance=1.0.0.3,1.0.0.5&syncStatus=0/1

Parameters
Type Name Description Schema Default

Query

appliance
required

Appliances

string

Query

syncStatus
required

Sync Status

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • application/json

  • application/xml

4.124.40. Check Objects

POST /v6server/checkObjectsInSameSubnet
Description

Checks given objects belongs to the same subnet or not.
The example listed below shows a sample request URL:
/rest/server/checkObjectsInSameSubnet?nicType=Remote

Parameters
Type Name Description Schema Default

Query

nicType
required

NIC Type: Remote or IPAM

string

Body

body
optional

< NICObject > array

Responses
HTTP Code Description Schema

200

successful operation

boolean

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.124.41. Server Debug Setting

POST /v6server/debug-setting
Description

Debugs the existing server setting.Changes debug log level to Enable/Disable Remote Debugging in DNS appliances managed by TCPWave IPAM.
Below example shows sample request JSON:
/rest/v6server/debug-setting

Parameters
Type Name Description Schema Default

Body

body
optional

< Server Information > array

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3088: Server IP address is null

No Content

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

  • application/json

  • application/xml

4.124.42. Enable/Disable DNS Tunnel Detection

POST /v6server/dnstunneldetection
Description

Enables/Disables DNS tunnel detection on the selected DNS recursive enabled appliance managed by the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/server/dnstunneldetection?address=1.0.0.3&applianceType=DNS&detect=yes/no

Parameters
Type Name Description Schema Default

Query

address
required

Server IP Address

string

Query

detect
required

Tunnel Detection Value

string

Query

serverType
required

Server Type

string

Responses
HTTP Code Description Schema

500

TIMS-14082: DNS tunnel detection cannot be enabled on DNS Proxy, NSD and Bind Auth without recursion enabled appliance.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • text/plain

4.124.43. Object Details

GET /v6server/get
Description

Get the object details.
The example listed below shows a sample request URL:
/rest/server/get?address=1.0.0.3&organization=Internal

Parameters
Type Name Description Schema Default

Query

address
required

Object Address

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

TIMS Object

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.124.44. GET Attached Network Interfaces

GET /v6server/getAttachedNics
Description

Provides the attached network interfaces for the given Appliance IP address in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/server/getAttachedNics?address=1.0.0.3&applianceType=DNS&nicType=Remote/IPAM

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Query

applianceType
required

Appliance Type

string

Query

nicType
required

NIC Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3091: Appliance does not exist.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.124.45. Server Get Clone Configuration

GET /v6server/getCloneConfiguration
Description

Cloning a DNS/DHCP server takes an exact copy of an existing server configuration in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/server/getCloneConfiguration?address=1.0.0.3&organization=Internal

Parameters
Type Name Description Schema Default

Query

address
required

Server IP Address

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Server Information

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.124.46. Get NIC duplex settings

GET /v6server/getDuplexSettings
Description

Gets given network interface’s duplex settings.
The example listed below shows a sample request URL:
/rest/server/getDuplexSettings?device=test&nicType=Remote&address=1.0.0.3&applianceType=DNS

Parameters
Type Name Description Schema Default

Query

address
required

IP address

string

Query

applianceType
required

Appliance Type

string

Query

device
required

Network interface Name

string

Query

nicType
required

NIC Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.124.47. Object Details

GET /v6server/getObjectDetailsForNIC
Description

Get the object details.
The example listed below shows a sample request URL:
/rest/server/getObjectDetailsForNIC?nicType=Remote&organization=Internal&address=1.0.0.3

Parameters
Type Name Description Schema Default

Query

address
required

Object Address

string

Query

device
optional

NIC Name

string

Query

nicType
required

NIC Type: Remote or IPAM

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Network Interface

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.124.48. Get patch deployment history

GET /v6server/getPatchHistory
Description

Provides the patch deployment history for the given Appliance in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/server/getPatchHistory?address=1.0.0.3&applianceType=DNS

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Query

applianceType
required

Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

< Patch deployment details in a Server. > array

500

TIMS-3091: Appliance does not exist.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.124.49. Get number of Processors

GET /v6server/getProcessorsCount
Description

Provides the number of processors for the given appliance IP address in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/server/getProcessorsCount?address=1.0.0.3&applianceType=DNS

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Query

applianceType
required

Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3091: Appliance does not exist.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.124.50. Get Routes of Network

GET /v6server/getRoutes
Description

Gets routes of the network setup in a given appliance.
The example listed below shows a sample request URL:
/rest/server/getRoutes?nicType=Remote&address=1.0.0.3&applianceType=DNS

Parameters
Type Name Description Schema Default

Query

address
required

IP Address

string

Query

applianceType
required

Appliance Type

string

Query

nicType
required

NIC Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.124.51. Get Routing Tables

GET /v6server/getRtTables
Description

Gets routing tables of the network interfaces in a given appliance.
The example listed below shows a sample request URL:
/rest/server/getRtTables?nicType=Remote&address=1.0.0.3&applianceType=DNS

Parameters
Type Name Description Schema Default

Query

address
required

IP address

string

Query

applianceType
required

Appliance Type

string

Query

nicType
required

NIC Type

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.124.52. DNS, DHCP and Both

GET /v6server/isDNSDHCP
Description

Checks given IP address associated with DNS, DHCP and both.
The example listed below shows a sample request URL:
/rest/server/isDNSDHCP?address=1.0.0.3

Parameters
Type Name Description Schema Default

Query

address
required

Object Address

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-7002: Permission information cannot be retrieved.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.124.53. DNS Server List

GET /v6server/list
Description

Obtain a List of all the DNS Servers defined in the TCPWave IPAM. Functional Admin gets the list of all servers. Rest of the Admins get only the list of servers associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/server/list?serverType=DNS

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

serverType
required

Server Type

string

Responses
HTTP Code Description Schema

200

successful operation

< string > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.124.54. Sync Network Interfaces

GET /v6server/syncNics
Description

Sync network interfaces for the given Appliance IP address in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/server/syncNics?address=1.0.0.3&applianceType=DNS&syncStatus=0/1

Parameters
Type Name Description Schema Default

Query

address
required

Appliance IP Address

string

Query

applianceType
required

Appliance Type

string

Query

syncStatus
required

Sync Status

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-3091: Appliance does not exist.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.124.55. Update the default syslog-ng configuration

POST /v6server/updateDefaultSyslogNgConfig
Description

Updates default syslog-ng configuration without wiping out user defined syslog-ng configuration.
The example listed below shows a sample request URL:
/rest/server/updateDefaultSyslogNgConfig

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

4.124.56. Server Central Logging Setting

POST /v6server/v6serverCentralLoggingSetting
Description

The Central Logging Service provides the functionality to send different IPAM logs to a data collection server, like Flume Agent.
Below example shows the sample request URL:
rest/v6server/v6serverCentralLoggingSetting

Parameters
Type Name Description Schema Default

Body

body
optional

< Server Information > array

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-8611: Central Logging is not configured on the IPAM server. Please configure it first, TIMS-8612: Central Logging feature is not implemented.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.125. Subnet Group Service

Description

This service provides API access to perform subnet group related operations like add, edit and delete.

4.125.1. Subnet Group Add

POST /subnetgroup/add
Description

Creates a new subnet group in the TCPWave IPAM. Functional Admins can add a subnet group in any organization. Other Admins can add the subnet groups in their own organization only.
Below example shows sample request JSON:
{ "name":"Subgroup","description":"test","organization_name":"Internal" }

Parameters
Type Name Description Schema Default

Body

body
optional

Subnet Group

Responses
HTTP Code Description Schema

500

TIMS-1250: A subnet group with the given name already exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.125.2. Subnet Group Delete Multiple

POST /subnetgroup/delete
Description

Deletes the subnet groups present in the TCPWave IPAM. Functional Admins can delete a subnet group in any organization. Other Admins can delete the subnet groups belonging to their organization only.
Below example shows sample request JSON:
{"name":"aaaa_sub"}

Parameters
Type Name Description Schema Default

Body

body
optional

Subnet Group

Responses
HTTP Code Description Schema

500

TIMS-2051: Subnet group is not deleted as it is being used.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.125.3. Disassociate Subnet

POST /subnetgroup/disassociate
Description

Dissociates Subnet from the Subnet Group. This action is audited.
The example listed below shows a sample request URL:
/rest/subnetgroup/disassociate?fullAddress=1.0.0.0&org_name=Internal

Parameters
Type Name Description Schema Default

Query

fullAddress
required

Subnet address

string

Query

org_name
required

Organization Name

string

Responses
HTTP Code Description Schema

500

Subnet does not exist.

No Content

Consumes
  • application/json

  • application/xml

4.125.4. Subnet Group Get

GET /subnetgroup/get
Description

Retrieves the details of a subnet group in the TCPWave IPAM. Subnet Group manages all the subnets which belongs to that subnet group.
The example listed below shows a sample request URL:
/rest/subnetgroup/get?organization=Internal&name=subnetGroupName

Parameters
Type Name Description Schema Default

Query

id
optional

Subnet Group ID

string

Query

name
required

Subnet Group Name

string

Query

organization
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Subnet Group

500

TIMS-2052: Both Subnet group name and id cannot be null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.125.5. List Subnets present in the given Subnet Group

GET /subnetgroup/listSubnets
Description

Returns a list of Subnets present in the given Subnet Group.
The example listed below shows a sample request URL:
/rest/subnetgroup/listSubnets?subnet_grp_name=subnetGroupName&org_name=Internal&length=20&start=1

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

org_name
required

Organization Name

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Subnet Range

integer(int32)

Query

subnet_grp_id
optional

Subnet Group Id

integer(int32)

Query

subnet_grp_name
required

Subnet Group Name

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListSubnet Information

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.125.6. Subnet Group Organization List

GET /subnetgroup/listbyorg
Description

Provides a list of Subnet groups present in the TCPWave IPAM. For Functional Admin, if the organization id is not specified then all the subnet groups are listed.
The example listed below shows a sample request URL:
/rest/subnetgroup/listbyorg?organization_name=Internal

Parameters
Type Name Description Schema Default

Query

organization_id
optional

Organization ID

integer(int32)

Query

organization_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Subnet Group > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.125.7. Subnet Group References

GET /subnetgroup/references
Description

Provides the list of Subnet Groups that are referenced in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/subnetgroup/references?page=1&rows=20&tables=tableName&count=2

Parameters
Type Name Description Schema Default

Query

count
required

Total Count

string

Query

id
optional

Reference ID

string

Query

page
required

Page Number

integer(int32)

Query

rows
required

Rows per Page

integer(int32)

Query

tables
required

Reference Table

string

Responses
HTTP Code Description Schema

200

successful operation

Reference Results

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.125.8. Subnet Group Search

GET /subnetgroup/search
Description

Searches for a particular subnet group present in TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/subnetgroup/search?page=1&rows=20

Parameters
Type Name Description Schema Default

Query

organizations
required

Organization List

string

Query

page
required

Page Number

integer(int32)

Query

rows
required

Rows per Page

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListSubnet Group

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.125.9. Subnet Group Edit

POST /subnetgroup/update
Description

Updates the subnet groups present in the TCPWave IPAM. Functional Admins can update a subnet group in any organization. Other Admins can update the subnet groups in their own organization only.
Below example shows sample request JSON:
{"name":"Subgroup11","description":"","organization_name":"QAOrg","oldName":"Subgroup" }

Parameters
Type Name Description Schema Default

Body

body
optional

Subnet Group

Responses
HTTP Code Description Schema

500

TIMS-1250: A subnet group with the given name already exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.126. Subnet Service

Description

This service provides API's to add, delete, modify subnets in the TCPWave IPAM.

4.126.1. Active Leases List

GET /subnet/activeLeases
Description

Lists all the DHCP Objects that are holding an active lease in the network for a given subnet that is defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/subnet/activeLeases?serverAddress=10.0.0.8&subnetAddress=10.0.0.0&organizationName=Internal&dhcpType=dhcp

Parameters
Type Name Description Schema Default

Query

dhcpType
required

DHCP type

string

Query

organizationName
required

Organization Name

string

Query

page
optional

Page

integer(int32)

Query

rows
optional

Rows

integer(int32)

Query

serverAddress
required

Server Address

string

Query

subnetAddress
required

Subnet Address

string

Responses
HTTP Code Description Schema

200

successful operation

PagedListDHCPLeaseObject

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.126.2. Subnet Add

POST /subnet/add
Description

Creates a new subnet by checking if they are overlapping with the existing subnets defined in the TCPWave IPAM.
The allowed subnet types are (1)Non-DHCP (2)DHCP Enabled (3)Cloud Hosted
Non-DHCP subnet type can be used to create static objects. DHCP Enabled subnet type is used to create DHCP objects along with static objects and Cloud Hosted subnet type is used to create cloud instances.
When Non-DHCP subnet type is selected, the parameters primary_domain and routerAddress are mandatory.
When DHCP Enabled subnet type is selected,primary_domain, routerAddress, template_name and primary_dhcp_server are mandatory.
When Enable Discovery is yes, Objects present in the subnet will be eligible for discovery.If Enable Discovery is yes then discovery_template is mandatory field.
When Enable Reclaim is set to yes,The objects present in the subnet will be eligible for reclaim validation and the objects that are not pingable in the reclaim period from the current time will be eligible for reclaim.
On enabling the global option "Enable Secondary Domains for Subnet" to "Yes", user can associate Secondary domains with the subnets
Sample payloads with mandatory parameters to add a subnet are listed below.
Create NON-DHCP Subnet:
{ "addr1":10,"addr2":0,"addr3":0,"addr4":0,"mask_length":24,"name":"Demo Subnet 1", "routerAddress":"10.0.0.1","organization_name":"QAOrg", "network_address":"10.0.0.0","primary_domain":"qa.com"}
Create DHCP-Enabled Subnet:
{ "addr1":10,"addr2":0,"addr3":0,"addr4":0,"mask_length":24,"name":"Demo Subnet 1", "routerAddress":"10.0.0.1","organization_name":"QAOrg", "network_address":"10.0.0.0","primary_domain":"qa.com", "template_name":"dhcp_option_template","primary_dhcp_server":"TCPWave00002Remote"}
Create Cloud Hosted Subnet:
{ "addr1":10,"addr2":0,"addr3":0,"addr4":0,"mask_length":24,"name":"Demo Subnet 1", "routerAddress":"10.0.0.1","network_address":"10.0.0.0","primary_domain":"qa.com", "organization_name":"QAOrg", "cloudProviderName":"cloudflare" }
Create subnet with Enable Discovery:
{ "addr1":10,"addr2":0,"addr3":0,"addr4":0,"mask_length":24,"name":"Demo Subnet 1", "routerAddress":"10.0.0.1","network_address":"10.0.0.0","primary_domain":"qa.com", "organization_name":"QAOrg", "enable_discovery":"yes", "discovery_template":"Default Discovery Template"}
Create subnet with Enable Reclaim:
{ "addr1":10,"addr2":0,"addr3":0,"addr4":0,"mask_length":24,"name":"Demo Subnet 1", "routerAddress":"10.0.0.1","network_address":"10.0.0.0","primary_domain":"qa.com", "organization_name":"QAOrg", "reclaim_objects":"yes", "discovery_template":"Default Discovery Template"}
Create Subnet with Secondary Domains:
{ "addr1":10,"addr2":0,"addr3":0,"addr4":0,"mask_length":24,"name":"Demo Subnet 1", "routerAddress":"10.0.0.1","organization_name":"QAOrg", "secondaryDomains": ["test.com", "example.com"],"network_address":"10.0.0.0","primary_domain":"qa.com"}

Parameters
Type Name Description Schema Default

Body

body
optional

Subnet Information

Responses
HTTP Code Description Schema

500

TIMS-2008: Both Network address and id cannot be null, TIMS-3101: Network does not exist: <Network Address>, TIMS-1355: Organization id is null, TIMS-1321: Domain does not exist: <Domain Name>, TIMS-1449: Cannot associate a restricted domain : <Domain Name> to the subnet, TIMS-5001: Template already exists, TIMS-2018: Subnet group information does not exist, TIMS-1505: Location information does not exist, TIMS-5035: DHCP Template does not exist: <DHCP Template Name>, TIMS-3058: DHCP Appliance does not exist: <DHCP Appliance Name>, TIMS-7004: Please select a DHCP Template.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.126.3. Subnet Add All

POST /subnet/addall
Description

Creates all the possible subnets in a given network by taking all the existing subnets into consideration.
The allowed subnet types are (1)Non-DHCP (2)DHCP Enabled (3)Cloud Hosted
Non-DHCP subnet type can be used to create static objects. DHCP Enabled subnet type is used to create DHCP objects along with static objects and Cloud Hosted subnet type is used to create cloud instances.
When Non-DHCP subnet type is selected, the parameters primary_domain and routerAddress are mandatory.
When DHCP Enabled subnet type is selected,primary_domain, routerAddress, template_name and primary_dhcp_server are mandatory.
When Enable Discovery is yes, Objects present in the subnet will be eligible for discovery.If Enable Discovery is yes then discovery_template is mandatory field.
When Enable Reclaim is set to yes,The objects present in the subnet will be eligible for reclaim validation and the objects that are not pingable in the reclaim period from the current time will be eligible for reclaim.
Sample payloads with mandatory parameters to add a subnet are listed below.
Create NON-DHCP Subnet:
{ "nw_mask_length":8,"mask_length":10,"network_address":"10.0.0.0","subnet":{"router_option":"First IP in the subnet","organization_name":"QAOrg","primary_domain":"qa.com"}}
Create DHCP-Enabled Subnet:
{ "nw_mask_length":8","mask_length":10,"network_address":"10.0.0.0","subnet":{"router_option":"First IP in the subnet","organization_name":"QAOrg","primary_domain":"qa.com", "template_name":"dhcp_option_template","primary_dhcp_server":"TCPWave00002Remote"}}
Create Cloud Hosted Subnet:
{ "nw_mask_length":8","mask_length":10,"network_address":"10.0.0.0","subnet":{"router_option":"First IP in the subnet","organization_name":"QAOrg","primary_domain":"qa.com", "cloudProviderName":"cloudflare" }}
Create subnet with Enable Discovery:
{ "nw_mask_length":8","mask_length":10,"network_address":"10.0.0.0","subnet":{"router_option":"First IP in the subnet","organization_name":"QAOrg","primary_domain":"qa.com", "enable_discovery":"yes", "discovery_template":"Default Discovery Template"}}
Create subnet with Enable Reclaim:
{ "nw_mask_length":8","mask_length":10,"network_address":"10.0.0.0","subnet":{"router_option":"First IP in the subnet","organization_name":"QAOrg","primary_domain":"qa.com", "reclaim_objects":"yes", "discovery_template":"Default Discovery Template"}}

Parameters
Type Name Description Schema Default

Body

body
required

Multiple subnets add operation

Multi Subnet Request

Responses
HTTP Code Description Schema

500

TIMS-2008: Both Network address and id cannot be null, TIMS-3101: Network does not exist: <Network Address>, TIMS-1355: Organization id is null, TIMS-1321: Domain does not exist: <Domain Name>, TIMS-1449: Cannot associate a restricted domain : <Domain Name> to the subnet, TIMS-5001: Template already exists, TIMS-2018: Subnet group information does not exist, TIMS-1505: Location information does not exist, TIMS-5035: DHCP Template does not exist: <DHCP Template Name>, TIMS-3058: DHCP Appliance does not exist: <DHCP Appliance Name>, TIMS-7004: Please select a DHCP Template.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.126.4. Subnet Add

POST /subnet/createNextAvailableSubnet
Description

Creates next available subnet in the specified network for desired mask in the TCPWave IPAM.{"mask_length":24,"name":"Test Subnet","subnetTemplateName":"Test Subnet Template""network_address":"10.10.0.0/16", "organization_name":"TestOrg"}

Parameters
Type Name Description Schema Default

Body

body
optional

Subnet Information

Responses
HTTP Code Description Schema

500

TIMS-7783: Subnet cannot be null., TIMS-7784: Please specify the desired subnet mask length., TIMS-7785: Next available subnet for desired mask does not exist., TIMS-1916: Organization name cannot be null., TIMS-11057: Subnet template name not specified., TIMS-14053: Network Address cannot be null.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • text/plain

4.126.5. Subnet Statistics

POST /subnet/delete
Description

Deletes one or more subnets present in the TCPWave IPAM. Functional Admin can delete subnet belonging to any organization. Rest of the admins can delete subnets belonging to their organization only.
Sample payload with mandatory parameters to delete subnet is listed below
{"addressList":["10.1.10.0/24"],"organizationName":"Internal"}

Parameters
Type Name Description Schema Default

Body

body
optional

Delete Cloud Subnet Request

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-2016: Subnet does not exist: <Subnet Address>, TIMS-3121: Subnet is not deleted as there are servers defined in it, TIMS-1445: Cannot delete subnet(s) as there are one or more Resource Records are defined with the subnet(s) objects. Please delete the references and try again, TIMS-1447: Cannot delete subnet(s) as there are one or more Resource Records are defined with the subnet(s) object level A Resource Records. Please delete the references and try again, TIMS-1454: Cannot delete a subnet as one or more objects are defined as DCs and associated with AD zones. Please delete the references and try again.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.126.6. Updating Subnet

POST /subnet/edit
Description

Updating an specified Subnet in TCPWave IPAM.
Below example shows sample request JSON:
{"subnet":{"name":"Demo Subnet 1","location_id":null, "subnet_group_id":"","vlan_id":"","vrf_name":"None", "sharedNetwork":"None","description":"test","primary_domain":"qa.com", "routerAddress":"10.1.10.1","organization_name":"QAOrg", "primary_dhcp_server_address":"QA-Remote","template_name":"option-temp"}, "address":["10.1.10.0"]}

Parameters
Type Name Description Schema Default

Body

body
required

Subnet update/multi update operation

Multi Subnet Request

Responses
HTTP Code Description Schema

500

TIMS-3084: Subnet update failed as DHCP server is being dis-associated when there is a template, TIMS-3085: Please select a DHCP Appliance, TIMS-3086: Subnet update failed as DHCP option template is being disassociated when there is a server, TIMS-2018: Subnet group information does not exist, TIMS-5035: DHCP Template does not exist: <DHCP Template Name>, TIMS-2016: Subnet does not exist: <Subnet Address>, TIMS-1505: Location information does not exist, TIMS-1321: Domain does not exist: <Domain Name>, TIMS-1449: Cannot associate a restricted domain : <Domain Name> to the subnet, TIMS-3125: Subnet update failed as DHCP Appliance or DHCP Template cannot be dis-associated as there are scopes/M-DHCP definitions in this subnet, TIMS-3058: DHCP Appliance does not exist: <DHCP Appliance Name>, TIMS-7004: Please select a DHCP Template., TIMS-10102: Both view id and view name cannot be null, TIMS-10103: DNS View does not exist for name: <View Name>, TIMS-10111: DNS View cannot be deleted as it is associated with one or more object(s), TIMS-10113: The selected template does not have the views managed by this zone.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.126.7. Subnet Details

GET /subnet/get
Description

Returns the Subnet details that has the DHCP Profile, Primary Router, Subnet Group, VLAN and Domain information for a given subnet.
The example listed below shows a sample request URL:
/rest/subnet/get?address=10.0.0.0&organizationName=Internal

Parameters
Type Name Description Schema Default

Query

address
required

Subnet Address

string

Query

organizationName
required

Organization Name

string

Query

subnet_id
optional

Subnet ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

Subnet Information

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.126.8. Subnet Details

GET /subnet/getSubnetData
Description

Provides the details of subnets for the specified subnet address or object address in the given organization.
The example listed below shows a sample request URL:
/rest/subnet/getSubnetData?org_name=Internal

Parameters
Type Name Description Schema Default

Query

obj_ip
optional

Object Address (In case of subnet address is not given)

string

Query

org_name
required

Organization Name

string

Query

subnet_address
optional

Subnet Address (In case of object address is not given)

string

Responses
HTTP Code Description Schema

200

successful operation

Subnet Information

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.126.9. Subnet Details

GET /subnet/getSubnetDetails
Description

Provides the details of a specified subnet in a network defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/subnet/getSubnetDetails?subnet_address=10.0.0.0&org_name=Internal

Parameters
Type Name Description Schema Default

Query

org_name
required

Organization name

string

Query

subnet_address
required

Subnet Address

string

Query

subnet_id
optional

Subnet ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

Subnet Information

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.126.10. Subnet Details

GET /subnet/getViewsAssociated
Description

Provides the details of associated views in subnet defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/subnet/getViewsAssociated?subnetAddress=10.0.0.0&organizationName=Internal

Parameters
Type Name Description Schema Default

Query

id
optional

Subnet ID

integer(int32)

Query

organizationName
required

Organization Name

string

Query

subnetAddress
required

Subnet Address

string

Responses
HTTP Code Description Schema

200

successful operation

< SubnetViews > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.126.11. Get Subnet

GET /subnet/ip/{address}/{organization_name}
Description

Retrieves the subnet information based on the Network IP address and Organization specified in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/subnet/ip/10.0.0.0/Internal

Parameters
Type Name Description Schema Default

Path

address
required

Network IP Address

string

Path

organization_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Subnet Information

500

TIMS-2016: Subnet does not exist: <Subnet Address>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.126.12. Free Subnet List

GET /subnet/listFreeSubnets
Description

Provides list of all available free subnets in a Network present in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/subnet/listFreeSubnets?ip_address=10.0.0.0&organization_name=Internal

Parameters
Type Name Description Schema Default

Query

ip_address
required

Network IP Address

string

Query

organization_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Subnet Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.126.13. DNS Recursive Enabled Appliance List

GET /subnet/listdomainservers
Description

Provides list of all available DNS recursive enabled appliances that are managed by the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/subnet/listdomainservers?organization_name=Internal

Parameters
Type Name Description Schema Default

Query

organization_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Server Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.126.14. Subnet Range List

GET /subnet/listinrange
Description

Provides the list of all the subnets available in specified range in a Network in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/subnet/listinrange?network_ip=10.0.0.0&start_subnet=1&end_subnet=20&organizationName=Internal

Parameters
Type Name Description Schema Default

Query

end_subnet
required

Page Length

string

Query

network_ip
required

Network IP Address

string

Query

organizationName
required

Organization Name

string

Query

start_subnet
required

Start Page Number

string

Responses
HTTP Code Description Schema

200

successful operation

< Subnet Information > array

500

TIMS-3101: Network does not exist: <Network Address>, TIMS-2016: Subnet does not exist: <Subnet Address>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.126.15. Subnet Merge

POST /subnet/merge
Description

Merges two or more subnets into a subnet of a greater size/ desired mask length. Note: The DHCP Definitions for the subnets have to be redone after the merge.
Sample payload with mandatory parameters to merge subnet is listed below.
{ "address":["10.0.0.0","10.128.0.0"], "subnet":{"primary_domain":"kiran.com", "routerAddress":"10.0.0.1", "mask_length":"8", "network_address":"10.0.0.0", "merge_subnet_start_ip":"10.0.0.0","merge_subnet_end_ip":"10.128.0.0","organization_name":"QAOrg"}}

Parameters
Type Name Description Schema Default

Body

body
required

Multiple subnet entities for subnet merge

Multi Subnet Request

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.126.16. Subnet Add Multiple

POST /subnet/multiadd
Description

Creates multiple subnets by checking if they overlap with the existing subnets in the TCPWave IPAM.
The allowed subnet types are (1)Non-DHCP (2)DHCP Enabled (3)Cloud Hosted
Non-DHCP subnet type can be used to create static objects. DHCP Enabled subnet type is used to create DHCP objects along with static objects and Cloud Hosted subnet type is used to create cloud instances.
When Non-DHCP subnet type is selected, the parameters primary_domain and routerAddress are mandatory.
When DHCP Enabled subnet type is selected,primary_domain, routerAddress, template_name and primary_dhcp_server are mandatory.
When Enable Discovery is set to yes,The Objects present in the subnet will be eligible for discovery.If Enable Discovery is yes then discovery_template is mandatory field.
When Enable Reclaim is set to yes,The objects present in the subnet will be eligible for reclaim validation and the objects that are not pingable in the reclaim period from the current time will be eligible for reclaim.
Sample payloads with mandatory parameters to add a subnet are listed below.
Create NON-DHCP Subnet:
{ "address":["10.64.0.0","10.128.0.0"],"nw_mask_length":24,"subnet":{"network_address":"10.0.0.0", "mask_length":"12","organization_name":"QAOrg", "router_option":"First IP in the subnet","primary_domain":"qa.com"}}
Create DHCP-Enabled Subnet:
{ "address":[ "10.64.0.0","10.128.0.0"],"nw_mask_length":24,"subnet":{"network_address":"10.0.0.0", "mask_length":"12","organization_name":"QAOrg", "router_option":"First IP in the subnet","primary_domain":"qa.com", "template_name":"dhcp_option_template","primary_dhcp_server":"TCPWave00002Remote"}}
Create Cloud Hosted Subnet:
{ "address":[ "10.64.0.0","10.128.0.0" ],"nw_mask_length":24,"subnet":{"network_address":"10.0.0.0", "mask_length":"12","organization_name":"QAOrg", "router_option":"First IP in the subnet","primary_domain":"qa.com", "cloudProviderName":"cloudflare" }}
Create subnet with Enable Discovery:
{ "address":[ "10.64.0.0","10.128.0.0" ],"nw_mask_length":24,"subnet":{"network_address":"10.0.0.0", "mask_length":"12","organization_name":"QAOrg", "router_option":"First IP in the subnet","primary_domain":"qa.com", "enable_discovery":"yes", "discovery_template":"Default Discovery Template"}}
Create subnet with Enable Reclaim:
{ "address":[ "10.64.0.0","10.128.0.0" ],"nw_mask_length":24,"subnet":{"network_address":"10.0.0.0", "mask_length":"12","organization_name":"QAOrg", "router_option":"First IP in the subnet","primary_domain":"qa.com", "reclaim_objects":"yes", "discovery_template":"Default Discovery Template"}}

Parameters
Type Name Description Schema Default

Body

body
required

Multiple subnets details

Multi Subnet Request

Responses
HTTP Code Description Schema

500

TIMS-2008: Both Network address and id cannot be null, TIMS-3101: Network does not exist: <Network Address>, TIMS-1355: Organization id is null, TIMS-1321: Domain does not exist: <Domain Name>, TIMS-1449: Cannot associate a restricted domain : <Domain Name> to the subnet, TIMS-5001: Template already exists, TIMS-2018: Subnet group information does not exist, TIMS-1505: Location information does not exist, TIMS-5035: DHCP Template does not exist: <DHCP Template Name>, TIMS-3058: DHCP Appliance does not exist: <DHCP Appliance Name>, TIMS-7004: Please select a DHCP Template.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.126.17. Subnet list page

GET /subnet/paged
Description

Retrieves the detailed list of subnets of the specified network in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/subnet/paged?network_address=10.0.0.0&org_name=Internal&draw=3&start=0&length=20&sort=fullAddress&order=asc&filterRules=[]

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

network_address
required

Network Address

string

Query

order
optional

Order String

string

Query

org_name
required

Organization Name

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Start Page Number

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListSubnet Information

500

TIMS-3001: An object exists at the given address. Please select an unallocated address, TIMS-3004: Cannot add an object at subnet boundary.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.126.18. Router Details

GET /subnet/routers
Description

Provides the list of Router Objects that are defined in a given subnet.
Below are the sample query parameter values accepted:
/rest/subnet/routers?subnet_address=10.0.0.0&org_name=Internal

Parameters
Type Name Description Schema Default

Query

org_name
required

Organization name

string

Query

subnet_address
required

Subnet Address

string

Responses
HTTP Code Description Schema

200

successful operation

< Subnet Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.126.19. Subnet Split

POST /subnet/split
Description

Splits a given subnet and creates two or more smaller subnets of a desired mask length. Note: The DHCP Definitions of the subnet that is being split are removed after the split is effective.
Sample payload with mandatory parameters to split a subnet is listed below.
{ "mask_length":"16", "router_option":"First IP in the subnet","organization_name":"QAOrg", "fullAddress":"10.0.0.0"}

Parameters
Type Name Description Schema Default

Body

body
required

Subnet entity for split operation

Subnet Information

Responses
HTTP Code Description Schema

500

TIMS-3088: Server IP address is null, TIMS-2015: Subnet does not exist, TIMS-2017: Choose a mask length greater than <Mask Length>

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.127. Subnet Template Service

Description

This service provides API's to manage Subnet Templates in the TCPWave IPAM.

4.127.1. Subnet Template Add

POST /subnet_template/add
Description

Creates a new Subnet Template that can be used during creation of subnets in the TCPWave IPAM.
Below example shows sample request JSON:
{"name": "qa-subnet template", "organizationName": "QAOrg", "primaryDomain": "qa.com", "dhcpServerAddress": "10.1.10.87", "dhcpOptionTemplateName": "option-temp", "subnetType": 1, "routerOption": "first", "description": "Testing creation using REST API", "addressAllocationList":[{ "startOffset": 2, "endOffset": 5, "classCode": "Server", "allocationType": 1, "domain": "qa.com", "ttl":1200 },{ "startOffset": 13, "endOffset": 15, "classCode": "Server", "allocationType": 2, "domain": "qa.com", "clientClassAllow": "c24", "ttl":1200 } ] }

Parameters
Type Name Description Schema Default

Body

body
required

Subnet Template details.

Subnet Template

Responses
HTTP Code Description Schema

500

TIMS-1020: Organization does not exist, TIMS-7003: You are not authorized to perform this operation, TIMS-5006: Template already exists: <Template Name>, TIMS-11057: Invalid router option specified.

No Content

Consumes
  • application/json

  • application/xml

4.127.2. Subnet Template Delete

POST /subnet_template/delete
Description

Deletes the Subnet Template.
The example listed below shows a sample request URL:
/rest/subnet_template/delete?name=templateName&org_name=Internal

Parameters
Type Name Description Schema Default

Query

name
required

Name

string

Query

org_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Subnet Template

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

  • application/json

Produces
  • application/json

  • application/xml

4.127.3. Subnet Template Get

GET /subnet_template/details
Description

Fetches the details of a subnet template.
The example listed below shows a sample request URL:
/rest/subnet_template/details?org_name=Internal&name=testtemplate

Parameters
Type Name Description Schema Default

Query

name
required

Name

string

Query

org_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

Subnet Template

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.127.4. Update Subnet Template

POST /subnet_template/edit
Description

Update an existing Subnet Template that can be used during creation of subnets in the TCPWave IPAM.
Below example shows sample request JSON:
{ "name": "test_template1", "oldName": "test_template1", "organizationName": "Internal", "primaryDomain": "tcpwave.com", "dhcpServerName": "DHCPAppliance1", "dhcpServerAddress": "192.0.0.32", "dhcpOptionTemplateName": "Template1", "dns_appliances": "string", "subnetType": 1, "cloudProvider": "testAWS", "routerOption": "first", "description": "string", "contact_name": "string", "first_name": "string", "middle_name": "string", "last_name": "string", "contact_email_id": "string", "location_name": "string", "street1": "string", "street2": "string", "city": "string", "state": "string", "country": "string", "zip": "string", "sharedNetwork": "shared_network2", "dhcpFailoverPeer": "nusartx-dp", "vrf_name": "network4_vrf", "enable_discovery": "Yes/No", "discovery_template": "DiscoveryTemp1", "reclaim_objects": "Yes/No", "subnet_group_name": "string", "addressAllocationList": [ { "id": 1, "startOffset": 10, "endOffset": 20, "v6StartOffset": 10, "v6EndOffset": 20, "classCodeId": 1, "classCode": "3G Phone", "allocationType": 1, "domainId": 1, "domain": "tcpwave.com", "clientClassAllowId": 1, "clientClassAllow": "ClientClass1", "clientClassDenyId": 1, "clientClassDeny": "ClientClass2", "userClassAllowId": 1, "userClassAllow": "Userclass1", "userClassDenyId": 1, "userClassDeny": "Userclass2", "vendorClassAllowId": 1, "vendorClassAllow": "vendorclass1", "vendorClassDenyId": 1, "vendorClassDeny": "vendorclass2", "ttl": 1200, "resExpiryDate": "3/18/2018 4:37" } ]}

Parameters
Type Name Description Schema Default

Body

body
required

Subnet Template details.

Subnet Template

Responses
HTTP Code Description Schema

500

TIMS-1020: Organization does not exist, TIMS-7003: You are not authorized to perform this operation, TIMS-5006: Template already exists: {Template Name}, TIMS-11057: Invalid router option specified.

No Content

Consumes
  • application/json

  • application/xml

4.127.5. List Subnet Template Search elements

GET /subnet_template/getAddressAllocation
Description

Returns a list of subnet template searched by User in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/subnet_template/getAddressAllocation?organization_name=Internal&name=testtemplate

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

string

Query

id
optional

Subnet Template Id

integer(int32)

Query

name
required

Subnet Template name

string

Query

organization_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Address Allocation > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.127.6. Subnet Template List

GET /subnet_template/list
Description

Fetches the list of subnet templates.
The example listed below shows a sample request URL:
/rest/subnet_template/list?organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

organizations

string

Responses
HTTP Code Description Schema

200

successful operation

< Subnet Template > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.127.7. Subnet Template List By Organization

GET /subnet_template/p_listbyorg
Description

Obtains a list of all subnet templates that are associated to a specified Organization.
The example listed below shows a sample request URL:
/rest/subnet_template/p_listbyorg?start=1&org_name=Internal&length=20&inSubnetEdit=

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

inSubnetEdit
required

In Subnet Edit

string

Query

length
required

Ending Subnet Template Range

integer(int32)

Query

order
optional

Sorting Order(asc/desc)

string

Query

org_id
optional

Organization Id

integer(int32)

Query

org_name
required

Organization Name

string

Query

q
required

Match Value

string

Query

sort
optional

Sorting String

string

Query

start
required

Starting Subnet Template Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListSubnet Template

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist:<Organization Name>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.127.8. List Subnet Template Search elements

GET /subnet_template/search
Description

Returns a list of subnet template searched by User in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/subnet_template/search?start=1&length=20

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organization Names

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Subnet_Template Object Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListSubnet Template

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.128. Switch Discovery Details Service

Description

This service provides APIs to get the discovery results of Switch such as Switch information, Devices, Vlans, Duplex and Ports.

4.128.1. Deletes switch results

POST /daswitch/deleteSwitches
Description

This service call deletes switch information.
Below example shows sample request JSON:
[ "10.0.0.3"]

Parameters
Type Name Description Schema Default

Body

body
required

Array of switch IP addresses

< string > array

Responses
HTTP Code Description Schema

500

TIMS-3501: Unable to retrieve the discovery commands list.

No Content

Consumes
  • application/json

4.128.2. Element Details

GET /daswitch/elementpage
Description

Lists all the elements discovered for the selected switch in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/daswitch/elementpage?switchIP=10.0.0.2&cmdId=TDCE_20220422123start=1&length=20&switchIP=20.0.0.3

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command Id

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Switch Element Range

integer(int32)

Query

switchIP
required

Switch IPAddress

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListSwitch Element Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.128.3. Interface Details

GET /daswitch/interfacepage
Description

Lists all the interfaces discovered for the selected switch in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/daswitch/interfacepage?switchIP=10.0.0.2&cmdId=TDCE_20220422123start=1&length=20&switchIP=20.0.0.3

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command Id

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Port Range

integer(int32)

Query

switchIP
required

Switch IPAddress

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListPort Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.128.4. Element Details

GET /daswitch/switchDetailsByElementIp
Description

Get the switch details for the selected switch element in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/daswitch/switchDetailsByElementIp?switchIP=10.0.0.3

Parameters
Type Name Description Schema Default

Query

elementIp
required

Switch Element IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

< Switch Details > array

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.128.5. Switch Details

GET /daswitch/switchdetails
Description

Gets the switch details for a switch discovered in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/daswitch/switchdetails?switchIP=10.0.0.2&cmdId=TDCE_20220422123&start=1&length=20&switchIP=20.0.0.3

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command ID

string

Query

switchIP
required

Switch IP

string

Responses
HTTP Code Description Schema

200

successful operation

Switch Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.128.6. Switch Details

GET /daswitch/switchpage
Description

Lists all the switches discovered in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/daswitch/switchpage?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Switch Discovery Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListSwitch Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.128.7. Element Details

GET /daswitch/vlan/subnetelementpage
Description

Lists all the vlan subnet elements discovered for the selected switch in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/daswitch/vlan/subnetelementpage?start=1&length=20&switchIP=20.0.0.3&cmdId=TDCE_2022040412&subnet_ip=10.0.0.0&mask=8

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command Id

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

mask
required

Subnet Mask

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Switch Element Range

integer(int32)

Query

subnet_ip
required

Subnet IPAddress

string

Query

switchIP
required

Switch IPAddress

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListSwitch VLAN Subnet Element Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.128.8. Vlan Details

GET /daswitch/vlanpage
Description

Lists all the vlans discovered for the selected switch in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/daswitch/vlanpage?switchIP=10.0.0.2&cmdId=TDCE_20220422123&start=1&length=20

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command Id

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting VLAN Range

integer(int32)

Query

switchIP
required

Switch IPAddress

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListVlan Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.128.9. Vlan Details

GET /daswitch/vlansubnet
Description

Lists all the vlans discovered for the selected switch in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/daswitch/vlansubnet?switchIP=10.0.0.2&cmdId=TDCE_20220422123&start=1&length=20

Parameters
Type Name Description Schema Default

Query

cmdId
required

Command Id

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting VLAN Subnet Range

integer(int32)

Query

switchIP
required

Switch IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListVlan Subnet Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.128.10. Deletes switch results

POST /switchdisco/deleteSwitches
Description

This service call deletes switch information.
Below example shows sample request JSON:
[ "10.0.0.3"]

Parameters
Type Name Description Schema Default

Body

body
required

Array of switch IP addresses

< string > array

Responses
HTTP Code Description Schema

500

TIMS-3501: Unable to retrieve the discovery commands list.

No Content

Consumes
  • application/json

4.128.11. Element Details

GET /switchdisco/elementpage
Description

Lists all the elements discovered for the selected switch in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/switchdisco/elementpage?start=1&length=20&switchIP=20.0.0.3

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Switch Element Range

integer(int32)

Query

switchIP
required

Switch IPAddress

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListSwitch Element Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.128.12. Interface Details

GET /switchdisco/interfacepage
Description

Lists all the interfaces discovered for the selected switch in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/switchdisco/interfacepage?start=1&length=20&switchIP=20.0.0.3

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Port Range

integer(int32)

Query

switchIP
required

Switch IPAddress

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListPort Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.128.13. Switch Details

GET /switchdisco/switchdetails
Description

Gets the switch details for a switch discovered in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/switchdisco/switchdetails?switchIP=10.0.0.3

Parameters
Type Name Description Schema Default

Query

switchIP
required

Switch IP

string

Responses
HTTP Code Description Schema

200

successful operation

Switch Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.128.14. Switch Details

GET /switchdisco/switchpage
Description

Lists all the switches discovered in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/switchdisco/switchpage?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Switch Discovery Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListSwitch Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.128.15. Vlan Details

GET /switchdisco/vlanpage
Description

Lists all the vlans discovered for the selected switch in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/switchdisco/vlanpage?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting VLAN Range

integer(int32)

Query

switchIP
required

Switch IPAddress

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListVlan Details

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.129. Template Service

Description

This service provides API's to get list of Templates present in the TCPWave IPAM, add Templates, update Templates, delete Templates, search for a Template in the TCPWave IPAM.

4.129.1. Template Create

POST /templates/create
Description

Create a new Template in the TCPWave IPAM and performs a sanity check to make sure that the parameters defined in the template have valid values in it Failing which, the update will be discarded by the TCPWave IPAM. On success, An incremental update is sent to all the DHCP Appliances that are governed with this policy template.
Below example shows sample request JSON:
{"template_name":"qa-zone-template","description":"","entity_type_code":"ZONE","server_type_code":"GENERICDNS","organization_name":"QAOrg","array_templates":[{"param_name":"email-addr","value":"[email protected]"},{"param_name":"default-ttl","numeric_value":"1200"},{"param_name":"refresh","numeric_value":"21600"},{"param_name":"retry","numeric_value":"3600"},{"param_name":"expire","numeric_value":"604800"},{"param_name":"negative-cache-ttl","numeric_value":"86400"},{"param_name":"serial","value":"DATE"},{"param_name":"allow-notify","aclList":[{"exclude":"0","value":"10.1.10.87","sequence":1}]},{"param_name":"allow-query","aclList":null},{"param_name":"also-notify","aclList":null},{"param_name":"allow-transfer","aclList":null},{"param_name":"allow-update","aclList":null},{"param_name":"master-dns-servers","value":"10.1.10.87,"},{"param_name":"slave-dns-servers","value":""},{"param_name":"customAcls","value":""},{"param_name":"windows_dns_servers","value":"10.1.1.1,"}]}

Parameters
Type Name Description Schema Default

Body

body
required

Template details

Template

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-5001: Template already exists, TIMS-5002: Template name already exists in DNS Option Templates, TIMS-5003: Template name already exists in DHCP Option Templates, TIMS-5004: Template name already exists in DNS Zone Templates, TIMS-5005: Template name already exists in DHCP Policy Templates, TIMS-7003: You are not authorized to perform this operation, TIMS-5011: Parameter does not exist: <Given Parameter Name>, TIMS-2005: ACL is not valid : <Given ACL Name> for option param: <Given Parameter Name>

No Content

Consumes
  • application/json

  • application/xml

4.129.2. Delete DHCP Option and Policy Templates

DELETE /templates/delete/dhcpTmpl
Description

Checks the Option Templates/Policy Templates by performing referential integrity checks and deletes the templates that are not associated with any subnet or appliance.
Below example shows sample request JSON:
[{ "organization_name":"QAOrg1","entity_type_code":"POLICY","template_name":"pol"}]

Parameters
Type Name Description Schema Default

Body

body
required

List of DHCP templates details

< Template > array

Responses
HTTP Code Description Schema

200

successful operation

< Template References Information > array

500

TIMS-1352: Cannot find organization: <organization name>, TIMS-7003: You are not authorized to perform this operation, TIMS-5020: Template does not exist:<Template Name>, TIMS-5012: Default template cannot be deleted: <Template Name>, TIMS-5015: Template delete failed as one or more Appliances are using this template, TIMS-5016: Template delete failed as one or more zones are using this template, TIMS-5017: Template delete failed as one or more subnets are using this template, TIMS-5018: Template delete failed as one or more scopes are using this template, TIMS-5019: Template delete failed as one or more DHCP objects are using this template.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.129.3. Zone Template Delete

POST /templates/delete/names
Description

Deletes an existing Zone or Option Template in the TCPWave IPAM. Functional Admin can delete a Zone or Option Template for any organization. Rest of the admins can delete a Zone or Option Template only for the organizations that they are associated with.
Below example shows sample request JSON:
[{"template_name":"qa-zone-template1","organization_name":"QAOrg"}]

Parameters
Type Name Description Schema Default

Body

body
optional

< Template > array

Responses
HTTP Code Description Schema

500

TIMS-1352: Cannot find organization: <organization name>, TIMS-7003: You are not authorized to perform this operation, TIMS-5020: Template does not exist:<Template Name>, TIMS-5012: Default template cannot be deleted: <Template Name>, TIMS-5015: Template delete failed as one or more Appliances are using this template, TIMS-5016: Template delete failed as one or more zones are using this template, TIMS-5017: Template delete failed as one or more subnets are using this template, TIMS-5018: Template delete failed as one or more scopes are using this template, TIMS-5019: Template delete failed as one or more DHCP objects are using this template.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.129.4. DHCP Option Template Update

POST /templates/dhcp-option-template-update
Description

Updates a DHCP Option Template and performs a sanity check to make sure that the options defined in the template have valid values in it Failing which, the update will be discarded by the TCPWave IPAM. On success, An incremental update is sent to all the DHCP Appliances that have scopes and Manual DHCP Objects associated to the template.
Below example shows sample request JSON:
{ "template_name": "dhcp_pol_temp", "old_template_name": "dhcp_pol", "description": "", "entity_type_code": "POLICY", "server_type_code": "DHCP", "array_params": [{"param_name": "default-lease-time", "value": 3600, "data_type": "STRING","group_name":"standard option"}], "organization_name": "QAOrg" }

Parameters
Type Name Description Schema Default

Body

body
required

DHCP option template details

Template

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-7003: You are not authorized to perform this operation, TIMS-5028: Template does not exist, TIMS-2005: ACL is not valid : <Given ACL Name> for option param: <Given Parameter Name>, TIMS-5001: Template already exists, TIMS-5011: Parameter does not exist: <Given Parameter Name>, TIMS-5021: Template is not updated as there are subnets using this template with different subnet mask, TIMS-5022: The option router is not removed from the template as it is associated with one or more subnets, TIMS-5023: Template is not updated as there are subnets which use this template that do not have a primary router, TIMS-5024: Template is not updated as it is associated with a subnet and the option router does not belong to the corresponding subnet, TIMS-5026: Template is not updated as there is no router defined with the address: <New Router Value>

No Content

Consumes
  • application/json

  • application/xml

4.129.5. DHCP Policy Template Update

POST /templates/dhcp-policy-template-update
Description

Updates a DHCP Policy Template and performs a sanity check to make sure that the parameters defined in the template have valid values in it Failing which, the update will be discarded by the TCPWave IPAM. On success, An incremental update is sent to all the DHCP Appliances that are governed with this policy template.
Below example shows sample request JSON:
{"template_name":"Test Policy","old_template_name":"Test Policy","description":"","entity_type_code":"POLICY","server_type_code":"DHCP","array_templates":[{"param_name":"default-lease-time","value":"3600","data_type":"STRING"}],"updated_by":"22290","organization_name":"Internal"}

Parameters
Type Name Description Schema Default

Body

body
required

DHCP policy template details

Template

Responses
HTTP Code Description Schema

500

TIMS-5011: Parameter does not exist: <Parameter Name>, TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-5020: Template does not exist:<Template Name>, TIMS-1020: Both Organization name and id cannot be null, TIMS-7003: You are not authorized to perform this operation, TIMS-5001: Template already exists, TIMS-5002: Template name already exists in DNS Option Templates, TIMS-5003: Template name already exists in DHCP Option Templates, TIMS-5004: Template name already exists in DNS Zone Templates, TIMS-5005: Template name already exists in DHCP Policy Templates, TIMS-5028: Template does not exist, TIMS-2005: ACL is not valid : <Given ACL Name> for option param: <Given Parameter Name>, TIMS-5011: Parameter does not exist: <Given Parameter Name>, TIMS-1422: Zone does not exist:<Zone Name>, TIMS-3088: Appliance IP address is null, TIMS-3090: Both Appliance id and name cannot be null, TIMS-3092: Appliance does not exist.

No Content

Consumes
  • application/json

  • application/xml

4.129.6. Add DHCP Option and Policy Templates

POST /templates/dhcp-template-create
Description

Creates a DHCP Option/Policy Template by performing a sanity check on parameters configured in the template.
Below example shows sample request JSON:
{"template_name":"option-temp","description":"","entity_type_code":"OPTION","server_type_code":"DHCP","array_params":[{"display_name":"Subnet Mask (1)","value":"Same as in subnet profile","group_name":"standard option"},{"display_name":"Router (3)","value":"Same as in subnet profile","group_name":"standard option"},{"display_name":"Domain Name (15)","value":"Same as the primary domain in subnet profile","group_name":"standard option"}],"organization_name":"QAOrg"}

Parameters
Type Name Description Schema Default

Body

body
required

DHCP template details

Template

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-7003: You are not authorized to perform this operation, TIMS-5001: Template already exists, TIMS-5011: Parameter does not exist: <Given Parameter Name>

No Content

Consumes
  • application/json

  • application/xml

4.129.7. DNS Template List

GET /templates/dnstemplatelist
Description

Provides the list of all Zone Templates or Option Templates for the given Entity type defined in the TCPWave IPAM. Functional Admin can view the list of all Zone templates or Option Templates for the given Entity type in any organization. The other Admins can view only the list all the Zone templates or Option Templates for the given Entity type associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/templates/dnstemplatelist

Parameters
Type Name Description Schema Default

Query

entity_type_code
required

Entity Type Code

string

Query

inEdit
optional

In Edit

integer(int32)

Query

organizations
optional

Organization List

string

Responses
HTTP Code Description Schema

200

successful operation

< Template > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.129.8. Zone Template Parameter List

GET /templates/getZoneTemplateDetails
Description

Lists all the parameters and their values for the given Zone Template in the TCPWave IPAM. Functional Admin can list parameters and their values for the given Zone Template in any organization. Rest of the Admins gets this provision for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/templates/getZoneTemplateDetails?organization_name=Internal&template_name=testTemplate

Parameters
Type Name Description Schema Default

Query

organization_id
optional

Organization Id

integer(int32)

Query

organization_name
required

Organization Name

string

Query

template_name
required

Template Name

string

Responses
HTTP Code Description Schema

200

successful operation

Template information

500

TIMS-1352: Cannot find organization: <organization name>, TIMS-1020: Both Organization name and id cannot be null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.129.9. Template List all params

GET /templates/list-all/params
Description

Provides a list of DHCP Options configured in a given Option Template as well as all the DHCP Options supported by the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/templates/list-all/params?template_name=testTemplate&server_type=DNS&entity_type=OPTION&organization_name=Internal

Parameters
Type Name Description Schema Default

Query

entity_type
required

Entity Type

string

Query

organization_name
required

Organization Name

string

Query

server_type
required

Appliance Type

string

Query

template_id
required

Template Id

integer(int32)

Query

template_name
required

Template Name

string

Responses
HTTP Code Description Schema

200

successful operation

Template

500

TIMS-5031: Both template name and id cannot be null, TIMS-5041: Template does not exist with name=<Given Template Name>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.129.10. User Defined DHCP Options List

GET /templates/list-custom-defined-params
Description

Provides a list of all the Custom DHCP Options (Option 128 - 253) defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/templates/list-custom-defined-params?template_name=testTemplate&server_type=DNS&entity_type=OPTION&organization_name=Internal

Parameters
Type Name Description Schema Default

Query

template_id
required

Template Id

integer(int32)

Query

template_name
required

Template Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Parameters Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.129.11. Template List Data Types

GET /templates/list-datatypes
Description

Lists the Data Types for the given Template in the TCPWave IPAM. Functional Admin can list Data Types of a Template in any organization. Rest of the Admins gets this provision for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/templates/list-datatypes?datatype_flag=

Parameters
Type Name Description Schema Default

Query

datatype_flag
required

Data Type

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< Data Types > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.129.12. DHCP Sub Options List

GET /templates/list-template-option-spaces
Description

Provides a list of all the DHCP sub options defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/templates/list-template-option-spaces?template_name=templateName

Parameters
Type Name Description Schema Default

Query

template_id
required

Template Id

integer(int32)

Query

template_name
required

Template Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Parameters Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.129.13. Option Template DNS Params List

GET /templates/list/dnsTemplateInfo
Description

Lists all the Option Template parameters and their values for the given Appliance type (BIND AUTH or BIND CACHE or UNBOUND or DNS Proxy) in the TCPWave IPAM. Functional Admin can list all the params for the given DNS Appliance type for any organization. Rest of the admins can list params for the given DNS Appliance type only for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/templates/list/dnsTemplateInfo?template_id=1234&template_name=testTemplate&entity_type_code=OPTION&server_type_code=1274&organization_name=Internal

Parameters
Type Name Description Schema Default

Query

entity_type_code
required

string

Query

organization_id
optional

Organization Id

integer(int32)

Query

organization_name
required

Organization Name

string

Query

server_type_code
required

Appliance Type Code

string

Query

template_id
required

Id of the template

integer(int32)

Query

template_name
required

Name of the template

string

Responses
HTTP Code Description Schema

200

successful operation

Template information

500

TIMS-7003: You are not authorized to perform this operation, TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-5040: Template does not exist with name=<Given Template Name> and Appliance Type=<Given Appliance Type>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.129.14. Option Template DNS Params List

GET /templates/list/dnsparams
Description

Lists all the Option Template parameters and their values for the given Appliance type (BIND AUTH or BIND CACHE or UNBOUND or DNS Proxy) in the TCPWave IPAM. Functional Admin can list all the params for the given DNS Appliance type for any organization. Rest of the admins can list the params for the given DNS Appliance type only for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/templates/list/dnsparams?template_id=1234&template_name=testTemplate&entity_type_code=OPTION&server_type_code=1274&organization_name=Internal

Parameters
Type Name Description Schema Default

Query

entity_type_code
required

string

Query

organization_id
optional

Organization Id

integer(int32)

Query

organization_name
required

Organization Name

string

Query

server_type_code
required

Appliance Type Code

string

Query

template_id
required

Id of the Template

integer(int32)

Query

template_name
required

Name of the Template

string

Responses
HTTP Code Description Schema

200

successful operation

< Template > array

500

TIMS-7003: You are not authorized to perform this operation, TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-5040: Template does not exist with name=<Given Template Name> and Appliance Type=<Given Appliance Type>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.129.15. Option Template NSD Params List

GET /templates/list/nsdparams
Description

Lists all the Option Template parameters and their values for the NSD Appliance type in the TCPWave IPAM. Functional Admin can list all the params for the NSD Appliance for any organization. Rest of the admins can list the params for the NSD Appliance only for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/templates/list/nsdparams?template_id=1234&template_name=testTemplate&entity_type_code=OPTION&server_type_code=1274&organization_name=Internal

Parameters
Type Name Description Schema Default

Query

entity_type_code
required

string

Query

organization_id
optional

Organization ID

integer(int32)

Query

organization_name
required

Organization Name

string

Query

server_type_code
required

Appliance Type Code

string

Query

template_id
required

Id of the Template

integer(int32)

Query

template_name
required

Name of the Template

string

Responses
HTTP Code Description Schema

200

successful operation

< Template > array

500

TIMS-7003: You are not authorized to perform this operation, TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-5040: Template does not exist with name=<Given Template Name> and Appliance Type=<Given Appliance Type>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.129.16. Option Template NSD Params List

GET /templates/list/nsdparamsinfo
Description

Lists all the Option Template parameters and their values for the NSD Appliance type in the TCPWave IPAM. Functional Admin can list all the params for the NSD Appliance for any organization. Rest of the admins can list the params for the NSD Appliance only for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/templates/list/nsdparamsinfo?template_id=1234&template_name=testTemplate&entity_type_code=OPTION&server_type_code=1274&organization_name=Internal

Parameters
Type Name Description Schema Default

Query

entity_type_code
required

string

Query

organization_id
optional

Organization ID

integer(int32)

Query

organization_name
required

Organization Name

string

Query

server_type_code
required

Appliance Type Code

string

Query

template_id
required

Id of the Template

integer(int32)

Query

template_name
required

Name of the Template

string

Responses
HTTP Code Description Schema

200

successful operation

Template information

500

TIMS-7003: You are not authorized to perform this operation, TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-5040: Template does not exist with name=<Given Template Name> and Appliance Type=<Given Appliance Type>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.129.17. DHCP Options Template List Params

GET /templates/list/params/{server_type}/{entity_type}
Description

Provides a list of all the DHCP Options supported by the TCPWave IPAM to create a DHCP Option Template.
The example listed below shows a sample request URL:
/rest/templates/list/params/DNS%20PROXY/OPTION

Parameters
Type Name Description Schema Default

Path

entity_type
required

Entity Type

string

Path

server_type
required

Appliance Type

string

Responses
HTTP Code Description Schema

200

successful operation

< Parameters Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.129.18. Template Params List By Name

GET /templates/list/paramsbyname/{template_name}
Description

Provides a list of DHCP Options configured in a given Option Template as well as all the DHCP Options supported by the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/templates/list/paramsbyname/testTemplate

Parameters
Type Name Description Schema Default

Path

template_name
required

Template Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Parameters Information > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.129.19. Template List

GET /templates/list/{server_type_code}/{entity_type_code}
Description

Lists all the Templates for the given Appliance type code and Entity type code in the TCPWave IPAM. Functional Admin can list Templates in any organization. Rest of the Admins gets this provision for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/templates/list/DNS%20PROXY/OPTION?start=1&length=20&organizations=Internal

Parameters
Type Name Description Schema Default

Path

entity_type_code
required

Entity Type Code

string

Path

server_type_code
required

Appliance Type Code

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organizations

string

Query

reference_id
optional

Reference Id

integer(int32)

Query

reference_type
required

Reference Type

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Template Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListTemplate

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

  • application/json

Produces
  • application/json

  • application/xml

4.129.20. Template List DNS Appliances

GET /templates/listdnsservers
Description

Lists all the DNS Appliances for the given Entity type and organization in the TCPWave IPAM. Functional Admin can list DNS Appliances for the given organization in any organization. Rest of the Admins gets this provision for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/templates/listdnsservers

Parameters
Type Name Description Schema Default

Query

organization_id
optional

Organization Id

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< Server Information > array

500

TIMS-1352: Organization does not exist: <Given Organization Name>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.129.21. Template List IPv6 DNS Appliances

GET /templates/listipv6dnsservers
Description

Lists all the IPv6 DNS Appliances for the given Entity type and organization in the TCPWave IPAM. Functional Admin can list IPv6 DNS Appliances for the given organization in any organization. Rest of the Admins gets this provision for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/templates/listipv6dnsservers

Parameters
Type Name Description Schema Default

Query

organization_id
optional

Organization Id

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< Server Information > array

500

TIMS-1352: Organization does not exist: <Given Organization Name>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.129.22. Template Page

GET /templates/page/{server_type_code}/{entity_type_code}
Description

Lists all the Templates with pagination for the given Appliance type code and Entity type code associated with an organization in the TCPWave IPAM. Functional Admin can list the Templates for any organization. Rest of the admins can list the Templates only for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/templates/page/DNS%20PROXY/OPTION?start=1&length=20&organization_name=Internal&inEdit=

Parameters
Type Name Description Schema Default

Path

entity_type_code
required

Entity Type Code

string

Path

server_type_code
required

Appliance Type Code

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

inEdit
required

In Edit

integer(int32)

Query

length
required

Page Length

integer(int32)

Query

organization_name
required

Organization Name

string

Query

q
optional

Match Value

string

Query

reference_id
optional

Reference Id

integer(int32)

Query

reference_type
required

Reference Type

string

Query

start
required

Starting Template Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListTemplate Selection Data

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.129.23. Template Search

GET /templates/params-name/search
Description

Searches for a given Template in the TCPWave IPAM based on a full text input.
The example listed below shows a sample request URL:
/rest/templates/params-name/search?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Template Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListTemplate

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.129.24. Template Search

GET /templates/params-value/search
Description

Searches for a given Template in the TCPWave IPAM based on a full text input.
The example listed below shows a sample request URL:
/rest/templates/params-value/search?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Template Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListTemplate

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.129.25. Find DHCP Option Template References

GET /templates/references
Description

Obtains a list of DHCP Option Template reference in TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/templates/references?tables=tableName

Parameters
Type Name Description Schema Default

Query

count
optional

Count Flag

string

Query

id
optional

Reference Id

string

Query

page
optional

Page Number

integer(int32)

Query

rows
optional

Number of rows

integer(int32)

Query

tables
required

Table

string

Responses
HTTP Code Description Schema

200

successful operation

Reference Results

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.129.26. Template Search

GET /templates/search
Description

Searches for a given Template in the TCPWave IPAM based on a full text input.
The example listed below shows a sample request URL:
/rest/templates/search?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
required

Organization List

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Template Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListTemplate

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.129.27. Zone Template Update

POST /templates/update
Description

Updates an existing Template in the TCPWave IPAM and performs a sanity check to make sure that the parameters defined in the template have valid values in it Failing which, the update will be discarded by the TCPWave IPAM. On success, An incremental update is sent to all the DHCP Appliances that are governed with this policy template.
Below example shows sample request JSON:
{"template_name":"qa-zone-template1","old_template_name":"qa-zone-template","description":"","customAcls":"","entity_type_code":"ZONE","server_type_code":"GENERICDNS","organization_name":"QAOrg","array_templates":[{"param_name":"email-addr","value":"[email protected]"},{"param_name":"default-ttl","numeric_value":"1200"},{"param_name":"refresh","numeric_value":"21600"},{"param_name":"retry","numeric_value":"3600"},{"param_name":"expire","numeric_value":"604800"},{"param_name":"negative-cache-ttl","numeric_value":"86400"},{"param_name":"serial","value":"DATE"},{"param_name":"allow-notify","aclList":[{"exclude":"0","value":"10.1.10.87","sequence":1}]},{"param_name":"allow-query","aclList":null},{"param_name":"also-notify","aclList":null},{"param_name":"allow-transfer","aclList":null},{"param_name":"allow-update","aclList":null},{"param_name":"master-dns-servers","value":"10.1.10.87,"},{"param_name":"slave-dns-servers","value":""}]}

Parameters
Type Name Description Schema Default

Body

body
optional

Template

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-5020: Template does not exist:<Template Name>, TIMS-1020: Both Organization name and id cannot be null, TIMS-7003: You are not authorized to perform this operation, TIMS-5001: Template already exists, TIMS-5002: Template name already exists in DNS Option Templates, TIMS-5003: Template name already exists in DHCP Option Templates, TIMS-5004: Template name already exists in DNS Zone Templates, TIMS-5005: Template name already exists in DHCP Policy Templates, TIMS-5028: Template does not exist, TIMS-2005: ACL is not valid : <Given ACL Name> for option param: <Given Parameter Name>, TIMS-5011: Parameter does not exist: <Given Parameter Name>, TIMS-1422: Zone does not exist:<Zone Name>, TIMS-3088: Appliance IP address is null, TIMS-3090: Both Appliance id and name cannot be null, TIMS-3092: Appliance does not exist.

No Content

Consumes
  • application/json

  • application/xml

4.129.28. Zone Template Parameter List

GET /templates/zoneparams
Description

Lists all the parameters and their values for the given Zone Template in the TCPWave IPAM. Functional Admin can list parameters and their values for the given Zone Template in any organization. Rest of the Admins gets this provision for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/templates/zoneparams?organization_name=Internal

Parameters
Type Name Description Schema Default

Query

organization_id
optional

Organization Id

integer(int32)

Query

organization_name
required

Organization Name

string

Query

template_name
required

Template Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Template > array

500

TIMS-1352: Cannot find organization: <organization name>, TIMS-1020: Both Organization name and id cannot be null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.130. Threat Intelligent Widget Service

4.130.1. Get Anomaly detection data

GET /threatIntell/widget/getAnomalyAlerts
Responses
HTTP Code Description Schema

200

successful operation

< AnomalyDetectedAlerts > array

500

TIMS-1351: User Id cannot be null.

No Content

Produces
  • application/json

  • application/xml

4.130.2. Get Intrusion Prevention data

GET /threatIntell/widget/getIntrusionAlerts
Responses
HTTP Code Description Schema

200

successful operation

< IntrusionPreventionAlerts > array

500

TIMS-1351: User Id cannot be null.

No Content

Produces
  • application/json

  • application/xml

4.131. Time Zone Service

4.131.1. Time Zone of the Server

GET /timezone/getTimeZone
Description

Gets the time zone of a specified server in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/timezone/getTimeZone

Responses
HTTP Code Description Schema

200

successful operation

string

500

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.131.2. Get list of all Time Zones

GET /timezone/list
Description

Returns a list of various time zones provided in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/timezone/list

Responses
HTTP Code Description Schema

200

successful operation

< Time Zone > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.132. UndoData Service

Description

This service provides the API to list the contents of the recycle bin and restore in TCPWave IPAM. The recycle bin contents are the deleted network elements.

4.132.1. UndoData List

GET /undo/list
Description

Lists all the network elements in the recycle bin that can be restored.
The example listed below shows a sample request URL:
/rest/undo/list?start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting UndoData Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListUndo Data

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.132.2. UndoData Purge

POST /undo/purge
Description

Purges a network element from the recycle bin.
Below example shows sample request JSON:
Ex.1: [{"type":"subnet","key":"10.0.0.0/16","organization_name":"JOrg","description":"IPV4 Subnet","operation":"delete"}]
Ex.2: [{"type":"object","key":"10.0.0.6","organization_name":"JOrg","description":"Azure00016Instance.111.com","operation":"delete"},{"type":"object","key":"10.0.0.5","organization_name":"JOrg","description":"Domain00021Controller.111.com","operation":"add"}]

Parameters
Type Name Description Schema Default

Body

body
required

List of undo data

< Undo Data > array

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.132.3. UndoData Purge

POST /undo/purgeAll
Description

Purges all the network elements from the recycle bin.
Below example shows sample request JSON:
/tims/rest/undo/purgeAll

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.132.4. UndoData Restore

POST /undo/restore
Description

Restores a network element from the recycle bin.
Below example shows sample request JSON:

Parameters
Type Name Description Schema Default

Body

body
required

List of undo data

< Undo Data > array

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1266: Cannot find the DHCP class for the name. TIMS-3025: Resource Records already exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.133. User Certificate Service

4.133.1. User Cert Delete

POST /user_cert/delete
Description

Delete the current user SSL/TLS certificate in the TCPWave IPAM.
Below example shows sample request JSON:
"string"

Parameters
Type Name Description Schema Default

Body

body
required

User certificate serial number

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

Produces
  • application/json

  • application/xml

4.133.2. Get User ID

GET /user_cert/get_user
Description

Retrieve the list of user SSL/TLS certificates associated with the current user in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/user_cert/get_user

Parameters
Type Name Description Schema Default

Query

serialNum
required

User certificate serial number

string

Responses
HTTP Code Description Schema

200

successful operation

integer(int32)

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.133.3. User Cert Import

POST /user_cert/import
Description

Import the current user SSL/TLS certificate in the TCPWave IPAM. User certificates enables remote REST API access for the associated user in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/user_cert/import?cfile=cfileNametest&user=15

Parameters
Type Name Description Schema Default

Query

cfile
required

User certificate file name

string

Query

user
required

Database Id of the associated user

integer(int32)

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.133.4. User Cert List

GET /user_cert/list
Description

Retrieve the list of user SSL/TLS certificates used for accessing REST API in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/user_cert/list

Responses
HTTP Code Description Schema

200

successful operation

< User Certificate > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.133.5. User List

GET /user_cert/userlist
Description

Retrieve the list of users associated with the current user SSL/TLS certificate in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/user_cert/userlist

Responses
HTTP Code Description Schema

200

successful operation

< User > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.134. User Service

Description

This service provides the API to manage the Admins in the TCPWave IPAM. It provides interfaces to list, create, modify and delete admins, and manage their permissions, and passwords.

4.134.1. Admin Add

POST /user/add
Description

Creates a new admin. Functional Admin can create an admin in any organization. Only Functional Admin can create an admin with Functional Admin role. Super Admin and User Admin can create admins in the organization that they belong to.
Below example shows sample request JSON:
{ "first_name":"system","middle_name":"","last_name":"Internal","phone_num":"456423","login_name":"sysadmin","organization_name":"Internal","password":"Zxcv1234","roles_code":"NADM","email_id":"{"name":"default","description":"default[admin@tcpwave.com","admin_groups":[{"name":"default","description":"default group of admins","organization_name":"Internal"}],"isAdmin":true}

Parameters
Type Name Description Schema Default

Body

body
optional

User

Responses
HTTP Code Description Schema

500

TIMS-1020: Both organization name and id cannot be null, TIMS-1021: Invalid Organization name specified, TIMS-1023: User Already Exists, TIMS-1023: login name specified already exists, TIMS-1022: Invalid Admin role specified

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.134.2. Admin List

GET /user/admin/list
Description

Obtains a List of all Admin
The example listed below shows a sample request URL:
/rest/user/admin/list

Responses
HTTP Code Description Schema

200

successful operation

< User > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.134.3. Admin Group List

GET /user/admingroup/list
Description

Obtains a List of all Admin Groups except FADM’s and UADM’s Groups
Below example shows sample request URL:
/rest/user/admingroup/list

Responses
HTTP Code Description Schema

200

successful operation

< Admin Group > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.134.4. Map of Admin Hierarchy

GET /user/adminhierarchymap
Description

Returns the hierarchy as a JSON string for the TCPWave IPAM GUI consumption.
The example listed below shows a sample request URL:
/rest/hierarchy/map

Parameters
Type Name Description Schema Default

Query

login_name
optional

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • text/plain

4.134.5. Update Change Ticket

POST /user/change_ticket
Description

Updates the change ticket associated .
Below example shows sample request JSON:
"string"

Parameters
Type Name Description Schema Default

Body

body
optional

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.134.6. Get Change Ticket

GET /user/change_ticket
Description

Gets the current session’s change ticket.
The example listed below shows a sample request URL:
/rest/user/change_ticket

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.134.7. Admin Clone

POST /user/clone
Description

Clone the specified admin. A new Admin is created with the login name and with the same permissions as the admin cloning from, into the same organization, with the same role, and will be associated with the same admin groups.
Below example shows sample request JSON:
{"first_name":"tom","last_name":"k","email_id":"],"roles_name":"Power["tom@tcp.com","organization_name":"QAOrg","isAdmin":true,"login_name":"tom","roles_code":"PADM","password_expired":true,"account_locked":false,"failed_attempts":0,"admin_groups":[],"roles_name":"Power" Admin","middle_name":"","phone_num":"","password":"Abc123"}

Parameters
Type Name Description Schema Default

Query

cemail_id
optional

Required User’s Id to Clone

string

Query

cfirst_name
optional

Required User’s Id to Clone

string

Query

clast_name
optional

Required User’s Id to Clone

string

Query

cmiddle_name
optional

Required User’s Id to Clone

string

Query

user_id
optional

Required User’s Id to Clone

integer(int32)

Body

body
optional

User

Responses
HTTP Code Description Schema

500

TIMS-3004: Invalid user id specified, TIMS-1023: User Already Exists, TIMS-1023: login name specified already exists.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.134.8. Admin Delete

POST /user/delete
Description

Deletes an existing admin. Functional Admin can delete an admin in any organization. Only Functional Admin can create an admin with Functional Admin role. Super Admin and User Admin can delete admins in the organization, they belong to.
The example listed below shows a sample request URL:
/rest/user/delete?first_name=John&last_name=Doe&middle_name=&email_id=[email protected]&org_name=Internal

Parameters
Type Name Description Schema Default

Query

email_id
required

User’s Email ID

string

Query

first_name
required

User’s First Name

string

Query

id
optional

User ID

integer(int32)

Query

last_name
required

User’s Last Name

string

Query

middle_name
required

User’s Middle Name

string

Query

org_name
required

Organization Name

string

Responses
HTTP Code Description Schema

500

TIMS-3002: first_name, last_name, or email_id cannot be null, TIMS-3003: cannot find the specified user, TIMS-3004: Invalid user id specified.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.134.9. Admin Delete

POST /user/deleteLogin
Description

Deletes an existing admin by login name. Functional Admin can delete an admin in any organization. Only Functional Admin can create an admin with Functional Admin role. Super Admin and User Admin can delete admins in the organization, they belong to.
The example listed below shows a sample request URL:
/rest/user/deleteLogin?login_name=admin

Parameters
Type Name Description Schema Default

Query

login_name
required

User’s Login Name

string

Responses
HTTP Code Description Schema

500

TIMS-4010: Invalid login name specified.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.134.10. Admin Update

POST /user/edit
Description

Updates an existing user details in the TCPWave IPAM.
Below example shows sample request JSON:
{"first_name":"system-1","last_name":"Internal","email_id":""admin@tcpwave.com","phone_num":"4564231","organization_name":"Internal","isAdmin":true,"login_name":"sysadmin","roles_code":"UADM","password_expired":false,"account_locked":false,"failed_attempts":0,"admin_groups":[{"name":"default","description":"default" group of admins","organization_name":"Internal"}],"roles_name":"Normal Admin","new_is_admin":true,"new_first_name":"system1","new_middle_name":"","new_last_name":"Internal","new_email_id":""admin@tcpwave.com","new_login_name":"system_admin""}

Parameters
Type Name Description Schema Default

Body

body
optional

User

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-1026: User already exists, TIMS-4005: User id is not valid, TIMS-4006: first_name, last_name, or email_id cannot be null, TIMS-4007: User does not exist, TIMS-1020: Both Organization name and id cannot be null.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.134.11. Admin Details

GET /user/get
Description

Get the details of the specified admin. List all the admins belonging to an organization. For FADM, if the organization is not specified, all the admins in the system are listed. If a group is specified, only the admins belonging to that groups are listed. FADM has visibility across all organizations and other admins are restricted to the organization that they belong to and will get a permission violation error when tried to get the list of admins from other organizations.
The example listed below shows a sample request URL:
/rest/user/get?first_name=testfname&middle_name=testmidname&last_name=lname&email=[email protected]

Parameters
Type Name Description Schema Default

Query

email_id
required

Admin’s Email ID

string

Query

first_name
required

Admin’s First Name

string

Query

id
optional

Admin ID

integer(int32)

Query

last_name
required

Admin’s Last Name

string

Query

middle_name
required

Admin’s Middle Name

string

Responses
HTTP Code Description Schema

200

successful operation

User

500

TIMS-1101: Cannot find organization, TIMS-1141: Cannot find admin group.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.134.12. Internal User Information

GET /user/getInternalUser
Description

Provides Internal User’s Information in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/user/getInternalUser

Responses
HTTP Code Description Schema

200

successful operation

< User > array

Consumes
  • text/plain

Produces
  • application/json

4.134.13. Roles List

GET /user/getRoles
Description

The example listed below shows a sample request URL:
/rest/user/getRoles

Responses
HTTP Code Description Schema

200

successful operation

< string, string > map

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.134.14. Admin Details

GET /user/getUserDetailsByLoginName
Description

Get the details of the specified admin. Get the Admin details using the Login name contains all the permissions and functions associated to that admin.
The example listed below shows a sample request URL:
/rest/user/getUserDetailsByLoginName?login_name=test

Parameters
Type Name Description Schema Default

Query

login_name
required

Admin’s Login Name

string

Responses
HTTP Code Description Schema

200

successful operation

User

500

TIMS-4010: Login name is not valid.

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

4.134.15. Admin List

GET /user/list
Description

List all the admins. Gets the list of Admin groups that the Admin belongs to besides other attributes. Functional Admin has visibility to the admins from all the organizations while Super Admin and User Admin are restricted to their organizations.
The example listed below shows a sample request URL:
/rest/user/list?grp_name=test

Parameters
Type Name Description Schema Default

Query

grp_id
optional

Group ID

integer(int32)

Query

grp_name
required

Group Name

string

Responses
HTTP Code Description Schema

200

successful operation

< User > array

500

TIMS-3002: first_name, last_name, or email_id cannot be null. TIMS-3003: cannot find the specified user. TIMS-3004: Invalid user id specified

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.134.16. Permission List.

GET /user/listpermission
Description

Provides all users permission list in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/user/listpermission

Responses
HTTP Code Description Schema

200

successful operation

< User Permission > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.134.17. Admin List Page

GET /user/page
Description

Returns a list of admins defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/user/page?grp_name=test&start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

grp_id
optional

Admin Group ID

integer(int32)

Query

grp_name
required

Admin Group Name

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Order (asc/desc)

string

Query

organizations
optional

Organization Names

string

Query

q
optional

Search String

string

Query

sort
optional

Sort String

string

Query

start
required

Starting User Range

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListUser

500

TIMS-3002: first_name, last_name, or email_id cannot be null, TIMS-3003: cannot find the specified user, TIMS-3004: Invalid user id specified.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.134.18. User Permission List

GET /user/permexpndlist
Description

Provides user’s permission list in TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/user/permexpndlist?login_name=admin

Parameters
Type Name Description Schema Default

Query

login_name
required

Admin Login Name

string

Query

user_id
optional

Admin ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< User Permission > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.134.19. Admin List Permissions

GET /user/permissionsforadmin
Description

List permissions associated with a given admin. Functional admin can get the permissions of any admin, while the Super Admin and User Admin are restricted to the admins belonging to their organization.
The example listed below shows a sample request URL:
/rest/user/permissionsforadmin?login_name=adminusername

Parameters
Type Name Description Schema Default

Query

grp_id
optional

Admin/User ID

string

Query

login_name
required

Admin Login Name

string

Query

user_id
optional

Admin/User ID

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< Permission > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.134.20. Lists Admin References

GET /user/references
Description

Find Admin references in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/user/references?tables=abc&count=2

Parameters
Type Name Description Schema Default

Query

count
required

Total Count param

string

Query

id
optional

Reference ID

string

Query

page
optional

Page

integer(int32)

Query

rows
optional

Rows

integer(int32)

Query

tables
required

Reference Table

string

Responses
HTTP Code Description Schema

200

successful operation

Reference Results

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.134.21. Searches User Page

GET /user/search
Description

Lists information of all searched Admins in an Organization in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/user/search?org_list=Internal

Parameters
Type Name Description Schema Default

Query

org_list
required

Organization List

string

Query

page
optional

Page Number

integer(int32)

Query

rows
optional

Rows per Page

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListUser

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.134.22. Roles List

GET /user/selectedgroup
Description

List all the administrator groups list for selected administrator roles .
The example listed below shows a sample request URL:
/rest/user/selectedgroup?name=admin

Parameters
Type Name Description Schema Default

Query

name
optional

string

Responses
HTTP Code Description Schema

200

successful operation

< Admin Group > array

500

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.134.23. Session User Information

GET /user/session_user
Description

Provides information such as Name, ID, Role of session user in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/user/session_user

Responses
HTTP Code Description Schema

200

successful operation

User

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.135. VMWare Discovery Details Service

4.135.1. GET /vmware/authsource

Parameters
Type Name Description Schema Default

Query

ipType
required

IP Type

string

Query

objectId
required

Object Id

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

VMWareAuthenticationSource

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.135.2. GET /vmware/authtypelist

Responses
HTTP Code Description Schema

200

successful operation

< VMWare Authentication Type > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.136. View Service

Description

This service provides API's to get list of Views present in the TCPWave IPAM, add Views, update Views, delete Views, list of Views for an existing Server, list of Views for an existing Zone in the TCPWave IPAM.

4.136.1. Countries List

GET /view/countries
Description

Provides a list of country names in the TCPWave IPAM. Functional Admin gets the list of Countries. Rest of the Admins get only the list of countries associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/view/countries

Responses
HTTP Code Description Schema

200

successful operation

< Countries list > array

500

TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-7003: You are not authorized to perform this operation.

No Content

Produces
  • application/json

  • application/xml

4.136.2. View Create

POST /view/create
Description

Creates a new View by checking if it overlaps with the existing Views defined in the TCPWave IPAM. Functional Admin can create a new View for any organization. Rest of the admins can create a new View only for the organizations that they are associated with.Refer to the Administrator reference documentation for additional information about the DNS Views.
Sample payloads with mandatory parameters to add a view are listed below.
{"name":"dns-view-test-1","organizationName":"QAOrg","matchClients": [{"exclude": "0", "value": "10.2.2.12", "sequence": 1}],"matchClientsValue": "10.2.2.12","allowRecursion": [{"exclude": "0", "value": "10.2.2.0/24", "sequence": 1}],"allowRecursionValue": "10.2.2.0/24"},"enableRecursion":"no","matchRecursiveOnly":"no"}

Parameters
Type Name Description Schema Default

Body

body
optional

DNS View

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-7003: You are not authorized to perform this operation, TIMS-10100: A DNS View with this name already exists: <View Name>, TIMS-10101: Both algorithm id and algorithm code cannot be null, TIMS-10105: DNS View cannot be created with name 'Default'. 'Default' is a reserved view, TIMS-2010: Algorithm is not valid: <Algorithm Code>, TIMS-3022: Bit size should be between <Min Algo code> and <Max Algo code} for algorithm <Algorithm code>

No Content

Consumes
  • application/json

  • application/xml

4.136.3. View Delete

POST /view/delete
Description

Deletes an existing View in the TCPWave IPAM. Functional Admin can delete a View for any organization. Rest of the admins can delete a View only for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/view/delete?organization_name=Internal
Below example shows sample request JSON:
{"name":"v-1","matchClientsValue":"10.2.2.2;10.3.3.3;10.7.7.7;"}

Parameters
Type Name Description Schema Default

Query

organization_id
optional

Organization Id

string

Query

organization_name
required

Organization Name

string

Body

body
optional

DNS View

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-7003: You are not authorized to perform this operation, TIMS-10102: Both view id and view name cannot be null, TIMS-10103: DNS View does not exist for name: <View Name>, TIMS-10104: DNS View cannot be deleted as it is associated with one more servers, TIMS-10107: 'Default' DNS View cannot be deleted.

No Content

Produces
  • application/json

  • application/xml

4.136.4. View Edit

POST /view/edit
Description

Updates an existing View in the TCPWave IPAM. Functional Admin can update a View for any organization. Rest of the admins can update a View only for the organizations that they are associated with.
Below example shows sample request JSON:
{"matchClients":[{"exclude":"0","value":"10.0.2.0","sequence":1},{"exclude":"0","value":"10.0.2.1","sequence":2},{"exclude":"0","value":"10.0.2.2","sequence":3}],"matchDestinations":null,"name":"v-1","organizationName":"QAOrg","matchClientsValue":"10.0.2.3;10.0.2.4;10.0.2.5","matchDestinationsValue":"","allowRecursion": [{"exclude": "0", "value": "10.2.2.0/24", "sequence": 1}],"allowRecursionValue": "10.2.2.0/24"},"enableRecursion":"no","matchRecursiveOnly":"no"}

Parameters
Type Name Description Schema Default

Body

body
optional

DNS View

Responses
HTTP Code Description Schema

500

TIMS-1352: Cannot find organization: <organization name>, TIMS-7003: You are not authorized to perform this operation, TIMS-10101: Both algorithm id and algorithm code cannot be null, TIMS-10102: Both view id and view name cannot be null, TIMS-10100: A DNS View with this name already exists: <View Name>, TIMS-10103: DNS View does not exist for name: <View Name>, TIMS-10106: 'Default' DNS View cannot be edited, TIMS-10105: DNS View cannot be created with name 'Default'. 'Default' is a reserved view.

No Content

Consumes
  • application/json

  • application/xml

4.136.5. View Get

GET /view/get
Description

Lists all the Views associated with an organization in the TCPWave IPAM. Functional Admin can list the Views for any organization. Rest of the admins can list the Views only for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/view/get?organization_name=Internal&view_name=testview

Parameters
Type Name Description Schema Default

Query

organization_id
optional

Organization Id

string

Query

organization_name
required

Organization Name

string

Query

view_id
optional

View Id

string

Query

view_name
required

View Name

string

Responses
HTTP Code Description Schema

200

successful operation

DNS View

500

TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-7003: You are not authorized to perform this operation, TIMS-5001: Template already exists.

No Content

Produces
  • application/json

  • application/xml

4.136.6. View List

GET /view/list
Description

Provides a paginated list of Views Defined in the TCPWave IPAM. Functional Admin gets the list of all Views. Rest of the Admins get only the list of Views associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/view/list?organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organizations

string

Responses
HTTP Code Description Schema

200

successful operation

< DNS View > array

500

TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-7003: You are not authorized to perform this operation.

No Content

Produces
  • application/json

  • application/xml

4.136.7. View List Associated with template

POST /view/listassociatedwithtemplate
Description

Checks if the Zone template is associated with any Zones that have Views defined in it. If Views are defined in the Zone then Zone Template is not allowed to change for that Zone.
The example listed below shows a sample request URL:
/rest/view/listassociatedwithtemplate?organization_name=Internal&template_name=testtemplate

Parameters
Type Name Description Schema Default

Query

organization_id
optional

Organization Id

string

Query

organization_name
required

Organization Name

string

Query

template_id
optional

Template Id

string

Query

template_name
required

Template Name

string

Responses
HTTP Code Description Schema

500

TIMS-1352: Cannot find organization: <organization name>, TIMS-7003: You are not authorized to perform this operation, TIMS-3050: Both server id and address cannot be null, TIMS-3091: Server does not exist, TIMS-10116: Selected Master/Slave server does not contain any common DNS Views as that of Master/Slave servers.

No Content

Produces
  • application/json

  • application/xml

4.136.8. View List For Server

GET /view/listforserver
Description

Lists all the Views associated with a server in the TCPWave IPAM. Functional Admin can list the Views for a server in any organization. Rest of the admins can list the Views for a server only for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/view/listforserver?organization_name=Internal&server_ip=1.0.0.3

Parameters
Type Name Description Schema Default

Query

organization_id
optional

Organization Id

string

Query

organization_name
required

Organization Name

string

Query

server_id
optional

Server Id

string

Query

server_ip
required

Server IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

< DNS View > array

500

TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-7003: You are not authorized to perform this operation, TIMS-3050: Both server id and address cannot be null, TIMS-3091: Server does not exist.

No Content

Produces
  • application/json

  • application/xml

4.136.9. View List for Zone

GET /view/listforzone
Description

Lists all the Views associated with a Zone in the TCPWave IPAM. Functional Admin can list the Views associated with a Zone in any organization. Rest of the admins can list the Views associated with a Zone only for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/view/listforzone?organization_name=Internal&zone_name=testzone.com

Parameters
Type Name Description Schema Default

Query

organization_id
optional

Organization Id

string

Query

organization_name
required

Organization Name

string

Query

zone_name
required

Zone Name

string

Responses
HTTP Code Description Schema

200

successful operation

< DNS View > array

500

TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-7003: You are not authorized to perform this operation, TIMS-1422: Zone does not exist: <Zone Name>

No Content

Produces
  • application/json

  • application/xml

4.136.10. View List For Zone Template

GET /view/listforzonetemplate
Description

Lists all the Views that are common in the servers which are associated with a Zone Template. TCPWave IPAM. Functional Admin have this provision for any organization. Rest of the admins have this provision only for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/view/listforzonetemplate?organization_name=Internal&template_name=testtemplate

Parameters
Type Name Description Schema Default

Query

organization_id
optional

Organization Id

string

Query

organization_name
required

Organization Name

string

Query

template_id
optional

Template Id

string

Query

template_name
required

Template Name

string

Responses
HTTP Code Description Schema

200

successful operation

< DNS View > array

500

TIMS-1352: Cannot find organization: <organization name>, TIMS-7003: You are not authorized to perform this operation, TIMS-3050: Both server id and address cannot be null, TIMS-3091: Server does not exist.

No Content

Produces
  • application/json

  • application/xml

4.136.11. View List For Server

GET /view/v6listforserver
Description

Lists all the Views associated with ipv6 server in the TCPWave IPAM. Functional Admin can list the Views for a ipv6 server in any organization. Rest of the admins can list the Views for a ipv6 server only for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/view/listforserver?organization_name=Internal&server_ip=1.0.0.3

Parameters
Type Name Description Schema Default

Query

organization_id
optional

Organization Id

string

Query

organization_name
required

Organization Name

string

Query

server_id
optional

Server Id

string

Query

server_ip
required

Server IP Address

string

Responses
HTTP Code Description Schema

200

successful operation

< DNS View > array

500

TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-7003: You are not authorized to perform this operation, TIMS-3050: Both server id and address cannot be null, TIMS-3091: Server does not exist.

No Content

Produces
  • application/json

  • application/xml

4.136.12. Zone List for View

GET /view/zonelistforview
Description

Lists all the Zones associated with a View in the TCPWave IPAM. Functional Admin can list the Zones associated with a View in any organization. Rest of the admins can list the Zones associated with a View only for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/view/zonelistforview?view_name=testview

Parameters
Type Name Description Schema Default

Query

organization_id
optional

Organization Id

string

Query

view_id
optional

View Id

string

Query

view_name
required

View Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Zone > array

500

TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-7003: You are not authorized to perform this operation, TIMS-1422: Zone does not exist: <Zone Name>

No Content

Produces
  • application/json

  • application/xml

4.137. Widget Service

Description

This service provides API to get widgets information on Dashboard. Based on the information widgets will be shown or hidden on the Dashboard.

4.137.1. Network Statistics

GET /widget/list
Description

Get detailed statistics information of the current network in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/widget/list?category=test

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

category
required

Category

string

Responses
HTTP Code Description Schema

200

successful operation

< Widget Card > array

Consumes
  • text/plain

  • application/xml

Produces
  • application/json

  • application/xml

4.137.2. Network Statistics

POST /widget/update
Description

Get detailed statistics information of the current network in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/widget/update?widget_name=test&status=1

Parameters
Type Name Description Schema Default

Header

TIMS-Session-Token
optional

Session token for authorization

string

Query

status
required

Widget Status

boolean

Query

widget_name
required

Widget Name

string

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • text/plain

  • application/xml

Produces
  • application/json

  • application/xml

4.138. Workflow Handler Service

4.138.1. Workflow Add

POST /workflow/add
Description

Adding new workflow to the TCPWave IPAM.
Below example shows sample request JSON:
{ "data": "{"addressArray": ["10.0.0.3"],"isDeleterrsChecked": 0,"organization_name":"World","routersArray": [],"subnet_id": 848652,"updated_by": "23199"}", "entity": "IPv4 Network/IPv4 Subnet/Subnet Group/IPv4 Object/IPv4 DHCP Scopes/DNS Domain/DNS Managed Zone", "operation": "Add", "extensionData": "extension", "changeTicket": "12345", "status": "Awaiting Approval/In Progress/Pass/Fail", "stage": "Staged/Approved/Denied/Implement/Completed", "statusCode": "1/2/3/4", "stageCode": "1/2/3/4/5"}

Parameters
Type Name Description Schema Default

Body

body
optional

Payload for Approval Workflows.

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.138.2. Workflow Delete

POST /workflow/delete
Description

Deleting new workflow to the TCPWave IPAM.
Below example shows sample request JSON:
{ "data": "{"addressArray": ["10.0.0.3"],"isDeleterrsChecked": 0,"organization_name":"World","routersArray": [],"subnet_id": 848652,"updated_by": "23199"}", "entity": "IPv4 Network/IPv4 Subnet/Subnet Group/IPv4 Object/IPv4 DHCP Scopes/DNS Domain/DNS Managed Zone", "operation": "Add", "extensionData": "extension", "changeTicket": "12345", "status": "Awaiting Approval/In Progress/Pass/Fail", "stage": "Staged/Approved/Denied/Implement/Completed", "statusCode": "1/2/3/4", "stageCode": "1/2/3/4/5"}

Parameters
Type Name Description Schema Default

Body

body
optional

Payload for Approval Workflows.

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.138.3. Workflow Details fetch

GET /workflow/listrows
Description

Fetching workflow details from the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/workflow/listrows?organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListPayload For Approval Workflows.

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.138.4. Workflow Edit

POST /workflow/modify
Description

Updating new workflow to the TCPWave IPAM.
Below example shows sample request JSON:
{ "data": "{"addressArray": ["10.0.0.3"],"isDeleterrsChecked": 0,"organization_name":"World","routersArray": [],"subnet_id": 848652,"updated_by": "23199"}", "entity": "IPv4 Network/IPv4 Subnet/Subnet Group/IPv4 Object/IPv4 DHCP Scopes/DNS Domain/DNS Managed Zone", "operation": "Add", "extensionData": "extension", "changeTicket": "12345", "status": "Awaiting Approval/In Progress/Pass/Fail", "stage": "Staged/Approved/Denied/Implement/Completed", "statusCode": "1/2/3/4"}

Parameters
Type Name Description Schema Default

Body

body
optional

Payload for Approval Workflows.

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.138.5. Workflow Details fetch

GET /workflow/profile
Description

Fetching workflow details from the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/workflow/profile?id=1235

Parameters
Type Name Description Schema Default

Query

id
optional

string

Responses
HTTP Code Description Schema

200

successful operation

Payload for Approval Workflows.

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.139. Xtn Service

4.139.1. Extension Attribute List

GET /xtn/attr
Description

Obtains the Extension Attribute List based on the entity.
The example listed below shows a sample request URL:
/rest/xtn/attr?entity=network
Note: entity can be network, subnet, object, zone, admin, revzone, rr

Parameters
Type Name Description Schema Default

Query

entity
required

entity

string

Responses
HTTP Code Description Schema

200

successful operation

< Xtn Attribute > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.139.2. Add Extension Attribute

POST /xtn/attr_add
Description

Adds the Extensions to Network, Subnet, Object, Admin, Resource Record, Reverse Zone or Zone
Sample payloads with mandatory parameters to add an Extension Attributes
Add an Extension of type String which can be applied to Network, Subnet, Object, Admin, Resource Record, Reverse Zone or Zone are listed below.
{"name":"stringXtn","xtn_type":"STRING","mandatory":"false","entities":[{"name":"admin","show_on_grid":false},{"name":"network","show_on_grid":false},{"name":"subnet","show_on_grid":false},{"name":"object","show_on_grid":false},{"name":"zone","show_on_grid":false},{"name":"rr","show_on_grid":false},{"name":"revzone","show_on_grid":false}]}
Add an Extension of type Numeric which can be applied to Network, Subnet, Object, Admin, Resource Record, Reverse Zone or Zone are listed below.
{"name":"numericXtn","xtn_type":"NUMERIC","mandatory":"false","entities":[{"name":"admin","show_on_grid":false},{"name":"network","show_on_grid":false},{"name":"subnet","show_on_grid":false},{"name":"object","show_on_grid":false},{"name":"zone","show_on_grid":false},{"name":"rr","show_on_grid":false},{"name":"revzone","show_on_grid":false}]}
Add an Extension of type Date which can be applied to Network, Subnet, Object, Admin, Resource Record, Reverse Zone or Zone are listed below.
{"name":"dateXtn","xtn_type":"DATE","mandatory":"false","entities":[{"name":"admin","show_on_grid":false},{"name":"network","show_on_grid":false},{"name":"subnet","show_on_grid":false},{"name":"object","show_on_grid":false},{"name":"zone","show_on_grid":false},{"name":"rr","show_on_grid":false},{"name":"revzone","show_on_grid":false}]}
Add an Extension of type IP Address which can be applied to Network, Subnet, Object, Admin, Resource Record, Reverse Zone or Zone are listed below.
{"name":"ipaddressXtn","xtn_type":"IP_ADDR","mandatory":"false","entities":[{"name":"admin","show_on_grid":false},{"name":"network","show_on_grid":false},{"name":"subnet","show_on_grid":false},{"name":"object","show_on_grid":false},{"name":"zone","show_on_grid":false},{"name":"rr","show_on_grid":false},{"name":"revzone","show_on_grid":false}]}
Add an Extension of type List which can be applied to Network, Subnet, Object, Admin, Resource Record, Reverse Zone or Zone are listed below.
{"name":"listXtn","xtn_type":"LIST","mandatory":"false","list_values":"1.0.0.0,2.0.0.0","entities":[{"name":"admin","show_on_grid":false},{"name":"network","show_on_grid":false},{"name":"subnet","show_on_grid":false},{"name":"object","show_on_grid":false},{"name":"zone","show_on_grid":false},{"name":"rr","show_on_grid":false},{"name":"revzone","show_on_grid":false}]}
Add an Extension of type REegex which can be applied to Network, Subnet, Object, Admin, Resource Record, Reverse Zone or Zone are listed below.
{"name":"regulaExpXtn","xtn_type":"REGEX","mandatory":"false","regex_values":"^[ A-Za-z0-9_@.\/#+-:]*$","entities":[{"name":"admin","show_on_grid":false},{"name":"network","show_on_grid":false},{"name":"subnet","show_on_grid":false},{"name":"object","show_on_grid":false},{"name":"zone","show_on_grid":false},{"name":"rr","show_on_grid":false},{"name":"revzone","show_on_grid":false}]}

Parameters
Type Name Description Schema Default

Body

body
optional

Xtn Attribute

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.139.3. Extension Delete

POST /xtn/attr_del
Description

Deletes the specified extension present in the TCPWave IPAM. Functional Admin can delete extension.
Below example shows sample request JSON:
"string"

Parameters
Type Name Description Schema Default

Body

body
required

name

string

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.139.4. Edit Extension Attribute

POST /xtn/attr_edit
Description

Edit the Extension attribute.
Below example shows sample request JSON:
{"name":"stringXtn","xtn_type":"STRING","mandatory":"false","list_values":"","regex_values":"","description":"test","new_name":"stringXtn"}

Parameters
Type Name Description Schema Default

Body

body
optional

Xtn Attribute

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.139.5. Extension Attribute List

GET /xtn/attr_list
Description

Obtains the Extension Attribute List defined and managed by the TCPWave IPAM which are used to control the behavior of Network, Subnet, Object, Admin, Resource Record, Reverse Zone and Zone
The example listed below shows a sample request URL:
/rest/xtn/attr_list?entity=network
Note: entity can be network, subnet, object, zone, admin, revzone, rr

Parameters
Type Name Description Schema Default

Query

entity
optional

string

Responses
HTTP Code Description Schema

200

successful operation

< Xtn Attribute > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.139.6. Objcet Extension Attribute List

GET /xtn/attr_object
Description

Obtains the Object Extension Attribute List based on the subnet address and Organization.
The example listed below shows a sample request URL:
/rest/xtn/attr_object?subnet_address=10.0.0.0&org_name=Internal
Note: entity can be network, subnet, object, zone, admin, revzone, rr

Parameters
Type Name Description Schema Default

Query

org_name
required

org_name

string

Query

subnet_address
required

subnet_address

string

Query

subnet_id
optional

subnet_id

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< Xtn Attribute > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.139.7. Update Extension Values

POST /xtn/attr_object_val
Description

Updates the extension values of object.
The example listed below shows a sample request URL:
/rest/xtn/attr_object_val?org_name=QAOrg
Below example shows sample request JSON:
{"type":"object","key":"10.0.0.0","values":[{"name":"stringXtn","value":"testextnsion"}]}

Parameters
Type Name Description Schema Default

Query

org_id
optional

integer(int32)

Query

org_name
optional

string

Body

body
optional

XtnData

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.139.8. Extension Attribute Page

GET /xtn/attr_page
Description

It Provides the information about the components which are using specified extension.
The example listed below shows a sample request URL:
/rest/xtn/attr_page?name=objxtn&draw=1&start=0&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

string

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

name
required

Extension Name

string

Query

order
optional

Sort Order(asc/desc)

string

Query

organizations
optional

Organization Names

string

Query

sort
optional

Sort String

string

Query

start
required

Start Page Number

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListXtnResponse

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.139.9. Update Extension Values

POST /xtn/attr_val
Description

Updates the extension values of network, subnet, object, zone, reverse zone, resource record, admin.
The example listed below shows a sample request URL:
/rest/xtn/attr_val?org_name=QAOrg
Below example shows sample request JSON:
{"type":"network","key":"10.0.0.0","values":[{"name":"stringXtn","value":"testextnsion"}]}

Parameters
Type Name Description Schema Default

Query

org_id
optional

integer(int32)

Query

org_name
optional

string

Body

body
optional

XtnData

Responses
HTTP Code Description Schema

default

successful operation

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

  • text/plain

4.139.10. Get Extension details by name

GET /xtn/get
Description

Get the extension details based on the extension name.
The example listed below shows a sample request URL:
/rest/xtn/get?name=xtnName

Parameters
Type Name Description Schema Default

Query

name
required

Extension Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Xtn Attribute > array

Consumes
  • text/plain

  • application/json

Produces
  • application/json

  • application/xml

4.139.11. Get network/subnet details

GET /xtn/getSubnetNetworkDetailsByExtensions
Description

Get the subnet or network details based on the extension value.
The value of the request parameter ext_value accepts regular expression.
Note: Regex search can also perform a fixed string search.
Example: String ^abc.com$ matches only abc.com.
Supported regular expression meta characters:
Character: *
Description: The asterisk () metacharacter is used to match a character zero 0 or more times of the strings preceding it.
Example: ab
will give all strings containing characters "ab" Ex: abcd, abde, etc.
Character:
Description: The plus () metacharacter is used to match a character one or more times of strings preceding it. Example : Mon will give all strings containing characters "mon" Ex: Monday, monsoon, etc.
Character: ?
Description: The question(?) metacharacter is used to match a character zero 0 or one time of the string preceding it.
Example : Example: com? will give all the strings containing characters "com". Ex: test.com.
Character: .
Description: The dot (.) metacharacter is used to match any single character except newline character.
Example : 200. will give all the strings starting with characters "200" followed by any single character. Ex: 2005,2007,2008 etc.
Character: [abc]
Description : The charlist [abc] is used to match any of the enclosed characters.
Example : [in] will give all the string containing any single character in "in". Ex: LinkedIn, learning.com, etc.
Character: [abc]
Description : The charlist [abc] is used to match any characters excluding the ones enclosed.
Example : [twc] will give all the strings containing characters other than the ones in "twc".
Character: [A-Z]
Description : The [A-Z] is used to match any upper-case letter.
Example : Example : [A-Z] will give all the strings that contain any character from A to Z. Ex: TEST
Character: [a-z]
Description : The [a-z] is used to match any lower-case letter.
Example : [a-z] will give all the strings containing any character from a to z. Ex: test
Character: [0-9]
Description : The pattern [0-9] is used to match any digit from 0 to 9.
Example : Example : [0-9] will give all the strings containing characters "[0-9]". Ex: Test90
Character: ^
Description : DThe caret (^) is used to start the match at the beginning.
Example : ^[cd] gives all the strings starting with any of the characters in "cd". Ex: cloud.com, DNS, etc

The example listed below shows a sample request URL:
/rest/xtn/getSubnetNetworkDetailsByExtensions?ext_value=^M&org_name=test&entity=subnet&ext_name=test

Parameters
Type Name Description Schema Default

Query

entity
required

Entity Value

string

Query

ext_name
required

Extension Name

string

Query

ext_value
required

Extension Value

string

Query

org_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Subnet Information > array

Consumes
  • text/plain

  • application/json

Produces
  • application/json

  • application/xml

4.139.12. Extension Attribute Name and value

GET /xtn/nvp_list
Description

Provides the extended attributes name and its values present in Network, Subnet, Object, Zone, Reverse Zone, Resource Record or Admin based on entity and organization.
The example listed below shows a sample request URL:
/rest/xtn/nvp_list?entity=network&key=10.0.0.0&org_name=Internal
Note: entity can be network, subnet, object, zone, admin, revzone or rr

Parameters
Type Name Description Schema Default

Query

entity
required

entity

string

Query

key
required

key

string

Query

org_id
optional

org_id

integer(int32)

Query

org_name
required

org_name

string

Responses
HTTP Code Description Schema

200

successful operation

< Xtn NVP > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140. Zone Service

Description

This service provides API's to get list of Zones present in the TCPWave IPAM, add Zones, update Zones, delete Zones, add,update and delete Root Zone, add,update and delete Proxy Root Zone in the TCPWave IPAM.

4.140.1. Zone Add

POST /zone/add
Description

Creates a new Zone by checking if it overlaps with the existing zones defined in the TCPWave IPAM. Functional Admin can create a new Zone for any organization. Rest of the admins can create a new Zone only for the organizations that they are associated with.Refer to the Administrator reference documentation for additional information about the Zones.
Sample payloads with mandatory parameters to add a zone are listed below.
Create Zone with mandatory fields
{ "name":"zone.com","template_name":"z_t","organization_name":"QAOrg"}
Create Zone with DNSSEC Enabled
{ "name":"zone.com","template_name":"z_t","organization_name":"QAOrg","dnssec_enable":"yes","nsec_option":"NSEC3"}
Create Zone with Restricted Zone
{ "name":"zone.com","template_name":"z_t","organization_name":"QAOrg","restrictedZone":"yes"}
Create Zone with Monitoring Service Enabled
{ "name":"zone.com","template_name":"z_t","organization_name":"QAOrg","monitoringService":"yes"}
Create Zone with DMZ Visibility
{ "name":"zone.com","template_name":"z_t","organization_name":"QAOrg","dmzVisible":"yes"}
Create Zone with Active Directory Updates Enabled
{ "name":"zone.com","template_name":"z_t","organization_name":"QAOrg","activeDirectoryEnable":"yes"} { "name":"test.com", "activeDirectoryEnable":"no", "description":"Testing REST API", "dmzVisible":"no", "dnssec_enable":"no", "organization_name":"QAOrg", "serial_format":"DATE", "template_name":"QA Standard Template", "zoneRR":[],Create Zone with Non Managed Name Servers
{ "name":"zone.com","template_name":"z_t","organization_name":"QAOrg","nonmanagedNS":[{"ns_fqdn":"nameserver.domain.com","ns_ip":"10.1.10.12"},{"ns_fqdn":"nameserver1.domain.com","ns_ip":"31.1.1.12"}],"is_tsig":1}

Parameters
Type Name Description Schema Default

Body

body
optional

Zone

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-1352: Cannot find organization: <Organization Name>, TIMS-5031: Both template name and id cannot be null, TIMS-5020: Template does not exist: <Template Name>, TIMS-5039: Template does not exist for organization, TIMS-1356: Zone already exists: <Zone Name>, TIMS-3209: Zone <Zone Name> is already delegated in the root zone(organization:<Organization Name>). Cannot add it as a managed zone in the TCPWave IPAM, TIMS-1430: Cannot create a zone: <Zone Name> as there is a forward only zone already exists with this name, TIMS-1440: Cannot create a restricted zone: <Zone Name> as it is associated with one or more subnets as a primary domain, TIMS-1441: Cannot create a restricted zone: <Zone Name> as it is associated with one or more subnets as a secondary domain, TIMS-1436: Cannot create a restricted zone: <Zone Name> as it is associated with one or more objects, TIMS-1349: DNS Configuration sync failed with error: <Error Message>, TIMS-1437: Cannot create a restricted zone: <Zone Name> as it is associated with one or more resource records, TIMS-10102: Both view id and view name cannot be null, TIMS-10103: DNS View does not exist for name: <View Name>, TIMS-3025: Resource Records already exist, TIMS-1399: Domain Controller does not exist: <IP Address>, TIMS-1423: Selected zone template has one or more stealth servers. AD enabled zones should not contain any stealth servers. Please select a different zone template

No Content

Consumes
  • application/json

  • application/xml

4.140.2. Zone List

GET /zone/aliasRRslist
Description

Provides a paginated list of Alias Resource Records in a Zone Defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/zone/aliasRRslist?zonename=zone.com&orgname=Internal

Parameters
Type Name Description Schema Default

Query

orgname
required

Organization Name

string

Query

zonename
required

Zone Name

string

Responses
HTTP Code Description Schema

200

successful operation

< CloudRR > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.3. Object Duplicate Name Checker

GET /zone/checkDuplicateZoneRRName
Description

Check for the occurrence of an object with the same name.
The example listed below shows a sample request URL:
/rest/zone/checkDuplicateZoneRRName?name=objectNameTest&domain_name=domain.com&orgName=Internal

Parameters
Type Name Description Schema Default

Query

domain_name
required

Domain Name

string

Query

name
required

Object Name

string

Query

org_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

string

Consumes
  • text/plain

Produces
  • text/plain

4.140.4. Check if IP address exists in the organization

GET /zone/checkIfIPExists
Description

Checks whether IP address is used in the given organization in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/zone/checkIfIPExists?orgName=Internal&ip=12.1.1.22

Parameters
Type Name Description Schema Default

Query

ip
required

IP Address

string

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation
TIMS-15039: IP address cannot be null or empty.
TIMS-1916: Organization name cannot be null.
TIMS-1352: Organization does not exist: {0}
TIMS-15037: IP address {0} is used in the organization {1} in the TCPWave IPAM.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.5. Check RR is Restricted Zone

GET /zone/check_RR_is_rtd_zone
Description

Checks if a DNS Zone A record is in a restricted zone. Restricted zones have a special behavior in the TCPWave IPAM. Refer to the Administrator reference documentation for additional information about the restricted zones.
The example listed below shows a sample request URL:
/rest/zone/check_RR_is_rtd_zone?owner=k1.com.zone.com.&zone_name=zone.com&org_name=Internal

Parameters
Type Name Description Schema Default

Query

org_id
optional

Organization Id

integer(int32)

Query

org_name
required

Organization Name

string

Query

owner
optional

Owner Name

string

Query

zone_name
required

Zone Name

string

Responses
HTTP Code Description Schema

200

successful operation

boolean

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-1422: Zone does not exist: <Zone Name> , TIMS-1444: Cannot create a resource record as there is a restricted zone defined with the name: <Zone Name>.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.140.6. Verification of AAAA Resource Record

GET /zone/check_for_AAAA_RR
Description

Checks if AAAA record exists with the given owner name.
The example listed below shows a sample request URL:
/rest/zone/check_for_AAAA_RR?owner=Owner Name:k1.com.zone.com.

Parameters
Type Name Description Schema Default

Query

owner
required

Owner Name

string

Responses
HTTP Code Description Schema

200

successful operation

boolean

500

TIMS-3255: No AAAA record found for given owner name: <Owner Name> Please enter a valid AAAA record name.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.140.7. Verification of A or CNAME Resource Records

GET /zone/check_for_A_CNAME_RR
Description

Checks if A or CNAME record exists with the given owner name. If the global option: Allow CNAME Daisy Chaining is enabled, this API checks for A and CNAME records otherwise it checks for only A records present in the IPAM with the given name.
The example listed below shows a sample request URL:
/rest/zone/check_for_A_CNAME_RR?owner=k1.com.zone.com.&orgName=Internal&is_restricted=0

Parameters
Type Name Description Schema Default

Query

is_restricted
required

Is Restricted

string

Query

org_name
required

Organization Name

string

Query

owner
required

Owner Name

string

Responses
HTTP Code Description Schema

200

successful operation

boolean

500

TIMS-3260: The global option: Allow CNAME Daisy Chaining is disabled. So CNAME chaining is not allowed.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.140.8. Verification of A Resource Record

GET /zone/check_for_A_RR
Description

Checks if A record exists with the given owner name.
The example listed below shows a sample request URL:
/rest/zone/check_for_A_RR?owner=k1.com.zone.com.&orgName=Internal&is_restricted=0

Parameters
Type Name Description Schema Default

Query

is_restricted
required

Is Restricted

string

Query

org_name
required

Organization Name

string

Query

owner
required

Owner Name

string

Responses
HTTP Code Description Schema

200

successful operation

boolean

500

TIMS-3254: No A record found for given owner name: {0} Please enter a valid A record name.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.140.9. Verification of MX Resource Record

GET /zone/check_for_MX_RR
Description

Checks if MX record exists with the given owner name.
The example listed below shows a sample request URL:
/rest/zone/check_for_MX_RR?owner=mx.tcpwave.com.&org_name=Internal

Parameters
Type Name Description Schema Default

Query

org_name
required

Organization Name

string

Query

owner
required

Owner Name

string

Responses
HTTP Code Description Schema

200

successful operation

boolean

500

TIMS-1735: No MX record found for the given owner name: {0} Please enter a valid MX record name., TIMS-1352: Organization does not exist: <Given Organization Name>.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.140.10. Check NS Record In Proxy Root Zone

GET /zone/check_ns_in_proxy
Description

Checks the DNS Zone Delegation records in the DNS Proxy Zone. It is mandatory to have valid name server delegations in the DNS Proxy root zone for name resolution to function properly when third parties are involved.
The example listed below shows a sample request URL:
/rest/zone/check_ns_in_proxy?owner=k1.com.&data=k1.com.zone.com.&org_name=Internal

Parameters
Type Name Description Schema Default

Query

data
required

NS Record Data

string

Query

org_name
required

Organization Name

string

Query

owner
required

Owner Name

string

Responses
HTTP Code Description Schema

200

successful operation

boolean

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-1434: No matching NS record found on the given proxy root server.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.140.11. Zone Check NS Record In Root Zone

GET /zone/check_ns_in_root
Description

Checks the DNS Zone Delegation records in the Root Zone. It is mandatory to have valid name appliance delegations in the root zone so that recursive caches can follow the appropriate delegation and can perform a DNS lookup properly on the behalf of an end user or an application.
Below are the sample query parameter values accepted:
/rest/zone/check_ns_in_root?owner=k1.com.&org_name=Internal

Parameters
Type Name Description Schema Default

Query

org_name
required

Organization Name

string

Query

owner
required

Owner Name

string

Responses
HTTP Code Description Schema

200

successful operation

boolean

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-1435: NS record is referencing in the root zone. Please delete the reference and try again.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.140.12. Zone Clone

POST /zone/clone
Description

Creates a new Zone by using other zone details in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/zone/clone?existing_zone=zone1.com&new_zone=zone2.com&org_name=Internal

Parameters
Type Name Description Schema Default

Query

existing_zone
required

Existing Zone Name

string

Query

new_zone
required

New Zone Name

string

Query

org_name
required

Organization Name

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-1352: Cannot find organization: <Organization Name>, TIMS-5031: Both template name and id cannot be null, TIMS-5039: Template does not exist for organization, TIMS-1356: Zone already exists: <Zone Name>, TIMS-3209: Zone <Zone Name> is already delegated in the root zone(organization:<Organization Name>). Cannot add it as a managed zone in the TCPWave IPAM, TIMS-1430: Cannot create a zone: <Zone Name> as there is a forward only zone already exists with this name, TIMS-1440: Cannot create a restricted zone: <Zone Name> as it is associated with one or more subnets as a primary domain, TIMS-1441: Cannot create a restricted zone: <Zone Name> as it is associated with one or more subnets as a secondary domain, TIMS-1436: Cannot create a restricted zone: <Zone Name> as it is associated with one or more objects, TIMS-1349: DNS Configuration sync failed with error: <Error Message>, TIMS-1437: Cannot create a restricted zone: <Zone Name> as it is associated with one or more resource records, TIMS-10102: Both view id and view name cannot be null, TIMS-10103: DNS View does not exist for name: <View Name>, TIMS-3025: Resource Records already exist, TIMS-1399: Domain Controller does not exist: <IP Address>, TIMS-1423: Selected zone template has one or more stealth servers. AD enabled zones should not contain any stealth servers. Please select a different zone template

No Content

Consumes
  • application/json

  • application/xml

4.140.13. Zone Delete

GET /zone/delete/{zoneName}
Description

Deletes an existing Zone in the TCPWave IPAM. Functional Admin can delete a Zone for any organization. Rest of the admins can delete a Zone only for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/zone/delete/zone.com

Parameters
Type Name Description Schema Default

Path

zoneName
required

Name of the Zone

string

Responses
HTTP Code Description Schema

200

successful operation

boolean

500

TIMS-1422: Zone does not exist: <Zone Name>

No Content

Consumes
  • application/json

  • application/xml

4.140.14. Zone List

GET /zone/dnssec_enabled_list
Description

Provides the list of DNSSEC Enabled Zones defined in the TCPWave IPAM for a specified organization.
The example listed below shows a sample request URL:
/rest/zone/dnssec_enabled_list?orgName=Internal

Parameters
Type Name Description Schema Default

Query

orgName
required

Organization name

string

Responses
HTTP Code Description Schema

200

successful operation

< Zone > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.15. DS Resource Record checks

GET /zone/dsrecord_checks
Description

Checks if NS record exists with the given owner name and if any domain exists.
Below example shows sample request url:
/tims/rest/zone/dsrecord_checks?owner=ds.tcpwave.com.&org_name=QAOrg&zone_name=domain.com

Parameters
Type Name Description Schema Default

Query

org_name
required

Organization Name

string

Query

owner
required

Owner Name

string

Query

zone_name
required

Zone Name

string

Responses
HTTP Code Description Schema

200

successful operation

boolean

500

TIMS-15081: No external NS record found for the given owner name: {0} Please enter a valid NS record name., TIMS-1352: Organization does not exist: <Given Organization Name>.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.140.16. Zone Force Sync

GET /zone/forcesynczones
Description

Synchronizes the DNS zone data for a given zone or a subset of zones by fetching all the resource records specified from the TCPWave data repository. The DNS zone files are constructed as per the TCPWave Product Engineering’s specifications with various integrity checks embedded into them. The files are then compressed and transmitted to the remote using an encrypted T-Message secure tunnel. The compressed files are uncompressed on the remote and the DNS process on the remote is signaled to read the updated contents. The administrator performing this action is required to have sync permission.
The example listed below shows a sample request URL:
/rest/zone/forcesynczones?zoneOrgNames=zone.com-@-Internal

Parameters
Type Name Description Schema Default

Query

zoneOrgNames
required

Zone with organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Zone Force Sync > array

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-1422: Zone does not exist: <Zone Name>

No Content

Consumes
  • application/json

  • application/xml

  • text/plain

Produces
  • application/json

  • application/xml

  • text/plain

4.140.17. Geo Locations List

GET /zone/geolocations
Description

Provides a list of geo locations for Alias Resource Records in a Zone Defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/zone/geolocations?orgname=Internal&zoneTemplate=testTemplate

Parameters
Type Name Description Schema Default

Query

orgname
required

Organization Name

string

Query

zoneTemplate
optional

string

Responses
HTTP Code Description Schema

200

successful operation

< CloudGeoLocations > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.18. Get RR List

GET /zone/get
Description

Gets the Resource Record details for the given Zone in the TCPWave IPAM. Functional Admin can get Resource Record of a Zone in any organization. Rest of the Admins gets this provision for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/zone/get?domainName=domain.com&orgName=QAOrg&isProxy

Parameters
Type Name Description Schema Default

Query

domainName
required

Name of the zone

string

Query

isProxy
required

Proxy flag for the DNS root zone

integer(int32)

Query

orgName
required

Name of the Organization in which zone exist

string

Query

zoneID
optional

Id of the zone

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< Resource Record > array

500

TIMS-1321: Domain does not exist: <Zone Name>, TIMS-1352: Cannot find organization: <Organization Name>, TIMS-1403: Zone id cannot be null

No Content

Consumes
  • text/plain

Produces
  • application/json

4.140.19. Gets all the A records for a given zone in a given organization.

GET /zone/getAllARecords
Description

Gets all the A records defined at object and zone level for a given zone in a given organization.
The example listed below shows a sample request URL:
/rest/zone/getAllARecords?orgName=Internal&name=zone.com

Parameters
Type Name Description Schema Default

Query

filterRules
optional

Filter String

string

Query

id
optional

Zone Id

integer(int32)

Query

length
optional

Page Length

integer(int32)

Query

name
required

Zone Name

string

Query

order
optional

Sort Order(asc/desc)

string

Query

orgId
optional

Organization Id

integer(int32)

Query

orgName
required

Organization Name

string

Query

sort
optional

Sort String

string

Query

start
optional

Start Page Number

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PagedListResource Record

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.140.20. Get DNSSEC Keys information for the Managed DNS Zone

GET /zone/getDNSSECInfo
Description

Gives the DNSSEC Keys information for the Managed DNS Zone.
The example listed below shows a sample request URL:
/rest/zone/getDNSSECInfo?orgName=Internal&name=zone.com&isKsk=0/1

Parameters
Type Name Description Schema Default

Query

id
optional

Zone ID

integer(int32)

Query

isKsk
required

Key Type

integer(int32)

Query

name
required

Zone Name

string

Query

orgId
optional

Organization ID

integer(int32)

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< string(date-time) > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.21. Get DS(Delegation Signer) record for the Managed Zone

GET /zone/getDSRecord
Description

Gives the DS(Delegation Signer) record for the Managed Zone.
The example listed below shows a sample request URL:
/rest/zone/getDSRecord?orgName=Internal&name=zone.com

Parameters
Type Name Description Schema Default

Query

id
optional

Zone ID

integer(int32)

Query

name
required

Zone Name

string

Query

orgId
optional

Organization ID

integer(int32)

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< string > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.22. Get Proxy Root Zone RR List

GET /zone/getProxyRR
Description

Lists the RRs for the given Proxy Root Zone in the TCPWave IPAM. Functional Admin can list RR of a Proxy Root Zone in any organization. Rest of the Admins gets this provision for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/zone/getProxyRR?domainName=zone.com&orgName=Internal&isProxy=0/1

Parameters
Type Name Description Schema Default

Query

domainName
required

Name of the zone

string

Query

isProxy
required

Is Proxy

integer(int32)

Query

orgID
optional

Id of the organization

integer(int32)

Query

orgName
required

Name of the Organization in which zone exist

string

Query

zoneID
optional

Id of the zone

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< Resource Record > array

500

TIMS-1321: Domain does not exist: <Zone Name>, TIMS-1352: Cannot find organization: <Organization Name>, TIMS-1403: Zone id cannot be null

No Content

Consumes
  • text/plain

Produces
  • application/json

4.140.23. Zone Get

POST /zone/getZone
Description

Gets all the Zones associated with an organization in the TCPWave IPAM. Functional Admin can get the Zones for any organization. Rest of the admins can get the Zones only for the organizations that they are associated with.
Below example shows sample request JSON:
{ "name":"qa-zone.com","organization_name":"Internal" }

Parameters
Type Name Description Schema Default

Body

body
optional

Zone

Responses
HTTP Code Description Schema

200

successful operation

Zone

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-1422: Zone does not exist: <Zone Name>

No Content

Consumes
  • application/json

  • application/xml

4.140.24. Zone Get Data

GET /zone/getZoneData
Description

Gets all the Resource Records associated with the specified Zone in the TCPWave IPAM. Functional Admin have this provision for any organization . Rest of the admins have this provision only for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/zone/getZoneData?domainName=domain.com&orgName=Internal

Parameters
Type Name Description Schema Default

Query

domainName
required

Domain Name

string

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Resource Record > array

500

TIMS-4005: User id is not valid: <User id>, TIMS-4006: first_name, last_name, or email_id cannot be null, TIMS-4007: User does not exist: <User First Name> <User Last Name> <User Mail Id>, TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-1422: Zone does not exist: <Zone Name>, TIMS-3010: Object does not exist: <Object Address>, TIMS-1328: Zone name cannot be null

No Content

Consumes
  • text/plain

Produces
  • application/json

4.140.25. Zone Records List

GET /zone/getZoneRecords
Description

Provides a paginated list of resource records along with its SOA record and name server records for the specified zone defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/zone/getZoneRecords?zoneName=zone.com&orgName=Internal&start=1&length=20

Parameters
Type Name Description Schema Default

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

isProxy
optional

Proxy flag for the zone

integer(int32)

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sorting Order(asc/desc)

string

Query

orgName
required

Organization Name

string

Query

sort
optional

Sorting String

string

Query

start
required

Start Page Number

integer(int32)

Query

zoneName
required

Zone Name

string

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListResource Record

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.26. Get Zone TTL

GET /zone/getZoneTTL
Description

Gets the TTL value associated with the specified Zone in the TCPWave IPAM. Functional Admin have this provision for any organization . Rest of the admins have this provision only for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/zone/getZoneTTL?domainName=domain.com&orgName=Internal

Parameters
Type Name Description Schema Default

Query

domainName
required

Domain Name

string

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

integer(int32)

500

TIMS-4005: User id is not valid: <User id>, TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-1422: Zone does not exist: <Zone Name>, TIMS-3010: Object does not exist: <Object Address>, TIMS-1328: Zone name cannot be null

No Content

Consumes
  • text/plain

Produces
  • application/json

4.140.27. Get Resource Records Information Before Merging With Cloud

POST /zone/getmergezoneinfo
Description

Get the resource records that will be added or deleted in the zone in IPAM before confirming the merge operation with cloud.
The example listed below shows a sample request URL:
/rest/zone/getmergezoneinfo?zonename=zone.com&orgname=Internal&cloudprovider=aws

Parameters
Type Name Description Schema Default

Query

cloudprovider
required

Cloud Provider

string

Query

orgname
required

Organization Name

string

Query

zonename
required

Zone name

string

Responses
HTTP Code Description Schema

200

successful operation

ManagedZonesInfo

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.28. Zone List By Organization

GET /zone/getzonelistbyorg
Description

Provides a list of Zones in the given organization managed by the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/zone/getzonelistbyorg?orgName=Internal

Parameters
Type Name Description Schema Default

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Zone > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.29. Health Check ids List

GET /zone/healthchecks
Description

Provides a list of health check information for Alias Resource Records in a Zone Defined in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/zone/healthchecks?orgname=Internal&zoneTemplate=testTemplate

Parameters
Type Name Description Schema Default

Query

orgname
required

Organization Name

string

Query

zoneTemplate
optional

string

Responses
HTTP Code Description Schema

200

successful operation

< CloudHealthCheckerforAliasRRS > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.30. Zone is Frozen or not

GET /zone/isFrozen
Description

Checks if the queried Zone is in frozen state or not.
The example listed below shows a sample request URL:
/rest/zone/isFrozen?zone_name=zone.com&org_name=Internal

Parameters
Type Name Description Schema Default

Query

org_name
required

Organization Name

string

Query

zone_name
required

Zone Name

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-1422: Zone does not exist: <Zone Name>, TIMS-3088: Server IP address is null, TIMS-1455: Given domain is not a valid domain name. Please give a valid domain name.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.140.31. Zone List

GET /zone/list
Description

Provides a paginated list of Zones defined in the TCPWave IPAM. Functional Admin gets the list of all zones. Rest of the Admins get only the list of zones associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/zone/list?revZone=0/1

Parameters
Type Name Description Schema Default

Query

revZone
optional

List all forward zones if revZone value is 0 (default), if revZone value is 1 it will list all the reverse zones

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

< Zone > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.32. List Appliances

GET /zone/list-servers
Description

Lists all DNS Appliances for the given zone or template in a given organization in the TCPWave IPAM. Functional Admin can list all DNS Appliances for the given zone or template for any organization, while rest of the admins have the provision only for the organizations that they are associated with. Refer to the Administrator reference documentation for additional information about the DNS Appliances.
Below are the sample query parameter values accepted:
/rest/zone/list-servers?type=zone&name=zone.com&organization=Internal

Parameters
Type Name Description Schema Default

Query

name
required

The name is either zone name or template name

string

Query

organization
required

Name of the organization

string

Query

type
required

The type is either zone or template

string

Responses
HTTP Code Description Schema

200

successful operation

< Server Information > array

500

TIMS-1352: Cannot find organization: <Organization Name>, TIMS-1414: Type is not valid, TIMS-1422: Zone does not exist: <Zone Name>, TIMS-5020: Template does not exist: <Template Name>

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.33. List Zone Resource Records

GET /zone/listZoneRRs
Description

List all the records of specified type of a managed zone in the given organization in the TCPWave IPAM. If record type or name is not specified, then it will list all the resource records.
The example listed below shows a sample request URL:
/rest/zone/listZoneRRs?orgName=Internal&zone=zone.com&recordType=CNAME

Parameters
Type Name Description Schema Default

Query

orgName
required

Organization Name

string

Query

owner
optional

Owner Name

string

Query

recordType
optional

Record Type

string

Query

zone
required

Zone Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Resource Record > array

500

TIMS-7003: You are not authorized to perform this operation
TIMS-1328: Zone name cannot be null.
TIMS-1916: Organization name cannot be null.
TIMS-1352: Organization does not exist: {0}
TIMS-1422: Managed zone does not exist with the name: {0}

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.34. Zone List For Appliance View

GET /zone/listforserverview
Description

Lists all the Views for an existing Appliance in the TCPWave IPAM. Functional Admin have this provision for any organization . Rest of the admins have this provision only for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/zone/listforserverview?server_ip=10.0.0.2&view_name=v2

Parameters
Type Name Description Schema Default

Query

organization
required

Organization Name

string

Query

server_id
optional

Appliance Id

string

Query

server_ip
required

Appliance IP Address

string

Query

view_id
optional

View Id

string

Query

view_name
required

View Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Zone > array

500

TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-7003: You are not authorized to perform this operation, TIMS-3050: Both Appliance id and address cannot be null, TIMS-3091: Appliance does not exist, TIMS-10102: Both view id and view name cannot be null, TIMS-10103: DNS View does not exist for name

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.35. Manual Key Rollover for the Managed DNS Zone.

GET /zone/manualKeyRollover
Description

Manual Key Rollover for the Managed DNS Zone.
The example listed below shows a sample request URL:
/rest/zone/manualKeyRollover?orgName=Internal&name=zone.com&isKsk=0/1

Parameters
Type Name Description Schema Default

Query

id
optional

Zone ID

integer(int32)

Query

isKsk
required

Key Type

integer(int32)

Query

name
required

Zone Name

string

Query

orgId
optional

Organization ID

integer(int32)

Query

orgName
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< string(date-time) > array

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.36. Merge Zone With Cloud

POST /zone/mergezonewithcloud
Description

Merge zone in the TCPWave IPAM with the zone in the cloud.The resource records present in the selected zone in the IPAM that are not present in the zone in cloud will be retained. New resource records from the zone in cloud will be added to the zone in the IPAM. The resource records with same name in the IPAM will be overridden with the resource records from the cloud.
The example listed below shows a sample request URL:
/rest/zone/mergezonewithcloud?zonename=zone.com&orgname=Internal&cloudProvider=aws

Parameters
Type Name Description Schema Default

Query

cloudprovider
required

Cloud Provider

string

Query

orgname
required

Organization Name

string

Query

zonename
required

Zone name

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.37. Zone Monitoring Update

POST /zone/monitoring
Description

Enables Monitoring or Disables Monitoring for an existing Zone in TCPWave IPAM. Functional Admin gets the provision to enable or disable monitoring in all organization but rest of the Admins gets this provision for the organizations that they are associated with. Refer to the Administrator reference documentation for additional information about Monitoring.
Sample payload with mandatory parameters for enable or disable monitoring zone is listed below.
[{"name":"test.com","monitoringService":"no","organization_name":"Internal"},{"name":"_udp.tcpwave.com","monitoringService":"no","organization_name":"Internal"}]

Parameters
Type Name Description Schema Default

Body

body
optional

< Zone > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-1352: Cannot find organization: <Organization Name>, TIMS-1422: Zone does not exist: <Zone Name>

No Content

Consumes
  • application/json

  • application/xml

4.140.38. Zone Delete Multiple

POST /zone/multidelete
Description

Deletes Multiple Zones in the TCPWave IPAM. Functional Admin can Delete Multiple Zones for any organization. Rest of the admins can Delete Multiple Zones only for the organizations that they are associated with.
Sample payload with mandatory parameters to delete multiple zone is listed below. Below example is to delete two zone.User can delete as much as they want to delete.
[{ "name":"zone1.com","organization_name":"Internal"},{ "name":"zone2.com","organization_name":"Internal"}]

Parameters
Type Name Description Schema Default

Body

body
optional

< Zone > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-1352: Cannot find organization: <Organization Name>, TIMS-1406: Zone(s) does(do) not exist, TIMS-1209: Active Directory enabled zone(s) cannot be deleted, TIMS-1325: Zones delete failed as they are referenced in objects. Please delete those references and try again, TIMS-1327: Zones delete failed as they are referenced in subnet domains. Please delete those references and try again, TIMS-1329: Zones delete failed as they are referenced in IPv6 subnet domains. Please delete those references and try again, TIMS-1326: Zones delete failed as they are referenced in subnets. Please delete those references and try again.

No Content

Consumes
  • application/json

  • application/xml

4.140.39. Zone List

GET /zone/page
Description

Provides a paginated list of Zones defined in the TCPWave IPAM. Functional Admin gets the list of all zones. Rest of the Admins get only the list of zones associated with the organization that they belong to.
The example listed below shows a sample request URL:
/rest/zone/page?start=1&length=20

Parameters
Type Name Description Schema Default

Query

customFilterRules
optional

Custom Filter String

string

Query

draw
optional

Page Draw Param

integer(int32)

Query

filterRules
optional

Filter String

string

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sorting Order(asc/desc)

string

Query

organizations
optional

Organization Names

string

Query

sort
optional

Sorting String

string

Query

start
required

Start Page Number

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListZone

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.40. Resolution Policy List

GET /zone/policy/get
Description

Gets the list of the resolution policies.
The example listed below shows a sample request URL:
/rest/zone/policy/get?name=sampleAmerica&organization_name=Internal&zone_name=policy.com

Parameters
Type Name Description Schema Default

Query

name
optional

Resolution Policy Name

string

Query

organization_name
required

Organization Name

string

Query

zone_name
required

Zone Name

string

Responses
HTTP Code Description Schema

200

successful operation

< ResolutionPolicy > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.41. Proxy Root Zone Add

POST /zone/proxyroot/add
Description

Creates a new Proxy Root Zone in the TCPWave IPAM. Functional Admin can create a Proxy Root Zone for any organization. Rest of the admins can create Proxy Root Zone only for the organizations that they are associated with. Refer to the Administrator reference documentation for additional information about the Proxy Root Zone.
Sample payload with mandatory parameters to add a Proxy Root Zone is listed below.
{"organization_name":"EARTH","name":".", "template_name":"EARTH-PROXYROOTZONE","template":{"template_name":"EARTH-PROXYROOTZONE","organization_name":"EARTH","description":"","entity_type_code":"ZONE","server_type_code":"GENERICDNS","reference_type":"Root Zone Specific","array_templates":[{"param_name":"default-ttl","numeric_value":"86400"},{"param_name":"email-addr","value":"[email protected]"},{"param_name":"refresh","numeric_value":"21600"},{"param_name":"retry","numeric_value":"3600"},{"param_name":"expire","numeric_value":"604800"},{"param_name":"negative-cache-ttl","numeric_value":"86400"},{"param_name":"master-dns-servers","activeServers":"10.0.0.1"}]}}

Parameters
Type Name Description Schema Default

Body

body
optional

Zone

Responses
HTTP Code Description Schema

500

TIMS-1352: Cannot find organization: <Organization Name>, TIMS-1101: Cannot find template for name: <Template Name>, TIMS-3011: Resource record already exists.

No Content

Consumes
  • application/json

  • application/xml

4.140.42. Proxy Root Zone List

GET /zone/proxyroot/list
Description

Lists all Proxy Root Zones defined in the TCPWave IPAM. Functional Admin can list Proxy Root Zones for any organization. Rest of the admins can list Proxy Root Zones only for the organizations that they are associated with. Refer to the Administrator reference documentation for additional information about the Proxy Root Zones.
The example listed below shows a sample request URL:
/rest/zone/proxyroot/list?organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Name of Organizations

string

Responses
HTTP Code Description Schema

200

successful operation

< Zone > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.43. Proxy Root Zone Multiple Delete

POST /zone/proxyroot/multidelete
Description

Deletes Multiple Proxy Root Zones in the TCPWave IPAM. Functional admin can delete multiple Proxy Root Zones for any organization. Rest of the admins can Multiple Proxy Root Zones only for the organizations that they are associated with. Refer to the Administrator reference documentation for additional information about the Proxy Root Zones.
Below example shows sample request JSON:
["Internal"]

Parameters
Type Name Description Schema Default

Body

body
optional

< string > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-1307: Root zone(s) does(do) not exist

No Content

Consumes
  • application/json

  • application/xml

4.140.44. Proxy Root Zone Edit

POST /zone/proxyroot/update
Description

Updates an existing Proxy Root Zone in the TCPWave IPAM. Functional Admin can update a Proxy Root Zone for any organization. Rest of the admins can update a Proxy Root Zone only for the organizations that they are associated with. Refer to the Administrator reference documentation for additional information about the Proxy Root Zones.
Below example shows sample request JSON:
{"description":"","name":".","organization_name":"EARTH","serial_format":"DATE","template_name":"EARTH-PROXYROOTZONE","zoneRR":[],"template":{"template_name":"EARTH-PROXYROOTZONE","organization_name":"EARTH","description":"","entity_type_code":"ZONE","server_type_code":"GENERICDNS","reference_type":"Root Zone Specific","array_templates":[{"param_name":"default-ttl","numeric_value":"86400"},{"param_name":"email-addr","value":""admin_1@gmail.com"},{"param_name":"refresh","numeric_value":"21600"},{"param_name":"retry","numeric_value":"3600"},{"param_name":"expire","numeric_value":"604800"},{"param_name":"negative-cache-ttl","numeric_value":"86400"},{"param_name":"serial","value":"DATE"},{"param_name":"allow-query","aclList":[{"exclude":"0","value":"1.1.1.1","sequence":1}},{"param_name":"master-dns-servers","value":"959"}],"old_template_name":"EARTH-PROXYROOTZONE"},"old_name":".","updateSubZone":false"]}

Parameters
Type Name Description Schema Default

Body

body
optional

Zone

Responses
HTTP Code Description Schema

500

TIMS-1352: Cannot find organization: <Organization Name>, TIMS-1415: Zone or Domain already exists: <Zone Name>, TIMS-1414: Zone does not exist: <Zone Name>, TIMS-1101: Cannot find template for name: <Template Name>, TIMS-3011: Resource record already exists.

No Content

Consumes
  • application/json

  • application/xml

4.140.45. Root Zone Add

POST /zone/root/add
Description

Create a new Root Zone in the TCPWave IPAM . Functional Admin can create a Root Zone for any organization. Rest of the admins can create Root Zone only for the organizations that they are associated with. Refer to the Administrator reference documentation for additional information about the Root Zones.
Sample payloads with mandatory parameters to add a Root Zone are listed below.
Create Root Zone
{"organization_name":"Internal","name":".", "template_name":"Internal-ROOTZONE", "template":{"template_name":"Internal-ROOTZONE","organization_name":"Internal","description":"","entity_type_code":"ZONE","server_type_code":"GENERICDNS","reference_type":"Root Zone Specific","array_templates":[{"param_name":"default-ttl","numeric_value":"86400"},{"param_name":"email-addr","value":""abc@gmail.com"},{"param_name":"refresh","numeric_value":"21600"},{"param_name":"retry","numeric_value":"3600"},{"param_name":"expire","numeric_value":"604800"},{"param_name":"negative-cache-ttl","numeric_value":"86400"},{"param_name":"master-dns-servers","value":"10.0.0.4"}]}"}
Create Root Zone with DNSSEC Enabled
{"dnssec_enable":"yes","nsec_option":"NSEC3", "organization_name":"Internal","name":".", "template_name":"Internal-ROOTZONE", "template":{"template_name":"Internal-ROOTZONE","organization_name":"Internal","description":"","entity_type_code":"ZONE","server_type_code":"GENERICDNS","reference_type":"Root Zone Specific","array_templates":[{"param_name":"default-ttl","numeric_value":"86400"},{"param_name":"email-addr","value":"[email protected]"},{"param_name":"refresh","numeric_value":"21600"},{"param_name":"retry","numeric_value":"3600"},{"param_name":"expire","numeric_value":"604800"},{"param_name":"negative-cache-ttl","numeric_value":"86400"},{"param_name":"master-dns-servers","value":"10.0.0.4"}]}}

Parameters
Type Name Description Schema Default

Body

body
optional

Zone

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-1352: Cannot find organization: <Organization Name>, TIMS-1349: DNS Configuration sync failed with error: <Error Message>, TIMS-1424: Root zone already exists in the selected organization.

No Content

Consumes
  • application/json

  • application/xml

4.140.46. Root Zone List

GET /zone/root/list
Description

Lists all Root Zones defined in the TCPWave IPAM. Functional Admin can list Root Zones for any organization. Rest of the admins can list Root Zones only for the organizations that they are associated with. Refer to the Administrator reference documentation for additional information about the Root Zones.
The example listed below shows a sample request URL:
/rest/zone/root/list?organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

organizations

string

Responses
HTTP Code Description Schema

200

successful operation

< Zone > array

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.47. Root Zone Multiple Delete

POST /zone/root/multidelete
Description

Deletes Multiple Root Zones in the TCPWave IPAM. Functional Admin can Multiple Root Zones for any organization. Rest of the admins can Multiple Root Zones only for the organizations that they are associated with. Refer to the Administrator reference documentation for additional information about the Root Zones.
Below example shows sample request JSON:
["Internal"]

Parameters
Type Name Description Schema Default

Body

body
optional

< string > array

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation, TIMS-1307: Root zone(s) does(do) not exist, TIMS-1331: Root zone cannot be deleted as it is being used by one or more DNS internal cache servers

No Content

Consumes
  • application/json

  • application/xml

4.140.48. Root Zone Edit

POST /zone/root/update
Description

Updates an existing Root Zone in the TCPWave IPAM. Functional Admin can update a Root Zone for any organization. Rest of the admins can update a Root Zone only for the organizations that they are associated with. Refer to the Administrator reference documentation for additional information about the Root Zones.
Below example shows sample request JSON:
{"description":"","name":".","organization_name":"EARTH","serial_format":"DATE","template_name":"EARTH-PROXYROOTZONE","zoneRR":[],"template":{"template_name":"EARTH-PROXYROOTZONE","organization_name":"EARTH","description":"","entity_type_code":"ZONE","server_type_code":"GENERICDNS","reference_type":"Root Zone Specific","array_templates":[{"param_name":"default-ttl","numeric_value":"86400"},{"param_name":"email-addr","value":""admin@gmail.com"},{"param_name":"refresh","numeric_value":"21600"},{"param_name":"retry","numeric_value":"3600"},{"param_name":"expire","numeric_value":"604800"},{"param_name":"negative-cache-ttl","numeric_value":"86400"},{"param_name":"serial","value":"DATE"},{"param_name":"allow-query","aclList":[{"exclude":"0","value":"1.1.1.1","sequence":1}},{"param_name":"master-dns-servers"}],"old_template_name":"EARTH-PROXYROOTZONE"},"old_name":".","updateSubZone":false"]}

Parameters
Type Name Description Schema Default

Body

body
optional

Zone

Responses
HTTP Code Description Schema

500

TIMS-1352: Cannot find organization: <Organization Name>, TIMS-1415: Zone or Domain already exists: <Zone Name>, TIMS-1414: Zone does not exist: <Zone Name>, TIMS-1101: Cannot find template for name: <Template Name>, TIMS-3011: Resource record already exists.

No Content

Consumes
  • application/json

  • application/xml

4.140.49. Zone Resource Record Add

POST /zone/rr/add
Description

Creates a new Resource Record for a Zone in the TCPWave IPAM . Functional Admin can create a Zone Resource Record for any organization. Rest of the admins can create Zone Resource Record only for the organizations that they are associated with. Refer to the Administrator reference documentation for additional information about the Zone Resource Records.
Below example shows sample request JSON:
{"zoneName":"qa.com","owner":"tcpw.com.qa.com.","rrclass":"IN","rrtype":"A","ttl":"1200","data":"10.0.1.2","description":"","is_external_rr":0,"status":1,"organization_name":"EARTH"}

Parameters
Type Name Description Schema Default

Body

body
optional

Resource Record

Responses
HTTP Code Description Schema

500

TIMS-7002: Permission information cannot be retrieved, TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Cannot find organization: <Organization Name>, TIMS-7003: You are not authorized to perform this operation, TIMS-1422: Zone does not exist: <Zone Name>, TIMS-3152: Record owner name: <Owner Name> is already managed by TCPWave IPAM. Please try a different name, TIMS-3012: CNAME does not refer to a valid A record, TIMS-3025: Resource Records already exist

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.140.50. Add A records

GET /zone/rr/addARRs
Description

Add A records into the zone in the given organization in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/zone/rr/addARRs?orgName=Internal&zone=zone.com&owner=recordname&ips=12.1.1.22,23.2.2.23&is_proxy=0

Parameters
Type Name Description Schema Default

Query

ips
required

Comma separated IP Addresses

string

Query

is_proxy
optional

Is Proxy

integer(int32)

Query

orgName
required

Organization Name

string

Query

owner
required

Owner Name

string

Query

zone
required

Zone Name

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operationTIMS-15039: IP address cannot be null or empty.
TIMS-1916: Organization name cannot be null.
TIMS-1352: Organization does not exist: {0}
TIMS-15039: IP address cannot be null or empty.
TIMS-15040: Owner name cannot be null or empty.
TIMS-1328: Zone name cannot be null.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.51. Zone Resource Record Check CNAME Conflict

POST /zone/rr/checkACNAMEconflict
Description

Checks A to CNAME Resource Record(RR) conflict in the TCPWave IPAM. It is mandatory to have a different name for a A RR than that of existing CNAME RR and vice-versa.
The example listed below shows a sample request URL:
/rest/zone/rr/checkACNAMEconflict?ownerName=1tcp.com.test.com.&org_name=Internal&recordType=CNAME&data=server.test.com.

Parameters
Type Name Description Schema Default

Query

data
required

Resource Record Data

string

Query

org_id
optional

Organization Id

integer(int32)

Query

org_name
required

Organization Name

string

Query

ownerName
required

Resource Record owner name

string

Query

recordType
required

Resource Record Type

string

Query

view_names
optional

Resource Record View Names

string

Responses
HTTP Code Description Schema

500

TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-1020: Both Organization name and id cannot be null, TIMS-3072: A or CNAME <Given Record Name> record already exists for an Object: <Object Name>, TIMS-1420: A or CNAME <Given Record Name> record already exists in Zone: <Zone Name>

No Content

Consumes
  • application/json

  • application/xml

4.140.52. Zone Resource Record Check Orphan

POST /zone/rr/checkRROrphan
Description

Checks for the references of the Zone Resource Record before editing or deleting it in the TCPWave IPAM. Resource Records are not allowed to be modified or deleted if references are found.
The example listed below shows a sample request URL:
/rest/zone/rr/checkRROrphan?ownerName=cc.in.tcpwave.com.&org_name=Internal&recordType=A&externalRR=0

Parameters
Type Name Description Schema Default

Query

externalRR
required

Is External RR

integer(int32)

Query

org_id
optional

Organization Id

integer(int32)

Query

org_name
required

Organization Name

string

Query

ownerName
required

Resource Record owner name

string

Query

recordType
required

Resource Record Type

string

Responses
HTTP Code Description Schema

500

TIMS-4005: User id is not valid: <User id>, TIMS-4006: first_name, last_name, or email_id cannot be null, TIMS-4007: User does not exist: <User First Name> <User Last Name> <User Mail Id>, TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-1020: Both Organization name and id cannot be null, TIMS-3207: A record cannot be modified/deleted as it is associated to record type: <Record Type> and owner: <Record Name>

No Content

Consumes
  • application/json

  • application/xml

4.140.53. Zone Resource Record Delete

POST /zone/rr/delete
Description

Deletes an existing Zone Resource Record in the TCPWave IPAM. Functional Admin can delete a Zone Resource Record for any organization. Rest of the admins can delete Zone Resource Record only for the organizations that they are associated with.
Sample payloads with mandatory parameters to delete resource record are listed below.
Delete a DNS Root Zone Resource Record:
{"zoneName":".","organization_name":"Internal","rrtype":"A","rrclass":"IN","owner":"twist.com.aa12.com.","data":"10.1.0.9"}
Delete a DNS Proxy Root Zone Resource Record:
{"zoneName":"proxyzone.com","organization_name":"Internal","rrtype":"A","rrclass":"IN","owner":"twist.com.aa12.com.","data":"10.1.0.9","proxy":1}

Parameters
Type Name Description Schema Default

Body

body
optional

Resource Record

Responses
HTTP Code Description Schema

500

TIMS-4005: User id is not valid: <User id>, TIMS-4006: first_name, last_name, or email_id cannot be null, TIMS-4007: User does not exist: <User First Name> <User Last Name> <User Mail Id>, TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-1422: Zone does not exist:<Zone Name>, TIMS-3088: Appliance IP address is null, TIMS-7003: You are not authorized to perform this operation, TIMS-1200: Active Directory zone cannot be deleted, TIMS-1416: Zone does not exist, TIMS-3015: Resource record does not exist.

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.140.54. Zone Resource Record Add

POST /zone/rr/edit
Description

Updates a Resource Record for a Zone in the TCPWave IPAM . Functional Admin can updates a Zone Resource Record for any organization. Rest of the admins can create Zone Resource Record only for the organizations that they are associated with. Refer to the Administrator reference documentation for additional information about the Zone Resource Records.
Below example shows sample request JSON:
{"zoneName":"qa.com","owner":"tcpwave.com.qa.com.","rrclass":"IN","rrtype":"A","ttl":"1200","data":"10.1.0.1","description":"","is_external_rr":0,"status":1}

Parameters
Type Name Description Schema Default

Body

body
optional

Resource Record

Responses
HTTP Code Description Schema

500

TIMS-7002: Permission information cannot be retrieved, TIMS-9561: Existing owner of the resource record cannot be null, TIMS-9564: Existing data of the resource record cannot be null, TIMS-1352: Cannot find organization: <Organization Name>, TIMS-7003: You are not authorized to perform this operation, TIMS-1328: Zone name cannot be null, TIMS-1422: Zone does not exist: <Zone Name>, TIMS-3015: Resource record does not exist, TIMS-3152: Record owner name: <Owner Name> is already managed by TCPWave IPAM. Please try a different name, TIMS-3012: CNAME does not refer to a valid A record, TIMS-3254: No A record found for given owner name:<Owner Name> Please enter a valid A record name, TIMS-3025: Resource Records already exist

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.140.55. Get RR List

GET /zone/rrlist
Description

Gets the Resource Record details for the given Zone in the TCPWave IPAM. Functional Admin can get Resource Record of a Zone in any organization. Rest of the Admins gets this provision for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/zone/rrlist?domainName=domain.com&orgName=QAOrg&isProxy

Parameters
Type Name Description Schema Default

Query

domainName
required

Name of the zone

string

Query

draw
optional

Pagination Rendering Parameter

integer(int32)

Query

filterRules
optional

Filter String

string

Query

isProxy
required

Proxy flag for the DNS root zone

integer(int32)

Query

length
required

Page Length

integer(int32)

Query

order
optional

Sort Order(asc/desc)

string

Query

orgName
required

Name of the Organization in which zone exist

string

Query

sort
optional

Sort String

string

Query

start
required

Starting Range

integer(int32)

Query

zoneID
optional

Id of the zone

integer(int32)

Responses
HTTP Code Description Schema

200

successful operation

PaginatedListResource Record

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.56. Zone Scope List

GET /zone/scope/get
Description

Gets the list of the zone scopes.
The example listed below shows a sample request URL:
/rest/scope/get?name=sampleAmerica&organization_name=Internal&zone_name=scope.com

Parameters
Type Name Description Schema Default

Query

name
optional

Zone Scope Name

string

Query

organization_name
required

Organization Name

string

Query

zone_name
required

Zone Name

string

Responses
HTTP Code Description Schema

200

successful operation

< ZoneScope > array

500

TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.57. Zone Resource Record Search

POST /zone/searchRR
Description

Searches for the Resource Record in the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/zone/searchRR?ownerName=cc.in.tcpwave.com.&org_name=Internal

Parameters
Type Name Description Schema Default

Query

org_id
optional

Organization Id

integer(int32)

Query

org_name
required

Organization Name

string

Query

ownerName
required

Owner name

string

Responses
HTTP Code Description Schema

200

successful operation

< Resource Record > array

500

TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-1020: Both Organization name and id cannot be null,

No Content

Consumes
  • application/json

  • application/xml

4.140.58. Zone Command

GET /zone/subsys
Description

Executes the given command on remote in the TCPWave IPAM. Functional Admin can give a command for any organization. Rest of the admins can give a command only for the organizations that they are associated with.
The example listed below shows a sample request URL:
/rest/zone/subsys?zone_name=zone.com&org_name=Internal&argc=0(Freeze)/1(Thaw)

Parameters
Type Name Description Schema Default

Query

argc
required

argc

integer(int32)

Query

org_name
required

Organization Name

string

Query

zone_name
required

Zone Name

string

Responses
HTTP Code Description Schema

200

successful operation

string

500

TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Organization does not exist: <Given Organization Name>, TIMS-1422: Zone does not exist: <Zone Name>, TIMS-3088: Server IP address is null, TIMS-1455: Given domain is not a valid domain name. Please give a valid domain name.

No Content

Consumes
  • text/plain

Produces
  • text/plain

4.140.59. Sync Zone With Cloud

POST /zone/synczonewithcloud
Description

Sync Zone in the TCPWave IPAM with the zone in the cloud.
The example listed below shows a sample request URL:
/rest/zone/synczonewithcloud?zonename=zone.com&orgname=Internal&cloudprovider=aws

Parameters
Type Name Description Schema Default

Query

cloudprovider
required

Cloud Provider

string

Query

orgname
required

Organization Name

string

Query

zonename
required

Zone name

string

Responses
HTTP Code Description Schema

500

TIMS-7003: You are not authorized to perform this operation

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.60. Zone Edit

POST /zone/update
Description

Updates an existing Zone in the TCPWave IPAM. Functional Admin can update a Zone for any organization. Rest of the admins can update a Zone only for the organizations that they are associated with.
Below example shows sample request JSON:
{ "deletedARRs": [{"domain": "sasha.com","evaluateHealthTarget": "true","failover": "true","geoLocation": "","healthCheck": "true","healthCheckID": "43ce0b8f-4e1b-4568-8f95-b8988c01b053","hostedZoneID": "Z7HUB22UULQXV","isAliasType": "true","name": "sasha2","region": "","routingPolicy":"Weight","setIdentifier": "qwerty","type": "CNAME","value": "vpce-0d542a3c017e9160d-6gyuz16k.ec2.us-east-1.vpce.amazonaws.com","weight": 12}],"addedARRs": [{"domain": "sasha.com","evaluateHealthTarget": "true","geoLocation": "AE","healthCheck": "false","hostedZoneID": "Z7HUB22UULQXV","isAliasType": "true","name": "sasha2","routingPolicy": "GeoLocation","setIdentifier": "qwerty","type": "CNAME","value": "vpce-0d542a3c017e9160d-6gyuz16k.ec2.us-east-1.vpce.amazonaws.com"}],"description":"Testing REST API Updates","dmzVisible":0,"dnssec_enable":"no","monitoringService":"yes","name":"qa1.com","old_name":"qa-zone.com","restrictedZone":"no","serial_format":"DATE","template_name":"qa-zone-template","organization_name":"Internal" }

Parameters
Type Name Description Schema Default

Body

body
optional

Zone

Responses
HTTP Code Description Schema

500

TIMS-1352: Cannot find organization: <Organization Name>, TIMS-7003: You are not authorized to perform this operation, TIMS-1415: Zone or Domain already exists: <Zone Name>, TIMS-1430: Cannot create a zone: <Zone Name> as there is a forward only zone already exists with this name, TIMS-1422: Zone does not exist: <Zone Name>, TIMS-5020: Template does not exist: <Template Name>, TIMS-1442: Cannot change a zone: <Zone Name> to a restricted zone as it is associated with one or more subnets as a primary domain, TIMS-1443: Cannot change a zone: <Zone Name> to a restricted zone as it is associated with one or more subnets as a secondary domain, TIMS-1438: Cannot change a zone: <Zone Name> to a restricted zone as it is associated with one or more objects, TIMS-1349: DNS Configuration sync failed with error: <Error Message>, TIMS-1439: Cannot change a zone: <Zone Name> to a restricted zone as it is associated with one or more resource records, TIMS-5039: Template does not exist for organization, TIMS-10102: Both view id and view name cannot be null, TIMS-10103: DNS View does not exist for name: <View Name>, TIMS-3025: Resource Records already exist, TIMS-10112: DNS View cannot be deleted as it is associated with one or more subnet(s) or resource record(s), TIMS-1399: Domain Controller does not exist: <IP Address>, TIMS-1423: Selected zone template has one or more stealth Appliances. AD enabled zones should not contain any stealth Appliances. Please select a different zone template

No Content

Consumes
  • application/json

  • application/xml

4.140.61. Zone Status

GET /zone/zoneStatus
Description

Gets the status of the Zone i.e Zone is active or inactive. If the Zone is not active then it lists all the inactive Appliances that are associated with this Zone.
The example listed below shows a sample request URL:
/rest/zone/zoneStatus?zoneName=zone.com&orgName=Internal

Parameters
Type Name Description Schema Default

Query

orgName
required

Organization Name

string

Query

zoneName
required

Zone Name

string

Responses
HTTP Code Description Schema

200

successful operation

Zone

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.140.62. DNS Zone Template Associated Zones List

GET /zone/zonelist_by_template
Description

Obtains a list of DNS zones that are associated with a given DNS Zone Template. This list includes forward zones and reverse zones.
The example listed below shows a sample request URL:
/rest/zone/zonelist_by_template?name=TCPWave00005Remote&org_name=Internal

Parameters
Type Name Description Schema Default

Query

name
required

Template Name

string

Query

org_id
optional

Organization Id

integer(int32)

Query

org_name
required

Organization Name

string

Responses
HTTP Code Description Schema

200

successful operation

< Zone > array

500

TIMS-7002: Permission information cannot be retrieved, TIMS-1020: Both Organization name and id cannot be null, TIMS-1352: Cannot find organization: <Organization Name>, TIMS-7003: You are not authorized to perform this operation.

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.141. IDRAC Management Service

4.141.1. Delete Custom Signing Certificate

POST /idracMgmt/deleteCustomSSLCert
Description

Deletes the iDRAC custom SSL signing certificate from the specified iDRAC appliance.
Below example shows sample request JSON:
{"applianceIp":"10.1.10.244","applianceName":"appliance001","applianceType":"BIND AUTH","organization":"TCPWave","idracIP":"10.1.10.240","sslCertType":"1","sslCertKey":"cert.key","sslCert":"cert.crt","sslPkcsPassphrase":"string","sslOperationStatus":"Success","sslOperationResponseMessage":"string"}

Parameters
Type Name Description Schema Default

Body

body
optional

IdracSslCert

Responses
HTTP Code Description Schema

200

successful operation

IdracSslCert

500

TIMS-7003: You are not authorized to perform this operation,

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.141.2. Download SSL Certificate

POST /idracMgmt/downloadSSLCert
Description

Downloads SSL server certificate and custom signing certificate from the specified iDRAC appliance.
Below example shows sample request JSON:
{"applianceIp":"10.1.10.244","applianceName":"appliance001","applianceType":"BIND AUTH","organization":"TCPWave","idracIP":"10.1.10.240","sslCertType":"1","sslCertKey":"cert.key","sslCert":"cert.crt","sslPkcsPassphrase":"string","sslOperationStatus":"Success","sslOperationResponseMessage":"string"}

Parameters
Type Name Description Schema Default

Body

body
optional

IdracSslCert

Responses
HTTP Code Description Schema

200

successful operation

IdracSslCert

500

TIMS-7003: You are not authorized to perform this operation,

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.141.3. iDRAC Appliance List

GET /idracMgmt/listAppliances
Description

Obtains a list of all the iDRAC appliances from the TCPWave IPAM.
The example listed below shows a sample request URL:
/rest/idracMgmt/listAppliances?organizations=Internal

Parameters
Type Name Description Schema Default

Query

organizations
optional

Organization Names

string

Responses
HTTP Code Description Schema

200

successful operation

< IdracSslCert > array

500

TIMS-7003: You are not authorized to perform this operation,

No Content

Consumes
  • text/plain

Produces
  • application/json

  • application/xml

4.141.4. Upload SSL Certificate

POST /idracMgmt/uploadSSLCert
Description

Upload SSL server certificate and custom signing certificate in the specified iDRAC appliance.
Below example shows sample request JSON:
{"applianceIp":"10.1.10.244","applianceName":"appliance001","applianceType":"BIND AUTH","organization":"TCPWave","idracIP":"10.1.10.240","sslCertType":"1","sslCertKey":"cert.key","sslCert":"cert.crt","sslPkcsPassphrase":"string","sslOperationStatus":"Success","sslOperationResponseMessage":"string"}

Parameters
Type Name Description Schema Default

Body

body
optional

IdracSslCert

Responses
HTTP Code Description Schema

200

successful operation

IdracSslCert

500

TIMS-7003: You are not authorized to perform this operation,

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

4.141.5. Display SSL Certificate Info

POST /idracMgmt/viewSSLCertInfo
Description

Displays iDRAC SSL certificate information of the specified iDRAC appliance.
Below example shows sample request JSON:
{"applianceIp":"10.1.10.244","applianceName":"appliance001","applianceType":"BIND AUTH","organization":"TCPWave","idracIP":"10.1.10.240","sslCertType":"1","sslCertKey":"cert.key","sslCert":"cert.crt","sslPkcsPassphrase":"string","sslOperationStatus":"Success","sslOperationResponseMessage":"string"}

Parameters
Type Name Description Schema Default

Body

body
optional

IdracSslCert

Responses
HTTP Code Description Schema

200

successful operation

IdracSslCert

500

TIMS-7003: You are not authorized to perform this operation,

No Content

Consumes
  • application/json

  • application/xml

Produces
  • application/json

  • application/xml

5. Definitions

5.1. A generic response

This class represents a generic response to any validation rest call.

Name Description Schema

info
optional

Generic Validation related information.

< string > array

name
optional

Generic name.

string

valid
optional

Validation result

boolean

5.2. ADKerberosConfg

Name Description Schema

applianceName
optional

Name of the DNS appliance.
Example : "remote01.tcpwave.com"

string

applinaceAddress
optional

IP address of the DNS appliance.
Example : "192.168.2.45"

string

confFileData
optional

Contents of the Kerberos configuration file.

KerberosConfSections

deleteKeytabEntries
optional

Entries of the Kerberos keytab file to be deleted.

< KerberosKeytabData > array

keytabData
optional

Contents of the Kerberos keytab file.

< KerberosKeytabData > array

5.3. ADSites Information

This class encapsulates the information of various ADSites defined.

Name Description Schema

description
optional

Description for the Microsoft AD Sites

string

id
optional

ID of this Contact

integer(int32)

name
required

Name of the Microsoft AD sites

string

old_name
optional

string

old_subnet
optional

string

organization_name
required

Organization name of the AD Sites to which this Sites belongs

string

serverAddr
optional

Server address for the Microsoft AD Sites

string

subnet
required

IP address of the subnet

string

5.4. AWS Block Device

AWS Block Device holds information of a block device used in AWS Instance.

Name Description Schema

delete_on_termination
required

EBS volumes persist independently from the running life of an EC2 instance. However, you can choose to automatically delete an EBS volume when the associated instance is terminated.
Example : true

boolean

device
required

Device
Example : "dev/sda1"

string

encrypted
required

Volumes that are created from encrypted snapshots are automatically encrypted, and volumes that are created from unencrypted snapshots are automatically unencrypted. If no snapshot is selected, you can choose to encrypt the volume.
Example : true

boolean

id
optional

AWS Block Device ID in IPAM
Example : 1

integer(int32)

iops
required

Baseline of 3 IOPS per GiB with a minimum of 100 IOPS, burstable to 3000 IOPS
Example : "100/3000"

string

size
required

Size in GiB
Example : 500

integer(int32)

snapshot
required

Snapshot ID
Example : "snap-q1w2e3r4"

string

throughput
required

Throughput that the volume can support is specified for Streaming Optimized volumes: ST1 and SC1
Example : "100"

string

volume
required

Volume Type
Example : "General Purpose SSD"

string

volume_type
required

Device type
Example : "EBS"

string

5.5. AWS Instance Family Type

AWSInstanceFamilyType Object holds name of the family of instance types.

Name Description Schema

name
required

Name of AWS Instance Family Type
Example : "General Purpose"

string

5.6. AWS Instance Type

AWSInstanceType Object holds AWS Instance type.

Name Description Schema

name
required

Name of AWS Instance Type
Example : "t2.micro"

string

5.7. AWS S3 File

This class encapsulate the database snapshot information, such as bucket name, snapshot file name, file size and uploaded time.

Name Description Schema

bucketName
required

Name of the AWS S3 Bucket
Example : "test-bucket"

string

fileName
required

Name of the database snapshot
Example : "dbsnapshot_2022_03_13_12_00_00.tar.gz"

string

fileSize
optional

Size of the database snapshot file in KB
Example : "16535"

string

uploadedTime
optional

Database snapshot uploaded time at AWS S3
Example : "2022-03-13 12:03:30"

string

5.8. AWS VPC’s

Detailed information about AWS VPC’s model.

Name Description Schema

id
optional

string

isDefault
optional

string

name
optional

string

5.9. AWS Volume Type

AWSVolumeType Object represents Volume type of AWS Device.

Name Description Schema

id
optional

ID of Volume Type
Example : "gp2"

string

name
required

Name of Volume Type
Example : "General Purpose SSD"

string

5.10. Accept Elements Request

AcceptElementsRequest class encapsulates the attributes that are required to Accept Elements after discovery. The attributes include Discovery Command Id and Comma separated list of IP Addresses.

Name Description Schema

cmdId
required

Command Id
Example : 123

integer(int32)

ipArr
required

IP Address
Example : "10.2.2.3"

string

5.11. Access Control List(ACL)

This class represents an Access Control List(ACL) and contains the attributes necessary for ACL management functionality in the TCPWave IPAM. The information includes the name, value, sequence, DataList, ElementList and other ACL related information.

Name Description Schema

aclDataList
required

Details of the specified Access Control List.

< string > array

aclElementList
required

List of Address Match List which contains user defined and default Access Control List for the specified Access Control List.

< Access Control List(ACL) > array

created_by
optional

Id of the User who has created the specified Access Control List.
Example : 2017

integer(int32)

created_by_login_name
optional

The User’s name, who has logged into the TCPWave IPAM, has been set as Created By for the specified Access Control List.
Example : "Stephen"

string

created_by_name
optional

User Name who has created the specified Access Control List.
Example : "Stephen"

string

created_time
optional

The time instance when the specified Access Control List has been created.
Example : "03/01/2022 4:37"

string(date-time)

created_time_string
optional

String format of the time when the specified Access Control List has been created.
Example : "03/01/2022 3:39"

string

description
optional

Description of the specified Access Control List.
Example : "Access Control List for the cardsprod."

string

exclude
required

Exclude a particular Access Control List value for the specified Access Control List.
Example : "10.0.0.0/24"

integer(int32)

id
optional

ID of the specified Access Control List.
Example : 1

integer(int32)

isRefTsig
optional

Is it a Reference TSIG key
Example : "0 or 1"

integer(int32)

name
required

Name of the specified Access Control List.
Example : "cardsprod"

string

newName
required

Modified Name of the specified Access Control List.
Example : "eurprod"

string

refAclName
required

The name of Access Control List which is referenced in the specified Access Control List.
Example : "cardsprod"

string

refTSIGKeyName
required

The name of TSIG Key which is referenced in the specified Access Control List.
Example : "key1"

string

referenceCount
required

The number of other Access Control Lists being used in the specified Access Control List.
Example : 3

integer(int32)

sequence
required

Sequence of the specified Access Control List.
Example : 2

integer(int32)

special
required

Specifies if this Access Control List is default Access Control List in the TCPWave IPAM or not.
Example : "TRUE"

integer(int32)

updated_by
optional

Id of the User who has modified the specified Access Control List.
Example : 2019

integer(int32)

updated_by_login_name
optional

The User’s name, who has logged into the TCPWave IPAM, has been set as Updated by for the specified Access Control List.
Example : "John"

string

updated_by_name
optional

User Name who has modified the specified Access Control List.
Example : "John"

string

updated_time
optional

The time instance when the specified Access Control List has been modified .
Example : "03/01/2022 4:37"

string(date-time)

updated_time_string
optional

String format of the time when the specified Access Control List has been modified.
Example : "03/01/2022 3:39"

string

value
required

Value of the specified Access Control List.
Example : "10.1.10.172"

string

5.12. Active Directory

This class contains the information of Active Directory Domain Controller’s User Principle Name.

Name Description Schema

created_by_name
required

User name who has created an Active Directory User mapping.
Example : "admin"

string

created_time
required

The time when the specified Active Directory user mapping is updated.
Example : "03/18/2022 3:37"

string(date-time)

dc_id
required

Domain Controller ID.
Example : 1

integer(int32)

dc_ip
required

Domain Controller IP Address.
Example : "10.0.0.3"

string

dc_name
required

Domain Controller Name.
Example : "dc.tcpwave.com"

string

dnsDomainName
required

Domain Name of a specified DNS Appliance in the TCPWave IPAM.
Example : "tcpwave.com"

string

dnsId
required

ID of an specified DNS Appliance in the TCPWave IPAM.
Example : 1

integer(int32)

dnsIp
required

IP Address of an specified DNS Appliance in the TCPWave IPAM.
Example : "10.0.0.2"

string

dnsServerName
required

DNS Appliance Name which exists in the TCPWave IPAM.
Example : "ns.tcpwave.com"

string

domain_name
required

Domain Name which belongs to an Organization in the TCPWave IPAM.
Example : "tcpwave.com"

string

encryption_type
required

Specifies the keys that are generated in the key tab file.
Example : "RC4-HMAC-NT employs 128-bit encryption."

string

file_data
required

Contents of the Kerberos version 5 .keytab file

string

file_name
required

Specifies the name of the Kerberos version 5 .keytab file
Example : "krb5.keytab"

string

id
optional

ID of a specified Active Directory User.
Example : 1

integer(int32)

principal_name
required

Specifies the principal name in the form computer.tcpwave.com
Example : "computer.tcpwave.com"

string

principal_type
optional

Specifies the principal type.

string

realm
required

The name of Kerberos realm. Kerberos realm can be any ASCII string, convention is to make it the same as your domain name, in upper-case letters.
Example : "TCPWAVE.COM"

string

service_type
required

Services running on Active Directory Domain Controller.
Example : "DNS"

string

updated_by_name
required

User Id who has created an Active Directory user mapping.
Example : "2017"

string

updated_time
required

The time when the Active Directory User mapping is updated.
Example : "03/18/2022 3:37"

string(date-time)

5.13. Address Allocation

This class represents a specific Address range definition in a subnet template.

Name Description Schema

allocationType
required

Id of allocation type used for specific address range(static, dynamic, reserved).
Example : 1

integer(int32)

classCode
required

Name of classcode used for specific address range.
Example : "3G Phone"

string

classCodeId
optional

Id of classcode used for specific address range.
Example : 1

integer(int32)

clientClassAllow
optional

Name of allowed client class for specific address range.
Example : "ClientClass1"

string

clientClassAllowId
optional

Id of allowed client class for specific address range.
Example : 1

integer(int32)

clientClassAllowStringVal
optional

Comma separated list of allowed client class names for specific address range.
Example : "ClientClass1,client class2"

string

clientClassDeny
optional

Name of denied client class for specific address range.
Example : "ClientClass2"

string

clientClassDenyId
optional

Id of denied client class for specific address range.
Example : 1

integer(int32)

clientClassDenyStringVal
optional

Comma separated list of deny client class names for specific address range.
Example : "client class2"

string

domain
required

Name of domain used for specific address range.
Example : "tcpwave.com"

string

domainId
optional

Id of domain used for specific address range.
Example : 1

integer(int32)

endOffset
required

End offset value of object address in the specified subnet.
Example : 20

integer(int32)

id
optional

Id of the specified address allocation.
Example : 1

integer(int32)

resExpiryDate
optional

Expiry date for specific address range.
Example : "03/18/2022 4:37"

string(date-time)

startOffset
required

Start offset value of object address in the specified subnet.
Example : 10

integer(int32)

ttl
required

TTL for specific address range.
Example : 1200

integer(int32)

userClassAllow
optional

Name of allowed user class for specific address range.
Example : "Userclass1"

string

userClassAllowId
optional

Id of allowed user class for specific address range.
Example : 1

integer(int32)

userClassAllowStringVal
optional

Comma separated list of allow user class names for specific address range.
Example : "User class1, User class2"

string

userClassDeny
optional

Name of denied user class for specific address range.
Example : "Userclass2"

string

userClassDenyId
optional

Id of denied user class for specific address range.
Example : 1

integer(int32)

userClassDenyStringVal
optional

Comma separated list of deny user class names for specific address range.
Example : "User class3,User class4"

string

v6EndOffset
required

End offset value of IPv6 object address in the specified subnet.
Example : 20

integer

v6StartOffset
required

Start offset value of IPv6 object address in the specified subnet.
Example : 10

integer

vendorClassAllow
optional

Name of allowed vendor class for specific address range.
Example : "vendorclass1"

string

vendorClassAllowId
optional

Id of allowed vendor class for specific address range.
Example : 1

integer(int32)

vendorClassAllowStringVal
optional

Comma separated list of allow vendor class names for specific address range.
Example : "vendor class1"

string

vendorClassDeny
optional

Name of denied vendor class for specific address range.
Example : "vendorclass2"

string

vendorClassDenyId
optional

Id of denied vendor class for specific address range.
Example : 1

integer(int32)

vendorClassDenyStringVal
optional

Comma separated list of deny vendor class names for specific address range.
Example : "vendor class2,Vendor class3"

string

5.14. Address Block

This class represents a specific Address Block that has been defined with objects

Name Description Schema

blockSize
required

Obtains the size of a given address block by counting the number of IP Addresses.
Example : 244

integer(int32)

endIp
required

Obtains an end IP from a given Address Block.
Example : "10.0.0.2"

string

startIp
required

Obtains a start IP from a given Address Block.
Example : "10.0.0.1"

string

5.15. Address Space

This class represents Network Address Space. The information includes the Regional Internet Registry associated with the address space and the contact email for managing the address space.

Name Description Schema

contact
optional

Contact email address
Example : "[email protected]"

string

createdTimeString
required

Created time
Example : "2022-01-20 00:05"

string

description
optional

Description
Example : "Internal address space"

string

name
required

Name of the address space
Example : "Internal Space"

string

orgName
required

Organization name
Example : "Internal"

string

registry
optional

Regional Internet Registry
Example : "ARIN"

string

updatedTimeString
required

Updated time
Example : "2022-01-20 00:05"

string

v4Blocks
optional

< AddressBlock > array

v6Blocks
optional

< AddressBlock > array

5.16. AddressBlock

Name Description Schema

address
optional

string

childBlocks
optional

< AddressBlock > array

createdTimeString
required

Created time
Example : "2022-01-20 00:05"

string

description
optional

string

end
optional

integer

isV6
optional

boolean

mask
optional

integer(int32)

name
optional

string

organizationName
required

Organization name
Example : "Internal"

string

parent
optional

AddressBlock

parentFullAddress
required

Parent block address
Example : "10.1.10.0/8"

string

parentSpace
required

Parent address space name
Example : "Internal Space"

string

start
optional

integer

updatedTimeString
required

Updated time
Example : "2022-01-20 00:05"

string

v6
optional

boolean

5.17. Admin Group

This class contains detailed Information about Admin Group. The information includes the admin group name, organization name and description.

Name Description Schema

addedRoles
optional

< AdministratorRoles > array

created_by_name
optional

User Name who has created the specified admin group.
Example : "admin2"

string

created_time
optional

The time when the specified admin group is created.
Example : "1479201867000"

string(date-time)

created_time_string
optional

The time instance when the specified Appliance Group has been created.
Example : "03/18/2022 4:37"

string

deletedRoles
optional

< AdministratorRoles > array

description
optional

Description of the admin group.
Example : "Admin group description"

string

id
optional

ID of the admin group
Example : 121

integer(int32)

name
required

Name of the admin group.
Example : "Admin-group-1"

string

oldName
required

Old name of the admin group if admin group name being changed while updating admin group.
Example : "Admin-group"

string

orgRoleInfo
optional

string

organization_id
optional

integer(int32)

organization_name
optional

string

roles
optional

< string, string > map

updated_by_name
optional

User Name who has updated the specified admin group.
Example : "admin1"

string

updated_time
optional

The time when the specified admin group is updated.
Example : "1479201874000"

string(date-time)

updated_time_string
optional

The time when the specified admin group is updated, in string format.
Example : "03/15/2022 7:14:17"

string

5.18. Admin Role

This class contains admin role information. The information includes the admin role code and description of the role code.

Name Description Schema

code
required

User’s role Code. Role codes are SADM,FADM,RADM,PADM,NADM and UADM
Example : "UADM"

string

description
required

User’s role description
Example : "User administrator"

string

id
optional

User’s role ID
Example : 1

integer(int32)

5.19. AdminPreference

Name Description Schema

adminId
optional

integer(int32)

dataTableId
optional

string

filterString
optional

string

gridName
optional

string

loginName
optional

string

5.20. AdministratorRoles

Name Description Schema

addedFunctions
optional

< Functions > array

admin_group_name
optional

string

created_by_login_name
optional

string

created_time_string
optional

string

deletedFunctions
optional

< Functions > array

description
optional

string

id
optional

integer(int32)

internal
optional

boolean

name
optional

string

old_name
optional

string

organization_id
optional

string

organization_name
optional

string

updated_by_login_name
optional

string

updated_time_string
optional

string

5.21. Alarm Subscription

Subscription class encapsulates the attributes that are required to create an alarm subscription, such as Component Type, Component Name, Component Address, Threshold Name etc.

Name Description Schema

appId
optional

integer(int32)

appType
optional

string

channelId
optional

string

chatId
optional

string

componentAddress
required

Address of the Component
Example : "10.31.2.55"

string

componentId
optional

Database ID of the Component
Example : 364

integer(int32)

componentName
required

Name of the Component
Example : "ns0001"

string

componentType
required

Type of the Component
Example : "DNS"

string

conf
optional

string

contactId
optional

Database ID of the contact
Example : 54

integer(int32)

contactMail
required

Email ID of the Contact
Example : "[email protected]"

string

contactName
optional

Full Contact Name
Example : "James Francis Stuart"

string

createdBy
optional

Database ID of the user who has created the specified alarm subscription.
Example : "Stephen"

integer(int32)

createdByLoginName
optional

Login name of the user who has created the specified alarm subscription.
Example : "Stephen"

string

createdTime
optional

The time when the specified alarm subscription is created.

string(date-time)

createdTimeString
optional

The time when the specified alarm subscription is created, in string format.
Example : "07:17:17 02-20-2022"

string

id
optional

Database ID of the alarm subscription
Example : 44

integer(int32)

integrationKey
optional

string

name
optional

string

organizationId
optional

Database ID of the Organization

integer(int32)

organizationName
required

Name of the Organization
Example : "TCPWave"

string

sendCritical
required

Send Critical flag
Example : true

boolean

sendWarning
required

Send Warning flag
Example : true

boolean

thresholdId
optional

Database ID of the Threshold

integer(int32)

thresholdName
required

Name of the Threshold
Example : "SYSTEM_CPU"

string

token
optional

string

webhookUrl
optional

string

5.22. Algorithm

This class represents an Algorithm and contains the attributes necessary for Algorithm management functionality in the TCPWave IPAM. The information includes the Minimum Value, Maximum Value, Bit Size and other Algorithm related information.

Name Description Schema

bitSize
required

Fetches the user given bit size for the specified DNS signing Algorithm.
Example : 312

integer(int32)

code
required

Name the specified DNS signing Algorithm.
Example : "HMAC-SHA512"

string

dnssec
required

Specifies whether the Domain Name System Security Extensions(DNSSEC) is enabled for the specified DNS signing Algorithm or not.
Example : true

boolean

id
optional

ID of the specified DNS signing Algorithm.
Example : 10

integer(int32)

mandatory
required

Specifies whether the specified DNS signing Algorithm is mandatory or not.
Example : false

boolean

max
required

Maximum bit size of the specified DNS signing Algorithm.
Example : 512

integer(int32)

min
required

Minimum bit size of the specified DNS signing Algorithm.
Example : 1

integer(int32)

5.23. Amazon Machine Image

AWSImage holds information of Amazon Machine Image.

Name Description Schema

blockDevices
required

List of block devices

< AWS Block Device > array

cloudProviderId
required

Cloud Provider ID
Example : 1

integer(int32)

cloudProviderName
required

Cloud Provider Name to which AWS Image belongs.
Example : "Provider"

string

createdBy
required

User ID of the user that has created the specified AWS Image.
Example : 12

integer(int32)

createdByLoginName
required

Login name user name who has created the specified AWS Image.
Example : "Stephen"

string

createdByName
required

Last Name and First Name of the user that has created the specified AWS Image.
Example : "John, Banyan"

string

createdTime
required

AWS Image Created Time
Example : "10:20:20 01-20-2022"

string(date-time)

createdTimeStr
required

AWS Image Created Time
Example : "10:20:20 01-20-2022"

string

desc
required

AWS Image Description
Example : "Red Hat Enterprise Linux version 7.3 (HVM), EBS General Purpose (SSD) Volume Type"

string

id
optional

AWS Image ID in IPAM
Example : "1"

string

name
required

AWS Image Name
Example : "Amazon Linux AMI"

string

orgName
required

Organization Name to which AWS Image belongs.
Example : "EARTH"

string

platform
required

The value is Windows for Windows AMIs; otherwise blank.
Example : "Windows"

string

readOnly
optional

boolean

rootDeviceName
required

Root Device Name
Example : "dev/sda1"

string

updatedBy
required

User ID of the user that has updated for the last time the specified AWS Image.
Example : 12

integer(int32)

updatedByLoginName
required

Login name of the user who has updated the specified AWS Image.
Example : "Stephen"

string

updatedByName
required

Last Name and First Name of the user that has updated for the last time the specified AWS Image.
Example : "John, Banyan"

string

updatedTime
required

AWS Image Updated Time
Example : "10:20:20 01-20-2022"

string(date-time)

updatedTimeStr
required

AWS Image Updated Time
Example : "10:20:20 01-20-2022"

string

5.24. AnomalousDomain

Name Description Schema

blocked
optional

boolean

domain
optional

string

whitelisted
optional

boolean

5.25. AnomalyDetectedAlerts

Name Description Schema

applianceAddress
optional

string

date
optional

string

id
optional

integer(int32)

noOfAnamolyQueries
optional

integer(int32)

noOfAnomalyQueries
optional

integer(int32)

query
optional

string

source
optional

string

target
optional

string

time
optional

string

timeStamp
optional

string

5.26. Appliance

Name Description Schema

domainName
required

Name of the Domain which is associated with the specified appliance.
Example : "atcc.com"

string

getiDRACInfo
optional

string

getiDRACIp
optional

string

internalCacheServer
optional

Cache server of Internal organization.

string

isCluster
optional

Indicates whether the appliance is a clustered appliance.

boolean

name
optional

Name of appliance
Example : "DEV-Appliance"

string

orgName
optional

string

serverType
required

Type of the specified appliance.
Example : "BIND AUTH"

string

v4Adderss
required

IPV4 Address which is associated with the specified appliance.
Example : "192.1.10.200"

string

v6Adderss
optional

string

5.27. Appliance Forwarder

This class represents an Appliance Forwarder and contains the attributes necessary for Appliance Forwarder management functionality in the TCPWave IPAM. The information includes the Appliance Id, Appliance Type, Appliance IP Address and other Appliance Forwarder related information.

Name Description Schema

description
required

Description for the Specified Sever Forwarder
Example : "Corp. DNS Appliance migrated to the TCPWave IPAM by Professional Services."

string

forward
required

Forward is only relevant in conjunction with a valid forwarders statement. If set to 'only' the Appliance will only forward queries, if set to 'first' (default) it will send the queries to the forwarder and if not answered will attempt to answer the query.
Example : "only/first"

string

forwardersIPv4
required

List IPV4 Address(es) to which queries will be forwarded for the specified Appliance Forwarder. It’s only relevant when used with the related forward statement.
Example : "192.1.100.10"

string

forwardersIPv6
required

List IPV4 Address(es) to which queries will be forwarded for the specified Appliance Forwarder. It’s only relevant when used with the related forward statement.
Example : "2001:503:ba3e::2:30"

string

serverForwarders
optional

integer(int32)

serverId
required

Id of the specified Appliance Forwarder.
Example : 17

integer(int32)

serverType
required

Type of the Appliance associated with the specified Appliance Forwarder.
Example : "BIND AUTH"

string

serverV4Addr
required

IPV4 Address of the Appliance associated with the specified Appliance Forwarder.
Example : "192.168.1.200"

string

zoneName
required

Name of the zone associated with the specified Appliance Forwarder.
Example : "edu.com"

string

5.28. Appliance Group

Detailed information about Appliance Group model.

Name Description Schema

appliance_root_password
required

Root password value to update the associated DHCP and DNS appliances
Example : "RootPassword!23"

string

children
optional

< Appliance Group > array

created_by_login_name
optional

Name of the User who has created the specified Appliance Group.
Example : "John"

string

created_time_string
optional

The time instance when the specified Appliance Group has been created.
Example : "03/01/2022 4:37"

string

description
optional

Description of Appliance Group.
Example : "This is a appliance group."

string

id
optional

Database ID of the appliance group
Example : 1234

integer(int32)

name
optional

Name of Appliance Group
Example : "Test"

string

organization_id
required

Id of the Organization which is associated with the specified Appliance Group.
Example : 990

integer(int32)

organization_name
required

Name of the Organization which is associated to the specified Appliance Group.
Example : "EARTH"

string

parentGroupId
optional

integer(int32)

parentGroupName
optional

Name of the parent Appliance Group
Example : "Parent-Test"

string

prevAppGroupName
optional

Previous name of Appliance Group.
Example : "ABC"

string

updated_by_login_name
optional

Name of the User who has modified the specified Appliance Group.
Example : "John"

string

updated_time_string
optional

The time instance when the specified Appliance Group has been modified.
Example : "03/01/2022 4:37"

string

5.29. Appliance Information

Appliance bean class encapsulates the attributes needed to delete DNS, DHCP or IPAM appliance.

Name Description Schema

address
required

IP address of the specified IPAM/DNS/DHCP/IPv6_DHCP appliance.
Example : "9000::2"

string

id
optional

Id of the specified appliance.
Example : 121

integer(int32)

v6_address
optional

IP address of the IPv6 DHCP appliance which is associated with the specified IPv6 DHCP appliance.
Example : "192.168.0.135"

string

5.30. Appliance Synchronization Status

This class represents Synchronization Status of an Appliance and contains the attributes necessary for Status of the Appliance Synchronization functionality in the TCPWave IPAM. The information includes the Appliance Id, Sync Start Time, Status Message and other related information.

Name Description Schema

lastUpdated
required

The last most instant when the user modified the specified Appliance.
Example : "03/05/2022 2:13"

string(date-time)

lastUpdatedString
required

String format of the last most instant when the user modified the specified Appliance.
Example : "03/05/2022 2:13"

string

serverId
required

Id of the specified appliance whose Sync status user wants to retrieve.
Example : 127

integer(int32)

startTime
required

The time instance when the user initiates the Synchronization process for the specified Appliance.
Example : "03/05/2022 3:39"

string(date-time)

startTimeString
required

String format of the time when the user initiates the Synchronization process for the specified Appliance.
Example : "03/05/2022 3:39"

string

status
required

Defines if the specified appliance is successfully synchronized with the remote or not.
Example : "Yes"

string

statusMsg
required

Status message defines if the specified appliance is successfully synchronized with the remote or not.
Example : "DNS full synchronization has been completed successfully on: nutalx-al0654-231"

string

5.31. ApplianceInfo

Name Description Schema

applianceIp
optional

IP address of the appliance.
Example : "10.0.0.1"

string

applianceName
required

Name of the appliance .

string

applianceType
optional

Type of the appliance .

string

organization
optional

Organization name.

string

patchOperation
optional

Patch operation.

integer(int32)

5.32. ApplianceService

Name Description Schema

anomalydetection
optional

Anomalydetection service status
Example : "yes/no"

string

bgpd
optional

BGP service status
Example : "yes/no"

string

dhcpd
optional

Dhcpd Status
Example : "yes/no"

string

dns
optional

DNS Process status of named, unbound or nsd.
Example : "yes/no"

string

id
optional

ID of the appliance
Example : 21

integer(int32)

is_primary
optional

Status of the DHCP appliance: primary or fail-over
Example : "0/1"

integer(int32)

monit
optional

Monit service status
Example : "yes/no"

string

name
optional

Name of the appliance
Example : "Test-appliance"

string

named
optional

Named service status
Example : "yes/no"

string

nsd
optional

NSD service status
Example : "yes/no"

string

ntpd
optional

NTP service status
Example : "yes/no"

string

object_id
optional

ID of the appliance object
Example : 101

integer(int32)

organization_id
optional

Organization ID
Example : 101

integer(int32)

organization_name
required

Organization Name
Example : "Internal"

string

ospfd
optional

OSPF service status
Example : "yes/no"

string

server_type
required

Type of the appliance
Example : "DHCP/BIND AUTH/BIND CACHE/NSD"

string

snmpd
optional

SNMP service status
Example : "yes/no"

string

sshd
optional

SSH service status
Example : "yes/no"

string

stunnel
optional

Stunnel service status
Example : "yes/no"

string

suricata
optional

Suricata service status
Example : "yes/no"

string

tftp
optional

TFTP service status
Example : "yes/no"

string

timsdhcp
optional

TIMS DHCP status
Example : "yes/no"

string

timsdiscovery
optional

string

timsdns
optional

TIMS DNS status
Example : "yes/no"

string

unbound
optional

Unbound service status
Example : "yes/no"

string

v4_ipaddress
required

IPv4 IP address of the appliance
Example : "192.168.0.101"

string

zebra
optional

Zebra service status
Example : "yes/no"

string

zeek
optional

Zeek service status
Example : "yes/no"

string

5.33. Apply Binlog Request

This class represents the request to load the database incremental changes into a recovery database in the TCPWave IPAM.

Name Description Schema

databases
required

Name of the recovery database
Example : "test"

string

dumpDir
required

Full path of the database binlog snapshot directory
Example : "/tmp/hostName_11.30P7_2022Mar15_1500.bak/binlogs"

string

endTime
required

End time of the snapshot

string

5.34. Apply DB Snapshot Request

This bean class loads the database snapshot into a recovery database in the TCPWave IPAM.

Name Description Schema

databases
required

Name of the recovery database
Example : "test"

string

mysqlCommandPath
optional

Full path of the mysql command
Example : "/usr/bin/mysql"

string

snapshotDir
required

Full path of the database snapshot directory
Example : "/tmp/hostName_11.30P7_2022Mar15_1500.bak"

string

5.35. Asset

This class represents an Asset and contains the attributes necessary for asset management functionality in the TCPWave IPAM. The information includes the service tag and other manufacturing information, the cost and acquisition details, maintenance and warranty information, physical location and OS and related information.

Name Description Schema

acquisition_type
required

Acquisition type of the Asset

string

capacity
required

Capacity of the Asset

string

city
required

City location of the Asset

string

cpu
required

CPU specification of the Asset

string

description
required

Description of the Asset

string

disposal_dt
required

Disposal date of the Asset

string(date-time)

disposal_reason
required

Reason for the disposal

string

green_zone
required

Green Zone for the Asset

boolean

id
optional

Database ID of the Asset

integer(int32)

maintenance_cost
required

Maintenance cost of the Asset

number(double)

maintenance_end_dt
required

Maintenance end date of the Asset

string(date-time)

model
required

Model of the Asset

string

name
required

Name of the Asset

string

os_version
required

Operating system of the Asset

string

previousAssetSerTag
optional

Previous Asset service tag

string

purchase_cost
required

Purchase cost of the Asset

number(double)

purchase_dt
required

Purchase date of the Asset

string(date-time)

serial_num
required

Serial Number of the Asset

string

service_tag
required

Service Tag of the Asset

string

vendor
required

Vendor of the Asset

string

warranty_end_dt
required

Warranty end date of the Asset

string(date-time)

5.36. AssociativeServersForForwarders

Name Description Schema

ip_address
optional

IP Address of the appliance.
Example : "193.168.0.123"

string

name
optional

Name of the DNS appliance.
Example : "named-alaska-sl0984"

string

recursion_enabled
optional

This value represents if recursion is enabled or not.
Example : "yes"

string

server_type
optional

Type of the appliance.
Example : "BIND AUTH"

string

5.37. AttachedPermissionsBoundary

Name Description Schema

permissionsBoundaryArn
optional

string

permissionsBoundaryType
optional

string

5.38. Audit Entry

This is a bean class for the Audit Log Information. The attributes include the information needed to identify the action, admin performing the action, outcome of the action, and the source IP information from which the action has taken place. This information is used for generating comprehensive audit trail within the TCPWave IPAM and is used internally by the service layer.

Name Description Schema

ip_address
optional

Obtains the IP Address that has been captured by the auditing mechanism in the TCPWave IPAM.
Example : "10.0.0.0"

string

organization_name
optional

Obtains the Organization Name of the audited entity from the TCPWave IPAM.
Example : "Internal"

string

5.39. Audit Log Configuration for a component

This class provides the audit logging status of a component in the TCPWave IPAM.

Name Description Schema

componentName
required

Name of a component in the TCPWave IPAM.
Example : "IPv4 Network Management"

string

description
optional

Description of a component whose operations can be audited in the TCPWave IPAM.
Example : "Logs the network related operations. Ex: Network Create/Update/Delete"

string

logging_status
required

Audit logging status for a component in the TCPWave IPAM.
Example : "enable"

string

5.40. Audit Log Entry in CEF Format

This class provides the CEF log entry format for logging Security information.

Name Description Schema

col9
optional

Internally used REST call to obtain the entity from the parsed CEF log output of the TCPWave IPAM.

string

5.41. Audit Report

This class contains information related to all reports. The information includes the administrator details, zone details, email, server details, monitoring alerts details, network details, subnet details, object details, history table details, DHS/DHCP details, schedule jobs details, refresh time, retry time, expire time, negative cache etc.

Name Description Schema

action
optional

Action value
Example : "create/modify/delete"

string

actionType
optional

Action type
Example : "success/failure"

string

adminName
optional

Administrator name
Example : "john"

string

adminRole
optional

Administrator role
Example : "FADM"

string

admin_jobs
optional

Schedule Job Category
Example : "Rest"

string

asso_type
optional

DHCP association name
Example : "abc"

string

change_ticket
optional

Change ticket value
Example : "abc123"

string

clientIp
optional

Client IP
Example : "127.0.0.2"

string

commandId
optional

Command Id
Example : "TDCE_20220330213"

string

config_name
optional

Configuration name
Example : "abc"

string

contact_first_name
optional

string

contact_last_name
optional

string

dmz_visible
optional

DMZ Visibility
Example : "0/1"

integer(int32)

domain
optional

Domain name
Example : "abc.com"

string

dropdown_status
optional

Dropdown status value
Example : "active/deleted"

string

email_recipients
optional

Email Id
Example : "[email protected]"

string

execution_status
optional

Execution status
Example : "success/failure"

string

execution_time
optional

Execution time
Example : "2022-02-04 05:24:00"

string

fileName
optional

Audit backup file name
Example : "audit_history_attachment_backup_4_2022.csv"

string

host_address
optional

Host IP
Example : "10.1.10.241"

string

host_id
optional

Host ID
Example : 1241

integer(int32)

host_name
optional

Host name for DHCP Lease report.
Example : "abcd"

string

internal_cache_server
optional

Cache Server Count
Example : 12

integer(int32)

ip_address
optional

IP address
Example : "10.1.10.241"

string

login_time
optional

Login time
Example : "2022-02-01 05:06:14"

string

logout_time
optional

Logout time
Example : "2022-02-01 05:06:14"

string

macAddress
required

MAC address for Global allocation report.
Example : "65:e1:44:a6:85:7b"

string

mailsHeading
optional

string

mask
optional

Network/Subnet Mask
Example : 24

integer(int32)

monitoring_service
optional

Monitoring service name
Example : "CHECK_MONIT"

string

name
optional

Name value
Example : "abc"

string

network_status
optional

Network status value
Example : "active/deleted"

string

obj_count
optional

Total Objects Count
Example : 12

integer(int32)

optionTempl
optional

DHCP option template name
Example : "optiontemplate"

string

organization
optional

Organization name
Example : "Earth"

string

param_domainName
optional

DHCP parameter name
Example : "abc"

string

param_val
optional

DHCP Parameter value
Example : "abc"

string

patch
optional

string

proxy
optional

Whether Proxy is enable or disable
Example : 12

integer(int32)

record_type
optional

Record Type
Example : "SOA"

string

rows
optional

Total number of rows
Example : 12

integer(int32)

serverIp
optional

Appliance IP
Example : "10.0.0.5"

string

serverName
optional

Appliance name
Example : "TCPWave00002Remote"

string

server_type
optional

Appliance type value
Example : "BIND AUTH/DHCP"

string

service_name
optional

Service name
Example : "abcservice"

string

source_ip
optional

Source IP
Example : "10.1.10.241"

string

stealth_server
optional

Stealth Server Count
Example : 12

integer(int32)

subnet_group
optional

Subnet group name
Example : "subnetgrp"

string

subnet_id
optional

Subnet ID
Example : 1241

integer(int32)

userId
optional

User ID
Example : 1224

integer(int32)

view_name
optional

View name
Example : "abcview"

string

vlan_id
optional

VLAN Id
Example : "2456"

string

xmlFileName
optional

string

zone_name
optional

Zone name
Example : "abc.com"

string

5.42. Audit Report Details

This class contains information related to all reports. The information includes the administrator details, zone details, email, server details, monitoring alerts details, network details, subnet details, object details, history table details, DHS/DHCP details, schedule jobs details, refresh time, retry time, expire time, negative cache etc.

Name Description Schema

a_records
optional

Total A Record requests for DNS Zone Traffic Report for All Zones.
Example : "10"

string

aaaa
optional

Total AAAA requests for DNS Zone Traffic Report for All Zones.
Example : "10"

string

action_by
optional

Name of the user who performed the action, generic property for all reports.
Example : "john smith"

string

action_time
optional

Time of action performed, generic property for all reports.
Example : "11/24/2016 15:18"

string

action_type
optional

Type of action performed, generic property for all reports.
Example : "Add/Modify/Deleted"

string

actual_response
optional

string

ad_enable
optional

Takes Yes/No value to specify whether zone is Active Directory Enabled or not.
Example : "yes"

string

address
required

IP address, generic property for all reports.
Example : "10.0.1.1"

string

admin_group_name
optional

Admin group name for Employee entitlement report.
Example : "default"

string

admin_id
optional

Takes administrator ID ,generic property for all audit reports.
Example : "432"

string

alloc_type
optional

Allocation type for an object.
Example : "static"

string

ampm
optional

string

autoObjects
optional

Count of auto objects for Network address space utilization report.
Example : "0"

string

cache_dns_server
optional

Cache Appliance IP.
Example : "10.1.2.182"

string

category
optional

Category.
Example : "Too_Little_Traffic"

string

change_ticket
optional

Change Ticket value.
Example : "12345"

string

class_code
optional

Defines class code for DHCP template association report.
Example : "Domain Controller"

string

clientIp
optional

Client IP.
Example : "127.0.0.1"

string

client_source_ip
optional

Client Source IP.
Example : "10.1.2.182"

string

cname_req
optional

Total CNAME requests for DNS Zone Traffic Report for All Zones.
Example : "10"

string

code
optional

Code for server configuration audit report.
Example : "BIND AUTH"

string

configData
optional

Configuration data for Server configuration audit report
Example : "10.0.1.5/10.0.1.6/10.0.1.7/10.0.1.8"

string

configType
optional

Configuration type for Server configuration audit report.
Example : "BANNER"

string

config_name
optional

Configuration name for DHCP Option Template Report.
Example : "subnet-mask"

string

created_by
optional

User Name who has created the specified operation.
Example : "John"

string

created_time
optional

The time instance when the specified operation has been created.
Example : "2022-02-04 05:24:00"

string

data
optional

Target name for a resource record.
Example : "192.168.101.2"

string

date
optional

Takes date as input.
Example : "01/28/2022"

string

debugLevel
optional

string

deploy_date
optional

Deployment date.
Example : "2022-02-22"

string

description
optional

Details of an operation when it is performed.
Example : "A successful login event has been recorded."

string

destination_ip
optional

Destination IP Address.
Example : "10.1.10.205"

string

device
optional

Device name in DHCP Fingerprint Report By Device.
Example : "Mac OS X"

string

dhcp_templ_name
required

Name of the DHCP template.
Example : "Generic"

string

display_name
optional

Display name for DHCP Option Template Report.
Example : "Time Offset"

string

dmz_visible
optional

DMZ Visibility
Example : "Yes/No"

string

dns_option_template
optional

DNS option template for DNS Appliance audit.
Example : "BIND AUTH Default Template"

string

dns_server_template
optional

DNS Appliance template for DNS Appliance audit.
Example : "BIND AUTH1"

string

dnskey
optional

Total number of DNS key requests for DNS Zone Traffic Report for All Zones.
Example : "10"

string

dnssec_enable
optional

Takes Yes/No as input whether DNSSEC option is enable or disable.
Example : "No"

string

domain
required

name of a domain, generic property for all reports.
Example : "tcpwave"

string

domain_name
required

Name of the domain.
Example : "tcpwave.com"

string

dynamicObjects
optional

Count of dynamic objects for Network address space utilization report.
Example : "28"

string

email
optional

Takes email ID ,generic property for all audit reports.
Example : "[email protected]"

string

email_id
optional

Takes email ID of the contact,generic property for all audit reports.
Example : "[email protected]"

string

email_notify
optional

Takes yes/no as input to check the Email notify for network audit.
Example : "No"

string

enable_dynamic_updates
optional

takes yes/No as input, whether the dynamic updates are enable or not.
Example : "No"

string

endDate
optional

Takes start date as input
Example : "11/1/2022"

string

end_id
optional

integer(int32)

end_of_life
optional

End Of life date of an object.
Example : "2019-03-02"

string

error_msg
optional

Message, when any operation is failed or success.
Example : "Job executed successfully."

string

execution_status
optional

Execution status of a schedule job.
Example : "Success"

string

execution_time
optional

Execution time of a schedule job.
Example : "01/20/2022 15:18"

string

expireTime
optional

Expire time of a zone.
Example : 3600

integer(int32)

expire_date
optional

Expiration date.
Example : "2022-02-22"

string

extra_data
optional

Extra data for rpz_query_stats table.
Example : "rewrite google.com via google.com.google.com"

string

extra_params
optional

Extra parameters for a schedule job.
Example : "sessionId:1fqu0o1howzbs1foextz3xz3pj userName:admin remoteAddress:10.2.2.1"

string

failover_server_details
optional

Details of the failover DHCP server.
Example : "Primary Server : 10.1.1.18, Fail Over Server : 10.1.1.19, Primary Port :64, Fail Over Port : 64, Max Response Delay : 30, Max Unpacked Updates : 10, MCLT : 1800, SPLIT : 128, Load Balance Max Secs : 3"

string

fileName
optional

string

fqdn
optional

FQDN
Example : "8.0.0.8.in-addr.arpa"

string

frequency
optional

string

fromtimestamp
optional

From date Time stamp.
Example : "2022-02-04 05:24:00"

string

groupName
optional

Group of a subnet.
Example : "group-1"

string

hist_id
optional

ID for history table.
Example : "45"

string

host_address
required

host name for Monitoring alerts report.
Example : "10.0.0.1"

string

host_name
optional

Host name for Monitoring alerts report.
Example : "ipam-234.tcpwave.com"

string

id
optional

Takes ID as input, generic property for multiple reports.
Example : "45"

string

inactive_date
optional

Inactive date.
Example : "2022-02-22"

string

instance_provider_name
optional

Instance Provider Name
Example : "Google"

string

instance_template_name
optional

Instance Template Name
Example : "template1"

string

ip_address
required

IP Address.
Example : "10.2.6.4"

string

ipv4
required

IPv4 Address.
Example : "10.2.3.5"

string

ipv4_address
required

IPv4 address.
Example : "10.10.1.220"

string

ipv6
required

IPv6 IP Address.
Example : "2000::"

string

isLoaded
optional

string

is_ksk
optional

KSK value(Yes/No).
Example : "Yes/No"

string

is_reverse_zone
optional

Takes True/False as input whether Zone is reverse or not.
Example : "TRUE"

string

jobId
optional

Job ID of a schedule job.
Example : "2452"

string

job_data
optional

Data for a schedule job.
Example : "{\"MajorVersion\":\"11\",\"ServerType\":\"DNS\",\"ZipFile\":\"IPAM_DNS_Patch002.zip\",\"PackageName\":\"TCPWaveDNS\",\"PatchLevel\":\"2\",\"PatchName\":\"DNS Test Patch 002\",\"MinorVersion\":\"8\",\"serverName\":\"server-name\",\"serverIp\":\"10.0.1.189\"}"

string

job_type
optional

Job type of a schedule job.
Example : "Event"

string

length
optional

string

level
required

Permission level for Employee entitlement report.
Example : "Admin"

string

location
optional

Takes location as input.
Example : "22 Main street, Atlantic city, sydney, South Australia-5540"

string

log_notify
optional

Takes yes/no as input to check the Log notify for network audit.
Example : "No"

string

logger
optional

Log channels for DNS templates.
Example : "named"

string

login_name
optional

Login name of the user.
Example : "John Smith"

string

login_time
optional

Login time.
Example : "2022-02-04 05:24:00"

string

logout_time
optional

Logout time.
Example : "2022-02-04 05:24:00"

string

mac
optional

Takes MAC address for DHCP option template association report.
Example : "00:0c:29:c5:68:5c"

string

mac_address
optional

MAC address for Global allocation report.
Example : "65:e1:44:a6:85:7b"

string

manualObjects
optional

Count of manual objects for Network address space utilization report.
Example : "1"

string

mask_length
required

Mask length for subnet or network.
Example : "24"

string

match_clients
optional

Match Client IP.
Example : "10.1.10.2"

string

match_destinations
optional

Match Destination IP.
Example : "10.1.10.2"

string

message
optional

Message.
Example : "Length:768B"

string

monitoring_service
optional

Monitoring service Name
Example : "CHECK_MONIT"

string

mx_req
optional

Total MX requests for DNS Zone Traffic Report for All Zones.
Example : "10"

string

name
optional

Name, generic property for all reports.
Example : "tcpwave"

string

naptr
optional

Total NAPTR requests for DNS Zone Traffic Report for All Zones.
Example : "10"

string

negativeCache
optional

Negative Cache of a zone.
Example : 604800

integer(int32)

networkAddress
required

Network address for audit reports.
Example : "10.0.1.1/24"

string

network_addr
required

Network address for audit reports.
Example : "10.1.0.0/16"

string

network_id
optional

string

network_ip
optional

string

ns
optional

Total NS requests for DNS Zone Traffic Report for All Zones.
Example : "10"

string

nsec_option
optional

Takes Yes/No as input whether Nsec option is enable or disable.
Example : "Yes"

string

objAddress
required

Generic property object address for all audit reports.
Example : "10.0.0.2"

string

obj_count
optional

Total zone to object count.
Example : 24

integer(int32)

object_addr
required

Generic property object address for all audit reports.
Example : "10.0.0.2"

string

object_name
required

Generic property object name for all audit reports.
Example : "object"

string

object_type
optional

Type of an object.
Example : "CRM Server"

string

ofac_countries
optional

List of OFAC Countries.
Example : "North Korea"

string

ofac_ip
optional

Appliance IP in OFAC DNS Query Report.
Example : "10.1.10.185"

string

ofac_name
optional

Appliance Name in OFAC DNS Query Report.
Example : "TCPWave00010Remote"

string

offending_dns_query_response
optional

string

operation
optional

Operation performed on a schedule job.
Example : "Schedule Create"

string

organization_name
optional

name of an organization.
Example : "tcpwave"

string

output
optional

output for Monitoring alerts report.
Example : "CRITICAL: Failed to generate the DNSDR configuration. Exception: Table 'tims.tea_zone' doesn’t exist"

string

owner
optional

Owner name of a resource record.
Example : "www.tcpwave1.com."

string

owner_class
optional

Code for server configuration audit report.
Example : "BIND AUTH"

string

percentage
optional

Percentage full of a network/Subnet.
Example : "10%"

string

percentagefull
optional

Percentage full for a network
Example : "34"

string

periods
optional

takes the period for Canned reports, whether it is Daily/Weekly/Monthly.
Example : "daily"

string

phone_num
optional

Phone Number.
Example : "7236985426"

string

policy_template
optional

Name of the policy template for DHCP server.
Example : "Clone-Policy-1"

string

preference
optional

Preference of the DHCP server.
Example : "Primary"

string

primaryRouter
optional

IP address of a primary router.
Example : "10.0.0.1"

string

primary_domain
optional

Name of the primary domain.
Example : "about-tcpwave.com"

string

producertype
optional

Producer type of Top alerts producers report.
Example : "subnet_full_alert"

string

proxy
optional

Proxy value.
Example : "0/1"

string

ptr
optional

Total PTR requests for DNS Zone Traffic Report for All Zones.
Example : "10"

string

queryA
optional

A
Example : "2345"

string

queryAAAA
optional

AAAA
Example : "2345"

string

queryAFSDB
optional

AFSDB
Example : "2345"

string

queryCAA
optional

CAA
Example : "2345"

string

queryCNAME
optional

CNAME
Example : "2345"

string

queryDKIM
optional

DKIM
Example : "2345"

string

queryDNAME
optional

DNAME
Example : "2345"

string

queryDS
optional

DS
Example : "2345"

string

queryHINFO
optional

HINFO
Example : "2345"

string

queryLOC
optional

LOC
Example : "2345"

string

queryMX
optional

MX
Example : "2345"

string

queryNAPTR
optional

NAPTR
Example : "2345"

string

queryNS
optional

NS
Example : "2345"

string

querySOA
optional

SOA
Example : "2345"

string

querySPF
optional

SPF
Example : "2345"

string

querySRV
optional

SRV
Example : "2345"

string

querySSHFP
optional

SSHFP
Example : "2345"

string

queryTLSA
optional

TLSA
Example : "2345"

string

queryTXT
optional

TXT
Example : "2345"

string

queryURI
optional

URI
Example : "2345"

string

reason
optional

Reason.
Example : "Bad Reputation Host"

string

record_type
optional

Record Type.
Example : "SOA"

string

refreshTime
optional

Refresh time of a zone.
Example : 21600

integer(int32)

remote_ip
optional

IP address used to perform the operation.
Example : "10.2.2.4"

string

repeat_count
optional

Repeat count of a schedule job.
Example : "1"

string

report_type
optional

Report type of the audit reports, generic property for all audit reports.
Example : "dailyFunctionalAdminAuditRpt"

string

retryTime
optional

Retry time of a zone.
Example : 3600

integer(int32)

role
optional

Role of an administrator.
Example : "Functional Administrator"

string

rows
required

Total numbers of rows. Generic property for all audit reports.
Example : 20

integer(int32)

rr_count
required

Total number resource record count.
Example : 5

integer(int32)

run_day
optional

Run day for a schedule job.
Example : "0"

string

schedule_type
optional

Type of a schedule job.
Example : "One time Job"

string

scope
optional

takes scope for DHCP option template association report.
Example : "10.1.12.17-10.1.12.18"

string

scope_count
optional

Total zone to scope count.
Example : 245

integer(int32)

secret_key
optional

DNS TSIG Key secret key
Example : "RS7OpG+ydNGq50usntAezYVjmsA6b"

string

secure_ad_enable
optional

Takes Yes/No value to specify whether zone is a secure Active Directory Enabled or not.
Example : "no"

string

serial
optional

Serial number of zone, generic property for multiple reports.
Example : "2016072939"

string

serialNumber
optional

Serial Number of the specified Zone.
Example : 2016153575

integer(int64)

serverIp
optional

Appliance IP.
Example : "10.11.10.2"

string

server_addr
required

Server address for the audit reports.
Example : "10.1.0.185"

string

server_name
optional

Server name ,generic property for multiple audit reports.
Example : "server-name"

string

server_type
optional

Type of the server.
Example : "BIND AUTH"

string

service_mode
optional

string

service_name
optional

Service name Monitoring alerts report.
Example : "External Authentication"

string

short_name
required

Short name for resource record audit.
Example : "www"

string

snmp_notify
optional

Takes yes/no as input to check the SNMP notify for network audit.
Example : "No"

string

soa
optional

Total SOA requests for DNS Zone Traffic Report for All Zones.
Example : "10"

string

source_ip
optional

Source IP Address.
Example : "10.1.10.205"

string

srv_req
optional

Total SRV requests for DNS Zone Traffic Report for All Zones.
Example : "10"

string

startDate
optional

Takes end date as input
Example : "11/28/2022"

string

start_id
optional

integer(int32)

state
optional

state for Monitoring alerts report
Example : "Critical"

string

staticObjects
optional

Count of static objects for Network address space utilization report.
Example : "30"

string

stats
required

Statistics of a zone which includes most required zones and least required zones.
Example : "25"

string

status
optional

Status of a operation , whether it is success or failed.
Example : "Success"

string

subnetAddress
required

Subnet address for audit reports.
Example : "10.0.1.1/16"

string

subnet_addr
required

Subnet address for audit reports.
Example : "10.0.0.0/24"

string

subnet_address
optional

Address of the subnet
Example : "10.1.2.8"

string

subnet_id
optional

ID of a subnet.
Example : 24

integer(int32)

subnet_name
optional

Name of the subnet.
Example : "subnet1"

string

target_name
required

Takes target name for Employee entitlement report.
Example : "Load Simulation"

string

target_rr
optional

string

target_type
required

Takes target type for Employee entitlement report.
Example : "Subnet Group"

string

template_name
optional

Name of a template
Example : "zone-template-1"

string

template_status
optional

Status of a DNS template.
Example : "Active/Deleted"

string

time
optional

Time when an action is performed.
Example : "05:24:00"

string

time_to_live
optional

Time to live for an object..
Example : "1200"

string

timestamp
optional

Time Stamp.
Example : "2022-02-04 05:24:00"

string

timestamp_date
optional

string

timestamp_time
optional

string

total
optional

Total count of all rows, generic property for all reports.
Example : "47"

string

total_objzonerr
required

Total number zone to object and zone resource record count.
Example : 35

integer(int32)

totalfqdn
optional

Total number of FQDNs.
Example : 10

integer(int32)

totimestamp
optional

To date Time stamp.
Example : "2022-02-04 05:24:00"

string

ttl
optional

Time To Live(TTL) of a resource record.
Example : "5000"

string

txt_req
optional

Total TXT requests for DNS Zone Traffic Report for All Zones.
Example : "10"

string

type
optional

Type of resource record.
Example : "A"

string

unusedObjects
optional

Number of objects which are not used.
Example : "2047"

string

updated_by
optional

User Name who has modified the specified operation.
Example : "John"

string

updated_time
optional

The time instance when the specified operation has been modified.
Example : "2022-02-04 05:24:00"

string

user
optional

User Name.
Example : "John"

string

user_id
optional

ID of a schedule job.
Example : "4562"

string

v4_ipaddress
optional

V4 IP address of network, subnet etc.
Example : "10.2.1.4"

string

v6_ipaddress
optional

IPv6 address.
Example : "5000::"

string

value
optional

Value for zone template.
Example : "60"

string

vendor
optional

Vendor name in DHCP Fingerprint Report By Vendor.
Example : "VMWare , Inc."

string

view_name
required

DNS View name.
Example : "viewdemo"

string

vlan_id
optional

VLAN ID for subnet audit by group report.
Example : "3456"

string

z_name
required

Name of a zone.
Example : "tcpwave.com"

string

zoneRR_count
required

Total number zone to zone resource record count.
Example : 4

integer(int32)

zone_count
required

Total count of zones
Example : 24

integer(int32)

zone_id
optional

ID of a zone.
Example : 1001

integer(int32)

zone_name
required

Zone Name.
Example : "abc.com"

string

5.43. AuditBackup

This class represents an audit backup files information and contains the attributes necessary for Audit backup files functionality in the TCPWave IPAM. The information includes the File Name, File Type, File Size and other related information.

Name Description Schema

action_time
optional

string

attachment
optional

string

audit_history_id
optional

string

change_ticket
optional

string

command
optional

string

created_by_Name
optional

string

created_time_string
optional

string

description
optional

string

error_msg
optional

string

fileName
optional

string

fileSize
optional

integer(int64)

fileType
optional

string

fromDate
optional

string

id
optional

string

ipv4_address
optional

string

login_name
optional

string

multipart
optional

string

name
optional

string

operation
optional

string

organization_id
optional

string

organization_name
optional

string

remote_ip
optional

string

reportType
optional

string

role
optional

string

status
optional

string

target
optional

string

target_instance
optional

string

toDate
optional

string

updated_time_string
optional

string

user_id
optional

string

5.44. AuditHistory

Name Description Schema

action
optional

string

action_status
optional

string

audit_time
optional

string(date-time)

audit_time_string
optional

string

change_ticket
optional

string

description
optional

string

error_msg
optional

string

id
optional

integer(int32)

login_name
optional

string

operation
optional

string

remote_ip
optional

string

role_code
optional

string

role_id
optional

integer(int32)

target
optional

string

user_id
optional

integer(int32)

5.45. Auth Info

This class represents the authorization information for a resource instance in the TCPWave IPAM. The information includes the entity type ( Network, Subnet, Object, Subnet Group ), and the resource instances ( id/name or IP), and the list of Admin Groups and Admins that are associated with that privilege.

Name Description Schema

created_by
optional

Database ID of the user

integer(int32)

created_by_name
optional

Name of the user

string

created_time
optional

Created date and time

string(date-time)

created_time_string
optional

string

updated_by
optional

Database ID of the user

integer(int32)

updated_by_name
optional

Name of the user

string

updated_time
optional

Updated date and time

string(date-time)

updated_time_string
optional

Name of the user

string

5.46. Authentication Configuration

This is a bean class for the TCPWave IPAM Authentication configuration that the user can modify to customize TCPWave IPAM to meet the security standards of the organization. The information includes the rules for password management including the complexity and length, and rules for reusing old password, session inactivity time out, and number of failed attempts before the user account is locked down.

Name Description Schema

allow_similar
required

Allow similar passwords across users or not

boolean

id
optional

Database ID for Authentication Configuration

integer(int32)

max_failed_attempts
required

Get the number of failed login attempts

integer(int32)

min_password_length
required

Minimum Password Length

integer(int32)

password_complexity
required

Level of Password complexity

integer(int32)

password_expiration
required

Number of days for password expiration

integer(int32)

password_reuse
required

Allow reusing a given password or not

integer(int32)

require_new_password
required

Enforce a new user to change the password after the first login

boolean

session_timeout
required

Time in seconds to destroy an active session on idle

integer(int32)

warn_timeout
required

Time in seconds before the session timeout to warn the user

integer(int32)

5.47. Authentication Token

This class represents an Authentication Token. Authentication Tokens are used in the TCPWave IPAM to allow session less REST API access in a secure way. The information identifies the source IP associated with the token, generated date, validity, and the Admin credentials associated with the token. This token is set on the header parameter of a request using TIMS-SESSION-TOKEN key and the actions are authorized and audited with the associated admin credentials.

Name Description Schema

active
optional

Is the token active?
Example : true

boolean

application
optional

Application name
Example : "tims"

string

description
optional

Description
Example : "Test"

string

generated_date
optional

Session token generated date
Example : "03-11-2022"

string(date-time)

id
optional

Database ID of the session token
Example : 23

integer(int32)

ip
optional

IP Address of the target where the session token will be used
Example : "10.10.0.2"

string

request_ip
optional

IP Address
Example : "10.1.10.3"

string

request_user_id
optional

User ID
Example : 323

integer(int32)

token
optional

Session Token String
Example : "fhgh234hhjzdhnckm"

string

validity
optional

Validity of the session token in days
Example : 30

integer(int32)

5.48. Authentication Token Response

This class contains the information related to newly generated authentication token and contains only subset of AuthToken information that is needed to display as response to the new token generate service call.

Name Description Schema

application
optional

Application name
Example : "tims"

string

description
optional

Description
Example : "Test"

string

ip
optional

IP address where session token will be used.
Example : "10.2.2.3"

string

token
optional

Session token string
Example : "56wejnbbyyis6k"

string

5.49. Authentication Type

This class represents authentication mechanism and holds the information related to the authentication module used in TCPWave IPAM for that authentication mechanism, and if that is the active authentication mechanism selected. This information is used internally by the TCPWave IPAM Security module to verify the login user credentials with the appropriate authentication mechanism selected.

Name Description Schema

active
required

Checks if a given authentication mechanism is active or inactive

boolean

auth_module
required

Name of the Authentication Module

string

code
required

Code of a given Authentication Type

string

description
required

Description of the Authentication Module

string

5.50. Authorization Entry

This class represents the permission information entry for a resource instance in TCPWave IPAM. Each entry includes Name, Id and level of the entity.

Name Description Schema

authorized
optional

Is the entry authorized or not
Example : true

boolean

id
optional

Database Id of the entry
Example : 24

integer(int32)

name
optional

Name of the entry
Example : "DefaultAdminGroup"

string

privilege
required

Type of privilege
Example : "READ/READ-WRITE"

string

privilegeCode
required

Integer value for the privilege
Example : "4 = READ; 6 = READ-WRITE"

integer(int32)

5.51. Autonomous System Number

Detailed information about Autonomous System Number.

Name Description Schema

as_number
optional

integer(int64)

created_by_login_name
optional

Name of the User who has created the specified AS Number.
Example : "John"

string

created_time_string
optional

The time instance when the specified AS Number has been created.
Example : "02/28/2022 4:37"

string

description
optional

Description of AS Number.
Example : "This is a appliance group."

string

id
optional

Database ID of the AS number
Example : 1234

integer(int32)

info
optional

AS number Information
Example : "2K21@ SAN"

string

name
optional

Name of AS Number
Example : "Test"

string

oldName
optional

string

oldNumber
optional

integer(int32)

organization_id
required

Id of the Organization which is associated with the specified AS Number.
Example : 990

integer(int32)

organization_name
required

Name of the Organization which is associated to the specified AS Number.
Example : "EARTH"

string

type
optional

AS number Type
Example : "abc"

string

updated_by_login_name
optional

Name of the User who has modified the specified AS Number.
Example : "John"

string

updated_time_string
optional

The time instance when the specified AS Number has been modified.
Example : "02/28/2022 4:37"

string

5.52. BGP Details

This class contains information related to BGP screen.

Name Description Schema

interfaces
required

Array of Interfaces.

< string > array

serverName
required

Appliance name.
Example : "TCPWave00012Remote"

string

staticRoutes
optional

Array of Static Routes Definitions

< BasicStaticRoutes > array

staticRoutesVal
required

Static Routes value.
Example : "staticRoutes"

string

zebraEventsVal
required

Zebra events value.
Example : "zebraEvents"

string

zebraKernelVal
required

Zebra kernel value.
Example : "zebraKernel"

string

zebra_events
required

Enable or Disable of Zebra Events.
Example : false

boolean

zebra_kernel
required

Enable or Disable of Zebra Kernel.
Example : false

boolean

zebra_static
required

Enable or Disable of Zebra Static Routes.
Example : false

boolean

5.53. Basic Object Info

BasicObjectInfo class encapsulates the attributes that are defined at the Object level, such as the name, IP address, Organization, Domain, Description, CNAME Resource Records.

Name Description Schema

address
required

IP Address of this object
Example : "172.16.13.1"

string

description
required

Description of this object
Example : "This is a basic object information."

string

domain_name
required

Domain of this object
Example : "domain.com"

string

name
required

Name of this object
Example : "BasicObject"

string

network_address
required

Network Address of this object
Example : "172.16.0.0"

string

organization_name
required

Organization Name
Example : "QAOrg"

string

rrs
optional

Collection of CNAME Resource Records associated to this object

< Resource Record > array

5.54. BasicStaticRoutes

Name Description Schema

gateway
optional

Gateway of the network
Example : "255.255.255.0"

string

mask
optional

Network mask length
Example : "24"

string

preference
optional

Preference of the route
Example : "255.255.255.0"

string

subnet
optional

Name of the subnet
Example : "region"

string

5.55. BlocksAndNetworks

Name Description Schema

address
optional

string

mask
optional

integer(int32)

name
optional

string

organizationName
optional

string

parentSpace
optional

string

type
optional

string

5.56. Bookmark

This class provide means to obtain list of bookmarks defined in the TCPWave IPAM by the user and to create a new bookmark in the TCPWave IPAM.

Name Description Schema

comment
optional

Comment for the bookmark
Example : "This is a test bookmark."

string

orgId
optional

Database ID of the organization
Example : 21

integer(int32)

orgName
optional

Name of the organization
Example : "TCPWave"

string

queryString
optional

Query string
Example : "address=192.168.0.120&type=BIND AUTH&isClone=no"

string

type
optional

Unique key value to map Bookmark with URI
Example : "dnsserver or ipamAppliance"

string

user
optional

Name of the user
Example : "twcadm"

string

value
optional

Name of Bookmark
Example : "Test"

string

5.57. CentralLoggingConfig

Name Description Schema

configName
optional

string

configProperties
optional

string

configStatus
optional

string

configType
optional

string

created_by
optional

integer(int32)

created_time
optional

string(date-time)

created_time_string
optional

string

created_user
optional

string

description
optional

string

id
optional

integer(int32)

oldConfigProperties
optional

string

updated_by
optional

integer(int32)

updated_time
optional

string(date-time)

updated_time_string
optional

string

updated_user
optional

string

5.58. CentralLoggingFullConfig

Name Description Schema

centralLoggingConfig
optional

CentralLoggingConfig

centralLoggingConfigs
optional

< CentralLoggingConfig > array

dhcpLogs
optional

< CentralLoggingServerLog > array

dnsLogs
optional

< CentralLoggingServerLog > array

ipamLogs
optional

< CentralLoggingServerLog > array

5.59. CentralLoggingServerLog

Name Description Schema

created_by
optional

integer(int32)

created_time
optional

string(date-time)

created_time_string
optional

string

created_user
optional

string

description
optional

string

id
optional

integer(int32)

logName
optional

string

logPath
optional

string

logProperties
optional

string

logStatus
optional

string

logType
optional

string

serverType
optional

string

updated_by
optional

integer(int32)

updated_time
optional

string(date-time)

updated_time_string
optional

string

updated_user
optional

string

5.60. Certificate

Certificate class represents an SSL certificate. It holds the information related to SSL certificate including the serial number, issuer, validity, signature and other information. This class is used in the service calls to import a customer specified SSL certificate into the TCPWave IPAM Web Server.

Name Description Schema

cert_name
required

Name of the certificate.
Example : "User_Certificate"

string

issuer
optional

Issuer of the certificate.

string

serial_number
optional

Serial number of the certificate.
Example : "12345"

string

valid
optional

Is the certificate valid?
Example : true

boolean

valid_from
optional

Certificate validity start date.
Example : "02/18/2022"

string

valid_to
optional

Certificate validity end date.
Example : "02/17/2022"

string

5.61. ChartSample

Name Description Schema

ip
optional

object

name
optional

object

time
optional

integer(int64)

value
optional

object

5.62. ChartsData

Name Description Schema

dataMap
optional

< string, < ChartSample > array > map

ip
optional

string

maxHeap
optional

integer(int64)

name
optional

string

5.63. Child Reverse Zone

This class represents a Zone and contains the attributes necessary for Zone management functionality in the TCPWave IPAM. The information includes the Zone Name, Template Name and other Zone related information.

Name Description Schema

name
required

Name of a reverse zone.
Example : "10.in-addr.arpa"

string

networkAddress
optional

Reverse zone network full address.
Example : "192.168.0.0"

string

networkMask
optional

Reverse zone network mask length.
Example : 24

integer(int32)

5.64. Class Code

This class provides handle to Add, Delete and Update Object type in the TCPWave IPAM. It also provides a list of all available Object types in TCPWave IPAM.

Name Description Schema

code
required

Object type
Example : "Windows"

string

created_by
optional

ID of the user who created this object type
Example : 45

integer(int32)

created_by_login_name
optional

The User’s name, who has logged into the TCPWave IPAM, has been set as Created By for the specified Domain.
Example : "Stephen"

string

created_by_name
optional

Name of the user who created this object type
Example : "user"

string

created_time
optional

Created time of the object type
Example : "05:21:35 02-01-2022"

string(date-time)

created_time_string
optional

String format of the time instance when the specified object type has been created.
Example : "05:21:35 02-01-2022"

string

description
optional

Description for this object type
Example : "Windows object type."

string

initial_seq_num
required

Initial sequence number used as suffix in the object name.
Example : 1

integer(int32)

logo
required

Object type logo
Example : "/tims/img/custom-object-types/windows2.png"

string

old_class_code
optional

Old object type
Example : "3G Phone"

string

prefix
required

Prefix value of the Object type name
Example : "3G"

string

prefix_zeros
required

Allow prefix zeros
Example : "yes/no"

string

suffix
required

Suffix of the Object type name
Example : "Phone"

string

updated_by
optional

ID of the user who updated this object type
Example : 45

integer(int32)

updated_by_login_name
optional

The User’s name, who has logged into the TCPWave IPAM, has been set as Created By for the specified Domain.
Example : "John"

string

updated_by_name
optional

Name of the user who updated this object type
Example : "user"

string

updated_seq_num
required

Generated sequence number to be used to create the object name
Example : 5

integer(int32)

updated_time
optional

Updated time of the object type
Example : "05:21:35 02-01-2022"

string(date-time)

updated_time_string
optional

String format of the time instance when the specified object has been updated.
Example : "05:21:35 02-01-2022"

string

This class represents the file path for rendering logos for various object types.

Type : object

5.66. Cloud Hosted Subnet

Cloud Hosted Subnet holds information about Auto Cloud Import status

Name Description Schema

autoImportEnabled
optional

Is auto cloud import enabled on this subnet?
Example : true

boolean

cloudProviderName
optional

Cloud provider name mapped to the subnet
Example : "Test"

string

cloudProviderType
optional

Cloud provider type
Example : "AWS"

string

id
optional

Database ID of the cloud hosted subnet
Example : 34

integer(int32)

subnetAddress
optional

Subnet address
Example : "10.1.2.0/24"

string

updatedBy
optional

User who updated the cloud hosted subnet information
Example : 321

integer(int32)

updatedByLoginName
required

Login name of the user who has updated the specified AWS Image.
Example : "Stephen"

string

updatedTime
required

AWS Image Updated Time
Example : "10:20:20 01-20-2022"

string(date-time)

updatedTimeStr
required

AWS Image Updated Time
Example : "10:20:20 01-20-2022"

string

5.67. Cloud Instance Bean

CloudInstanceBean class encapsulates the attributes that are defined at the Cloud Instance, such as the zone name, machine type, image etc.

Name Description Schema

dnsName
optional

DNS name of the cloud instance
Example : "AWS172311623.test.com"

string

objectAddress
required

Address of the cloud instance object
Example : "10.31.16.23"

string

objectId
optional

Database ID of the cloud instance object
Example : 501

integer(int32)

objectName
required

Name of the cloud instance object
Example : "AWS172311623"

string

organizationId
optional

Database ID of the organization to which cloud instance object is associated
Example : 1

integer(int32)

organizationName
required

Name of the organization to which cloud instance object is associated
Example : "Internal"

string

providerTemplate
required

Cloud instance template to which cloud instance object is associated

Cloud Instance Template

publicIP
optional

Public IP address of the cloud instance

string

status
required

Status of the cloud instance
Example : "RUNNING"

string

subnetAddress
required

Subnet Address to which the cloud instance object is associated
Example : "10.31.16.0"

string

templateId
optional

Database ID of the cloud instance template to which cloud instance is associated
Example : 101

integer(int32)

templateName
required

Name of the cloud instance template to which cloud instance is associated
Example : "AWS-Instance-Provisioning-Template"

string

5.68. Cloud Instance Template

CloudInstanceTemplate class encapsulates the attributes that are defined at the Cloud Instance Template, such as the name, cloud provider, description etc.

Name Description Schema

cloudProviderId
required

Database cloud provider ID associated with this cloud instance template
Example : 21

integer(int32)

cloudProviderName
required

Cloud provider name associated with this cloud instance template
Example : "AWS-Provider"

string

cloudProviderType
required

Cloud provider type associated with this cloud instance template
Example : "AWS"

string

created_by_name
optional

Name of the user who created this cloud instance template
Example : "admin"

string

created_time_string
optional

String instance of the created time
Example : "2022-01-20 03:16:04"

string

description
required

Description for this cloud instance template
Example : "AWS Instance template test"

string

id
optional

Database ID of cloud instance template
Example : 101

integer(int32)

instanceTmplJsonStr
required

Cloud provider specific JSON string required to create the cloud instance template
Example : "'{\"zone\":\"us-east1-b\",\"machineType\":\"f1-micro\",\"bootDiskImageFamily\":\"centos\",\"bootDiskImage\":\"centos-6-v20180401\",\"nonDepricatedImage\":true,\"bootDiskType\":\"pd-standard\",\"bootDiskSize\":\"10\",\"bootDiskAutoDelete\":true,\"allowHttpTraffic\":true,\"allowHttpsTraffic\":true}'"

string

name
required

Name of the cloud instance template
Example : "AWS-Instance-Provisioning-Template"

string

newName
required

New name of the cloud instance template
Example : "Default-AWS-Instance-Provisioning-Template"

string

organizationId
optional

Database ID of the organization
Example : 1

integer(int32)

organizationName
required

Name of the organization associated with this cloud instance template
Example : "Internal"

string

updated_by
optional

Database ID of the user who updated this cloud instance template
Example : 21

integer(int32)

updated_by_name
optional

Name of the user who updated this cloud instance template
Example : "admin"

string

updated_time_string
optional

String instance of the updated time
Example : "2022-01-20 05:26:05"

string

5.69. Cloud Subnet Bean

Cloud subnet bean holds information about the cloud enabled subnet

Name Description Schema

cloudProviderId
optional

Cloud provider ID
Example : 34

integer(int32)

cloudProviderName
optional

Cloud provider name
Example : "TestProvider"

string

cloudProviderType
optional

Cloud provider type
Example : "AWS"

string

fullAddress
optional

Subnet address
Example : "10.1.10.0/24"

string

name
optional

Subnet name
Example : "TestSubnet"

string

organizationId
optional

Organization ID
Example : 23

integer(int32)

organizationName
optional

Organization name
Example : "Internal"

string

subnetTemplateId
optional

Subnet template ID
Example : 34

integer(int32)

subnetTemplateName
optional

Subnet template name
Example : "TestSubnetTemplate"

string

5.70. Cloud Subnet Creation Status Information

This bean holds information about the cloud subnet creation status

Name Description Schema

status
optional

Subnet creation status (Created/Failed)
Example : "Created"

string

statusMsg
optional

Subnet creation status message
Example : "Subnet 10.1.10.0/24 has been created successfully."

string

subnet
optional

Subnet address
Example : "10.1.10.0/24"

string

success
optional

Is subnet creation success or not?
Example : true

boolean

5.71. Cloud Subnets Creation Status in the IPAM

This class encapsulates the information which indicates import subnets status after importing the cloud subnets into the TCPWave IPAM.

Name Description Schema

created
optional

Number of subnets successfully created
Example : 30

integer(int32)

failed
optional

Number of subnets failed to import
Example : 20

integer(int32)

statusMessages
optional

List of SubnetCreateInfo instances

< Cloud Subnet Creation Status Information > array

tolalRequested
optional

Total Number of requested subnets
Example : 50

integer(int32)

5.72. CloudGeoLocations

Name Description Schema

continentCode
optional

Continent code
Example : "AS"

string

continentname
optional

Name of the continent
Example : "ASIA"

string

countryCode
optional

Country code
Example : "IN"

string

countyName
optional

Name of the country
Example : "INDIA"

string

type
optional

string

5.73. CloudHealthCheckerforAliasRRS

Name Description Schema

healthCallerReference
optional

Reference of the health checker
Example : "43ce0b8f-4e1b-4568-8f95-b8988c01b053"

string

healthCheckversion
optional

Version of the health checker
Example : "2.0"

integer(int64)

healthID
optional

ID of the health checker
Example : "43ce0b8f-4e1b-4568-8f95-b8988c01b053"

string

5.74. CloudRR

Name Description Schema

addedARRs
optional

< CloudRR > array

data
optional

string

deletedARRs
optional

< CloudRR > array

domain
optional

string

evaluateHealthTarget
optional

boolean

failover
optional

boolean

geoLocation
optional

string

healthCheck
optional

boolean

healthCheckID
optional

string

hostedZoneID
optional

string

id
optional

integer(int32)

isAliasType
optional

boolean

name
optional

string

region
optional

string

routingPolicy
optional

string

setIdentifier
optional

string

ttl
optional

integer(int32)

type
optional

string

value
optional

string

weight
optional

integer(int64)

zone_id
optional

integer(int32)

5.75. CloudResource

Name Description Schema

account
optional

string

cloudProviderId
optional

integer(int32)

iamRole
optional

string

id
optional

integer(int32)

region
optional

string

resourceName
optional

string

resourceType
optional

integer(int32)

5.76. CloudResourceWrapper

Name Description Schema

account
optional

string

cloud_provider_id
optional

integer(int32)

cloud_provider_name
optional

string

cloud_provider_type
optional

string

iam_role
optional

string

id
optional

integer(int32)

old_resource_name
optional

string

organization_name
optional

string

region
optional

string

resource_name
optional

string

resource_type
optional

string

5.77. Column Metadata

This class holds the metadata related to a given column of import type.

Name Description Schema

mandatory
optional

Is the column mandatory for the import
Example : true

boolean

maxLength
optional

Maximum length of the data allowed for the column
Example : 30

integer(int32)

minLength
optional

Minimum length of the data allowed for the column
Example : 3

integer(int32)

name
optional

Column name
Example : "IP Address"

string

type
optional

Column type
Example : "IP"

enum (INT, STR, ENUM_0, IP, STR_LIST, DOMAIN, DOMAIN_ARRAY, MAC, EMAIL, SUPRESS, RR_TYPE, CLASS, PHONE_NUM, DATE, REGEX, IP_LIST)

xtnId
optional

Get extension attribute Id
Example : 3

integer(int32)

5.78. Component

Name Description Schema

component
optional

Name or Address of the Component
Example : "ns0001"

string

componentId
optional

Database ID of the Component
Example : 364

integer(int32)

componentType
required

Type of the Component
Example : "DNS"

string

5.79. Contacts Information

This class encapsulates the information of various contacts defined.

Name Description Schema

created_by_name
required

Login name of the user who created this entity

string

created_time_string
optional

String instance of the Date and Time

string

email_id
required

Email address of the contact

string

first_name
required

First name of the contact

string

full_name
required

Full name of the contact

string

id
optional

ID of this Contact

integer(int32)

last_name
required

Last name of the contact

string

middle_name
required

Middle name of Contact

string

old_email_id
required

Previous email id of the contact being updated.

string

old_first_name
required

Previous first name of the contact being updated.

string

old_last_name
required

Previous last name of the contact being updated.

string

old_middle_name
required

Previous middle name of the contact being updated.

string

organization_id
optional

Database ID of the organization to which this contact belongs

integer(int32)

organization_name
required

Organization name of the contact to which this contact belongs

string

phone_num
required

Phone number of the contact

string

roles
required

Role of the contact

string

updated_by_name
required

Login name of the user who updated this entity

string

updated_time_string
optional

String instance of the Date and Time

string

5.80. Countries list

List of countries.

Name Description Schema

countryCode
optional

string

countryName
optional

string

id
optional

integer(int32)

5.81. Create Network Request

This class holds the information required to create network in cloud.

Name Description Schema

cloudProviderName
optional

Cloud provider name
Example : "AWS"

string

dhcpOptionsSetId
optional

DHCP Option Set ID
Example : "Test"

string

endIP
optional

End IP of IP range.
Example : "10.0.0.255"

string

fullAddress
optional

Network address
Example : "10.1.10.0/24"

string

mask
optional

Mask length of the network
Example : 24

integer(int32)

name
optional

Name of the network
Example : "Test"

string

orgName
optional

Name of the organization
Example : "Internal"

string

series
optional

Network Series. It accepts 10, 172 or 192
Example : "10"

string

startIP
optional

Start IP of IP range.
Example : "10.0.0.1"

string

tenancy
optional

Tenancy of the network
Example : "Dedicated"

string

5.82. Create Network Response

This class holds the information of the network created in cloud.

Name Description Schema

dhcpOptionsId
optional

DHCP Option Set ID
Example : "Test"

string

instanceTenancy
optional

Tenancy of the network
Example : "Dedicated"

string

isDefault
optional

Is this network default one?
Example : true

boolean

state
optional

State of the network
Example : "Pending"

string

v4FullAddress
optional

Network address
Example : "10.1.10.0/24"

string

vpcId
optional

Network ID
Example : "vpc-10"

string

5.83. Create Scope Request

Name Description Schema

dyn_update_rrs_a
required

Boolean value for Dynamic DNS Update of A resource records for DHCP lease objects
Example : true

boolean

dyn_update_rrs_cname
required

Boolean value for Dynamic DNS Update of CNAME resource records for DHCP lease objects
Example : true

boolean

dyn_update_rrs_mx
required

Boolean value for Dynamic DNS Update of MX resource records for DHCP lease objects
Example : true

boolean

dyn_update_rrs_ptr
required

Boolean value for Dynamic DNS Update of PTR resource records for DHCP lease objects
Example : true

boolean

scope
required

Scope Information

Scope Information

subnetAddress
required

Subnet address of the scope
Example : "10.0.0.1"

string

ttl
required

TTL value for the scope objects
Example : 1200

integer(int32)

update_ns_a
required

Boolean value to update Name Services A resource records for DHCP lease objects
Example : true

boolean

update_ns_ptr
required

Boolean value to update Name Services PTR resource records for DHCP lease objects
Example : true

boolean

v6Scope
required

IPV6 Scope

IPV6 Scope

5.84. Create Subnet Request

This class holds the information required to create subnet in cloud.

Name Description Schema

cloudProviderName
optional

Cloud provider name
Example : "AWS"

string

mask
optional

Mask length of the subnet
Example : 24

integer(int32)

name
optional

Name of the subnet
Example : "Test"

string

networkFullAddress
required

Name of the region where subnet is being created
Example : "us-east1"

string

orgName
optional

Name of the organization
Example : "Internal"

string

region
required

Name of the region where subnet is being created
Example : "us-east1"

string

subnetFullAddress
optional

Subnet address
Example : "10.1.10.0/24"

string

vpcId
optional

Network ID
Example : "vpc-10"

string

5.85. Create Subnet Response

This class holds the information of the subnet created in cloud.

Name Description Schema

availableIpsCount
optional

Available IP count in the subnet
Example : 150

integer(int32)

state
optional

State of the subnet
Example : "Pending"

string

subnetAddress
optional

Subnet address
Example : "10.1.10.0/24"

string

subnetId
optional

Subnet ID
Example : "subnet-01"

string

vpcId
optional

Network ID
Example : "vpc-10"

string

5.86. DBDiscoveryCommand

The class includes discovery of Database and list the discovered information and set the status on the discovery command.

Name Description Schema

cmdId
required

Command ID
Example : 238

integer(int32)

current
optional

Current Command

integer(int32)

endTime
optional

End Time

string

ipAdd
required

IP Address

string

mask
required

Return Mask

string

noDevicesDiscovered
optional

Un-Discovered Devices

integer(int32)

numberOfDevicesInSubnet
optional

Number Of Devices In Subnet

integer(int32)

numberOfDevicesPolled
required

Number Of Devices Polled

integer(int32)

orgName
required

Name of the organization
Example : "Internal"

string

seedRouterList
optional

Seed Routers List

string

startTime
optional

Start Time

string

status
required

Status

string(byte)

statusName
required

Status Name

string

subnetWithMask
optional

Subnet with Mask

string

type
required

Type

string(byte)

vrfName
required

Name of the VRF

string

5.87. DHCP Appliance

Holds the properties that are specific to a DHCP Appliance. That are used to generate the DHCP configuration.

Name Description Schema

macExclusionArray
optional

Array of MAC Addresses to exclude from a lease grant

< MAC Addresses Information > array

server
optional

Server Information

Server Information

5.88. DHCP Appliance Statistics Details

This class contains information related to all DHCP Appliance Statistics used in DHCP Appliance Statistics Report.

Type : object

5.89. DHCP Class

Holds the name, description and match expression for DHCP Client, Vendor and User class definitions.

Name Description Schema

created_by
optional

Database ID of the user who created this entity

integer(int32)

created_by_login_name
optional

Login name of the user who created this entity

string

created_by_name
required

Login name of the user who created this entity

string

created_time
required

Date and Time of creation of the entity

string(date-time)

created_time_string
optional

String instance of the Date and Time

string

description
required

Description of the DHCP Class

string

entity_type
required

Entity Type of the DHCP Class (CLIENT/VENDOR/USER)

string

id
optional

Database ID of the DHCP Class

integer(int32)

match_expression
required

Match Expression of the given DHCP Class

string

name
required

Name of the DHCP Class

string

previous_name
required

Previous name of the DHCP Class

string

updated_by
optional

Database ID of the user who updated this entity

integer(int32)

updated_by_login_name
optional

Login name of the user who updated this entity

string

updated_by_name
required

Login name of the user who updated this entity

string

updated_time
optional

Date and Time of updating the entity

string(date-time)

updated_time_string
required

String instance of the Date and Time

string

5.90. DHCP Failover

Encapsulates the DHCP Failover Server Configuration such as, Failover address, Port essential to perform DHCP peer to peer communication, Split ratio etc.

Name Description Schema

created_by
required

Id of the User who has created the DHCP peer.
Example : 2017

integer(int32)

created_by_login_name
required

The User’s name, who has logged into the TCPWave IPAM, has been set as Created By for the specified DHCP peer.
Example : "Stephen"

string

created_time_string
optional

String format of the time when the specified DHCP peer is created.
Example : "03/18/2022 3:39"

string

description
optional

Description for the DHCP Peer.
Example : " Tcpwave peer1"

string

dhcp_type
required

DHCP Appliance type
Example : "dhcp/msdhcp"

string

failoverServerAddress
required

DHCP Peer Configuration failover appliance IP Address
Example : "10.1.20.8"

string

failoverServerName
required

Name of the failover appliance.
Example : "est015-sl09115"

string

failoverState
optional

Failover state of the DHCP failover peer
Example : "normal"

string

failover_port
required

DHCP Failover appliance Port number for peer Configuration
Example : 648

integer(int32)

load_balance_max_secs
required

DHCP Failover Configuration Parameters for load balance(in sec)
Example : 3

integer(int32)

max_response_delay
required

Maximum Response delay (in sec)
Example : 30

integer(int32)

max_unacked_updates
required

Maximum unpacked updates
Example : 30

integer(int32)

mclt
required

Maximum client lease time for failover configuration(in sec)
Example : 1800

integer(int32)

message_authentication
optional

Microsoft DHCP appliance failover configuration parameter to enable/disable message authentication between peer appliances
Example : true

boolean

name
required

DHCP Peer name
Example : "failoverPeer1"

string

oldName
required

DHCP Peer previous name
Example : "failoverPeer"

string

organizationName
required

Organization name
Example : "Internal"

string

primaryServerAddress
required

DHCP Peer Configuration Primary appliance IP Address
Example : "10.1.20.5"

string

primaryServerName
required

Name of the primary appliance.
Example : "est015-sl09113"

string

primaryState
optional

Primary state of the DHCP failover peer
Example : "normal"

string

primary_port
required

DHCP Primary appliance Port number for peer Configuration
Example : 647

integer(int32)

shared_secret
optional

Shared secret key for Microsoft DHCP appliance failover communication
Example : "abc123"

string

split
required

Load balancing share percentage
Example : 50

integer(int32)

sso_interval
optional

State switch over interval time duration(in seconds)
Example : 2

integer(int32)

status
optional

Status of the DHCP failover peer
Example : true

boolean

updated_by
required

Id of the User who has modified the specified DHCP peer.
Example : 123

integer(int32)

updated_by_login_name
required

The User’s name, who has logged into the TCPWave IPAM, has been set as updated By for the specified DHCP Peer.
Example : "John"

string

updated_time_string
optional

String format of the time when the specified DHCP peer is modified.
Example : "03/18/2022 4:37"

string

5.91. DHCP Option Space

DHCP option space class encapsulates the attributes of a generic Option space.

Name Description Schema

created_by
required

Id of the User who has created the specified DHCP Option Space.
Example : 2017

integer(int32)

created_by_name
optional

Name of the User who has created the specified DHCP Option Space.
Example : "Stephen"

string

created_time
optional

The time instance when the specified DHCP Option Space has been created.
Example : "05:21:35 02-01-2022"

string(date-time)

created_time_string
optional

String format of the time when the specified DHCP Option Space is created.
Example : "05:21:35 02-01-2022"

string

description
required

Description for option space
Example : "Integrated with DB sub options "

string

optionSpaceName
required

option space name
Example : "optionSpacedb"

string

prevoptionSpaceName
required

Previous option space name
Example : "optionSpacedb1"

string

updated_by
required

Id of the User who has modified the specified DHCP Option Space.
Example : 2019

integer(int32)

updated_by_name
optional

Name of the user who has modified the DHCP Option Space.
Example : "John"

string

updated_time
optional

The time instance when the specified DHCP Option Space has been modified.
Example : "05:21:35 02-01-2022"

string(date-time)

updated_time_string
optional

String format of the time when the specified DHCP Option Space is modified.
Example : "05:21:35 02-01-2022"

string

vendorClassName
optional

Vendor class identifier
Example : "Apple"

string

5.92. DHCP active lease count

This class gives the information of IPv4 and IPv6 DHCP active lease and free objects count.

Type : object

5.93. DHCPApplianceDefaults

Name Description Schema

created_by
required

IPAM appliance template created by user Id
Example : 1219

integer(int32)

created_by_name
optional

IPAM appliance template created by user name
Example : "twcuser"

string

created_time
optional

IPAM appliance template created time stamp
Example : "1222221231"

string(date-time)

elevatedPrivilegesConfig
optional

Elevated Privileges Configuration Details
Example : "{\"environmentVariables\":[{\"value\":\"Defaults always_query_group_plugin\"}],\"userAliases\":[{\"user_alias_name\":\"USER_ALIAS_1\",\"user_alias_value\":\"testuser\"}],\"hostAliases\":[{\"host_alias_name\":\"HOST_ALIAS_1\",\"host_alias_value\":\"192.168.0.139\"}],\"runasAliases\":[{\"runas_alias_name\":\"RUNAS_ALIAS_1\",\"runas_alias_value\":\"user2\"}],\"commandAliases\":[{\"command_alias_name\":\"COMMAND_ALIAS_1\",\"command_alias_value\":\"/cp\"}],\"userSpecifications\":[{\"user_alias\":\"USER_ALIAS_1\",\"host_alias\":\"HOST_ALIAS_1\",\"runas_alias\":\"RUNAS_ALIAS_1\",\"runas_group_alias\":\"\",\"command_alias\":\"COMMAND_ALIAS_1\",\"taglist\":\"\"}]}"

string

elevatedPrivilegesJson
optional

Elevated Privileges Configuration JSON String
Example : "{\"environmentVariables\":[{\"value\":\"Defaults always_query_group_plugin\"}],\"userAliases\":[{\"user_alias_name\":\"USER_ALIAS_1\",\"user_alias_value\":\"testuser\"}],\"hostAliases\":[{\"host_alias_name\":\"HOST_ALIAS_1\",\"host_alias_value\":\"192.168.0.139\"}],\"runasAliases\":[{\"runas_alias_name\":\"RUNAS_ALIAS_1\",\"runas_alias_value\":\"user2\"}],\"commandAliases\":[{\"command_alias_name\":\"COMMAND_ALIAS_1\",\"command_alias_value\":\"/cp\"}],\"userSpecifications\":[{\"user_alias\":\"USER_ALIAS_1\",\"host_alias\":\"HOST_ALIAS_1\",\"runas_alias\":\"RUNAS_ALIAS_1\",\"runas_group_alias\":\"\",\"command_alias\":\"COMMAND_ALIAS_1\",\"taglist\":\"\"}]}"

string

ldapSSHConfig
optional

JSON string of the LDAP SSH configuration - for Internal use only

string

syslogConfig
optional

JSON string of the Syslog-ng configuration – for Internal use only

string

syslogNgConfig
optional

Syslog-NG Configuration Details

Syslog-ng configuration details

tacacsConfig
optional

JSON string of the TACACS configuration - for Internal use only

string

tacacsConfigDecrypted
optional

JSON decrypted string of the TACACS configuration - for Internal use only

string

updated_by
optional

IPAM appliance template updated by user Id
Example : 1219

integer(int32)

updated_by_name
optional

IPAM appliance template updated by user name
Example : "twcuser"

string

updated_time
optional

IPAM appliance template updated time stamp
Example : "1222221231"

string(date-time)

5.94. DHCPLeaseObject

Name Description Schema

address
required

DHCP lease object address
Example : "10.2.3.5"

string

dhcpServer
required

DHCP appliance name
Example : "DHCP_appliance"

string

ends
optional

Lease duration end time
Example : "02/28/2022 11:27:30"

string

fingerPrintData
optional

Finger print data

Fingerprint data information

mac
required

Hardware Address of object
Example : "aa:bb:cc:dd:ee:ff"

string

name
required

Client host name of the object
Example : "ctxs-phone"

string

starts
optional

Lease duration start time
Example : "02/28/2022 1:27:30"

string

5.95. DHCPTrafficChart

Name Description Schema

acknowledge
optional

integer(int32)

discover
optional

integer(int32)

offer
optional

integer(int32)

release
optional

integer(int32)

request
optional

integer(int32)

server_name
optional

string

start_time
optional

string

5.96. DNS Appliance Statistics Details

This class contains information related to all DNS Appliance Statistics used in DNS Appliance Statistics Report.

Name Description Schema

action_time
optional

string

appliance_type
optional

string

badvers
optional

integer(int32)

boot_time
optional

string

config_time
optional

string

id
optional

string

ipv4_address
optional

string

noerror
optional

integer(int32)

notauth
optional

integer(int32)

notzone
optional

integer(int32)

nxdomain
optional

integer(int32)

qryauthans
optional

integer(int32)

qrydropped
optional

integer(int32)

qryduplicate
optional

integer(int32)

qrynoauthans
optional

integer(int32)

qrynxdomain
optional

integer(int32)

qryrecursion
optional

integer(int32)

qryreferral
optional

integer(int32)

qryservfail
optional

integer(int32)

qrysuccess
optional

integer(int32)

qrytcp
optional

integer(int32)

qryudp
optional

integer(int32)

refused
optional

integer(int32)

reqedns0
optional

integer(int32)

reqtcp
optional

integer(int32)

requestv4
optional

integer(int32)

respedns0
optional

integer(int32)

response
optional

integer(int32)

server_name
optional

string

servfail
optional

integer(int32)

total_queries
optional

integer(int32)

totalrows
optional

string

version
optional

string

5.97. DNS Appliance Template

This class represents a DNS Appliance Template and contains the attributes necessary for DNS Appliance Template management functionality in TCPWave IPAM. The information includes the Access Control List(ACL) List, Algorithm List, Appliance Type and other DNS Appliance Template related information.

Name Description Schema

acls
required

List of all Access Control List associated to the specified DNS Appliance Template.

< Access Control List(ACL) > array

addedforwarders
optional

< ForwardersCategory > array

algos
required

List of all DNS signing Algorithm associated to the specified DNS Appliance Template.

< Algorithm > array

created_by
required

Id of the User who has created the specified DNS Appliance Template.
Example : 2017

integer(int32)

created_by_login_name
optional

The User’s name, has logged into the TCPWave IPAM, has been set as Created By for the specified DNS Appliance Template.
Example : "Stephen"

string

created_by_name
optional

User Name who has created this DNS Appliance Template.
Example : "Stephen"

string

created_time
optional

The time instance when the specified DNS Appliance Template has been created.
Example : "03/18/2022 3:39"

string(date-time)

created_time_string
optional

String format of the time when the specified DNS Appliance Template has been created.
Example : "03/18/2022 3:39"

string

deletedforwarders
optional

< ForwardersCategory > array

description
optional

Description for the specified DNS Appliance Template.
Example : "DNS Appliance Template for BIND Auth Appliance type."

string

dmzForwarders
optional

Semicolon separated list of IPv4 addresses of internal resolvers for DMZ cache forwarding.
Example : "192.168.0.20;172.16.0.2"

string

email_id
optional

E-mail id of the user for the specified DNS Appliance Template.
Example : "[email protected]"

string

enable_dnstap
required

Specifies whether DNSTAP logs for the specified DNS Appliance Template is enabled or not.
Example : true

boolean

enable_dynamic_updates
required

Specifies whether dynamic update for the specified DNS Appliance Template is enabled or not.
Example : true

boolean

forwarders
optional

< ForwardersCategory > array

id
optional

ID of the specified DNS Server Template.
Example : 84

integer(int32)

loggers
required

List of the log categories and log channels for the specified DNS Appliance Template.

< Logger > array

name
required

Name of the specified DNS Appliance Template.
Example : "Bind Auth Appliance Template"

string

new_name
optional

Modified name for the specified DNS Appliance Template.
Example : "BIND CACHE Appliance Template"

string

server_type_code
required

Code of the Appliance type for the specified DNS Appliance Template.
Example : "BIND AUTH"

string

server_type_id
required

ID of the Appliance type for the specified DNS Appliance Template.
Example : 128

integer(int32)

updated_by
required

Id of the User who has modified the specified DNS Appliance Template.
Example : 2019

integer(int32)

updated_by_login_name
optional

The User’s name, who has logged into the TCPWave IPAM, has been set as Updated By for the specified DNS Appliance Template.
Example : "John"

string

updated_by_name
optional

User Name who has modified the specified DNS Appliance Template.
Example : "John"

string

updated_time
optional

The time instance when the specified DNS Appliance Template has been modified.
Example : "03/18/2022 4:37"

string(date-time)

updated_time_string
optional

String format of the time when the specified this DNS Appliance Template has been updated.
Example : "03/18/2022 4:37"

string

5.98. DNS Appliance Tool

This class represents a DNS Tool and contains the attributes necessary for DNS Tool management functionality in the TCPWave IPAM. The information includes the Resource Record Name, Resource Record Value, Resource Record Type, Domain Name and other DNS Tool related information.

Name Description Schema

dnssec_details
required

DNSSEC Details (Key).

string

domain_id
required

Id of the Domain for the specified Converge Resource Record.
Example : 135978

integer(int32)

domain_name
required

Name of the Domain for the specified Converge Resource Record.
Example : "edu.com"

string

getdnssec_enabled
required

DNSSEC is Enabled/Disabled (true/false)

boolean

maskLength
optional

Network mask length
Example : 24

integer(int32)

obj_type
required

Address type of the specified Object.
Example : "IPv4"

string

organization_id
required

Id of the Organization for the specified Converge Resource Record.
Example : 998

integer(int32)

organization_name
required

Name of the organization.
Example : "EARTH"

string

rev_zone_name
required

Name of the Reverse Zone for the specified Network.
Example : "0-17.144.133.in-addr.arpa"

string

rr_data
required

Data of the Resource Record for the Converge Resource Record.

string

rr_fqdn
required

Fully qualified domain name for the specified Converge Resource Record.

string

rr_name
required

Short name of the Resource Record Name for the Converge Resource Record.
Example : "www.edu.com"

string

rr_type
required

Type of the Resource Record for the specified Converge Resource Record.
Example : "A"

string

rr_value
required

Value Resource Record for the specified Converge Resource Record.
Example : "10.0.0.1"

string

server_ip
required

IP Address of DNS Appliance for the specified Converge Resource Record.
Example : "10.1.10.191"

string

server_name
required

Name of the DNS Appliance for the specified Converge Resource Record.
Example : "nuslax-sl0983-191.edu.com"

string

server_type
required

Type of DNS Server i.e. Master or Slave for the specified Converge Resource Record.
Example : "Master"

string

server_type_code
required

Code of the Appliance Type for the specified Converge Resource Record.
Example : "BIND AUTH"

string

status
required

Defines whether the resource record is up to date or not with respect to master and slaves.
Example : "Up to Date"

string

5.99. DNS Cloud Provider

This class contains cloud DNS provider information. The information includes the cloud DNS provider name and authentication credentials required for interaction with cloud DNS service provider API.

Name Description Schema

account
optional

string

addedResources
optional

< CloudResource > array

adtenant
required

AD tenant ID of the cloud DNS provider.

string

api_key
required

API Key for the cloud provider.

string

api_password
optional

string

application
required

Application of the cloud DNS provider.

string

cloud_dns_provider_type_id
required

ID of the cloud DNS provider type.
Example : 1

integer(int32)

cloud_dns_provider_type_name
required

Name of the cloud DNS provider type.
Example : "AWS"

string

created_by
required

An ID of the user who has created the specified cloud DNS provider.
Example : 1

integer(int32)

created_by_login_name
required

Login name user name who has created the specified cloud DNS provide.
Example : "Stephen"

string

created_by_name
required

User Name who has created the specified cloud DNS provider.
Example : "Stephen"

string

created_time
required

The time when the specified cloud DNS provider is created.
Example : "1.4792E+12"

string(date-time)

created_time_string
optional

The time when the specified cloud DNS provider is created, in string format.
Example : "03/18/2022 3:39"

string

cust_name
optional

string

deletedResources
optional

< CloudResource > array

description
required

Description of Cloud DNS provider.
Example : "AWS DNS Zone"

string

id
optional

ID of the cloud DNS provider.
Example : 2

integer(int32)

keystorepassword
required

Secret key of the cloud DNS provider.

string

name
required

Name of the cloud DNS provider.
Example : "AWS Cloud DNS"

string

organization_id
required

Organization ID of the cloud DNS provider.
Example : 1

integer(int32)

organization_name
required

Organization name of the cloud DNS provider.
Example : "Internal"

string

region
optional

string

resourceMap
optional

< string, CloudResource > map

resourcegroup
required

Resource group name of the cloud DNS provider.
Example : "DNS_Zone"

string

updated_by
required

User Id who has updated the specified cloud DNS provider.
Example : 1

integer(int32)

updated_by_login_name
required

Login name of the user who has updated the specified cloud DNS provide.
Example : "Stephen"

string

updated_by_name
required

User Name who has updated the specified cloud DNS provide.
Example : "Stephen"

string

updated_time
required

The time when the specified cloud DNS provider is updated.
Example : "1.47911E+12"

string(date-time)

updated_time_string
optional

The time when the specified cloud DNS provider is updated, in string format.
Example : "03/28/2022 5:30"

string

uri
optional

string

useIAMRole
optional

boolean

user
required

User name of the cloud DNS provider.

string

vpcResourceBlocks
optional

< NetworkBlock > array

5.100. DNS Cloud Provider Template

This class contains cloud DNS provider association information with DNS zone template. The information includes the cloud DNS provider name and associated DNS zone template name.

Name Description Schema

cloud_dns_provider_type_name
optional

string

5.101. DNS Cloud Provider Type

This class contains cloud DNS service provider information. The information includes the cloud DNS service provider name and description.

Name Description Schema

created_by
optional

User Id who has created the specified cloud DNS provider type.
Example : 1

integer(int32)

created_by_name
optional

User name who has created the specified cloud DNS provider type.
Example : "Stephen"

string

created_time
optional

The time when the specified cloud DNS provider type is created.

string(date-time)

created_time_string
optional

The time when the specified cloud DNS provider is created, in string format.
Example : "04/25/2022 5:30"

string

description
required

Description of the cloud DNS provider.
Example : "Amazon Web Service"

string

id
optional

ID of the cloud DNS provider.
Example : 1

integer(int32)

name
required

Name of the cloud DNS provider.
Example : "AWS"

string

updated_by
optional

The time when the specified cloud DNS provider type is updated.
Example : 1

integer(int32)

updated_by_name
optional

User name who has updated the specified cloud DNS provider type.
Example : "Stephen"

string

updated_time
optional

The time when the specified cloud DNS provider type is updated.

string(date-time)

updated_time_string
optional

The time when the specified cloud DNS provider is updated, in string format.
Example : "03/28/2022 4:20"

string

5.102. DNS External Root Hints

This class represents a DNS External Root Hints and contains the attributes necessary for DNS External Root Hints management functionality in the TCPWave IPAM. The information includes the Name server FQDN, Name server IPv4 address and other information.

Name Description Schema

appliance_template_id
optional

Appliance template id of the specified DNS External Root Hints.
Example : 84

integer(int32)

appliance_template_name
required

Appliance template name of the specified DNS External Root Hints.
Example : "84"

string

created_by
required

Id of the User who has created the specified DNS External Root Hints.
Example : 2017

integer(int32)

created_by_login_name
optional

The User’s name, who has logged into the TCPWave IPAM, has been set as Created By for the specified DNS External Root Hints.
Example : "Stephen"

string

created_by_name
optional

User Name who has created this DNS External Root Hints.
Example : "Stephen"

string

created_time
optional

The time instance when the specified DNS External Root Hints has been created.
Example : "01/18/20122 3:39"

string(date-time)

created_time_string
optional

String format of the time when the specified DNS External Root Hints has been created.
Example : "01/18/20122 3:39"

string

id
optional

ID of the specified DNS External Root Hints.
Example : 84

integer(int32)

ns_fqdn
required

Name server FQDN of the specified DNS External Root Hint.
Example : "ns1.tcpwave.com."

string

ns_ipv4Address
required

Name server IPv4 address of the specified DNS External Root Hint.
Example : "10.1.10.10"

string

old_ns_fqdn
required

Old name of the specified DNS External Root Hint.
Example : "ns1.tcpwave.com."

string

old_ns_ipv4Address
required

Old IPv4 address of the specified DNS External Root Hint.
Example : "10.1.10.10"

string

organization_id
optional

Organization ID of a DNS External Root Hints.
Example : 1

integer(int32)

organization_name
required

Organization Name of DNS External Root Hints.
Example : "TCPWave"

string

ttl
required

TTL (Time To Live) of the specified DNS External Root Hint.
Example : 3600

integer(int32)

updated_by
required

Id of the User who has modified the specified DNS External Root Hints.
Example : 2019

integer(int32)

updated_by_login_name
optional

The User’s name, who has logged into the TCPWave IPAM, has been set as Created By for the specified DNS External Root Hints.
Example : "John"

string

updated_by_name
optional

User Name who has modified the specified DNS External Root Hints.
Example : "John"

string

updated_time
optional

The time instance when the specified DNS External Root Hints has been modified.
Example : "01/18/20122 4:37"

string(date-time)

updated_time_string
optional

String format of the time when the specified this DNS External Root Hints has been updated.
Example : "01/18/20122 4:37"

string

5.103. DNS TSIG (Transaction Signatures) Keys

This class represents a TSIG (Transaction Signatures) keys and contains the attributes necessary for TSIG key management functionality in the TCPWave IPAM. The information includes the name, algorithm, secret key and other TSIG key related information.

Name Description Schema

algoId
optional

ID of the specified TSIG algorithm.
Example : 1

integer(int32)

algoName
required

Name of the specified TSIG algorithm.
Example : "HMAC-SHA512"

string

autoGenSecretKey
optional

Auto generate the TSIG key for given name and algorithm.
Example : "0 or 1"

integer(int32)

created_by
optional

Id of the User who has created the specified TSIG key.
Example : 12

integer(int32)

created_by_login_name
optional

The User’s name, who has logged into the TCPWave IPAM, has been set as Created By for the specified TSIG key.
Example : "Stephen"

string

created_by_name
optional

User Name who has created the specified TSIG key.
Example : "Stephen"

string

created_time
optional

The time instance when the specified TSIG key has been created.
Example : "02/18/2022 4:37"

string(date-time)

created_time_string
optional

String format of the time when the specified TSIG key has been created.
Example : "02/18/2022 3:39"

string

description
optional

Description of the specified TSIG key.
Example : "TSIG key for the key1."

string

id
optional

ID of the specified TSIG key.
Example : 1

integer(int32)

name
required

Name of the specified TSIG key.
Example : "key1"

string

newName
required

Modified Name of the specified TSIG key.
Example : "key2"

string

secretKey
required

Secret key of the TSIG key.
Example : "wTrdaq6SHatfVkfYQ7sQ33dD/xVDURiF6eSBmBufGrmcr9arTy6RfMatCpI481hLaebqgq4mrzUKMF55B1gv/Q=="

string

updated_by
optional

Id of the User who has modified the specified TSIG key.
Example : 12

integer(int32)

updated_by_login_name
optional

The User’s name, who has logged into the TCPWave IPAM, has been set as Updated by for the specified TSIG key.
Example : "John"

string

updated_by_name
optional

User Name who has modified the specified TSIG key.
Example : "John"

string

updated_time
optional

The time instance when the specified TSIG key has been modified .
Example : "02/18/2022 4:37"

string(date-time)

updated_time_string
optional

String format of the time when the specified TSIG key has been modified.
Example : "02/18/2022 3:39"

string

5.104. DNS View

This class represents a DNS View and contains the attributes necessary for DNS View management functionality in the TCPWave IPAM. The information includes the View Name, Match Clients, Match Destinations and other DNS View related information.

Name Description Schema

allowRecursion
optional

< Access Control List(ACL) > array

allowRecursionValue
optional

Allow Recursion of a view. Allow Recursion takes array list of Access Control List(ACL).
Example : "[ACL1, ACL2, ACL3]"

string

createdBy
optional

Id of a user who created the view.
Example : 1

integer(int32)

createdByName
optional

Name of the user who created the view.
Example : "User1"

string

createdTime
optional

View creation time.
Example : "01/22/2022"

string(date-time)

createdTimeString
optional

Created time of a view in String format.
Example : "01/22/2022 6:57"

string

created_by_login_name
optional

string

enableRecursion
optional

Enable Recursion of a view. Enable Recursion accepts yes/no values.
Example : "no"

string

geoType
optional

string

id
optional

ID of a view.
Example : 1

integer(int32)

matchClients
required

Match clients of a view. Match clients takes array list of Access Control List(ACL).

< Access Control List(ACL) > array

matchClientsValue
optional

View match clients value as a string.
Example : "localhost;10.0.0.0/16"

string

matchDestinations
required

Match destinations of a view. Match destinations takes array list of Access Control List(ACL).

< Access Control List(ACL) > array

matchDestinationsValue
optional

View match destinations value as a string.
Example : "localhost;10.0.0.0/16"

string

matchGeoClients
optional

string

matchGeoDestinations
optional

string

matchRecursiveOnly
optional

Match Recursive Only of a view. Match Recursive Only accepts yes/no values.
Example : "no"

string

name
required

Name of a view
Example : "internal"

string

newName
required

New name of a view.
Example : "external"

string

organizationId
required

Organization id of a view.
Example : 1

integer(int32)

organizationName
required

Organization name of a view.
Example : "TCPWave"

string

sequence
optional

Sequence number of a view when it is assigned to remote servers.
Example : 1

integer(int32)

updatedBy
optional

Id of a user who last updated the view.
Example : 1

integer(int32)

updatedByName
optional

Name of the user who last updated the view.
Example : "1"

string

updatedTime
optional

Last updated time of a view.
Example : "10/2/2016"

string(date-time)

updatedTimeString
optional

Updated time of a zone in String format.
Example : "01/22/2022 6:57"

string

updated_by_login_name
optional

string

5.105. DNS/DHCP Appliance information

Fetches the DNS/DHCP Appliances information defined in the TCPWave IPAM

Name Description Schema

authAsCache
optional

Authoritative as Cache appliance.
Example : "1"

string

enableTunnelDetection
optional

Specifies whether the given appliance has DNS tunnel detection enable or not.
Example : "no"

string

ip
required

Get server IP Address
Example : "10.1.1.3"

string

name
required

Get server name
Example : "nusax"

string

scode
required

Get server type
Example : "BIND-AUTH"

string

5.106. DNS64

Name Description Schema

breakDnssec
required

Break DNSSEC for the DNS64 template
Example : "yes"

string

clientsValue
required

Comma separated string of clients
Example : "192.168.0.1,192.168.0.45"

string

createdBy
optional

ID of the user who created this DNS64 template
Example : 45

integer(int32)

createdByName
optional

Name of the user who created this DNS64 template
Example : "user"

string

createdTime
optional

Created time of the DNS64 template
Example : "03/05/2022 4:39"

string(date-time)

createdTimeString
optional

String format of the time instance when the specified DNS64 template has been created.
Example : "03/05/2022 4:39"

string

created_by_login_name
optional

The User’s name, who has logged into the TCPWave IPAM, has been set as Created By for the specified Domain.
Example : "Stephen"

string

description
optional

Description for the DNS64 template
Example : "DNS64 is a mechanism for synthesizing AAAA resource records (RRs) from A RRs."

string

excludeValue
required

Comma separated string of exclude
Example : "192.168.0.19,192.168.0.65"

string

id
optional

ID of the DNS64 template
Example : 34

integer(int32)

mappedValue
required

Comma separated string of mapped
Example : "192.168.0.10,192.168.0.55"

string

mask
required

Mask length of prefix
Example : 64

integer(int32)

name
required

Name of the DNS64 template
Example : "cloud"

string

newName
optional

New name of the DNS64 template
Example : "provider"

string

organizationId
required

Organization ID of the DNS64 template
Example : "yes"

integer(int32)

organizationName
required

Organization name of the DNS64 template
Example : "Organization"

string

prefix
required

Prefix value of IPv6 address
Example : "5000:0002::"

string

recursiveOnly
required

Recursion only for the DNS64 template
Example : "yes"

string

suffix
required

Suffix of the DNS64 template
Example : "::5000"

string

updatedBy
optional

ID of the user who modified this DNS64 template
Example : 45

integer(int32)

updatedByName
optional

Name of the user who modified this DNS64 template
Example : "user"

string

updatedTime
optional

Modified time of the DNS64 template
Example : "03/05/2022 4:39"

string(date-time)

updatedTimeString
optional

String format of the time instance when the specified DNS64 template has been modified.
Example : "03/05/2022 4:39"

string

updated_by_login_name
optional

The User’s name, who has logged into the TCPWave IPAM, has been set as Updated By for the specified Domain.
Example : "John"

string

5.107. DNSAnalyticsRules

Name Description Schema

fqdnLengthThreshold
optional

integer(int32)

intPercentThreshold
optional

integer(int32)

queryCountPerDomainThreshold
optional

integer(int32)

queryCountPerHostThreshold
optional

integer(int32)

subdomainLengthThreshold
optional

integer(int32)

5.108. DNSApplianceDefaults

Name Description Schema

created_by
required

IPAM appliance template created by user Id
Example : 1219

integer(int32)

created_by_name
optional

IPAM appliance template created by user name
Example : "twcuser"

string

created_time
optional

IPAM appliance template created time stamp
Example : "1222221231"

string(date-time)

elevatedPrivilegesConfig
optional

Elevated Privileges Configuration Details
Example : "{\"environmentVariables\":[{\"value\":\"Defaults always_query_group_plugin\"}],\"userAliases\":[{\"user_alias_name\":\"USER_ALIAS_1\",\"user_alias_value\":\"testuser\"}],\"hostAliases\":[{\"host_alias_name\":\"HOST_ALIAS_1\",\"host_alias_value\":\"192.168.0.139\"}],\"runasAliases\":[{\"runas_alias_name\":\"RUNAS_ALIAS_1\",\"runas_alias_value\":\"user2\"}],\"commandAliases\":[{\"command_alias_name\":\"COMMAND_ALIAS_1\",\"command_alias_value\":\"/cp\"}],\"userSpecifications\":[{\"user_alias\":\"USER_ALIAS_1\",\"host_alias\":\"HOST_ALIAS_1\",\"runas_alias\":\"RUNAS_ALIAS_1\",\"runas_group_alias\":\"\",\"command_alias\":\"COMMAND_ALIAS_1\",\"taglist\":\"\"}]}"

string

elevatedPrivilegesJson
optional

Elevated Privileges Configuration JSON String
Example : "{\"environmentVariables\":[{\"value\":\"Defaults always_query_group_plugin\"}],\"userAliases\":[{\"user_alias_name\":\"USER_ALIAS_1\",\"user_alias_value\":\"testuser\"}],\"hostAliases\":[{\"host_alias_name\":\"HOST_ALIAS_1\",\"host_alias_value\":\"192.168.0.139\"}],\"runasAliases\":[{\"runas_alias_name\":\"RUNAS_ALIAS_1\",\"runas_alias_value\":\"user2\"}],\"commandAliases\":[{\"command_alias_name\":\"COMMAND_ALIAS_1\",\"command_alias_value\":\"/cp\"}],\"userSpecifications\":[{\"user_alias\":\"USER_ALIAS_1\",\"host_alias\":\"HOST_ALIAS_1\",\"runas_alias\":\"RUNAS_ALIAS_1\",\"runas_group_alias\":\"\",\"command_alias\":\"COMMAND_ALIAS_1\",\"taglist\":\"\"}]}"

string

ldapSSHConfig
optional

JSON string of the LDAP SSH configuration - for Internal use only

string

syslogConfig
optional

JSON string of the Syslog-ng configuration – for Internal use only

string

syslogNgConfig
optional

Syslog-NG Configuration Details

Syslog-ng configuration details

tacacsConfig
optional

JSON string of the TACACS configuration - for Internal use only

string

tacacsConfigDecrypted
optional

JSON decrypted string of the TACACS configuration - for Internal use only

string

updated_by
optional

IPAM appliance template updated by user Id
Example : 1219

integer(int32)

updated_by_name
optional

IPAM appliance template updated by user name
Example : "twcuser"

string

updated_time
optional

IPAM appliance template updated time stamp
Example : "1222221231"

string(date-time)

5.109. DNSForwarders

Name Description Schema

forward
optional

Forward is only relevant in conjunction with a valid forwarders statement. If set to 'only' the Appliance will only forward queries, if set to 'first' (default) it will send the queries to the forwarder and if not answered will attempt to answer the query.
Example : "only/first"

string

forwardersIPv4
optional

List IPV4 Address(es) to which queries will be forwarded for the specified Appliance Forwarder. It’s only relevant when used with the related forward statement.
Example : "192.1.100.10"

string

forwardersIPv6
optional

List IPV6 Address(es) to which queries will be forwarded for the specified Appliance Forwarder. It’s only relevant when used with the related forward statement.
Example : "2001:503:ba3e::2:30"

string

isPresent
optional

This represents if the forwarder is from the IPAM database or not.
Example : false

boolean

zoneName
optional

Name of the zone associated with the specified DNS Appliance template.
Example : "edu.com"

string

5.110. DNSForwardersList

Name Description Schema

addedForwarders
optional

List of the Added Forwarders.

< DNSForwarders > array

deletedForwarders
optional

List of the deleted Forwarders.

< DNSForwarders > array

description
optional

Description for the DNS Forwarder Category.
Example : "Microsoft Forwarders"

string

forwarders
optional

List of the DNS Forwarder Categories.

< DNSForwarders > array

name
optional

Name of the DNS Forwarder Category.
Example : "Microsoft"

string

5.111. DNSTotalTrafficChart

This class represents the information to display DNS traffic charts on dashboard.

Name Description Schema

a
required

A record query count
Example : 100

integer(int32)

aaaa
required

AAAA record query count
Example : 100

integer(int32)

cname
required

CNAME record query count
Example : 100

integer(int32)

mx
required

MX record query count
Example : 100

integer(int32)

ns
required

NS record query count
Example : 100

integer(int32)

ptr
required

PTR record query count
Example : 100

integer(int32)

server_name
required

Appliance Name
Example : "Test-Appliance"

string

soa
required

SOA record query count
Example : 100

integer(int32)

srv
required

SRV record query count
Example : 100

integer(int32)

start_time
required

Start time to get queries count
Example : "2022-20-01 00:01:00"

string

5.112. Dashboard

Name Description Schema

configList
optional

string

getwList
optional

string

isDefault
required

Is dashboard default ?
Example : false

boolean

name
required

Dashboard Name
Example : "Dashboard1"

string

oldName
optional

string

positions
optional

string

widgetList
optional

List of selected widgets in the dashboard

< DashboardWidget > array

5.113. DashboardWidget

Name Description Schema

config
required

Widget Config
Example : "{\r\n\r\n\"USER SESSION\":{\"url\":\"/rest/user/session\", \"chartType\":\"BAR\"},\r\n\r\n\"DNS Statistics\":\r\n\r\n{\"url\":\"/rest/dns/statistics\", \"chartType\":\"DONUT\"}\r\n\r\n}"

string

dashenum
optional

enum (user_sessions, zone_distribution, total_objects, object_types, object_allocation, health_index_score, dns_allocation_trend, dhcp_ip_allocation_trend, ipam_counter, active_sessions, clocks, world_clock, noncompliant_dhcp_policies, noncomliant_dns_policies, non_compliant_ipam_policies, alerts_widget, top_alert_producers, ipam_cpu_utilization, ipam_database_connections, ipam_database_network_traffic, ipam_database_row_operations, ipam_database_summary, ipam_database_table_locks, ipam_database_thread, ipam_disk_utilization, ipam_memory_utilization, ipam_ntp_statistics, ipam_runtime_heap_usage, ipv4_network_space_utilization, ipv4_subnet_space_utilization, ipv6_network_space_utilization, ipv6_subnet_space_utilization, dhcp_cpu_utilization, dhcp_cumulative_chart, dhcp_query_statistics, dhcp_response_statistics, dhcp_disk_utilization, dhcp_heartbeat_statistics, dhcp_icmp_statistics, dhcp_memory_utilization, dhcp_ntp_statistics, dhcp_swap_memory, dhcp_top10_least_used_scopes, dhcp_top10_most_used_scopes, dns_cache_hit_ratio_metrics, dns_cpu_utilization, dns_disk_utilization, dns_authoritative_cumulative_chart, dns_cache_cumulative_chart, dns_proxy_cumulative_chart, dns_query_statistics, dns_response_statistics, dns_heartbeat_statistics, dns_icmp_statistics, dns_memory_utilization, dns_ntp_statistics, dns_swap_memory, dns_top_talker, dns_large_queries, dns_large_responses, dns_nxdomain_query_responses, dns_traffic_anomaly, dns_unique_subdomain_count, top10_anomalous_queries, anomaly_alerts, intrusion_alerts, ips_action_type_distribution, ips_protocol_type_distribution, titan_threat_intel_score, anomalous_query_distribution, suspicious_query_ml_log, suspicious_query_signature_log, active_directory_updates, alarms_and_statistics, ddns_updates, dhcp_configuration, dhcp_leases, dns_configuration, ha_configration, ha_delegation, health_check, remote_commands, cumulative_utilization, top_10_cpu_consumers, top_10_memory_consumers, top_10_disk_consumers, top_10_disk_query_per_second, top_10_disk_leases_per_second, dns_top_talkers, my_device)

name
required

Widget Name
Example : "DNS Statistics"

string

5.114. Data Types

This class encapsulates various data types defined in the system for DHCP Options

Type : object

5.115. Delete Cloud Network Request

DeleteCloudNetworkRequest class encapsulates the attributes that are required to delete a private cloud network, such as VPC ID, Cloud Provider Name and Organization Name.

Name Description Schema

cloudProviderName
required

Name of the Cloud Provider
Example : "AWS-Provider"

string

orgName
required

Name of the Organization
Example : "Internal"

string

vpcId
required

ID of the VPC
Example : "ERTFDFD54SDS6SDS"

string

5.116. Delete Cloud Subnet Request

DeleteSubnetRequest class encapsulates the attributes that are required to delete a private cloud subnet, such as Subnet Address List,Organization Name etc.

Name Description Schema

addressList
required

Array of subnet addresses

< string > array

deletedBy
optional

Database ID of the User who requested the delete operation
Example : 201

integer(int32)

isDeleterrsChecked
optional

This field checks if referenced resource records are allowed to be deleted along with the object delete.
Example : 0

integer(int32)

organizationName
required

Name of the Organization
Example : "Internal"

string

5.117. Delete Scope Request

This is a request object to delete a given scope on a given server for a specified subnet.

Name Description Schema

addressRange
required

Address range of scope to be deleted
Example : "10.0.0.7-10.0.0.20"

string

organization_name
required

Organization name
Example : "Internal"

string

primary_dhcp_server
required

Subnet DHCP appliance address
Example : "10.0.0.5"

string

subnetAddress
required

Subnet address of the scope
Example : "10.0.0.0"

string

5.118. Device Details

This class represents device details which include IP Address, Description, Up time, Contact, Name, Location etc.

Name Description Schema

accepted
optional

boolean

cmdId
required

Command ID
Example : 23

integer(int32)

commandId
optional

string

configDifference
optional

string

configFilePath
optional

Configuration File Path
Example : "/opt/tcpwave/timsdiscovery/configs/TDCE_20211026102220/10.1.1.20_show_version.raw"

string

description
optional

Description
Example : "5"

string

deviceName
optional

string

deviceType
optional

string

discoveredBy
required

The user who submitted the discovery command.
Example : "sadm"

string

discoveredElements
required

Discovered Element

integer(int32)

discoveryAgentCommandId
optional

string

endTime
required

End Time

string

ifNumber
required

Interface number
Example : "001"

string

ipAddress
required

IP address
Example : "10.2.2.3"

string

mac
required

Mac address

string

organization
optional

string

password
optional

string

platform
optional

Platform

string

snmpCommunityString
optional

string

snmpVersion
optional

string

startTime
required

Start Time

string

subnetIP
required

Subnet IP

string

sysContact
required

Contact
Example : "John"

string

sysDesc
required

Description

string

sysLocation
required

Location
Example : "TCPWave"

string

sysName
required

Name
Example : "Switch"

string

sysUpTime
required

Switch uptime
Example : "2hrs"

string

user_name
optional

string

v3ApprovedPassword
optional

string

v3Password
optional

string

v3UserName
optional

string

vendor
optional

Vendor
Example : "5"

string

5.119. Device Details Map

This class represents device details.

Name Description Schema

deviceName
optional

string

deviceType
optional

string

ipAddress
optional

string

vendor
optional

string

5.120. Discovered Object

This class represents the Discovered Object details which include switch id, name, mac and location.

Name Description Schema

contact
required

Contact
Example : "Jhon"

string

description
required

Description
Example : "Discovered object"

string

id
required

ID
Example : 101

integer(int32)

location
required

Location
Example : "TCPWave"

string

mac
required

Mac address
Example : "00-14-22-01-23-45"

string

name
required

Name
Example : "Test"

string

5.121. Discovery Agent VMWare

This class represents Discovery Agent VMWare.

Name Description Schema

commandId
optional

Command Id
Example : "TDCE_20220422123"

string

if_number
optional

Interface number
Example : "101a01"

string

ip
required

IP Address of a VMWare server
Example : "10.0.0.0"

string

mac
optional

System MAC
Example : "00:00:5e:00:53:af"

string

platform
optional

Platform
Example : "ESX"

string

serial_number
optional

System serial number
Example : "1A012B"

string

sys_contact
optional

System Contact
Example : "John"

string

sys_desc
optional

System Description
Example : "VMWare device."

string

sys_location
optional

System Location
Example : "USA"

string

sys_name
optional

System Name
Example : "VMWareDevice"

string

sys_services
optional

System service
Example : "service"

string

sys_uptime
optional

System up time
Example : "2022-04-22 10:29:24"

string

vendor
optional

Vendor
Example : "VMWare"

string

5.122. Discovery Appliance

This class represents a discovery appliance that has discovery agent running on it and can do discovery of a network/subnet.

Name Description Schema

addedExclusions
optional

< Discovery Exclusions > array

addedRouters
optional

< DiscoveryRouters > array

applianceIP
required

IP address of the discovery appliance.
Example : "10.1.10.2"

string

applianceId
optional

Id of the specified discovery appliance.
Example : 1

integer(int32)

applianceName
optional

Name of the specified discovery appliance.
Example : "RemoteAppliance"

string

autoCreateVrfOrg
optional

string

autoSync
optional

string

banner
optional

string

connectedIPAM
optional

string

connectedIPAMIP
optional

string

createdBy
optional

UserId of user who created the specific discovery appliance.
Example : 1234

integer(int32)

createdByUser
optional

Name of user who created the specific discovery appliance.
Example : "admin"

string

createdTime
optional

Discovery appliance creation time.
Example : "03/18/2022 4:37"

string(date-time)

defaultNetworkMask
optional

integer(int32)

deletedExclusions
optional

< Discovery Exclusions > array

deletedRouters
optional

< DiscoveryRouters > array

description
optional

Description of the discovery appliance.
Example : "This is discovery appliance."

string

discovery
optional

string

discovery_init
optional

string

domainName
optional

string

enableSNMPv3
optional

boolean

extraData
optional

string

haIPAMList
optional

< string > array

heapSize
optional

string

hostName
optional

string

id
optional

Id of the specified discovery appliance.
Example : 1

integer(int32)

isAlive
optional

boolean

monitServices
optional

string

neighborDiscovery
optional

string

objectDiscovery
optional

string

oldApplianceIP
optional

IP address of the discovery appliance before the update.
Example : "10.1.10.2"

string

oldOrganizationName
optional

Name of an organization to which the specified discovery appliance is associated with before the update.
Example : "Internal"

string

oldTemplateName
required

Name of the specified discovery template before the update.
Example : "DiscoveryTemplate"

string

organizationId
optional

Id of an organization to which the specified discovery appliance is associated with.
Example : 1

integer(int32)

organizationName
required

Name of an organization to which the specified discovery appliance is associated with.
Example : "Internal"

string

resolverObj
optional

string

resolvers
optional

string

scheduleConfig
optional

string

snmpConfig
optional

string

snmpv3Users
optional

string

templateId
optional

Id of the specified discovery template.
Example : 1

integer(int32)

templateName
required

Name of the specified discovery template.
Example : "DiscoveryTemplate"

string

threadPoolSize
optional

integer(int32)

timeZone
optional

string

updatedBy
optional

UserId of user who updated the specific discovery appliance.
Example : 1234

integer(int32)

updatedByUser
optional

Name of user who updated the specific discovery appliance.
Example : "admin"

string

updatedTime
optional

Discovery appliance updated time.
Example : "03/18/2022 4:37"

string(date-time)

vrfDiscovery
optional

string

5.123. Discovery Command Data

This class encapsulates discovery request details to perform discovery.

Name Description Schema

community_strings
required

List of community strings

< string > array

discoPrefs
optional

Discovery preferences
Example : "Ping,SNMP,Reverse DNS,Switch"

string

orgName
optional

Organization name
Example : "Internal"

string

retries
optional

SNMP retries count
Example : 3

integer(int32)

reverseDNSTimeout
optional

Reverse DNS timeout in milliseconds
Example : 2000

integer(int64)

seed_routers
optional

Seed routers

< string > array

subnets
optional

List of subnets

< string > array

switchIPs
optional

List of switch IPs

< string > array

timeout
optional

SNMP timeout in milliseconds
Example : 2000

integer(int64)

type
optional

Discovery type. It can be Network or Subnet.
Example : "N"

string

userId
optional

User Id
Example : 1234

integer(int32)

vmWareAuthSourceList
optional

VMWare authentication source

< VMWareAuthenticationSource > array

5.124. Discovery Exclusions

This class represents a discovery exclusions that has discovery agent running on it and can do discovery of a network/subnet.

Name Description Schema

id
optional

integer(int32)

ip
optional

string

name
optional

string

type
optional

string

5.125. Discovery Request

This class encapsulates the network discovery requests and the type of the discovery requests.

Name Description Schema

reqs
required

List of the network discovery requests to allow multiple requests at a time.

< Network Discovery Request > array

type
required

Discovery type
Example : "N"

string

5.126. Discovery Template

This class represents a discovery template that can be used during creation or modification of a network and subnet.

Name Description Schema

addNonConflictingObjects
required

Non-conflicting objects will be added on accepting discovery results.
Example : true

boolean

conflictingObjPreference
required

Preferences to perform operations for conflicting objects.
Example : "Flag For Manual Reconciliation"

string

createdBy
optional

UserId of user who created the specific discovery template.
Example : 1234

integer(int32)

createdByUser
optional

Name of user who created the specific discovery template.
Example : "admin"

string

createdTime
optional

Discovery template creation time.
Example : "03/08/2022 4:37"

string(date-time)

description
optional

Description of discovery template.

string

discoveryPreferences
optional

Comma separated list of the different discovery methods.
Example : "SNMP,NMAP"

string

discoveryRemoteApplianceAddress
required

IP address of the Discovery Remote Appliance.
Example : "192.0.0.32"

string

discoveryRemoteApplianceId
optional

Id of the Discovery Remote Appliance.
Example : 1

integer(int32)

discoveryRemoteApplianceName
required

Name of the Discovery Remote Appliance.
Example : "DHCPAppliance1"

string

id
optional

Id of the specified discovery template.
Example : 1

integer(int32)

maxSNMPReqRetries
required

Maximum number of retries of a transaction allowed after it hits deadlock.
Example : 2

integer(int32)

name
required

Name of the specified discovery template.
Example : "test_template1"

string

oldName
optional

Old name of the specified discovery template.
Example : "test_template2"

string

organizationId
optional

Id of an organization to which the specified discovery template is associated with.
Example : 1

integer(int32)

organizationName
required

Name of an organization to which the specified discovery template is associated with.
Example : "Internal"

string

reclaim_grace_duration
optional

Reclaim grace duration time.
Example : 2

integer(int32)

revDNSLookupTimeout
required

Maximum time(in milliseconds) to wait to retry transaction after it hits deadlock. Accepts a value between 1,000 and 10,000.
Example : 2000

integer(int32)

snmpResTimeout
required

Response timeout (in milliseconds). Accepts a value between 1 and 10,000.
Example : 2000

integer(int32)

updatedBy
optional

UserId of user who updated the specific discovery template.
Example : 1234

integer(int32)

updatedByUser
optional

Name of user who updated the specific discovery template.
Example : "admin"

string

updatedTime
optional

Discovery template updated time.
Example : "03/08/2022 4:37"

string(date-time)

5.127. DiscoveryAgentCommand

Name Description Schema

accepted
optional

boolean

applianceIp
optional

string

applianceName
optional

string

cidr
optional

integer(int32)

commandId
optional

string

description
optional

string

discoveredDevicesCount
optional

integer(int32)

endTime
optional

string

id
optional

integer(int32)

ipaddress
optional

string

mask
optional

string

organization
optional

string

startTime
optional

string

status
optional

integer(int32)

statusName
optional

string

type
optional

integer(int32)

userid
optional

integer(int32)

5.128. DiscoveryElementDTO

Name Description Schema

discoveryApplianceIp
optional

string

domain
optional

string

elementType
optional

string

ipAddress
optional

string

organization
optional

string

vlan
optional

string

vrf
optional

string

5.129. DiscoveryEvents

Name Description Schema

applianceIp
optional

string

category
optional

integer(int32)

commandId
optional

string

deviceIp
optional

string

id
optional

integer(int32)

message
optional

string

organization
optional

string

status
optional

integer(int32)

5.130. DiscoveryMap

Name Description Schema

connected_router
optional

string

cr_address
optional

string

cr_type
optional

string

deviceAddress
optional

string

r_type
optional

string

router
optional

string

5.131. DiscoveryRouters

Name Description Schema

description
optional

string

deviceAlgorithms
optional

string

deviceType
optional

string

firewallContexts
optional

string

id
optional

integer(int32)

ipPrefixes
optional

string

loginType
optional

string

neighbors
optional

Neighbors
Example : "10.0.0.0,192.168.56.0"

string

password
optional

string

platform
optional

string

port
optional

integer(int32)

retry
optional

integer(int32)

router_address
optional

string

router_name
optional

string

routingProtocols
optional

string

snmpCommunityString
optional

string

snmpPort
optional

integer(int32)

snmpVersion
optional

string

sshTimeout
optional

integer(int32)

switchDeviceIP
optional

string

switchPort
optional

string

timeout
optional

integer(int32)

user_name
optional

string

v3ApprovedPassword
optional

string

v3Password
optional

string

v3SnmpAuthProtocol
optional

string

v3SnmpEncryptProtocol
optional

string

v3UserName
optional

string

vendor
optional

string

5.132. DnstapLogs

Name Description Schema

date
optional

Date of the log
Example : "2022-05-03"

string

query
optional

Query that caused the log
Example : "tcpwave.com IN SOA"

string

status
optional

Status of the log
Example : "NO ERROR"

string

time
optional

Time of the log
Example : "10:14:54"

string

5.133. Domain

This class represents a Domain and contains the attributes necessary for Domain management functionality in the TCPWave IPAM. The information includes the Domain Name, Domain Id, Zone Id, Organization Name and other Domain related information.

Name Description Schema

contact_email
optional

Email Id of the contact person of the specified Domain.
Example : "[email protected]"

string

contact_phone
optional

Phone Number of the contact person of the specified Domain.
Example : "1 (877) 609-2236"

string

created_by
required

Id of the User who has created the specified Domain.
Example : 2017

integer(int32)

created_by_login_name
optional

The User’s name, who has logged into the TCPWave IPAM, has been set as Created By for the specified Domain.
Example : "Stephen"

string

created_by_name
optional

Name of the User who has created the specified Domain.
Example : "Stephen"

string

created_time
required

The time instance when the specified Domain has been created.
Example : "03/18/2022 3:39"

string(date-time)

created_time_string
optional

String format of the time when the specified Domain has been created.
Example : "03/18/2022 3:39"

string

description
optional

Description for the specified Domain.
Example : "Domain for edu.com"

string

id
optional

Id of the specified Domain.
Example : 45

integer(int32)

is_managed
required

Specifies whether the specified Domain has Zone defined in it or not.
Example : "Yes"

string

name
required

Name of the specified Domain.
Example : "edu.com"

string

object_address
optional

Address of the associated Domain Controller object for the AD Enabled Zone.
Example : "10.0.0.20"

string

old_name
required

Name of the specified Domain before modification.
Example : "accitrade.com"

string

organization_id
required

Id of the Organization which is associated to the specified Domain
Example : 990

integer(int32)

organization_name
required

Name of the Organization which is associated to the specified Domain.
Example : "EARTH"

string

restrictedDomain
required

Determines if the specified Domain is a Restricted Domain.
Example : "yes"

string

updateSubDomain
optional

Update the sub domain name when parent domain name is changed.
Example : true

boolean

updated_by
optional

Id of the User who has modified the specified Domain.
Example : 2019

integer(int32)

updated_by_login_name
optional

The User’s name, who has logged into the TCPWave IPAM, has been set as Created By for the specified Domain.
Example : "John"

string

updated_by_name
optional

Name of the User who has modified the specified Domain.
Example : "John"

string

updated_time
optional

The time instance when the specified Domain has been modified.
Example : "03/18/2022 4:37"

string(date-time)

updated_time_string
optional

String format of the time when the specified Domain has been modified.
Example : "03/18/2022 4:37"

string

zone_id
optional

Zone Id for the specified Domain.
Example : 34

integer(int32)

5.134. DomainNode

Type : object

5.135. Dropdown Details

This class holds the information of a row in a dropdown.

Name Description Schema

description
optional

Description of the row
Example : "Description"

string

id
optional

Database row ID
Example : 71

integer(int32)

name
optional

Name of the row
Example : "Internal"

string

5.136. Dump DB Response

This is a response of a Dump DB operation. The bean contains the directory where the dump is located.

Name Description Schema

dumpDir
required

Directory/Location of dump database

string

5.137. Export Response Information

Holds the End result of an export process such as: Time taken to export, exported file path, number of errors etc.

Name Description Schema

elapsed_time
optional

Time taken for the import

integer(int64)

error_message
optional

Error message in case of error

string

fileName
required

Exported File Name

string

is_success
required

Is the export successfully completed?
Example : true

boolean

total_rows
required

Total number of rows exported

integer(int32)

5.138. External DNS Master

This class represents an External DNS Master and contains the attributes necessary for DNS Masters management functionality in the TCPWave IPAM. The information includes the DNS Master IP, Name and other DNS Master related information.

Name Description Schema

created_by
optional

Id of a user who created the external DNS master.
Example : 1

integer(int32)

created_by_login_name
optional

The User’s name, who has logged into the TCPWave IPAM, has been set as Created By for the specified server.
Example : "Stephen"

string

created_by_name
optional

Name of the user who created the external DNS master.
Example : "User1"

string

created_time
optional

External DNS master creation time.
Example : "03/01/2022"

string(date-time)

created_time_string
optional

String format of the time when the specified server is created.
Example : "05:21:35 02-01-2022"

string

description
optional

Description of a external DNS master.
Example : "This DNS master is created by TCPWave Inc."

string

id
optional

Id of an external DNS master
Example : 1

integer(int32)

ipv6_address
required

IPv4 address of an external DNS master.
Example : "10.1.10.10"

string

isAlive
optional

Is secure communication establish or not
Example : false

boolean

lastSyncTime
optional

Last sync time of the External DNS master
Example : "05:21:35 02-01-2022"

string(date-time)

lastSyncTimeString
optional

String format of the time when the specified external DNS master is last synchronized.
Example : "05:21:35 02-01-2022"

string

masterType
required

Type of an external DNS master.
Example : "PDNS/XDNS"

string

name
required

Name of an external DNS master.
Example : "dns1.tcpwave.com"

string

newPassword
optional

New updated password
Example : "abc1234"

string

oldLiveStatus
optional

Is secure communication establish or not
Example : false

boolean

organization_id
optional

Organization ID of an external DNS master.
Example : 1

integer(int32)

organization_name
required

Organization Name of an external DNS master.
Example : "TCPWave"

string

password
optional

Password of an external DNS master to communicate.
Example : "password1"

string

secret_key
optional

Secret of an external DNS master to communicate with an internal TCPWave slave remote.
Example : "AHDNsjhdg6702870JSNLA=-sdjjkdf&HHNs"

string

tsig_algo
optional

TSIG algorithm of an external DNS master to communicate with an internal TCPWave slave remote.
Example : "HMAC-SHA512"

string

tsig_name
optional

TSIG key name of an external DNS master to communicate with an internal TCPWave slave remote.
Example : "key_name"

string

updated_by
optional

Id of a user who updated the external DNS master last time.
Example : 1

integer(int32)

updated_by_login_name
optional

The User’s name, who has logged into the TCPWave IPAM, has been set as Created By for the specified server.
Example : "John"

string

updated_by_name
optional

Name of the user who updated the external DNS master last time.
Example : "User1"

string

updated_time
optional

Last updated time of an external DNS master.
Example : "03/01/2022"

string(date-time)

updated_time_string
optional

String format of the time when the specified server is modified.
Example : "05:21:35 02-01-2022"

string

user_name
optional

User name of an external DNS master to communicate.
Example : "username1"

string

5.139. External DNS Zone

This class represents an External DNS Zone and contains the attributes necessary for Zone management functionality in the TCPWave IPAM. The information includes the Zone Name, External DNS Masters, Internal DNS Slaves and other Zone related information.

Name Description Schema

created_by
optional

Id of a user who created the external DNS zone.
Example : 1

integer(int32)

created_by_login_name
optional

Login Name of a user who created an external DNS zone.
Example : "admin"

string

created_by_name
optional

Name of the user who created the external DNS zone.
Example : "User1"

string

created_time
optional

External DNS zone creation time.
Example : "03/01/2022"

string(date-time)

created_time_string
optional

Created time of an external DNS zone in String format.
Example : "03/01/2022 6:57"

string

description
optional

Description of a external DNS zone.
Example : "This zone is created by the TCPWave Inc."

string

externalDNSMasterIPs
required

An array list of external DNS or PowerDNS masters of an external DNS zone.

< string > array

id
optional

Zone ID of an external DNS zone.
Example : 1

integer(int32)

internalDNSSlaveIPs
optional

An array list of internal DNS slaves of an external DNS zone.

< string > array

masterType
required

Type of an external DNS zone.
Example : "PDNS/XDNS"

string

orgId
optional

Organization ID of an external DNS zone.
Example : 1

integer(int32)

orgName
required

Organization Name of an external DNS zone.
Example : "TCPWave"

string

rrs
optional

An array list of resource records present in an external DNS zone.

< Resource Record > array

secretKey
optional

Secret of an external DNS master to communicate with an internal TCPWave slave remote.
Example : "AHDNsjhdg6702870JSNLA=-sdjjkdf&HHNs"

string

serial_number
required

Serial Number of a zone.
Example : 2016102800

integer(int32)

tsigAlgo
optional

TSIG algorithm of an external DNS master to communicate with an internal TCPWave slave remote.
Example : "HMAC-SHA512"

string

tsig_name
optional

TSIG key name of an external DNS zone to communicate with an internal TCPWave slave remote.
Example : "key_name"

string

updated_by
optional

Id of a user who updated the external DNS zone last time.
Example : 1

integer(int32)

updated_by_login_name
optional

Login Name of a user who updated an external DNS zone.
Example : "admin"

string

updated_by_name
optional

Name of the user who updated the external DNS zone last time.
Example : "User1"

string

updated_time
optional

Last updated time of an external DNS zone.
Example : "03/01/2022"

string(date-time)

updated_time_string
optional

Updated time of an external DNS zone in String format.
Example : "03/01/2022 6:57"

string

zoneName
required

Name of an external DNS zone.
Example : "tcpwave.com"

string

5.140. Failed Row Information

Holds the information of a failed row and the reason of failure

Name Description Schema

row_data
required

Row that has failed to be imported

string

row_error_message
required

Error message in case of error

string

5.141. File Set

Detailed information about File Distribution Management.

Name Description Schema

created_by
required

Name of the user who created file set
Example : "Smith"

string

created_time
required

Created time
Example : "3/18/2022 4:37"

string

description
required

Description for file set

string

filesetData
required

File set data

< File Set File > array

filesetappliances
required

List of the DHCP appliances

< ApplianceInfo > array

name
required

File set name
Example : "Test"

string

old_name
optional

string

organization_name
required

Name of the organization
Example : "Internal"

string

protocol
required

Name of the protocol
Example : "TFTP"

string

server
required

List of servers

< Server Information > array

updated_by
required

Name of the user who updated file set
Example : "Smith"

string

updated_time
required

Updated time
Example : "3/18/2022 4:37"

string

5.142. File Set File

Detailed information about File set File.

Name Description Schema

change_ticket
optional

change ticket value of the file.
Example : "Abc123Qwr"

string

children
optional

List of File Set Files.

< File Set File > array

content
optional

Content of the specified file.
Example : "files are added under file set files"

string

created_by
optional

Name of the User who has created the specified File.
Example : "raina"

string

created_time
optional

The time instance when the specified file has been created.
Example : "03/18/2022 3:39"

string

description
optional

Description for the specified file.
Example : "files added"

string

file_set_id
optional

Id of the specific File Set File.
Example : 12

integer(int32)

id
optional

Id of the specified file.
Example : 101

integer(int32)

isFolder
optional

This represents if selected row is a file or a folder .
Example : false

boolean

name
optional

Name of the specified file.
Example : "Trent"

string

old_name
optional

Old name of file.
Example : "raina"

string

parent_id
optional

Id of the parent file.
Example : 12

integer(int32)

parent_name
optional

Parent file name of the specific file.
Example : "topone"

string

path
optional

Path of the specified file.
Example : "/etc/var/lib/tmp"

string

updated_by
optional

Name of the User who has Updated the specified File.
Example : "raina"

string

updated_time
optional

Name of the User who has modified the specified file.
Example : "03/18/2022 4:37"

string

5.143. Fingerprint data information

This class represents fingerprint information of the DHCP client.

Name Description Schema

certainityIndex
optional

DCI (Digital Certainty Index) score of DHCP client
Example : "11"

string

device
optional

Device information of the DHCP client
Example : "Microsoft Windows Kernel 6.0"

string

optionSequence
optional

DHCP standard option sequence
Example : "1,2,3,9,11,"

string

osName
optional

Operating system information of the DHCP client
Example : "10.1"

string

userAgent
optional

System details to appliance hosting the web page
Example : "1.1"

string

vendor
optional

Vendor information of the DHCP client
Example : "3COM CORPORATION"

string

5.144. Firewall

This class represents a discovery firewall

Name Description Schema

base_bridge_address
optional

Base bridge address.

string

commandId
optional

string

id
optional

Id of the specified router.
Example : 1

integer(int64)

if_number
optional

if_number.

string

ip
optional

IP address of the specified router.
Example : "1.0.0.1"

string

mac
optional

MAC.

string

neighborIp
optional

string

platform
optional

Platform

string

serial_number
optional

Serial number.

string

sys_contact
optional

System contact.

string

sys_desc
optional

System Description.

string

sys_location
optional

System location.

string

sys_name
optional

System name.

string

sys_services
optional

System services.

string

sys_uptime
optional

System uptime.

string

vendor
optional

Vendor

string

version
optional

Version
Example : "5"

string

5.145. Firewall Element Details

This class represents the IP Address, Mac Address, and Firewall IP details of a device connected to a Switch.

Name Description Schema

aton_address
optional

integer(int64)

commandId
optional

string

description
required

Description

string

elementIp
optional

string

firewallIP
required

Firewall IP

string

firewallIp
optional

string

id
optional

integer(int64)

interfaceName
optional

string

last_seen
optional

string

mac
optional

string

macAddress
required

Mac address

string

name
required

Element Name

string

vrf
optional

string

5.146. Firewall Interface

This class represents a discovery firewall neighbor

Name Description Schema

commandId
optional

string

description
optional

string

firewallIp
optional

IP address of the specified firewall interface.
Example : "1"

string

id
optional

Id of the specified router interface.

integer(int64)

interfaceIp
optional

Interface IP.
Example : "1"

string

interfaceName
optional

Interface name.
Example : "1"

string

ipVersion
optional

integer(int32)

protocol
optional

Protocol.
Example : false

boolean

status
optional

Status.
Example : false

boolean

5.147. Firewall NAT Pool Details

This class represents the Rule, NAT type, NAT Rule Set, Host Addresses, Destination Addresses, Mask and VRF details of a device connected to a Firewall.

Name Description Schema

commandId
required

Command Id
Example : "TDCE_20220331012"

string

destinationAddress
required

Destination Addresses
Example : "10.1.10.26"

string

firewallIp
required

Firewall IP Address
Example : "10.1.10.28"

string

hostAddress
required

Host Addresses
Example : "10.1.10.25"

string

mask
required

Mask
Example : 32

integer(int32)

natPool
required

NAT Pool
Example : "DIP-5"

string

natRule
required

NAT Rule
Example : "STATIC_01"

string

natRuleSet
required

NAT Rule Set
Example : "MIP_NAT_02"

string

natType
required

NAT Type
Example : "static"

string

total_addresses
optional

integer(int64)

vrf
required

VRF Name
Example : "TCPWaveVRF"

string

5.148. Firewall Neighbor

This class represents a discovery firewall neighbor

Name Description Schema

capabilities
optional

Router neighbor capabilities.

string

chassis_id
optional

Chassis Id of the specified router neighbor.

string

commandId
optional

string

id
optional

Id of the specified router neighbor.
Example : 1

integer(int64)

ipVersion
optional

integer(int32)

local_interface
optional

Local Interface of the specified router neighbor.

string

management_ip
optional

Management IP of the specified router neighbor.

string

neighbor
optional

Router Neighbor.

string

neighbor_interface
optional

Interface of the specified router neighbor.

string

neighbor_port_id
optional

Port Id of the specified router neighbor.

string

protocol
optional

string

routerIp
optional

string

serial
optional

Serial.

string

system_description
optional

System description.

string

5.149. Firewall Subnet

This class represents a firewall subnet

Name Description Schema

appliance_ip
optional

string

commandId
optional

string

description
optional

string

domain_name
required

Domain of the router.
Example : "tcpwave.com"

string

firewallIP
required

IP address of the router.
Example : "10.1.10.2"

string

id
optional

Id of the specified router subnet.
Example : 1

integer(int64)

interfaceIp
optional

string

interfaceName
required

Name of the interface.
Example : "loopback0"

string

ipVersion
optional

integer(int32)

isAccepted
optional

integer(int32)

local
required

Is local.
Example : false

boolean

nextHop
required

Next hop.

string

objectIP
optional

string

organization_name
required

Organization of the router.
Example : "Internal"

string

protocol
required

Protocol.

string

subnetIP
required

IP address of the subnet.
Example : "10.1.10.0"

string

subnetMask
required

Subnet mask.
Example : "255.255.255.0"

string

subnetMaskLength
required

Mask length of subnet.
Example : 24

integer(int32)

type
required

type.

string

vlan
optional

string

vrfEnabled
optional

boolean

vrfName
optional

string

5.150. Firewall Template

This is a bean class which provides Firewall template to a DNS Appliance. A firewall template contains firewall rule, name, description etc. 

Type : object

5.151. Firewall Template Association

This is a bean class that encapsulates the association between a DNS Appliance and a Firewall template in the TCPWave IPAM.

Name Description Schema

snmpAcl
optional

string

5.152. FirewallSubnetElement

Name Description Schema

aton_address
optional

integer(int64)

commandId
optional

string

contact
optional

string

description
optional

string

device
optional

string

domainName
optional

string

firewallIp
optional

string

ip_address
optional

string

last_seen
optional

string

latency
optional

string

location
optional

string

mac
optional

string

maskLength
optional

integer(int32)

name
optional

string

organizationName
optional

string

os
optional

string

port_duplex
optional

string

ports
optional

string

status
optional

string

subnetIp
optional

string

switch_name
optional

string

switch_port
optional

string

vendor
optional

string

5.153. ForwardersCategory

Name Description Schema

created_by
optional

Name of the user who has created the specified forwarder category.
Example : "raina"

string

cretaed_time
optional

The time instance when the specified Forwarder has been created.
Example : "03/18/2022 3:39"

string

description
optional

Description for the forwarder category.
Example : "Google Forwarders"

string

id
optional

Id of the specified forwarder category.
Example : 121

integer(int32)

name
optional

Name of the DNS forwarder category.
Example : "Google"

string

updated_by
optional

Name of the user who has Updated the specified forwarder category.
Example : "raina"

string

updated_time
optional

Time when user modified the specified forwarder category.
Example : "03/18/2022 4:37"

string

5.154. Function

Name Description Schema

description
optional

string

id
optional

integer(int32)

isGranular
optional

string

name
optional

string

5.155. Functions

Name Description Schema

description
optional

string

granular_support
optional

boolean

id
optional

integer(int32)

name
optional

string

5.156. Global Options List

This class contains a list of global options supported by the TCPWave IPAM. Global options control the behavior of various sub components and the overall performance of the product. Changes to the global options are audited.

Name Description Schema

category
optional

Category of the option

string

description
optional

Description of the option

string

display_name
optional

Display name of the option

string

paramName
required

Name of the option

string

paramValue
optional

Value of the option

string

prompt
optional

Prompt for the option

string

updated_by_name
optional

User who updated the option value

string

updated_time
optional

Option update time

string(date-time)

5.157. Global Policy Management(GPM)

This class represents Global Policy Management(GPM) and contains the attributes necessary for Global Policy Management functionality in TCPWave IPAM. The information includes the id, name, value,category, type, unit and other Global Policy related information.

Name Description Schema

getpCat
required

Category of the specified Global Policy Management.
Example : "Preferences"

string

getpId
required

ID of the specified Global Policy Management.
Example : "1"

string

getpName
required

Name of the specified Global Policy Management.
Example : "LOGO"

string

getpType
required

Type of the specified Global Policy Management.
Example : "FILE"

string

getpUnit
required

Unit of the specified Global Policy Management.
Example : "1"

string

getpValue
required

Value of the specified Global Policy Management.
Example : "1"

string

5.158. HA IPAM

The IPAM Server information in HA Setting.

Name Description Schema

create_by_string
required

Name of the user who setup the HA.
Example : "Smith"

string

created_by
required

Database ID of the user who setup the HA.
Example : 2862

integer(int32)

created_time_string
required

HA setup creation time.
Example : "01/20/2022 4:37"

string

description
required

Description about HA setup.

string

extra_info
required

Extra information about HA IPAM.

string

id
required

ID of the HA IPAM
Example : 1123

integer(int32)

is_pseudomaster
required

Is IPAM master or not?

integer(int32)

name
required

Name of the IPAM Appliance.

string

priority
required

Priority given to the appliance.

integer(int32)

updated_by
required

Database ID of the user who updated the HA.
Example : 2862

integer(int32)

updated_by_string
required

Name of the user who modified the HA.
Example : "John"

string

updated_time
required

HA setup modification time.
Example : "01/20/2022 4:37"

string(date-time)

updated_time_string
required

HA setup modification time.
Example : "01/20/2022 4:37"

string

v4_ipaddress
required

IPV4 Address of the IPAM Appliance.

string

v6_ipaddress
required

IPV6 Address of the IPAM Appliance.

string

5.159. HealthIndices

Name Description Schema

dhcp_count
optional

Number of DHCP alerts
Example : 23

integer(int32)

dhcp_hosts_critical
optional

Number of DHCP hosts in critical state
Example : 23

integer(int32)

dhcp_lastsync_failed
optional

Number of sync failed on DHCP host
Example : 24

integer(int32)

dhcp_services_count
optional

Number of DHCP services
Example : 20

integer(int32)

dhcp_services_critical
optional

Number of DHCP services in critical state
Example : 32

integer(int32)

dns_count
optional

Number of DNS alerts
Example : 32

integer(int32)

dns_hosts_critical
optional

Number of DNS hosts in critical state
Example : 23

integer(int32)

dns_lastsync_failed
optional

Number of sync failed on DNS host
Example : 22

integer(int32)

dns_services_count
optional

Number of DNS services
Example : 14

integer(int32)

dns_services_crtical
optional

Number of DNS services in critical state
Example : 25

integer(int32)

ipam_critical
optional

Number of critical alerts on the IPAM.
Example : 25

integer(int32)

5.160. Home

This class represents the information to display on dashboard.

Name Description Schema

address
required

Network’s full address
Example : "10.1.10.45"

string

count
required

Count value
Example : 1

integer(int32)

email_id
optional

Email ID
Example : "[email protected]"

string

fullAddress
required

Network’s full address
Example : "10.1.10.135"

string

network_id
required

Database ID of network
Example : 156

integer(int32)

organization_id
required

Database ID of organization
Example : 134

integer(int32)

organization_name
required

Name of organization
Example : "Internal"

string

primary_dhcp_server
required

IP address of primary DHCP server
Example : "10.1.56.24"

string

5.161. Home Scopes

Fetches the top ten DHCP scopes in the TCPWave IPAM.

Name Description Schema

end_address
required

Get Ending Address
Example : "10.1.1.25"

string

not_leased
required

Get IP’s not leased count
Example : 10

integer(int32)

object_count
required

Get Object count
Example : 25

integer(int32)

start_address
required

Get Starting Address
Example : "10.1.1.0"

string

5.162. Home Subnet List Tree

This class contains the information about the list of monitoring service enabled DNS and DHCP servers list

Name Description Schema

class_code
required

Status of the remote appliance. either zero or one
Example : "0/1"

string

end_time
required

End time
Example : "02/09/2022"

string

explicit_server_type
required

Server type of remote appliance
Example : "BIND-AUTH"

string

id
optional

ID of remote appliance
Example : 69

integer(int32)

ipv4
required

IPv4 address of appliance
Example : "10.1.10.56"

string

ipv6
required

IPV6 address of appliance
Example : "2001:db8:a0b:12f0::1"

string

object_id
required

Object ID
Example : 8

integer(int32)

start_time
required

Start time
Example : "01/05/2022"

string

type
required

remote appliance type
Example : "BIND-AUTH"

string

valInt
required

Heartbeat status of the remote appliance. either zero or one
Example : "0/1"

integer(int32)

5.163. HopData

Name Description Schema

host
optional

string

index
optional

integer(int32)

ip
optional

string

lost
optional

string

time
optional

string

5.164. Host Naming Policies

This class represents a Host Naming Policy and contains the attributes necessary for Policy management functionality in the TCPWave IPAM. The information includes the Policy Name, Policy Id, Policy Value, Policy Type and other Policy related information.

Name Description Schema

created_by
required

Id of the User who has created the specified Policy.
Example : 2017

integer(int32)

created_by_login_name
optional

The User’s name, who has logged into the TCPWave IPAM, has been set as Created By for the specified policy.
Example : "Stephen"

string

created_by_name
optional

Name of the User who has created the specified Policy.
Example : "Stephen"

string

created_time
required

The time instance when the specified Policy has been created.
Example : "04/25/2022 4:39"

string(date-time)

created_time_string
optional

String format of the time when the specified Policy has been created.
Example : "04/25/2022 4:39"

string

policy_description
optional

Description for the specified Policy.
Example : "description"

string

policy_id
optional

ID of the specified policy.
Example : 10

integer(int32)

policy_name
required

Name of the specified Policy.
Example : "policy"

string

policy_type
required

Type of the specified policy.
Example : "Contains"

string

policy_value
required

Value of the specified Domain.
Example : "value"

string

updated_by
required

Id of the User who has modified the specified Policy.
Example : 2017

integer(int32)

updated_by_login_name
optional

The User’s name, who has logged into the TCPWave IPAM, has been set as Updated By for the specified policy.
Example : "John"

string

updated_by_name
optional

Name of the User who has modified the specified Policy.
Example : "Stephen"

string

updated_time
required

The time instance when the specified Policy has been updated.
Example : "04/25/2022 4:39"

string(date-time)

updated_time_string
optional

String format of the time when the specified Policy has been modified.
Example : "04/25/2022 4:39"

string

5.165. IPAM Sub Versions

Detailed information about IPAM Sub Versions.

Name Description Schema

autoRestarterVersion
required

Auto Restarter/Watchdog version
Example : "5.25.2"

string

bios
required

BIOS version
Example : "2.11.0"

string

cliengine
required

CLI engine version

string

dataengine
required

Data engine version

string

discovery
required

Discovery engine version

string

firmware
required

Firmware version
Example : "2.47.41"

string

galera
required

Galera version

string

heartbeat
required

Heart beat of appliance

boolean

ipam
required

IPAM version

string

kernel
required

Kernel version
Example : "4.4.194"

string

monitoringengine
required

Monitoring engine version

string

name
required

Name
Example : "Test"

string

ntp
required

NTP version

string

ntpServers
optional

string

scheduler
required

Scheduler version

string

searchengine
required

Search engine version

string

snmp
required

SNMP version

string

snmpTraps
optional

string

ssh
required

SSH version

string

syslogNGServers
optional

string

tacacsServers
optional

string

tcpwavemq
required

TCPWave AMQ version

string

5.166. IPAM statistics

Fetches the networks,subnets,objects,zones,servers ,scopes count defined in the TCPWave IPAM

Name Description Schema

admin
required

Get administrators count
Example : 5

integer(int64)

alert
optional

integer(int64)

cloud_provider
required

Get Cloud Providers count
Example : 5

integer(int64)

dhcp
required

Get dhcp servers count
Example : 3

integer(int64)

dhcp_option_template
required

Get option templates count
Example : 5

integer(int64)

dns
required

Get dns servers count
Example : 4

integer(int64)

network
required

Get networks count
Example : 5

integer(int64)

object
required

Get objects count
Example : 100

integer(int64)

scope
required

Get scopes count
Example : 0

integer(int64)

subnet
required

Get subnets count
Example : 10

integer(int64)

zone
required

Get zones count
Example : 7

integer(int64)

zone_dnssec
required

Get dnssec enabled zones count
Example : 5

integer(int64)

5.167. IPAM subcomponents version

Fetches the IPAM sub-components versions present in the TCPWave IPAM

Name Description Schema

name
required

Get global options name
Example : "CLI engine"

string

version
required

Get version of IPAM subcomponent
Example : "11.8"

string

5.168. IPAMAppliance

Name Description Schema

applianceGroups
optional

< Appliance Group > array

applianceGroupsStr
optional

string

created_by
required

IPAM appliance created by user Id
Example : 1219

integer(int32)

created_by_name
optional

IPAM appliance created by user name
Example : "twcuser"

string

created_time
optional

IPAM appliance created time stamp
Example : "1222221231"

string(date-time)

description
optional

IPAM appliance description
Example : "This is a IPAM appliance."

string

domain_id
optional

Domain Id
Example : 15

integer(int32)

domain_name
required

Domain name
Example : "tcpwave.com"

string

firewall_template
optional

Firewall template of the IPAM appliance
Example : "Firewall_Template"

string

firewall_template_id
optional

Template ID of Firewall template
Example : 15

integer(int32)

id
optional

IPAM Appliance ID
Example : 12

integer(int32)

ipamTemplate
optional

Template name of IPAM appliance

IPAMTemplate

isAlive
required

Is secure communication establish or not
Example : false

boolean

isClusterIPAM
optional

Is the IPAM appliance part of the HA or DR cluster or not?
Example : "true/false"

string

isHost
optional

Is IPAM appliance local host or not?
Example : false

boolean

lastSyncTime
optional

Last sync time of the IPAM appliance
Example : "05:21:35 02-01-2022"

string

mgmtIP
optional

IP address of management or primary network interface, that is used to connect to IPAM.
Example : "192.168.0.45"

string

name
required

Object name of the TCPWave IPAM type object or IPAM appliance name
Example : "test"

string

nicsConfig
optional

Details of network interface

NICConfig

object_id
optional

Object ID of the TCPWave IPAM type object
Example : 15

integer(int32)

old_firewall_template
optional

string

old_v4_ipaddress
required

Object IPv4 old address of the TCPWave IPAM type object
Example : "10.12.1.2"

string

oldtimeZone
optional

Old Time Zone of the IPAM appliance
Example : "GMT"

string

organization_id
optional

Organization Id
Example : 15

integer(int32)

organization_name
optional

Organization Name
Example : "Internal"

string

rtTablesJson
optional

RtTables information JSON string
Example : "[{\"port\":\"255\",\"name\":\"local\"},{\"port\":\"254\",\"name\":\"main\"},{\"port\":\"253\",\"name\":\"default\"},{\"port\":\"0\",\"name\":\"unspec\"}]"

string

snmpAcl
optional

Acl Name
Example : "TestAcl"

string

snmpAcl_id
optional

Acl Id
Example : 123

integer(int32)

sysLogs
optional

Syslog-ng configuration object
Example : "{\"globalOptions\":\"{\\\"timewaitdead\\\":\\\"70\\\",\\\"timetoidle\\\":\\\"78\\\",\\\"messagetoBuffer\\\":\\\"60\\\",\\\"twstatic\\\":\\\"600\\\",\\\"noofMsg\\\":\\\"1000\\\",\\\"maxSize\\\":\\\"65536\\\",\\\"logtime\\\":\\\"true\\\"}\",\"sourcesData\":[{\"name\":\"s_sys\",\"allSources\":[{\"type\":\"internal\",\"filePath\":null,\"fileName\":null,\"address\":null,\"port\":null,\"protocol\":null},{\"type\":\"system\",\"filePath\":null,\"fileName\":null,\"address\":null,\"port\":null,\"protocol\":null}],\"sourceTypes\":\"internal, system\"}],\"filtersData\":[{\"name\":\"f_default\",\"condition\":\"level(info..emerg) and not (facility(mail) or facility(authpriv) or facility(cron))\",\"category\":\"complex\"}],\"destinationData\":[{\"name\":\"d_mesg\",\"typeSNG\":\"File\",\"logDestGivenValSNG\":\"/var/log/messages\",\"syncAfterEachMsg\":false}],\"targetsData\":[{\"source\":\"s_sys\",\"logdestination\":\"d_mesg\",\"filter\":\"f_default\"}]}"

string

timeZone
optional

Time Zone of the IPAM appliance
Example : "GMT"

string

updated_by
optional

IPAM appliance updated by user Id
Example : 1219

integer(int32)

updated_by_name
optional

IPAM appliance updated by user name
Example : "twcuser"

string

updated_time
optional

IPAM appliance updated time stamp
Example : "1222221231"

string(date-time)

v4_ipaddress
required

Object IPv4 address of the TCPWave IPAM type object
Example : "10.12.1.2"

string

v6_ipaddress
optional

Object IPv6 address of the TCPWave IPAM type object
Example : "1000::"

string

5.169. IPAMApplianceTrafficData

Name Description Schema

date
optional

Current date of IPAM
Example : "2022-03-07"

string

destination
optional

Destination IP address
Example : "192.168.0.125"

string

destport
optional

Destination port of IPAM
Example : "61617/tcp"

string

information
optional

Traffic information
Example : "cksum 0x4aa5 (correct), ack 1806646258, win 128, length 0"

string

packetlength
optional

Size of packet
Example : "0"

string

protocol
optional

Protocols
Example : "TCP"

string

source
optional

Source IP address
Example : "192.168.0.120"

string

sourceport
optional

Source port of IPAM
Example : "53868/tcp"

string

time
optional

Current time of IPAM
Example : "21:12:12.373054"

string

5.170. IPAMServices

Name Description Schema

cli
optional

CLI service status
Example : "yes/no"

string

cron
optional

CRON service status
Example : "yes/no"

string

dbreplicator
optional

DB Replicator status
Example : "yes/no"

string

de
optional

DE service status
Example : "yes/no"

string

iptables
optional

IP table service status
Example : "yes/no"

string

mysql
optional

MariaDB status
Example : "yes/no"

string

name
optional

Name of the IPAM appliance
Example : "Test-IPAM"

string

ntp
optional

NTP service status
Example : "yes/no"

string

organization_id
optional

Organization ID
Example : 101

integer(int32)

organization_name
required

Organization Name
Example : "Internal"

string

search
optional

Search service status
Example : "yes/no"

string

servicesArr
optional

< string > array

snmp
optional

SNMP service status
Example : "yes/no"

string

ssh
optional

SSH service status
Example : "yes/no"

string

tims
optional

TIMS status
Example : "yes/no"

string

timsdiscovery
optional

DE service status
Example : "yes/no"

string

timsmonitor
optional

TIMS Monitor status
Example : "yes/no"

string

timsscheduler
optional

TIMS Scheduler status
Example : "yes/no"

string

v4_ipaddress
required

IPv4 IP address of the IAPM appliance
Example : "192.168.0.101"

string

v6_ipaddress
optional

IPv6 IP address of the IPAM appliance
Example : "1000::12"

string

5.171. IPAMServicesInfo

Name Description Schema

appliances
optional

List of IPAM appliances and their services.

< IPAMServices > array

operation
optional

Operation type
Example : "start/stop/restart/rebuild"

string

operationMethod
optional

Operation method
Example : "sequential/simultaneous"

string

schedTime
optional

Operation schedule time
Example : "2022-03-07 16:22:00"

string

services
optional

Comma separated services
Example : "ntpd,sshd,snmpd,cliserver"

string

5.172. IPAMTemplate

Name Description Schema

applianceType
optional

IPAM appliance type
Example : "development"

string

banner
optional

IPAM appliance banner text
Example : "This is a banner."

string

banner_color
optional

IPAM appliance banner text color
Example : "red"

string

created_by
required

IPAM appliance template created by user Id
Example : 1219

integer(int32)

created_by_name
optional

IPAM appliance template created by user name
Example : "twcuser"

string

created_time
optional

IPAM appliance template created time stamp
Example : "1222221231"

string(date-time)

description
optional

IPAM appliance template description
Example : "This is a test template."

string

dnsResolverConfig
required

IPAM appliance template DNSResolver configuration JSON string
Example : "{\"ns1\":\"10.2.1.21\",\"ns2\":\"\",\"ns3\":\"\",\"ns4\":\"\",\"search1\":\"\",\"search2\":\"\",\"search3\":\"\",\"search4\":\"\",\"search5\":\"\",\"search6\":\"\"}"

string

elevatedPrivilegesConfig
optional

Elevated Privileges Configuration Details
Example : "{\"environmentVariables\":[{\"value\":\"Defaults always_query_group_plugin\"}],\"userAliases\":[{\"user_alias_name\":\"USER_ALIAS_1\",\"user_alias_value\":\"testuser\"}],\"hostAliases\":[{\"host_alias_name\":\"HOST_ALIAS_1\",\"host_alias_value\":\"192.168.0.139\"}],\"runasAliases\":[{\"runas_alias_name\":\"RUNAS_ALIAS_1\",\"runas_alias_value\":\"user2\"}],\"commandAliases\":[{\"command_alias_name\":\"COMMAND_ALIAS_1\",\"command_alias_value\":\"/cp\"}],\"userSpecifications\":[{\"user_alias\":\"USER_ALIAS_1\",\"host_alias\":\"HOST_ALIAS_1\",\"runas_alias\":\"RUNAS_ALIAS_1\",\"runas_group_alias\":\"\",\"command_alias\":\"COMMAND_ALIAS_1\",\"taglist\":\"\"}]}"

string

elevatedPrivilegesJson
optional

Elevated Privileges Configuration JSON String
Example : "{\"environmentVariables\":[{\"value\":\"Defaults always_query_group_plugin\"}],\"userAliases\":[{\"user_alias_name\":\"USER_ALIAS_1\",\"user_alias_value\":\"testuser\"}],\"hostAliases\":[{\"host_alias_name\":\"HOST_ALIAS_1\",\"host_alias_value\":\"192.168.0.139\"}],\"runasAliases\":[{\"runas_alias_name\":\"RUNAS_ALIAS_1\",\"runas_alias_value\":\"user2\"}],\"commandAliases\":[{\"command_alias_name\":\"COMMAND_ALIAS_1\",\"command_alias_value\":\"/cp\"}],\"userSpecifications\":[{\"user_alias\":\"USER_ALIAS_1\",\"host_alias\":\"HOST_ALIAS_1\",\"runas_alias\":\"RUNAS_ALIAS_1\",\"runas_group_alias\":\"\",\"command_alias\":\"COMMAND_ALIAS_1\",\"taglist\":\"\"}]}"

string

enableSNMPv3
required

Specifies whether SNMPv3 is enabled or not on the IPAM.
Example : true

boolean

id
optional

IPAM appliance template Id
Example : 15

integer(int32)

idracConfig
optional

IPAM appliance template iDrac configuration JSON string
Example : "{\"password\":\"\",\"address\":\"\",\"enable\":\"\",\"snmp_community_string\":\"\"}"

string

ldapSSHConfig
optional

LDAP_SSH Configuration JSON String
Example : "{\"enable\":false}"

string

log_file_size
optional

IPAM appliance template, log file size
Example : "5MB"

integer(int32)

name
optional

IPAM appliance template name
Example : "test"

string

no_of_backup_log_files
optional

IPAM appliance template, no of backup log files
Example : 5

integer(int32)

ntpConfig
required

Comma separated NTP appliances of IPAM appliance template
Example : "10.2.2.1,10.2.21.1"

string

oldName
required

IPAM appliance template old name
Example : "test"

string

organization
required

Organization name
Example : "Internal"

string

organization_id
optional

Organization Id
Example : 2121

integer(int32)

rootConfig
optional

IPAM appliance template Root password
Example : "abc"

string

snmpConfig
required

IPAM appliance template SNMP configuration JSON string
Example : "{\"systemLocation\":\"\",\"processes\":\"ntpd-1/snmpd-0/crond-0/sshd-0/de-1/cli-0/search-1/tims-0/timsscheduler-0/mysql-0\",\"trapSink2\":\"10.2.2.43\",\"communityString\":\"8DE1BF9E2B9819A3\",\"trapSink1\":\"10.2.1.122\",\"systemContact\":\"\",\"sendToThirdParty\":\"yes\"}"

string

snmpv3Users
required

Specifies list of SNMPv3 users.

string

ssh_banner
optional

IPAM appliance SSH banner text
Example : "This is a SSH banner."

string

sysLogNgConfig
optional

Syslog-ng configuration object

Syslog-ng configuration details

sysLogsConfig
optional

Syslog-ng configuration object
Example : "{\"globalOptions\":\"{\\\"timewaitdead\\\":\\\"70\\\",\\\"timetoidle\\\":\\\"78\\\",\\\"messagetoBuffer\\\":\\\"60\\\",\\\"twstatic\\\":\\\"600\\\",\\\"noofMsg\\\":\\\"1000\\\",\\\"maxSize\\\":\\\"65536\\\",\\\"logtime\\\":\\\"true\\\"}\",\"sourcesData\":[{\"name\":\"s_sys\",\"allSources\":[{\"type\":\"internal\",\"filePath\":null,\"fileName\":null,\"address\":null,\"port\":null,\"protocol\":null},{\"type\":\"system\",\"filePath\":null,\"fileName\":null,\"address\":null,\"port\":null,\"protocol\":null}],\"sourceTypes\":\"internal, system\"}],\"filtersData\":[{\"name\":\"f_default\",\"condition\":\"level(info..emerg) and not (facility(mail) or facility(authpriv) or facility(cron))\",\"category\":\"complex\"}],\"destinationData\":[{\"name\":\"d_mesg\",\"typeSNG\":\"File\",\"logDestGivenValSNG\":\"/var/log/messages\",\"syncAfterEachMsg\":false}],\"targetsData\":[{\"source\":\"s_sys\",\"logdestination\":\"d_mesg\",\"filter\":\"f_default\"}]}"

string

systemResources
required

Specifies system resource option values

string

tacacsConfig
required

IPAM appliance template TACACS configuration JSON string
Example : "{\"appliance\":\"\",\"enable\":false,\"pass_key\":\"\"}"

string

updated_by
optional

IPAM appliance template updated by user Id
Example : 1219

integer(int32)

updated_by_name
optional

IPAM appliance template updated by user name
Example : "twcuser"

string

updated_time
optional

IPAM appliance template updated time stamp
Example : "1222221231"

string(date-time)

5.173. IPAMTopicStats

Name Description Schema

rx_msg_count
optional

integer(int64)

rx_msg_size
optional

integer(int64)

stat_time
optional

string

topic
optional

string

tx_msg_count
optional

integer(int64)

tx_msg_size
optional

integer(int64)

5.174. IPAMVersion

Name Description Schema

bldDisplayString
optional

string

bldString
optional

string

majorVersion
optional

string

minorVersion
optional

string

patchLevel
optional

integer(int32)

5.175. IPV6 Scope

Persists the attributes of DHCP v6 Scope such as start address, end address, subnet address, network address, organization, DHCP v6 Option Template, DHCP v6 Server, DHCP v6 Classes to be allowed and denied etc.

Name Description Schema

allocation_type
optional

IPv6 object allocation type
Example : "4"

string

class_code
optional

IPv6 object class code
Example : "Router"

string

count
optional

Number of scopes to be created.
Example : 1

integer(int32)

created_by_login_name
optional

Login name of the user who created the entity

string

created_by_name
optional

Login name of the user who created the entity

string

created_time
optional

Date and Time of creation of the entity

string(date-time)

created_time_string
optional

String instance of the created time

string

description
optional

Description
Example : "Adding an object."

string

endIP
optional

IPv6 scope end IP address
Example : "4c-2018:2018::95"

string

network_address
optional

IPv6 network address
Example : "1000::"

string

organization_name
optional

Organization
Example : "Internal"

string

primary_dhcp_server
optional

IPv6 primary DHCP appliance
Example : "dhcpserver"

string

size
optional

Number of DHCP objects in the scope range.
Example : 3

integer(int32)

startIP
optional

IPv6 scope start IP address
Example : "2018:2018"

string

subnetAddress
optional

IPv6 subnet address
Example : "1000::"

string

template_name
optional

IPv6 template
Example : "template"

string

updated_by_login_name
optional

Login name of the user who updated the entity

string

updated_by_name
optional

Login name of the user who updated the entity

string

updated_time
optional

Date and Time of updating the entity

string(date-time)

updated_time_string
optional

String instance of the updated time

string

v6_dhcp_server_address
optional

string

5.176. IPv6 Network Details

This class provides the attributes that are associated with an IPv6 network such as the address, size, mask length etc.

Name Description Schema

address
required

Full address of the IPv6 network

string

block_count
optional

integer(int32)

block_id
optional

integer(int32)

cloud_region
optional

string

contact_email_id
optional

string

contact_id
optional

integer(int32)

contact_name
optional

string

createRevZone
optional

Auto create reverse zone for a network
Example : "Yes/No"

string

created_by
optional

Database ID of the user who created the entity

integer(int32)

created_by_login_name
optional

Login name of the user who created the IPv6 network

string

created_by_name
required

Database ID of the user who created the entity
Example : "22"

string

created_time
required

IPv6 network created time in the TCPWave IPAM
Example : "03/18/2022 3:39"

string(date-time)

description
optional

Description of IPv6 Network

string

dhcp_enabled_subnets
required

Number of DHCP enabled subnets in IPv6 network in the TCPWave IPAM

integer(int32)

discoveryTemplateId
required

Id of the Discovery Template defined in the organization which is associated with the specified Network.
Example : 41010

integer(int32)

discovery_template
required

Name of the Discovery Template defined in the organization which is associated with the specified Network.
Example : "DiscoveryTemp1"

string

dmzVisible
required

Specifies whether the zone which is associated with the Network is a Demilitarized Zone(DMZ) or not.
Example : "Yes/No"

string

dnssec_enable
required

Specifies whether Domain Name System Security Extensions(DNSSEC) enabled or not for the zone associated with the specified Network.
Example : "Yes/No"

string

email_id
optional

Internal use only

string

enable_discovery
required

Specifies whether discovery is enabled or not for the specified Network.
Example : "Yes/No"

string

end_addr_val
optional

Internal use only

integer(int64)

extensions
optional

< Xtn NVP > array

first_name
optional

string

has_block
optional

boolean

has_blocks
optional

integer(int32)

id
optional

Database ID of the IPv6 network

integer(int32)

ipv6ShortAddress
optional

IPv6 short address
Example : "3000::"

string

last_name
optional

string

mask_length
required

IPv6 network mask length

integer(int32)

middle_name
optional

string

monitoringService
optional

string

name
required

Name of the IPv6 network

string

network_id
optional

string

nsec_option
required

Takes NSEC or NSEC3 when Domain Name System Security Extensions(DNSSEC) is enabled for the zone which is associated with the specific Network.
Example : "NSEC/NSEC3"

string

nw_mask_length
required

Mask length of the IPv6 Network

integer(int32)

object_count
optional

Number of objects defined in this IPV6 Network

integer(int32)

oldName
required

Old name of the IPv6 network
Example : "IPv6TestNetwork"

string

organization_id
required

Organization ID of the network

integer(int32)

organization_name
required

Organization name of the network

string

parent_block
optional

integer(int32)

parent_pool
optional

integer(int32)

percentChanged
optional

boolean

percent_full
optional

Threshold percentage full for the IPv6 network

number(double)

percentageFull
optional

Percentage usage of a given network

integer(int32)

pool
optional

boolean

poolAddress
optional

string

pool_id
optional

integer(int32)

pool_name
optional

string

pool_short_ip
optional

string

reverse_zone
optional

Reverse Zone for the given IPv6 network

string

reverse_zone_serial
required

Serial Number of the Reverse Zone which is associated with the specified Network.
Example : 2016102800

integer(int32)

rrs
required

List of Resource Records associated with the specified IPv6 Network.

< Resource Record > array

selectedMasterServer
required

List of Master Servers defined in Zone Templates associated with the specified IPv6 Network.

< Server Information > array

selectedSlaveServer
required

List of Slave Servers defined in Zone Templates associated with the specified IPv6 Network.

< Server Information > array

serialFormat
required

Serial Number format of the zone which is associated with the specified Network.
Example : "NODATE/DATE"

string

server_count
optional

Number of servers provisioned in the IPv6 network

integer(int32)

server_id
required

Id of the server which is associated with the specified Network.
Example : 121

integer(int32)

server_name
required

Name of the server which is associated with the specified Network.
Example : "lisartx-est015-sl012"

string

startAddress
optional

IPv6 network Start Address

string

start_addr_val
optional

Internal use only

integer(int64)

subnet_count
optional

Number of subnets defined in the IPv6 network

integer(int32)

templateList
required

Provides the list of templates to be applied to IPv6 network

< Template > array

updated_by
optional

Login ID of the user who updated the IPv6 Network

integer(int32)

updated_by_login_name
optional

Login name of the user who updated the IPv6 network

string

updated_by_name
optional

Login ID of the user who updated the IPv6 Network

string

updated_time
required

IPv6 network updated time in the TCPWave IPAM
Example : "03/18/2022 3:40"

string(date-time)

vrf_id
optional

integer(int32)

vrf_name
optional

string

zoneTemplateId
required

Id of the Zone Template defined in the zone which is associated with the specified Network.
Example : 41010

integer(int32)

zoneTemplateName
required

Name of the Zone Template defined in the zone which is associated with the specified Network.
Example : "ZoneTemp1"

string

5.177. IPv6 Subnet

This class provides the attributes that are associated with an IPv6 network such as the address, size, mask length etc.

Name Description Schema

alloc_type
optional

string

awsSubnetId
optional

string

block_address
optional

IPv6 Network address of this IPv6 Subnet

string

block_id
optional

ID of the IPv6 Network to which the IPv6 Subnet belongs

integer(int32)

block_mask
optional

integer(int32)

block_name
optional

Name of the IPv6 Network to which the IPv6 Subnet belongs

string

city
optional

City of the location

string

cloudProviderId
optional

integer(int32)

cloudProviderName
optional

string

contact_id
optional

Contact ID of the admin user whom the IPv6 subnet is associated

integer(int32)

country
optional

Country of the location
Example : "spain"

string

createRevZone
optional

string

created_by_name
optional

Name of the User who has created the specified IPv6 subnet.
Example : "Stephen"

string

created_time
optional

Date and Time of creation of the IPv6 subnet

string(date-time)

created_time_string
optional

String instance of the created time.

string

description
optional

Description of the IPv6 Subnet

string

dhcpFailoverPeer
optional

string

dhcp_object_count
optional

integer(int64)

dhcpserverType
optional

string

discoveryTemplateId
optional

integer(int32)

discovery_template
optional

string

dns_appliances
optional

string

domains
optional

List of the secondary domains

< string > array

email_id
optional

Email ID of the admin user whom the IPv6 subnet is associated

string

enable_discovery
optional

string

endAddress
optional

string

extensions
optional

< Xtn NVP > array

first_name
optional

First Name of the admin user whom the IPv6 subnet is associated

string

id
optional

ID of the IPv6 subnet

integer(int32)

last_name
optional

Last Name of the admin user whom the IPv6 subnet is associated

string

location_id
optional

Location ID of the IPv6 subnet

integer(int32)

location_name
optional

Location name of the IPv6 subnet

string

mask_length
optional

Mask length of the IPv6 Subnet

integer(int32)

merge_subnet_end_ip
optional

string

merge_subnet_start_ip
optional

string

middle_name
optional

string

name
optional

Name of the IPv6 Subnet

string

network_id
optional

string

object_count
optional

Total number of objects defined in the IPv6 subnet

integer(int64)

organization_id
optional

Organization ID to which the IPv6 subnet is associated

integer(int32)

organization_name
optional

Name of the Organization to which the IPv6 subnet is associated

string

percent_full
optional

Threshold percentage full for the IPv6 Subnet

number(double)

primary_dhcp_server
optional

Name of the primary DHCP Appliance

string

primary_dhcp_server_address
optional

Associated v6 primary DHCP appliance address
Example : "20182018000000000000000000000020"

string

primary_domain
optional

Name of the Primary domain of the subnet

string

primary_router
optional

string

reclaim_objects
optional

string

region
optional

string

routerAddress
required

Address of the primary router

string

router_name
required

Name of the primary router

string

router_option
required

Selection option for the primary router - can be either the first IP in the subnet or the last IP in the subnet

string

schedule_job_id
optional

string

schedule_reclaim
optional

string

secondaryDomains
optional

< string > array

secondaryDomainsString
optional

string

sharedNetwork
optional

string

startAddress
optional

string

state
optional

State - of the location

string

street1
optional

Street 1 of the location

string

street2
optional

Street 2 of the location

string

subnetTemplateName
optional

string

subnet_group_id
optional

ID of the group to which this IPv6 Subnet belongs

integer(int32)

subnet_group_name
optional

Name of the group to which the IPv6 Subnet belongs

string

subnet_template
optional

Name of the subnet template.
Example : "testTemplate1"

string

subnetscreate
optional

string

subnetview
optional

string

template_id
optional

Database ID of the DHCP Option Template

integer(int32)

template_name
optional

Name of the DHCP Option Template

string

updated_by_name
optional

Name of the User who has modified the specified IPv6 subnet.
Example : "John"

string

updated_time
optional

Date and Time of updating the IPv6 subnet

string(date-time)

updated_time_string
optional

String instance of the updated time.

string

v4_primary_dhcp_server_address
optional

Associated v4 primary DHCP appliance address
Example : "192.168.0.145"

string

viewList
optional

< DNS View > array

vlan_id
optional

VLAN ID of the IPv6 subnet

string

vrfGrid
optional

string

vrf_id
optional

integer(int32)

vrf_name
optional

string

xtn
optional

string

zip
optional

Zip code of the location

string

zoneTemplateId
optional

integer(int32)

zoneTemplateName
optional

string

5.178. IPv6 object

This class provides the attributes that are associated to a IPv6 object such as the name, domain, etc.

Name Description Schema

addedRRs
optional

< Resource Record > array

address
required

IPv6 Address of the object.

string

addressArray
optional

Collection of IPv6 Addresses - for Internal use.

< string > array

alias
optional

Alias Name of IPV6 Object.

string

alloc_type
required

Allocation Type for this IPv6 object.

integer(int32)

alloc_type_desc
required

Allocation type: Static, Dynamic, Manual or Auto.

string

allowClassesArray
optional

List of DHCP Classes applicable to this object.

< string > array

change_control_team
optional

Details of the change control team
Example : "56"

string

city
optional

City of the location.

string

class_code
required

Object type/Class code of the IPv6 object.

string

client_hostname
required

Hostname of this object.

string

contact_email_id
required

Email address of the IPv6 object.
Example : "[email protected]"

string

contact_first_name
required

First name of the IPv6 object.
Example : "Shawn"

string

contact_id
required

Database ID of the contact.
Example : 524

integer(int32)

contact_last_name
optional

Last name of the IPv6 object.
Example : "Mendes"

string

contact_middle_name
optional

Middle name of the IPv6 object.

string

contact_name
optional

Name of the contact responsible for this IPv6 object.

string

country
optional

Country Name.

string

created_by_name
optional

Name of the user who created this IPv6 object.

string

created_time_string
optional

String instance of the created time.

string

deletedRRs
optional

< Resource Record > array

denyClassesArray
optional

List of denied DHCP Classes for this object.

< string > array

description
optional

Description of the IPv6 Object.

string

dhcp_server
optional

DHCP Appliance associated to this Object.

string

domain_id
required

Database ID of the domain associated to this IPv6 object.

integer(int32)

domain_name
required

Name of the domain associated to this IPv6 object.

string

dyn_update_rrs_aaaa
required

Dynamic update DNS with AAAA Resource Records.

boolean

dyn_update_rrs_cname
required

Dynamic update DNS with CNAME Resource Records.

boolean

dyn_update_rrs_mx
required

Dynamic update DNS with MX Resource Records.

boolean

dyn_update_rrs_ptr
required

Dynamic update DNS with PTR Resource Records.

boolean

end_of_life
optional

End of life for this object
Example : "03/29/2022"

string

ends
optional

Lease end time in case of a DHCPv6 Object.

string

extensions
optional

< Xtn NVP > array

floor
optional

Floor (placement) of this object
Example : "3"

string

fullAddress
optional

IPv6 full address.

string

id
optional

Database ID the object.

integer(int32)

ip_address
required

IPv6 Address of this object.

string

isDeleterrsChecked
required

Delete resource record references.
Example : "0 or 1"

integer(int32)

isRenew
optional

Lease status of dynamic object
Example : true

boolean

last_seen
optional

Last seen date and time of this object
Example : "2022-02-21 05:30:25"

string(date-time)

location_id
required

Database ID of the location.
Example : 2

integer(int32)

location_name
optional

Name of the location.
Example : "New York"

string

mac
optional

MAC Address of this IPv6 object.

string

mac_address
optional

MAC Address of this object.

string

managed_by
optional

Name of user who manages this object
Example : "John"

string

model_type
optional

Model type of this IPv6 object.

string

monitored_by
optional

Name of the user who manages this object
Example : "Andrew"

string

name
optional

Name of the IPv6 object.

string

object_short_address
optional

IPv6 short address
Example : "3000::"

string

oldName
optional

string

option_template_id
optional

DHCPv6 Option Template ID.

integer(int32)

option_template_name
optional

Name of the DHCPv6 Option Template.

string

organization_id
optional

Database ID of the organization.

integer(int32)

organization_name
required

Name of the organization associated with this IPv6 object.

string

room
optional

Room (placement) of this object
Example : "6"

string

rrs
optional

Collection of Resource Records associated to this IPv6 object.

< Resource Record > array

serial_num
optional

Serial Number of this IPv6 object.

string

shortAddress
optional

Short IPv6 address.

string

starts
optional

Lease Start time in case of a DHCPv6 Object.

string

state
optional

State of the location.

string

street1
optional

Street-1 of the location.
Example : "Lane-1"

string

street2
optional

Street-2 of the location.

string

subnet_address
required

Subnet address to which the IPv6 object belongs to.

string

subnet_id
required

Database ID of the subnet associated to this IPv6 object.

integer(int32)

subnet_name
optional

Name of the subnet to which object associated to
Example : "v6subnet-5689"

string

terminal_server_kvm
optional

Terminal Server for this object
Example : "10.0.0.5"

string

ttl
optional

Time to live for this IPv6 object.

integer(int32)

update_ns_aaaa
required

Dynamic update DNS with the AAAA records.

boolean

update_ns_ptr
required

Dynamic update DNS with PTR records.

boolean

updated_by_name
optional

Name of the user who updated this IPv6 object.

string

updated_time
optional

Name of the user who created this IPv6 object.

string(date-time)

updated_time_string
optional

String instance of the updated time.

string

v6addr
optional

IPv6 object address

string

zip
required

Zip code of the location.
Example : "3001"

string

5.179. Idn

Type : object

5.180. IdracSslCert

Name Description Schema

applianceIp
required

IP address of the appliance.
Example : "10.1.10.244"

string

applianceName
optional

Name of the appliance.
Example : "appliance001"

string

applianceType
required

Type of the appliance.
Example : "BIND AUTH"

string

idracIP
optional

iDRAC IP address of the appliance.
Example : "10.1.10.240"

string

organization
required

Name of the organization.
Example : "TCPWave"

string

sslCert
optional

Name of the iDRAC server certificate. This is required in upload operation.
Example : "cert.crt"

string

sslCertKey
optional

Name of the iDRAC key certificate. This is required in upload operation.
Example : "cert.key"

string

sslCertType
optional

Type of the iDRAC certificate. Specify '1' for SSL server certificate and '3' for custom signing certificate. This is required while upload and download operation.
Example : "1"

string

sslOperationResponseMessage
optional

Response message of the SSL certificate operation.

string

sslOperationStatus
optional

Status of the SSL certificate operation.
Example : "Success"

string

sslPkcsPassphrase
optional

Pass phrase of the PKCS12 certificate. This is required while uploading custom signing certificate.

string

5.181. Import Cloud Response

This class encapsulates the response message of Import from Cloud operation on a Subnet.

Name Description Schema

result
required

Result string contains cloud response

string

5.182. Import Command

This encapsulates the Import request which includes input file, output file, error file and maximum permissible errors.

Name Description Schema

error_file
optional

Error file

string

failed_entries_file
optional

File containing only failed entries

string

input_file
required

input file to import

string

max_permissible_errors
optional

Maximum permissible errors

integer(int32)

output_file
required

output file to store result

string

5.183. Import Instances From Cloud Subnet

This class encapsulates the information required to import instances from a cloud subnet in the TCPWave IPAM.

Name Description Schema

cloudProvider
required

Database ID of the cloud provider
Example : 101

integer(int32)

orgName
required

Name of the organization
Example : "Internal"

string

5.184. Import Response Information

Holds the End result of an import process such as: Time taken to import, Import File path, Number of errors due to referential integrity checks etc.

Name Description Schema

elapsed_time
optional

Total time taken to process the import

integer(int64)

error_count
optional

Number of errors in an import

integer(int32)

error_message
optional

Reason for the failure

string

failed_rows
optional

Collection of failed rows

< Failed Row Information > array

importType
required

Import Type
Example : "Object"

string

import_command
optional

Instance that is being imported

Import Command

imported_rows
optional

Number of rows that have been imported successfully

integer(int32)

is_success
optional

Is the import operation successful?
Example : true

boolean

responseText
optional

Return response message of the import

string

success_rows
optional

Collection of success rows

< Failed Row Information > array

total_rows
optional

Number of rows that are attempted to be imported

integer(int32)

5.185. Import Type Information

Holds a list of predefined entities that the product can import.

Name Description Schema

description
optional

Description of imported file

string

type
required

Import file type

string

5.186. Internet Root Hint

This class represents an Internet Root Hint and contains the attributes necessary for Internet Root Hint management functionality in the TCPWave IPAM. The information includes the Zone Name, Name Service Record, Time To Live(TTL) Value and other Internet Root Hint related information.

Name Description Schema

createdBy
required

Id of the User who has created the specified Internet Root Hint.
Example : 2017

integer(int32)

createdByName
optional

User Name who has created the specified Internet Root Hint.
Example : "Stephen"

string

createdTime
optional

The time instance when the specified Internet Root Hint has been created.
Example : "03/18/2022 3:39"

string(date-time)

createdTimeString
optional

String format of the time when the specified Internet Root Hint has been created.
Example : "03/18/2022 3:39"

string

description
optional

Description of the specified Internet Root Hints
Example : "FORMERLY NS.INTERNIC.NET"

string

id
optional

Id of the specified Internet Root Hint.
Example : 23

integer(int32)

ipv4
required

IPv4 Address of the specified Internet Root Hint
Example : "198.41.0.4"

string

ipv6
required

IPv6 Address of the specified Internet Root Hint
Example : "2001:503:ba3e::2:30"

string

ns
required

Name Service record of the specified Internet Root Hint
Example : "A.ROOT-SERVERS.NET."

string

ttl
required

Time To Live(TTL) value of the specified Internet Root Hint
Example : 3600000

integer(int32)

updatedBy
required

Id of the User who has modified the specified Internet Root Hint.
Example : 2019

integer(int32)

updatedByName
optional

User Name who has modified the specified Internet Root Hint.
Example : "John"

string

updatedTime
optional

The time instance when the specified Internet Root Hint has been modified.
Example : "03/18/2022 4:37"

string(date-time)

updatedTimeString
optional

String format of the time when the specified Internet Root Hint has been modified.
Example : "03/18/2022 4:37"

string

zoneName
required

Root zone name of specified Internet Root Hint
Example : "."

string

5.187. InternetRootHints Sync

This class represents an Internet root hint and contains the attributes necessary for Internet root hint Sync functionality in the TCPWave IPAM. The information includes the Organization Name & Server List.

Name Description Schema

organization_name
required

Name of an Organization.
Example : "tcpwave"

string

serversInfo
required

Array list of InternetRootHint SyncInfo objects of an InternetRootHint that contains the server IP address, server name and other sync related information.

< InternetRootHints Sync Information > array

5.188. InternetRootHints Sync Information

InternetRootHintsSyncInfo bean class encapsulates the attributes like organization name and other information related to InternetRootHints Sync.

Name Description Schema

isSyncSuccess
optional

States if InternetRootHint sync is successful or not.
Example : false

boolean

serverIP
required

IPV4 Address which is associated with the specified Server.
Example : "192.1.10.200"

string

serverName
required

Name of a DNS Server.
Example : "nusartx-est015-sl09113"

string

5.189. Intrusion Provision System Rule

This class represents a rule definition which can be used for intrusion detection and prevention.

Name Description Schema

action
required

Action of the IPS Rule.
Example : "drop"

string

classtype
required

Classtype of the IPS Rule.
Example : "pup-activity"

string

destination_ip
required

Destination IP address of the IPS Rule.
Example : "172.16.0.20"

string

destination_port
required

Destination port of the IPS Rule.
Example : "53"

string

id
required

ID of IPS Rule.

integer(int32)

message
required

Message of the IPS Rule.
Example : "(msg:\"TCPWAVE DNS TITAN This is a drop query test\"; dns_query; content:\"www.drop.com\"; depth:14; fast_pattern; endswith; nocase; rev:33;)"

string

protocol
required

Protocol of the IPS Rule.
Example : "dns"

string

ruleDefinition
required

Definition of IPS Rule.

string

signature_id
required

Signature Id of the IPS Rule.
Example : 123

integer(int32)

source_ip
required

Source IP address of the IPS Rule.
Example : "192.168.0.20"

string

source_port
required

Source port of the IPS Rule.
Example : "229"

string

status
required

Status of the IPS Rule.
Example : true

boolean

templateId
required

Template ID in which specified IPS Rules defined

integer(int32)

5.190. IntrusionPreventionAlerts

Name Description Schema

applianceAddress
optional

string

count
optional

integer(int32)

date
optional

string

id
optional

integer(int32)

optionType
optional

string

optionValue
optional

string

time
optional

string

timeStamp
optional

string

5.191. IpPermission

Name Description Schema

fromPort
optional

integer(int32)

ipProtocol
optional

string

ipRanges
optional

< string > array

ipv4Ranges
optional

< IpRange > array

ipv6Ranges
optional

< Ipv6Range > array

prefixListIds
optional

< PrefixListId > array

toPort
optional

integer(int32)

userIdGroupPairs
optional

< UserIdGroupPair > array

5.192. IpRange

Name Description Schema

cidrIp
optional

string

description
optional

string

5.193. Ipv6Range

Name Description Schema

cidrIpv6
optional

string

description
optional

string

5.194. Job data for scheduling operation.

This bean encapsulates the information needed to execute the operation when it is scheduled.

Name Description Schema

data
optional

Scheduled job details

string

entity
optional

Entity type for scheduled operation
Example : "zone"

string

extensiondata
optional

Extension details

string

operation
optional

Type of scheduled operation
Example : "true"

string

userIP
optional

IP address of the system from which operation is scheduled
Example : "192.168.0.139"

string

userId
optional

Database id of the user
Example : 1225

integer(int32)

5.195. KerberosConfSections

Name Description Schema

appdefaults
optional

Contents of the appdefaults section in the Kerberos configuration file.

< string, string > map

capaths
optional

Contents of the capaths section in the Kerberos configuration file.

< string, string > map

domain_realm
optional

Contents of the domain_realm section in the Kerberos configuration file.

< string, string > map

libdefaults
optional

Contents of the libdefaults section in the Kerberos configuration file.

< string, string > map

logging
optional

Contents of the logging section in the Kerberos configuration file.

< string, string > map

plugins
optional

Contents of the plugins section in the Kerberos configuration file.

< string, string > map

realms
optional

Contents of the realms section in the Kerberos configuration file.

< string, string > map

5.196. KerberosKeytabData

Name Description Schema

encryptionType
optional

Encryption type of the keytab entry.

string

kvNo
optional

KVNO of the keytab file entry.

string

principle
optional

Principle of the keytab file entry.

string

slot
optional

Slot of the keytab entry.

string

timestamp
optional

Timestamp of the keytab file entry.

string

5.197. Last sync status

Fetches the last sync status information of DNS/DHCP Appliances in the TCPWave IPAM

Name Description Schema

ip
required

Get server IP Address
Example : "10.1.1.23"

string

last_updated
required

Get last updated time
Example : "2022-01-18 16:11:30"

string

name
required

Get server name
Example : "nsuax"

string

scode
required

Get server type
Example : "DHCP"

string

status
required

Get server sync status
Example : "nsuax"

string

status_msg
required

Get last sync status message
Example : "Sync successful for DNS Appliance: 10.1.1.23"

string

synctime
required

Get last sync time
Example : "2022-01-18 16:11:30"

string

5.198. License Data

This class represents the License information of IPAM server.

Name Description Schema

cust
optional

string

custId
optional

string

daysToExpiry
optional

integer(int32)

expiry
optional

string(date-time)

expiryString
optional

string

haEnabled
optional

boolean

ip
optional

string

isPermanent
optional

boolean

licenseValid
optional

string

major_version
optional

string

maxIPs
optional

integer(int32)

minor_version
optional

string

serviceTag
optional

string

titanEus
optional

TitanEndUserSecurity

5.199. LicenseData

Name Description Schema

cust
optional

string

cust_id
optional

string

daysToExpiry
optional

integer(int32)

expiry
optional

string(date-time)

expiryString
optional

string

ip
optional

string

isPermanent
optional

boolean

licenseExpired
optional

boolean

licenseHostValid
optional

boolean

licensePresent
optional

boolean

licenseValid
optional

boolean

major_version
optional

string

minor_version
optional

string

serverType
optional

integer(int32)

serviceTag
optional

string

serviceTagValid
optional

boolean

status
optional

string

5.200. Location References

This class represents the Subnets which are associated to a location in the TCPWave IPAM.

Name Description Schema

subnet
required

Subnet

Subnet

5.201. Locations

Holds the information that is relevant to a location such as the street address, city, state , zip code etc.

Name Description Schema

city
required

City of the location
Example : "WARNERTOWN"

string

country
required

Country of the location
Example : "Australia"

string

created_by_name
optional

Name of the user who created the location
Example : "admin"

string

created_time
optional

Date and time of the creation of the entity

string(date-time)

created_time_string
optional

String instance of the updated time

string

full_location
optional

Complete address which contains Street 1, Street2, City, State, Country, ZIP code etc.
Example : "22 Main street, Opp. white mall, WARNERTOWN, Sydney, Australia-5540"

string

id
optional

Database ID of the location
Example : 22

integer(int32)

new_city
required

New City of the location to update
Example : "Toronto"

string

new_country
required

New Country of the location to update
Example : "Canada"

string

new_state
required

New State of the location to update
Example : "Ontario"

string

new_street1
required

New Street 1 of the location to update
Example : "32 Main street"

string

new_street2
required

New Street 2 of the location to update
Example : "Opp. Red Bungalow"

string

new_zip
required

New Zip code of the location to update
Example : "6580"

string

organization_id
optional

Organization ID of the location
Example : 3401

integer(int32)

organization_name
required

Organization name of the location
Example : "QAOrg"

string

state
required

State of the location
Example : "Sydney"

string

street1
required

Street 1 of the location
Example : "22 Main street"

string

street2
required

Street 2 of the location
Example : "Opp. white mall"

string

updated_by_name
optional

Name of the user who updated the location
Example : "admin"

string

updated_time
optional

Date and time of updating the entity

string(date-time)

updated_time_string
optional

String instance of the created time

string

zip
required

Zip code of the location
Example : "5540"

string

5.202. Log

This class contains detailed Information about logs. The information includes the hostname, log message and file name.

Name Description Schema

date
required

Date and time of the log generation.
Example : "2022-03-04 6:16:29"

string

file_name
required

Name of file to which the log belongs to.
Example : "/opt/tcpwave/logs/Tims.log"

string

hostName
required

Name of the system where the log is generated.
Example : "COMMON-DEVELOPER-IPAM"

string

message
required

Log message.
Example : "Domain tcpwave.com has been created successfully."

string

5.203. Logger

This class represents the Log category information and different log channels.

Type : object

5.204. Logger Category

This class contains Logger Category information. The information includes the Id, Name and its description.

Name Description Schema

category
required

Specific class of the specified Log Category.
Example : "Client"

string

description
required

Description of the specified Log Category.
Example : "Processing of client requests."

string

id
optional

Id of the specified Log Category.
Example : 13

integer(int32)

5.205. Logger Channel

This class contains detailed information about Log Channel. This includes log channel name, type, versions, severity and debug level etc.

Name Description Schema

channel
required

Name of the specified Log Channel.
Example : "named"

string

created_by_name
required

User Name who has created the specified Log Channel.
Example : "Stephen"

string

created_time
required

The time instance when the specified Log Channel has been created.
Example : "03/18/2022 3:39"

string(date-time)

created_time_string
required

String format of the time when the specified Access Control List has been created.
Example : "03/18/2022 3:39"

string

debug_level
required

Debug level of a log channel.
Example : 0

integer(int32)

facility
required

The facility argument is used to specify what type of program is logging the message.
Example : "syslog"

string

file_path
required

File is the absolute path to the logging file.
Example : "/var/named/log/named.log"

string

id
optional

Id of the specified Log Channel.
Example : 21

integer(int32)

print_category
required

Controls whether the severity level is written to the output channel (true) or not (false).
Example : true

boolean

print_severity
required

Controls whether the severity level is written to the output channel (true) or not (false).
Example : true

boolean

print_time
required

Controls whether the date and time are written to the output channel (true) or not (false).
Example : true

boolean

severity
required

Controls the logging levels and takes the values defined (0(dynamic), 1(debug), 2(info), 3(notice), 4(warning), 5(error), 6(critical)).
Example : 1

integer(int32)

severity_text
required

String format of the severity value.
Example : "debug"

string

size
required

Size allows you to define a limit to the file size created.
Example : 1024000

integer(int32)

special_channel
required

This parameter is used to specify whether the channel is a special channel or user defined channel.
Example : false

boolean

type
required

Type of the specified Log Channel. Type can be 0(FILE), 1(SYSLOG), 2(STDERR), 3(NULL)
Example : 0

integer(int32)

type_string
required

String format of type for the specified Log Channel.
Example : "SYSLOG/FILE/STDERR/ NULL"

string

updated_by_name
required

User Name who has modified the specified Log Channel.
Example : "John"

string

updated_time
required

The time instance when the specified Log Channel has been modified.
Example : "03/18/2022 4:37"

string(date-time)

updated_time_string
required

String format of the time when the specified Access Control List has been modified.
Example : "03/18/2022 4:37"

string

versions
required

Versions takes the parameter 'number' and defines the number of file versions that should be kept by BIND.
Example : 6

integer(int32)

5.206. Logs Information

Encapsulates the live logs retrieved from a Remote DNS/DHCP Appliance in a format that can be loaded onto a data grid.

Name Description Schema

category
optional

Log category

string

classification
optional

Classification about the log.
Example : "This log gives classifications details. Example: Generic Protocol Command Decode"

string

description
optional

Description about the log.
Example : "This log gives lease details."

string

destinationIP
optional

DestinationIP about the log.
Example : "This log gives destination IP Address details."

string

destinationPort
optional

string

id
optional

Database Id of the log.
Example : "112"

string

leaseenddate
optional

DHCP lease end date

string

leasestartdate
optional

DHCP lease start date

string

logData
optional

Log information fetched from the server

string

macaddress
optional

Mac Address of leased DHCP server

string

priority
optional

Priority about the log.
Example : "This log gives priority details."

string

protocol
optional

Protocol about the log.
Example : "This log gives protocol details."

string

serverIP
optional

IP Address of remote appliance

string

severity
optional

Severity level of log

string

sourceIP
optional

SourceIP about the log.
Example : "This log gives source IP Address details."

string

sourcePort
optional

string

type
optional

Type of remote appliance

string

zoneName
optional

string

5.207. MAC Addresses Information

Represents the MAC Addresses and their descriptions that are blackholed/excluded from a given DHCP Appliance.

Name Description Schema

macAddress
optional

MAC Address to be blacklisted for a given DHCP Appliance

string

macDescription
optional

Reason/Description for the blacklisted mac address

string

5.208. MS DNS Logs Wrapper

This class represents Microsoft DNS Appliance logs in the TCPWave IPAM.

Name Description Schema

category
optional

string

date
optional

string

log
optional

string

seviarity
optional

string

type
optional

string

5.209. ManagedZonesInfo

Name Description Schema

addedAliasRRs
optional

< CloudRR > array

addedNormalRRs
optional

< CloudRR > array

arecs
optional

< string > array

deletedAliasRRs
optional

< CloudRR > array

deletedNormalRRs
optional

< Resource Record > array

5.210. Mask Length

For internal use only - Maps the mask length to the Mask Bits.

Type : object

5.211. Microsoft DHCP Exclusion range Information

Persists the attributes of DHCP Exclusion range such as start address, end address, subnet address, network address, organization, DHCP Appliance etc.

Name Description Schema

created_by_login_name
optional

Login name of the user who created the entity
Example : "twcadm"

string

created_time
optional

Date and Time of creation of the entity

string(date-time)

created_time_string
optional

String instance of the created time

string

description
optional

Description for the Exclusion range

string

dhcpServerAddress
required

Name of the DHCP Appliance
Example : "10.1.0.180"

string

organizationName
required

Name of the organization
Example : "Internal"

string

subnetAddress
required

Subnet Address of the network
Example : "10.1.0.0"

string

updated_by_login_name
optional

Login name of the user who updated the entity
Example : "twcadm"

string

updated_time
optional

Date and Time of update of the entity

string(date-time)

updated_time_string
optional

String instance of the updated time

string

5.212. Microsoft Server Information

Server bean class encapsulates the attributes of a generic windows server. This class represents the properties that are common to both windows DNS and DHCP Sever.

Name Description Schema

auto_sync_interval
optional

This value represents Auto sync interval of the Microsoft appliance. It accepts a value between 2 and 240.
Example : 10

integer(int32)

created_by
required

Id of the User who has created the specified Server.
Example : 2017

integer(int32)

created_by_name
optional

Name of the User who has created the specified Server.
Example : "Stephen"

string

created_time
optional

The time instance when the specified Server has been created.
Example : "03/18/2022 3:39"

string(date-time)

created_time_string
optional

String format of the time when the specified Server is created.
Example : "03/18/2022 3:39"

string

description
optional

Description for the Specified appliance.
Example : "DNS appliance added by the TCPWave IPAM by Professional Services."

string

domain_name
required

Name of the domain associated to the specified IP address
Example : "test.com"

string

folderName
optional

string

httpsEnabled
optional

This value represents if HTTPS connection is enabled to connect to the Microsoft appliance. It accepts either 1 or 0.
Example : 1

integer(int32)

id
optional

Id of the specified server.
Example : 121

integer(int32)

isAlive
optional

True/false describes the status of the specified appliance
Example : false

boolean

is_auto_sync_enabled
optional

This value represents if Auto sync is enabled on the Microsoft appliance. It accepts either yes or no.
Example : "yes"

string

newPassword
optional

New updated password
Example : "abc1234"

string

oldWindowsUserName
optional

string

old_server_ip
optional

Previous appliance IP Address
Example : "10.0.1.8"

string

organization_name
required

Name of the Organization which is associated to the specified Server.
Example : "EARTH"

string

password
required

Password for the Microsoft appliance
Example : "abc123"

string

read_write_option
optional

This value represents either Read or Read and Write operations can be performed on the Microsoft appliance. It accepts 0 or 1.
Example : 1

integer(int32)

server_ip
required

Address which is associated with the specified Server.
Example : "10.1.10.45"

string

server_name
required

Name of the specified Server.
Example : "WIND-est015-sl09113"

string

server_type
required

Type of the specified Server.
Example : "MSDHCP"

string

updated_by
required

Id of the User who has modified the specified Server.
Example : 1145

integer(int32)

updated_by_name
optional

Name of the User who has modified the specified Server.
Example : "John"

string

updated_time
optional

The time instance when the specified Server has been modified.
Example : "03/18/2022 4:37"

string(date-time)

updated_time_string
optional

String format of the time when the specified Server is modified.
Example : "03/18/2022 4:37"

string

windows_user_name
required

User name of the specified Server.
Example : "Administrator"

string

5.213. MicrosoftActiveUsers

Name Description Schema

domain
optional

string

firstSeen
optional

string

first_name
optional

string

fqdn
optional

string

ipAddr
optional

string

isAnomaly
optional

string

lastSeen
optional

string

lastUpdated
optional

string

last_name
optional

string

mac
optional

string

name
optional

string

userName
optional

string

whenChanged
optional

string

whenCreated
optional

string

5.214. Mirrored Zones

This class represents a Mirrored Zone and contains the attributes necessary for mirrored zone management functionality in the TCPWave IPAM. The information includes the Zone id,Organization id, Mirrored zone name and other Mirrored zone related information.

Name Description Schema

created_by_login_name
optional

Name of the user who created this mirrored zone

string

description
optional

Description of the mirrored zone
Example : "Description of Mirrored Zones."

string

id
optional

Database id of the mirrored zone
Example : 23

integer(int32)

mirror_name
optional

Name of the specified Mirrored Zone.
Example : "zone.com"

string

mirrored_zone_list
required

Comma separated list of Mirrored Zone names.
Example : "example.com,mirror.com"

string

old_description
optional

Description of the mirrored zone
Example : "This is the mirrored zone for the zone domain.com."

string

old_mirror_name
optional

Name of the mirrored zone.
Example : "zone.com"

string

org_id
optional

Database ID of the organization
Example : 12

integer(int32)

org_name
optional

Name of the organization
Example : "Org"

string

updated_by_login_name
optional

Name of the user who updated this mirrored zone

string

zone_id
required

Id of the specified Mirrored Zone.
Example : 10

integer(int32)

zone_name
optional

Name of the zone.
Example : "zone.com"

string

5.215. Module

This class represents status of the TCPWave IPAM sub components such as search server,CLI Engine, Database Engine, Discovery Engine, Monitoring Engine, Scheduler.

Name Description Schema

cli
required

CLI Engine status
Example : "ACTIVE"

integer(int32)

cli_S
required

CLI Engine status
Example : "ACTIVE"

string

database
required

Database Engine status
Example : "ACTIVE"

integer(int32)

database_S
required

DatabaseEngine status
Example : "ACTIVE"

string

dhcp
required

DHCP Appliance status
Example : "ACTIVE"

integer(int32)

dhcp_S
required

DHCP Appliance status
Example : "ACTIVE"

string

dns
required

DNS Appliance status
Example : "ACTIVE"

integer(int32)

dns_S
required

DNS Appliance status
Example : "ACTIVE"

string

ipam
required

IPAM server status
Example : "ACTIVE"

integer(int32)

ipam_S
required

IPAM server status
Example : "ACTIVE"

string

monitoringengine
required

Monitoring Engine status
Example : "ACTIVE"

integer(int32)

monitoringengine_S
required

Monitoring Engine status
Example : "ACTIVE"

string

scheduler
required

Scheduler status
Example : "ACTIVE"

integer(int32)

scheduler_S
required

Scheduler status
Example : "ACTIVE"

string

search
required

Search server status
Example : "ACTIVE"

integer(int32)

search_S
required

Search server status
Example : "ACTIVE"

string

5.216. Monitor Information

This class provides the service monitoring information. The information includes the host types and services that are being monitored

Name Description Schema

bindAuth
required

Enable monitoring on BIND Authoritative Servers
Example : "true/false"

string

bindCache
required

Enable monitoring on BIND Cache Servers
Example : "true/false"

string

category
optional

Category of the Monitoring Service
Example : "Appliance Components"

string

createdBy
optional

Database Id of a user who created the Monitoring Service.
Example : 1

integer(int32)

createdByName
optional

Name of the user who created the Monitoring Service.
Example : "User1"

string

createdTime
optional

Monitoring Service creation time.
Example : "06:57:00 03-10-2022"

string(date-time)

createdTimeString
optional

Created time of a Monitoring Service in String format.
Example : "06:57:00 03-01-2022"

string

created_by_login_name
optional

Login Name of a user who created a Monitoring Service.
Example : "admin"

string

criticalThresholdVal
required

Critical Threshold Value
Example : "70"

string

dhcp
required

Enable monitoring on DHCP Appliances
Example : "true/false"

string

disableAlertFromString
optional

Disable monitoring of the service from the specified time.
Example : "2022-02-13 12:00:00"

string

disableAlertToString
optional

Disable monitoring of the service till the specified time.
Example : "2022-02-13 12:00:00"

string

enableAlertAck
required

Enable Alert Acknowledgment, Should be specified as 1 or 0
Example : "1"

string

enableCritical
optional

Get Critical alerts flag, Should be specified 0 or 1
Example : "1"

string

enableFlapping
required

Enable Flapping, Should be specified as 1 or 0
Example : "1"

string

enableUnknown
optional

Get Unknown alerts flag, Should be specified 0 or 1
Example : "0"

string

enableWarning
optional

Get Warning alerts flag, Should be specified 0 or 1
Example : "1"

string

ipam
required

Enable monitoring on IPAM Servers
Example : "true/false"

string

nsdAuth
optional

If the value is 1, NSD service on authoritative appliance will be monitored.Otherwise, it will not be monitored.
Example : "1"

string

scheduledDownTime
optional

Scheduled down time of the monitoring service.
Example : "03/01/2022 12:00:00"

string(date-time)

serviceDescription
required

Description of each service
Example : "Monitor the % CPU of all host types"

string

serviceId
required

ID of this monitoring service
Example : 1

integer(int32)

serviceName
required

Monitoring service name which is being monitored by host groups
Example : "SYSTEM_CPU"

string

unboundCache
required

Enable monitoring on Unbound Cache Servers
Example : "true/false"

string

updatedBy
optional

Database Id of a user who updated the Monitoring Service last time.
Example : 1

integer(int32)

updatedByName
optional

Name of the user who updated the Monitoring Service last time.
Example : "User1"

string

updatedTime
optional

Last updated time of a Monitoring Service.
Example : "08:34:00 03-01-2022"

string(date-time)

updatedTimeString
optional

Updated time of a Monitoring Service in String format.
Example : "08:34:00 03-01-2022"

string

updated_by_login_name
optional

Login Name of a user who updated a Monitoring Service.
Example : "admin"

string

userScriptPath
optional

string

warningThresholdVal
required

Warning Threshold Value
Example : "50"

string

5.217. Monitored devices

Fetches the monitoring information of DNS/DHCP Appliances in the TCPWave IPAM

Name Description Schema

alerts
required

Get the current alerts for monitored device
Example : 5

integer(int32)

ip
required

Get monitored device IP address
Example : "172.31.11.23"

string

isAlive
required

Get the status of an appliance
Example : true

boolean

mservice
required

Get monitoring service
Example : "172.31.11.24"

string

name
required

Get monitored device name
Example : "nsuax"

string

threshold
required

Get the number of monitoring thresholds
Example : 35

integer(int32)

traps
required

Get the traps sent
Example : 5

integer(int32)

type
required

Get monitored device type
Example : "DHCP"

string

5.218. Monitoring Details

This class provides the alert information viz. Ok, Critical, Warning and Unknown for all the services monitored for a specific host types.

Type : object

5.219. Monitoring Service Information

Service encapsulates the attributes that pertain to a monitoring service such as the service name address, host address, host name, alert units, critical threshold, warning threshold of the monitoring service etc.

Name Description Schema

acknowledge_id
optional

Acknowledge ID

string

acknowledge_status
optional

Acknowledge Status
Example : "no"

string

acknowledge_time
optional

Acknowledge Time

string

acknowledged_by
optional

Acknowledge By

string

alertUnits
optional

Alerts Units

string

attempts
optional

Attempts to be performed

string

autoAck
optional

Auto Acknowledgment

string

category
optional

Notification Category
Example : "TOTAL_USED_RAM"

string

criticalThreshold
optional

Critical Threshold Value

string

data
optional

Data

string

end_time
optional

End Time
Example : "2022-01-20 12:40:41"

string

hostName
optional

Host Name
Example : "TCPWaveRemote"

string

host_address
required

Host Address
Example : "192.168.2.215"

string

host_type
required

Server Type
Example : "IPAMServerAlert"

string

ipv4
optional

IPv4 Address
Example : "192.168.2.215"

string

last_state_change
optional

Last State Change
Example : "1d 0h 44m 51s"

string

notification_id
optional

Notification ID

integer(int32)

notifyCriticalAlert
optional

Notify Critical Alerts

string

notifyFlappingService
optional

Notify Flapping Service

string

notifyOKAlert
optional

Notify Ok Alerts

string

notifyUnknownAlert
optional

Notify Unknown Alerts

string

notifyWarningAlert
optional

Notify Warning Alerts

string

serviceDownEndTime
optional

Service Down End Time

string

serviceDownStartTime
optional

Service Down Start Time

string

serviceEnable
optional

Enable Service

string

serviceName
required

Name of the service
Example : "TOTAL_USED_RAM"

string

start_time
optional

Start Time
Example : "2022-01-20 12:40:41"

string

triggerInterval
optional

Trigger Interval

string

v6_server_name
optional

IPv6 Sever name of the host
Example : "TCPWaveRemote"

string

v6_short_address
optional

IPv6 Address of the host
Example : "ff02::1"

string

warningThreshold
optional

Warning Threshold Value

string

5.220. MonitoringHierarchy

Name Description Schema

applianceIp
optional

string

applianceName
optional

string

applianceType
optional

string

commonConfigChecks
optional

integer(int32)

criticalAlerts
optional

integer(int32)

criticalConfigChecks
optional

integer(int32)

dhcpCriticalAlerts
optional

integer(int32)

dhcpCriticalConfigChecks
optional

integer(int32)

dhcpGroups
optional

string

dhcpHeartbeat
optional

boolean

dhcpId
optional

integer(int32)

dhcpOkAlerts
optional

integer(int32)

dhcpOkConfigChecks
optional

integer(int32)

dhcpWarningAlerts
optional

integer(int32)

dnsCriticalAlerts
optional

integer(int32)

dnsCriticalConfigChecks
optional

integer(int32)

dnsGroups
optional

string

dnsHeartbeat
optional

boolean

dnsId
optional

integer(int32)

dnsOkAlerts
optional

integer(int32)

dnsOkConfigChecks
optional

integer(int32)

dnsWarningAlerts
optional

integer(int32)

heartbeat
optional

boolean

okAlerts
optional

integer(int32)

okConfigChecks
optional

integer(int32)

warningAlerts
optional

integer(int32)

5.221. MonitoringUpdateRequest

Name Description Schema

ip
required

IPA Address of the specific resource
Example : "network"

string

monitor
optional

Monitoring status of the specific resource
Example : true

boolean

name
optional

Name of the specific resource
Example : "Network-1"

string

organization
optional

Organization of the specific resource
Example : "network"

string

stype
optional

Appliance type
Example : "DHCP"

string

type
required

Type of the specific resource
Example : "network"

string

5.222. MsgCert

Name Description Schema

cert_details
optional

string

cert_name
optional

string

cn
optional

string

errMsg
optional

string

id
optional

integer(int32)

info
optional

< string > array

issuer
optional

string

serial_number
optional

string

valid
optional

boolean

valid_from
optional

string

valid_to
optional

string

validity
optional

string

5.223. Multi IPv6 Subnet Request

This class encapsulates request information for creating multiple V6 Subnets.

Name Description Schema

address
optional

< string > array

ids
optional

< integer(int32) > array

ip_full_addr_val
optional

IPv6 subnet full address
Example : "1000:0000:0000:0000:0000:0000:0000:0000"

integer(int64)

mask_length
optional

IPv6 subnet mask length
Example : "/64"

integer(int32)

nw_mask_length
optional

IPv6 network mask length
Example : 48

integer(int32)

subnet
optional

IPv6 subnet

IPv6 Subnet

5.224. Multi Subnet Request

This class encapsulates request information for creating multiple V4 Subnets in the TCPWave IPAM.

Name Description Schema

address
required

Subnet address

< string > array

end_addr_val
required

Subnet end ip
Example : "10.0.0.254"

integer(int64)

mask_length
required

Subnet mask length
Example : 24

integer(int32)

start_addr_val
required

Subnet start IP
Example : "10.0.0.0"

integer(int64)

subnet
required

Subnet Information

Subnet Information

5.225. NICConfig

Name Description Schema

appliance
optional

Appliances
Example : "10.1.10.245,10.1.10.250"

string

nics
optional

NIC JSON string
Example : "[{'device':'eth0'},{'device':'eth1'}]"

string

syncStatus
optional

NIC Sync Status
Example : "0/1/2"

integer(int32)

5.226. NICObject

Type : object

5.227. Network Discovery Request

This class encapsulates the discovery preferences and network or subnet address of a discovery request.

Name Description Schema

address
required

Network or subnet address
Example : "10.0.0.0/24"

string

discoPrefs
required

Discovery methods
Example : "PING,SNMP"

string

organization
required

Name of the organization
Example : "Internal"

string

retries
required

SNMP request retries
Example : 2

integer(int32)

reverseDNSTimeout
required

Reverse DNS lookup timeout
Example : 2000

integer(int64)

timeout
required

SNMP response timeout
Example : 2000

integer(int64)

5.228. Network Information

Holds various attributes that are associated to a network such as the address, size, mask length etc.

Name Description Schema

addr1
required

Octet-1 of the network

integer(int32)

addr2
required

Octet-2 of the network

integer(int32)

addr3
required

Octet-3 of the network

integer(int32)

addr4
required

Octet-4 of the network

integer(int32)

address
required

Full address of the network

string

contact_email_id
optional

Email of the contact

string

contact_id
optional

ID of the contact

integer(int32)

contact_name
optional

Name of the contact

string

createRevZone
optional

Auto create reverse zone for a network
Example : "Yes/No"

string

created_by
optional

Login name of the user who created the network

integer(int32)

created_by_login_name
optional

Login name of the user who updated the entity

string

created_by_name
optional

Database ID of the user who created the entity

string

created_time
optional

Date and Time of creation of the entity

string(date-time)

created_time_string
optional

String instance of creating the entity

string

customTemplate
required

It specifies whether the template is custom defined or pre-defined
Example : false

boolean

description
optional

Description for the network

string

discoveryApplianceIp
optional

string

discoveryTemplateId
required

Id of the Discovery Template defined in the organization which is associated with the specified Network.
Example : 41010

integer(int32)

discovery_template
required

Name of the Discovery Template defined in the organization which is associated with the specified Network.
Example : "DiscoveryTemp1"

string

dmzVisible
optional

Specifies whether the zone which is associated with the Network is a Demilitarized Zone(DMZ) or not.
Example : "Yes/No"

string

dnssec_enable
required

Specifies whether Domain Name System Security Extensions(DNSSEC) enabled or not for the zone associated with the specified Network.
Example : "Yes/No"

string

email_check
optional

Email to send out the network capacity/usage information

integer(int32)

email_id
optional

Email ID
Example : "[email protected]"

string

enable_discovery
required

Specifies whether discovery is enabled or not for the specified Network.
Example : "Yes/No"

string

extensions
optional

Login name of the user who created the entity

< Xtn NVP > array

first_name
optional

First name of the contact

string

id
optional

Database ID of the network

integer(int32)

last_name
optional

Last name of the contact

string

mask_length
required

Network mask length

integer(int32)

middle_name
optional

Middle name of the contact

string

monitoringService
optional

string

name
required

Name of the network

string

network_usage
optional

Percentage usage of a given network

string

nsec_option
required

Takes NSEC or NSEC3 when Domain Name System Security Extensions(DNSSEC) is enabled for the zone which is associated with the specific Network.
Example : "NSEC/NSEC3"

string

nw_mask_length
required

Mask length of the network

integer(int32)

object_count
optional

Number of objects defined in this network

integer(int32)

oldName
required

Old name of the network

string

organization_id
required

Organization ID of the network

integer(int32)

organization_name
required

Organization name of the network

string

percent_full
optional

Threshold percentage full for the network

number(double)

percentageFull
optional

Percentage full for the given network

integer(int32)

region
optional

string

reverse_zone
optional

Reverse Zone for the given network

string

reverse_zone_serial
required

Serial Number of the Reverse Zone which is associated with the specified Network.
Example : 2016102800

integer(int32)

selectedMasterServer
required

List of Master Servers defined in Zone Templates associated with the specified Network.

< Server Information > array

selectedSlaveServer
required

List of Slave Servers defined in Zone Templates associated with the specified Network.

< Server Information > array

serialFormat
required

Serial Number format of the zone which is associated with the specified Network.
Example : "NODATE/DATE"

string

server_count
optional

Number of servers provisioned in the network

integer(int32)

server_id
required

Id of the server which is associated with the specified Network.
Example : 121

integer(int32)

server_name
required

Name of the server which is associated with the specified Network.
Example : "lisartx-est015-sl012"

string

snmp_check
optional

SNMP to send out the network capacity/usage information

integer(int32)

startAddress
optional

Network Start Address

string

subnet_count
optional

Number of subnets defined in the network

integer(int32)

templateList
required

Array list of Zone Templates associated with the specified Network

< Template > array

updated_by
optional

Login name of the user who updated the network

integer(int32)

updated_by_login_name
optional

Login name of the user who created the entity

string

updated_by_name
optional

Database ID of the user who updated the entity

string

updated_time
optional

Date and time of updating the entity

string(date-time)

updated_time_string
optional

String instance of updating the entity

string

vrf_id
optional

integer(int32)

vrf_name
optional

string

zoneTemplateId
required

Id of the Zone Template defined in the zone which is associated with the specified Network.
Example : 41010

integer(int32)

zoneTemplateName
required

Name of the Zone Template defined in the zone which is associated with the specified Network.
Example : "ZoneTemp1"

string

5.229. Network Interface

This class consolidates the details of a Network Interface configuration file.

Name Description Schema

bond_mode
optional

Bonding mode of network interfaces bond i.e. Mode 1 (active-backup policy)

string

broadCast
required

Network broadcast of network interface
Example : "192.168.0.255"

string

gateway
required

Network gateway of network interface
Example : "192.168.0.1"

string

ipv4Addr
required

IPv4 address of network interface
Example : "192.168.0.105"

string

ipv6Addr
optional

IPv6 address of network interface
Example : "2000::2"

string

ipv6DefaultGw
optional

IPv6 network gateway of network interface
Example : "2000::1"

string

ipv6Init
optional

IPv6 address of network interface
Example : "fe80::a00:27ff:fecd:c5de"

string

isMgmtInterface
optional

Network interface is management interface or not.
Example : false

boolean

master
optional

Master bond Name
Example : "bond0"

string

netMask
required

Netmask of network interface
Example : "255.255.255.0"

string

nicBootproto
optional

It is an attribute of Network Interface Configuration file.
Example : "none"

string

nicDevice
required

Name of network interface
Example : "eth0"

string

nicHwaddr
optional

MAC Address
Example : "08:00:27:cd:c5:de"

string

nicJSON
optional

JSON string of network interfaces

string

nicNM_controlled
optional

It is only for bond interface.
Example : "none"

string

nicNetwork
required

Network IP of network interface
Example : "192.168.0.0"

string

nicOnboot
optional

It is a bond interface or not
Example : "yes/no"

string

nicType
required

Name of network interface type
Example : "Ethernet"

string

route
optional

Routes for Network Interface

string

rule
optional

Rules for Network Interface

string

serverIP
required

Remote IP Address
Example : "192.168.0.105"

string

serverName
required

Remote Name
Example : "remote-1"

string

serverType
required

Server Type Code
Example : "BIND AUTH"

string

slave
optional

It is slave device or not
Example : "yes/no"

string

5.230. Network Security Monitoring Template

This class represents a NSM template that can be used to configure Threat Intelligence settings for DNS appliances.

Name Description Schema

configuration
optional

JSON format of NSM Template configuration parameters: Interface, Enable Anomaly Detection, Enable Tunnel Detection, Enable Intrusion Prevention, etc.

string

createdBy
optional

UserId of user who created the specific NSM template.
Example : 1234

integer(int32)

createdByUser
optional

Name of user who created the specific NSM template.
Example : "admin"

string

createdTime
optional

NSM template creation time.
Example : "03/04/2022 4:37"

string(date-time)

description
optional

Description of NSM template.

string

domainList
optional

ArrayList of NSM domains associated to NSM template.

< Whitelist and Blacklist domain > array

id
optional

Id of the NSM template.
Example : 1

integer(int32)

ipsRuleList
optional

ArrayList of IPS rules associated to NSM template.

< Intrusion Provision System Rule > array

ipsRuleVariables
optional

JSON format of IPS rule variables.

string

name
required

Name of the NSM template.
Example : "nsm_template_1"

string

oldName
required

Old name of the NSM template.
Example : "test_template"

string

organizationId
optional

Id of an organization to which the specified NSM template is associated with.
Example : 1

integer(int32)

organizationName
required

Name of an organization to which the specified NSM template is associated with.
Example : "Internal"

string

tunnelDetectionRules
optional

JSON format of tunnel detection rule parameters.

string

updatedBy
optional

UserId of user who updated the specific NSM template.
Example : 1234

integer(int32)

updatedByUser
optional

Name of user who updated the specific NSM template.
Example : "admin"

string

updatedTime
optional

NSM template updated time.
Example : "03/05/2022 4:37"

string(date-time)

5.231. Network Stats

This bean encapsulates the statistics related to a Network. The information includes the percentages values of address space that is free, address space occupied by static, manual, auto, and dynamic objects, and the list of top ten subnets in the network by size.

Name Description Schema

auto_percent
optional

Percentage of the DHCP-Auto objects usage
Example : 20.0

number(double)

dynamic_percent
optional

Percentage of the DHCP-Dynamic objects usage
Example : 20.0

number(double)

free_percent
optional

Percentage of the network that is usable
Example : 20.0

number(double)

manual_percent
optional

Percentage of the DHCP-Manual objects usage
Example : 20.0

number(double)

static_percent
optional

Percentage of the static objects usage
Example : 20.0

number(double)

top_ten
optional

List of the top ten subnets

< Top Ten Element > array

5.232. NetworkBlock

Name Description Schema

endIP
optional

integer(int64)

fullAddress
optional

string

mask
optional

integer(int32)

startIP
optional

integer(int64)

5.233. NonManagedNameServer

Name Description Schema

id
optional

Non-Managed Name Server id

integer(int32)

is_tsig
optional

Non-Managed Name Server is secured with TSIG key or not
Example : 0

integer(int32)

ns_fqdn
optional

Non-Managed Name Server FQDN
Example : "nameserver.domain.com"

string

ns_ip
optional

Non-Managed Name Server IP Address
Example : "10.1.10.12"

string

zone_id
optional

Zone id

integer(int32)

5.234. Notification Details

Notifications class gives the information about an IPAM notification such as Host Address, Host Type, Category, Service, Start Time, End Time etc.

Name Description Schema

host_address
optional

Address of the Host for which notification is generated
Example : "196.168.10.101"

string

host_name
optional

Name of the host for which notification is generated
Example : "dhcp-appliance-2.test.com. "

string

host_type
optional

Type of the host for which notification is generated
Example : "DHCP"

string

output
optional

Notification Message
Example : "CRITICAL - Secure communication between the IPAM and the remote appliance is not functional. "

string

start_time
optional

Start time at which notification is generated
Example : "3/15/2022 10:29:03"

string

status
optional

Severity Code of the notification. Codes 0, 1 and 2 represent OK, WARNING and CRITICAL respectively
Example : 0

integer(int32)

5.235. OFAC Country

This class represents OFAC country and contains the attributes necessary for Export Compliance Management functionality in TCPWave IPAM. The information includes the Country Name, ccTLDs, and other OFAC related information.

Name Description Schema

cctld
optional

CcTld of a country
Example : "nk"

string

contact_email
optional

User’s email ID who has modified the specified OFAC record.
Example : "[email protected]"

string

countryname
optional

Country Name
Example : "North Korea"

string

created_by
optional

User ID who has created the specified OFAC record.
Example : 1234

integer(int32)

created_by_login_name
optional

The User’s name, who has logged into TCPWave IPAM, has been set as Created By for the specified Domain.
Example : "Stephen"

string

created_by_name
optional

User Name who has created the specified OFAC record.
Example : "John"

string

created_time
optional

The time instance when the specified OFAC record has been created.
Example : "2022-02-04 05:24:00"

string(date-time)

created_time_string
optional

String format of the time when the specified Domain has been created.
Example : "03/18/2022 3:39"

string

description
optional

Description
Example : "This is for OFAC Report"

string

firstName
optional

User’s first name who has modified the specified OFAC record.
Example : "John"

string

lastName
optional

User’s last name who has modified the specified OFAC record.
Example : "Smith"

string

updated_by
optional

User ID who has modified the specified OFAC record.
Example : 1234

integer(int32)

updated_by_login_name
optional

The User’s name, who has logged into TCPWave IPAM, has been set as Created By for the specified Domain.
Example : "John"

string

updated_by_name
optional

User name who has modified the specified OFAC record.
Example : "John"

string

updated_time
optional

The time instance when the specified OFAC record has been updated.
Example : "2022-02-04 05:24:00"

string(date-time)

updated_time_string
optional

String format of the time when the specified Domain has been modified.
Example : "03/18/2022 4:37"

string

5.236. OSPF Details

This class contains information related to OSPF screen.

Name Description Schema

areas
optional

List of areas

< OSPF Details > array

delay
optional

Delay Time in seconds
Example : 60

integer(int32)

graceful_restart
optional

Is graceful restart enabled or not?
Example : false

boolean

holdTime
optional

Hold time value in seconds. It ranges 1 to 65535 seconds
Example : 60

integer(int32)

hostName
optional

Host name
Example : "Host-IPAM"

string

log_adjacency_changes
optional

Log adjacency changes detail
Example : false

boolean

logging
optional

Is logging is enabled or not?
Example : false

boolean

ospfInterfaces
optional

List of OSPF Interfaces

< OSPF Details > array

redistribute_connected
optional

Is redistribute connected or not?
Example : false

boolean

rfc_compatible
optional

Is RFC service compatible or not?
Example : false

boolean

routerAddress
optional

IP address of the router
Example : "192.168.0.1"

string

5.237. OSPatch

This class represents an OS Patch and contains the attributes necessary for OS Patch management functionality in TCPWave IPAM. The information includes the Patch Name, Patch Type, Patch Size, Patch Checksum and Patch Folder Path and other related information.

Name Description Schema

creadtedTime
optional

The time instance when the patch has been created.
Example : "2022-02-04 05:24:00"

string(date-time)

createBy
required

Database ID of the user who created the patch.
Example : 2862

integer(int32)

createdByName
required

Name of the user who created the patch.
Example : "Smith"

string

createdTimeString
required

Patch creation time.
Example : "03/18/2022 4:37"

string

id
optional

Database Id of the patch
Example : 1252

integer(int32)

patchChecksum
optional

Patch checksum value
Example : 1

integer(int32)

patchFolderPath
optional

Patch folder location
Example : "/tmp/patches"

string

patchLevel
optional

string

patchName
optional

Patch name
Example : "DB_patch1"

string

patchSize
optional

Patch size
Example : 1000

integer(int64)

patchType
optional

Patch type
Example : "dellhardware"

string

patchVersion
optional

string

5.238. OSPatchStatus

Name Description Schema

applianceID
optional

integer(int32)

applianceName
optional

string

applianceType
optional

string

exitCode
optional

string

ipAddress
optional

string

lastAppliedTime
optional

string

message
optional

string

5.239. Object Allocation

This class represents Object allocation count of different types of Objects like Static, DHCP etc. in TCPWave IPAM.

Name Description Schema

auto_dhcp
required

Get auto DHCP object count.
Example : 600

integer(int64)

ddhcp_count
required

Get dynamic DHCP object count
Example : 6

integer(int64)

mdhcp_count
required

Get DHCP device name
Example : "nsuax"

integer(int64)

static_count
required

Get static object count
Example : 4

integer(int64)

total
required

Get total object count
Example : 300

integer(int64)

unalloc_count
required

Get unallocated object count
Example : 100

integer(int64)

5.240. Object Basic Information

This class represents the properties of object.

Name Description Schema

change_control_ticket
optional

Details of the change control team
Example : "324554"

string

class_code
required

Object type/Class code of the object
Example : "3G Phone"

string

contact_email_id
optional

Email address of the contact

string

contact_first_name
optional

First name of the contact
Example : "3G-Phone-0002"

string

contact_id
optional

Database ID of the contact
Example : 11

integer(int32)

contact_last_name
optional

Last name of the contact

string

contact_middle_name
optional

Middle name of the contact

string

domain_id
required

Database ID of the domain associated to this object
Example : 990

integer(int32)

domain_name
required

Name of the domain associated to this object
Example : "tcp.com"

string

dyn_update_rrs_a
required

Dynamic update DNS with A Resource Records
Example : false

boolean

dyn_update_rrs_cname
required

Dynamic update DNS with CNAME Resource Records
Example : false

boolean

dyn_update_rrs_mx
required

Dynamic update DNS with MX Resource Records
Example : false

boolean

dyn_update_rrs_ptr
required

Dynamic update DNS with PTR Resource Records
Example : true

boolean

enable_dynamic_dns_options
optional

Enable the Dynamic dns options
Example : false

boolean

floor
optional

Floor (placement) of this object

string

managed_by
optional

Name of user who manages this object
Example : "admin"

string

monitored_by
optional

Name of the user who monitors this object
Example : "admin"

string

objectKeyList
optional

List of Object Keys (ID and Address)

< ObjectKey > array

organization_id
optional

Database ID of the organization
Example : 2357

integer(int32)

organization_name
required

Name of the organization associated with this object
Example : "QAOrg"

string

room
optional

Room (placement) of this object

string

subnet_id
required

Database ID of the subnet associated to this object
Example : 1

integer(int32)

terminal_server_kvm
optional

Terminal Server for this object

string

ttl
optional

Time to live for this object
Example : 1200

integer(int32)

update_ns_a
required

Dynamic update DNS with the A rec
Example : false

boolean

update_ns_ptr
required

Dynamic update DNS with PTR rec
Example : false

boolean

updated_by
optional

Name of the user who has updated this object
Example : "admin"

integer(int32)

5.241. Object Chart

This class contains object added/deleted information.

Name Description Schema

count
optional

Count of object
Example : 10

integer(int32)

date
optional

Get Date
Example : "3/18/2022"

string

day_count
optional

Day count
Example : 3

integer(int32)

dynamic_objects_added
optional

Total dynamic objects added

integer(int32)

dynamic_objects_deleted
optional

Total dynamic objects deleted

integer(int32)

static_objects_added
optional

Total static objects added

integer(int32)

static_objects_deleted
optional

Total static objects deleted

integer(int32)

total_objects_added
optional

Total number of objects added

integer(int32)

total_objects_deleted
optional

Total number of objects deleted

integer(int32)

5.242. Object DHCP Details

Persists the DHCP Profile - Option Template and the DHCP Appliance for a given object.

Name Description Schema

allow_client_class
required

Allow client class name

< string > array

allow_user_class
required

Allow user class name

< string > array

allow_vendor_class
required

Allow vendor class name

< string > array

deny_client_class
required

Deny client class name

< string > array

deny_user_class
required

Deny user class name

< string > array

deny_vendor_class
required

Deny vendor class name

< string > array

server_name
optional

DHCP Appliance of a DHCP Object - Internal use only

string

template_name
optional

DHCP Option Template of a DHCP Object - Internal use only

string

5.243. Object Discovery Data

This class represents the object discovery data which include switch name, switch port, port duplex and object address.

Name Description Schema

objectAddress
required

Object address
Example : "10.0.0.0"

string

objectId
required

Database ID of Object
Example : 101

integer(int32)

organization
required

Organization name
Example : "Internal"

string

portDuplex
required

Port duplex
Example : "Full/10Mbps"

string

switchName
required

Switch Name
Example : "Switch001"

string

switchPort
required

Switch port
Example : "Eth1"

string

5.244. Object Type Chart

This class fetches the number of object types defined in the TCPWave IPAM

Name Description Schema

parameter
required

Get type of object
Example : "4"

string

value
required

Get the object count
Example : "4"

string

5.245. ObjectKey

Name Description Schema

id
optional

Database ID the object

integer(int32)

5.246. Organization

This class contains organization information. The information includes the organization name, DNS root zone enable flag and created/updated information.

Name Description Schema

auth_info
required

Information about the organization.

Auth Info

description
required

Description of the organization.
Example : "Internal organization"

string

enable_root_zone
required

Indicate root zone is enabled or not. 1 indicates root zone is enabled and 0 indicate that root zone is disabled.
Example : 1

integer(int32)

id
optional

ID of the organization.
Example : 1

integer(int32)

name
required

Name of the organization.
Example : "Internal"

string

oldName
required

Old Name of the organization.
Example : "Test"

string

5.247. PagedList

Name Description Schema

data
optional

Rows List

< object > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.248. PagedListAccess Control List(ACL)

Name Description Schema

data
optional

Rows List

< Access Control List(ACL) > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.249. PagedListAdmin Group

Name Description Schema

data
optional

Rows List

< Admin Group > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.250. PagedListAudit Report Details

Name Description Schema

data
optional

Rows List

< Audit Report Details > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.251. PagedListContacts Information

Name Description Schema

data
optional

Rows List

< Contacts Information > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.252. PagedListDHCP Failover

Name Description Schema

data
optional

Rows List

< DHCP Failover > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.253. PagedListDHCPLeaseObject

Name Description Schema

data
optional

Rows List

< DHCPLeaseObject > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.254. PagedListDNS Appliance Template

Name Description Schema

data
optional

Rows List

< DNS Appliance Template > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.255. PagedListDomain

Name Description Schema

data
optional

Rows List

< Domain > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.256. PagedListExternal DNS Zone

Name Description Schema

data
optional

Rows List

< External DNS Zone > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.257. PagedListHome

Name Description Schema

data
optional

Rows List

< Home > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.258. PagedListIPv6 Network Details

Name Description Schema

data
optional

Rows List

< IPv6 Network Details > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.259. PagedListIPv6 Subnet

Name Description Schema

data
optional

Rows List

< IPv6 Subnet > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.260. PagedListLocations

Name Description Schema

data
optional

Rows List

< Locations > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.261. PagedListLogger Channel

Name Description Schema

data
optional

Rows List

< Logger Channel > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.262. PagedListMicrosoft DHCP Exclusion Range Information

Name Description Schema

data
optional

Rows List

< Microsoft DHCP Exclusion range Information > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.263. PagedListMicrosoft Server Information

Name Description Schema

data
optional

Rows List

< Microsoft Server Information > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.264. PagedListNetwork Information

Name Description Schema

data
optional

Rows List

< Network Information > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.265. PagedListNetwork Security Monitoring Template

Name Description Schema

data
optional

Rows List

< Network Security Monitoring Template > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.266. PagedListObject

Name Description Schema

data
optional

Rows List

< object > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.267. PagedListOrganization

Name Description Schema

data
optional

Rows List

< Organization > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.268. PagedListParameters Information

Name Description Schema

data
optional

Rows List

< Parameters Information > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.269. PagedListResource Record

Name Description Schema

data
optional

Rows List

< Resource Record > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.270. PagedListResponse Policy Zone(RPZ) Rule File

Name Description Schema

data
optional

Rows List

< Response Policy Zone(RPZ) Rule File > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.271. PagedListSOA

Name Description Schema

data
optional

Rows List

< SOA > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.272. PagedListScheduled Job Execution Status Information

Name Description Schema

data
optional

Rows List

< Scheduled job execution status information > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.273. PagedListScope Information

Name Description Schema

data
optional

Rows List

< Scope Information > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.274. PagedListServer Entity Version

Name Description Schema

data
optional

Rows List

< Server Entity Version > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.275. PagedListServer Information

Name Description Schema

data
optional

Rows List

< Server Information > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.276. PagedListSubnet Group

Name Description Schema

data
optional

Rows List

< Subnet Group > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.277. PagedListSubnet Information

Name Description Schema

data
optional

Rows List

< Subnet Information > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.278. PagedListTIMS Object

Name Description Schema

data
optional

Rows List

< TIMS Object > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.279. PagedListTemplate

Name Description Schema

data
optional

Rows List

< Template > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.280. PagedListTemplate Selection Data

Name Description Schema

data
optional

Rows List

< Template Selection Data > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.281. PagedListUser

Name Description Schema

data
optional

Rows List

< User > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.282. PagedListZone

Name Description Schema

data
optional

Rows List

< Zone > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

total
optional

Total Number of rows.
Example : 20

integer(int32)

5.283. PagedList_d

Name Description Schema

data
optional

< object > array

draw
optional

integer(int32)

recordsFiltered
optional

integer(int32)

recordsTotal
optional

integer(int32)

5.284. PagedList_dIPv6 Network Details

Name Description Schema

data
optional

< IPv6 Network Details > array

draw
optional

integer(int32)

recordsFiltered
optional

integer(int32)

recordsTotal
optional

integer(int32)

5.285. PaginatedList

Name Description Schema

data
optional

Rows List

< object > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.286. PaginatedListAdministratorRoles

Name Description Schema

data
optional

Rows List

< AdministratorRoles > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.287. PaginatedListAlarm Subscription

Name Description Schema

data
optional

Rows List

< Alarm Subscription > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.288. PaginatedListAmazon Machine Image

Name Description Schema

data
optional

Rows List

< Amazon Machine Image > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.289. PaginatedListAppliance Group

Name Description Schema

data
optional

Rows List

< Appliance Group > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.290. PaginatedListAudit Entry

Name Description Schema

data
optional

Rows List

< Audit Entry > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.291. PaginatedListAudit Log Entry In CEF Format

Name Description Schema

data
optional

Rows List

< Audit Log Entry in CEF Format > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.292. PaginatedListAudit Report Details

Name Description Schema

data
optional

Rows List

< Audit Report Details > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.293. PaginatedListAuditHistory

Name Description Schema

data
optional

Rows List

< AuditHistory > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.294. PaginatedListAutonomous System Number

Name Description Schema

data
optional

Rows List

< Autonomous System Number > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.295. PaginatedListCloud Hosted Subnet

Name Description Schema

data
optional

Rows List

< Cloud Hosted Subnet > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.296. PaginatedListCloud Instance Template

Name Description Schema

data
optional

Rows List

< Cloud Instance Template > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.297. PaginatedListCloudResourceWrapper

Name Description Schema

data
optional

Rows List

< CloudResourceWrapper > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.298. PaginatedListComponent

Name Description Schema

data
optional

Rows List

< Component > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.299. PaginatedListContacts Information

Name Description Schema

data
optional

Rows List

< Contacts Information > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.300. PaginatedListDHCP Appliance Statistics Details

Name Description Schema

data
optional

Rows List

< DHCP Appliance Statistics Details > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.301. PaginatedListDNS Appliance Statistics Details

Name Description Schema

data
optional

Rows List

< DNS Appliance Statistics Details > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.302. PaginatedListDNS Cloud Provider

Name Description Schema

data
optional

Rows List

< DNS Cloud Provider > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.303. PaginatedListDNS TSIG (Transaction Signatures) Keys

Name Description Schema

data
optional

Rows List

< DNS TSIG (Transaction Signatures) Keys > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.304. PaginatedListDevice Details

Name Description Schema

data
optional

Rows List

< Device Details > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.305. PaginatedListDiscovery Exclusions

Name Description Schema

data
optional

Rows List

< Discovery Exclusions > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.306. PaginatedListDiscovery Template

Name Description Schema

data
optional

Rows List

< Discovery Template > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.307. PaginatedListDiscoveryEvents

Name Description Schema

data
optional

Rows List

< DiscoveryEvents > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.308. PaginatedListDiscoveryRouters

Name Description Schema

data
optional

Rows List

< DiscoveryRouters > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.309. PaginatedListDomain

Name Description Schema

data
optional

Rows List

< Domain > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.310. PaginatedListExternal DNS Master

Name Description Schema

data
optional

Rows List

< External DNS Master > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.311. PaginatedListExternal DNS Zone

Name Description Schema

data
optional

Rows List

< External DNS Zone > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.312. PaginatedListFile Set

Name Description Schema

data
optional

Rows List

< File Set > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.313. PaginatedListFirewall Element Details

Name Description Schema

data
optional

Rows List

< Firewall Element Details > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.314. PaginatedListFirewall Interface

Name Description Schema

data
optional

Rows List

< Firewall Interface > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.315. PaginatedListFirewall NAT Pool Details

Name Description Schema

data
optional

Rows List

< Firewall NAT Pool Details > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.316. PaginatedListFirewall Neighbor

Name Description Schema

data
optional

Rows List

< Firewall Neighbor > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.317. PaginatedListFirewall Subnet

Name Description Schema

data
optional

Rows List

< Firewall Subnet > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.318. PaginatedListFirewallSubnetElement

Name Description Schema

data
optional

Rows List

< FirewallSubnetElement > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.319. PaginatedListForwardersCategory

Name Description Schema

data
optional

Rows List

< ForwardersCategory > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.320. PaginatedListFunction

Name Description Schema

data
optional

Rows List

< Function > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.321. PaginatedListFunctions

Name Description Schema

data
optional

Rows List

< Functions > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.322. PaginatedListHome

Name Description Schema

data
optional

Rows List

< Home > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.323. PaginatedListHome Scopes

Name Description Schema

data
optional

Rows List

< Home Scopes > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.324. PaginatedListIPAMAppliance

Name Description Schema

data
optional

Rows List

< IPAMAppliance > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.325. PaginatedListIPV6 Scope

Name Description Schema

data
optional

Rows List

< IPV6 Scope > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.326. PaginatedListIPv6 Network Details

Name Description Schema

data
optional

Rows List

< IPv6 Network Details > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.327. PaginatedListIPv6 Object

Name Description Schema

data
optional

Rows List

< IPv6 object > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.328. PaginatedListIPv6 Subnet

Name Description Schema

data
optional

Rows List

< IPv6 Subnet > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.329. PaginatedListIntrusion Provision System Rule

Name Description Schema

data
optional

Rows List

< Intrusion Provision System Rule > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.330. PaginatedListLog

Name Description Schema

data
optional

Rows List

< Log > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.331. PaginatedListLogs Information

Name Description Schema

data
optional

Rows List

< Logs Information > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.332. PaginatedListMicrosoft Server Information

Name Description Schema

data
optional

Rows List

< Microsoft Server Information > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.333. PaginatedListMirrored Zones

Name Description Schema

data
optional

Rows List

< Mirrored Zones > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.334. PaginatedListMonitor Information

Name Description Schema

data
optional

Rows List

< Monitor Information > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.335. PaginatedListMonitored Devices

Name Description Schema

data
optional

Rows List

< Monitored devices > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.336. PaginatedListMonitoring Service Information

Name Description Schema

data
optional

Rows List

< Monitoring Service Information > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.337. PaginatedListNetwork Information

Name Description Schema

data
optional

Rows List

< Network Information > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.338. PaginatedListNetwork Security Monitoring Template

Name Description Schema

data
optional

Rows List

< Network Security Monitoring Template > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.339. PaginatedListNotification Details

Name Description Schema

data
optional

Rows List

< Notification Details > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.340. PaginatedListPayload For Approval Workflows.

Name Description Schema

data
optional

Rows List

< Payload for Approval Workflows. > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.341. PaginatedListPermission

Name Description Schema

data
optional

Rows List

< Permission > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.342. PaginatedListPolicy Compliance Entity

Name Description Schema

data
optional

Rows List

< Policy Compliance Entity > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.343. PaginatedListPort Details

Name Description Schema

data
optional

Rows List

< Port Details > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.344. PaginatedListResource Record

Name Description Schema

data
optional

Rows List

< Resource Record > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.345. PaginatedListRouter Element Details

Name Description Schema

data
optional

Rows List

< Router Element Details > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.346. PaginatedListRouter Interface

Name Description Schema

data
optional

Rows List

< Router Interface > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.347. PaginatedListRouter Neighbor

Name Description Schema

data
optional

Rows List

< Router Neighbor > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.348. PaginatedListRouter Subnet

Name Description Schema

data
optional

Rows List

< Router Subnet > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.349. PaginatedListRouterSubnetElement

Name Description Schema

data
optional

Rows List

< RouterSubnetElement > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.350. PaginatedListSecurity Group

Name Description Schema

data
optional

Rows List

< Security Group > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.351. PaginatedListServer Information

Name Description Schema

data
optional

Rows List

< Server Information > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.352. PaginatedListSubnet Elements

Name Description Schema

data
optional

Rows List

< Subnet Elements > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.353. PaginatedListSubnet Information

Name Description Schema

data
optional

Rows List

< Subnet Information > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.354. PaginatedListSubnet Template

Name Description Schema

data
optional

Rows List

< Subnet Template > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.355. PaginatedListSwitch Details

Name Description Schema

data
optional

Rows List

< Switch Details > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.356. PaginatedListSwitch Element Details

Name Description Schema

data
optional

Rows List

< Switch Element Details > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.357. PaginatedListSwitch Neighbor

Name Description Schema

data
optional

Rows List

< Switch Neighbor > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.358. PaginatedListSwitch VLAN Subnet Element Details

Name Description Schema

data
optional

Rows List

< Switch VLAN Subnet Element Details > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.359. PaginatedListTIMS Object

Name Description Schema

data
optional

Rows List

< TIMS Object > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.360. PaginatedListTemplate

Name Description Schema

data
optional

Rows List

< Template > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.361. PaginatedListUndo Data

Name Description Schema

data
optional

Rows List

< Undo Data > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.362. PaginatedListUser

Name Description Schema

data
optional

Rows List

< User > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.363. PaginatedListV6IPAMAppliance

Name Description Schema

data
optional

Rows List

< V6IPAMAppliance > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.364. PaginatedListVMWare Discovery Element Details

Name Description Schema

data
optional

Rows List

< VMWare Discovery Element Details > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.365. PaginatedListVRF

Name Description Schema

data
optional

Rows List

< VRF > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.366. PaginatedListVlan Details

Name Description Schema

data
optional

Rows List

< Vlan Details > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.367. PaginatedListVlan Subnet Details

Name Description Schema

data
optional

Rows List

< Vlan Subnet Details > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.368. PaginatedListWhitelist And Blacklist Domain

Name Description Schema

data
optional

Rows List

< Whitelist and Blacklist domain > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.369. PaginatedListXtnResponse

Name Description Schema

data
optional

Rows List

< XtnResponse > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.370. PaginatedListZone

Name Description Schema

data
optional

Rows List

< Zone > array

recordsFiltered
optional

Total number of rows fetched based on filter.
Example : 40

integer(int32)

recordsTotal
optional

Total number of rows.
Example : 40

integer(int32)

5.371. Parameters Information

Persists the attributes of various DNS and DHCP Configuration parameters - such as their actual name, Configuration name, Option number in case of DHCP, Data type, the value for the Parameter etc.

Name Description Schema

array_params
optional

Collection of DNS/DHCP Params

< Parameters Information > array

config_name
required

Name of the parameter as in the DNS/DHCP Configuration Files

string

created_by
required

Id of the User who has created the specified Parameter.

integer(int32)

created_by_login_name
optional

The User’s name, who has logged into TCPWave IPAM, has been set as Created By for the specified Parameter.

string

created_by_name
optional

Name of the User who has created the specified Parameter.

string

created_time
optional

The time instance when the specified Resource Record has been created.

string(date-time)

created_time_string
optional

String format of the time when the specified Parameter has been created.
Example : "03/18/2022 3:37"

string

data_type
optional

Data type of the specified Parameter.

string

display_name
optional

Display name of a parameter

string

entity_type_code
required

Code for the entity type

string

entity_type_id
optional

Database ID of the entity type

integer(int32)

group_name
required

Category of a parameter

string

id
optional

Id of the specified Parameter.

string

mandatory
optional

Defines if the Parameter is mandatory or not.

string

max_value
optional

Maximum value of the specified Parameter.

integer(int32)

min_value
optional

Minimum value of the specified Parameter.

integer(int32)

name
optional

Name of the specified Parameter.

string

old_group_name
optional

DHCP custom folder previous name.
Example : "DGroup1"

string

server_type_code
required

Code for the server type

string

subOption
optional

Create the sub option
Example : true

boolean

updated_by
required

Id of the User who has modified the specified Parameter.

integer(int32)

updated_by_login_name
optional

The User’s name, who has logged into TCPWave IPAM, has been set as Created By for the specified Parameter.

string

updated_by_name
optional

Name of the User who has modified the specified Parameter.

string

updated_time
optional

The time instance when the specified Resource Record has been modified.

string(date-time)

updated_time_string
optional

String format of the time when the specified Parameter has been modified.
Example : "03/18/2022 3:37"

string

user_defined
required

Boolean to check if a parameter is user defined or not

string

value
optional

Value of the specified Parameter.

string

5.372. Patch deployment details in a Server.

This class contains the patch deployment information in a server. It contains the details of sever address, server name, patch name, level, status, description, package version, status, description.

Name Description Schema

componentCode
optional

string

created_by
optional

integer(int32)

created_by_name
optional

string

created_time
optional

string(date-time)

created_time_string
optional

string

description
optional

string

id
optional

integer(int32)

message
optional

string

package_description
optional

string

package_id
optional

integer(int32)

package_major_version
optional

string

package_minor_version
optional

string

package_name
optional

string

package_server_type
optional

string

package_version
optional

string

patchSchedule_job_id
optional

string

patch_description
optional

string

patch_id
optional

integer(int32)

patch_level
optional

integer(int32)

patch_name
optional

string

patch_schedule_id
optional

integer(int32)

server_id
optional

integer(int32)

server_ipaddress
optional

string

server_name
optional

string

server_type
optional

string

status
optional

integer(int32)

status_string
optional

string

stepId
optional

integer(int32)

updated_by
optional

integer(int32)

updated_by_name
optional

string

updated_time
optional

string(date-time)

updated_time_string
optional

string

workflowId
optional

integer(int32)

5.373. Payload for Approval Workflows.

This bean encapsulates the information needed to execute the operation when it is staged for approval and processing.

Name Description Schema

approverLoginName
optional

User who has approved/denied the workflow
Example : "SADM/FADM"

string

changeTicket
optional

Change ticket number obtained from the session information
Example : "12345"

string

created_by_login_name
optional

User Name who has created the specified operation.
Example : "John"

string

created_time_string
optional

The time when the specified operation is created, in string format.
Example : "01/20/2022 6:04:15"

string

data
optional

Data encapsulating the workflow information
Example : "{\"addressArray\": [\"10.0.0.3\"],\"isDeleterrsChecked\": 0,\"organization_name\":\"World\",\"routersArray\": [],\"subnet_id\": 848652,\"updated_by\": \"23199\"}"

string

description
optional

Description
Example : "Adding an object."

string

entity
optional

DDI Classification
Example : "IPv4 Network/IPv4 Subnet/Subnet Group/IPv4 Object/IPv4 DHCP Scopes/DNS Domain/DNS Managed Zone"

string

executionSummary
optional

Execution Summary
Example : "Completed. Time taken: 410 ms"

string

extensionData
optional

Any extended attributes that are applicable to the workflow entity
Example : "extension"

string

notes
optional

Notes for workflow.
Example : "Adding an object."

string

operation
optional

Operations Add, Edit, Delete, Multi-Add, Add-All, Subnet Split and Subnet Merge(ForSubnets) are supported
Example : "Add"

string

stage
optional

The stage of the workflow
Example : "Staged/Approved/Denied/Implement/Completed"

string

stageCode
optional

Stage code of workflow
Example : "1/2/3/4/5"

integer(int32)

status
optional

The status of the workflow
Example : "Awaiting Approval/In Progress/Pass/Fail"

string

statusCode
optional

Status code of workflow
Example : "1/2/3/4"

integer(int32)

updated_by_login_name
optional

User Name who has updated the specified operation.
Example : "John"

string

updated_time_string
optional

The time when the specified operation is updated, in string format.
Example : "01/20/2022 6:04:15"

string

5.374. Permission

Name Description Schema

adminAdminGroup
optional

string

adminGroupName
required

Admin group name
Example : "Dev"

string

adminName
required

Admin name
Example : "Jack"

string

createdBy
optional

string

createdTime
optional

string

functionName
required

Function Name
Example : "IPv4 Networks"

string

functionValue
required

Function value
Example : "test"

string

organizationName
required

Organization Name
Example : "Internal"

string

permissionLevel
required

Permission level either admin or admin-group
Example : "admin/admin-group"

string

privilege
required

Privilege
Example : "2/4/6"

integer(int32)

role
required

Role
Example : "NADM/PADM"

string

selectAll
required

Is select all
Example : "0/1"

integer(int32)

selectedList
required

comma separated list of Selected entity like selected networks or subnets
Example : "network1,network2"

string

updatedBy
optional

string

updatedTime
optional

string

userId
optional

integer(int32)

5.375. Permission Information

This class represents the permission information for a resource instance in the TCPWave IPAM. The information includes the entity type (Network, Subnet, Object and Subnet Group), and the resource instances (id/name or IP), and the list of Admin Groups and Admins that are associated with that privilege.

Name Description Schema

admins
optional

Admin Permission

< Authorization Entry > array

groups
optional

Admin Permission Group

< Authorization Entry > array

target_names
optional

Address of Network/Subnet/Object for which permission is given.

< string > array

target_type
required

Various targets to which the enforcement is applicable
Example : "N (for network)/S (for subnet)/O (for object)"

string

5.376. Ping Data

This class holds the results of a ping operation. This class is used for internal calls in TCPWave IPAM.

Name Description Schema

avg
required

Average value ping result

string

hops
required

List of hope data

< HopData > array

ip
optional

string

isUp
optional

boolean

loss
optional

string

max
required

Max value ping result

string

min
optional

string

rx
required

Rx value ping result

string

tx
required

Tx value ping result

string

5.377. Policy Compliance Entity

CheckoutEntity class encapsulates the attributes that are required to perform policy compliance operations, such as Policy Name, Threshold Name, Expected Value, Actual Value etc.

Name Description Schema

actualValue
required

Actual value of the threshold
Example : "100"

string

checkoutID
optional

Database ID of the policy compliance action
Example : 543

integer(int32)

checkoutStatus
optional

Compliance status
Example : "In Compliance"

string

common
required

Common policy compliance flag. This flag indicates if the policy compliance entity is common among DNS and DHCP.
Example : false

boolean

expectedValue
required

Expected value of the threshold
Example : "100"

string

name
optional

Name of the appliance.
Example : "ns0001"

string

policyID
optional

Database ID of the policy
Example : 546

integer(int32)

policyName
required

Name of the policy
Example : "TCPWave-Application-Check-Policy"

string

server_type
optional

Type of the appliance.
Example : "DHCP"

string

setBaseLine
required

Set Baseline flag. This flag indicates if the policy compliance entity can be set baseline or not.
Example : true

boolean

thresholdName
required

Name of the threshold
Example : "DNS Zone Count"

string

v4_ipaddress
optional

IPv4 Address of the appliance.
Example : "192.168.20.12"

string

v6_ipaddress
optional

IPv6 Address of the appliance.
Example : "2001:503:ba3e::2:30"

string

5.378. Port Details

This class represents switch port details which include index, name, vlan, duplex, speed, type, description, Mac Address and switch IP.

Name Description Schema

commandId
optional

string

desc
optional

Description

string

duplex
optional

Duplex
Example : "Full"

string

ifIndex
optional

Interface Index
Example : "2"

string

index
optional

Port Index
Example : "3"

string

name
optional

Name
Example : "eth1"

string

physicalAddr
optional

Interface Physical Address
Example : "10.1.1.2"

string

speed
optional

Speed
Example : "10Mbps"

string

status
optional

Status
Example : "down"

string

switchIP
optional

Switch IP
Example : "10.2.3.4"

string

vlan
optional

Vlan
Example : "vlan0"

string

5.379. PrefixListId

Name Description Schema

description
optional

string

prefixListId
optional

string

5.380. Progress Status Information

Holds various attributes that are associated to progress status.

Name Description Schema

percentCompleted
optional

Percentage completed

integer(int32)

response
optional

List of responses

< object > array

5.381. Quick Move

This class consolidates the details needed to move an object to different IP Address/name/domain.

Name Description Schema

currentAddress
required

Current address of an object.
Example : "10.2.3.0"

string

currentDomain
required

Current domain of an object.
Example : "tcptest.com"

string

currentName
required

Current name of an object.
Example : "3G00001Phone"

string

destinationAddress
required

Destination Address of an object.
Example : "10.1.6.0"

string

destinationDomain
required

Destination domain of an object.
Example : "test.com"

string

destinationName
required

Destination name.
Example : "phone32"

string

moveType
required

Object or Alias.

string

organizationName
required

Name of an organization.
Example : "Internal"

string

status
optional

boolean

5.382. RPZTemplate

Name Description Schema

certfile
optional

string

created_by
optional

integer(int32)

created_by_name
optional

string

created_time
optional

string(date-time)

created_time_string
optional

string

data
optional

string

description
optional

string

ext_feed_provider
optional

string

full_policy_file
optional

string

id
optional

integer(int32)

isZoneTransfer
optional

boolean

name
optional

string

new_name
optional

string

organization_id
optional

integer(int32)

organization_name
optional

string

policy_file
optional

string

rpz_qname_wait_recurse
optional

boolean

server_ip
optional

< string > array

server_keyalgo
optional

string

server_keyname
optional

string

server_keyvalue
optional

string

updated_by
optional

integer(int32)

updated_by_name
optional

string

updated_time
optional

string(date-time)

updated_time_string
optional

string

url
optional

string

zone_name
optional

string

zone_type
optional

integer(int32)

5.383. RRSet Order

This class represents an RRSet Order and contains the attributes necessary for RRSetOrder management functionality in TCPWave IPAM. The information includes the Zone Name, Resource Record Type, RRSet Order Value and other RRSetOrder related information.

Name Description Schema

isDefaultOrder
optional

Takes 0 or 1 to specify whether the RRSet Order is default or not
Example : 0

integer(int32)

recordType
required

Type of the specified Resource Record.
Example : "CNAME"

string

rrDefaultOrder
required

Specifies the default order for RRSet Order.
Example : "Random"

string

rrSetOrder
required

Specifies the order of the Resource Record.
Example : "Cyclic"

string

zone_name
required

Name of a zone.
Example : "tcpwave.com"

string

5.384. Reference Results

This class contains the list of Subnets, Objects, Servers, ACLs, Templates, AdminGroups, Scopes, Zones, RRs, DNS Servers and DHCP Appliances. This class is used to get and set search results of the above lists.

Name Description Schema

aclList
optional

List of Access Control List(ACLs)

PagedListAccess Control List(ACL)

adminList
optional

List of Admins.

PagedListUser

agList
optional

List of Admin Groups.

PagedListAdmin Group

dhcpServerList
optional

List of available DHCP Appliances.

PagedListServer Information

dnsServerList
optional

List of available DNS Servers.

PagedListServer Information

externalDNSZoneList
optional

List of Non-managed DNS zone references which are associated with the specified Non-managed DNS master.

PagedListExternal DNS Zone

networkList
optional

List of available networks.

PagedListNetwork Information

nsmTemplateList
optional

List of available DNS Servers.

PagedListNetwork Security Monitoring Template

objList
optional

List of Objects which are associated with the Specified Resource Record.

PagedListTIMS Object

rrlist
optional

List of Resource Records.

PagedListResource Record

scopeList
optional

List of available Scopes.

PagedListScope Information

serverList
optional

List of all Servers.

PagedListServer Information

subnetList
optional

List of Subnet References which are associated with the Specified Network.

PagedListSubnet Information

tempList
optional

List of templates.

PagedListTemplate

zoneList
optional

List of Zones.

PagedListZone

5.385. Remote Cluster Server Information

Remote Cluster Server bean class encapsulates the attributes of a remote cluster setup.

Name Description Schema

createdBy
optional

integer(int32)

createdByName
optional

string

createdTime
optional

string(date-time)

createdTimeString
optional

string

description
optional

string

extraInfo
optional

string

node01OrgName
optional

string

node01Priority
optional

Priority of the first node in the cluster.

integer(int32)

node01ServerIP
optional

string

node01ServerId
required

Server id of the first node in the cluster.

integer(int32)

node01ServerName
optional

string

node02OrgName
optional

string

node02Priority
optional

Priority of the second node in the cluster.

integer(int32)

node02ServerIP
optional

string

node02ServerId
required

Server id of the second node in the cluster.

integer(int32)

node02ServerName
optional

string

nodeStickiness
optional

Priority stickiness of the resources in a node.

integer(int32)

numOfNodes
required

Number of nodes in the cluster.

integer(int32)

serverIP
optional

Cluster IP.

string

serverId
required

The cluster server id.

integer(int32)

serverName
optional

string

serverOrgName
optional

string

serverType
optional

string

updatedBy
optional

integer(int32)

updatedByName
optional

string

updatedTime
optional

string(date-time)

updatedTimeString
optional

string

5.386. RemoteClusterState

Name Description Schema

activeNode
optional

string

clusterName
optional

string

member01Active
optional

boolean

member01IP
optional

string

member01Name
optional

string

member01Offline
optional

boolean

member01Online
optional

boolean

member01StandBy
optional

boolean

member02Active
optional

boolean

member02IP
optional

string

member02Name
optional

string

member02Offline
optional

boolean

member02Online
optional

boolean

member02StandBy
optional

boolean

serviceAffinityEnabled
optional

boolean

5.387. ReportDNSStatsPerZone

Name Description Schema

dnssec
optional

DNSSEC
Example : "Signed"

string

server_ip
required

Appliance IP
Example : "10.1.10.2"

string

server_name
required

Appliance Name
Example : "testserver"

string

totalRecords
optional

Total count of the zone resource records
Example : 28

integer(int32)

zoneRRs
optional

Zone RRs

< string, integer(int32) > map

zone_name
required

Zone Name
Example : "test.com"

string

zone_type
optional

Zone Type
Example : "Forward-Mapping"

string

5.388. ReportDNSSubTraffic

Name Description Schema

name
optional

string

total
optional

string

5.389. ReportDNSTraffic

Name Description Schema

clientList
optional

< ReportDNSSubTraffic > array

domainList
optional

< ReportDNSSubTraffic > array

queriedList
optional

< ReportDNSSubTraffic > array

reportDuration
optional

string

totalDNSQueryProcessed
optional

string

5.390. ResolutionPolicy

Name Description Schema

created_by
required

Id of the User who has created the specified Resolution Policy.
Example : 2017

integer(int32)

created_by_name
optional

The User’s name, who has logged into TCPWave IPAM, has been set as Created By for the specified Resolution Policy.
Example : "Stephen"

string

created_time
optional

The time instance when the specified Resolution Policy has been created.
Example : "03/01/2022 3:39"

string(date-time)

created_time_string
optional

String format of the time when the specified Resolution Policy has been created.
Example : "03/01/2022 4:37"

string

description
optional

Description of the Specified Resolution Policy.
Example : "This is the sample description"

string

id
optional

Id of the specified Resolution Policy.
Example : 1201

integer(int32)

matchType
required

The match type of the specified Resolution Policy.
Example : "Allow"

string

name
required

Name of the specified Resolution Policy.
Example : "BasicPolicy"

string

old_name
optional

Old Name of the specified Resolution Policy.
Example : "OldPolicy"

string

organization_id
optional

Id of the Organization which is associated to the specified Resolution Policy.
Example : 1200

integer(int32)

organization_name
required

Name of the Organization which is associated to the specified Resolution Policy.
Example : "EARTH"

string

policyData
required

Array list of ACL which are associated with the Specified Resolution Policy.

< Access Control List(ACL) > array

policyDataValue
optional

The policy data of the specified Resolution Policy.
Example : "EQ,12.1.1.12;NE,NetworkSubnet"

string

scopes
required

Scope names which are associated with the Specified Resolution Policy.
Example : "Internal,1;Moscow,2"

string

updated_by
required

Id of the User who has modified the specified Resolution Policy.
Example : 2019

integer(int32)

updated_by_name
optional

The User’s name, who has logged into TCPWave IPAM, has been set as modified By for the specified Resolution Policy.
Example : "Stephen"

string

updated_time
optional

The time instance when the specified Resolution Policy has been modified.
Example : "03/01/2022 4:37"

string(date-time)

updated_time_string
optional

String format of the time when the specified Resolution Policy has been modified.
Example : "03/01/2022 4:37"

string

zone_id
optional

Id of the zone for which the specified Resolution Policy has been associated.
Example : 1201

integer(int32)

zone_name
required

Zone Name for which the specified Resolution Policy has been associated.
Example : "zone.com"

string

5.391. Resource Record

This class represents a Resource Record and contains the attributes necessary for Resource Record management functionality in TCPWave IPAM. The information includes the Owner Name, Resource Record Value, Time To Live(TTL) Value and other Resource Record related information.

Name Description Schema

created_by
required

Id of the User who has created the specified Resource Record.
Example : "2017"

string

created_by_login_name
optional

The User’s name, who has logged into TCPWave IPAM, has been set as Created By for the specified resource record.
Example : "Stephen"

string

created_time
optional

The time instance when the specified Resource Record has been created.
Example : "03/18/2022 3:39"

string(date-time)

created_time_string
optional

String format of the time when the specified RR has been created.
Example : "03/18/2022 4:37"

string

data
optional

Target Name of the specified Resource Record.

string

description
required

Description of the specified Resource Record.
Example : "Zone RR migrated to TCPWave IPAM by Professional Services."

string

domain
required

Domain Name which is associated with the specified Resource Record.
Example : "converge.com"

string

domain_id
required

Domain Id which is associated with the specified Resource Record.
Example : 135978

integer(int32)

extensions
optional

< Xtn NVP > array

id
optional

Id of the specified Resource Record.
Example : 39447

integer(int32)

ipAddr
required

IP Address which is associated with the specified Resource Record.
Example : "192.168.1.43"

string

is_ad_rr
required

Defines if the specified Resource Record has been created by Active Directory.
Example : "No"

integer(int32)

is_external_rr
required

Defines if the specified Resource Record is external Resource Record or not.
Example : "No"

integer(int32)

mask
optional

Mask length of reverse zone
Example : 28

integer(int32)

name
required

Name of the specified Resource Record.
Example : "cons.atcc.com."

string

networkAddress
required

Address of the Network which is associated to the specified Resource Record.
Example : "10.0.0.0"

string

network_id
required

Id of the Network which is associated to the specified Resource Record.
Example : 7939

integer(int32)

olddata
optional

string

oldowner
optional

string

oldtype
optional

string

organization_id
required

Id of the Organization which is associated to the specified Resource Record.
Example : 990

integer(int32)

organization_name
required

Name of the Organization which is associated to the specified Resource Record.
Example : "EARTH"

string

owner
required

Owner Name of the specified Resource Record.
Example : "www.converge.com"

string

proxy
required

Defines if the specified Resource Record is associated with Proxy Root Zone or not.
Example : 1

integer(int32)

rrclass
required

Class of the specified Resource Record.
Example : "IN "

string

rrtype
required

Type of the specified Resource Record.
Example : "CNAME"

string

source
optional

Defines the source of the resource record update
Example : "cloud"

string

subnet_address
required

Address of the Subnet which is associated to the specified Resource Record.
Example : "10.10.0.0"

string

subnet_id
required

Id of the Subnet which is associated to the specified Resource Record.
Example : 318534

integer(int32)

ttl
required

Time To Live(TTL) of the specified Resource Record.
Example : 1200

integer(int32)

updated_by
required

Id of the User who has modified the specified Resource Record.
Example : "2019"

string

updated_by_login_name
optional

The User’s name, who has logged into TCPWave IPAM, has been set as updated By for the specified resource record.
Example : "Stephen"

string

updated_time
optional

The time instance when the specified Resource Record has been modified.
Example : "03/18/2022 4:37"

string(date-time)

updated_time_string
optional

String format of the time when the specified RR has been modified.
Example : "03/18/2022 4:37"

string

viewList
required

Array list of DNS View which are associated with the Specified Resource Record.

< DNS View > array

view_id
required

Id of the DNS View Id which is associated to the specified Resource Record.
Example : 21

integer(int32)

view_name
required

Name of the DNS View Id which is associated to the specified Resource Record.
Example : "Moscow"

string

zoneName
required

Zone name which is associated with the specified Resource Record.
Example : "atcc.com"

string

5.392. Response Policy Zone(RPZ) Policy File

This class represents a Response Policy File in TCPWave IPAM. TCPWave IPAM supports RPZ using the concept of templates. The policy file holds the rpz policy rules necessary to manage a zone. The RPZ Template refers to the policy file.

Name Description Schema

description
optional

Description of the RPZ Policy File

string

policy_file
optional

Policy rules file name.

string

5.393. Response Policy Zone(RPZ) Rule File

This class represents a Response Policy Rule in TCPWave IPAM. TCPWave IPAM supports RPZ using the concept of templates.

Name Description Schema

action
optional

Action for internal usage.

string

oldPolicyRR
optional

Policy Trigger RR old value.

string

oldPolicyRhValue
optional

Policy Rules rh old value.

string

policy_rhvalue
required

Policy Rules rh value.

string

policy_rr
required

Policy Trigger RR value.

string

policy_trigger
required

Policy Trigger Name.

string

5.394. Response Policy Zone(RPZ) Template association information with DNS Server

This bean is used internally by TCPWave IPAM to manage the associations between an RPZ Template and a DNS Cache Server. When an RPZ Template is applied to a DNS Cache Server in TCPWave IPAM an instance of the RPZ Template association is created. (This is for internal use in TCPWave IPAM.)

Type : object

5.395. Role

Name Description Schema

arn
optional

string

assumeRolePolicyDocument
optional

string

createDate
optional

string(date-time)

description
optional

string

maxSessionDuration
optional

integer(int32)

path
optional

string

permissionsBoundary
optional

AttachedPermissionsBoundary

roleId
optional

string

roleName
optional

string

tags
optional

< Tag > array

5.396. Root Access Management Details

Root Access Management Details class encapsulates the attributes that are required to set up Root Access Management across TCPWave IPAM infrastructure.

Name Description Schema

updatedBy
required

User who has updated the information
Example : "sadm"

string

updatedTime
optional

Updated Time
Example : "03/18/2022 4:50"

string(date-time)

updatedTimeStr
required

Updated Time

string

useSSL
required

Use SSL
Example : true

boolean

vaultServerCertPath
required

Vault Server Certificate Path
Example : "/tmp/cert.crt"

string

vaultServerHost
required

Vault Host Address
Example : "10.1.2.3"

string

vaultServerPort
required

Vault Port
Example : 8200

integer(int32)

vaultType
required

Vault type
Example : "Native"

string

5.397. Router

This class represents a discovery router

Name Description Schema

base_bridge_address
optional

Base bridge address.

string

commandId
optional

string

id
optional

Id of the specified router.
Example : 1

integer(int64)

if_number
optional

if_number.

string

ip
optional

IP address of the specified router.
Example : "1.0.0.1"

string

mac
optional

MAC.

string

neighborIp
optional

string

platform
optional

Platform

string

serial_number
optional

Serial number.

string

sys_contact
optional

System contact.

string

sys_desc
optional

System Description.

string

sys_location
optional

System location.

string

sys_name
optional

System name.

string

sys_services
optional

System services.

string

sys_uptime
optional

System uptime.

string

vendor
optional

Vendor

string

version
optional

Version

string

5.398. Router Element Details

This class represents the IP Address, Interface, Description and Mac Address details of a device connected to a Router.

Name Description Schema

commandId
optional

string

description
required

Description

string

interfaceName
required

Interface name

string

ipAddress
required

IP address
Example : "10.0.0.0"

string

lastSeen
required

Last seen

string

macAddress
required

Mac address

string

name
required

Router Element Name

string

routerIP
required

Router IP

string

uptime
required

Up time

string

vrf
optional

VRF

string

5.399. Router Interface

This class represents a discovery router neighbor

Name Description Schema

commandId
optional

string

description
optional

string

id
optional

Id of the specified router interface.

integer(int64)

interfaceIp
optional

Interface IP.
Example : "1"

string

interfaceName
optional

Interface name.
Example : "1"

string

ipVersion
optional

integer(int32)

protocol
optional

Protocol.
Example : false

boolean

routerIp
optional

IP address of the specified router interface.
Example : "1"

string

status
optional

Status.
Example : false

boolean

5.400. Router Neighbor

This class represents a discovery router neighbor

Name Description Schema

capabilities
optional

Router neighbor capabilities.

string

chassis_id
optional

Chassis Id of the specified router neighbor.

string

commandId
optional

string

id
optional

Id of the specified router neighbor.
Example : 1

integer(int64)

ipVersion
optional

integer(int32)

local_interface
optional

Local Interface of the specified router neighbor.

string

management_ip
optional

Management IP of the specified router neighbor.

string

neighbor
optional

Router Neighbor.

string

neighbor_interface
optional

Interface of the specified router neighbor.

string

neighbor_port_id
optional

Port Id of the specified router neighbor.

string

protocol
optional

string

routerIp
optional

string

serial
optional

Serial.

string

system_description
optional

System description.

string

5.401. Router Subnet

This class represents a router subnet

Name Description Schema

appliance_ip
optional

string

commandId
optional

string

description
optional

string

domain_name
required

Domain of the router.
Example : "tcpwave.com"

string

id
optional

Id of the specified router subnet.
Example : 1

integer(int64)

interfaceIp
optional

string

interfaceName
required

Name of the interface.
Example : "loopback0"

string

ipVersion
optional

integer(int32)

isAccepted
optional

integer(int32)

local
required

Is local.
Example : false

boolean

nextHop
required

Next hop.

string

objectIP
optional

string

organization_name
required

Organization of the router.
Example : "Internal"

string

protocol
required

Protocol.

string

routerIP
required

IP address of the router.
Example : "10.1.10.2"

string

subnetIP
required

IP address of the subnet.
Example : "10.1.10.0"

string

subnetMask
required

Subnet mask.
Example : "255.255.255.0"

string

subnetMaskLength
required

Mask length of subnet.
Example : 24

integer(int32)

type
required

type.

string

vlan
optional

string

vrfEnabled
optional

boolean

vrfName
optional

string

5.402. Router Switch

This class represents a discovery router and switch relation.

Name Description Schema

commandId
optional

string

id
optional

integer(int64)

routerIp
optional

string

switchIp
optional

string

5.403. RouterSubnetElement

Name Description Schema

aton_address
optional

integer(int64)

commandId
optional

string

contact
optional

string

description
optional

string

device
optional

string

domainName
optional

string

ip_address
optional

string

last_seen
optional

string

latency
optional

string

location
optional

string

mac
optional

string

maskLength
optional

integer(int32)

name
optional

string

organizationName
optional

string

os
optional

string

port_duplex
optional

string

ports
optional

string

routerIp
optional

string

status
optional

string

subnetIp
optional

string

switch_name
optional

string

switch_port
optional

string

vendor
optional

string

5.404. SOA

Name Description Schema

email
optional

string

expireTime
optional

integer(int32)

host
optional

string

negativeCache
optional

integer(int32)

refreshTime
optional

integer(int32)

retryTime
optional

integer(int32)

serialNumber
optional

integer(int64)

serverIP
optional

string

serverName
optional

string

serverType
optional

string

zoneName
optional

string

5.405. Scheduled Job Type

This class contains the information about scheduled job ID, job type and job description.

Name Description Schema

description
optional

Description of the schedule job type

string

typeCode
optional

Code of the schedule job type

string

typeName
optional

Name of schedule job type

string

5.406. Scheduled job execution status information

This class contains the information about scheduled job ID, execution status, success or failure message and the execution time of the scheduled job.

Name Description Schema

execution_message
optional

Represents execution message
Example : "Executed successfully"

string

execution_status
optional

Represents state of execution
Example : "completed"

integer(int32)

execution_time
optional

Represents execution time
Example : "02/18/2022 3:39"

string(date-time)

execution_time_string
optional

Represents the execution time
Example : "02/18/2022 3:39"

string

id
optional

Id for the specific scheduled job
Example : 33

integer(int32)

jobData
optional

Get job details
Example : "Executed at 15.20 AM"

string

jobId
optional

ID for the specific job
Example : "11"

string

jobType
optional

Represents Job type
Example : "rest"

string

operation
optional

Represent the type of operation
Example : "Add"

string

scheduleType
optional

Represents the Scheduled type
Example : "Daily"

string

5.407. Scope Information

Persists the attributes of DHCP Scope such as start address, end address, subnet address, network address, organization, DHCP Option Template, DHCP Appliance, DHCP Classes to be allowed and denied etc.

Name Description Schema

addr
required

IP address of the object

string

addressRange
required

Collection of address ranges

string

allowClassesArray
optional

DHCP Classes to be allowed for a given scope

< string > array

class_code
required

Object type for the placeholder objects

string

created_by_login_name
optional

Login name of the user who created the entity

string

created_by_name
optional

Login name of the user who created the entity

string

created_time
optional

Date and Time of creation of the entity

string(date-time)

created_time_string
optional

String instance of the created time

string

denyClassesArray
required

DHCP Classes to be denied for a given scope

< string > array

description
optional

Description for the scope

string

endIP
required

End IP of the scope

integer(int64)

full
required

Percentage full in terms of active leases in a given scope

integer(int32)

max_addr
required

End IP of the Scope

< string > array

min_addr
required

Short IP of the Scope

< string > array

network_address
required

IP Address of the network

string

objectCount
optional

integer(int64)

organization_name
required

Name of the organization

string

primary_dhcp_server
required

Name of the primary DHCP Appliance

string

rangeArray
required

Collection of address ranges

< string > array

sharedNetworkName
optional

string

startIP
required

Start IP of the scope

integer(int64)

subnetDomain
required

Domain name of the subnet
Example : "test.com"

string

subnetMask
required

Mask length of the subnet
Example : "24"

string

subnetRouter
optional

Router address of the subnet
Example : "10.0.0.1"

string

subnet_address
required

IP Address of the subnet

string

template_name
required

Name of the DHCP Option Template

string

updated_by_login_name
optional

Login name of the user who updated the entity

string

updated_by_name
optional

Login name of the user who updated the entity

string

updated_time
optional

Date and Time of updating the entity

string(date-time)

updated_time_string
optional

String instance of the updated time

string

5.408. Scope Validate Request Data

Represents the data that is passed on to the DHCP Sanity checker to validate the syntax and correctness of a scope that is to be created.

Name Description Schema

dhcp_server_ip
optional

string

dhcp_server_type
required

DHCP Appliance type

string

ttl
required

Time to Live value

integer(int32)

5.409. Security Group

Detailed information about Security Group model.

Name Description Schema

addedInboundRules
optional

< Security Group Conigs > array

cloud_provider_id
optional

integer(int32)

cloud_provider_name
optional

string

created_by_login_name
optional

Name of the User who has created the specified Security Group.
Example : "John"

string

created_time_string
optional

The time instance when the specified Security Group has been created.
Example : "03/18/2022 4:37"

string

deletedInboundRules
optional

< Security Group Conigs > array

description
optional

Description of Security Group.
Example : "This is a Security group."

string

id
optional

Database ID of the appliance group
Example : 1234

integer(int32)

name
optional

Name of Security Group
Example : "Test"

string

organization_name
optional

string

prevAppGroupName
optional

Previous name of Security Group.
Example : "ABC"

string

updated_by_login_name
optional

Name of the User who has modified the specified Security Group.
Example : "John"

string

updated_time_string
optional

The time instance when the specified Security Group has been modified.
Example : "03/18/2022 4:37"

string

vpc_id
optional

string

5.410. Security Group Conigs

Detailed information about Security Group configuration model.

Name Description Schema

description
optional

string

end_port
optional

string

id
optional

integer(int32)

ip_version
optional

string

protocol
optional

string

start_port
optional

string

type
optional

string

5.411. SecurityGroup

Name Description Schema

description
optional

string

groupId
optional

string

groupName
optional

string

ipPermissions
optional

< IpPermission > array

ipPermissionsEgress
optional

< IpPermission > array

ownerId
optional

string

tags
optional

< Tag > array

vpcId
optional

string

5.412. Server Basic Information

Server bean class encapsulates the attributes of a generic server. This class represents the properties that are common to both DNS and DHCP Sever.

Name Description Schema

associated_v4_ipaddress
required

IPV4 Address associated with IPV6 server
Example : "7000::1"

string

id
optional

Id of the specified server.
Example : 121

integer(int32)

name
required

Name of the specified Server.
Example : "nusartx-est015-sl09113"

string

organization_id
required

Id of the Organization which is associated with the specified Server.
Example : 990

integer(int32)

organization_name
required

Name of the Organization which is associated to the specified Server.
Example : "EARTH"

string

server_type
required

Type of the specified Server.
Example : "BIND_AUTH"

string

v4_address
required

IPV4 Address which is associated with the specified Server.
Example : "192.1.10.200"

string

v6_address
required

IPV6 Address which is associated with the specified Server.
Example : "7000::1"

string

5.413. Server Entity Version

Gets Server version information. Version information includes MajorVersion, BuildString, PatchLevel, MinorVersion, ServerType

Name Description Schema

amq_version
optional

Amq version of appliance

string

bgp
optional

BGP version of remote server

string

bgp_peers
optional

Bgp peers

string

bind
optional

BIND version of DNS Appliance

string

bios
required

BIOS version
Example : "2.11.0"

string

dhcp
optional

The DHCP version

string

dr_config
optional

DR config

string

firmware
required

Firmware version
Example : "2.47.41"

string

id
optional

Database ID of server

string

ipv4
optional

Remote server’s IP Address

string

kernel
required

Kernel version
Example : "4.4.194"

string

last_sync
optional

string

last_updated
optional

string

master_server
optional

Host address of Master IPAM server

string

master_z
optional

Master IPAM server IP Address

integer(int32)

name
optional

Remote server’s name

string

nsd_version
optional

NSD version of DNS Appliance

string

ntp
optional

NTP version of remote server

string

ntp_servers
optional

NTP version of appliance

string

organization
optional

Organization name associated with appliance
Example : "Internal"

string

patch_level
optional

Patch level

string

server_current_heartbeat
optional

Server current heart beat

integer(int32)

server_current_status
optional

integer(int32)

slave_server
optional

Host address of Slave IPAM server

string

slave_z
optional

Slave IPAM server IP Address

integer(int32)

snmp
optional

SNMP version of remote server

string

snmp_trap
optional

list of SNMP trap targets

string

ssh
optional

SSH version of remote server

string

syslog_servers
optional

List of syslog servers defined on a server

string

tacacs_servers
optional

list of TACACS servers defined

string

tims_dhcp_version
optional

The timsdhcp version

string

tims_dns_version
optional

The timsdns version

string

type
optional

Remote appliance server type

string

unbound
optional

Unbound version of DNS remote appliance

string

zebra_version
optional

Zebra version of server

string

5.414. Server Information

Server bean class encapsulates the attributes of a generic server. This class represents the properties that are common to both DNS and DHCP Sever.

Name Description Schema

alerts
optional

integer(int32)

applianceGroups
optional

List of associated appliance groups of an appliance.

< Appliance Group > array

applianceGroupsStr
optional

Comma separated appliance groups list
Example : "Appliance Groups List"

string

associated_v4_ipaddress
required

IPV4 address of the specified Server.

string

authAsCache
optional

Authoritative as Cache appliance.
Example : "1"

string

autoDNSDR
optional

Enable automatic DNS DR on internal cache appliance.
Example : "yes"

string

autoRestoreConf
optional

Defines whether to auto restore configurations on remote if the configuration files mismatch.
Example : 1

integer(int32)

banner
optional

Banner of the DNS/DHCP appliance

string

bgpobj
required

Defines BGP configuration associated with the specified appliance.

BGP Details

centralLoggingStatus
required

Specifies central logging enablement status of the specified server.
Example : "yes"

string

clusterMembers
required

Comma separated member appliance IP addresses of a cluster appliance.
Example : "10.1.1.2,10.1.1.3"

string

created_by
required

Id of the User who has created the specified server.
Example : 2017

integer(int32)

created_by_login_name
required

The User’s name, who has logged into the TCPWave IPAM, has been set as Created By for the specified server.
Example : "Stephen"

string

created_by_name
optional

Name of the User who has created the specified server.
Example : "Stephen"

string

created_time
optional

The time instance when the specified server has been created.
Example : "05:21:35 02-01-2022"

string(date-time)

created_time_string
optional

String format of the time when the specified server is created.
Example : "05:21:35 02-01-2022"

string

customProperties
optional

< string, string > map

deletedForwarders
optional

List of server forwarders which need to be deleted.

< Appliance Forwarder > array

description
optional

Description for the specified server.
Example : "Corp. DNS Server migrated to the TCPWave IPAM by Professional Services."

string

dhcp_policy_template_id
required

Id of the DHCP policy template which is associated to the specified server.
Example : "DHCP Policy Template"

integer(int32)

dhcp_policy_template_name
required

Name of the DHCP policy template which is associated to the specified server.
Example : "41065"

string

dhcpd_interfaces
optional

dhcpd listening Interface names
Example : "eth0,eth1"

string

discoveryConfig
optional

string

dmzVisible
required

Defines whether the specified Server has Demilitarized Zone(DMZ) visibility or not.
Example : "no"

integer(int32)

dns64List
required

Array list of DNS64 Prefixes which are associated with the specified server.

< DNS64 > array

dns_options_template_id
required

Id of the DNS option template which is associated to the specified server.
Example : 41049

integer(int32)

dns_options_template_name
required

Name of the DNS option template which is associated to the specified server.
Example : "BIND AUTH Option Template"

string

dns_server_template_id
required

Id of the DNS server template which is associated to the specified server.
Example : 40940

integer(int32)

dns_server_template_name
required

Name of the DNS server template which is associated to the specified server.
Example : "BIND AUTH Server Template"

string

domain_id
required

Id of the Domain which is associated with the specified server.
Example : 135977

integer(int32)

domain_name
required

Name of the Domain which is associated with the specified server.
Example : "atcc.com"

string

elevatedPrivilegesConfig
optional

Elevated Privileges Configuration Details
Example : "{\"environmentVariables\":[{\"value\":\"Defaults always_query_group_plugin\"}],\"userAliases\":[{\"user_alias_name\":\"USER_ALIAS_1\",\"user_alias_value\":\"testuser\"}],\"hostAliases\":[{\"host_alias_name\":\"HOST_ALIAS_1\",\"host_alias_value\":\"192.168.0.139\"}],\"runasAliases\":[{\"runas_alias_name\":\"RUNAS_ALIAS_1\",\"runas_alias_value\":\"user2\"}],\"commandAliases\":[{\"command_alias_name\":\"COMMAND_ALIAS_1\",\"command_alias_value\":\"/cp\"}],\"userSpecifications\":[{\"user_alias\":\"USER_ALIAS_1\",\"host_alias\":\"HOST_ALIAS_1\",\"runas_alias\":\"RUNAS_ALIAS_1\",\"runas_group_alias\":\"\",\"command_alias\":\"COMMAND_ALIAS_1\",\"taglist\":\"\"}]}"

string

elevatedPrivilegesJson
optional

Elevated Privileges Configuration JSON String
Example : "{\"environmentVariables\":[{\"value\":\"Defaults always_query_group_plugin\"}],\"userAliases\":[{\"user_alias_name\":\"USER_ALIAS_1\",\"user_alias_value\":\"testuser\"}],\"hostAliases\":[{\"host_alias_name\":\"HOST_ALIAS_1\",\"host_alias_value\":\"192.168.0.139\"}],\"runasAliases\":[{\"runas_alias_name\":\"RUNAS_ALIAS_1\",\"runas_alias_value\":\"user2\"}],\"commandAliases\":[{\"command_alias_name\":\"COMMAND_ALIAS_1\",\"command_alias_value\":\"/cp\"}],\"userSpecifications\":[{\"user_alias\":\"USER_ALIAS_1\",\"host_alias\":\"HOST_ALIAS_1\",\"runas_alias\":\"RUNAS_ALIAS_1\",\"runas_group_alias\":\"\",\"command_alias\":\"COMMAND_ALIAS_1\",\"taglist\":\"\"}]}"

string

enableDnsOverTLS
optional

Is DNSOverTLS enabled on the appliance
Example : "yes/no"

string

enableIntrusionDetection
optional

boolean

enableSNMPv3
required

Specifies whether SNMPv3 is enabled or not on the appliance.
Example : true

boolean

enableTunnelDetection
optional

Specifies whether the given appliance has DNS tunnel detection enable or not.
Example : "no"

string

enablefingerprint
optional

Restart the dhcpd service with finger print enabled
Example : true

boolean

entity_type_code
required

Entity Type code for the specified Server
Example : "OPTION"

string

failover_address
optional

Failover Settings

string

failover_port
optional

Failover port
Example : 2523

integer(int32)

firewall_template_id
required

Internal storage ID of the firewall template for the specified server.

integer(int32)

firewall_template_name
required

Name of the firewall template for the specified server.

string

id
optional

Id of the specified server.
Example : 121

integer(int32)

idracPassword
optional

iDrac password of an appliance.
Example : "abc123"

string

idracSnmpCommunity
optional

iDrac SNMP Community string
Example : "zxcv"

string

internal_cache_server
required

Defines if the specified server is an internal cache server or not.
Example : "No"

integer(int32)

isAlive
optional

Is secure communication establish or not
Example : false

boolean

isRemoteClusterServer
required

Indicates whether this is a remote cluster appliance.
Example : true

boolean

isRootPassConfigured
optional

boolean

is_primary
required

Defines if the server is primary server or not.
Example : 0

integer(int32)

lastSyncTime
optional

Last sync time of the appliance
Example : "05:21:35 02-01-2022"

string(date-time)

lastSyncTimeString
optional

String format of the time when the specified server is last synchronized.
Example : "05:21:35 02-01-2022"

string

ldapSSHConfig
optional

JSON string of the LDAP SSH configuration - for Internal use only

string

load_balance_max_secs
optional

DHCP Failover settings

integer(int32)

max_response_delay
optional

DHCP Failover settings

integer(int32)

max_unacked_updates
required

Maximum unacknowledged updates
Example : 30

integer(int32)

mclt
required

Maximum client lease time for failover configuration(in sec)
Example : 1800

integer(int32)

mgmtIP
optional

IP address of management or primary network interface, that is used to connect to remote.
Example : "192.168.0.22"

string

monitoringService
required

Defines if monitoring is enabled or disabled for the specified server.
Example : "Yes"

string

name
required

Name of the specified Server.
Example : "nusartx-est015-sl09113"

string

nicsConfig
required

List of network interface associated with the specified appliance

NICConfig

nsm_template
optional

Name of the NSM template for the specified server.
Example : "nsm_template_1"

string

nsm_template_id
optional

Internal storage ID of the NSM template for the specified server.
Example : 101

integer(int32)

ntpConfig
optional

JSON string of the NTP configuration - for Internal use only

string

object_id
required

Id of the Object associated to the server .
Example : 19

integer(int32)

old_address
required

IP address of the specified server before modification.
Example : "192.168.1.234"

string

option
optional

DHCP Failover settings

string

organization_id
required

Id of the Organization which is associated with the specified server.
Example : 990

integer(int32)

organization_name
required

Name of the Organization which is associated to the specified server.
Example : "EARTH"

string

ospfConfiguration
required

Defines OSPF configuration associated with the specified appliance.

OSPF Details

primary_port
optional

Primary port
Example : 2732

integer(int32)

remoteDebug
optional

Enable remote debugging on appliance.
Example : "yes"

string

resolverData
optional

JSON Formatted /etc/resolv.conf

string

rootPassword
optional

Root password of an appliance
Example : "abc123"

string

routingConfig
optional

Routing configuration

string

routingType
optional

string

rpzTemplates
optional

Response Policy Zone(RPZ) templates associated with the specified server.

< RPZTemplate > array

rtTablesJson
optional

RtTable JSON string
Example : "[{\"port\":\"255\",\"name\":\"local\"},{\"port\":\"254\",\"name\":\"main\"},{\"port\":\"253\",\"name\":\"default\"},{\"port\":\"0\",\"name\":\"unspec\"}]"

string

serverPreference
optional

DHCP Failover settings

string

server_type
required

Type of the specified server.
Example : "BIND AUTH"

string

setFailoverFlag
optional

DHCP Failover settings

boolean

snmpAcl
optional

string

snmpAcl_id
optional

integer(int32)

snmpConfig
optional

JSON string of the SNMP configuration for Internal use only

string

snmpv3Users
required

Specifies list of SNMPv3 users.

string

split
required

Load balancing share percentage
Example : 50

integer(int32)

stealthServer
required

Defines if the specified server is a Stealth Server or not.
Example : "No"

integer(int32)

subnet_address
optional

string

syslogConfig
optional

JSON string of the Syslog-ng configuration - - for Internal use only

string

syslogNgConfig
optional

JSON string of the Syslog-ng configuration - - for Internal use only

Syslog-ng configuration details

systemResources
optional

System resources details of the appliance

string

tacacsConfig
optional

JSON string of the TACACS configuration - for Internal use only

string

tacacsConfigDecrypted
optional

JSON decrypted string of the TACACS configuration - for Internal use only

string

timeZone
optional

Time Zone of the given DNS/DHCP Appliance

string

update_in_progress
optional

boolean

updated_by
required

Id of the User who has modified the specified server.
Example : "05:21:35 02-01-2022"

integer(int32)

updated_by_login_name
required

The User’s name, who has logged into the TCPWave IPAM, has been set as Created By for the specified server.
Example : "John"

string

updated_by_name
optional

Name of the user who has modified the authoritative server.
Example : "John"

string

updated_time
optional

The time instance when the specified server has been modified.
Example : "05:21:35 02-01-2022"

string(date-time)

updated_time_string
optional

String format of the time when the specified server is modified.
Example : "05:21:35 02-01-2022"

string

v4_ipaddress
required

IPV4 Address which is associated with the specified server.
Example : "192.1.10.200"

string

v6ShortHandAddress
optional

Appliance IPv6 short hand address.
Example : "5000:2"

string

v6_ipaddress
required

IPV6 Address which is associated with the specified server.
Example : "2001:503:ba3e::2:30"

string

viewList
required

Array list of DNS View which are associated with the specified Server.

< DNS View > array

vrrpConfiguration
required

Defines VRRP configuration associated with the specified appliance.

VRRP Details

zebraConfig
optional

Zebra configuration for the given DNS/DHCP appliance

string

zebraobj
required

Defines Zebra configuration associated with the specified appliance.

BGP Details

5.415. Server License

This class represents the license details of a server. The details include but not limited to Server IP, Server Name, Days Valid, License IP, Customer and Status.

Name Description Schema

customer
required

Customer name who has requested for updating License.
Example : "Ericson Ltd."

string

customer_id
required

Customer ID who has requested for updating License.
Example : "987"

string

days_valid
required

Total number of days Server License is valid for.
Example : 100

integer(int32)

isHaLicense
optional

boolean

isPermanent
optional

boolean

is_valid
required

If Server License ID is valid or invalid.
Example : false

boolean

last_checked
required

Date on which Server License has been checked last time.
Example : "12/03/2022"

string(date-time)

license_ip
required

IP of Server License.
Example : "10.0.0.0"

string

license_service_tag
required

Service tag of License based on Server Type. i.e. DNS - 1, DHCP - 2, DNS-DHCP - 3
Example : "2"

string

majorVersion
optional

string

maxIps
optional

integer(int32)

minorVersion
optional

string

organization_name
required

Organization Name associated with Server.
Example : "TCPWAVE"

string

server_current_status
optional

Appliance current status.
Example : "0 (for License valid)/ 1 (for License Invalid) "

integer(int32)

server_id
required

ID of the Server.
Example : 123

integer(int32)

server_license_id
required

License ID of the Server.
Example : "8EB8AB85DFF74B0B492BB9618375DA11"

integer(int32)

server_name
required

Name of the Server.
Example : "DHCP-100"

string

server_type
required

Server which has to be updated with new License.
Example : "BIND"

integer(int32)

server_type_code
required

Code of the Server to Identify its type.

string

server_v4ip
required

IP of Server.
Example : "10.0.0.0"

string

status
required

Status of current Server License.
Example : "Valid/Invalid"

string

titanEus
optional

TitanEndUserSecurity

5.416. ServerZone

Name Description Schema

activeDirectoryEnable
required

Defines whether Active Directory is enabled or not for the specified zone.
Example : "Yes/No"

string

dcAclNames
required

Array list of Domain Controller Access Control List(ACL) names for the specified zone.

< string > array

dcObjectAddresses
required

Array list of Domain Controller Object Addresses of a zone.

< string > array

dcV6ObjectAddresses
optional

< string > array

default_ttl
required

Default Time To Live(TTL) of the specified zone.
Example : 3200

integer(int32)

dnssec_enable
required

Defines if Domain Name System Security Extensions(DNSSEC) is enabled or not for the specified Zone.
Example : "Yes/No"

string

email_addr
optional

Email Id of the contact person for this specified Zone.
Example : "[email protected]"

string

is_master
required

Defines if the specified server is Master or not.
Example : false

boolean

mirrorzoneString
optional

Comma separated Mirrored zone names for an existing Managed Zone.
Example : "text.com,volume.com"

string

name
required

Name of the Zone associated with the specified Server.
Example : "edu.com"

string

nonManagedNSList
required

List of the Non-Managed Name Servers for the zone

< NonManagedNameServer > array

nonManagedNSTSIGKeys
required

Array list of TSIG key names for non managed secondaries zone transfer..

< string > array

nsec_option
required

Defines the value when Domain Name System Security Extensions(DNSSEC) is enabled for a zone.
Example : "NSEC/NSEC3"

string

organization_id
required

Id of the Organization which is associated with the specified Zone.
Example : 10

integer(int32)

organization_name
required

Name of the Organization which is associated with the specified Zone.
Example : "EARTH"

string

proxy
required

Defines if the server is associated with Proxy Root Zone or not.
Example : "No"

integer(int32)

rrSetOrderList
optional

Array list of rrset-order preferences for the specified zone.

< RRSet Order > array

secureActiveDirectoryEnable
required

Defines whether Secure Active Directory is enabled or not for the specified zone.
Example : "Yes/No"

string

serial_number
required

Serial Number of the specified Zone
Example : 5

integer(int64)

server_id
required

Id of the specified Server which is defined as a Master or Slave in the Zone.
Example : 121

integer(int32)

zoneMonitoringService
required

Defines whether Monitoring is enabled or not for the specified zone.
Example : "Yes/No"

string

zone_description
optional

Description for the specified Zone.
Example : "[10.0.0.2,10.0.0.3]"

string

zone_id
required

Id of the Zone associated with the specified Server.
Example : 135231

integer(int32)

zone_template_id
required

Id of the zone template which is associated with the specified Zone.
Example : 10

integer(int32)

zone_template_name
required

Name of the Zone Template associated with the specified Zone.
Example : "Zone Template"

string

5.417. Service

ServiceMode class encapsulates the attributes that are required to create a service such as Name, Cname, Selected Mode, Current Mode, Description etc.

Name Description Schema

cname
optional

string

createdBy
optional

integer(int32)

createdByName
optional

string

createdTime
optional

string(date-time)

createdTimeString
optional

string

currentMode
optional

string

description
optional

string

id
optional

integer(int32)

lastChecked
optional

string(date-time)

lastCheckedString
optional

string

lastUpdateStatus
optional

string

name
optional

string

oldName
optional

string

organizationId
optional

integer(int32)

organizationName
optional

string

selectedMode
optional

string

targets
optional

< Service Target > array

updatedBy
optional

integer(int32)

updatedByName
optional

string

updatedTime
optional

string(date-time)

updatedTimeString
optional

string

zoneId
optional

integer(int32)

zoneName
optional

string

5.418. Service Mode

ServiceMode class encapsulates the attributes that are required to create a service mode such as Mode, Description etc.

Name Description Schema

createdBy
optional

integer(int32)

createdByName
optional

string

createdTime
optional

string(date-time)

createdTimeString
optional

string

description
optional

string

id
optional

Database ID of the service mode
Example : 44

integer(int32)

mode
optional

string

oldMode
optional

string

updatedBy
optional

integer(int32)

updatedByName
optional

string

updatedTime
optional

string(date-time)

updatedTimeString
optional

string

5.419. Service Schedule

ServiceSchedule class encapsulates the attributes that are required to create a service schedule such as Service Name, Service Mode, Schedule Time etc.

Name Description Schema

cname
optional

string

id
optional

integer(int32)

organizationName
optional

string

runDay
optional

integer(int32)

runDayStr
optional

string

runTime
optional

string

schedTaskId
optional

string

scheduleFrequency
optional

string

scheduleTime
optional

string(date-time)

scheduleTimeStr
optional

string

serviceId
optional

integer(int32)

serviceMode
optional

string

serviceName
optional

string

targetRR
optional

string

5.420. Service Target

ServiceTarget class encapsulates the attributes that are required to create a service target such as Service, service Mode, Target, Description etc.

Name Description Schema

createdBy
optional

integer(int32)

createdByName
optional

string

createdTime
optional

string(date-time)

createdTimeString
optional

string

id
optional

integer(int32)

serviceId
optional

integer(int32)

serviceMode
optional

string

serviceName
optional

string

target
optional

string

updatedBy
optional

integer(int32)

updatedByName
optional

string

updatedTime
optional

string(date-time)

updatedTimeString
optional

string

5.421. Subnet

This class represents a discovery Subnet.

Name Description Schema

commandId
optional

string

description
optional

string

domain_name
optional

string

end_aton_address
optional

integer(int64)

id
optional

integer(int64)

interfaceIp
optional

string

interfaceName
optional

string

ip_address
optional

string

ip_version
optional

integer(int32)

name
optional

string

nextHop
optional

string

organization_name
optional

string

protocol
optional

string

routerIP
optional

string

send_to_ipam
optional

boolean

sent_status
optional

boolean

start_aton_address
optional

integer(int64)

startsWith
optional

integer(int32)

subnetMask
optional

string

subnetMaskLength
optional

integer(int32)

type
optional

string

vlan
optional

string

vrfEnabled
optional

boolean

vrfName
optional

string

5.422. Subnet Elements

This class represents a subnet elements

Name Description Schema

aton_address
optional

integer(int64)

commandId
optional

string

contact
optional

string

description
optional

string

device
optional

string

id
optional

integer(int64)

ip_address
optional

string

last_seen
optional

string

latency
optional

string

location
optional

string

mac
optional

string

mac_in_db
optional

string

name
optional

string

name_in_db
optional

string

os
optional

string

port_duplex
optional

string

ports
optional

string

subnetIp
optional

string

subnetMaskLength
optional

integer(int32)

switch_name
optional

string

switch_port
optional

string

type
optional

string

vendor
optional

string

5.423. Subnet Group

Detailed information about Subnet Group model.

Name Description Schema

bootp_id
optional

ID of the bootp.
Example : 13

integer(int32)

created_by_name
optional

Login name of the user who created the subnet group.
Example : "admin"

string

created_time
optional

Date and Time of creation of the subnet group.
Example : "03/18/2022 3:39"

string(date-time)

created_time_string
optional

String format of the date and Time of creation of the subnet group.
Example : "03/18/2022 4:37"

string

description
optional

A description for the subnet group.
Example : "SALES US Subnet Group"

string

id
optional

ID of this Subnet Group.
Example : 1

integer(int32)

name
optional

Name of this subnet group.
Example : "Subnet Group"

string

oldName
optional

Name of the specified SubnetGroup before modification.
Example : "Comm-Equipment"

string

option_template_id
optional

ID of the associated option template.
Example : 11

integer(int32)

organization_id
optional

ID of the organization to which this subnet group belongs.
Example : 1

integer(int32)

organization_name
optional

Name of the organization to which this subnet group belongs.
Example : "Internal"

string

policy_template_id
optional

integer(int32)

updated_by_name
optional

Login name of the user who last updated the subnet group.
Example : "admin"

string

updated_time
optional

Date and time of the last update performed on this subnet group.
Example : "03/18/2022 3:49"

string(date-time)

updated_time_string
optional

String format of the date and time of the last update performed on this subnet group.
Example : "03/18/2022 4:37"

string

5.424. Subnet Group Delete Request

Required information to delete subnet groups with or without references.

Name Description Schema

deleteWithReferences
optional

This parameter decides whether to delete subnet groups with references or not.
Example : false

boolean

subnetGroupList
required

List of subnet groups.

< Subnet Group > array

5.425. Subnet Group References

This class represents a subnet group references(subnets) in TCPWave IPAM. The information includes the Subnet Group Name, Organization Name, Subnet Address and Subnet Name.

Name Description Schema

organizationName
optional

Name of an organization to which the subnet group is associated with.
Example : "Internal"

string

referencesList
optional

List of subnets which are referring to the specified subnet groups.

< Subnet Group References > array

subnetAddress
optional

Address of a subnet which is referring to the specified subnet group.
Example : "192.168.0.0/24"

string

subnetGroupName
optional

Name of a subnet group which has subnets referring to it.
Example : "tcp-sngroup1"

string

subnetName
optional

Name of a subnet which is referring to the specified subnet group.
Example : "test_subnet10"

string

subnetTemplateName
optional

Name of a subnet template which is referring to the specified subnet group.
Example : "subnet_template_1"

string

undeletedSubnetGroups
optional

Comma separated list of undeleted subnet groups(subnetGroupName|organizationName).
Example : "tcp-gr|Internal, group2|testOrg"

string

5.426. Subnet Information

SubNet encapsulates the attributes that pertain to a subnet such as the subnet start address, subnet end address, mask length, primary router, primary domain, DHCP Profile of the subnet etc.

Name Description Schema

addr1
required

Octet-1 of the subnet address.
Example : 162

integer(int32)

addr2
required

Octet-2 of the subnet address.
Example : 192

integer(int32)

addr3
required

Octet-3 of the subnet address.
Example : 10

integer(int32)

addr4
required

Octet-4 of the subnet address.
Example : 0

integer(int32)

awsSubnetId
required

ID of the Subnet which is created in AWS Cloud.
Example : "18772"

string

city
optional

City of the location.

string

cloudProviderId
optional

ID of the Cloud Provider.

integer(int32)

cloudProviderName
required

Name of the cloud provider associated to subnet.
Example : "DDS_Cloud"

string

commandId
optional

string

contact_name
optional

Name of the contact.

string

country
optional

County of the location.

string

createRevZone
optional

Auto create reverse zone for a subnet
Example : "Yes/No"

string

created_by_login_name
optional

Login name of the user who created the subnet.

string

created_by_name
optional

Login name of the user who created the subnet.

string

created_time
optional

Date and Time of creation of the subnet.

string(date-time)

created_time_string
optional

String instance of the created time.

string

description
optional

Description of the subnet.

string

dhcpFailoverPeer
required

DHCP failover peer name
Example : "nusartx-dp"

string

dhcp_object_count
optional

integer(int64)

discoveryApplianceIp
optional

string

discoveryTemplateId
required

Id of the Discovery Template defined in the organization which is associated with the specified Network.
Example : 41010

integer(int32)

discovery_template
required

Name of the Discovery Template defined in the organization which is associated with the specified Network.
Example : "DiscoveryTemp1"

string

dmzVisible
required

Specifies whether the zone which is associated with the Network is a Demilitarized Zone(DMZ) or not.
Example : "Yes/No"

string

dns_appliances
optional

Comma separated list of DNS Server IP Address.
Example : "1.2.3.4,2.3.5.6"

string

dnssec_enable
required

Specifies whether Domain Name System Security Extensions(DNSSEC) enabled or not for the zone associated with the specified Network.
Example : "Yes/No"

string

domain_id
optional

Database Id of the primary domain of the subnet.

integer(int32)

email_id
optional

Email id of the contact.

string

enable_discovery
required

Specifies whether discovery is enabled or not for the specified Network.
Example : "Yes/No"

string

end_addr_val
optional

End address of the subnet.

integer(int64)

extensions
optional

List of DNS views applicable to this subnet

< Xtn NVP > array

first_name
optional

First name of the contact.

string

fullAddress
required

Full Address of the subnet.
Example : "10.1.10.185/24"

string

id
optional

Database ID of the subnet.

integer(int32)

last_name
optional

Last name of the contact.

string

location_name
optional

Name of the location.

string

mask_length
required

Mask Length of the subnet.
Example : 32

integer(int32)

middle_name
optional

Middle name of the contact.

string

monitoringService
required

Specifies whether the zone to be monitored or not.
Example : "Yes/No"

string

name
optional

Name of the subnet.

string

network_address
required

Address of the network to which the subnet belongs.
Example : "10.0.0.0"

string

network_id
optional

Database ID of the network.

integer(int32)

network_mask
optional

Mask Length of the network.
Example : 32

integer(int32)

network_name
optional

Name of the network.

string

nsec_option
required

Takes NSEC or NSEC3 when Domain Name System Security Extensions(DNSSEC) is enabled for the zone which is associated with the specific Network.
Example : "NSEC/NSEC3"

string

object_count
optional

Total number of objects defined in the subnet.

integer(int64)

organization_name
required

Name of the organization.
Example : "TCPWave"

string

percent_full
optional

Capacity full of the subnet in percentage.

number(double)

primary_dhcp_server
optional

Name of the primary DHCP Appliance.

string

primary_dhcp_server_address
optional

Address of the primary DHCP Appliance.

string

primary_domain
optional

Name of the Primary domain of the subnet.

string

quickAddress
optional

Quick address is Subnet Address concatenated with the mask length for quick search of Subnet.

string

reclaim_objects
required

Specifies whether to auto-reclaim DHCP leases for specified subnet.
Example : "Yes/No"

string

region
optional

string

routerAddress
required

Address of the primary router.
Example : "10.10.0.1"

string

routerIP
optional

string

router_name
required

Name of the primary router.
Example : "Router-1"

string

router_option
required

Selection option for the primary router - can be either the first IP in the subnet or the last IP in the subnet.
Example : "First IP in the subnet"

string

schedule_job_id
required

ID of the schedule job which is created in subnet schedule reclaim.
Example : "Rest_800"

string

schedule_reclaim
required

Specifies whether to schedule-reclaim for specified subnet.
Example : "Yes/No"

string

secondaryDomains
optional

List of secondary Domains

< string > array

serialFormat
required

Serial Number format of the zone which is associated with the specified Network.
Example : "NODATE/DATE"

string

server_id
optional

Database ID of the DHCP Appliance.

integer(int32)

sharedNetwork
optional

Name of the shared network.
Example : "shared_network2"

string

split_mask_length
required

Desired mask length to split a subnet.
Example : 16

integer(int32)

start_addr_val
optional

Start address of the subnet.

integer(int64)

state
optional

State - of the location.

string

street1
optional

Street 1 of the location.

string

street2
optional

Street 2 of the location.

string

subnetTemplateName
optional

Name of the subnet template for the specified subnet.
Example : "SubnetTemplate"

string

subnet_group_id
optional

Database ID of the subnet group.

integer(int32)

subnet_group_name
required

Name of the subnet group associated to the subnet.

string

template_id
optional

Database ID of the DHCP Option Template.

integer(int32)

template_name
optional

Name of the DHCP Option Template.

string

updated_by_login_name
optional

Login name of the user who updated the subnet.

string

updated_by_name
optional

Login name of the user who updated the subnet.

string

updated_time
optional

Date and Time of updating the subnet.

string(date-time)

updated_time_string
optional

String instance of the updated time.

string

viewList
optional

List of DNS views applicable to this subnet.

< DNS View > array

vlan_id
optional

VLAN ID of the subnet.

string

vrf_name
optional

Name of the Virtual routing and forwarding.
Example : "network4_vrf"

string

zip
optional

Zip code of the location.

string

zoneTemplateId
required

Id of the Zone Template defined in the zone which is associated with the specified Network.
Example : 41010

integer(int32)

zoneTemplateName
required

Name of the Zone Template defined in the zone which is associated with the specified Network.
Example : "ZoneTemp1"

string

5.427. Subnet Template

This class represents a subnet template that can be used during creation of a subnet.

Name Description Schema

addressAllocationList
optional

ArrayList of address ranges with object related details.

< Address Allocation > array

city
optional

City of the location.

string

cloudProvider
required

Name of cloud provider used for subnet.
Example : "testAWS"

string

cloudProviderId
optional

Id of cloud provider used for subnet.
Example : 1

integer(int32)

contact_email_id
optional

Email of the contact

string

contact_id
optional

ID of the contact

integer(int32)

contact_name
optional

Name of the contact

string

country
optional

County of the location.

string

createdBy
optional

UserId of user who created the specific subnet template.
Example : 1234

integer(int32)

createdByUser
optional

Name of user who created the specific subnet template.
Example : "admin"

string

createdTime
optional

Subnet template creation time.
Example : "03/18/2022 4:37"

string(date-time)

description
optional

Description of subnet template.

string

dhcpFailoverPeer
required

DHCP failover peer name
Example : "nusartx-dp"

string

dhcpOptionTemplateId
optional

Id of the DHCP Option Template used for the subnet.
Example : 1

integer(int32)

dhcpOptionTemplateName
required

Name of the DHCP Option Template used for the subnet.
Example : "Template1"

string

dhcpServerAddress
required

IP address of the DHCP Server used for the subnet.
Example : "192.0.0.32"

string

dhcpServerId
required

Id of the DHCP Server used for the subnet.
Example : 1

integer(int32)

dhcpServerName
required

Name of the DHCP Server used for the subnet.
Example : "DHCPAppliance1"

string

discovery_template
required

Name of the Discovery Template defined in the organization which is associated with the specified Network.
Example : "DiscoveryTemp1"

string

dns_appliances
optional

string

enable_discovery
required

Specifies whether discovery is enabled or not for the specified Network.
Example : "Yes/No"

string

first_name
optional

First name of the contact

string

id
optional

Id of the specified subnet template.
Example : 1

integer(int32)

last_name
optional

Last name of the contact

string

location_name
optional

Name of the location.

string

middle_name
optional

Middle name of the contact

string

name
required

Name of the specified subnet template.
Example : "test_template1"

string

oldName
required

Old name of the specified subnet template.
Example : "test_template1"

string

organizationId
optional

Id of an organization to which the specified subnet template is associated with.
Example : 1

integer(int32)

organizationName
required

Name of an organization to which the specified subnet template is associated with.
Example : "Internal"

string

primaryDomain
required

Name of the primary domain of the subnet.
Example : "tcpwave.com"

string

primaryDomainId
optional

Id of the primary domain of the subnet.
Example : 1

integer(int32)

reclaim_objects
required

Specifies whether to auto-reclaim DHCP leases for specified subnet.
Example : "Yes/No"

string

routerOption
required

Offset number for router object (first/last/10).
Example : "first"

string

secondaryDomains
optional

List of secondary Domains

< string > array

sharedNetwork
optional

Name of the shared network.
Example : "shared_network2"

string

sharedNetworkID
optional

integer(int32)

state
optional

State - of the location.

string

street1
optional

Street 1 of the location.

string

street2
optional

Street 2 of the location.

string

subnetType
required

Subnet type (Non-DHCP, DHCP-Enabled, Cloud-Hosted).
Example : 1

integer(int32)

subnet_group_id
optional

Database ID of the subnet group.

integer(int32)

subnet_group_name
required

Name of the subnet group associated to the subnet.

string

updatedBy
optional

UserId of user who updated the specific subnet template.
Example : 1234

integer(int32)

updatedByUser
optional

Name of user who updated the specific subnet template.
Example : "admin"

string

updatedTime
optional

Subnet template updated time.
Example : "03/18/2022 4:37"

string(date-time)

vlan_id
optional

VLAN ID of the subnet.

string

vrf_name
optional

Name of the Virtual routing and forwarding.
Example : "network4_vrf"

string

zip
optional

Zip code of the location.

string

5.428. SubnetViews

Name Description Schema

view_name
optional

Name of the View.
Example : "internal"

string

5.429. Switch Details

This class represents switch details which include IP Address, Description, Up time, Contact, Name, Location, Discovery Command ID etc.

Name Description Schema

cmdId
required

Command ID
Example : 23

integer(int32)

commandId
optional

string

discoveredBy
required

The user who submitted the discovery command.
Example : "sadm"

string

discoveredElements
required

Discovered Element

integer(int32)

elementPort
optional

string

elementVlan
optional

string

endTime
required

End Time

string

ifNumber
required

Interface number
Example : "001"

string

ipAddress
required

IP address
Example : "10.2.2.3"

string

mac
required

Mac address

string

neighborIp
optional

string

organizationName
optional

string

platform
optional

Platform

string

startTime
required

Start Time

string

subnetIP
required

Subnet IP

string

sysContact
required

Contact
Example : "John"

string

sysDesc
required

Description

string

sysLocation
required

Location
Example : "TCPWave"

string

sysName
required

Name
Example : "Switch"

string

sysUpTime
required

Switch uptime
Example : "2hrs"

string

vendor
optional

Vendor

string

version
optional

Version
Example : "5"

string

5.430. Switch Element Details

This class represents the IP Address, Mac Address, Port, Vlan and Switch IP details of a device connected to a Switch.

Name Description Schema

commandId
optional

string

ipAddress
required

IP address
Example : "10.0.0.0"

string

lastSeen
required

Last seen

string

macAddress
required

Mac address

string

portDesc
required

Port description

string

portID
required

Port ID

string

portName
required

Port name

string

switchIP
required

Switch IP

string

uptime
required

Up time

string

vlanID
required

Vlan ID

string

vlanName
required

Vlan Name

string

5.431. Switch Neighbor

This class represents a discovery switch neighbor

Name Description Schema

capabilities
optional

string

chassis_id
optional

string

commandId
optional

string

id
optional

integer(int64)

local_interface
optional

string

management_ip
optional

string

neighbor
optional

string

neighbor_interface
optional

string

neighbor_port_id
optional

string

protocol
optional

string

serial
optional

string

switch_ip
optional

string

system_description
optional

string

vlan
optional

string

5.432. Switch VLAN Subnet Element Details

This class represents the IP Address, Mac Address, Port, Vlan and Switch IP details of a device connected to a Switch.

Name Description Schema

commandId
optional

string

description
required

Description
Example : "32"

string

ipAddress
required

IP address
Example : "10.0.0.0"

string

lastSeen
required

Last seen

string

macAddress
required

Mac address

string

maskLength
required

Subnet Mask Length
Example : 32

integer(int32)

name
optional

string

portDesc
required

Port description

string

portName
required

Port name

string

subnetIP
required

Subnet IP Address
Example : "10.1.10.21"

string

switchIP
required

Switch IP

string

uptime
required

Up time

string

vlanName
required

Vlan Name

string

5.433. Syslog-ng configuration details

This class consolidates the details of the syslog-ng configuration.

Name Description Schema

destinationData
required

List of syslog-ng destinations.

< Syslog-ng destination details > array

filtersData
required

List of syslog-ng filters.

< Syslog-ng filter details > array

globalOptions
required

Syslog-ng global options.
Example : "timewaitdead"

string

sourcesData
required

List of syslog-ng sources.

< Syslog-ng source details > array

targetsData
required

List of syslog-ng targets.

< Syslog-ng target details > array

5.434. Syslog-ng destination details

This class consolidates the details of the syslog-ng destinations.

Name Description Schema

logDestGivenValSNG
required

Value of the syslog-ng destination.
Example : "/var/log/messages"

string

name
required

Syslog-ng destination name.
Example : "d_msg"

string

syncAfterEachMsg
required

Sync destination on receiving each message or not?
Example : false

boolean

typeSNG
required

Syslog-ng destination type.
Example : "File"

string

5.435. Syslog-ng filter details

This class consolidates the details of the syslog-ng filters.

Name Description Schema

category
required

Syslog-ng filter category.
Example : "complex"

string

condition
required

Syslog-ng filter condition.
Example : "facility(kern)"

string

name
required

Syslog-ng filter name.
Example : "f_kernel"

string

5.436. Syslog-ng source details

This class consolidates the details of the syslog-ng sources.

Name Description Schema

allSources
required

List of source options specified in the syslog-ng source.

< Syslog-ng source details > array

name
required

Syslog-ng source name.
Example : "s_sys"

string

sourceTypes
required

Types of source options specified in the syslog-ng source.
Example : "internal, system"

string

5.437. Syslog-ng target details

This class consolidates the details of the syslog-ng targets.

Name Description Schema

filter
required

Syslog-ng filter specified in the target.
Example : "f_kernel"

string

logdestination
required

Syslog-ng destination specified in the target.
Example : "d_msg"

string

source
required

Syslog-ng source specified in the target.
Example : "s_sys"

string

5.438. TIMS Object

TIMSObject class encapsulates the attributes that are defined at the Object level, such as the name, IP address, Description, DHCP Profile, DNS Resource Records, DDNS preferences etc.

Name Description Schema

addedRRs
required

Array List of RRs which are added to an object.

< Resource Record > array

addr1
required

Octet-1 of the IP Address

integer(int32)

addr2
required

Octet-2 of the IP Address

integer(int32)

addr3
required

Octet-3 of the IP Address

integer(int32)

addr4
required

Octet-4 of the IP Address

integer(int32)

address
required

IP Address of the object
Example : "172.16.13.5"

string

alias
optional

Alias name of the Object
Example : "zxcvb"

string

alloc_type
required

Allocation type for this object
Example : "Static/Manual/Dynamic/Reserved etc"

integer(int32)

alloc_type_desc
required

Object allocation type
Example : "Static/Dynamic/Manual/Auto/Reserved"

string

allowClassesArray
optional

List of DHCP Classes applicable to this object

< string > array

change_control_team
optional

Details of the change control team

string

city
optional

City of the location
Example : "zxcv"

string

class_code
required

Object type/Class code of the object

string

client_hostname
required

Host name of this object
Example : "abcd"

string

cloudAttributes
optional

Cloud Attributes

< string, string > map

cloudExtensions
optional

Cloud Extensions

< Xtn NVP > array

contact_email_id
optional

Email address of the object
Example : "[email protected]"

string

contact_first_name
optional

First name of the contact

string

contact_last_name
optional

Last name of the contact

string

contact_middle_name
optional

Middle name of the contact

string

contact_name
optional

Contact name

string

country
optional

Country of the location
Example : "xyza"

string

created_by_login_name
optional

Name of the user who created this object
Example : "John"

string

created_by_name
optional

Name of the user who created this object
Example : "John"

string

created_time_string
optional

String instance of the created time

string

deletedRRs
required

Array List of RRs which are deleted from the object.

< Resource Record > array

denyClassesArray
optional

List of denied DHCP Classes for this object

< string > array

description
optional

Description for this object

string

dhcp_server
optional

DHCP Appliance associated to this Object

string

domain_name
required

Name of the domain associated with this object
Example : "domain.com"

string

dyn_update_rrs_a
required

Dynamic update DNS with A Resource Records
Example : false

boolean

dyn_update_rrs_cname
required

Dynamic update DNS with CNAME Resource Records

boolean

dyn_update_rrs_mx
required

Dynamic update DNS with MX Resource Records

boolean

dyn_update_rrs_ptr
required

Dynamic update DNS with PTR Resource Records

boolean

end_of_life
optional

End of life of this object
Example : "2022-03-14 06:58:42"

string

ends
optional

Lease end time of a DHCP object
Example : "2022-03-01 03:04:09"

string

extensions
optional

< Xtn NVP > array

floor
optional

Floor (placement) of this object

string

ip_address
required

IP Address of this object
Example : "172.16.13.1"

string

ipv6Address
optional

string

isDeleterrsChecked
required

Delete resource record references.
Example : "0 or 1"

integer(int32)

isRenew
optional

string

last_seen
optional

Last seen of object
Example : "2022-03-14 06:58:42"

string(date-time)

last_seen_string
optional

Last seen of object
Example : "2022-03-14 06:58:42"

string

location_name
optional

Name of the location
Example : "abcdef"

string

mac
optional

MAC Address of this object
Example : "aa:bb:cc:ddd:ee:ff"

string

mac_address
optional

MAC Address of this object
Example : "aa:bb:cc:dd:ee:ff"

string

managed_by
optional

Name of user who manages this object
Example : "admin"

string

model_type
optional

Model type of this object

string

monitored_by
optional

Name of the user who manages this object
Example : "admin"

string

name
optional

Name of the object
Example : "timsobject"

string

network_address
optional

Network Address
Example : "172.16.13.0"

string

noOfAssociation
optional

integer(int32)

operation
optional

Mode of operation
Example : "add/edit/delete"

string

option_template_name
optional

Name of the DHCP option template
Example : "dhcp_option"

string

organization_name
required

Name of the organization associated with this object
Example : "Internal"

string

region
optional

string

room
optional

Room (placement) of this object

string

rrs
optional

Collection of Resource Records associated to this object

< Resource Record > array

rrsXML
optional

string

serial_num
optional

Serial Number of this object

string

starts
optional

Lease start time of a DHCP object
Example : "2022-03-01 02:59:09"

string

state
optional

State of the location
Example : "asdf"

string

street1
optional

Street-1 of the location
Example : "abc"

string

street2
optional

Street-2 of the location
Example : "def"

string

subnet_address
required

Subnet address to which the object belongs to
Example : "10.0.0.0/24"

string

switchName
optional

Switch name
Example : "switch1"

string

terminal_server_kvm
optional

Terminal Server for this object

string

ttl
optional

Time to live for this object
Example : 1200

integer(int32)

update_ns_a
required

Dynamic update DNS with the A records

boolean

update_ns_ptr
required

Dynamic update DNS with PTR records

boolean

updated_by_login_name
optional

Name of the user who updated this object
Example : "John"

string

updated_by_name
optional

Name of the user who updated this object
Example : "qwert"

string

updated_time
optional

Updated time of the object
Example : "12:10:50 11-28-2018"

string(date-time)

updated_time_string
optional

String instance of the updated time

string

v6_Id
optional

integer(int32)

viewList
optional

< DNS View > array

viewName
optional

DNS View applicable to this object
Example : "viewname"

string

zip
optional

Zip code of the location
Example : "50000"

string

5.439. Tag

Name Description Schema

key
optional

string

value
optional

string

5.440. Template

This class represents a Template and contains the attributes necessary for Template management functionality in the TCPWave IPAM. The information includes the Entity Type, Server Type, Param Name, Param Value and other Template related information.

Name Description Schema

aclList
required

Array list of Access Control List(ACL) for the specified Template.

< Access Control List(ACL) > array

array_params
required

Collection of DHCP Parameters

< Parameters Information > array

array_templates
optional

Collection of DHCP Templates

< Template > array

code
optional

Category of the DHCP Template. Specifies if its Policy Template/Option Template

string

cookieSecret
optional

Generated random key which will be taken as cookie in the global options section of named.conf
Example : "X634555"

string

created_by
required

Id of the User who has created the specified Template.
Example : 2017

integer(int32)

created_by_login_name
optional

The User’s name, who has logged into the TCPWave IPAM, has been set as Created By for the specified Template.
Example : "Stephen"

string

created_by_name
optional

Name of the User who has created the specified Template.
Example : "Stephen"

string

created_time
optional

The instant when the specified Template has been created.
Example : "03/18/2022 3:39"

string(date-time)

created_time_string
optional

String format of the time when the specified Template has been created.
Example : "03/18/2022 3:39"

string

customAcls
optional

DNS custom ACLs List

string

data_type
required

Data Type of a parameter associated with the specified Template.

string

deletedCustomAcls
optional

string

description
optional

Description of the specified Template.
Example : "Zone Template Definition For Corp’s External DNS Zones"

string

display_name
optional

Display name of a parameter associated with the specified Template.

string

entity_type_code
required

Type Code of the entity which is associated with the specified Template.
Example : "ZONE"

string

entity_type_id
required

Id of the Entity Type which is associated with the specified Template.
Example : 61

integer(int32)

external_dns_appliance_algo
optional

External DNS appliance algorithm

string

external_dns_appliance_secret
optional

External DNS appliance secret

string

geoPath
optional

string

max_value
required

Maximum Value of a parameter associated with the specified Template.

integer(int32)

min_value
required

Minimum Value of a parameter associated with the specified Template.

integer(int32)

numeric_value
required

Numeric Value of a parameter associated with the specified Template.

integer(int32)

old_template_name
required

Name of the specified template before modification.
Example : "Corp. IDNS Zone Template"

string

organization_id
required

Id of the Organization associated with the specified Template.
Example : 990

integer(int32)

organization_name
required

Name of the Organization associated with the specified Template.
Example : "EARTH"

string

param_id
required

Parameter Id for the specified Template.

integer(int32)

param_name
required

Parameter Name for the specified Template.

string

server_type_code
required

Type Code of the server which is associated with the specified Template.
Example : "BIND CACHE"

string

server_type_id
required

Id of the server which is associated with the specified Template.
Example : 70

integer(int32)

tempInfo
optional

Template information

< Template information > array

template_id
required

Id of the specified Template.
Example : 41230

integer(int32)

template_name
required

Name of the specified Template.
Example : "Corp. EDNS Zone Template"

string

updated_by
required

Id of the User who has modified the specified Template.
Example : 2019

integer(int32)

updated_by_login_name
optional

The User’s name, who has logged into the TCPWave IPAM, has been set as Updated By for the specified Template.
Example : "John"

string

updated_by_name
optional

Name of the User who has modified the specified Template.
Example : "John"

string

updated_time
optional

The time instance when the specified Template has been modified.
Example : "03/18/2022 4:37"

string(date-time)

updated_time_string
optional

String format of the time when the specified Template has been modified.
Example : "03/18/2022 4:37"

string

user_defined
optional

This will specify whether the parameter defined in the template is a user defined param or not.
Example : "Y or N"

string

user_text
optional

User defined text for the template.
Example : "allow-notify{localhost};"

string

valid_characters
optional

Valid characters of a parameter for the specified template.

string

valid_chars
optional

Valid chars for a parameter for the specified template.
Example : "Yes/No"

integer(int32)

value
required

Value of a parameter associated with the specified Template.

string

valueAsString
optional

Template parameter value as a string.
Example : "1200 or localhost"

string

5.441. Template References Information

Template References Information class encapsulates template name, id , organization name and the count of subnets/appliances associated with the template.

Type : object

5.442. Template References To Be Deleted

This class represents the request to delete the discovery template references from networks and subnets.

Name Description Schema

addressList
required

List of network or subnet addresses from which discovery template reference has to be removed.

< string > array

organizationName
required

Name of the organization to which these networks and subnets are associated with.
Example : "Internal"

string

templateName
required

Name of the discovery template which is assigned to these networks and subnets.
Example : "Discovery template1"

string

type
required

Type of component(Network/Subnet) from which reference has to be removed.
Example : "Network"

string

5.443. Template Selection Data

This class holds dropdown information of templates. This class is used for Internal calls in the TCPWave IPAM.

Name Description Schema

template_id
optional

integer(int32)

template_name
optional

string

5.444. Template information

Template information class provides the details of DNS cookie parameters.

Name Description Schema

cookie_secret_key
optional

Generated random key which will be taken as cookie in the global options section of named.conf
Example : "X634555"

string

tempDesc
optional

Template description
Example : "test"

string

templates
optional

Template

< Template > array

5.445. Time Zone

This class specifies the Time Zone of DNS and DHCP Appliances defined in the TCPWave IPAM.

Name Description Schema

name
required

Name of the time zone corresponding to a given DNS/DHCP Appliance
Example : "America/Merida (Central Time Campeche, Yucatan)"

string

5.446. Tims Scheduled Job Information

This class represents information of a Scheduled Job in TCPWave IPAM. This class is used for internal calls in TCPWave IPAM.

Name Description Schema

createdBy
optional

Login ID of the user who created the schedule job
Example : 2226

integer(int32)

createdByName
optional

User name who created the entity
Example : "Smith"

string

createdTime
optional

Date and Time of creation of the entity
Example : "3/18/2016 4:37"

string(date-time)

description
optional

string

endDate
required

End date
Example : "4/18/2022 4:37"

string(date-time)

endDateString
required

End date
Example : "3/18/2017 4:50"

string

id
required

Database Id of the scheduled job
Example : 101

integer(int32)

jobData
optional

string

jobId
optional

string

jobType
optional

string

jobpaused
required

Scheduled job status

integer(int32)

operation
required

Operation type
Example : "Add"

string

repeatCount
optional

integer(int32)

repeatInterval
optional

integer(int64)

repeatIntervalString
required

Scheduled job repeat interval

string

runDay
optional

integer(int32)

runDayDisplayString
required

Job execution day

string

runTimeString
required

Execution Time

string

scheduleType
optional

string

startDate
required

Start date
Example : "3/18/2022 4:37"

string(date-time)

startDateString
required

Start date
Example : "3/18/2016 4:50"

string

sysjob
required

Database job Id
Example : 112

integer(int32)

target_instance
required

Target Instance
Example : "Object"

string

updatedBy
optional

Login ID of the user who updated the schedule job
Example : 2226

integer(int32)

updatedByName
optional

Database ID of the user who updated the entity

string

updatedTime
optional

Date and time of updating the entity
Example : "5/18/2016 4:37"

string(date-time)

5.447. TitanEndUserSecurity

Name Description Schema

dbstoreString
optional

string

enabled
optional

boolean

expDate
optional

string(date-time)

expDateString
optional

string

expDays
optional

integer(int32)

feedType
optional

integer(int32)

5.448. Top Ten Element

This class represents top ten subnets of a network. This class is used for internal calls in the TCPWave IPAM.

Name Description Schema

name
required

Name

string

percent
required

Percentage

number(double)

5.449. Top talker

Fetches the toptalker information for DNS/DHCP Appliances defined in the TCPWave IPAM

Name Description Schema

clientName
required

Get the hostname of Client
Example : "hostname"

string

count
optional

integer(int32)

date
required

Get date of top talker received
Example : "2022-01-18 16:11:30"

string

domain
optional

string

end_time
optional

string

interval
optional

string

ip
required

Get the IP address of DNS/DHCP Appliance
Example : "10.1.2.36"

string

name
required

Get the name of DNS/DHCP server
Example : "nusax"

string

record_type
optional

string

start_time
optional

string

topTalker
required

Get the client IP Address
Example : "10.1.1.35"

string

type
required

Get the type of DNS/DHCP server
Example : "DHCP"

string

5.450. Tree Node

An internal class that is used to hold the bookmarks information for display in the TCPWave IPAM GUI screens.

Name Description Schema

queryString
optional

Query String of URI

string

5.451. Undo Data

This class contains the data for undoing a delete operation in the TCPWave IPAM.

Name Description Schema

change_ticket
optional

Change Ticket value
Example : "235"

string

description
optional

Description of the undo element
Example : "Modified name"

string

id
optional

ID of the undo data instance
Example : 121

integer(int32)

operation
optional

Mode of operation
Example : "add/delete"

string

organization_name
optional

Organization name of undo element
Example : "Internal"

string

status
optional

Status of the undo operation
Example : 1

integer(int32)

status_string
optional

Status of the undo operation

string

updated_by_login_name
required

Name of the user who updated the undo element
Example : "Stephen"

string

updated_time
optional

The time instance at which the undo element has been modified.
Example : "01/18/2022 4:37"

string(date-time)

updated_time_string
optional

String format of the updated time of the undo element.
Example : "01/18/2022 4:37"

string

5.452. User

This class contains user information related to an Admin. The information includes the first and last names, email address, phone number, role, and the status - if password expired or account locked, and how many failed attempts to login, the admin groups associated with the user, and extensions.

Name Description Schema

account_locked
required

If account is locked or not.
Example : false

boolean

adminId
required

ID of the Admin.
Example : 2024

integer(int32)

admin_group_name
optional

Admin Group Name
Example : "King"

string

admin_groups
optional

Admin Group(s) associated with the User.

< Admin Group > array

admin_image
optional

Base64 string value of an image

string

admin_permissionsList
optional

Admin Permissions List

< Permission > array

admin_roles
optional

< AdministratorRoles > array

allowed_function
optional

< string > array

createdBy
optional

integer(int32)

createdByUser
optional

string

createdTime
optional

string(date-time)

created_by_name
optional

Name of Admin who has added the User.

string

created_time
required

Time when User has been created.
Example : "01/01/2022 0:09"

string(date-time)

created_time_string
required

Date and Time when User has been created.
Example : "2022-02-12 07:35:43.0"

string

email_id
optional

Email ID of the User.
Example : "[email protected]"

string

extensions
optional

Extended Attribute Values

< Xtn NVP > array

failed_attempts
required

Count failed login attempts.
Example : 3

integer(int32)

fileName
optional

File name of an image
Example : "admin.png"

string

first_name
required

First Name of the current logged in User.
Example : "tango"

string

id
optional

ID of the current logged in User.
Example : 34

integer(int32)

isAdmin
required

If current User is Admin. (true/false)
Example : true

boolean

last_change_time
optional

Time when User Information were last time changed.

string(date-time)

last_login
required

Time when User was last time logged-in.
Example : "01/14/2022"

string(date-time)

last_name
optional

Last Name of the current logged in User.
Example : "charli"

string

login_name
required

Login Name of the User.
Example : "NewRADM"

string

login_name_of_cloned_user
optional

string

middle_name
required

Middle Name of the current logged in User.
Example : "chaplin"

string

new_email_id
optional

Updated Email Id of the User.
Example : "[email protected]"

string

new_first_name
optional

Updated first name of the User.
Example : "Denial"

string

new_is_admin
optional

If User is Admin or not.
Example : true

boolean

new_last_name
optional

Updated last name of the User.
Example : "shawn"

string

new_login_name
optional

Updated Login Name.
Example : "Denial11"

string

new_middle_name
optional

Updated middle name of the User.
Example : "smith"

string

organizationListString
optional

string

organization_id
required

ID of the Organization with which User is associated.
Example : 2

integer(int32)

organization_name
required

Name of the Organization with which User is associated.
Example : "TCPWave"

string

password_expired
required

If password is expired or not.
Example : false

boolean

phone_num
optional

Phone Number of the User.
Example : "7878989888"

string

rolesMap
optional

< string, < string > array > map

roles_code
required

Code for the User Role. (e.g. FADM/SADM/RADM)
Example : "RADM"

string

roles_id
required

Role of the User. (e.g. FADM/SADM/RADM)
Example : "RADM"

integer(int32)

roles_name
optional

Modified User Role.
Example : "RADM"

string

updatedBy
optional

integer(int32)

updatedByUser
optional

string

updatedTime
optional

string(date-time)

updated_by_name
optional

Name of Admin who has updated the User.

string

updated_time
required

Time when User has been updated.
Example : "02/04/2022 0:11"

string(date-time)

updated_time_string
required

Date and Time when User has been updated.
Example : "01/03/2022 0:55"

string

userRolesForAllOrgs
optional

< string > array

5.453. User Certificate

This class represents the Client side certificate information that is used by the TCPWave IPAM to allow session less secure REST API invocation for integrating with automation flows and third party tools. The information includes the certificate details, validity, and associated admin information. This certificate is imported to TCPWave IPAM using the provided GUI and CLI. The REST API calls made with this mechanism are subjected to the same authorization as the associated admin and are audited against that admin.

Name Description Schema

associated_user
optional

Database ID of the user associated with the user certificate
Example : 1226

integer(int32)

associated_user_name
optional

Name of the user associated with the user certificate
Example : "Smith"

string

id
optional

Database Id of the user certificate
Example : 123

integer(int32)

imported_by
optional

Database ID of the user who imported the user certificate
Example : 1553

integer(int32)

imported_by_name
optional

Name of the user who imported the user certificate
Example : "Adam"

string

imported_time
optional

Time at which the certificate is imported
Example : "5/18/2016 4:37"

string(date-time)

issuer
optional

Name of the user certificate issuer

string

name
required

User certificate name
Example : "user_cert1"

string

owner
optional

Name of the user certificate owner
Example : "Jhon"

string

serial_num
required

User certificate serial number
Example : "12345"

string

valid_from
required

Validity start date of the message certificate.
Example : "03/18/2022"

string

valid_to
required

Validity end date of the message certificate.
Example : "03/18/2022"

string

5.454. User Permission

This class represents a privilege associated with the admin. The information includes the entity type, resource instance information, if it is inherited permission by virtue of being associated with an admin group, and who granted the privilege, etc.

Name Description Schema

admin_admin_groups
required

Admin groups with which user is associated.
Example : "group1,group2,group3"

string

admin_name
required

Admin name

string

admin_role
required

Admin Role
Example : "Functional Admin"

string

created_by
optional

User Id

integer(int32)

created_by_user
optional

User name

string

created_time
optional

Creation time

string(date-time)

created_time_string
optional

Creation time as String

string

function_id
optional

integer(int32)

function_name
optional

string

id
optional

Admin ID

integer(int32)

level
required

Level of permission
Example : "Network/Subnet/Object/Domain/Subnet Group etc."

string

privilege
required

Type of privilege
Example : "READ/READ-WRITE"

string

privilegeCode
required

Integer value for the privilege
Example : "4 = READ; 6 = READ-WRITE"

integer(int32)

role_function_id
optional

integer(int32)

subnet_within_sgroup
required

Subnet within the subnet group, to which the target user have permissions.

< string > array

target
required

Target Value
Example : "10.0.0.0/24"

string

target_address
optional

Address of the target

string

target_description
required

Description of the target

string

target_name
optional

Name or value of the target
Example : "[\"10.1.0.0/16\"]"

string

type
required

Type of the target
Example : "Network/Subnet/Object"

string

5.455. UserDashboards

Name Description Schema

configList
optional

string

dashboardName
optional

string

list
optional

List of all dashboards

< Dashboard > array

position
optional

string

selectedDashWidgets
optional

List of widgets of selected/default dashboard.

< DashboardWidget > array

5.456. UserIdGroupPair

Name Description Schema

description
optional

string

groupId
optional

string

groupName
optional

string

peeringStatus
optional

string

userId
optional

string

vpcId
optional

string

vpcPeeringConnectionId
optional

string

5.457. Utility Bean

This class encapsulate the information, that is fetch from Azure provider.

Name Description Schema

additionalDetails
optional

Encapsulates information of region, instance etc.

string

description
optional

Description of Azure provider

string

name
optional

Name of Azure provider

string

5.458. V6IPAMAppliance

Name Description Schema

applianceGroups
optional

< Appliance Group > array

applianceGroupsStr
optional

string

created_by
required

IPAM appliance created by user Id
Example : 1219

integer(int32)

created_by_name
optional

IPAM appliance created by user name
Example : "twcuser"

string

created_time
optional

IPAM appliance created time stamp
Example : "1222221231"

string(date-time)

description
optional

IPAM appliance description
Example : "This is a IPAM appliance."

string

domain_id
optional

Domain Id
Example : 15

integer(int32)

domain_name
required

Domain name
Example : "tcpwave.com"

string

firewall_template
optional

Firewall template of the IPAM appliance
Example : "Firewall_Template"

string

firewall_template_id
optional

Template ID of Firewall template
Example : 15

integer(int32)

id
optional

IPAM Appliance ID
Example : 12

integer(int32)

ipamTemplate
optional

Template name of IPAM appliance

V6IPAMTemplate

isAlive
required

Is secure communication establish or not
Example : false

boolean

isClusterIPAM
optional

Is the IPAM appliance part of the HA or DR cluster or not?
Example : "true/false"

string

isHost
optional

Is IPAM appliance local host or not?
Example : false

boolean

lastSyncTime
optional

Last sync time of the IPAM appliance
Example : "05:21:35 02-01-2022"

string

mgmtIP
optional

IP address of management or primary network interface, that is used to connect to IPAM.
Example : "192.168.0.45"

string

name
required

Object name of the TCPWave IPAM type object or IPAM appliance name
Example : "test"

string

nicsConfig
optional

Details of network interface

NICConfig

object_id
optional

Object ID of the TCPWave IPAM type object
Example : 15

integer(int32)

old_firewall_template
optional

string

old_v4_ipaddress
required

Object IPv4 old address of the TCPWave IPAM type object
Example : "10.12.1.2"

string

old_v6_ipaddress
optional

string

oldtimeZone
optional

Old Time Zone of the IPAM appliance
Example : "GMT"

string

organization_id
optional

Organization Id
Example : 15

integer(int32)

organization_name
optional

Organization Name
Example : "Internal"

string

rtTablesJson
optional

RtTables information JSON string
Example : "[{\"port\":\"255\",\"name\":\"local\"},{\"port\":\"254\",\"name\":\"main\"},{\"port\":\"253\",\"name\":\"default\"},{\"port\":\"0\",\"name\":\"unspec\"}]"

string

snmpAcl
optional

Acl Name
Example : "TestAcl"

string

snmpAcl_id
optional

Acl Id
Example : 123

integer(int32)

sysLogs
optional

Syslog-ng configuration object
Example : "{\"globalOptions\":\"{\\\"timewaitdead\\\":\\\"70\\\",\\\"timetoidle\\\":\\\"78\\\",\\\"messagetoBuffer\\\":\\\"60\\\",\\\"twstatic\\\":\\\"600\\\",\\\"noofMsg\\\":\\\"1000\\\",\\\"maxSize\\\":\\\"65536\\\",\\\"logtime\\\":\\\"true\\\"}\",\"sourcesData\":[{\"name\":\"s_sys\",\"allSources\":[{\"type\":\"internal\",\"filePath\":null,\"fileName\":null,\"address\":null,\"port\":null,\"protocol\":null},{\"type\":\"system\",\"filePath\":null,\"fileName\":null,\"address\":null,\"port\":null,\"protocol\":null}],\"sourceTypes\":\"internal, system\"}],\"filtersData\":[{\"name\":\"f_default\",\"condition\":\"level(info..emerg) and not (facility(mail) or facility(authpriv) or facility(cron))\",\"category\":\"complex\"}],\"destinationData\":[{\"name\":\"d_mesg\",\"typeSNG\":\"File\",\"logDestGivenValSNG\":\"/var/log/messages\",\"syncAfterEachMsg\":false}],\"targetsData\":[{\"source\":\"s_sys\",\"logdestination\":\"d_mesg\",\"filter\":\"f_default\"}]}"

string

timeZone
optional

Time Zone of the IPAM appliance
Example : "GMT"

string

updated_by
optional

IPAM appliance updated by user Id
Example : 1219

integer(int32)

updated_by_name
optional

IPAM appliance updated by user name
Example : "twcuser"

string

updated_time
optional

IPAM appliance updated time stamp
Example : "1222221231"

string(date-time)

v4_ipaddress
required

Object IPv4 address of the TCPWave IPAM type object
Example : "10.12.1.2"

string

v6_ipaddress
optional

Object IPv6 address of the TCPWave IPAM type object
Example : "1000::"

string

5.459. V6IPAMServicesInfo

Name Description Schema

appliances
optional

List of IPAM appliances and their services.

< IPAMServices > array

operation
optional

Operation type
Example : "start/stop/restart/rebuild"

string

operationMethod
optional

Operation method
Example : "sequential/simultaneous"

string

schedTime
optional

Operation schedule time
Example : "2022-03-07 16:22:00"

string

services
optional

Comma separated services
Example : "ntpd,sshd,snmpd,cliserver"

string

5.460. V6IPAMTemplate

Name Description Schema

applianceType
optional

IPAM appliance type
Example : "development"

string

banner
optional

IPAM appliance banner text
Example : "This is a banner."

string

banner_color
optional

IPAM appliance banner text color
Example : "red"

string

created_by
required

IPAM appliance template created by user Id
Example : 1219

integer(int32)

created_by_name
optional

IPAM appliance template created by user name
Example : "twcuser"

string

created_time
optional

IPAM appliance template created time stamp
Example : "1222221231"

string(date-time)

description
optional

IPAM appliance template description
Example : "This is a test template."

string

dnsResolverConfig
required

IPAM appliance template DNSResolver configuration JSON string
Example : "{\"ns1\":\"10.2.1.21\",\"ns2\":\"\",\"ns3\":\"\",\"ns4\":\"\",\"search1\":\"\",\"search2\":\"\",\"search3\":\"\",\"search4\":\"\",\"search5\":\"\",\"search6\":\"\"}"

string

elevatedPrivilegesConfig
optional

Elevated Privileges Configuration Details
Example : "{\"environmentVariables\":[{\"value\":\"Defaults always_query_group_plugin\"}],\"userAliases\":[{\"user_alias_name\":\"USER_ALIAS_1\",\"user_alias_value\":\"testuser\"}],\"hostAliases\":[{\"host_alias_name\":\"HOST_ALIAS_1\",\"host_alias_value\":\"192.168.0.139\"}],\"runasAliases\":[{\"runas_alias_name\":\"RUNAS_ALIAS_1\",\"runas_alias_value\":\"user2\"}],\"commandAliases\":[{\"command_alias_name\":\"COMMAND_ALIAS_1\",\"command_alias_value\":\"/cp\"}],\"userSpecifications\":[{\"user_alias\":\"USER_ALIAS_1\",\"host_alias\":\"HOST_ALIAS_1\",\"runas_alias\":\"RUNAS_ALIAS_1\",\"runas_group_alias\":\"\",\"command_alias\":\"COMMAND_ALIAS_1\",\"taglist\":\"\"}]}"

string

elevatedPrivilegesJson
optional

Elevated Privileges Configuration JSON String
Example : "{\"environmentVariables\":[{\"value\":\"Defaults always_query_group_plugin\"}],\"userAliases\":[{\"user_alias_name\":\"USER_ALIAS_1\",\"user_alias_value\":\"testuser\"}],\"hostAliases\":[{\"host_alias_name\":\"HOST_ALIAS_1\",\"host_alias_value\":\"192.168.0.139\"}],\"runasAliases\":[{\"runas_alias_name\":\"RUNAS_ALIAS_1\",\"runas_alias_value\":\"user2\"}],\"commandAliases\":[{\"command_alias_name\":\"COMMAND_ALIAS_1\",\"command_alias_value\":\"/cp\"}],\"userSpecifications\":[{\"user_alias\":\"USER_ALIAS_1\",\"host_alias\":\"HOST_ALIAS_1\",\"runas_alias\":\"RUNAS_ALIAS_1\",\"runas_group_alias\":\"\",\"command_alias\":\"COMMAND_ALIAS_1\",\"taglist\":\"\"}]}"

string

enableSNMPv3
required

Specifies whether SNMPv3 is enabled or not on the IPAM.
Example : true

boolean

id
optional

IPAM appliance template Id
Example : 15

integer(int32)

idracConfig
optional

IPAM appliance template iDrac configuration JSON string
Example : "{\"password\":\"\",\"address\":\"\",\"enable\":\"\",\"snmp_community_string\":\"\"}"

string

ldapSSHConfig
optional

LDAP_SSH Configuration JSON String
Example : "{\"enable\":false}"

string

log_file_size
optional

IPAM appliance template, log file size
Example : "5MB"

integer(int32)

name
optional

IPAM appliance template name
Example : "test"

string

no_of_backup_log_files
optional

IPAM appliance template, no of backup log files
Example : 5

integer(int32)

ntpConfig
required

Comma separated NTP appliances of IPAM appliance template
Example : "10.2.2.1,10.2.21.1"

string

oldName
required

IPAM appliance template old name
Example : "test"

string

organization
required

Organization name
Example : "Internal"

string

organization_id
optional

Organization Id
Example : 2121

integer(int32)

rootConfig
optional

IPAM appliance template Root password
Example : "abc"

string

snmpConfig
required

IPAM appliance template SNMP configuration JSON string
Example : "{\"systemLocation\":\"\",\"processes\":\"ntpd-1/snmpd-0/crond-0/sshd-0/de-1/cli-0/search-1/tims-0/timsscheduler-0/mysql-0\",\"trapSink2\":\"10.2.2.43\",\"communityString\":\"8DE1BF9E2B9819A3\",\"trapSink1\":\"10.2.1.122\",\"systemContact\":\"\",\"sendToThirdParty\":\"yes\"}"

string

snmpv3Users
required

Specifies list of SNMPv3 users.

string

ssh_banner
optional

IPAM appliance SSH banner text
Example : "This is a SSH banner."

string

sysLogNgConfig
optional

Syslog-ng configuration object

Syslog-ng configuration details

sysLogsConfig
optional

Syslog-ng configuration object
Example : "{\"globalOptions\":\"{\\\"timewaitdead\\\":\\\"70\\\",\\\"timetoidle\\\":\\\"78\\\",\\\"messagetoBuffer\\\":\\\"60\\\",\\\"twstatic\\\":\\\"600\\\",\\\"noofMsg\\\":\\\"1000\\\",\\\"maxSize\\\":\\\"65536\\\",\\\"logtime\\\":\\\"true\\\"}\",\"sourcesData\":[{\"name\":\"s_sys\",\"allSources\":[{\"type\":\"internal\",\"filePath\":null,\"fileName\":null,\"address\":null,\"port\":null,\"protocol\":null},{\"type\":\"system\",\"filePath\":null,\"fileName\":null,\"address\":null,\"port\":null,\"protocol\":null}],\"sourceTypes\":\"internal, system\"}],\"filtersData\":[{\"name\":\"f_default\",\"condition\":\"level(info..emerg) and not (facility(mail) or facility(authpriv) or facility(cron))\",\"category\":\"complex\"}],\"destinationData\":[{\"name\":\"d_mesg\",\"typeSNG\":\"File\",\"logDestGivenValSNG\":\"/var/log/messages\",\"syncAfterEachMsg\":false}],\"targetsData\":[{\"source\":\"s_sys\",\"logdestination\":\"d_mesg\",\"filter\":\"f_default\"}]}"

string

systemResources
required

Specifies system resource option values

string

tacacsConfig
required

IPAM appliance template TACACS configuration JSON string
Example : "{\"appliance\":\"\",\"enable\":false,\"pass_key\":\"\"}"

string

updated_by
optional

IPAM appliance template updated by user Id
Example : 1219

integer(int32)

updated_by_name
optional

IPAM appliance template updated by user name
Example : "twcuser"

string

updated_time
optional

IPAM appliance template updated time stamp
Example : "1222221231"

string(date-time)

5.461. VMWare Authentication Type

This class represents the authorization type for a VMWare in the TCPWave IPAM.

Name Description Schema

id
required

ID of the VMWare appliance
Example : 54567

integer(int32)

type
required

Type of the VMWare appliance
Example : "TCP-VMWare"

string

5.462. VMWare Discovery Element Details

This class represents the name, IP Address, Mask, domain, contact, location, description, VRF etc., details of a device connected to a VMWare.

Name Description Schema

aton_address
optional

integer(int64)

commandId
optional

string

description
optional

string

device
optional

string

domainName
optional

string

ip_address
optional

string

last_seen
optional

string

latency
optional

string

mac
optional

string

name
optional

string

organizationName
optional

string

os
optional

string

ports
optional

string

status
optional

string

vendor
optional

string

vmwareIp
optional

string

5.463. VMWareAuthenticationSource

Name Description Schema

authType
optional

string

authTypeId
optional

integer(int32)

desc
optional

string

host
optional

string

id
optional

integer(int32)

ignoreCerts
optional

boolean

objectIPType
optional

string

objectId
optional

integer(int32)

orgId
optional

integer(int32)

orgName
optional

string

password
optional

string

port
optional

integer(int32)

ssoHost
optional

string

ssoPort
optional

integer(int32)

userId
optional

integer(int32)

userName
optional

string

5.464. VRF

Name Description Schema

commandId
optional

string

created_by
optional

Database ID of the user who created this entity

integer(int32)

created_by_login_name
optional

Login name of the user who created this entity

string

created_by_name
required

Login name of the user who created this entity

string

created_time
required

Date and Time of creation of the entity

string(date-time)

created_time_string
optional

String instance of the Date and Time

string

description
optional

string

firewallIp
optional

Firewall IP Address
Example : "10.1.10.250"

string

id
optional

integer(int32)

name
optional

string

organization_id
optional

integer(int32)

organization_name
optional

string

organization_name_readonly
optional

string

route_distinguisher
optional

string

route_target_export
optional

string

route_target_import
optional

string

routerIp
optional

string

updated_by
optional

Database ID of the user who updated this entity

integer(int32)

updated_by_login_name
optional

Login name of the user who updated this entity

string

updated_by_name
required

Login name of the user who updated this entity

string

updated_time
optional

Date and Time of updating the entity

string(date-time)

updated_time_string
required

String instance of the Date and Time

string

vrf_interface
optional

string

5.465. VRRP Details

This class contains information related to VRRP screen.

Name Description Schema

global_defs
optional

VRRPGlobalDefinition

vrrpInstanceName
optional

string

vrrpInstanceSubnet
optional

string

vrrpVirtualIPAddress
optional

string

vrrp_instance
optional

< VRRPInstance > array

5.466. VRRPGlobalDefinition

Name Description Schema

notification_email
optional

< string > array

notification_email_from
optional

string

smtp_connect_timeout
optional

string

smtp_server
optional

string

5.467. VRRPInstance

Name Description Schema

vrrpAdvertInt
optional

integer(int32)

vrrpApplianceIP
optional

string

vrrpApplianceInterface
optional

string

vrrpAppliancePriority
optional

string

vrrpInstanceState
optional

string

vrrpVirtualRouterId
optional

integer(int32)

5.468. Vault Type

This class represents the vault type details which include ID and Name.

Name Description Schema

id
optional

ID
Example : 101

integer(int32)

name
required

Name
Example : "Native"

string

5.469. Vlan Details

This class represents vlan details which include index, switch Ip, name, status, port names and type. This class is used for internal calls in the TCPWave IPAM.

Name Description Schema

commandId
optional

string

ifIndex
optional

Interface index
Example : "1"

string

index
optional

Vlan Index
Example : "2"

string

name
optional

Vlan name

string

portNames
optional

Port Names

< string > array

port_names
optional

string

status
optional

Vlan Status
Example : "Up"

string

switchIP
optional

Switch IP
Example : "10.2.3.4"

string

type
optional

Vlan Type
Example : "Data"

string

5.470. Vlan Subnet Details

This class represents vlan subnet details which include name, subnet Ip, mask, description. This class is used for internal calls in the TCPWave IPAM.

Name Description Schema

commandId
optional

string

description
optional

string

domain_name
optional

string

id
optional

integer(int64)

ipVersion
optional

integer(int32)

isAccepted
optional

integer(int32)

organization_name
optional

string

send_to_ipam
optional

boolean

sent_status
optional

boolean

subnetIP
optional

string

subnetMask
optional

string

subnetMaskLength
optional

integer(int32)

switchIp
optional

string

vlanId
optional

string

vlanInterface
optional

string

vlanName
optional

string

5.471. Whitelist and Blacklist domain

This class represents a domain which can be used as whitelist or blacklist domain for anomaly detection.

Name Description Schema

category
required

Category of domain.
Example : "Whitelist"

string

id
required

ID of domain.

integer(int32)

name
required

Name of domain.
Example : "tcpwave.com"

string

oldName
required

Name of old domain.
Example : "abc.com"

string

5.472. Widget Card

Widget card class encapsulates the information about a widget to be displayed on Dashboard or not.

Name Description Schema

category
optional

Category of the widget
Example : "Dashboard"

string

name
optional

Name of the widget
Example : "Health Index Score"

string

status
optional

Visibility status of the widget
Example : false

boolean

5.473. Xtn Attribute

This is an extensible attribute containing information like type and entity that it is applicable to. This class is used for internal calls in the TCPWave IPAM.

Name Description Schema

created_by
optional

Created by
Example : "admin"

string

created_time
optional

Created time
Example : "1484204472000"

string(date-time)

created_time_string
optional

Created time string
Example : "20:52:53 01-23-2022"

string

description
optional

Description of the Extensible Attribute
Example : "testing extended attribute"

string

entities
optional

Array list of Extensible Entities

< Xtn Entity > array

entities_added
optional

Added Entities

< Xtn Entity > array

entities_deleted
optional

Deleted Entities

< Xtn Entity > array

entities_modified
optional

Modified Entities

< Xtn Entity > array

flag
optional

enum (CLOUD)

flagInt
optional

integer(int32)

high
optional

High

integer(int32)

id
optional

ID of the Extensible Attribute
Example : 8

integer(int32)

inheritance
required

Inheritance Of Extensible Attribute
Example : "Yes/No"

string

is_unique
optional

unique attribute
Example : false

boolean

list_values
optional

List of Values
Example : "Windows, Linux, Android"

string

low
optional

Low

integer(int32)

mandatory
required

If Extensible Attribute is mandatory
Example : false

boolean

name
required

Name of the Extensible Attribute
Example : "admin"

string

new_name
optional

New Name
Example : "CHK_TKT"

string

regex_values
optional

Regular expression to validate extended attribute.
Example : "^[ A-Za-z0-9_@.\\/#+-:]*$"

string

show_on_grid
optional

show attribute on grid
Example : false

boolean

updated_by
optional

updated by
Example : "admin"

string

updated_time
optional

updated time
Example : "1481205110000"

string(date-time)

updated_time_string
optional

Updated time string
Example : "05:03:20 01-30-2022"

string

xtn_type
required

Type of the Extensible Attribute
Example : "String/Numeric/IP"

string

5.474. Xtn Entity

This class holds list of extensible attributes for a given entity like Network, Subnet, Object, Admin and Zone. This class is used for internal calls in the TCPWave IPAM.

Name Description Schema

attrib
required

Array of Extensible Entities

< Xtn Attribute > array

name
required

Extensible Entities Name assigned with Extensible Attribute
Example : "Admin"

string

show_on_grid
optional

Show Extensible Entity on grid
Example : false

boolean

5.475. Xtn NVP

This class holds name value pair corresponding to an Extensible attribute. This class is used for internal calls in the TCPWave IPAM.

Name Description Schema

name
required

Extensible attribute name
Example : "RITS_ID-1"

string

value
required

Extensible attribute value
Example : "Admin/Network/Subnet"

string

5.476. XtnData

Name Description Schema

key
optional

string

type
optional

string

values
optional

< Xtn NVP > array

5.477. XtnResponse

Name Description Schema

entity
optional

string

key
optional

string

name
optional

string

organization
optional

string

value
optional

string

5.478. Zone

This class represents a Zone and contains the attributes necessary for Zone management functionality in the TCPWave IPAM. The information includes the Zone Name, Template Name, Zone Resource Record List, Domain Controller(DC) Object List and other Zone related information.

Name Description Schema

activeDirectoryEnable
required

Takes Yes/No value to specify whether a zone is an Active Directory Enabled or not.
Example : "No"

string

activeServers
optional

List of remote servers where zone is active.
Example : "[email protected]@-found"

string

adScavengCheckInterval
optional

Active Directory Scavenging check time interval for a zone.
Example : 7

integer(int32)

adScavengingEnable
optional

Enable Active Directory Scavenging on a zone.
Example : "yes"

string

addedARRs
optional

< CloudRR > array

addedRRs
required

Array List of RRs which are added to a zone.

< Resource Record > array

childDcAclNames
optional

Array list of Domain Controller Access Control List(ACL) names of a zone child forest.

< string > array

childRevZones
optional

Child Reverse Zones Information.

< Child Reverse Zone > array

contact_id
optional

ID of the contact

integer(int32)

contact_name
optional

Name of the contact

string

created_by
optional

Id of a user who created the zone.
Example : 1

integer(int32)

created_by_login_name
optional

Login Name of a user who created a zone.
Example : "admin"

string

created_by_name
optional

Name of the user who created the zone.
Example : "User1"

string

created_time
optional

Zone creation time.
Example : "01/20/2022"

string(date-time)

created_time_string
optional

Created time of a zone in String format.
Example : "01/20/2022 6:57"

string

dcAclIds
required

Array list of Domain Controller(DC) Access Control List(ACL) Ids of a zone.

< integer(int32) > array

dcAclNames
required

Array list of Domain Controller Access Control List(ACL) names of a zone.

< string > array

dcObjectAddresses
required

Array list of Domain Controller Object Addresses of a zone.

< string > array

dcObjectIds
required

An array list of Domain Controller Object Ids of an Active Directory Enabled zone.

< integer(int32) > array

dcStatusCheckInterval
optional

Domain Controller status check time interval for a zone.
Example : 3

integer(int32)

dcV6ObjectAddresses
optional

< string > array

dcV6ObjectIds
optional

< integer(int32) > array

default_ttl
optional

Default Time To Live(TTL) of a zone.
Example : 84200

integer(int32)

deletedARRs
optional

< CloudRR > array

deletedRRs
required

Array List of RRs which are deleted from the zone.

< Resource Record > array

description
optional

Description of a zone.
Example : "This zone is created by the TCPWave Inc."

string

dmzVisible
required

Takes Yes/No value to specify whether the zone is a Demilitarized Zone(DMZ) or not.
Example : "No"

string

dnssec_enable
required

Takes Yes/No value to specify whether the zone is a DNSSEC enabled or not.
Example : "Yes"

string

email_addr
optional

Email Id in the zone.
Example : "[email protected]"

string

email_id
optional

Email id of the contact

string

extensions
optional

Array List of RRs which are added to a zone.

< Xtn NVP > array

first_name
optional

First name of the contact

string

forestType
optional

Takes 0 or 1 value to specify active directory zone forest type. 0-parent, 1-child.
Example : 0

integer(int32)

id
optional

ID of a zone.
Example : 1

integer(int32)

importCloudRR
optional

Flag to import cloud DNS resource records while creating a DNS zone.
Example : false

boolean

inActiveServers
optional

List of remote servers where zone is not active.
Example : "[email protected]@-found"

string

isActive
optional

Takes 0 or 1 to specify whether the zone is active or not on remotes
Example : 0

integer(int32)

isFrozen
optional

Zone is frozen or thawed.
Example : "Frozen"

string

is_tsig
optional

Non Managed Name Server is secured with TSIG key or not
Example : "1/0"

integer(int32)

lastUpdatedStatus
optional

Last status updated time of a zone.
Example : "01/28/2022"

string(date-time)

lastUpdatedStatusString
optional

Last status updated time in String format of a zone.
Example : "01/28/2022 10:59"

string

last_name
optional

Last name of the contact

string

middle_name
optional

Middle name of the contact

string

mirroredZones
optional

List of the mirrored zones for the zone.
Example : "mirror.com,mir.com,etc.com"

string

monitoringService
required

Takes Yes/No value to specify whether zone is Monitoring Enabled or not.
Example : "Yes"

string

name
required

Name of a zone.
Example : "tcpwave.com"

string

networkAddress
optional

Reverse zone network full address.
Example : "192.168.0.0"

string

networkMask
optional

Reverse zone network mask length.
Example : 24

integer(int32)

nonManagedNSTSIGKeys
required

Array list of TSIG key names for non managed secondaries zone transfer.

< string > array

nsec_option
required

Takes NSEC/NSEC3 value when DNSSEC is enabled for a zone.
Example : "NSEC3"

string

old_name
optional

Old name of a zone.
Example : "tcpwave.com"

string

organization_id
optional

Organization ID of a zone.
Example : 1

integer(int32)

organization_name
required

Organization Name of zone.
Example : "TCPWave"

string

overRideMS
optional

Defines whether to override the Microsoft DNS Appliance with the IPAM zone or not
Example : false

boolean

parentDcAclNames
optional

Array list of Domain Controller Access Control List(ACL) names of a zone parent forest.

< string > array

parentForestName
optional

Name of the active directory parent forest.
Example : "_tcp.tcpwave.com"

string

proxy
required

Takes 0 or 1 value to specify whether the zone is a Proxy Root Zone or not.
Example : 0

integer(int32)

restrictedZone
required

Takes Yes/No value to specify whether the zone is a restricted zone or not.
Example : "Yes"

string

revZoneParentId
optional

integer(int32)

rrSetOrderList
optional

Array list of rrset-order preferences for the specified zone.

< RRSet Order > array

secureActiveDirectoryEnable
required

Takes Yes/No value to specify whether zone is a Secure Active Directory Enabled or not.
Example : "No"

string

serial_format
required

Serial Number format of a zone. It takes DATE/NODATE
Example : "DATE"

string

serial_number
required

Serial Number of a zone.
Example : 2016102800

integer(int64)

template_id
optional

Zone Template Id of a zone.
Example : 1

integer(int32)

template_name
required

Zone Template Name of a zone.
Example : "Zone Template1"

string

updateSubZone
required

Defines whether to update the sub zones or not
Example : false

boolean

updated_by
optional

Id of a user who updated the zone last time.
Example : 1

integer(int32)

updated_by_login_name
optional

Login Name of a user who updated a zone.
Example : "admin"

string

updated_by_name
optional

Name of the user who updated the zone last time.
Example : "User1"

string

updated_time
optional

Last updated time of a zone.
Example : "01/20/2022"

string(date-time)

updated_time_string
optional

Updated time of a zone in String format.
Example : "01/20/2022 6:57"

string

viewList
required

Array list of view which are associated with a zone

< DNS View > array

windowsADIntegrated
optional

Takes Yes/No value to specify whether a zone is a Microsoft Active Directory Integrated or not.
Example : "No"

string

zoneRR
required

Array list of RR objects of a zone.

< Resource Record > array

zoneScopeList
optional

Array list of zone scope names.

< ZoneScope > array

5.479. Zone Force Sync

This class represents a Zone and contains the attributes necessary for Zone Force Sync functionality in the TCPWave IPAM. The information includes the Zone Name & Appliance List.

Name Description Schema

name
required

Name of a zone.
Example : "tcpwave.com"

string

serversInfo
required

Array list of Zone Force SyncInfo objects of a zone that contains the Appliance ip, Appliance name and other sync related information.

< Zone Sync Information > array

5.480. Zone Statistics for Charting

Fetches the top ten zones in the TCPWave IPAM.

Name Description Schema

zone_count
required

Get zone count
Example : 24

integer(int64)

zone_name
required

Get zone name
Example : "nusax.com"

string

5.481. Zone Sync Information

ZoneForceSyncInfo bean class encapsulates the attributes of a generic Appliance. This class represents properties like Appliance ip, Appliance name and other information related to Zone Sync.

Name Description Schema

isSyncSuccess
optional

States if zone sync is successful or not.
Example : false

boolean

serverIP
required

IPV4 Address which is associated with the specified Appliance.
Example : "192.1.10.200"

string

serverName
required

Name of a DNS Appliance.
Example : "nusartx-est015-sl09113"

string

5.482. ZoneScope

Name Description Schema

created_by
required

Id of the User who has created the specified Zone Scope.
Example : 2017

integer(int32)

created_by_name
optional

The User’s name, who has logged into the TCPWave IPAM, has been set as Created By for the specified Zone Scope.
Example : "Stephen"

string

created_time
optional

The time instance when the specified Zone Scope has been created.
Example : "03/01/2022 3:39"

string(date-time)

created_time_string
optional

String format of the time when the specified zone scope has been created.
Example : "03/01/2022 3:39"

string

description
optional

Description of the Specified Zone Scope.
Example : "This is the sample description"

string

id
optional

Id of the specified Zone Scope.
Example : 1201

integer(int32)

name
required

Name of the specified Zone Scope.
Example : "BasicScope"

string

old_name
optional

Old Name of the specified Zone Scope.
Example : "OldPolicy"

string

organization_id
optional

Id of the Organization which is associated to the specified Zone Scope.
Example : 1200

integer(int32)

organization_name
required

Name of the Organization which is associated to the specified Zone Scope.
Example : "EARTH"

string

policies
optional

Policy names which are associated with the Specified Zone Scope.
Example : "Internal,1;Moscow,2"

string

updated_by
required

Id of the User who has modified the specified Zone Scope.
Example : 2019

integer(int32)

updated_by_name
optional

The User’s name, who has logged into the TCPWave IPAM, has been set as modified By for the specified Zone Scope.
Example : "Stephen"

string

updated_time
optional

The time instance when the specified Zone Scope has been modified.
Example : "03/01/2022 4:37"

string(date-time)

updated_time_string
optional

String format of the time when the specified zone scope has been modified.
Example : "03/01/2022 4:37"

string

zone_id
optional

Id of the zone for which the specified Zone Scope has been associated.
Example : 1201

integer(int32)

zone_name
required

Zone Name for which the specified Zone Scope has been associated.
Example : "zone.com"

string

6. TCPWave IPAM Error Codes

Error Codes

1020

TIMS-1020: The organization name and the id cannot be null.

1021

TIMS-1021: The organization name is not valid: {0}

1022

TIMS-1022: The admin role is not valid: {0}

1023

TIMS-1023: The host does not exist. Provide the correct hostname or IP address.

1024

TIMS-1024: Failed to delete the object(s) as {0} is the primary router of the subnet.

1025

TIMS-1025: The organization id is not valid: {0}

1026

TIMS-1026: The user already exists.

1027

TIMS-1027: The timestamp is null.

1028

TIMS-1028: The name of this object conflicts with an existing Active Directory enabled zone name. Try with a different name.

1029

TIMS-1029: The owner name of the resource record conflicts with an existing Active Directory enabled zone name. Try with a different name.

1030

TIMS-1030: The Domain Controller object type cannot be changed as it is used in an ACL: {0}.

1031

TIMS-1031: The Domain Controller object type cannot be changed as it is associated with the AD zone.

1042

TIMS-1042: This action can cause a severe impact on the system performance. Try creating subnets of a relatively smaller mask length.

1043

TIMS-1043: Enter a valid number for {0}. The value should be between {1} and {2}.

1048

TIMS-1048: Enter a valid Interface of 20 characters.

1050

TIMS-1050: Enter a valid string for {0}.

1051

TIMS-1051: Enter a valid value. The accepted characters are a-z, A-Z, 0-9, :, ., -, _ and space.

1052

TIMS-1052: Enter a valid {0}.

1053

TIMS-1053: Enter a valid string for {0}. The value should be between {1} and {2} characters.

1054

TIMS-1054: Enter a valid string for {0}. The accepted characters are a-z, A-Z, 0-9, :, ., *, -, _ and space.

1055

TIMS-1055: An invalid entity type was specified.

1056

TIMS-1056: Enter a valid string for {0}. The accepted strings are auth, authpriv, cron, daemon, kern, lpr, mail, mark, news, Syslog, user, uucp, local0, local1, local2, local3, local4, local5, local6, local7.

1057

TIMS-1057: An invalid data was specified for the MX resource record. The valid format for the MX data is " ".

1058

TIMS-1058: An invalid data was specified for the resource record. Enter the valid data.

1059

TIMS-1059: An invalid class was specified for the resource record. The valid class value is IN.

1060

TIMS-1060: Enter a valid string for {0}. The accepted characters are a-z, A-Z, and 0-9.

1061

TIMS-1061: Enter a valid number for {0}.

1062

TIMS-1062: Enter a valid character for {0}. Accepted characters are {1} and {2}.

1063

TIMS-1063: Enter a valid hexadecimal string for {0}.

1064

TIMS-1064: Enter a valid value. The accepted characters are a-z, A-Z, 0-9, _, @, ., *, #, +, -, :, /, %, (, ) and space.

1065

TIMS-1065: Enter a valid file path. The accepted file paths are {0}.

1066

TIMS-1066: Enter a valid string for login name {0}.

1080

TIMS-1080: The page number is not specified.

1081

TIMS-1081: The page size is not specified.

1082

TIMS-1082: The page number is not valid: {0}

1083

TIMS-1083: The page number exceeds available pages: {0}

1084

TIMS-1084: The job start time cannot be in the past. Select a valid time.

1085

TIMS-1085: The job end time cannot be earlier than the job start time.

1086

TIMS-1086: Select a subnet to delete.

1087

TIMS-1087: Select a subnet to modify.

1088

TIMS-1088: Enter valid values for syslog entry.

1089

TIMS-1089: Restrict the file path to {0}.

1103

TIMS-1103: The organization with the same name: {0} already exists.

1104

TIMS-1104: The target name and id cannot be null.

1122

TIMS-1122: Delete dependent or child network elements and retry.

1123

TIMS-1123: Could not find unused addresses within the specified subnet.

1124

TIMS-1124: Start IP address and the organization name are mandatory to determine the next available free range.

1140

TIMS-1140: The admin group id and name cannot be null.

1141

TIMS-1141: The admin group does not exist: {0}

1142

TIMS-1142: The admin group does not exist.

1143

TIMS-1143: The admin group cannot be deleted as it is associated with existing Admins.

1144

TIMS-1144: Select an admin group to modify.

1145

TIMS-1145: Select an admin group to delete.

1146

TIMS-1146: Select admins to remove from the admin group.

1147

TIMS-1147: Select at least one admin to remove from the admin group.

1148

TIMS-1148: The zone {0} cannot be deleted as a managed DNS remote {1} full configuration synchronization is in process, try after DNS full sync.

1149

TIMS-1149: The debug preference should be either yes or no.

1150

TIMS-1150: The option name " {0} " contains a whitespace. Enter a name without a space.

1151

TIMS-1151: The option name {0} already exists.

1152

TIMS-1152: {0} contains only digits. Enter at least one character.

1153

TIMS-1153: {0} should not contain special character. Enter a valid name.

1161

TIMS-1161: The admin group name cannot be null or empty.

1200

TIMS-1200: The active directory zone cannot be deleted.

1201

TIMS-1201: {0}

1202

TIMS-1202: The contact does not exist: {0}

1203

TIMS-1203: Select an active directory user principal (UPN) name to delete.

1204

TIMS-1204: The email address is not valid: {0}

1205

TIMS-1205: Select an active directory user principal name to delete.

1207

TIMS-1207: Select an active directory user principal name (UPN) for authentication.

1208

TIMS-1208: No user selected for authentication.

1209

TIMS-1209: The Active Directory enabled zone(s) cannot be deleted.

1210

TIMS-1210: The Active Directory enabled zone cannot be modified.

1211

TIMS-1211: Unable to generate the DNSViz HTML from the DNSSEC enabled zone: {0} on the DNS cache appliance: {1}. Check the IPAM logs.

1212

TIMS-1212: Unable to generate the DNSViz PNG from the DNSSEC enabled zone: {0} on the DNS cache appliance: {1}. Check the IPAM logs.

1213

TIMS-1213: Unable to generate the DNSViz Text from the DNSSEC enabled zone: {0} on the given DNS cache appliance: {1}. Check the IPAM logs.

1214

TIMS-1214: Cannot delete the GSS-TSIG principle as secure active directory update is enabled on the zone: {0}.

1215

TIMS-1215: Cannot delete the network as one or more domain controller objects are associated with the active directory enabled zone(s).

1216

TIMS-1216: Cannot delete the subnet(s) as one or more domain controller objects are associated with the active directory enabled zone(s).

1222

TIMS-1222: Delete dependent/child network elements and retry.

1255

TIMS-1255: The Scopes cannot exceed a maximum size of 4096, as it may impact the system performance.

1256

TIMS-1256: The scope already exists for this object range: {0}

1257

TIMS-1257: The object address range overlaps with an existing object address range.

1258

TIMS-1258: The object address range exceeds the subnet range.

1259

TIMS-1259: The object address range does not belong to any defined subnet or network.

1260

TIMS-1260: The object address range already has non-dynamic objects.

1261

TIMS-1261: The scope does not exist for the object range: {0}

1262

TIMS-1262: The subnet does not have a primary router defined, and the template has the option router defined as {0}.

1263

TIMS-1263: The subnet does not have a primary router: {0}

1264

TIMS-1264: The subnet mask of this subnet does not match with the subnet mask defined in the template.

1265

TIMS-1265: The router defined in this template {0} does not belong to this subnet.

1266

TIMS-1266: The option subnet mask for this template cannot be changed as it is associated with other subnets and DHCP Scopes.

1267

TIMS-1267: Enter a valid value for {0}.

1268

TIMS-1268: Static objects are defined at the resultant subnet and broadcast addresses.

1269

TIMS-1269: A router cannot be created with IP {0} as a static object already exists at this address.

1270

TIMS-1270: The subnet does not have {0} defined as a router as it is - in the DHCP Option Template.

1271

TIMS-1271: The subnet {0} is not associated to a DHCP template.

1272

TIMS-1272: Specify a valid range.

1273

TIMS-1273: Cannot create subnet(s) without a primary router.

1274

TIMS-1274: Select subnet(s) to create.

1278

TIMS-1278: Select a subnet to delete.

1279

TIMS-1279: Select a subnet to modify.

1280

TIMS-1280: Select a subnet to import from the cloud.

1281

TIMS-1281: The scope cannot be created as the specified range is invalid. Start IP {0} End IP {1}.

1282

TIMS-1282: The subnet address and id cannot be null.

1283

TIMS-1283: The end of life value {0} is not valid.

1284

TIMS-1284: An appliance already exists in another organization with the same IP address. Try to create an appliance using a different IP.

1285

TIMS-1285: The object cannot be added as the selected subnet is full.

1286

TIMS-1286: Delete operation for the zone {0} has failed because of references in the object definitions. Use the search functionality to obtain those references.

1287

TIMS-1287: Delete operation for the zone {0} has failed because of references in the subnet domain definitions. Use the search functionality to obtain those references.

1288

TIMS-1288: Delete operation for the zone {0} has failed because of references in the IPv6 subnet domain definitions. Use the search functionality to obtain those references.

1289

TIMS-1289: Cannot create the template as the following IP address(es) {0} are not defined as objects in the IPAM.

1290

TIMS-1290: Cannot update template as the following IP address(es) {0} are not defined as objects in the IPAM.

1291

TIMS-1291: The object delete has failed as the object(s) {0} are referred in the DHCP template(s): {1}.

1292

TIMS-1292: The lease object binding state cannot be null or empty.

1293

TIMS-1293: Given field name is not supported to search the data.

1294

TIMS-1294: Either field name or field key is mandatory if the search type is not a text.

1295

TIMS-1295: Text, Wildcard, Regex, and Match are the allowed search types.

1296

TIMS-1296: All, Logs and Tables are the allowed search categories.

1297

TIMS-1297: Enter a valid entity name. Ex: network, subnet, object, etc.

1298

TIMS-1298: Cannot delete the network as one or more domain controller objects are associated with Active Directory GSS-TSIG management. Delete the associated references and try again.

1299

TIMS-1299: Cannot delete the subnet(s) as one or more domain controller objects are associated with active directory GSS-TSIG management. Delete the associated references and try again.

1300

TIMS-1300: The domain already exists: {0}

1301

TIMS-1301: The channel name and id cannot be null.

1302

TIMS-1302: The log channel does not exist: {0}

1303

TIMS-1303: The special channel cannot be deleted: {0}

1304

TIMS-1304: The log channel already exists: {0}

1305

TIMS-1305: Cannot delete a Log channel: {0} as one or more DNS Appliances are using it.

1306

TIMS-1306: Selected domain(s) does(do) not exist.

1307

TIMS-1307: The root zone(s) does(do) not exist.

1308

TIMS-1308: The domains are referenced in the appliance. Delete those references and try again.

1309

TIMS-1309: The domains are referenced in objects. Delete those references and try again.

1310

TIMS-1310: The domains are referenced in subnets. Delete those references and try again.

1311

TIMS-1311: The domains are referenced in the subnet domain. Delete those references and try again.

1312

TIMS-1312: Duplicate entry for {0}

1313

TIMS-1313: Update dependent network elements referring to this domain and retry.

1314

TIMS-1314: The DNS appliance cannot be changed from authoritative to cache as zone templates are using it.

1315

TIMS-1315: The secure communication between IPAM and remote DNS Appliance{0} is not functioning. Ensure that the remote appliance is operational and check if a firewall is blocking communication.

1316

TIMS-1316: The last sync status is unavailable for the selected DNS Appliance. Check if the appliance is up and running.

1317

TIMS-1317: Some ACLs are referenced in appliance template(s). Delete those references and try again.

1318

TIMS-1318: The Internet Root Hints id and NS should not be null.

1319

TIMS-1319: The Internet Root Hints id cannot be found for given NS: {0}

1320

TIMS-1320: A domain with the given name already exists.

1321

TIMS-1321: The domain does not exist: {0}

1322

TIMS-1322: One or more appliances in the zone template are invalid.

1323

TIMS-1323: A contact with the given information already exists.

1324

TIMS-1324: The phone number is not valid.

1325

TIMS-1325: The zone delete operation has failed because of references in the object definitions. Use the search functionality to obtain those references.

1326

TIMS-1326: The zone delete operation has failed because of references in the subnet definitions. Use the search functionality to obtain those references.

1327

TIMS-1327: The zone delete operation has failed because of references in the subnet domain definitions. Use the search functionality to obtain those references.

1328

TIMS-1328: The zone name cannot be null.

1329

TIMS-1329: The zone delete operation has failed because of references in the IPv6 subnet domain definitions. Use the search functionality to obtain those references.

1330

TIMS-1330: The DNS Appliance cannot be deleted as it manages one or more zone templates.

1331

TIMS-1331: The root zone cannot be deleted as it is used by one or more DNS internal cache appliances.

1332

TIMS-1332: The ACL is referenced in one or more zone templates. Delete the references and retry.

1333

TIMS-1333: Update the dependent network elements referring to this contact and retry.

1334

TIMS-1334: Update the dependent network elements referring to this location and retry.

1335

TIMS-1335: The DNS internal cache appliance cannot be created as this organization has no root zone.

1336

TIMS-1336: The DNS appliance cannot be changed to the internal DNS cache appliance as there is no root zone defined or DMZ forwarders defined in this organization.

1337

TIMS-1337: The DNS appliance cannot be changed to NSD as one or more views are associated with this appliance.

1338

TIMS-1338: The zone stats query is already in progress. Try later.

1341

TIMS-1341: An organization with the given name already exists.

1342

TIMS-1342: The selected log channel is a special channel. Only version, size, and severity can be modified.

1347

TIMS-1347: Delete dependent network elements within this organization and retry.

1348

TIMS-1348: The secure communication between IPAM and remote DHCP Appliance is broken. Restart TIMS-DHCP on the DHCP Appliance: {0}.

1349

TIMS-1349: The DNS configuration sync failed with error: {0}

1350

TIMS-1350: An invalid DNS appliance {0} specified.

1351

TIMS-1351: The user Id cannot be null.

1352

TIMS-1352: The organization does not exist: {0}

1353

TIMS-1353: The organization not found: {0}

1354

TIMS-1354: The organization does not exist.

1355

TIMS-1355: The organization id is null.

1356

TIMS-1356: The zone already exists: {0}

1357

TIMS-1357: The location already exists for the organization: {0}

1358

TIMS-1358: The location already exists.

1359

TIMS-1359: Failed to get the log information from DHCP Appliance. Check if the appliance is up and running.

1360

TIMS-1360: No changes detected to update.

1368

TIMS-1368: The DHCP appliance cannot be deleted as it manages one or more subnets.

1369

TIMS-1369: The request has timed out from the DNS appliance.

1370

TIMS-1370: The request has timed out from the DHCP appliance.

1371

TIMS-1371: Select at least one master DNS Appliance.

1372

TIMS-1372: The DNS Appliance configuration for Appliance Name: {0}, IP Address: {1} has been created successfully.

1373

TIMS-1373: The DNS Appliance configuration for Appliance: {0}, IP: {1} has been modified successfully.

1374

TIMS-1374: The selected object type is not a TCPWave Remote. Choose a different object.

1375

TIMS-1375: Select a single server to clone.

1376

TIMS-1376: Select a server to clone.

1377

TIMS-1377: Select a single server to modify.

1378

TIMS-1378: Select a server to modify.

1379

TIMS-1379: Select a server to delete.

1380

TIMS-1380: Select a server to synchronize the configuration.

1381

TIMS-1381: Select a server to download the configuration.

1382

TIMS-1382: Select at least one process to be monitored using SNMP.

1383

TIMS-1383: Select a server to see the status.

1384

TIMS-1384: The system summary is applicable on a physical DNS or a DHCP appliance and when the IDRAC is configured and available. This option does not apply to remote DNS or DHCP appliances on a virtualized infrastructure.

1385

TIMS-1385: Failed to set the debug level for DNS Appliance. Check if the appliance is up and running.

1386

TIMS-1386: Select a valid domain from the given options.

1387

TIMS-1387: Select an SNMP process to be monitored.

1388

TIMS-1388: Select a server to generate configuration.

1389

TIMS-1389: Select a lease to be deleted.

1390

TIMS-1390: Select a single log channel to modify.

1391

TIMS-1391: The selected log channel is a special channel.

1392

TIMS-1392: Select a log channel to modify.

1393

TIMS-1393: The selected log channel is a special channel. It cannot be deleted.

1394

TIMS-1394: Select a log channel to delete.

1395

TIMS-1395: The DNS configuration update failed for the server(s): {0}

1396

TIMS-1396: The specified log channel is a special channel that already exists: {0}

1397

TIMS-1397: Specify valid filename without directory.

1398

TIMS-1398: Specify the iDRAC IP address and SNMP community string for monitoring.

1399

TIMS-1399: The domain controller does not exist: {0}

1400

TIMS-1400: The full sync for the {2} appliance {0} has failed due to the failure of pre {1} plugin execution.

1401

TIMS-1401: The full sync for the {2} appliance {0} has failed as the pre {1} plugin does not exist.

1403

TIMS-1403: The zone id cannot be null.

1404

TIMS-1404: The zone id is null: {0}

1405

TIMS-1405: The zone template does not exist.

1406

TIMS-1406: The zone(s) does(do) not exist.

1407

TIMS-1407: There are no Domain Controllers for the specified zone. Change Enable AD Updates to No and create a zone.

1408

TIMS-1408: The selected zone is an active directory enabled zone. Select at least one Domain Controller to manage this zone.

1409

TIMS-1409: Select a single zone to see the status of its DNS Appliances.

1410

TIMS-1410: Select a zone to see the SOA status on its DNS Appliances.

1411

TIMS-1411: Select at least one zone to force a sync with its master DNS Appliances.

1412

TIMS-1412: The selected zones contain active directory-enabled zones that cannot be deleted. Exclude them from the selection and retry.

1413

TIMS-1413: The selected zone is an active directory zone that cannot be modified/cloned/deleted. Select a non-active directory zone and retry.

1414

TIMS-1414: The type is not valid.

1415

TIMS-1415: The zone already exists: {0}

1416

TIMS-1416: The zone does not exist.

1417

TIMS-1417: The type is not valid: {0}

1418

TIMS-1418: Select Domain Controllers managing a parent zone of the selected zones.

1419

TIMS-1419: The selected zone is an active directory enabled zone. Select at least one ACL to manage this zone.

1420

TIMS-1420: A or CNAME {0} record already exists in Zone: {1}

1421

TIMS-1421: The domain name and id cannot be null.

1422

TIMS-1422: A managed zone does not exist with the name: {0}

1423

TIMS-1423: Selected zone template has one or more stealth appliances. AD-enabled zones should not contain any stealth appliances. Select a different zone template.

1424

TIMS-1424: The root zone already exists in the selected organization.

1425

TIMS-1425: The appliance id and IP address cannot be null.

1426

TIMS-1426: The DNS cache appliance does not exist.

1427

TIMS-1427: The forward only zone: {0} already exists in the DNS Appliance.

1428

TIMS-1428: The forward only zone: {0} does not exist.

1429

TIMS-1429: Cannot create a forward-only zone: {0} as IPAM already manages it.

1430

TIMS-1430: Cannot create a zone: {0} as a forward-only zone already exists with this name.

1431

TIMS-1431: Cannot create a domain: {0} as a forward-only zone already exists with this name.

1432

TIMS-1432: Select the domains to be added.

1433

TIMS-1433: Select the domains to be removed.

1434

TIMS-1434: No matching NS record found on the given proxy root appliance.

1435

TIMS-1435: NS record is referencing in the root zone. Delete the reference and try again.

1436

TIMS-1436: Cannot create a restricted zone: {0} as it is associated with one or more objects.

1437

TIMS-1437: Cannot create a restricted zone: {0} as it is associated with one or more resource records.

1438

TIMS-1438: Cannot change a zone: {0} to a restricted zone as it is associated with one or more objects.

1439

TIMS-1439: Cannot change a zone: {0} to a restricted zone as it is associated with one or more resource records.

1440

TIMS-1440: Cannot create a restricted zone: {0} as it is associated with one or more subnets as a primary domain.

1441

TIMS-1441: Cannot create a restricted zone: {0} as it is associated with one or more subnets as a secondary domain.

1442

TIMS-1442: Cannot change a zone: {0} to a restricted zone as it is associated with one or more subnets as a primary domain.

1443

TIMS-1443: Cannot change a zone: {0} to a restricted zone as it is associated with one or more subnets as a secondary domain.

1444

TIMS-1444: Cannot create a resource record as a restricted zone is defined with the name {0}.

1445

TIMS-1445: Cannot delete subnet(s) as one or more resource record references are associated with the objects defined in the subnet. Delete the references and try again.

1446

TIMS-1446: Cannot delete network(s) as one or more resource records are defined with the network(s) objects. Delete the references and try again.

1447

TIMS-1447: Cannot delete subnet(s) as one or more resource records are defined with the subnet(s) object level A Resource Records. Delete the references and try again.

1448

TIMS-1448: Cannot delete network(s) as one or more resource records are defined with the network(s) object level A Resource Records. Delete the references and try again.

1449

TIMS-1449: Cannot associate a restricted domain : {0} to the subnet.

1450

TIMS-1450: Enter a max of 255 characters for {0} field.

1451

TIMS-1451: Enter a max of 255 characters for zone name.

1452

TIMS-1452: Enter a max of 63 characters for each label.

1453

TIMS-1453: Cannot associate the failover appliance as it is already in use. Select a different failover appliance.

1454

TIMS-1454: Cannot delete a subnet as one or more objects are defined as DCs and associated with AD zones. Delete the references and try again.

1455

TIMS-1455: An invalid domain name has been provided. Enter a valid domain name.

1456

TIMS-1456: An invalid record type specified.

1457

TIMS-1457: The zone is already frozen.

1458

TIMS-1458: The zone is already thawed.

1459

TIMS-1459: Enter a name for the template.

1460

TIMS-1460: Enter a zone name.

1461

TIMS-1461: Enter an appliance IP.

1462

TIMS-1462: Enter a communication key name.

1463

TIMS-1463: Enter a value for the communication key.

1464

TIMS-1464: Enter a policy file.

1465

TIMS-1465: Failed to restart SNMP on DNS Appliance Name: {0} , IP Address: {1}. Check the logs.

1466

TIMS-1466: Failed to restart DNS Appliance Name: {0} , IP Address: {1} . Please check the logs.

1467

TIMS-1467: Failed to reload DNS Appliance Name: {0} , IP Address: {1} . Please check the logs.

1468

TIMS-1468: Failed to restart Monit on DNS Appliance: {0} , IP Address: {1} . Please check the logs.

1469

TIMS-1469: Failed to restart BGP on DNS Appliance: {0} , IP Address: {1} . Please check the logs.

1470

TIMS-1470: Failed to restart OSPF on DNS Appliance: {0} , IP Address: {1} . Please check the logs.

1471

TIMS-1471: Failed to restart Zebra on DNS Appliance: {0} , IP Address: {1} . Please check the logs.

1472

TIMS-1472: Failed to restart NTP on DNS Appliance: {0} , IP Address: {1} . Please check the logs.

1473

TIMS-1473: Failed to restart SSH on DNS Appliance: {0} , IP Address: {1} . Please check the logs.

1474

TIMS-1474: Failed to restart TIMS-DNS service on DNS Appliance: {0} , IP: {1} . Please check the logs.

1475

TIMS-1475: Cannot create a root zone, zone name must be .(dot).

1476

TIMS-1476: Cannot create a proxy root zone, zone name must be .(dot).

1477

TIMS-1477: Invalid data specified for the input parameter. Valid input format is "zonename-@-organizationname", multiple with comma(,) separated.

1478

TIMS-1478: Configuration changes to the core directory of TCPWave IPAM are not permitted during the execution of {0} plugin on appliance {1}.

1479

TIMS-1479: Root Zone cannot be created as there are one or more master appliances are not defined as BIND AUTH appliances.

1480

TIMS-1480: Root Zone cannot be updated as there are one or more master appliances are not defined as BIND AUTH appliances.

1488

TIMS-1488: Invalid resource record type specified, valid types are A, AAAA, CNAME, MX, TXT, NS, PTR, NAPTR, DS, SOA, SRV, DNSKEY.

1489

TIMS-1489: No external DNS cache appliances found to Sync.

1490

TIMS-1490: Domains are referenced in ipv6 objects. Please delete those references and try again.

1491

TIMS-1491: Location(s) cannot be deleted, as it is used in one or more subnets.

1492

TIMS-1492: {0} for the DHCP Class cannot be null or empty.

1493

TIMS-1493: {0} for the DHCP Poller cannot be null or empty.

1494

TIMS-1494: Cannot create a zone as there is a CNAME defined with the name: {0}.

1495

TIMS-1495: Cannot update a zone name as there is a CNAME defined with the name: {0}.

1496

TIMS-1496: You are not permitted to recursively delete the {0} references. Please check the global option: Permit users to recursively delete Subnet and Object references.

1497

TIMS-1497: Unable to create a custom sync plugin file or to change the executable permissions of a custom sync plugin.

1498

TIMS-1498: DNS authoritative appliance: {0} recursion cannot be enabled as there is a root zone defined with this appliance and recursion on root appliance global option is set to no.

1499

TIMS-1499: Root Zone cannot be created as there are one or more master appliances are defined as recursion enabled.

1500

TIMS-1500: Root Zone cannot be updated as there are one or more master appliances are defined as recursion enabled.

1501

TIMS-1501: Please select a single location to modify.

1502

TIMS-1502: Please select a location to modify.

1503

TIMS-1503: Please select a location to delete.

1504

TIMS-1504: The location does not exist.

1505

TIMS-1505: The location information does not exist.

1506

TIMS-1506: DHCP Pollers cannot have the same name. Please try with a different name.

1507

TIMS-1507: DHCP Pollers cannot have the same IP Address. Please try with a different IP Address.

1508

TIMS-1508: DHCP Pollers cannot have the same MAC Address. Please try with a different MAC Address.

1509

TIMS-1509: The number of DHCP Pollers has exceeded the maximum limit (4).

1510

TIMS-1510: {0} is not valid.

1511

TIMS-1511: Location(s) cannot be deleted. As they are associated with: {0}

1512

TIMS-1512: Location cannot be deleted as it is associated with one or more ipv6 subnet.

1513

TIMS-1513: Please select a Location to bookmark.

1514

TIMS-1514: The name of this DHCP object conflicts with that of an existing static object. The operation cannot be completed.

1515

TIMS-1515: DNS authoritative appliance: {0} recursion cannot be enabled as there is no root zone defined in the organization.

1516

TIMS-1516: Root zone cannot be deleted as it is being used by one or more DNS authoritative recursion enabled internal cache appliances.

1517

TIMS-1517: DNS authoritative appliance: {0} recursion cannot be enabled as it is a stealth appliance.

1518

TIMS-1518: DNS authoritative appliance: {0} cannot be a stealth appliance as it is a recursion enabled appliance.

1519

TIMS-1519: DNS authoritative appliance: {0} recursion cannot be enabled as IPAM is DNS views enabled.

1520

TIMS-1520: A parent forest with the name: {0} does not exist.

1521

TIMS-1521: Active Directory zone: {0} cannot be deleted as it is being used as a parent forest in one or more AD zones.

1522

TIMS-1522: Parent forest cannot be same as the zone: {0}.

1523

TIMS-1523: There is no Network/Subnet: {0} with the Mask: {1} exists in the organization to create a reverse zone.

1524

TIMS-1524: Reverse zone: {0} cannot be created as it is conflicting with one or more existing reverse zones.

1525

TIMS-1525: There is no Network/Subnet: {0} with the Mask: {1} exists in the organization to update a reverse zone.

1526

TIMS-1526: Reverse zone: {0} cannot be modified as address and mask are not matching with existing values of a reverse zone.

1527

TIMS-1527: Hostname cannot be null for the external PTR record.

1531

TIMS-1531: Service mode cannot be null.

1532

TIMS-1532: Service mode does not exist: {0}

1533

TIMS-1533: Service mode already exists: {0}

1534

TIMS-1534: Default service mode cannot be updated.

1535

TIMS-1535: Default service mode cannot be deleted.

1536

TIMS-1536: Service name cannot be null.

1537

TIMS-1537: Service already exists: {0}

1538

TIMS-1538: Service does not exist: {0}

1539

TIMS-1539: Service target does not exist: {0}

1540

TIMS-1540: Service mode: {0} has not been defined for service: {1}

1541

TIMS-1541: CNAME resource record with owner: {0} does not exist.

1542

TIMS-1542: Service target: {0} does not point to a valid 'A' or 'AAAA' resource record.

1543

TIMS-1543: CNAME resource record of the service is not associated with object or zone.

1544

TIMS-1544: Service mode cannot be deleted as it is associated with one or more contingency service(s).

1545

TIMS-1545: Subnet cannot be created as subnet reverse zone template is not matching with the network reverse zone template.

1546

TIMS-1546: Reverse zone: {0} cannot be created/edited as subnet reverse zone template is not matching with the network reverse zone template.

1547

TIMS-1547: DNS External Root Hint: {0} with IP: {1} already exists in the specified DNS appliance template.

1548

TIMS-1548: DNS External Root Hint: {0} with IP: {1} does not exist in the specified DNS appliance template.

1549

TIMS-1549: Child Reverse zone: {0} cannot be created as the mask length: {1} provided is less than the parent reverse zone mask length: {2}.

1550

TIMS-1550: Child Reverse zone: {0} cannot be created as the start or end address of the child reverse zone are not in parent reverse zone start and end address range.

1601

TIMS-1601: Please enter an AML value.

1602

TIMS-1602: The encrypted root password for the remote appliance, cannot not be generated as the encryption file has been modified/deleted. Please contact customer support.

1603

TIMS-1603: You are not authorized to set the root password.

1604

TIMS-1604: The user credentials/change request number cannot not be validated as the ServiceNow instance is unreachable.

1605

TIMS-1605: The user credentials validation cannot not be completed. Please confirm that the credentials are correct.

1607

TIMS-1607: The user credentials for {0} are already registered with TIMS.

1609

TIMS-1609: The user credentials cannot be deleted as they are needed to validate the ServiceNow change request numbers.

1610

TIMS-1610: The change management instance URL cannot be null.

1611

TIMS-1611: The ServiceNow authentication credentials have not been configured. Please configure them and try again.

1612

TIMS-1612: The entered ServiceNow change request number has not been approved for implementation.

1613

TIMS-1613: The change schedule information for the ServiceNow change request number cannot not be obtained.

1614

TIMS-1614: The change corresponding to the entered ServiceNow change request number is not scheduled for the current time.

1615

TIMS-1615: Please enter all the mandatory values for the defining a workflow.

1616

TIMS-1616: Incorrect workflow operation specified. Accepted values are Add/Modify/Delete

1617

TIMS-1617: Incorrect workflow entity specified. Please refer the product documentation for a list of supported workflow entities.

1618

TIMS-1618: A workflow with the given id {0} already exists.

1619

TIMS-1619: A workflow with the given data is already defined.

1620

TIMS-1620: A workflow cannot be defined by a Functional Administrator or Super Administrator Account.

1621

TIMS-1621: Could not retrieve data for the given workflow id {0}

1622

TIMS-1622: The selected workflow cannot be deleted as its currently under execution.

1624

TIMS-1624: The specified object cannot be created/updated as the Non-Managed DNS master with the name {0} exists in the system.

1625

TIMS-1625: The domain/zone cannot be created/updated as the Non-Managed DNS zone with the name {0} exists in the system.

1626

TIMS-1626: The DNS/DHCP appliance cannot be created/updated as the Non-Managed DNS master {0} with the IP address {1} exists in the system.

1701

TIMS-1701: Please select a single asset to modify.

1702

TIMS-1702: Please select an asset to modify.

1703

TIMS-1703: Please select an asset to delete.

1704

TIMS-1704: The Microsoft DNS appliance name cannot be null.

1705

TIMS-1705: The Microsoft DNS appliance user name cannot be null.

1706

TIMS-1706: The Microsoft DNS appliance IP address cannot be null.

1707

TIMS-1707: The Microsoft DNS appliance cannot be associated with the object {0} as the object type is TCPWave Remote.

1708

TIMS-1708: The Microsoft DNS appliance with IP address {0} is already being managed by the TCPWave IPAM.

1709

TIMS-1709: The Microsoft DNS appliance with IP address {0} does not exist.

1710

TIMS-1710: Object with IP address {1} cannot be created as a Microsoft appliance {0} already exists with the same IP address.

1711

TIMS-1711: An object with the specified address {0} already exists with an object type "TCPWave Remote".

1712

TIMS-1712: Active directory enabled zone {0} cannot be created as the Microsoft DNS appliance {1} has {2} as an active directory integrated zone.

1713

TIMS-1713: Zone {0} cannot be deleted as it is active directory integrated on the Microsoft DNS appliance {1}.

1714

TIMS-1714: Both Id and IP address of the Microsoft appliance cannot be null.

1715

TIMS-1715: Zone name cannot be updated for {0} as it is Active directory integrated on the Microsoft appliance {1}.

1719

TIMS-1719: Please enter valid credentials.

1720

TIMS-1720: The entered old and new passwords cannot be same.

1721

TIMS-1721: The domain {0} cannot be modified as the object is associated with the Active Directory integrated Microsoft appliance {1}.

1722

TIMS-1722: The Microsoft appliance {0} cannot be created, as an object of type Microsoft Remote does not exist.

1723

TIMS-1723: The Microsoft appliance {0} cannot be updated, as an object of type Microsoft Remote does not exist.

1724

TIMS-1724: The Active Directory enabled Zone {0} cannot created as the object of the Microsoft DNS appliance {1} has {2} as domain.

1725

TIMS-1725: Force sync cannot be done on the Active Directory zone {0} as the Microsoft DNS appliance {1} has different Active Directory integrated zone {2}.

1726

TIMS-1726: Force sync cannot be done on the Active Directory enabled zone {0} as the Microsoft DNS appliance {1} does not have any Active Directory integrated zone.

1727

TIMS-1727: The domain {0} cannot be modified as it is Active Directory enabled and associated to the Microsoft DNS appliance {1}.

1728

TIMS-1728: DNSSEC cannot be enabled/disabled on the zone {0} as the associated zone template {1} has the Microsoft DNS appliances as masters.

1729

TIMS-1729: Force sync cannot be done on the zone {0} as it is Active Directory enabled on the Microsoft DNS appliance {1} and not Active Directory enabled on IPAM.

1730

TIMS-1730: The zone: {0} specified as {1} domain for resource record {2} of type {3} does not exist.

1731

TIMS-1731: The data of the resource record {0} of type {1} should not be greater than 512 characters.

1732

TIMS-1732: TXT record cannot be modified/deleted as it is associated with the resource record {0} of type SPF.

1733

TIMS-1733: Same domain cannot be given as the include/redirect domain {0} for SPF resource record.

1734

TIMS-1734: MX record cannot be modified/deleted as it is associated with the resource record {0} of type {1}.

1735

TIMS-1735: No MX record found for the given verification data: {0} Please enter a valid MX record name.

1736

TIMS-1736: The resource record {0} specified in the verification data of the resource record {2} of type {3} as {1} does not exist.

1737

TIMS-1737: ACL object cannot be null.

1738

TIMS-1738: {0} Master cannot be created as there is a TCPWave Remote already exist with the same IPv4 address: {1}.

1739

TIMS-1739: {0} Master cannot be created as there is a Microsoft Windows Remote already exist with the same IPv4 address: {1}.

1740

TIMS-1740: {0} Master cannot be created as there is a IPAM Appliance already exist with the same IPv4 address: {1}.

1741

TIMS-1741: {0} Master already exist with the same IPv4 address: {1}.

1742

TIMS-1742: {0} Master already exist with the same name: {1}.

1743

TIMS-1743: {0} Master does not exist in the IPAM with the IPv4 Address: {1}.

1744

TIMS-1744: Both DNS Master Id and IPv4 Address cannot be null.

1745

TIMS-1745: {0} Master cannot be deleted as there are one or more Non-Managed DNS zones defined in it.

1746

TIMS-1746: The specified master type is invalid. Please enter the master type as Power DNS or External DNS.

1747

TIMS-1747: The Non-Managed DNS zone cannot be created in the system as there is an existing TCPWave managed zone with the name: {0}.

1748

TIMS-1748: The Non-Managed DNS zone cannot be created in the system as there is an existing TCPWave managed object with the name: {0}.

1749

TIMS-1749 The Non-Managed DNS zone cannot be created in the system as there is an existing TCPWave managed resource record with the name: {0}.

1750

TIMS-1750 The Non-Managed DNS zone cannot be created in the system as there is an existing TCPWave managed IPv6 with the name: {0}.

1751

TIMS-1751: The Non-Managed DNS Zone cannot be created in the system as there is an existing TCPWave managed appliance level forwarder zone with the name: {0}.

1752

TIMS-1752: The Non-Managed DNS zone cannot be created in the system as there is an existing TCPWave managed appliance template level forwarder zone with the name: {0}.

1753

TIMS-1753: The Non-Managed DNS zone cannot be created in the system as there is no defined TCPWave managed DNS appliance with IPv4 address: {0}.

1754

TIMS-1754: The system cannot find the Non-Managed DNS zone with the name: {0}.

1755

TIMS-1755: A Non-Managed DNS zone with the same name already exists in the system: {0}.

1756

TIMS-1756: The Non-Managed DNS zone value cannot be null. Please enter a valid external DNS zone name.

1757

TIMS-1757: At least one Non-Managed DNS Master should be specified.

1758

TIMS-1758: At least one TCPWave IPAM managed slave should be specified.

1759

TIMS-1759: The Non-Managed DNS master cannot be updated in the system as there is a TSIG key with the name: {0} already defined in one of the managed external DNS zones.

1760

TIMS-1760: The Non-Managed DNS zone cannot be created in the system as there is a TSIG key with the name: {0} already defined in one of the managed external DNS master.

1761

TIMS-1761: The Non-Managed DNS master cannot be created in the system a there is an existing TCPWave managed DHCP object with the IP address: {0}.

1762

TIMS-1762: The Non-Managed DNS zone cannot be created in the system as there is a TSIG key with the name: {0} already defined in one of the managed external DNS zone.

1796

TIMS-1796: The selected DNS appliance: {0} cannot be deleted as it is associated with the Non-Managed DNS zones.

1797

TIMS-1797: The Non-Managed DNS master address value cannot be null. Please enter a valid Non-Managed DNS master address.

1798

TIMS-1798: The specified password is invalid for the Non-Managed DNS master {0} . Please enter a valid password.

1799

TIMS-1799: The PowerDNS master does not exist with specified IP address: {0} in the system.

1801

TIMS-1801: Please select a business unit to delete.

1802

TIMS-1802: Please select a business unit to modify.

1898

TIMS-1898: Unable to accept as one or more of the selected commands are not the latest discovery commands for the associated switches.

1899

TIMS-1899: Unable to accept as one or more of the selected commands have already been accepted.

1900

TIMS-1900: Switch IP cannot be null.

1901

TIMS-1901: Please select a switch to accept the switch results.

1902

TIMS-1902: An error occurred while deleting the switch results.

1903

TIMS-1903: Please select a switch to discard the switch results.

1904

TIMS-1904: An error occurred while discovering switches.

1905

TIMS-1905: Please select a switch to discover the connected devices.

1906

TIMS-1906: Please select a switch to see the discovered devices.

1907

TIMS-1907: Object type must be V4 or V6.

1908

TIMS-1908: Both V4 object Id or V6 object id cannot be null.

1909

TIMS-1909: Host cannot be null.

1910

TIMS-1910: Port cannot be null.

1911

TIMS-1911: User Name cannot be null.

1912

TIMS-1912: Password cannot be null.

1913

TIMS-1913: Authentication type cannot be null.

1914

TIMS-1914: VMWare authentication has failed. Please check the credentials.

1915

TIMS-1915: Please make sure host is matched to either Object IP Address or Object hostname.

1916

TIMS-1916: Organization name cannot be null.

1917

TIMS-1917: Organization name and id cannot be null.

1918

TIMS-1918: Object address does not belong to any defined subnet in the given organization.

1939

TIMS-1939: DNS appliance template or recursion cannot be changed as DNS forwarding is enabled on this appliance.

1940

TIMS-1940: Appliance Template cannot be changed as one more appliance template level forwarders are conflicting with appliance specific forwarders.

1941

TIMS-1941: Zone name already exists in appliance level forwarders.

1942

TIMS-1942: Forwarders Group should contain at least one or more forwarders.

1943

TIMS-1943: Appliance template cannot be associated to BIND AUTH appliance as DNS forwarding is enabled on selected appliance template.

1944

TIMS-1944: Forwarder zone name cannot be null.

1945

TIMS-1945: Forwarder name already exists.

1946

TIMS-1946: Forwarders Group with a name already exists: {0}.

1947

TIMS-1947: The selected DNS forwarders group cannot be deleted as it is associated to one or more DNS appliance template(s).

1948

TIMS-1948: Appliance forwarder cannot be edited as it is associated with appliance templates.

1949

TIMS-1949: Appliance forwarder cannot be deleted as it is associated with appliance templates.

1950

TIMS-1950: File Set cannot be null.

1951

TIMS-1951: File Set {0} does not exist in the organization {1}.

1952

TIMS-1952: Protocol cannot be null.

1953

TIMS-1953: File Set name and Id cannot be null.

1954

TIMS-1954: File Set does not exist: {0}

1955

TIMS-1955: File name already exists.

1956

TIMS-1956: File Set already exists.

1957

TIMS-1957: File set with name {0} already exits.

1958

TIMS-1958: File Set file ID Cannot be null .

1959

TIMS-1959: Selected appliance is already assigned to {0} FileSet.

1960

TIMS-1960: Appliance is referenced in file set. Please delete those references and try again.

1961

TIMS-1961: Alias Resource record already exists with name {0}.

1962

TIMS-1962: Alias Resource record name cannot be null.

1963

TIMS-1963: Invalid rows present with more than 2 columns. Maximum columns allowed is 2.

1964

TIMS-1964: {0} record of owner {1} already exists for an Object: {2}

1965

TIMS-1965: {0} record of owner {1} already exists in Zone: {2}

1966

TIMS-1966: As the zone is already managed by the TCPWave IPAM, the operation cannot be performed. The existing zone must be deleted to continue the operation.

1967

TIMS-1967: IAM Role name can contain alphanumeric characters, or any of the following: _+=,.@- {0}.

1968

TIMS-1968: Domain Servers cannot be empty as the selected DHCP option template has the value Same as Subnet Profile for the option Domain Servers(6).

1969

TIMS-1969: Selected DNS appliance has references in one or more subnet(s). Please dis-associate the appliance from the subnet(s) and try again.

1970

TIMS-1970: Selected DHCP option template cannot be updated as the one or more subnet(s) associated for this template has no Domain Servers selected.

1971

TIMS-1971: Resource with name {0} already exists.

1972

TIMS-1972: Patch name cannot be null.

1973

TIMS-1973: Both patch name and patch type cannot be null.

1974

TIMS-1974: Resource type cannot be null.

1975

TIMS-1975: Resource name already exists.

1976

TIMS-1976: Old resource name cannot be null.

1977

TIMS-1977: Resource type is not valid.

1978

TIMS-1978: Please give a valid old resource name.

1979

TIMS-1979: No changes has been discovered for this operation.

1980

TIMS-1980: Cloud Provider is not valid.

1981

TIMS-1981: The cloud provider doesn't have the resource role mapping for the zone.So zone name edit cannot be performed. Please add resource role mapping for this zone in the cloud provider and try again.

1982

TIMS-1982: Administrator Role with name {0} already exists.

1983

TIMS-1983: Administrator Role {0} cannot be edited.

1984

TIMS-1984: Administrator Role should contain at least one or more functions.

1985

TIMS-1985: Organization name cannot be null for {0} role.

1986

TIMS-1986: Please give a valid role name.

1987

TIMS-1987: Default role cannot be updated.

1988

TIMS-1988: To assign the {0} role, unassign the existing roles and add this role to the Administrator Group.

1989

TIMS-1989: You cannot assign another role to the this Administrator Group as {0} role is already assigned to this Administrator Group.

1990

TIMS-1990: Administrator role {0} does not exist.

1991

TIMS-1991: Administrator Role cannot be null.

1992

TIMS-1992: Administrator Group should contain at least one or more administrator roles.

1993

TIMS-1993: Custom role cannot be created with the security management actions.

1994

TIMS-1994: Custom role cannot be updated with the security management actions.

1995

TIMS-1995: Function {0} does not exist.

1996

TIMS-1996: Default Administrator Group cannot be updated.

1997

TIMS-1997: Administrator Role {0} is referenced in an existing Administrator. Please delete those references and retry.

1998

TIMS-1998: Default Administrator Group cannot be deleted.

2000

TIMS-2000: ACL is referenced in Active Directory enabled zones. Please delete those references and retry.

2001

TIMS-2001: ACL(s) not found : {0}

2002

TIMS-2002: ACL already exists: {0}

2003

TIMS-2003: The ACLs are not valid.

2004

TIMS-2004: The ACL is referenced in the appliance templates. Please delete those references and retry.

2005

TIMS-2005: The ACL is not valid : {0} for option param: {0}

2006

TIMS-2006: The ACL is not valid: {0}

2007

TIMS-2007: The ACL name is not valid : {0}

2008

TIMS-2008: Both Network address and id cannot be null.

2009

TIMS-2009: Key is not valid: {0}

2010

TIMS-2010: Algorithm is not valid: {0}

2011

TIMS-2011: Bit size should be between {0} and {1}.

2012

TIMS-2012: Cannot merge into /{0} subnet.

2013

TIMS-2013: A split operation is currently in progress. Please try later.

2014

TIMS-2014: Subnet group already exists: {0}

2015

TIMS-2015: Subnet does not exist.

2016

TIMS-2016: Subnet does not exist: {0}

2017

TIMS-2017: Choose a mask length greater than {0}

2018

TIMS-2018: Subnet group information does not exist.

2019

TIMS-2019: Subnet group information does not exist: {0}

2020

TIMS-2020: Object Type does not exist: {0}

2021

TIMS-2021: Subnet(s) cannot be {0} as the option router in the DHCP Option Template does not match with the primary router of the subnet. Please choose a different template.

2022

TIMS-2022: Subnet(s) cannot be {0} as the option subnet mask in the DHCP Option Template does not match with the subnet mask of the subnet. Please choose a different template.

2023

TIMS-2023: Subnet(s) cannot be {0} as the primary domain of the subnet does not match with the option domain-name in the DHCP Option Template. Please choose a different template.

2024

TIMS-2024: This subnet does not correspond to any of the existing networks.

2025

TIMS-2025: Cannot delete a default object type.

2026

TIMS-2026: Cannot modify a default object type.

2027

TIMS-2027: DHCP class with the given match expression already exists.

2028

TIMS-2028: DHCP class with the given name already exists.

2030

TIMS-2030: Object Type already exists: {0}

2031

TIMS-2031: Please enter ACL value.

2032

TIMS-2032: Creating new ACL failed. Please check the logs.

2034

TIMS-2034: Please enter data for the ACL.

2035

TIMS-2035: Please select reference ACL.

2036

TIMS-2036: ACL NONE already exists. You cannot add ANY to the ACL.

2037

TIMS-2037: ACL ANY already exists. You cannot add NONE to the ACL.

2038

TIMS-2038: Please select at least one row to delete.

2039

TIMS-2039: Please select an entry to move.

2040

TIMS-2040: Please select a single row to modify.

2041

TIMS-2041: Selected ACL is a special ACL. It cannot be modified.

2042

TIMS-2042: Please select an ACL to modify.

2043

TIMS-2043: Selected ACL is a special ACL. It cannot be cloned.

2044

TIMS-2044: Please select a row to clone.

2045

TIMS-2045: {0} already exists.

2046

TIMS-2046: Updating ACL failed. Please check the logs.

2047

TIMS-2047: There is an existing entry with the same address.

2048

TIMS-2048: There is an existing entry with the same ACL name.

2050

TIMS-2050: Subnet group does not exist: {0}

2051

TIMS-2051: Unable to delete the selected subnet group as it has references.

2052

TIMS-2052: Both Subnet group name and id cannot be null.

2053

TIMS-2053: Please select an entry to move.

2054

TIMS-2054: Please select an entry to modify.

2055

TIMS-2055: Please select a reference ACL.

2056

TIMS-2056: Selected ACL is a special ACL. It cannot be deleted.

2057

TIMS-2057: Please select at least one ACL to delete.

2058

TIMS-2058: {0} already exists, Please confirm to override.

2059

TIMS-2059: Subnet is not associated to the selected domain: {0}

2060

TIMS-2060: Subnet insert failed as subnet address is out of network address range.

2061

TIMS-2061: Subnet insert failed as router address does not belong to the subnet.

2062

TIMS-2062: Please enter a valid router address.

2063

TIMS-2063: Subnet cannot be split as DHCP enabled subnets require a default primary router.

2064

TIMS-2064: Cloud Provider Type cannot be null.

2070

TIMS-2070: Please select a single row.

2071

TIMS-2071: Please select at least one AML to delete.

2072

TIMS-2072: Please select a single subnet to view the active leases.

2073

TIMS-2073: Active leases cannot be viewed as the selected subnet does not have a DHCP Appliance associated with it.

2074

TIMS-2074: Please select an active lease to be deleted.

2075

TIMS-2075: Please select a single subnet to split.

2076

TIMS-2076: Please select a subnet to split.

2077

TIMS-2077: Unable to sync an object, Dynamic DNS options are not set.

2078

TIMS-2078: Please select a single server to sync.

2079

TIMS-2079: Please select a single object to view permissions.

2080

TIMS-2080: Please select a single object to modify permissions.

2081

TIMS-2081: Failed to get the object as it is not found or not reachable on DNS Appliances. Please check if the associated appliances are up and running.

2082

TIMS-2082: DNS Appliance is not reachable to sync.

2083

TIMS-2083: Object not available on the DNS Appliance to sync

2084

TIMS-2084: Cannot sync Cache Appliance. Slave Appliance are not in sync with Master Appliance. Please sync Slave Appliances first.

2085

TIMS-2085: Discovery has failed. Please check the logs for more information.

2086

TIMS-2086: Please select a subnet to discover.

2087

TIMS-2087: Please select domains to be removed.

2088

TIMS-2088: Please select domains to be added.

2089

TIMS-2089: Cannot perform a DNS traversal since the dynamic update flags are not set.

2090

TIMS-2090: IPv6 Address overlaps with an existing DHCP Scope. Please choose a different IPv6 address.

2100

TIMS-2100: IPv6 address is not valid: {0}

2101

TIMS-2101: The IP address and Name you entered already exists.

2102

TIMS-2102: The Name cannot be more than 63 characters long.

2103

TIMS-2103: Please select a network to modify.

2104

TIMS-2104: v6_network address does not exist: {0}

2105

TIMS-2105: IPv6 subnet address is out of block address range.

2106

TIMS-2106: Please select a network to delete.

2107

TIMS-2107: Subnet(s) cannot be created/updated as option subnet mask is not defined in the template.

2108

TIMS-2108: Subnet(s) cannot be created/updated as option routers are not defined in the template.

2109

TIMS-2109: Object with this name already exists.

2110

TIMS-2110: Please select at least one DNS64 prefix to be added.

2111

TIMS-2111: Please select at least one DNS64 prefix to be deleted.

2112

TIMS-2112: Please select at least one Active Directory Domain Controller to be added.

2113

TIMS-2113: Please select at least one Active Directory Domain Controller to be deleted.

2114

TIMS-2114: Please select at least one ACL to be added.

2115

TIMS-2115: Please select at least one ACL to be deleted.

2116

TIMS-2116: Child forest ACL cannot be deleted from the parent forest.

2117

TIMS-2117: TSIG key name cannot be null.

2118

TIMS-2118: TSIG key algorithm cannot be null.

2119

TIMS-2119: TSIG key name already exists: {0}.

2120

TIMS-2120: TSIG key algorithm does not exist: {0}.

2121

TIMS-2121: TSIG key name does not exist: {0}.

2122

TIMS-2122: TSIG keys cannot be deleted as some of the specified keys does not exist in IPAM.

2123

TIMS-2123: TSIG key(s) not found.

2124

TIMS-2124: Please select reference TSIG Key.

2125

TIMS-2125: TSIG Key(s) cannot be delete as there are one or more DNS ACLs are associated with this.

2126

TIMS-2126: TSIG Key Reference(s) not found.

2201

TIMS-2201: An address space with the given name already exists in the organization.

2202

TIMS-2202: Invalid Regional Internet Registry (RIR) specified.

2203

TIMS-2203: Specified address space does not exist in the organization.

2204

TIMS-2204: Invalid mask specified.

2205

TIMS-2205: Specified parent block does not exist.

2206

TIMS-2206: Specified address block does not exist.

2207

TIMS-2207: Specified start address is invalid for the given mask.

2208

TIMS-2208: Specified address is invalid, mask value is missing.

2209

TIMS-2209: Invalid IPv6 mask value specified.

2210

TIMS-2210: Invalid IPv4 mask value specified.

2211

TIMS-2211: Specified IPv6 address is invalid.

2212

TIMS-2212: Specified IPv4 address is invalid.

2213

TIMS-2213: Child block is out of bounds of the parent block.

2214

TIMS-2214: Block clashes with an existing child block.

2215

TIMS-2215: Block clashes with the existing blocks in the address space.

2216

TIMS-2216: Please specify the new mask length.

2217

TIMS-2217: Please specify a mask length that is greater than the current mask length.

2218

TIMS-2218: IPv4 block mask length should be less than or equal to 32.

2219

TIMS-2219: IPv6 block mask length should be less than or equal to 128.

2220

TIMS-2220: One or more child nodes are larger than the specified new block size.

2221

TIMS-2221: Difference between the new and old masks should not be greater than 4.

2222

TIMS-2222: Specified seed block does not exist.

2223

TIMS-2223: No free space to create network with the specified mask in the address block.

2224

TIMS-2224: No free space to create child block with the specified mask in the address block.

2424

TIMS-2424: Proxy Root zone already exists in the selected organization.

2500

TIMS-2500: Owner name should be same as zone name.

2990

TIMS-2990: Incorrect address ranges specified.

2991

TIMS-2991: The name of this object conflicts with an existing CNAME record. Please try with a different name.

2992

TIMS-2992: Please select an object to modify.

2993

TIMS-2993: Current selection contains unallocated objects that cannot be edited. Please redo the selection.

2994

TIMS-2994: Please select a defined object to delete.

2995

TIMS-2995: DHCP Objects cannot be {0} as the subnet is not DHCP enabled. Please associate a DHCP Option Template and a DHCP Appliance to the subnet and try again.

2996

TIMS-2996: Please select a resource record to remove.

2997

TIMS-2997: Please select an organization to add resource records.

2998

TIMS-2998: Please enter all the required values.

2999

TIMS-2999: Please select an organization to update resource records.

3000

TIMS-3000: The selected resource record is the default A record. It cannot be modified.

3001

TIMS-3001: An object exists at the given address. Please select an unallocated address.

3002

TIMS-3002: DHCP Appliance name is null.

3003

TIMS-3003: Object type for this object cannot be changed as it is defined as an appliance.

3004

TIMS-3004: Cannot add an object at subnet boundary.

3005

TIMS-3005: Object name is null.

3006

TIMS-3006: Object address cannot be null.

3007

TIMS-3007: Object already exists: {0}

3008

TIMS-3008: IPv6 Address already exists: {0}

3009

TIMS-3009: Object does not exist.

3010

TIMS-3010: Object does not exist: {0}

3011

TIMS-3011: Owner name does not point to a valid A record.

3012

TIMS-3012: CNAME does not refer to a valid A record.

3013

TIMS-3013: Object address out of specified subnet address range.

3014

TIMS-3014: Both Subnet address and id cannot be null.

3015

TIMS-3015: Resource record does not exist.

3016

TIMS-3016: Please run a valid dig command.

3017

TIMS-3017: Dynamic DNS update options cannot be changed for this object as it belongs to a DHCP Scope.

3018

TIMS-3018: Name Service update options cannot be changed for this object as it belongs to a DHCP Scope.

3019

TIMS-3019: DHCP Option Template cannot be changed for this object as it belongs to a DHCP Scope.

3020

TIMS-3020: Both appliance type and id cannot be null.

3021

TIMS-3021: Subnet does not exist for object: {0}

3022

TIMS-3022: Bit size should be between {0} and {1} for algorithm {2}

3023

TIMS-3023: Logger is not valid.

3024

TIMS-3024: MAC address is not unique.

3025

TIMS-3025: Resource Records already exist.

3026

TIMS-3026: A template with the specified name already exists.

3027

TIMS-3027: Object is not deleted as it is associated with an appliance.

3028

TIMS-3028: Object name cannot be changed to {0}.

3029

TIMS-3029: Object cannot be created with {0} as name.

3030

TIMS-3030: Both Object address and id cannot be null.

3031

TIMS-3031: Object is not deleted as it is associated with a zone.

3032

TIMS-3032: Object is not deleted as it is associated with Active Directory UPN.

3033

TIMS-3033: An appliance already exists with specified address/name.

3034

TIMS-3034: Both DNS Appliance Template name and id cannot be null.

3035

TIMS-3035: DNS Appliance Template does not exist.

3036

TIMS-3036: Both DHCP Policy Template name and id cannot be null.

3037

TIMS-3037: DHCP Policy Template does not exist.

3038

TIMS-3038: Appliance Type is not valid: {0}

3039

TIMS-3039: A DHCP object cannot be used to create a remote appliance.

3040

TIMS-3040: A DHCP Appliance cannot be created using the selected device as it is the primary router of the subnet. Please choose a different device.

3041

TIMS-3041: Cannot modify the object as mac address is not specified.

3042

TIMS-3042: Error detected in DHCP Policy Template : {0}. DHCP configuration will not be updated with changes to this template. Template and remote DHCP configurations have been rolled back to their last known good configurations.

3043

TIMS-3043: Error detected in DHCP Option Template : {0}. DHCP configuration will not be updated with changes to this template. Template and remote DHCP configurations have been rolled back to their last known good configurations.

3044

TIMS-3044: Cannot create a scope as the primary router for this subnet is not defined.

3045

TIMS-3045: Cannot create a scope as the DHCP Appliance for this subnet is not defined.

3046

TIMS-3046: Cannot create a scope as the DHCP option template for this subnet is not defined.

3047

TIMS-3047: Cannot complete this action as the DHCP option template does not have a subnet mask defined.

3048

TIMS-3048: Cannot complete this action as the DHCP option template does not have a router defined.

3049

TIMS-3049: Cannot complete this action as the DHCP option template does not have a domain defined.

3050

TIMS-3050: Both appliance id and address cannot be null.

3051

TIMS-3051: Appliance address cannot be null.

3052

TIMS-3052: An appliance is not deleted as other zone(s) are using it. Please remove the referencing zone(s) and retry.

3053

TIMS-3053: An appliance is not deleted as other zone template(s) are using it. Please remove the referencing zone template(s) and retry.

3055

TIMS-3055: An appliance is not deleted as other network(s) are using it. Please remove the referencing network(s) and retry.

3056

TIMS-3056: DHCP class does not exist: {0}

3057

TIMS-3057: The DHCP option template is invalid for the subnets after the split.

3058

TIMS-3058: DHCP Appliance does not exist: {0}

3059

TIMS-3059: Appliance id and address both cannot be null.

3060

TIMS-3060: DHCP Appliance is not deleted as it manages subnets.

3061

TIMS-3061: DHCP Appliance is not deleted as it manages scopes.

3063

TIMS-3063: Class cannot be deleted as it is being used by one or more scopes.

3064

TIMS-3064: DHCP Appliance is not deleted as there are manual-DHCP Objects associated with it.

3065

TIMS-3065: The vendor-class-identifier is not specified in the match expression. Please verify the expression syntax or check for examples in the help section.

3066

TIMS-3066: The client-class-identifier is not specified in the match expression. Please verify the expression syntax or check for examples in the help section.

3067

TIMS-3067: DHCP Appliance cannot be changed for this object as it belongs to a DHCP Scope.

3068

TIMS-3068: Please select more subnets to merge.

3069

TIMS-3069: DHCP configuration regeneration error. Please check the logs.

3070

TIMS-3070: DHCP Scope Creation failed. The template and remote DHCP configurations are rolled back to their last known good configurations.

3071

TIMS-3071: Error detected in DHCP Policy Template: {0}. DHCP configuration will not be updated with changes to this template.

3072

TIMS-3072: A or CNAME {0} record already exists for an Object: {1}

3073

TIMS-3073: Please select a single row to create an object.

3074

TIMS-3074: Please select a single row to modify an object.

3075

TIMS-3075: Object cannot be created with a name called localhost because it will impact to applications.

3076

TIMS-3076: Cannot create the object as mac address is not specified.

3077

TIMS-3077: Current selection contains unallocated object(s) that cannot be deleted. Please select again.

3078

TIMS-3078: Object creation failed. The name of this object conflicts with an existing CNAME record. Please try with a different name.

3079

TIMS-3079: Both DNS Options Template name and id cannot be null.

3080

TIMS-3080: DNS Options Template does not exist.

3081

TIMS-3081: DNS Appliance cannot be created using the selected device as it is the primary router of the subnet. Please choose a different device.

3082

TIMS-3082: An object exists at the given address. Please select an unallocated address.

3083

TIMS-3083: DHCP Appliance does not exist.

3084

TIMS-3084: Subnet update failed as DHCP Appliance is being disassociated when there is a template.

3085

TIMS-3085: Please select a DHCP Appliance.

3086

TIMS-3086: Subnet update failed as DHCP option template is being disassociated when there is an appliance.

3087

TIMS-3087: DNS Appliance cannot be created using the selected object as it is reserved. Please choose another object.

3088

TIMS-3088: Appliance IP address is null.

3089

TIMS-3089: Appliance name is null.

3090

TIMS-3090: Both appliance id and name cannot be null.

3091

TIMS-3091: Appliance does not exist.

3092

TIMS-3092: Appliance does not exist: {0}

3093

TIMS-3093: Cannot delete the lease as TIMS is not able to communicate with the remote DHCP Appliance. Please try restarting TIMS-DHCP on the Remote DHCP Appliance.

3094

TIMS-3094: Allocation type cannot be changed as object is an appliance.

3095

TIMS-3095: DHCP Appliance preference cannot be changed from primary to fail over.

3096

TIMS-3096: The user-class attribute is not specified in the match expression. Please verify the expression syntax or check for examples in the help section.

3097

TIMS-3097: The {0} class match expression is not valid. Please check the help manual for additional information.

3098

TIMS-3098: Router address does not belong to the subnet.

3099

TIMS-3099: DHCP lease update to TCPWave IPAM failed. The name of this object conflicts with an existing CNAME record.

3100

TIMS-3100: Object name cannot be modified as it conflicts with an existing appliance name.

3101

TIMS-3101: Network does not exist: {0}

3102

TIMS-3102: DHCP Scopes/Objects cannot be created as the subnet is not DHCP enabled. Please associate a DHCP Option Template and a DHCP Appliance to the subnet and try again

3103

TIMS-3103: Allocation type of Router, TCPWave Remote, Microsoft Remote, TCPWave IPAM or Domain Controller has to be static.

3104

TIMS-3104: Network does not exist.

3105

TIMS-3105: Object creation failed. The name of this object conflicts with an existing A record. Please try with a different name.

3106

TIMS-3106: The name of this object conflicts with an existing A record. Please try with a different name.

3107

TIMS-3107: Network does not exist for the specified organization.

3108

TIMS-3108: Object update failed. The name of this object conflicts with an existing CNAME record. Please try with a different name.

3109

TIMS-3109: Object update failed. The name of this object conflicts with an existing A record. Please try with a different name.

3110

TIMS-3110: Please specify a maximum of 256 objects only.

3121

TIMS-3121: Subnet is not deleted as there are appliances defined in it.

3122

TIMS-3122: Please select two or more subnets to merge.

3123

TIMS-3123: Subnet merge failed as Primary Router is not selected.

3124

TIMS-3124: Subnet merge failed as DHCP Appliance is not selected.

3125

TIMS-3125: Subnet update failed as DHCP Appliance or DHCP Template cannot be disassociated as there are scopes/M-DHCP definitions in this subnet.

3126

TIMS-3126: Failover cannot be configured for this DHCP Appliance as all the existing failover appliance are in use. Please create a failover appliance and try again.

3130

TIMS-3130: Object Type cannot be deleted as it is being used.

3131

TIMS-3131: Please select a vendor class to modify.

3132

TIMS-3132: Please select a vendor class to delete.

3133

TIMS-3133: Failed to get the resource record as it is not found or not reachable on DNS Appliances. Please check if the associated appliances are up and running.

3134

TIMS-3134: Sync is not applicable on DNS Authoritative master appliances.

3135

TIMS-3135: DNS Appliance is not reachable to sync.

3136

TIMS-3136: Resource record not available on the DNS Appliance to sync.

3137

TIMS-3137: Cannot sync Cache Appliance. Slave appliances are not in sync with Master appliance. Please sync Slave appliance first.

3138

TIMS-3138: Please select a resource record to sync.

3139

TIMS-3139: Please select an object type to modify.

3140

TIMS-3140: Please select an object type to delete.

3141

TIMS-3141: No object type selected for deletion.

3142

TIMS-3142: The selected appliance is a failover type. It cannot be cloned.

3143

TIMS-3143: Please select a defined object to delete.

3144

TIMS-3144: Please select an object to delete.

3145

TIMS-3145: Please select an object to modify.

3146

TIMS-3146: Current selection contains unallocated object(s) that cannot be modified. Please select again.

3147

TIMS-3147: Please select a subnet to split.

3148

TIMS-3148: Please select a single subnet to split.

3149

TIMS-3149: Please select a single subnet to view permissions.

3150

TIMS-3150: Please select a single subnet to modify permissions.

3151

TIMS-3151: Error occurred during discovery, Please check the logs.

3152

TIMS-3152: Record owner name:{0} is already managed by TCPWave IPAM. Please try a different name.

3153

TIMS-3153: Object name cannot exceed 253 characters.

3154

TIMS-3154: Object cannot be created/modified as its name conflicts with existing Manual/Automatic DHCP Object of the same DHCP Appliance. Please try with different name.

3155

TIMS-3155: Shared Networks have to be associated to DHCP Appliances. Please define a DHCP Appliance and try again.

3156

TIMS-3156: Shared Network does not exist.

3157

TIMS-3157: The selected shared network is not associated to the DHCP Appliance.

3158

TIMS-3158: Shared Network cannot be deleted as it is associated to one or more subnets.

3159

TIMS-3159: Shared Networks require DHCP Appliance associated to the subnet. Please associate a DHCP Appliance to the subnet and try again.

3160

TIMS-3160: DHCP Appliance for the shared network cannot be modified as the shared network is associated to one or more subnets.

3161

TIMS-3161: Shared network length cannot exceed more than 255 characters.

3162

TIMS-3162: Please enter a valid DHCP Server IP Address.

3163

TIMS-3163: Shared network with name {0} and DHCP server {1} cannot be found.

3164

TIMS-3164: Please choose the DHCP Server defined in the subnet profile to create the scope/dynamic DHCP object(s).

3165

TIMS-3165: Please choose the DHCP Option Template defined in the subnet profile to create the scope/dynamic DHCP object(s).

3166

TIMS-3166: Manual and Auto-DHCP Objects must have the same DHCP Appliance as that in the subnet profile.

3167

TIMS-3167: Shared network with this name already exists in the specified organization. Please try with a different name.

3168

TIMS-3168: The selected Subnets cannot be merged as the entered primary router does not correspond to a router object in any of the chosen subnets.

3180

TIMS-3180: DHCP appliance update failed as the new IP Address does not correspond to the same organization as the old DHCP appliance.

3181

TIMS-3181: DHCP Appliance is not deleted as there are Shared Networks associated with it.

3185

TIMS-3185: DHCP Template syntax checker has failed due to invalid or empty data.

3186

TIMS-3186: IPv6 address for DHCPV6 appliance cannot be empty data.

3187

TIMS-3187: Network with IP Address {0} and organization {1} does not exist.

3192

TIMS-3192: DHCPv6 configuration sync has failed on appliance: {0} due to {1}.

3201

TIMS-3201: Please select an organization for adding resource records.

3202

TIMS-3202: Please select a resource record to remove.

3203

TIMS-3203: Please select an organization before adding resource records.

3204

TIMS-3204: Invalid resource record specified. Owner name does not end with the give domain name.

3205

TIMS-3205: Please select only one zone to Freeze or Unfreeze.

3206

TIMS-3206: Resource record with type:{0} and owner:{1} already exists.

3207

TIMS-3207: A record cannot be modified/deleted as it is associated to record type: {0} and owner: {1}

3208

TIMS-3208: NS records for {0} are managed by the TCPWave IPAM. Resolution errors will take place if root delegations are incorrect.

3209

TIMS-3209: Zone name {0} is already delegated in the zone {1} in organization:{2}. Cannot add it as a managed zone in the TCPWave IPAM.

3210

TIMS-3210: The selected resource record is the default A record. It cannot be modified.

3211

TIMS-3211: Please select a scope to delete.

3212

TIMS-3212: Resource record cannot be added as there is a zone defined with the name: {0}.

3213

TIMS-3213: Object cannot be created as there is a zone defined with the name: {0}.

3214

TIMS-3214: There is(are) {0} appliance(s) defined in this network. Please delete the appliance(s) and try again.

3215

TIMS-3215: Object cannot be deleted as one of it's A record is associated to record type: {0} and owner: {1}

3216

TIMS-3216: Resource record cannot be added as there is a dynamic object defined with the name: {0}.

3217

TIMS-3217: Resource record cannot be added as there is a dynamic object defined with the IP Address: {0}.

3218

TIMS-3218: Scope cannot be created as it is overlapping with an existing scope.

3219

TIMS-3219: A or CNAME {0} record already exists for an Object: {1} in the selected DNS view(s).

3220

TIMS-3220: {0} record of owner {1} already exists for an Object: {2} in the selected DNS view(s).

3221

TIMS-3221: A or CNAME {0} record already exists in Zone: {1} in the selected DNS view(s).

3222

TIMS-3222: {0} record of owner {1} already exists in Zone: {2} in the selected DNS view(s).

3223

TIMS-3223: There is(are) {0} discovery agent(s) defined in this network. Please delete the discovery agent(s) belongs to this network and try again.

3250

TIMS-3250: Please define at least one parameter to create user defined options.

3251

TIMS-3251: Please enter valid values.

3252

TIMS-3252: Please select a user defined param to modify.

3253

TIMS-3253: Please choose a different Failover DHCP Appliance address as this is already associated to a Primary DHCP Appliance.

3254

TIMS-3254: No A record found for the given owner/mail server/data: {0} Please enter a valid A record name.

3255

TIMS-3255: No AAAA record found for given owner/mail server/data: {0} Please enter a valid AAAA record name.

3256

TIMS-3256: Object name should not contain underscore for the object type TCPWAVE REMOTE.

3257

TIMS-3257: {0} record cannot be modified/deleted as it is associated with one or more {1} resource record(s).

3258

TIMS-3258: No A/CNAME record found for the given data: {0} Please enter a valid A/CNAME record name.

3259

TIMS-3259: CNAME does not refer to a valid A/CNAME record.

3260

TIMS-3260: The global option: Allow CNAME Daisy Chaining is disabled.So CNAME chaining is not allowed.

3301

TIMS-3301: Please select at least one appliance type.

3302

TIMS-3302: Please select at least one appliance.

3497

TIMS:3497: An object with same Host Name already exists in IPAM. Therefore object: {0} has not been added.

3498

TIMS:3498: An object with same Mac Address already exists in IPAM. Therefore object: {0} has not been added.

3499

TIMS-3499: There has been no mismatch of Mac or Name found for the object: {0}. Therefore, it has not been added to IPAM.

3500

TIMS-3500: Discovered Object : {0} does not have a name associated to it. Therefore, it has not been added to IPAM.

3501

TIMS-3501: Unable to retrieve the discovery commands list.

3502

TIMS-3502: Please select a subnet to accept the command results.

3503

TIMS-3503: Unable to accept as {0} of the commands {1} not the latest discovery command(s) for the associated subnets.

3504

TIMS-3504: Unable to accept as {0} of the commands {1} either already accepted or not completed.

3505

TIMS-3505: An error occurred while discarding the command results.

3506

TIMS-3506: Please select a subnet to discard the command results.

3507

TIMS-3507: An error occurred during retrieval of discovered data.

3508

TIMS-3508: Please select a subnet to show the discovery results.

3509

TIMS-3509: Failed to sync on DNS Appliance {0} for record {1}.

3510

TIMS-3510: DHCP process restart has encountered an error. Please check if the appliance is up and running.

3511

TIMS-3511: An unexpected problem has occurred while restarting the SNMP process on DHCP - Appliance Name: {0}, IP Address: {1}. Please try again or contact TCPWave Customer Support.

3512

TIMS-3512: No {0} information found on remote DHCP appliance: {1}. Please check if the appliance is up and running.

3513

TIMS-3513: The selected commands do not have any discovered devices.

3514

TIMS-3514: Unable to accept as the command is either already accepted or not completed.

3515

TIMS-3515: Unable to accept as the command is not the latest discovery command for the associated subnet.

3601

TIMS-3601: Vault type is invalid.

3602

TIMS-3602: Vault Server host cannot be null or empty if Vault type selected is Hashicorp.

3603

TIMS-3603: Vault Server certificate full path cannot be null or empty if SSL is chosen to connect to Hashicorp vault server.

3604

TIMS-3604: No changes detected in Root Access Management details.

3605

TIMS-3605: Vault Server port cannot be null or empty if Vault type selected is Hashicorp.

3606

TIMS-3606: A CAA/DNAME record cannot be created with owner {0} as it is different from the zone name.

3607

TIMS-3607: A DNAME record with the data {1} cannot be created for the zone {0} as it is being referring itself.

3608

TIMS-3608: Zone does not exist for the given DNAME record redirection name {0}

3609

TIMS-3609: Zone cannot be deleted as it is referred in resource record {0} of type {1}.

3610

TIMS-3610: DNAME cannot be created with the data {0} as one or more master or slave appliances have domain with this zone name {1}.

3611

TIMS-3611: DNAME cannot be created with the sub domain {0} as data.

3612

TIMS-3612: A TLSA record cannot be created with owner {0} as it is different from the zone name.

3901

TIMS-3901: License Key is not valid.

3902

TIMS-3902: License Key is not valid. Please contact TCPWave Customer Support for further assistance.

3903

TIMS-3903: Schedule Reclaim check box is enabled. Please disable and proceed to {0} without scheduling reclaim operation.

3904

TIMS-3904: IPV4 DHCP appliance cannot be deleted as DHCP v6 appliance: {0} is associated to it. Please delete the associated DHCPV6 appliance.

3905

TIMS-3905: Microsoft DHCP appliance does not exist with the specified IP address {0} .

3906

TIMS-3906: Microsoft DHCP appliance already exists with the specified IP address {0}.

3907

TIMS-3907: The object type of the selected device is not a Microsoft Remote. Please choose a different device.

3908

TIMS-3908: A scope already exists in the subnet {0}. Microsoft DHCP appliance does not allow multiple scopes per subnet.

3909

TIMS-3909: Unable to enable monitoring on IPv6 DHCP appliance: {0} as monitoring on corresponding associated IPV4 DHCP appliance: {1} has been disabled.

3912

TIMS-3912: DHCP fingerprint data does not exist.

3913

TIMS-3913: DHCP fingerprint option sequence, MAC bits, Vendor or device profile cannot be null.

3914

TIMS-3914: DHCP fingerprint data already exists with MAC bits {0} and option sequence {1} .

3915

TIMS-3915: DHCP fingerprint data cannot be deleted as it is referred with active lease object.

3916

TIMS-3916: Invalid data specified for {0}.

3917

TIMS-3917: Microsoft DHCP Appliance address cannot be null.

3918

TIMS-3918: Microsoft DHCP Appliance is not deleted as it is associated to subnets.

3919

TIMS-3919: Microsoft DHCP Appliance is not deleted as it is associated to scopes.

3920

TIMS-3920: Microsoft Appliance does not exist with the given data.

3921

TIMS-3921: Value cannot be null or empty for {0}.

3922

TIMS-3922: Object allocation type cannot be changed which results in fragmenting scopes and the Microsoft DHCP Appliance cannot support multiple scopes per subnet.

3923

TIMS-3923: Object(s) in the subnet are still associated to domain: {0}, Please disassociate the domain from the objects.

3924

TIMS-3924: Cannot add DHCP Reservations without scopes in Microsoft DHCP enabled subnet.

3925

TIMS-3925: Password cannot be null or empty.

3926

TIMS-3926: An exception has occurred while checking the UDP port 67 status for the Microsoft DHCP appliance.

3927

TIMS-3927: Password should not match with the last used password.

3928

TIMS-3928: Exception while generating the DHCP configuration file for Microsoft DHCP appliance {0}

3929

TIMS-3929: Global Policy does not permit a normal administrator to alter the DHCP objects/scopes. Please contact your super administrator for assistance.

3930

TIMS-3930: Microsoft DHCP appliance does not exist.

3931

TIMS-3931: Secure communication between IPAM and Microsoft DHCP Appliance is broken. Please restart dhcp service on the Microsoft Appliance: {0}.

3932

TIMS-3932: Old password is not correct for the Microsoft appliance {0} .

3933

TIMS-3933: Cannot merge the new scope with existing scope as the existing scope has different user/vendor classes.

3934

TIMS-3934: Microsoft DHCP appliance cannot be null.

3935

TIMS-3935: Microsoft DHCP appliance cannot be deleted as it is associated to one or more Microsoft DHCP Failover Peers.

3936

TIMS-3936: DHCP Appliance type cannot be changed.

3937

TIMS-3937: Failed to update subnet {0} with Microsoft DHCP appliance as subnet contains multiple scopes. Microsoft DHCP does not support multiple scopes per subnet.

3938

TIMS-3938: DHCP option space does not exist with name {0}.

3939

TIMS-3939: Previous DHCP option space name cannot be null.

3940

TIMS-3940: DHCP option space name cannot be null or empty.

3941

TIMS-3941: DHCP sub option name cannot be null or empty.

3942

TIMS-3942: DHCP option parameter does not exist with name {0}.

3943

TIMS-3943: DHCP option space already exists with name {0}.

3944

TIMS-3944: DHCP option space: {0} cannot be deleted as it has sub options defined in it.

3945

TIMS-3945: DHCP sub option with option number {0} has been already defined.

3946

TIMS-3946: DHCP option space cannot be updated as the sub options defined in it are used in the option template(s).

3947

TIMS-3947: Microsoft DHCP appliance does not allow multiple scopes per subnet.

3948

TIMS-3948: Option space name cannot be a predefined option space names like dhcp, agent, server, space, nwip, and fqdn.

3949

TIMS-3949: Option param {0} has been associated to another sub option in the option space: {1}. Please select the different parameter number.

3950

TIMS-3950: Vendor class name already associated with existing other option space.

3951

TIMS-3951: Cannot {0} option space with name {1} as it is already defined for the custom folder.

3952

TIMS-3952: Ping poller MAC address is in the MAC exclusion list. Please enter a different MAC address.

3953

TIMS-3953: DHCP option space name "{0}" contains one or more whitespace. Please enter a name without a space.

3954

TIMS-3954: Both Shared network name and appliance address cannot be null.

3955

TIMS-3955: DHCP poller cannot be {0} with the given data as the DHCP-M/DHCP-A object already exists with the Name: {1}.

3956

TIMS-3956: DHCP-M/DHCP-A object cannot be {0} with the given data as the DHCP poller already exist with the Name: {1}.

3957

TIMS-3957: DHCP poller cannot be {0} as the IP address is with in the scope ranges.

3958

TIMS-3958: Cannot {0} custom folder with name {1} as it is already defined for the option space.

3959

TIMS-3959: Cannot associate DHCP client class to Microsoft DHCP enabled subnet.

3960

TIMS-3960: Microsoft DHCP peer cannot be created as message authentication is enabled but secret key is not provided. To resolve this, please add a column SHARED_SECRET in the header of the CSV file to be imported and provide value in the data row.

3961

TIMS-3961: Failed to get the {0} information from the DHCP Appliance {1}. Please check if the appliance is up and running

3962

TIMS-3962: DHCP appliance type should be either of "DHCP" or "MSDHCP".

3963

TIMS-3963: DHCP option template: {0} has the router value as "Same as in subnet profile" but subnet profile does not have router defined in it.

3964

TIMS-3964: DHCP option template: {0} has the subnet mask value as "Same as in subnet profile" but subnet profile does not have mask value.

3965

TIMS-3965: DHCP option template: {0} has the domain value as "Same as the primary domain in subnet profile" but subnet profile does not have domain defined in it.

3966

TIMS-3966: Scope does not exist for object range: {0} in {1} organization.

3967

TIMS-3967: Policy template cannot be deleted as it is associated to one or more DHCP IPv6 appliances.

3968

TIMS-3968: Cannot delete the active leases for the Microsoft DHCP enabled scope.

3969

TIMS-3969: Please give the valid scope range.

3970

TIMS-3970: Response timeout while {0} for the DHCP appliance: {1}.

3971

TIMS-3971: Cannot {0} as IPAM is not able to communicate with the associated DHCP appliance. Please check if the DHCP appliance:{1} is up and running.

3973

TIMS-3973: User is not authorized to modify SNMP counter/Fingerprint values.

3974

TIMS-3974: DHCP Appliance: {0} does not exist in the organization: {1}.

3975

TIMS-3975: Microsoft DHCP appliance does not exist with the specified name {0} .

3976

TIMS-3976: DHCP fingerprint data cannot be updated as it has reference with active lease objects

4000

TIMS-4000: Authentication type code is not valid: {0}

4002

TIMS-4002: The first name should be specified while creating/updating an user.

4003

TIMS-4003: The last name should be specified while creating/updating an user.

4004

TIMS-4004: The email id should be specified while creating/updating an user.

4005

TIMS-4005: User id is not valid: {0}

4006

TIMS-4006: first_name, middle_name, last_name, or email_id cannot be null.

4007

TIMS-4007: User does not exist: {0} {1} {2}

4008

TIMS-4008: User does not exist: {0}

4009

TIMS-4009: Admin group already exists: {0}

4010

TIMS-4010: Login name is not valid: {0}

4011

TIMS-4011: Target type is not valid: {0}

4012

TIMS-4012: Admin group is not valid: {0}

4013

TIMS-4013: Invalid User/Password specified.

4015

TIMS-4015: All the auth tokens cannot be de-activated.

4016

TIMS-4016: Auth token has expired.

4017

TIMS-4017: Auth token is not specified.

4018

TIMS-4018: Admin name is not valid: {0}

4019

TIMS-4019: Target is not valid.

4020

TIMS-4020: Target does not exist: {0}

4021

TIMS-4021: Please select a session token to de-activate.

4022

TIMS-4022: Admin does not exist: {0}

4023

TIMS-4023: SNMP Trap destination is not configured.

4024

TIMS-4024: SNMP Community string is not configured.

4025

TIMS-4025: Target {0} already exists.

4050

TIMS-4050: Login name is not valid.

4051

TIMS-4051: Password should be at least {0} characters long.

4052

TIMS-4052: Password should not be longer than 20 characters.

4053

TIMS-4053: Password should not contain any references to the admin's organization, login name, first name, or last name.

4054

TIMS-4054: Password should contain at least one letter and one number.

4055

TIMS-4055: Password should contain at least one capital letter, one letter and one number.

4056

TIMS-4056: Password should contain at least one letter, one number and one of the special characters !@#$%

4057

TIMS-4057: Password should not match with the last {0} passwords.

4058

TIMS-4058: Login name already exists : {0}

4059

TIMS-4059: Please specify a login name.

4060

TIMS-4060: Authentication type is not valid : {0}

4061

TIMS-4061: TACACS+ Server is not configured.

4062

TIMS-4062: TACACS+ Server {0} is not up.

4063

TIMS-4063: TACACS+ Server password is not configured.

4064

TIMS-4064: RADIUS Server is not configured.

4065

TIMS-4065: RADIUS Server {0} is not up.

4066

TIMS-4066: RADIUS Server access key is not configured.

4067

TIMS-4067: LDAP Server is not configured.

4068

TIMS-4068: LDAP Server {0} is not up.

4069

TIMS-4069: LDAP Server port is not configured.

4070

TIMS-4070: KERBEROS Key Distribution Center (KDC) is not configured.

4071

TIMS-4071: KERBEROS Key Distribution Center (KDC) {0} is not up.

4072

TIMS-4072: KERBEROS Realm is not configured.

4073

TIMS-4073: Both session_id and login_id cannot be null.

4074

TIMS-4074: Session is not valid.

4075

TIMS-4075: Invalid Config Type Specified.

4076

TIMS-4076: Invalid Config Entity Specified.

4077

TIMS-4077: Cannot find config entity for name {0}

4078

TIMS-4078: Config entity already exists.

4080

TIMS-4080: Invalid Firewall Rule specified. Please check Rule {0}

4081

TIMS-4081: The {0} rule(s) could block the critical communication between IPAM and remote appliances.

4090

TIMS-4090: SAML Identity Provider Entity ID is not configured.

4091

TIMS-4091: SAML Identity Provider Single Sign On URL is not configured.

4092

TIMS-4092: SAML Identity Provider Logout URL is not configured.

4093

TIMS-4093: SAML Identity Provider Certificate is not configured.

4099

TIMS-4099: Please set all the required AD/LDAP global configuration parameters.

4100

TIMS-4100: Global Option does not exist: {0}

4101

TIMS-4101: Config parameter setting failed : {0}

4102

TIMS-4102: Global Option name is null.

4103

TIMS-4103: None of the NTP appliance(s) are reachable.

4104

TIMS-4104: Global Option: {0} cannot be changed to 'yes' as there are one or more authoritative appliances are recursion enabled.

4201

TIMS-4201: Please select a row.

4202

TIMS-4202: Please select a row to modify.

4203

TIMS-4203: Please select a row to delete.

4301

TIMS-4301: Appliance {0} does not exist.

4302

TIMS-4302: Appliance and Template do not belong to the same Organization.

4303

TIMS-4303: Object type for this list cannot be changed as it contains defined appliance.

4304

TIMS-4304: Operation is not specified for the {0} restore.

4305

TIMS-4305: Subnet has been created successfully but the object creation has failed for the range specified in the subnet template as the sequence number of the selected Object Type has reached its limit.

4306

TIMS-4306: {0} is not valid: {1}.

4307

TIMS-4307: Use another name for {0} as "ALL" is reserved for a predefined alias name.

4308

TIMS-4308: Invalid value specified for alias {0}.

4309

TIMS-4309: Detected multiple {0} with the same name: {1}.

4310

TIMS-4310: User value {0} specified in the user alias: {1} is restricted from the global policy.

4311

TIMS-4311: User value {0} specified in the user alias: {1} is restricted.

4312

TIMS-4312: Command {0} specified in the command alias: {1} is restricted from the global policy.

4313

TIMS-4313: Invalid sudoers option specified in default environment Variable: {0}.

4314

TIMS-4314: Cannot delete the VRF as it has references in one or more subnet templates.

4315

TIMS-4315: Cannot delete the discovery template as it has references in one or more subnet templates.

4316

TIMS-4316: Cannot delete the DHCP failover peer as it has references in one or more subnet templates.

4317

TIMS-4317: Cannot delete the shared network as it has references in one or more subnet templates.

4331

TIMS-4331: The Elevated Privileges configuration has syntax error at line(s): {0}.

4332

TIMS-4332: The Intrusion Prevention settings has syntax error: {0}.

4333

TIMS-4333: Cannot import the TCPWave's default IPS rules.

4335

TIMS-4335: Cannot add/update IPS rule as Intrusion Prevention is disabled.

4600

TIMS-4600: DHCP poller does not exist with name: {0}.

4601

TIMS-4601: DHCP poller already exists with same name: {0}

4602

TIMS-4602: DHCP Appliances does not exist in the {0} organization.

4603

TIMS-4603: Shared Network: {0} does not exist with given name for the DHCP appliance: {1}.

4604

TIMS-4604: DHCP failover Peer: {0} does not match with the selected primary DHCP appliance:{1}

4605

TIMS-4605: Object address range does not belong to any network in the organization {0}.

4606

TIMS-4606: Unable to update the DHCP peer:"{0}" as IPAM is not able to communicate with the DHCP appliance: {1}. Please check if the DHCP appliance is up and running.

4607

TIMS-4607: Unable to update the DHCP peer: {0}. Please check the DHCPTask.log on {1} remote for more information.

4608

TIMS-4608: Failed to get the interface: {0} information. Please enter the valid interface name.

4609

TIMS-4609: Cannot delete all DHCP Scope objects for windows DHCP enabled subnet as DHCP manual objects exist, Please delete DHCP manual objects first and try to delete scope.

4610

TIMS-4610: Cannot delete Microsoft DHCP scope {0} as DHCP manual objects exist in subnet {1}, Please delete DHCP manual objects first and try to delete scope.

4611

TIMS-4611: Subnet(s) cannot be updated with new domain as the DHCP objects will have different domain from subnet primary domain.

4612

TIMS-4612: Auto sync operation is currently in progress. Please check the Last sync Time column for more information.

4613

TIMS-4613: Cannot update Microsoft DHCP/DNS Auto Sync Schedule job data, please update interval duration from the Microsoft DHCP/DNS Appliance details screen page.

4614

TIMS-4614: Cannot delete Microsoft DHCP/DNS Auto Sync Schedule job, please disable Auto sync from the Microsoft DHCP/DNS Appliance details screen page.

4615

TIMS-4615: Cannot perform {0} as Microsoft DHCP appliance: {1} is configured to read only mode.

4616

TIMS-4616: Cannot perform {0} as Auto sync configuration is still in progress for Microsoft DHCP appliance: {1} .

4617

TIMS-4617: Cannot perform {0} operation for the object: {1} as the dynamic objects cannot have user defined resource records.

4618

TIMS-4618: Object {0} cannot be {1} as the domain {2} is not associated to the subnet.

4619

TIMS-4619: Failed to {0} {1}{2} because a maximum of {3} domains can be associated as secondary domains.

4620

TIMS-4620: DHCP {0} template does not exist with name:{1} in {2} organization.

4622

TIMS-4622: Input Password is not matching with the password in the database for the user:{0}

4623

TIMS-4623: Account lock functionality is applicable only for FADM accounts.

4624

TIMS-4624: Cannot update subnet from {0} DHCP Subnet to {1} DHCP subnet. Please delete all the DHCP elements of the subnet scopes, manual/Auto objects and try.

4625

TIMS-4625: Cannot create DHCP Exclusion range as the subnet:{0} is not associated to any DHCP appliance.

4626

TIMS-4626: Cannot create DHCP Exclusion range as the scope is not defined for the subnet.

4627

TIMS-4627: Cannot delete DHCP Exclusion range as the static/DHCP reservation objects are defined and cannot be added them to DHCP range.

4628

TIMS-4628: DHCP Exclusion range are supported only for Microsoft DHCP Enabled subnet.

4629

TIMS-4629: Cannot create DHCP Exclusion range:{0} as it not being subset of scope:{1}

4630

TIMS-4630: Cannot add same DHCP class in allow and deny mode for same scope.

4631

TIMS-4631: Please specify the value for the param:{0} as IP Address array format.

4632

TIMS-4632: DHCP custom folder does not exist with name:{0}

4633

TIMS-4633: DHCP Class cannot be deleted as it is being used in IPv4 subnet template.

5001

TIMS-5001: Template name already exists.

5002

TIMS-5002: Template name already exists in DNS Option Templates.

5003

TIMS-5003: Template name already exists in DHCP Option Templates.

5004

TIMS-5004: Template name already exists in DNS Zone Templates.

5005

TIMS-5005: Template name already exists in DHCP Policy Templates.

5006

TIMS-5006: Template name {0} already exists.

5009

TIMS-5009: Option Template does not exist.

5010

TIMS-5010: Parameter does not exist.

5011

TIMS-5011: Parameter does not exist: {0}

5012

TIMS-5012: Default template cannot be deleted: {0}

5013

TIMS-5013: Template Name is null.

5015

TIMS-5015: Template delete failed as one or more appliances are using this template.

5016

TIMS-5016: Template delete failed as one or more zones are using this template.

5017

TIMS-5017: Template delete failed as one or more subnets are using this template.

5018

TIMS-5018: Template delete failed as one or more scopes are using this template.

5019

TIMS-5019: Template delete failed as one or more DHCP objects are using this template.

5020

TIMS-5020: Template does not exist: {0}

5021

TIMS-5021: Template is not updated as there are subnets using this template with different subnet mask.

5022

TIMS-5022: The option router is not removed from the template as it is associated with one or more subnets.

5023

TIMS-5023: Template is not updated as there are subnets which use this template that do not have a primary router.

5024

TIMS-5024: Template is not updated as it is associated with a subnet and the option router does not belong to the corresponding subnet.

5025

TIMS-5025: Parameter cannot be modified as it is being used in option template(s).

5026

TIMS-5026: Template cannot be {0} as there is no router object defined with the address: {1}

5027

TIMS-5027: Template cannot be created/updated as there are syntax errors in the parameters. Please check the application log for more information. Contact Customer support if you need assistance.

5028

TIMS-5028: Template does not exist.

5029

TIMS-5029: Template name is not specified.

5030

TIMS-5030: Parameter name is null.

5031

TIMS-5031: Both template name and id cannot be null.

5032

TIMS-5032: Template is not deleted as other appliance(s) is(are) using it. Please remove the referencing appliance(s) and retry.

5033

TIMS-5033: Appliance Template does not exist.

5034

TIMS-5034: Custom parameter creation failed as custom DHCP option cannot be defined with name: {0}

5035

TIMS-5035: DHCP Template does not exist: {0}

5036

TIMS-5036: Parameter cannot be deleted as it is being used in option template(s).

5037

TIMS-5037: A Folder with this name already exists.

5038

TIMS-5038: Folder has options defined in it. Please delete or move them before deleting the folder.

5039

TIMS-5039: Template does not exist for organization.

5040

TIMS-5040: Template does not exist with name={0} and Appliance Type={1}.

5041

TIMS-5041: Template does not exist with name={0}

5042

TIMS-5042: Please select a template to delete.

5043

TIMS-5043: Please enter at least one option. Cannot create an empty template.

5044

TIMS-5044: Please select a template to modify.

5045

TIMS-5045: Cannot modify more than one template at a time.

5046

TIMS-5046: Please enter at least one option. Cannot save an empty template.

5047

TIMS-5047: Please select a DHCP option template.

5048

TIMS-5048: Please select a policy to modify.

5049

TIMS-5049: The selected template is a default template. It cannot be modified.

5050

TIMS-5050: Please select a template to clone.

5051

TIMS-5051: Please select at least one TSIG Algorithm for use in dynamic updates.

5052

TIMS-5052: Please select an algorithm to delete.

5053

TIMS-5053: Please select a logger to delete.

5054

TIMS-5054: DHCP configuration generation failed due to syntax errors. Please check the log: /opt/tcpwave/logs/Tims.log. Contact Customer support if you need assistance.

5055

TIMS-5055: Cannot clone more than one template at a time.

5056

TIMS-5056: Please select a policy template to delete.

5057

TIMS-5057: Please select subnets to create.

5058

TIMS-5058: Please select a rule to delete.

5059

TIMS-5059: Policy file {0} does not exist.

5060

TIMS-5060: The selected template is a default template. It cannot be deleted.

5061

TIMS-5061: Please enter a valid policy file.

5062

TIMS-5062: Template is not valid.

5063

TIMS-5063: Default template cannot be modified: {0}

5101

TIMS-5101: Getting Node info has failed.

5102

TIMS-5102: Accepting Node has failed.

5144

TIMS-5144: NSD Appliance cannot be selected as a Slave as one or more DNS View(s) are associated with it.

5201

TIMS-5201: Please select an organization to modify.

5202

TIMS-5202: Please select an organization to delete.

5203

TIMS-5203: Please select an organization.

5204

TIMS-5204: Organization contains: {0}. Please delete them first and retry.

5205

TIMS-5205: Please select an organization to update resource records.

5206

TIMS-5206: Please select an organization to add resource records.

5207

TIMS-5207: Template id is null.

6001

TIMS-6001: Please select a custom folder to modify.

6002

TIMS-6002: Please select a custom folder to delete.

6101

TIMS-6101: Invalid Product License. Please contact support.

6102

TIMS-6102: Product License expired. Please contact support.

6103

TIMS-6103: License is not valid for this appliance. Please update the license or contact TCPWave Customer Support for more information.

6104

TIMS-6104: Product License is missing. Please contact TCPWave Customer Support for more information.

6105

TIMS-6105: Object cannot be created as license limit of maximum objects, {0}, reached.

6106

TIMS-6106: Scope cannot be created as license limit of maximum objects, {0}, exceeds.

6107

TIMS-6107: Import failed as the license limit of maximum objects, {0}, exceeds.

6501

TIMS-6501: Invalid category.

6502

TIMS-6502: Invalid widget name.

6503

TIMS-6503: Invalid mask length.

7002

TIMS-7002: Permission information cannot be retrieved.

7003

TIMS-7003: The user is not authorized to perform this operation.

7004

TIMS-7004: Please select a DHCP Template.

7005

TIMS-7005: Please select the permissions to remove.

7006

TIMS-7006: Please select permissions to remove for the admin.

7007

TIMS-7007: The user is not authorized to access {0}.

7050

TIMS-7050: Configuration generation is not in progress.

7051

TIMS-7051: Configuration generation is already in progress.

7052

TIMS-7052: An unexpected problem has occurred while updating the configuration. Please check if the associated appliance is up and running.

7053

TIMS-7053: Failed to generate monitoring configurations.

7054

TIMS-7054: Successfully generated monitoring configurations.

7056

TIMS-7056: Monitoring Services updated successfully.

7701

TIMS-7701: This command can be executed only on a master appliance.

7702

TIMS-7702: This command cannot be executed on a slave appliance.

7777

TIMS-7777: Specified Asset already exists: {0}

7778

TIMS-7778: The Asset cannot be deleted as it is being referred from object(s): {0}

7779

TIMS-7779: Invalid Asset specified: {0}

7780

TIMS-7780: Please specify an Asset.

7781

TIMS-7781: The Asset serial number cannot be changed as it is being referred from object(s): {0}

7782

TIMS-7782: Serial number cannot be null.

7783

TIMS-7783: Subnet cannot be null.

7784

TIMS-7784: Please specify the desired subnet mask length.

7785

TIMS-7785: Next available subnet for desired mask does not exist.

7786

TIMS-7786: VPC does not exist" {0}.

7800

TIMS-7800: This action can impact system performance. Please try creating maximum of 6048 scopes in a single transaction.

8000

TIMS-8000: Job Status information is not valid.

8001

TIMS-8001: JobId is null.

8002

TIMS-8002: Job Type is null.

8003

TIMS-8003: Job Data is null.

8004

TIMS-8004: Job Schedule Type is null.

8005

TIMS-8005: Job Start Date is null.

8006

TIMS-8006: Please select job run time.

8007

TIMS-8007: Job Id is empty.

8008

TIMS-8008: Job Data is empty.

8009

TIMS-8009: Job Type is empty.

8010

TIMS-8010: Job Schedule Type is empty.

8011

TIMS-8011: Job Execution Time is null.

8012

TIMS-8012: Job Status Execution Status is null.

8013

TIMS-8013: Scheduler connection error: {0}

8014

TIMS-8014: Job Id, {0} does not exist in the scheduler.

8015

TIMS-8015: Scheduler Internal Error.

8017

TIMS-8017: TCPWave IPAM Appliance Internal Error.

8018

TIMS-8018: TCPWave IPAM connection error.

8019

TIMS-8019: Operation is not specified for the scheduled job : {0}.

8020

TIMS-8020: Invalid operation {0} is specified for the scheduled job : {1}.

8021

TIMS-8021: Job handler is not defined for the scheduled job {0}.

8022

TIMS-8022: Please select a job to modify.

8023

TIMS-8023: Please select a job to delete.

8024

TIMS-8024: Please select job execution time.

8025

TIMS-8025: Please select day of the week for scheduling.

8026

TIMS-8026: Please select day of the month for scheduling.

8027

TIMS-8027: Please select job start date.

8028

TIMS-8028: Please select job repeat interval.

8029

TIMS-8029: Schedule operation {0} is not valid.

8030

TIMS-8030: Job execution time cannot be in the past.

8031

TIMS-8031: Job start time cannot be in the past.

8032

TIMS-8032: Job end time cannot be earlier than the start time.

8033

TIMS-8033: JobType, {0} is not valid.

8034

TIMS-8034: JobId is either null or empty.

8035

TIMS-8035: JobId cannot start with Rest_ or Patch_ and followed by digits.

8036

TIMS-8036: A Job with the same jobId already exists.

8037

TIMS-8037: file {0} does not exist.

8038

TIMS-8038: Handler for the event {0} is not implemented.

8039

TIMS-8039: Event handler class {0} is not implemented.

8040

TIMS-8040: Handler {0} is not a concrete implementation.

8041

TIMS-8041: Handler {0} does not have a no-arg constructor.

8042

TIMS-8042: Event handler is not defined correctly.

8043

TIMS-8043: {0} is not a regular file.

8044

TIMS-8044: {0} is not an executable file.

8045

TIMS-8045: Please enter a Job identifier.

8046

TIMS-8046: Please select the job type.

8047

TIMS-8047: Please enter the job data.

8048

TIMS-8048: Job scheduled status is null.

8050

TIMS-8050: TCPWave IPAM internal jobs cannot be deleted.

8051

TIMS-8051: JobId {0} does not exist.

8052

TIMS-8052: Job will never get scheduled with current settings.

8053

TIMS-8053: The purge_days is null.

8054

TIMS-8054: Error during file add. Please check logs.

8055

TIMS-8055: Failed to modify file. Please try again.

8056

TIMS-8056: Failed to delete file. Please try again.

8057

TIMS-8057: JobId cannot be longer than 64 characters.

8058

TIMS-8058: Please enter a valid string for JobId. Accepted characters are a-z, A-Z, 0-9, and "_".

8059

TIMS-8059: Please select report start date.

8060

TIMS-8060: Please select report end date.

8061

TIMS-8061: Invalid Date. The date format should be : mm/dd/yyyy.

8062

TIMS-8062: Invalid month specified. The month value should be between 1 to 12.

8063

TIMS-8063: Invalid day specified. The day should be between 1 to 31, depending on the month selected.

8064

TIMS-8064: Invalid year specified.

8065

TIMS-8065: Please enter a valid date.

8066

TIMS-8066: Accepting discovered devices has failed. Please check the logs for more information.

8067

TIMS-8067: Please select a job to execute.

8068

TIMS-8068: {0} type jobs cannot be executed using this option.

8069

TIMS-8069: DNS Appliance name is not specified for the sync operation.

8070

TIMS-8070: DHCP Appliance name is not specified for the sync operation.

8071

TIMS-8071: The IP Address {0} is defined in two or more organizations. Please choose a different IP Address.

8072

TIMS-8072: {0} is null.

8073

TIMS-8073: An incorrect value, {0} is specified for {1}.

8074

TIMS-8074: {0} job is in paused state. Please resume the job before executing it.

8075

TIMS-8075: {0} job is already in {1} state.

8076

TIMS-8076: {0} job is already {1} type of job.

8080

TIMS-8080: Cannot change appliance type of BIND AUTH as it is used by one or more zones as Master/Slave.

8085

TIMS-8085: Cannot change appliance type of BIND AUTH as it is used by one or more zones as Master.

8086

TIMS-8086: Cannot change appliance type of NSD to {0} as it is used by one or more zones as Slave.

8087

TIMS-8087: Cannot change the DNS Appliance to stealth as it is defined as a slave appliance in one or more zone templates.

8088

TIMS-8088: Cannot change the DNS Appliance to stealth as it is defined as a master appliance in root zone.

8089

TIMS-8089: Cannot change the DNS Appliance to stealth as it is defined as a master appliance in zone template and it doesn't have any slave appliances associated.

8101

TIMS-8101: Service to restart jetty server is not defined.

8102

TIMS-8102: Appliance address is empty.

8103

TIMS-8103: Service to update the client address for AMQ is not defined.

8121

TIMS-8121: Appliance Type cannot be modified as it is used by Proxy Root Zone.

8201

TIMS-8201: Package name is null.

8202

TIMS-8202: Major version is null.

8203

TIMS-8203: Minor version is null.

8204

TIMS-8204: Checksum is null.

8205

TIMS-8205: Package name is empty.

8206

TIMS-8206: Patch name is null.

8207

TIMS-8207: Patch level is null.

8208

TIMS-8208: Patch package_id is null.

8211

TIMS-8211: Patch name is empty.

8212

TIMS-8212: Appliance Id is null.

8215

TIMS-8215: Appliance name is null.

8220

TIMS-8220: Patch extraction error : {0}

8221

TIMS-8221: Package name is not specified in the metadata file.

8222

TIMS-8222: Checksum is not specified in the metadata file.

8223

TIMS-8223: Patch files extraction from {0} failed.

8224

TIMS-8224: Please select a package to delete.

8225

TIMS-8225: Metadata file does not exist in {0}

8226

TIMS-8226: The install file {0} does not exist in the zip file.

8227

TIMS-8227: Patch is not approved by TCPWave. Please contact the TCPWave customer service.

8228

TIMS-8228: The file type is not valid.

8229

TIMS-8229: Size of the rpm file is null.

8230

TIMS-8230: Appliance type is null.

8231

TIMS-8231: Install file name is not specified in the metadata file.

8232

TIMS-8232: Package does not exist.

8233

TIMS-8233: Package zip file name is null.

8234

TIMS-8234: Patch zip file name is null.

8235

TIMS-8235: Package {0} is not present in the repository.

8236

TIMS-8236: IPAM patch repository {0} does not exist.

8237

TIMS-8237: Error while publishing the patch :{0}

8238

TIMS-8238: Installation image checksum validation failed.

8239

TIMS-8239: Installation image size validation failed.

8240

TIMS-8240: Size of the install image is not specified in the metadata file.

8241

TIMS-8241: Please select a patch to deploy.

8242

TIMS-8242: Deployment of this patch is already in progress.

8243

TIMS-8243: Patch is already deployed to this appliance.

8244

TIMS-8244: Patch is already scheduled for deployment.

8245

TIMS-8245: Patch cannot be rolled back as it is not deployed on the appliance.

8246

TIMS-8246: Please select schedule time.

8247

TIMS-8247: Patch is either not validated or validation has failed.

8248

TIMS-8248: Patch delete failed : {0}

8249

TIMS-8249: Time stamp is null.

8251

TIMS-8251: JobId is null.

8252

TIMS-8252: Patch deployment schedule status update failed : {0}

8253

TIMS-8253: Patch roll back scheduled status update failed : {0}

8254

TIMS-8254: Please select an appliance to deploy.

8255

TIMS-8255: Please select an appliance to roll back from.

8256

TIMS-8256: Please select a patch to roll back.

8257

TIMS-8257: Patch job cannot be scheduled as a repetitive operation.

8260

TIMS-8260: Patch Level is not specified in the metadata file.

8261

TIMS-8261: Patch Name is not specified in the metadata file.

8262

TIMS-8262: Patch level is not set correctly in the metadata file.

8263

TIMS-8263: Patch rollback failed. Error{0}.

8264

TIMS-8264: Required package for the patch is not deployed.

8265

TIMS-8265: Patch does not exist in the database.

8266

TIMS-8266: Patch cannot be deployed as the prerequisite patches are not deployed.

8267

TIMS-8267: Patch cannot be rolled back as other deployed patches depend on it.

8268

TIMS-8268: Appliance IP address is null.

8269

TIMS-8269: Schedule time cannot be in the past.

8270

TIMS-8270: The installation image size validation failed : {0}

8271

TIMS-8271: Package is currently installed on appliance(s).

8272

TIMS-8272: There are uploaded patches which depend on this package.

8273

TIMS-8273: Patch is currently installed on other appliance(s).

8274

TIMS-8274: Other patches depend on this patch.

8275

TIMS-8275: Please select at least one appliance type.

8276

TIMS-8276: Please select at least one appliance.

8277

TIMS-8277: Package already exists or failed to add.

8278

TIMS-8278: Patch modify failed.

8279

TIMS-8279: Patch delete failed.

8280

TIMS-8280: Please select a patch.

8281

TIMS-8281: Please select a patch to show history.

8282

TIMS-8282: Please select at least one appliance to delete.

8283

TIMS-8283: Please select at least one appliance to add.

8284

TIMS-8284: Target update file is not specified in the meta-data file.

8285

TIMS-8285: Install method specified is not correct : {0}

8286

TIMS-8286: An error occurred while patching the target file : {0}

8287

TIMS-8287: An error occurred while adding the patch to the repository : {0}

8288

TIMS-8288: Patch version numbers don't match with the Appliance Version.

8289

TIMS-8289: Package type patch is not supported.

8290

TIMS-8290: Patch rollback operation is in progress. Please wait until it is finished.

8291

TIMS-8291: Patch rollback operation is scheduled. Please wait until it is completed.

8292

TIMS-8292: Deployment of this patch is in progress. Please wait until it is finished.

8293

TIMS-8293: Patch deployment operation is scheduled. Please wait until it is completed.

8294

TIMS-8294: Secure communication between IPAM and remote appliance is currently not functioning. Please ensure that the remote appliance is operational and check if a firewall is blocking the communication.

8295

TIMS-8295: Patch deployment failed. Error : {0}

8296

TIMS-8296: Patch {0} depends on this patch. Therefore, this patch cannot be rolled back.

8297

TIMS-8297: The version information for the current IPAM server is not available.

8298

TIMS-8298: Please upload a valid zip file.

8299

TIMS-8299: The uploaded zip file does not contain the csv files with the pre defined names for organization import. Please refer the help section to know about the naming convention of the csv files.

8300

TIMS-8300: Please upload a valid csv or txt file.

8301

TIMS-8301: {0}

8302

TIMS-8302: Scheduled job does not exist: {0}

8303

TIMS-8303: Certificate get list failed : {0}

8304

TIMS-8304: Certificate is not valid : {0}

8305

TIMS-8305: Certificate delete operation failed : {0}

8306

TIMS-8306: Please select a certificate to delete.

8307

TIMS-8307: This certificate cannot be deleted as it is the only certificate in the keystore with private key.

8308

TIMS-8308: An error occurred while changing the certificate store password : {0}

8309

TIMS-8309: Keystore is not valid : {0}

8310

TIMS-8310: The keystore is empty.

8311

TIMS-8311: There are more than one certificate in the keystore.

8312

TIMS-8312: The keystore does not exist : {0}

8313

TIMS-8313: An error occurred while publishing the certificate to remote systems : {0}

8314

TIMS-8314: Please select a certificate to publish to remote systems.

8315

TIMS-8315: An error occurred while reading the keystore file: {0}

8316

TIMS-8316: Please enter Message Certificate KeyStorage Password.

8317

TIMS-8317: Please enter Certificate file.

8318

TIMS-8318: Please enter Certificate Keystore file.

8319

TIMS-8319: Please enter Certificate Keystore Password.

8320

TIMS-8320: Certificate delete operation failed. Please retry with the correct password. Please contact TCPWave Customer Support if additional assistance is required.

8321

TIMS-8321: Certificate delete operation has failed. Please check the TCPWave IPAM WebServer Log for more information or contact TCPWave Customer Support if additional assistance is required.

8322

TIMS-8322: Certificate import operation failed. Please retry with the correct password. Please contact TCPWave Customer Support if additional assistance is required.

8323

TIMS-8323: Certificate import operation has failed. Please check the TCPWave IPAM WebServer Log for more information or contact TCPWave Customer Support if additional assistance is required.

8324

TIMS-8324: Certificate import operation failed. Please retry with the correct Private Key file. Please check the log file for more information or contact TCPWave Customer Support if additional assistance is required.

8325

TIMS-8325: Keystore validation has failed. Please check the TCPWave IPAM WebServer Log for more information or contact TCPWave Customer Support if additional assistance is required.

8326

TIMS-8326: Keystore validation operation failed. Please retry with the correct password. Please contact TCPWave Customer Support if additional assistance is required.

8327

TIMS-8327: Keystore password change operation failed. Please retry with the correct password. Please contact TCPWave Customer Support if additional assistance is required.

8328

TIMS-8328: Keystore password change operation has failed. Please check the TCPWave IPAM WebServer Log for more information or contact TCPWave Customer Support if additional assistance is required.

8329

TIMS-8329: Mandatory certificate {0} cannot be deleted.

8330

TIMS-8330: Certificate Keystore password cannot be null or empty.

8331

TIMS-8331: Certificate Keystore password should contain at least one letter, one number and one of the special characters !@#$%.

8332

TIMS-8332: Certificate keystore password should be at least {0} characters long.

8333

TIMS-8333: Certificate has already expired.

8334

TIMS-8334: Certificate is not valid yet.

8336

TIMS-8336: Private Key password should contain at least one letter, one number and one of the special characters !@#$%.

8337

TIMS-8337: Private key password should be at least {0} characters long.

8338

TIMS-8338: Alarm Subscription does not exist.

8339

TIMS-8339: Alarm Component type does not exist.

8340

TIMS-8340: Monitoring threshold does not exist.

8341

TIMS-8341: Invalid Level name: {0}. Level should be specified either as appliance or appliance_group.

8342

TIMS-8342: Level name cannot be null. It should be specified either as appliance or appliance_group.

8343

TIMS-8343: There are no {0} appliances associated with any Appliance Group.

8401

TIMS-8401: Bit Mask should be at least 8.

8402

TIMS-8402: Bit Mask should be at least 16.

8403

TIMS-8403: Bit Mask should be at least 24.

8501

TIMS-8501: Please enter a valid file path.

8502

TIMS-8502: Please enter a valid named pipe path.

8503

TIMS-8503: Please enter a valid list of user names separated by commas.

8504

TIMS-8504: Please enter a valid IP address.

8505

TIMS-8505: Please add at least one message type to log.

8506

TIMS-8506: Please select at least one facility.

8601

TIMS-8601: Configuration type is null.

8602

TIMS-8602: Configuration type is empty.

8603

TIMS-8603: Configuration type does not exist : {0}

8604

TIMS-8604: Appliance type is null.

8605

TIMS-8605: Appliance type is empty.

8606

TIMS-8606: Log name is null.

8607

TIMS-8607: Log name is empty.

8608

TIMS-8608: {0} log does not exist for {1} appliance type.

8609

TIMS-8609: Configuration type is either null or empty.

8610

TIMS-8610: Appliance type is either null or empty.

8611

TIMS-8611: Please configure the Central Logging on the IPAM appliance before enabling the Central logging on the remote appliance.

8612

TIMS-8612: Central Logging feature is not implemented.

8613

TIMS-8613: Failed to enable the central logging for the DHCP Appliance. Please check if the associated appliance is up and running.

8614

TIMS-8614: Failed to enable the central logging for the DNS Appliance. Please check if the associated appliance is up and running.

8615

TIMS-8615: Appliance type {0} is not valid.

8616

TIMS-8616: Central Configuration is null.

8617

TIMS-8617: Central Configuration is not valid.

8618

TIMS-8618: Central Appliance Configuration is null.

8619

TIMS-8619: Central Appliance configuration setting options is not valid.

8620

TIMS-8620: Appliance address {0} is not valid.

8700

TIMS-8700: VRF with this name already exists in the specified organization. Please try with a different name.

8701

TIMS-8701: VRF with this name does not exist in the specified organization.

8702

TIMS-8702: VRF cannot be deleted as it is associated with one or more subnet(s).

8703

TIMS-8703: VRF does not exist: {0} {1}

8704

TIMS-8704: VRF cannot be deleted as it is associated with one or more network(s).

8800

TIMS-8800: The RPZ Policy file name is null.

8801

TIMS-8801: Please select a policy rule to update.

8802

TIMS-8802: Please select a policy rule to delete.

8803

TIMS-8803: Please select a policy file to delete.

8804

TIMS-8804: Please select a policy file to update.

8805

TIMS-8805: Please select a policy file to download.

8806

TIMS-8806: Only one policy rule can be updated at a time.

8807

TIMS-8807: Policy file is not valid.

8808

TIMS-8808: Please enter a policy file.

8809

TIMS-8809: Policy trigger is either null empty.

8810

TIMS-8810: RPZ Policy trigger {0} is not valid.

8811

TIMS-8811: RPZ Policy rr {0} is not valid.

8812

TIMS-8812: RPZ Policy rh value {0} is not valid.

8813

TIMS-8813: Policy file name is either null or empty.

8814

TIMS-8814: Policy file name {0} is not valid.

8815

TIMS-8815: Policy file {0} does not exist.

8816

TIMS-8816: Policy file {0} is being used by template {1}. Therefore, it cannot be deleted.

8817

TIMS-8817: An error has occurred while deleting the RPZ policy file {0}.

8818

TIMS-8818: An error occurred while retrieving the policy file {0}.

8819

TIMS-8819: An RPZ policy file update is already in progress by {0}. Please try again later.

8820

TIMS-8820: RPZ Policy file name is not valid.

8821

TIMS-8821: RPZ Template name {0} is not valid.

8822

TIMS-8822: RPZ Zone name {0} is not valid.

8823

TIMS-8823: RPZ Server Key name {0} is not valid.

8824

TIMS-8824: RPZ Server Key value {0} is not valid.

8825

TIMS-8825: RPZ Template is null.

8826

TIMS-8826: RPZ Zone name is either null or empty.

8827

TIMS-8827: RPZ Template name is either null or empty.

8828

TIMS-8828: RPZ Server Key name is either null or empty.

8829

TIMS-8829: RPZ Server Key value is either null or empty.

8830

TIMS-8830: Please enter a name for the template.

8831

TIMS-8831: Please enter Zone name.

8832

TIMS-8832: Please enter an appliance IP.

8833

TIMS-8833: Please enter Communication Key Name.

8834

TIMS-8834: Please enter a value for Communication Key.

8835

TIMS-8835: Please enter Policy file.

8836

TIMS-8836: Invalid information.Please add comma separated values in the order ,,,.

8901

TIMS-8901: Replication user password is either null or empty.

8902

TIMS-8902: The Secondary Appliance Database is down.

8903

TIMS-8903: The Secondary Appliance IPAM Service is down.

8904

TIMS-8904: The service request pay load is either empty or null.

8905

TIMS-8905: Port {0} is already in use. Please select a different port.

9004

TIMS-9004: Age of the audit entries to keep is less than 0.

9005

TIMS-9005: The delimiting time is null.

9006

TIMS-9006: Failed to create {0}

9007

TIMS-9007: Age of the audit entries to preserve is not defined.

9008

TIMS-9008: {0} as disk utilization is more than 90%. Current disk utilization is {1}.

9101

TIMS-9101: An error has occurred while restoring database. Please check the TCPWave IPAM WebServer Log for details.

9212

TIMS-9212: A sync is currently in progress initiated by {0} from {1}. Please wait until it is completed.

9213

TIMS-9213: A download config is currently in progress initiated by {0} from {1}. Please wait until it is completed.

9214

TIMS-9214: Integrity checks of the DNS configuration files is OK but the remote: {0} encountered an error. Please verify the monitoring alerts and the remote's DNS Logs. Contact customer support if additional assistance is required.

9215

TIMS-9215: A DNS config update is currently in progress initiated by {0} from {1}. Please wait until it is completed.

9250

TIMS-9250: Internal User cannot be modified, cloned or deleted.

9251

TIMS-9251: Internal User twcadm cannot be cloned or deleted.

9252

TIMS-9252: Multiple FADM users are not supported.

9253

TIMS-9253: Multiple FADM users are present. Please delete all FADM users other than system and twcadm and retry.

9254

TIMS-9254: Functional Admin access is disabled.

9300

TIMS-9300: Please select a single contact to modify.

9301

TIMS-9301: Please select a contact to modify.

9302

TIMS-9302: Please select a contact to delete.

9303

TIMS-9303: Please select schedule run time.

9304

TIMS-9304: Please select at least one Admin.

9305

TIMS-9305: Please select a single admin to modify.

9306

TIMS-9306: Please select an admin to modify.

9307

TIMS-9307: Please select a single admin to clone.

9308

TIMS-9308: Please select an admin to clone.

9309

TIMS-9309: Please select a single admin to change password.

9310

TIMS-9310: Please select an admin to unlock/change password.

9311

TIMS-9311: Please select an admin to delete.

9312

TIMS-9312: Current selection exceeds the allowable Email size. Please modify your criteria or use CSV file download.

9313

TIMS-9313: Current selection exceeds the allowable PDF rows limit than the global option default page rows. Please modify your criteria or use CSV file download.

9314

TIMS-9314: Export to CSV failed.

9315

TIMS-9315: Please select at least one contact.

9316

TIMS-9316: The specified IP address does not exist.

9317

TIMS-9317: Contact id {0} does not exist.

9318

TIMS-9318: The Contact cannot be deleted as it is being referred from object(s): {0}

9319

TIMS-9319: There is no data in the input audit backup file.

9401

TIMS-9401: Both Provider Type name and id cannot be null.

9402

TIMS-9402: Provider Type name is not valid : {0}

9403

TIMS-9403: Provider Type id is not valid : {0}

9404

TIMS-9404: Provider Type name is null.

9405

TIMS-9405: Provider Type already exists: {0}

9406

TIMS-9406: Both Provider name and id cannot be null.

9407

TIMS-9407: Provider name is not valid: {0}

9408

TIMS-9408: Provider id is not valid: {0}

9409

TIMS-9409: Provider name already exists: {0}

9410

TIMS-9410: Provider name is missing.

9411

TIMS-9411: Both Provider id and Zone Template id are null.

9412

TIMS-9412: Provider name or Zone Template name is not valid.

9413

TIMS-9413: Provider new name is missing.

9414

TIMS-9414: Provider name is null.

9415

TIMS-9415: Provider is used in zone template(s). Please dissociate those template(s) from the provider and try again.

9416

TIMS-9416: Please select a zone template to dissociate.

9417

TIMS-9417: Please select a provider to modify.

9418

TIMS-9418: Please select a Provider to delete.

9419

TIMS-9419: Please enter the application name.

9420

TIMS-9420: Cloud Provider cannot be deleted as it is associated with one more subnet(s).

9421

TIMS-9421: There is no object associated with the IP address {0} .

9422

TIMS-9422: The image {0} is not valid.

9423

TIMS-9423: Cloud Provider Name cannot be null.

9424

TIMS-9424: Cloud Provider does not belong to the organization of the user.

9425

TIMS-9425: Both cloud instance template name and ID cannot be null.

9426

TIMS-9426: Cloud instance template does not exist: {0}

9427

TIMS-9427: Cloud instance template id is not valid: {0}

9428

TIMS-9428: Cloud Instance template already exists: {0}

9429

TIMS-9429: Cloud instance template cannot be deleted as it is associated with existing cloud instance objects.

9430

TIMS-9430: Cloud provider does not exist.

9431

TIMS-9431: Cloud instance does not exist.

9432

TIMS-9432: Region is mandatory to create an AWS cloud provider.

9492

TIMS-9492: Please select a storage to delete.

9493

TIMS-9493: Please select a Tag to delete.

9494

TIMS-9494: Please enter User.

9495

TIMS-9495: Please enter Password.

9496

TIMS-9496: Please enter Customer Name.

9497

TIMS-9497: Please enter Account.

9498

TIMS-9498: Please enter URI.

9499

TIMS-9499: Please enter API Key.

9500

TIMS-9500: Please enter Credentials.

9501

TIMS-9501: Please enter values for the mandatory fields.

9502

TIMS-9502: There is no failover appliance defined. So, cannot initiate the failover.

9503

TIMS-9503: The {0} appliance {1} did not respond for license update. Please check if the associated appliance is up and running.

9504

TIMS-9504: License update has failed for the {0} appliance {1}. Please enter a valid license key.

9505

TIMS-9505: Please reset the DR configuration before updating with new configuration.

9506

TIMS-9506: The Master Appliance IP is either null or empty.

9507

TIMS-9507: The DR configuration can be reset from the Master IPAM Appliance only.

9508

TIMS-9508: The DR can be configured from the Master IPAM Appliance only.

9509

TIMS-9509: The sync operation is in progress. Please try later.

9510

TIMS-9510: The failover operation is already in progress.

9511

TIMS-9511: A DR activity is already in progress.

9512

TIMS-9512: A DR activity is in progress.

9513

TIMS-9513: The master and slave appliances are same.

9514

TIMS-9514: If search string contains one of these special characters + - && || ! ( ) { } [ ] ^ " ~ * ? : \\, please escape such character by placing \\ before the character.

9515

TIMS-9515: The backup {0} has been taken in {1} mode. Currently the system is in {2} mode so restoration of database can not be performed.

9516

TIMS-9516: The backup {0} has been taken at patch level {1}. Currently the system is at level {2}. There are database related changes in between patches so restoration of database can not be performed.

9517

TIMS-9517: The backup {0} has been taken in high availability configuration mode with {1} nodes ( {2} ). Currently the system is in high availability configuration mode with {3} nodes ( {4}) so restoration of database can not be performed.

9518

TIMS-9518: The backup {0} has been taken in disaster recovery configuration mode with master {1} and slave {2}. Currently the system is in disaster recovery configuration mode with master {3} and slave {4} so restoration of database can not be performed.

9519

TIMS-9519: The database can not be restored as the backup {0} has been taken at the patch level {1} where as the current the patch level is {2} which has database schema changes.

9520

TIMS-9520: The input argument is null for DR Configure service call.

9521

TIMS-9521: The Slave Appliance IP is either null or empty.

9522

TIMS-9522: The Master Appliance Port is either null or empty.

9523

TIMS-9523: The Slave Appliance Port is either null or empty.

9524

TIMS-9524: The Master Appliance address {0} is not valid.

9525

TIMS-9525: The Slave Appliance address {0} is not valid.

9526

TIMS-9526: Disaster Recovery(DR) is already configured.

9527

TIMS-9527: IPAM Appliance {0} is not compatible. Please check it's version.

9528

TIMS-9528: FADM user only can configure the Disaster Recovery setup.

9529

TIMS-9529: Disaster Recovery(DR) is not configured in this appliance's environment.

9550

TIMS-9550: Please ensure that bucket name has been configured in global options and it exists in AWS S3.

9551

TIMS-9551: Global option does not exist : AWS_S3_BUCKET_NAME.

9552

TIMS-9552: Unable to locate AWS S3 CLI credentials. Please configure the AWS CLI credentials.

9553

TIMS-9553: Bucket does not exist : {0}

9554

TIMS-9554: Failed to dump the database.

9555

TIMS-9555: Error occurred while making tar.gz file of database snapshots.

9556

TIMS-9556: Error occurred while uploading tar.gz file to AWS S3.

9557

TIMS-9557: DNS View is disabled in the TCPWave IPAM.

9558

TIMS-9558: AWS Machine Image ID does not exist.

9559

TIMS-9559: Maximum number of tags allowed is 50. Please delete a Tag to add a new one.

9560

TIMS-9560: {0} tag already exists.

9561

TIMS-9561: Existing owner of the resource record cannot be null.

9562

TIMS-9562: Resource record type cannot be null.

9563

TIMS-9563: Invalid Resource record type.

9564

TIMS-9564: Existing data of the resource record cannot be null.

9565

TIMS-9565: Checkout group name cannot be null.

9566

TIMS-9566: Checkout Group name does not exist.

9567

TIMS-9567: Checkout policy name cannot be null.

9568

TIMS-9568: Checkout Policy name does not exist.

9569

TIMS-9569: Checkout Baseline operation is not applicable for specified policy.

9570

TIMS-9570: Invalid Checkout ID.

9571

TIMS-9571: Resource record cannot be null.

9572

TIMS-9572: Resource record with type:{0} and owner:{1} does not exist.

9573

TIMS-9573: Baseline operation cannot be performed as the actual value cannot be found.

9574

TIMS-9574: Database backup is in progress. Please try later.

9575

TIMS-9575: Database backup is in progress. Hence, incremental backup is not performed.

9576

TIMS-9576: Database initialization snapshot cannot be deleted.

9577

TIMS-9577: DNS Flatten record does not exist.

9578

TIMS-9578: DNS Flatten record already exist.

9579

TIMS-9579: DNS Proxy Root Zone does not exist in the selected organization.

9581

TIMS-9581: Contingency Service with specified CNAME already exist.

9582

TIMS-9582: The Zone delete operation has failed because of references in the contingency service definitions.

9583

TIMS-9583: CNAME resource record with owner: {0} already exist.

9584

TIMS-9584: Resource record with type:{0}, owner:{1} and data:{2} already exists.

9585

TIMS-9585: DNS Flatten CNAME zone:{0} does not exist.

9586

TIMS-9586: DNS Flatten CNAME record cannot be deleted as there are one or more Zone Normal RRs are defined with the zone name: {0}.

9600

TIMS-9600: Extension already exists.

9601

TIMS-9601: Invalid Extension Type specified.

9602

TIMS-9602: Low value should be less than or equal to the High value.

9603

TIMS-9603: Invalid Entity specified.

9604

TIMS-9604: Specified Extension does not exist.

9605

TIMS-9605: Please select an Extension to delete.

9606

TIMS-9606: Please select an Extension to modify.

9607

TIMS-9607: Invalid input specified.

9608

TIMS-9608: Invalid parameter {0} specified for the {1} Option Template.

9609

TIMS-9609: Invalid data specified for the parameter {0}, valid data is {1}.

9610

TIMS-9610: Prefix:{0} and Suffix:{1} combination already exists.

9611

TIMS-9611: Please select a valid value for the List type extension.

9701

TIMS-9701: Please enter a valid name: {0}.

9702

TIMS-9702: Please enter a valid value: {0}.

9703

TIMS-9703: Please enter a valid owner name: {0}.

9704

TIMS-9704: The owner name: {0} that you have entered violates the IPAM Host Naming Convention. Please choose a non-business offensive name.

9705

TIMS-9705: The object name:{0} that you have entered violates the IPAM Host Naming Convention. Please choose a non-business offensive name.

9706

TIMS-9706: Policy Name: {0} already exists.

9707

TIMS-9707: Policy Name: {0} does not exist.

9708

TIMS-9708: The domain name: {0} that you have entered violates the IPAM Host Naming Convention. Please choose a non-business offensive name.

9709

TIMS-9709: The zone name: {0} that you have entered violates the IPAM Host Naming Convention. Please choose a non-business offensive name.

9710

TIMS-9710: The alias name:{0} that you have entered violates the IPAM Host Naming Convention. Please choose a non-business offensive name.

9720

TIMS-9720: selected policy(ies) does not exist.

9730

TIMS-9730: Please select a single appliance to delete.

9731

TIMS-9731: Host name already exists with a name: {0}.

9732

TIMS-9732: Host name cannot be null.

9733

TIMS-9733: Domain name cannot be null.

9741

TIMS-9741: DNS View cannot be deleted as it is associated with one or more zone(s).

9800

TIMS-9800: The object cannot be moved as an object with the specified destination address: {0} already exists. Please delete the object or enter another unallocated object.

9801

TIMS-9801: The object cannot be moved as it is a DHCP object.

9802

TIMS-9802: The object with object type: {0} cannot be moved.

9803

TIMS-9803: The object: {0} cannot be moved as it is referenced in ACL definitions.

9804

TIMS-9804: The object: {0} cannot be moved as it is referenced in DHCP templates.

9805

TIMS-9805: The object: {0} cannot be moved as duplicate object definitions found with the specified destination object: {1}

9806

TIMS-9806: The object: {0} cannot be moved as the destination object does not exist.

9807

TIMS-9807: The object cannot be moved as the object: {0} does not exist.

9808

TIMS-9808: The object: {0} cannot be moved as it's MAC Address matches with the MAC address of the object: {1}.

9809

TIMS-9809: Cannot move object as an alias to itself.

10000

TIMS-10000: There is no IPV4 DHCP Appliance defined with the address specified.

10001

TIMS-10001: There is no IPV4 Object defined with the address specified.

10002

TIMS-10002: There is already a DHCP Appliance that is associated with this IPv4 DHCP Appliance. Please choose a different address.

10100

TIMS-10100: A DNS View with this name already exists: {0}

10101

TIMS-10101: Both algorithm id and algorithm code cannot be null.

10102

TIMS-10102: Both view id and view name cannot be null.

10103

TIMS-10103: DNS View does not exist for name: {0}

10104

TIMS-10104: DNS View cannot be deleted as it is associated with one more appliance(s).

10105

TIMS-10105: DNS View cannot be created with name 'Default'. 'Default' is a reserved view.

10106

TIMS-10106: 'Default' DNS View cannot be modified.

10107

TIMS-10107: 'Default' DNS View cannot be deleted.

10108

TIMS-10108: DNS View cannot be deleted from the appliance as one or more zone(s) are associated with this view.

10109

TIMS-10109: One or more resource records are associated with the view that are not associated to the zone.

10110

TIMS-10110: Both Match Client and Match Destination cannot be empty.

10111

TIMS-10111: DNS View cannot be deleted as it is associated with one or more object(s).

10112

TIMS-10112: DNS View cannot be deleted as it is associated with one or more subnet(s) or resource record(s).

10113

TIMS-10113: The selected template does not have the views managed by this zone.

10114

TIMS-10114: Primary domain cannot be changed as it is associated with one or more object(s) with its view.

10115

TIMS-10115: DNS View cannot have values for Match Clients and Match Destinations to coexist. They are mutually exclusive.

10116

TIMS-10116: Selected Master/Slave appliance does not contain any common DNS Views as that of Master/Slave appliances.

10117

TIMS-10117: DNS64 Prefix cannot be deleted as it is associated with one more appliance(s).

10118

TIMS-10118: A DNS64 Prefix with this name already exists: {0}

10119

TIMS-10119: Please enter the values for Match Clients or Match Destinations.

10120

TIMS-10120: Domain Controllers cannot be added/deleted as the zone {0} is not active directory enabled.

10121

TIMS-10121: Domain Controller {0} already exists for the zone {1}.

10122

TIMS-10122: Domain Controller {0} does not exist for the zone {1}.

10123

TIMS-10123: Match Clients cannot have null or empty value.

10124

TIMS-10124: Match Destinations cannot have null or empty value.

10125

TIMS-10125: Domain Controllers cannot be deleted as the zone {0} is active directory enabled and atleast one Domain Controller is required.

11007

TIMS-11007: Invalid DNS view name : {0}

11008

TIMS-11008: DNS view {0} is not associated with DNS zone {1}

11009

TIMS-11009: DNS view {0} is not associated with subnet.

11011

TIMS-11011: Prefix field cannot be null.

11012

TIMS-11012: Suffix field cannot be null.

11013

TIMS-11013: Invalid Initial sequence number specified, valid values are 1 to 99999.

11014

TIMS-11014: Prefix-Zeros should be 'yes' or 'no'.

11015

TIMS-11015: Please enter a valid Object type.

11016

TIMS-11016: Please enter a valid Prefix/Suffix.

11017

TIMS-11017: Object Type cannot be null.

11018

TIMS-11018: Sequence number of the selected Object Type has reached its limit, please choose another Object type.

11019

TIMS-11019: Description field cannot be Null.

11020

TIMS-11020: Auto Generate Host Name is disabled, please enable and try again.

11030

TIMS-11030: Policy Name field cannot be null.

11031

TIMS-11031: Policy Value field cannot be null.

11032

TIMS-11032: Policy Type field cannot be null.

11033

TIMS-11033: Policy Description cannot be null.

11034

TIMS-11034: Policy value is invalid.

11035

TIMS-11035: Allow Dotted Host Names global options is set to NO, please enter object name without .(dot).

11037

TIMS-11037: Please select a single appliance to download the configuration.

11038

TIMS-11038: Please select a single appliance to synchronize the configuration.

11040

TIMS-11040: Please select only one appliance to get the options.

11041

TIMS-11041: Policy type should be "RegEx" or "Contains".

11042

TIMS-11042: Selected View: {0} is not defined in the organization: {1}. Please refresh the page to get the available views.

11043

TIMS-11043: Subnet: {0} does not exist in the organization: {1}.

11044

TIMS-11044: Name cannot be null for IDN converter.

11045

TIMS-11045: Network Mask cannot be null.

11047

TIMS-11047: Invalid domain name specified in IDN field.

11050

TIMS-11050: Invalid subnet type specified.

11051

TIMS-11051: Invalid allocation type specified for address range {0}.

11052

TIMS-11052: Invalid DHCP class specified for address range {0}.

11053

TIMS-11053: Invalid permission value specified for DHCP class.

11054

TIMS-11054: Invalid lease time value specified.

11055

TIMS-11055: DHCP server not specified.

11056

TIMS-11056: Invalid DHCP server {0} specified.

11057

TIMS-11057: Subnet template name not specified.

11058

TIMS-11058: Invalid address range {0} specified.

11059

TIMS-11059: Router address clashes with the range {0}.

11060

TIMS-11060: Invalid values specified for the static address range {0}.

11061

TIMS-11061: Required values missing for the dynamic range {0}.

11062

TIMS-11062: Same DHCP class is specified in the allow and deny list for the address range {0}.

11063

TIMS-11063: Dynamic address range {0} defined for a non DHCP enabled subnet.

11064

TIMS-11064: Invalid value specified for primary router option.

12001

TIMS-12001: One or more Objects in the Subnet(s):{0} are associated to Cloud Instances. Please delete those objects before deleting Subnet(s).

12002

TIMS-12002: One or more Objects in this Network are associated to Cloud Instances. Please delete those objects before deleting Network.

12003

TIMS-12003: ACL Name cannot be Null.

12004

TIMS-12004: ACL Reference(s) not found.

12005

TIMS-12005: The Root device cannot be deleted.

12010

TIMS-12010: Old and new passwords are same.

12011

TIMS-12011: Please choose an Organization.

12012

TIMS-12012: Please select an object type to auto generate a name.

12013

TIMS-12013: Auto Host Naming Policy is disabled. Please enable it to Auto generate object name.

12014

TIMS-12014: Auto hostname for the selected Object type is already generated, please select another object type.

12015

TIMS-12015: Root zone is already enabled for this organization.

12016

TIMS-12016: Root zone is already disabled for this organization.

12017

TIMS-12017: Please select an Organization to bookmark.

12018

TIMS-12018: The bookmark limit has reached the maximum value. Please delete existing bookmarks or increase the maximum limit of Global option.

12019

TIMS-12019: Standard object Types cannot be modified.

12020

TIMS-12020: Subnet address cannot be null.

12030

TIMS-12030: CNAME does not refer to a valid AAAA record.

12031

TIMS-12031: No AAAA record found for given owner name: Please enter a valid AAAA record name.

12032

TIMS-12032: AAAA or CNAME "{0}" record already exists for an Object: {1}.

12033

TIMS-12033: AAAA or CNAME {0} record already exists in Zone: {1}.

12034

TIMS-12034: Owner name does not point to a valid AAAA record.

12035

TIMS-12035: No AAAA record found for given owner/mail server/data: {0} Please enter a valid AAAA record name

12040

TIMS-12040: Object Allocation Type cannot be changed to Manual DHCP or Dynamic DHCP as Resource Records are present for this object.

12041

TIMS-12041: Resource Records cannot be added to Objects of allocation type Manual DHCP or Dynamic DHCP.

12042

TIMS-12042: Failed to {0} {1}. Please try again later.

12043

TIMS-12043: DHCP class name is missing.

12044

TIMS-12044: DHCP Fingerprint Information is not available for this object.

12045

TIMS-12045: The zone {0} is not hosted on any authoritative DNS appliances managed by the TCPWave IPAM.

12046

TIMS-12046: The reverse zone {0} is not hosted on any authoritative DNS appliances managed by the TCPWave IPAM.

12047

TIMS-12047: The DHCP Peer name needs to be unique.

12048

TIMS-12048: The DHCP Peer cannot have the same server as both primary and secondary.

12049

TIMS-12049: Please enter all the mandatory values for the DHCP Failover Configuration.

12050

TIMS-12050: Both Zone id and Zone name cannot be null.

12051

TIMS-12051: A resource record or object with the name: {0} already exists.

12052

TIMS-12052: The name: {0} conflicts with an existing Mirrored Zone.

12053

TIMS-12053: The DHCP Failover peer cannot be deleted as it is associated to one or more subnets.

12054

TIMS-12054: The DHCP Failover peer with name: "{0}" does not exist.

12055

TIMS-12055: Mirrored Zone name cannot be null.

12056

TIMS-12056: Mirrored Zone does not exist.

12057

TIMS-12057: Duplicate Mirrored Zone name entry for {0}.

12058

TIMS-12058: Mirrored Zones cannot be created as it is exceeding maximum limit {1} defined in the global options for the zone {0}.

12059

TIMS-12059: DHCP Server cannot be deleted as it is associated to one or more DHCP Failover Peers.

12060

TIMS-12060: DHCP Failover Peer with the given Primary and Failover DHCP Servers already exists.

12061

TIMS-12061: Cannot enable the active directory updates to the zone: {0} as it is associated with one or more Mirrored Zones.

12062

TIMS-12062: Given IP address is not found in the network range for the selected reverse zone.

12063

TIMS-12063: There is no bookmark to remove.

12064

TIMS-12064: Both id and query string cannot be null.

12065

TIMS-12065: Both id and name of Mirrored Zone cannot be null.

12066

TIMS-12066: The subnet(s) could not be created/modified as the selected primary DHCP Server does not match with that of the DHCP Peer.

12070

TIMS-12070: Object creation failed. The name of this object conflicts with an existing Mirrored Zone. Please try with a different name.

12071

TIMS-12071: Appliance group already exists: {0}.

12072

TIMS-12072: Appliance group does not exist: {0}.

12073

TIMS-12073: Unable to delete the selected appliance group as it has references.

12074

TIMS-12074: Both Appliance group name and id cannot be null.

12075

TIMS-12075: Appliance group cannot be deleted as it has child groups associated.

12076

TIMS-12076: Appliance group {0} cannot be updated as the specified parent group {1} is a child to {2}.

12077

TIMS-12077: Parent appliance group does not exist: {0}.

12078

TIMS-12078: Appliance group {0} cannot be a child/parent to itself.

12080

TIMS-12080: A subnet :{0} with the given address is already managed by IPAM. Please enter another address for NS record.

12081

TIMS-12081: NS record with the address:{0} already exists. Please enter another address.

12083

TIMS-12083: Organization contains: {0} View(s). Please delete them first and retry.

12084

TIMS-12084: Cannot get DS record as DNSSEC is not enabled to the zone: {0}.

12085

TIMS-12085: DS records for the zone: {0} does not exist.

12090

TIMS-12090: This ccTLD already exists.

12091

TIMS-12091: This Router object type cannot be changed as it is associated with the subnet: {0} .

12092

TIMS-12092: Object type update has failed for the object: {0} as it is defined as a primary router for the subnet: {1}.

12093

TIMS-12093: Bulk object type update has failed as one of the object: {0} is defined as a primary router for the subnet: {1}.

12094

TIMS-12094: Entered object address range is overlapping with existing address range. Please try different range.

12095

TIMS-12095: Please enter the start offset value.

12096

TIMS-12096: Please enter the subnet address.

12097

TIMS-12097: Router object offset clashes with the entered address range.

12098

TIMS-12098: Router object offset clashes with the address range {0} to {1}.

12099

TIMS-12099: One or more domains are referenced in subnet templates. Please delete those references and try again.

12100

TIMS-12100: Domain used in the address range from {0} to {1} of the Subnet Template is not a primary or secondary domain of the subnet.

12101

TIMS-12101: Domain category cannot be null or empty.

12102

TIMS-12102: Invalid domain category type specified.

12103

TIMS-12103: Configuration status specified in the central logging configuration is null or empty.

12104

TIMS-12104: Configuration status specified in the central logging configuration is null or empty.

12105

TIMS-12105: Configuration name specified in the central logging configuration is null or empty.

12106

TIMS-12106: Configuration name specified in the central logging configuration is invalid.

12107

TIMS-12107: Configuration type specified in the central logging configuration is null or empty.

12108

TIMS-12108: Configuration type specified in the central logging configuration is invalid.

12109

TIMS-12109: Server type specified in the central logging configuration is null or empty.

12110

TIMS-12110: Server type specified in the central logging configuration is invalid.

12111

TIMS-12111: Log status specified in the central logging configuration is null or empty.

12112

TIMS-12112: Log status specified in the central logging configuration is invalid.

13000

TIMS-13000: IPAM Appliance IP Address is null.

13001

TIMS-13001: IPAM Master setting is null.

13002

TIMS-13002: IPAM Appliance {0} does not exist.

13003

TIMS-13003: Remote Appliance IP Address is null.

13004

TIMS-13004: Remote Appliance type is null.

13005

TIMS-13005: Remote Appliance {0} of type {1} does not exist.

13007

TIMS-13007: IPAM Appliance {0} and Remote Appliance {1} association does not exist.

13008

TIMS-13008: HA is already configured.

13009

TIMS-13009: HA is not configured in this appliance's environment.

13010

TIMS-13010: Appliance address {0} is not valid.

13011

TIMS-13011: IPAM Appliance {0} is already part of the HA environment.

13012

TIMS-13012: IPAM Appliance {0} is not compatible with other IPAM Appliances in the HA environment. Please check the versions.

13013

TIMS-13013: IPAM Appliance {0} did not respond.

13014

TIMS-13014: The IPAM Appliance {0} version information could not be obtained.

13015

TIMS-13015: An error occurred while updating the firewall settings for new IPAM Appliance: {0}

13016

TIMS-13016: IPAM Appliance {0} is not part of the HA environment.

13017

TIMS-13017: The Master IPAM Appliance cannot be removed from the HA environment.

13018

TIMS-13018: An IPAM Appliance cannot remove itself from the HA environment.

13019

TIMS-13019: IPAM Appliance {0} is already the Master in the HA environment.

13020

TIMS-13020: An IPAM Appliance is already being configured as the Master in the HA environment.

13021

TIMS-13021: The Resource Name is either null or empty.

13022

TIMS-13022: The Resource Type is either null or empty.

13023

TIMS-13023: The Resource Operation is either null or empty.

13024

TIMS-13024: The Resource Sub-Operation is either null or empty.

13025

TIMS-13025: The resource transfer sessionId is either null or empty.

13026

TIMS-13026: The resource transfer chunk content is either null or empty.

13027

TIMS-13027: The resource transfer sequence number is either null or empty.

13028

TIMS-13028: The HA Configuration can be reset from the Master IPAM Appliance only.

13029

TIMS-13029: The HA Configuration can be reset when there is only one IPAM Appliance in the HA Configuration.

13030

TIMS-13030: The Destination IP is either null or empty for resource sync operation.

13031

TIMS-13031: The License for High Availability Cluster is not present. Please contact TCPWave Support.

13032

TIMS-13032: Please configure High Availability first.

13033

TIMS-13033: Disaster Recovery(DR) is already configured. Please disable DR before enabling High Availability.

13034

TIMS-13034: High Availability(HA) is already configured. Please disable HA before enabling Disaster Recovery.

13035

TIMS-13035: Invalid License Key specified. HA is already configured in the system. So, please contact TCPWave Support for HA enabled license key.

13036

TIMS-13036: Disaster Recovery is not configured.

13037

TIMS-13037: There is no need to redistribute the Remote Appliances as there is only one IPAM Appliance in the HA environment.

13038

TIMS-13038: IPAM Appliance name with IP address {0} is either null or empty.

13039

TIMS-13039: IPAM Appliance name {0} clashes with an existing IPAM Appliance's name.

13040

TIMS-13040: No IPAM Appliance can be promoted as new Master.

13041

TIMS-13041: IPAM Appliance Priority setting is null.

13042

TIMS-13042: IPAM Appliance Priority {0} is not valid. It has to be between {1} and {2}.

13043

TIMS-13043: IPAM Appliance Priority is already set to {0}.

13044

TIMS-13044: Remote Appliance {0} does not exist.

13045

TIMS-13045: IPAM Appliance Preference list is null.

13046

TIMS=13046: Please select at least one IPAM Appliance to add to the preferred list.

13047

TIMS=13047: Please select at least one IPAM Appliance to delete from the preferred list.

13048

TIMS-13048: IPAM Appliance {0} did not respond for search service life cycle operation.

13049

TIMS-13049: The time difference between the current IPAM Appliance and {0} is more than the allowed {1} seconds. Please synchronize the time.

13050

TIMS-13050: The timeout is not set correctly in the Mariadb service file.

13051

TIMS-13051: The timeout is not set correctly in the Mariadb service file on {0}.

13052

TIMS-13052: The user is not set correctly in galera_recovery file.

13053

TIMS-13053: The user is not set correctly in galera_recovery file on {0}.

13054

TIMS-13054: The HA Configuration can be reset when there is only one active IPAM Appliance in the HA Configuration.

13055

TIMS-13055: The IPAM Service is down on the Appliance. Please start the service and retry the operation.

13056

TIMS-13056: IPAM Appliance {0} does not have the license to support HA functionality. Please update the license and retry.

13057

TIMS-13057: HA is already configured on the IPAM Appliance {0}.

13058

TIMS-13058: DR is configured on the IPAM Appliance {0}. Therefore, HA cannot be configured.

13059

TIMS-13059: The input argument is either null or empty for add IPAM Appliance service call.

13060

TIMS-13060: The FADM User Id is either null or empty.

13061

TIMS-13061: The FADM User Password is either null or empty.

13062

TIMS-13062: FADM User {0} does not exist.

13063

TIMS-13063: Only an FADM User can add an IPAM Appliance to the HA Cluster.

13064

TIMS-13064: The credentials provided for the FADM user {0} are not valid.

13065

TIMS-13065: The credentials provided for the FADM user {0} are valid.

13066

TIMS-13066: TCPWave IPAM device is not defined for {0}. Please define it before configuring {1}.

13067

TIMS-13067: IPAM Appliance is not defined for {0}. Please define it before configuring {1}.

13068

TIMS-13068: The argument is either null or empty for re-join cluster service call.

13069

TIMS-13069: Cannot request self IPAM Server, {0} to re-join the cluster.

13070

TIMS-13070: IPAM Appliance {0} is already part of the cluster.

13071

TIMS-13071: The node is not isolated from the cluster.

13072

TIMS-13072: The node is in an invalid state to rejoin ({0}).

13073

TIMS-13073: The remote IPAM's cluster state is null.

13074

TIMS-13074: Enter private network series: 10, 172 or 192.

13075

TIMS-13075: No network is available with the given mask.

13076

TIMS-13076: The database user password on {0} does not match with the database user password on the current IPAM.

13077

TIMS-13077: The database administrator password on {0} does not match with the database administrator password on the current IPAM.

13078

TIMS-13078: The database replication password on {0} does not match with the database replication password on the current IPAM.

13079

TIMS-13079: The IPAM Appliance keystore password on {0} does not match with the IPAM Appliance keystore password on the current IPAM.

13080

TIMS-13080: The Message client truststore password on {0} does not match with the Message client truststore password on the current IPAM.

13999

TIMS-13999: IPAM HA LAST MESSAGE PLACE HOLDER FOR THIS RANGE.

14010

TIMS-14010: DNSSEC Keys cannot be generated as DNSSEC is not enabled on Zone: {0}.

14011

TIMS-14011: Please specify the type of the key, either ZSK or KSK.

14012

TIMS-14012: Please try Manual Key Rollover after {0}.

14013

TIMS-14013: Manage services request has been submitted successfully. Please refresh the Active Appliances grid to check the status of the selected services.

14014

TIMS-14014: Object: {0} does not exist in the organization: {1}.

14020

TIMS-14020: Template cannot be created/updated as custom allow transfer/update ACL {0} contains an IP address of the managed DNS appliance name: {1}, IP: {2}.

14021

TIMS-14021: Template cannot be created/updated as custom allow transfer/update ACL {0} contains an IP address of the domain controller name: {1}, IP: {2}.

14023

TIMS-14023: Template cannot be created/updated as custom allow transfer/update contains duplicate entry for ACL {0}.

14024

TIMS-14024: Firmware patch cannot be uploaded as there is already a patch exists with same Name: {0}, Type: {1}, Size: {2} and Checksum: {3}.

14026

TIMS-14026: Resource Records cannot be added for Reserved Objects.

14027

TIMS-14027: Resource Records cannot be modified for Reserved Objects.

14028

TIMS-14028: Resource Records cannot be deleted for Reserved Objects.

14029

TIMS-14029: Reservation Expiry date cannot be in past.

14030

TIMS-14030: TACACS+ Server details are not found, so the configuration has been updated to disable TACACS.

14031

TIMS-14031: TACACS+ Server password is not set up, so the configuration has been updated to disable TACACS.

14032

TIMS-14032: Network interface lo cannot be deleted.

14033

TIMS-14033: Bond cannot be part of another bond.

14034

TIMS-14034: The loopback network interface cannot be part of bond.

14035

TIMS-14035: Virtual interface cannot be part of bond.

14036

TIMS-14036: Device {0} has already been bonded with bond {1}.

14038

TIMS-14038: The loopback network interface cannot be edited.

14039

TIMS-14039: Selected interfaces do not belong to the same subnet. Please modify the selection.

14040

TIMS-14040: Object with IP Address {0} and object type TCPWave IPAM is not found.

14041

TIMS-14041: One or more domains are referenced in address ranges defined in subnet templates. Please delete those references and try again.

14042

TIMS-14042: Template is referenced in subnet templates. Please delete those references and try again.

14043

TIMS-14043: Appliance is referenced in subnet templates. Please delete those references and try again.

14044

TIMS-14044: Cloud provider is referenced in subnet templates. Please delete those references and try again.

14045

TIMS-14045: One or more domains are referenced in IPv6 subnet templates. Please delete those references and try again.

14046

TIMS-14046: One or more domains are referenced in address ranges defined in IPv6 subnet templates. Please delete those references and try again.

14047

TIMS-14047: Template is referenced in IPv6 subnet templates. Please delete those references and try again.

14048

TIMS-14048: Appliance is referenced in IPv6 subnet templates. Please delete those references and try again.

14049

TIMS-14049: Cannot create the ACL as managed object(s) or subnet(s) or network(s) with IP addresses{0} are not available in IPAM.

14050

TIMS-14050: Cannot update the ACL as managed object(s) or subnet(s) or network(s) with IP addresses{0} are not available in IPAM.

14051

TIMS-14051: Cannot delete the discovery template as it has references in one or more networks.

14052

TIMS-14052: Cannot delete the discovery template as it has references in one or more subnets.

14053

TIMS-14053: Network Address cannot be null.

14054

TIMS-14054: Command id cannot be null.

14055

TIMS-14055: Discovery on this network has been disabled. So discovery results cannot be accepted.

14056

TIMS-14056: Cannot update the root password as the vault type is {0}.

14057

TIMS-14057: Cannot set the root password as the vault type is {0}.

14058

TIMS-14058: Object with the IP address {0} does not exist.

14059

TIMS-14059: Discovery element type cannot be null or empty.

14060

TIMS-14060: IPAM Appliance cannot be created using the selected device as it is the primary router of the subnet. Please choose a different device.

14061

TIMS-14061: Object {0} is already associated with IPAM appliance instance.

14062

TIMS-14062: Object {0} is already associated with DNS/DHCP appliance instance.

14063

TIMS-14063: IPAM Template {0} cannot be deleted as it is associated with one or more IPAM appliances.

14064

TIMS-14064: The selected device, is not of the type TCPWave IPAM. Please choose a different device.

14065

TIMS-14065: Cannot create more than one IPAM appliance template.

14066

TIMS-14066: The object with IP Address {0} of type TCPWave IPAM in the organization {1} is not present in TCPWave IPAM. Please create an object to proceed.

14067

TIMS-14067: Scheduler, DB Replicator and Search Engine cannot be managed from slave appliance in DR setup. Please deselect these services for slave appliance and try again.

14068

TIMS-14068: Scheduler, DB Replicator and Search Engine cannot be managed from a member appliance in HA Cluster. Please deselect these services for member appliance and try again.

14069

TIMS-14069: The object with IP Address {0} is associated with an IPAM appliance. So object can be created only with 'TCPWave IPAM' object type. Please change the object type and try again.

14070

TIMS-14070: Cannot delete a network as there are one or more ACLs referring to the network. Please delete the references and try again.

14071

TIMS-14071: Cannot delete subnet(s) as there are one or more ACLs referring to the subnet(s). Please delete the references and try again.

14072

TIMS-14072: The object with IP Address {0} is associated with an IPAM appliance. So object type cannot be modified.

14073

TIMS-14073: Default discovery template cannot be modified.

14074

TIMS-14074: Default discovery template cannot be deleted.

14075

TIMS-14075: Discovery template cannot be dissociate from subnet as reclaim is enabled for the subnet.

14076

TIMS-14076: NIC type should be either 'IPAM' or 'Remote'.

14077

TIMS-14077: Object type cannot be changed to Static, Automatic DHCP, Manual DHCP or Reserved as the object is part of a scope and the global option Auto Fragment DHCP Scope is disabled. Please enable the global option to change the object type.

14078

TIMS-14078: Logging status for a component cannot be null or empty.

14079

TIMS-14079: Specified logging status {0} is invalid. Valid status is enable/disable.

14080

TIMS-14080: Component name cannot be null or empty.

14081

TIMS-14081: Specified component name {0} is invalid.

14082

TIMS-14082: DNS tunnel detection cannot be enabled on DNS Proxy, NSD and Bind Auth (without recursion) appliances.

14083

TIMS-14083: DNS tunnel detection value should be 'yes' or 'no'.

14084

TIMS-14084: IPAM appliance already exist with name {0}.

14085

TIMS-14085: Cloud provider is referenced in cloud subnet discovery. Please delete those references and try again.

14091

TIMS-14091: The extension {0} does not exist for the entity: {1}.

14092

TIMS-14092: Network level reverse zone(s) cannot be deleted. Please delete network(s) to auto delete reverse zone(s).

14093

TIMS-14093: Reverse zone does not exist: {0} with the given mask.

14094

TIMS-14094: Appliance cannot be created with the router IP address.

14095

TIMS-14095: Reverse zone(s) cannot be deleted as there are one or more child reverse zones are created under this reverse zone.

14096

TIMS-14096: Monitored service name cannot be null or empty.

14097

TIMS-14097: Alert host type cannot be null or empty.

14098

TIMS-14098: Alert host type is not valid.

14099

TIMS-14099: Alert host address cannot be null or empty.

14100

TIMS-14100: Alert error message cannot be null or empty.

14101

TIMS-14101: Alert category value cannot be null or empty.

14102

TIMS-14102: Force re-check is not supported for the specified alert.

14103

TIMS-14103: The alert cannot be re-checked on the specified appliance.

14104

TIMS-14104: Alternate Query Resolver already exist with specified DNS PROXY appliance.

14105

TIMS-14105: Alternate Query Resolvers does not exist with specified organization and DNS PROXY appliance.

15000

TIMS-15000: DB Restore is in Progress, Database activity not allowed.

15001

TIMS-15001: Domain/Record should be specified for the DNS flush operation on the appliance: {0} of type: {1}.

15002

TIMS-15002: Flush operation cannot be performed on the appliance: {0} of type: {1} as recursion is not enabled.

15003

TIMS-15003: Flush operation can be performed only on cache appliance, but the appliance: {0} is of type: {1}.

15005

TIMS-15005: Please provide the resource record type of name: {0}.

15006

TIMS-15006: Both appliance IP and name cannot be null.

15007

TIMS-15007: Please enter a valid regular expression.

15008

TIMS-15008: IP Address: {0} of the PTR record: {1} is out of subnet range.

15009

TIMS-15009: Zone cannot be created/updated as there is an existing resource record with this name: {0}.

15010

TIMS-15010: Root zone cannot be disabled on the organization: {0} as there is a root zone defined in it.

15011

TIMS-15011: Router address cannot be same as Subnet address.

15012

TIMS-15012: Object address: {0} cannot be same as Subnet address.

15013

TIMS-15013: ACL cannot be deleted as it is associated to one or more appliances as SNMP ACL. Please delete those references and retry.

15014

TIMS-15014: Extension name cannot be null.

15015

TIMS-15015: Location cannot be deleted as it is associated with one or more objects.

15016

TIMS-15016: The accepted values for RRSet order are cyclic, random and fixed.

15017

TIMS-15017: The option with the name: {0} and display name:{1} already exists.

15018

TIMS-15018: Master Server's IP addresses are not valid.

15019

TIMS-15019: Only one master server is supported.

15020

TIMS-15020: Zone Transfer must be disabled.

15021

TIMS-15021: Zone Transfer must be enabled.

15022

TIMS-15022: Should have at least 3 master servers

15023

TIMS-15023: RPZ Server Key algorithm is either null or empty.

15024

TIMS-15024: RPZ Template provider is either null or empty.

15025

TIMS-15025: The Gateway value is invalid.

15026

TIMS-15026: DHCP Appliance cannot be created using the selected object as it is reserved. Please choose another object.

15031

TIMS-15031: Objects defined in the dynamic address range cannot be of type Router, TCPWave Remote, Microsoft Remote, TCPWave IPAM or Domain Controller.

15032

TIMS-15032: The Zone delete operation has failed because of references in the subnet template definitions. Please use the search functionality to obtain those references.

15033

TIMS-15033: Delete operation for zone {0} has failed because of references in the subnet template definitions. Please use the search functionality to obtain those references.

15034

TIMS-15034: The Zone delete operation has failed because of references in address ranges defined in subnet templates. Please delete those references and try again.

15035

TIMS-15035: Delete operation for zone {0} has failed because of references in address ranges defined in subnet templates. Please delete those references and try again.

15036

TIMS-15036: ACL {0} cannot be modified with TCPWave Managed Appliances as it is associated with Allow Update params.

15037

TIMS-15037: IP address {0} is used in the organization {1} in the TCPWave IPAM.

15038

TIMS-15038: Object with name {0} already exists in the organization {1} on the TCPWave IPAM.

15039

TIMS-15039: IP address cannot be null or empty.

15040

TIMS-15040: Owner name cannot be null or empty.

15041

TIMS-15041: Network: {0} exists with the range that has the IP address: {1}, but subnet does not exist.

15042

TIMS-15042: Subnet: {0} exists with the range that has the IP address: {1}, but object does not exist.

15043

TIMS-15043: Network does not exist with the range that has the IP address: {0}.

15044

TIMS-15044: Restricted domain {0} does not exist in the organization {1}.

15045

TIMS-15045: Maximum of 19 Non-Managed name servers are allowed.

15046

TIMS-15046: Please enter a valid Non-Managed Name Servers data.

15047

TIMS-15047: Please enter atleast one Non-Managed Name Server or uncheck Custom Allow Name Servers.

15048

TIMS-15048: CNAME record: {0} cannot be same as object name.

15049

TIMS-15049: Match clients value cannot be more than 1024 characters.

15050

TIMS-15050: Match destinations value cannot be more than 1024 characters.

15051

TIMS-15051: Custom Allow name appliances contains master/slave appliance {0} IP address {1}.

15052

TIMS-15052: Both Subnet Template id and name cannot be null.

15053

TIMS-15053: The domain of the object cannot be changed as the object is being used in the Active Directory Zone {0}.

15054

TIMS-15054: Sync cannot be performed on the Object {0} as the managed zone {1} does not exists.

15055

TIMS-15055: Allow Recursion value cannot be more than 1024 characters.

15073

TIMS-15073: The default admin role and the default organization does not belong to any of the associated admin groups.

15074

TIMS-15074: Please select at least one value from the grid.

15075

TIMS-15075: A Permission already exists for the given inputs.

15076

TIMS-15076: Data is not correct. Please Enter correct value.

15077

TIMS-15077: Authorization function's target list cannot be empty.

15078

TIMS-15078: {0} doesn't exist for the given values {1}.

15079

TIMS-15079: Entity type code cannot be empty or null.

15080

TIMS-15080: The dissociated admin group has permissions assigned to its roles. You should delete the existing permissions of the role functions to dissociate the selected admin group from the admin.

15081

TIMS-15081: No external NS record found for the given owner name: {0} Please enter a valid DS record owner name.

15082

TIMS-15082: Managed zone already exists with the same name {0}

15083

TIMS-15083: DS record {0} cannot be created with the external flag disabled.

15084

TIMS-15084: The object with IP Address {0} of type TCPWave IPAM does not exist. Please create an object of type TCPWave IPAM to update the IPAM appliance.

15085

TIMS-15085: DNS Zone Template cannot have both TCPWave Managed DNS appliances and Microsoft DNS appliances as masters.

15086

TIMS-15086: The DNS Zone template: {1} with Microsoft DNS Appliance as master cannot be associated to the active directory zone: {0}.

15087

TIMS-15087: Active directory cannot be enabled on the zone: {0} as the associated DNS Zone template: {1} has Microsoft DNS appliance as master.

15088

TIMS-15088: Microsoft DNS appliance with IP address: {0} does not exist.

15089

TIMS-15089: The Microsoft AD appliance name cannot be null.

15090

TIMS-15090: Selected NSM template has references in one or more DNS appliance(s). Please dis-associate the template from the DNS appliance(s) and try again.

15091

TIMS-15091: NSM Template with the same name: {0} already exists.

15092

TIMS-15092: The Microsoft AD appliance with IP address {0} does not exist.

15093

TIMS-15093: The Microsoft AD appliance {0} cannot be updated, as an object of type Microsoft Remote does not exist.

15094

TIMS-15094: The Microsoft AD site name cannot be null.

15095

TIMS-15095: The Microsoft AD site {0} does not exist.

15096

TIMS-15096: The Microsoft AD appliance IP address cannot be null.

15097

TIMS-15097: The Microsoft AD appliance {0} cannot be created, as an object of type Microsoft Remote does not exist.

15098

TIMS-15098: The Microsoft AD appliance with IP address {0} is already being managed by the TCPWave IPAM.

15099

TIMS-15099: Non-Managed name server with IP address {0} is not allowed as TCPWave Managed DNS Appliance with same IP address exist.

15100

TIMS-15100: Non-Managed name server with IP address {0} is not allowed as Microsoft DNS Appliance with same IP address exist.

15101

TIMS-15101: Appliance with IP address {0} cannot be created as non-managed name server with same IP address exist for zone {1}.

15102

TIMS-15102: Failed to get the Microsoft AD sites information from AD Appliance with IP address {0}. Please check if the appliance is up and running.

15103

TIMS-15103: The Microsoft AD appliance with IP address {0} does not exist in the given organization.

15104

TIMS-15104: DNS Forwarder zone name does not exists: {0}.

15105

TIMS-15105: Cannot {0} an object {1} with the restricted domain {2}.

15106

TIMS-15106: Discovery template cannot be null.

15107

TIMS-15107: Discovery template is not valid: {0}

15108

TIMS-15108: Discovery appliance is not valid.

15109

TIMS-15109: Discovery appliance: {0} already exists.

15110

TIMS-15110: Please enter a valid IPv6 Object address.

15111

TIMS-15111: Autonomous System Number already exists: {0}.

15112

TIMS-15112: Autonomous System Number does not exist: {0}.

15113

TIMS-15113: Security group already exists: {0}.

15114

TIMS-15114: Security group does not exist: {0}.

15115

TIMS-15115: Exclusion name cannot be null.

15116

TIMS-15116: Exclusion IP Address cannot be null.

15117

TIMS-15117: Exclusion type cannot be null.

15118

TIMS-15118: Exclusion name already exists.

15119

TIMS-15119: Router name already exists.

15120

TIMS-15120: Router name cannot be null.

15121

TIMS-15121: Cannot create an appliance template as one or more forwarder zones are conflicting with each other in the selected forwarder groups.

15122

TIMS-15122: Cannot update an appliance template as one or more forwarder zones are conflicting with each other in the selected forwarder groups..

15123

TIMS-15123: {0} cannot be deleted as it is a management interface. Please set another physical interface as a management interface before deleting this interface.

15124

TIMS-15124: The bonded interface cannot be deleted.

15125

TIMS-15125: {0} does not have IP address. Please assign IP address to it.

15126

TIMS-15126: Please select a network interface IP to delete.

15127

TIMS-15127: In the IPAM appliance, if the management interface is part of the network bonding, users can select the required IP address associated with it.

15128

TIMS-15128: Please select at least two network interfaces to bond.

15129

TIMS-15129: The duplex setting of the bond interface cannot be modified as it depends on its slave interfaces.

15130

TIMS-15130: Please select a value for speed from the drop-down menu.

15131

TIMS-15131: One of the interfaces selected for bonding is the management interface. Please set either another interface or current bonding interface as management interface by selecting the checkbox: Is Management IP.

15132

TIMS-15132: The default tables in the system cannot be edited.

15133

TIMS-15133: The default tables in the system cannot be deleted.

15134

TIMS-15134: The selected table is associated with {0}. So {1} table cannot be deleted.

15135

TIMS-15135: Please enter a valid configuration for the rules.

15136

TIMS-15136: Please enter a valid configuration for the routes.

15137

TIMS-15137: Please enter a valid configuration for rule: {0}

15138

TIMS-15138: Please enter a valid configuration for route: {0}

15139

TIMS-15139: User cannot use default tables to configure policy based routing.

15140

TIMS-15140: Enter a valid key for extra attribute. : {0}

15141

TIMS-15141: Selected network interface is a virtual interface itself. Please select non-virtual interface.

15142

TIMS-15142: Please select at least one network interface to edit.

15143

TIMS-15143: Device {0} has virtual interface. Please delete the virtual interface and try again.

15144

TIMS-15144: {0} cannot be deleted as it is a management interface.

15145

TIMS-15145: Selected subnet already exists.

15146

TIMS-15146: Discovery agent task does not exist with the command id: {0}

15147

TIMS-15147: Selected router subnet already accepted: {0}

15148

TIMS-15148: The Microsoft resolution policy {0} already exists for zone {1}.

15149

TIMS-15149: The Microsoft resolution policy {0} does not exists for zone {1}.

15150

TIMS-15150: The zone scope {0} cannot be deleted as it is associated to resolution policy {1}.

15151

TIMS-15151: The operator of server interface for the Microsoft resolution policy {0} should be either EQ or NE.

15152

TIMS-15152: The Microsoft resolution policy {0} does not exists for zone {1}.

15153

TIMS-15153: The Microsoft scope {0} already exists for zone {1}.

15154

TIMS-15154: The Microsoft scope {0} does not exists for zone {1}.

15155

TIMS-15155: The ACL {0} cannot be deleted as it is referenced in the Resolution policy {1}.

15180

TIMS-15180: Device already exist: {0}.

15181

TIMS-15181: Device does not exist with the command id: {0}.

15182

TIMS-15182: Discovery event does not exist with the command id: {0}.

15183

TIMS-15183: Discovery agent does not exist with the IP: {0}.

15184

TIMS-15184: Discovery agent cannot be deleted as it is associated with network or subnet.

15185

TIMS-15185: Discovery agent cannot be deleted as it is associated with DNS/DHCP appliance.

15186

TIMS-15186: Discovery agent IP Address can not be null.

15187

TIMS-15187: Device Credentials already exist with the name: {0}.

15230

TIMS-15230: Please Enter valid IPv6 Address.

15231

TIMS-15231: IPv6 pool: {0} cannot be created as it is conflicting with one or more existing IPv6 pools.

15232

TIMS-15232: IPv6 block does not exist: {0}

15233

TIMS-15233: IPv6 pool does not exist: {0}

15234

TIMS-15234: IPv6 block: {0} cannot be created as it is conflicting with one or more existing IPv6 blocks.

15235

TIMS-15235: There is already IPv6 DHCP Appliance defined with the address specified.

15236

TIMS-15236: There is no IPv6 Object defined with the address specified.

15237

TIMS-15237: Unable to calculate IPv6 end range for {0}.

15238

TIMS-15238: IPv6 Block {0} is out of Pool range.

15239

TIMS-15239: Both Block address and id cannot be null.

15240

TIMS-15240: IPv6 block address does not exist: {0}

15241

TIMS-15241: IPv6 subnet: {0} cannot be created as it is conflicting with one or more existing IPv6 subnet.

15242

TIMS-15242: IPv6 Object {0} is out of subnet range.

15243

TIMS-15243: Reverse zone already exists with an IPv6 Address: {0}

15244

TIMS-15244: Reverse zone(s) cannot be deleted as it is associated with an IPv6 address space.

15600

TIMS-15600: Either Virtual Appliance IP or one of the Member Appliance IP is null.

15601

TIMS-15601: Number of appliances specified is not correct.

15602

TIMS-15602: Remote Cluster is already configured with the specified appliance(s).

15603

TIMS-15603: Remote Cluster is not configured at {0}.

15604

TIMS-15604: The input argument is null.

15605

TIMS-15605: Virtual IP is either null or empty.

15606

TIMS-15606: Virtual Appliance name is either null or empty.

15607

TIMS-15607: A Member Appliance IP Address is either null or empty.

15608

TIMS-15608: Virtual IP Address {0} is not valid.

15609

TIMS-15609: Member IP Address {0} is not valid.

15610

TIMS-15610: Member Appliance does not exist with {0} address.

15611

TIMS-15611: Organization name is either null or empty.

15612

TIMS-15612: Virtual Appliance IP is either null or empty.

15613

TIMS-15613: Virtual Appliance IP Address {0} is not valid.

15614

TIMS-15614: Member Appliances belong to different organizations:{0} and {1}

15615

TIMS-15615: Member DNS Appliances are of different type: {0} and {1}

15616

TIMS-15616: A remote appliance already exists with {0} address.

15617

TIMS-15617: An error has occurred while obtaining the configuration information for member appliance {0}.

15618

TIMS-15618: Time zone is either null or empty for member appliance {0}.

15619

TIMS-15619: Time zone setting for the member appliances do not match: {0} and {1}.

15620

TIMS-15620: Subnet address is either null or empty for member node: {0}.

15621

TIMS-15621: Member Appliances are in different subnets: {0} and {1}.

15622

TIMS-15622: zebra service is configured on member node {0}. Please delete it before forming the cluster.

15623

TIMS-15623: {0} service is configured on member node {1}. Please delete it before forming the cluster.

15624

TIMS-15624: {0} member appliance has references in DNS Zone Template(s). Please remove them before forming the cluster.

15625

TIMS-15625: {0} is associated with the non-managed DNS zones. Please delete the association before forming the cluster.

15626

TIMS-15626: {0} has references in one or more subnet(s). Please dis-associate the appliance from the subnet(s) before forming the cluster.

15627

TIMS-15627: An error has occurred while checking whether the virtual IP {0} address is being used. Please retry again.

15628

TIMS-15628: The virtual IP address {0} is being used. There is an active device at this address.

15629

TIMS-15629: An error has occurred while checking member appliance version information. Please retry again.

15630

TIMS-15630: Member Appliances version information is not present for {0}. Please retry after fixing the version information.

15631

TIMS-15631: Member Appliances are at different version: {0} and {1}. Please update them so that they are at the same level and retry.

15632

TIMS-15632: Cluster Appliance does not belong to {0} organization. It belongs to {1}.

15633

TIMS-15633: Appliance type is either null or empty.

15634

TIMS-15634: Appliance does not exist at {0} address.

15635

TIMS-15635: A remote cluster is configured at {0}. Please reset the cluster first.

15636

TIMS-15636: Member Appliance {0} is not active. Please check it's heartbeat status.

15637

TIMS-15637: Sync operation is in progress for {0} member node. Please wait until it is complete.

15638

TIMS-15638: Member Appliance {0} did not respond to {1} operation. Please check whether {2} service is up and running.

15639

TIMS-15639: Member Appliance {0} did not respond with the current time. Please check whether {1} is up and running.

15640

TIMS-15640: Time difference between the member nodes is more than minimum allowed {0}.

15641

TIMS-15641: Member Appliance {0} did not respond with system type info. Please check whether {1} is up and running.

15642

TIMS-15642: Member Appliances hardware is not identical ({0} and {1}).

15643

TIMS-15643: Member addresses could not be added to the /etc/hosts file on {0}. ({1})

15644

TIMS-15644: Cluster services could not be started on {0}. ({1})

15645

TIMS-15645: Remote Cluster could not be formed on {0}. ({1})

15646

TIMS-15646: Virtual IP resource could not be created on {0}. ({1})

15647

TIMS-15647: TCPWave Named resource could not be created on {0}. ({1})

15648

TIMS-15648: TCPWave Timsdns resource could not be created on {0}. ({1})

15649

TIMS-15649: Appliance related properties could not be updated on {0}. ({1})

15650

TIMS-15650: Remote Cluster could not be destroyed on {0}. ({1})

15651

TIMS-15651: DNS Appliance Template is either null or empty for member node {0}.

15652

TIMS-15652: Member Appliances have different DNS appliance templates, {0} and {1} configured.

15653

TIMS-15653: DNS options template is either null or empty for member node {0}.

15654

TIMS-15654: Member Appliances have different DNS option templates {0} and {1} configured.

15655

TIMS-15655: Virtual Appliance has references in zone template(s). Please remove them before resetting the cluster.

15656

TIMS-15656: Virtual Appliance is associated with the non-managed DNS zones. Please delete the association before resetting the cluster.

15657

TIMS-15657: Virtual Appliance has references in one or more subnet(s). Please dis-associate the appliance from the subnet(s) before resetting the cluster.

15658

TIMS-15658: Virtual Appliance is referenced in templates. Please remove the references before resetting the cluster.

15659

TIMS-15659: Appliance {0} is not active. Please check its heartbeat status.

15660

TIMS-15660: Only FADM or SADM can perform this cluster operation.

15661

TIMS-15661: No object is defined at virtual IP address {0}.

15662

TIMS-15662: Object defined at {0} is not of type TCPWave Remote.

15663

TIMS-15663: Virtual Appliance and Member Appliance objects are in different subnets, {0} and {1}.

15664

TIMS-15664: Remote Cluster is supported on BIND AUTH and BIND CACHE type of DNS Appliances only.

15665

TIMS-15665: Appliance name should not contain underscore.

15666

TIMS-15666: Appliance {0} is also configured as a {1} Appliance. Member node should not be configured as both DNS and DHCP Appliance.

15667

TIMS-15667: Member appliance {0} is already part of a cluster.

15668

TIMS-15668: Appliance type {1} is not a valid supported remote cluster type.

15669

TIMS-15669: Current cluster settings are identical to the new settings. Hence, no action was taken.

15670

TIMS-15670: Virtual Appliance {0} did not respond. Please check whether {1} is up and running.

15671

TIMS-15671: An error was encountered while updating the cluster configuration: {0}.

15672

TIMS-15672: An error was encountered while retrieving the cluster status: {0}.

15673

TIMS-15673: Virtual Appliance does not exist at {0}.

15674

TIMS-15674: Appliance {0} is part of a cluster. Please reset the cluster first.

15675

TIMS-15675: A remote cluster is configured at {0}. Hence, an appliance cannot be configured at the same address.

15676

TIMS-15676: Appliance {0} is part of a cluster. Hence, it cannot be configured as another appliance.

15677

TIMS-15677: Appliance {0} does not have heartbeat. Hence, not resetting the cluster.

15678

TIMS-15678: TCPWave Timsdns resource could not be started on {0}. ({1})

15679

TIMS-15679: Member Appliances have different firewall templates configured. Please make them identical and retry.

15680

TIMS-15680: Member Appliances have different TACACS+ Configuration settings. Please make them identical and retry.

15681

TIMS-15681: Member Appliances have different LDAP SSH Configuration settings. Please make them identical and retry.

15682

TIMS-15682: Member Appliances have different iDRAC passwords set. Please make them identical and retry.

15683

TIMS-15683: Member Appliances have different iDRAC SNMP Community settings. Please make them identical and retry.

15684

TIMS-15684: Member Appliances have different DNS Resolvers configured. Please make them identical and retry.

15685

TIMS-15685: Member Appliances have different NTP settings. Please make them identical and retry.

15686

TIMS-15686: Member Appliances belong to different appliances groups.

15687

TIMS-15687: Member Appliances have different Elevated Privileges configured.

15688

TIMS-15688: Member Appliances have different stealth appliances configured.

15689

TIMS-15689: Recursion setting is different on member appliances.

15690

TIMS-15690: Member Appliances have different DNS over TLS setting.

15691

TIMS-15691: Member Appliances are of different Cache Appliance types (Internal vs External).

15692

TIMS-15692: Member Appliances have different DMZ Zone Visibility setting.

15693

TIMS-15693: Member Appliances have different Automatic DNSDR setting.

15694

TIMS-15694: Member Appliances have different Monitoring Service setting.

15695

TIMS-15695: Member Appliances have different NSM Templates configured.

15696

TIMS-15696: Member Appliances have different Discovery setting.

15697

TIMS=15697: Member Appliances have different Syslog settings.

15698

TIMS-15698: Member Appliances have different Views configured.

15699

TIMS-15699: Member Appliances have different DNS64 Prefixes configured.

15700

TIMS-15700: Member Appliances have different Forwarders configured.

15701

TIMS-15701: Remote Cluster Appliance type cannot be changed to {1}.

15702

TIMS-15702: Remote Cluster Member Appliance name cannot be modified.

15703

TIMS-15703: Remote Cluster Appliance name cannot be modified.

15704

TIMS-15704: Remote Cluster Member IP cannot be modified.

15705

TIMS-15705: Remote Cluster Appliance IP cannot be modified.

15706

TIMS-15706: DHCP policy template is either null or empty for member node {0}.

15707

TIMS-15707: Member Appliances have different DHCP policy templates, {0} and {1} configured.

15708

TIMS-15708: No object is defined at member appliance IP address {0}.

15709

TIMS-15709: Member Appliances have different DHCP Listening Interfaces, {0} and {1} configured.

15710

TIMS-15710: Member Appliances have different mac exclusions configured.

15711

TIMS-15711: Member Appliance {0} is associated with one or more DHCP Failover Peers. Please remove the association(s) before forming the cluster.

15712

TIMS-15712: Member Appliance {0} manages subnets. Please dis-associate the appliance from managing the subnet(s) before forming the cluster.

15713

TIMS-15713: Member Appliance {0} manages scopes. Please dis-associate the appliance from managing the scope(s) before forming the cluster.

15714

TIMS-15714: Member Appliance {0} has manual-DHCP objects associated with it. Please dis-associate the appliance from manual-DHCP objects before forming the cluster.

15715

TIMS-15715: Member Appliance {0} has Shared Networks associated with it. Please remove the association(s) before forming the cluster.

15716

TIMS-15716: Member Appliance {0} has references in subnet templates. Please remove the subnet template references before forming the cluster.

15717

TIMS-15717: Member Appliance {0} has references in file set. Please remove the file set references before forming the cluster.

15718

TIMS-15718: The DHCP Appliance at {0} is not configured as an IPV4 DHCP Appliance.

15719

TIMS-15719: Please select a remote cluster appliance to update the cluster settings.

15720

TIMS-15720: Please select a configured active remote cluster appliance to get the status information.

15721

TIMS-15721: Virtual Appliance is associated with one or more DHCP Failover Peers. Please remove the association(s) before resetting the cluster.

15722

TIMS-15722: Virtual Appliance manages subnets. Please dis-associate the appliance from managing the subnet(s) before resetting the cluster.

15723

TIMS-15723: Virtual Appliance manages scopes. Please dis-associate the appliance from managing the scope(s) before resetting the cluster.

15724

TIMS-15724: Virtual Appliance has manual-DHCP objects associated with it. Please dis-associate the appliance from manual-DHCP objects before resetting the cluster.

15725

TIMS-15725: Virtual Appliance has Shared Networks associated with it. Please remove the association(s) before resetting the cluster.

15726

TIMS-15726: Virtual Appliance has references in subnet templates. Please remove the subnet template references before resetting the cluster.

15727

TIMS-15727: Virtual Appliance has references in file set. Please remove the file set references before resetting the cluster.

15728

TIMS-15728: Member Appliances have different RPZ Templates configured.

15729

TIMS-15729: Member Appliances IP Address interface netmasks are not identical ({0} and {1}).

15730

TIMS-15730: Member Appliances have different SNMP settings. Please make them identical and retry.

15731

TIMS-15731: Member Appliance {0} has no network interface configuration defined.

15732

TIMS-15732: Network mask for the management interface is not set for member node {0}.

15733

TIMS-15733: Network masks of the managed interface are not identical for member nodes.

15734

TIMS-15734: Remote cluster appliance at {0} is part of {1} subnet. Hence, the subnet cannot be merged with other subnets.

15735

TIMS-15735: Remote cluster appliance at {0} is part of {1} subnet. Hence, the subnet cannot be split.

15799

TIMS-15799: Reserved 15600 to 15799 error numbers for remote cluster work.

16000

TIMS-16000: The dashboard name does not exist.

16001

TIMS-16001: The executive dashboard cannot be deleted.

16012

TIMS-16012: The user does not exist.

16013

TIMS-16013: The widget list cannot be null.

16014

TIMS-16014: The widget list does not exist.

16015

TIMS-16015: The dashboard id cannot be null.

16021

TIMS-16021: The dashboard name already exists.

16022

TIMS-16022: The dashboard name cannot be null.

16023

TIMS-16023: The dashboard has been updated successfully.

16024

TIMS-16024: The user cannot add more than nine widgets in a customized dashboard.

16025

TIMS-16025: The selected widget already exists in the dashboard.

16026

TIMS-16026: The widget name is not valid: {0}.

16027

TIMS-16027: The widget category name is not valid: {0}.

16028

TIMS-16028: The user cannot add more than fifteen cities clocks in a clock widget.

16200

TIMS-16200: An IPv6 DHCP Appliance sync is currently in progress. Please wait until it is completed.

16201

TIMS-16201: Appliance type cannot be modified.

16202

TIMS-16202: Total object count should not exceed 1000.

16203

TIMS-16203: The ACL name {0} matches with the autoblock anomalous traffic functionality naming convention. Please try with other name which does not start with the word "titan".

16204

TIMS-16204: The template name {0} matches with the autoblock anomalous traffic functionality naming convention. Please try with other name which does not start with the word "titan".

16205

TIMS-16205: The ACL name cannot be modified as it is created as part of the autoblock anomalous traffic functionality.

16206

TIMS-16206: The template name cannot be modified as it is created as part of the autoblock anomalous traffic functionality.

16207

TIMS-16207: Organization must be same as IPv6 Pool.

16208

TIMS-16208: Object address {0} is referenced in the Windows appliance. Please delete those references and try again.

16209

TIMS-16209: Autonomous System Number cannot be null.

16210

TIMS-16210: Autonomous System Number not exists: {0}.

16211

TIMS-16211: Autonomous System Number range should be in between 0 to 4294967295.

16212

TIMS-16212: {0} cannot be null or empty.

16213

TIMS-16213: {0} is invalid app type.

16214

TIMS-16214: App Id and contact Id both cannot be null.

16215

TIMS-16215: {0} is invalid app Id.

16216

TIMS-16216: Invalid child reverse zone name specified: {0}.

16217

TIMS-16217: Global option cannot be updated as there are references to the object or resource records with the name localhost.

16218

TIMS-16218: DNS Appliance is not reachable to perform the operation.

16219

TIMS-16219: Zone file does not exist for: {0}. Please check whether the zone exists on the Microsoft DNS appliance: {1} and has required privileges set to the provided user.
  • Note: {0}, {1}, {2} and {3} are place holders for respective entity names.