Create network

post

https://cloud.tenable.com/networks

Creates a network object that you associate with scanners and scanner groups.

Note: You cannot add AWS assets to network objects. For AWS assets, use the network segmentation provided by AWS instead.

Requires the Administrator [64] user role or the VM.VM_SENSOR.NETWORK.CREATE custom role privilege. See Roles.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

name

string

required

The name of the network object. This name must be unique within your Tenable Vulnerability Management instance, cannot duplicate the name of a previously deleted network, and cannot be default.

Note: You can add a maximum of 50,000 network objects to an individual Tenable Vulnerability Management instance.

description

string

The description of the network object.

assets_ttl_days

integer

The number of days to wait before assets age out. Assets will be permanently deleted if they are not seen on a scan within the specified number of days.

Minimum value: 14
Maximum value: 365

Warning: If you enable this option, Tenable Vulnerability Management immediately deletes assets in the specified network that have not been seen for the specified number of days. All asset records and associated vulnerabilities are deleted and cannot be recovered. The deleted assets no longer count towards your license.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

400

Returned if Tenable Vulnerability Management encounters invalid JSON in the request body or if an invalid assets_ttl_days value was declared (min: 14, max: 365).

401

Returned if Tenable Vulnerability Management cannot authenticate the user account that submitted the request.

403

Returned if you do not have permission to create network objects.

409

Returned if a network object with the same name already exists.

415

Returned if the request payload is in an unsupported format.

200Returned if Tenable Vulnerability Management successfully created the network.

429Returned if you attempt to send too many requests in a specific period of time. For more information, see Rate Limiting.

500Returned if Tenable Vulnerability Management encountered an internal server error. Wait a moment, and try your request again.

503Returned if a Tenable Vulnerability Management service is unavailable. Wait a moment, and try your request again.