Network Discovery Bulk Device L2L3 Updates

PUT 
/pub/v4.0/network/ndNodeL2L3BulkUpdate

Bulk device l2l3 updates for network discovery devices

Request

Query Parameters

updateSource stringrequired

Source of integration

multipart/form-data

Body

required

file filerequired

network discovery l2l3 txt file

Responses

200

Successful Response

application/json

Schema

Schema

api string

The path used to call the IoT Security API: “/network/ndNodeL2L3BulkUpdate”

ver string

The version of the IoT Security API: “v4.0”

message string

The message indicating success: “success”

updatedInterface integer

The number of successfully inserted/updated interfaces

updatedSubnet integer

The number of successfully inserted/updated subnets

updatedDevice integer

The number of successfully inserted/updated devices

Example (from schema)

{
  "api": "string",
  "ver": "string",
  "message": "string",
  "updatedInterface": 0,
  "updatedSubnet": 0,
  "updatedDevice": 0
}

resolveSecurityAlertResponseExample

{
  "ver": "v4.0",
  "api": "/network/ndNodeL2L3BulkUpdate",
  "message": "success",
  "updatedInterface": 1,
  "updatedSubnet": 1,
  "updatedDevice": 1
}

4XX

Client Error Response

application/json

Schema

Schema

code string

STATUS_CODE

msg string

GENERAL_MESSAGE

Example (from schema)

{
  "code": "string",
  "msg": "string"
}

Bad Request

{
  "code": 400,
  "msg": "Bad Request. This occurs when an HTTP request contains an invalid query string."
}

Forbidden access

{
  "code": 403,
  "msg": "Forbidden access. Either the provided API key is invalid or it does not have the required RBAC permissions to run this API."
}

Too many requests

{
  "code": 429,
  "msg": "Too many requests. The number of requests for device details for a single device exceeded the rate limit of 180 queries per minute per tenant."
}

5XX

Server Error Response

application/json

Schema

Schema

code string

STATUS_CODE

msg string

GENERAL_MESSAGE

Example (from schema)

{
  "code": "string",
  "msg": "string"
}

resolveSecurityAlertResponseExample

{
  "code": 500,
  "msg": "Internal server error. A unified status for API communication type errors."
}

Loading...