You are here: Asset > Asset by ID

/asset/{id}

Methods

GET

Gets the Asset associated with {id}.

Fields Parameter

The fields parameter should be specified along the query string, and it takes the syntax

?fields=<field>,...

Allowed Fields

*id

**name

**description

**status

creator

owner

ownerGroup

targetGroup

groups

type

tags

context

template

createdTime

modifiedTime

repositories

ipCount

assetDataFields

typeFields

viewableIPs

Legend

* = always comes back

** = comes back if fields list not specified on GET all

Request Query Parameters

None

Example Response

{

"type" : "regular",

"response" : {

"id" : "33",

"name" : "test",

"type" : "combination",

"description" : "",

"tags" : "",

"context" : "",

"status" : "0",

"templateID" : "-1",

"createdTime" : "1412171859",

"modifiedTime" : "1412171859",

"typeFields" : {

"combinations" : {

"operator" : "intersection",

"operand1" : {

"id" : "28",

"name" : "Test 1",

"description" : ""

},

"operand2" : {

"id" : "29",

"name" : "Test 2",

"description" : ""

}

}

},

"repositories" : [

{

"ipCount" : "0",

"repository" : {

"id" : "17",

"name" : "New Fields Repo",

"description" : ""

}

},

{

"ipCount" : "0",

"repository" : {

"id" : "18",

"name" : "New Rep 1",

"description" : ""

}

},

{

"ipCount" : "0",

"repository" : {

"id" : "19",

"name" : "New Rep 2",

"description" : ""

}

},

{

"ipCount" : "0",

"repository" : {

"id" : "20",

"name" : "New Rep 3",

"description" : ""

}

},

{

"ipCount" : "0",

"repository" : {

"id" : "21",

"name" : "New Rep 4",

"description" : ""

}

},

{

"ipCount" : "0",

"repository" : {

"id" : "22",

"name" : "New Rep 5",

"description" : ""

}

},

{

"ipCount" : "0",

"repository" : {

"id" : "23",

"name" : "New Rep 6",

"description" : ""

}

},

{

"ipCount" : "0",

"repository" : {

"id" : "24",

"name" : "New Rep 7",

"description" : ""

}

}

],

"ipCount" : 0,

"groups" : [],

"assetDataFields" : [],

"viewableIPs" : [

{

"repository" : {

"id" : "37",

"name" : "ag repo1"

},

"ipList" : "192.168.1.1\n",

"ipCount" : "1"

},

{

"repository" : {

"id" : "38",

"name" : "jm ipv4"

},

"ipList" : "192.168.1.1\n",

"ipCount" : "1"

},

{

"repository" : {

"id" : "39",

"name" : "ipv6 rep"

},

"ipList" : "",

"ipCount" : "0"

}

],

"creator" : {

"id" : "1",

"username" : "head",

"firstname" : "Security Manager",

"lastname" : ""

},

"owner" : {

"id" : "1",

"username" : "head",

"firstname" : "Security Manager",

"lastname" : ""

},

"ownerGroup" : {

"id" : "0",

"name" : "Full Access",

"description" : "Full Access group"

},

"targetGroup" : {

"id" : -1,

"name" : "",

"description" : ""

}

},

"error_code" : 0,

"error_msg" : "",

"warnings" : [],

"timestamp" : 1412273575

}

PATCH

Edits the Asset associated with {id}, changing only the passed in fields.

Request Parameters

(All fields are optional)

See /asset::POST for parameters.

Example Response

See /asset/{id}::GET

Copyright © 2016. Tenable Network Security, Inc. All rights reserved. Tenable Network Security and Nessus are registered trademarks of Tenable Network Security, Inc. SecurityCenter Continuous View, Passive Vulnerability Scanner, and Log Correlation Engine are trademarks of Tenable Network Security, Inc. All other products or services are trademarks of their respective owners.