This URL adds a new device in the specified domain.
Resource URL
PUT /domain/<domain_id>/device/<device_id>
Request Parameters
URL Parameters:
| Field Name | Description | Data Type | Mandatory |
|---|---|---|---|
| device_id | Device Id | Number | Yes |
Payload Request Parameters:
| Field Name | Description | Data Type | Mandatory |
|---|---|---|---|
| deviceId | Unique device id, not required for POST | String | Yes |
| deviceName | Device name | String | Yes |
| deviceType | Device type can be IPSNACSensor/ virtualHIPSensor/ NTBAAppliance/ loadBalancer | Object | Yes |
| contactInformation | Contact information for the device | String | No |
| location | Device location | String | No |
| lastModifiedTime | Last modified time of the device | String | No |
Details of IPSNACSensor:
| Field Name | Description | Data Type | Mandatory |
|---|---|---|---|
| sharedSecret | Device shared secret key | String | Yes |
| confirmSharedSecret | Device confirmed shared secret key | String | Yes |
| updatingMode | Update mode can be ONLINE/ OFFLINE/ UNKNOWN | String | Yes |
Details of virtualHIPSensor:
| Field Name | Description | Data Type | Mandatory |
|---|---|---|---|
| sharedSecret | Device shared secret key | String | Yes |
| confirmSharedSecret | Device confirmed shared secret key | String | Yes |
Details of NTBAAppliance:
| Field Name | Description | Data Type | Mandatory |
|---|---|---|---|
| sharedSecret | Device shared secret key | String | Yes |
| confirmSharedSecret | Device confirmed shared secret key | String | Yes |
Details of loadBalancer:
| Field Name | Description | Data Type | Mandatory |
|---|---|---|---|
| ipAddress | IP address | String | Yes |
| SNMPv3User | SNMP user name | String | Yes |
| authenticationPassword | Authentication password | String | Yes |
| privacyPassword | Privacy password | String | Yes |
Response Parameters
Following fields are returned if the request parameters are correct, otherwise error details are returned.
| Field Name | Description | Data Type |
|---|---|---|
| createdResourceId | Unique id of the created device | Number |
Example
Request
PUT https://%3CNSM_IP%3E/sdkapi/domain/0/device/1006
{
"deviceId": 1006,
"deviceName": "Load_BALANCER",
"deviceType": {
"virtualHIPSensor": null,
"loadBalancer": {
"ipAddress": "1.1.1.1",
"SNMPv3User": "SNMP",
"authenticationPassword": "admin123",
"privacyPassword": "admin123"
}
},
"contactInformation": "ContactInform",
"location": "Location",
"LastModifiedTime": "Mon Jul 22 20:05:00 IST 2013"
} Response
{
"status":1
} Error Information
Following error codes are returned by this URL:
| S.No | HTTP Error Code | SDK API errorId | SDK API errorMessage |
|---|---|---|---|
| 1 | 404 | 1105 | Invalid domain |
| 2 | 400 | 4601 | Device name is required |
| 3 | 400 | 4602 | Device name should not be greater than 25 chars |
| 4 | 400 | 4603 | Shared secret is required |
| 5 | 400 | 4604 | Confirm shared secret is required |
| 6 | 400 | 4605 | Shared secret does not match |
| 7 | 400 | 4606 | Device name cannot be modified |
| 8 | 400 | 4607 | Update mode is required |
| 9 | 404 | 4608 | Invalid device id /device not visible in this domain |
| 10 | 400 | 4609 | SNMPv3 username is required |
| 11 | 400 | 4610 | Authentication password is required |
| 12 | 400 | 4611 | Privacy password is required |
| 13 | 400 | 4612 | Password should not be less than 8 chars |
| 14 | 400 | 4613 | Name must contain only letters, numerical, dot, hyphens or underscore |
| 15 | 400 | 4614 | Device name already exists |
| 16 | 400 | 4615 | IP address already exists |
| 17 | 400 | 4616 | Device profile provided is not up to date |
| 18 | 400 | 4617 | Location should not be greater than 25 chars |
| 19 | 400 | 4618 | Location must contain only letters, numerical, dot, hyphens or underscore |
| 20 | 400 | 4619 | Contact should not be greater than 25 chars |
| 21 | 400 | 4620 | Location must contain only letters, numerical, dot, hyphens or underscore |
| 22 | 400 | 4621 | Shared secret should not be greater than 25 chars |