TOC & Recently Viewed

Recently Viewed Topics

View Asset Details

User Permissions: Basic (16)

To view asset details, use the API endpoint described below.

Before You Begin

Determine the UUID of the asset for which you want to view details.

HTTP Request

Note: To authenticate your request, be sure to include API keys in the HTTP header of the request. For more information, see Authorization.

Request Path Syntax

GET https://cloud.tenable.com/assets/{asset_uuid}

Request Path Parameters

Attribute Type Description Required?
asset_uuid string The UUID of the asset. required

Request Path Example

https://cloud.tenable.com/assets/538d2d84-32b7-4d1d-ae6c-8dfa2f50ed0d

Request Body Syntax

None.

HTTP Response

Response Codes

Status Description
200 Returns a list of assets. For more information, see "Response Body Syntax."
403 Returned if you do not have permission to view information about an asset.
429

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

Response Body Syntax

{ "id": {string}, "has_agent": {boolean], "created_at": {string}, "updated_at": {string}, "first_seen": {string}, "last_seen": {string}, "last_authenticated_scan_date": {string}, "last_licensed_scan_date": {string}, "sources": [ { "name": {string}, "first_seen": {string}, "last_seen": {string} } ], "tags": [ { "tag_uuid": {string}, "tag_key": {string}, "tag_value": {string}, "added_by": {string}, "added_at": {string} } ], "ipv4": [ {string} ], "ipv6": [ {string} ], "fqdn": [ {string} ], "mac_address": [ {string} ], "netbios_name": [ {string} ], "operating_system": [ {string} ], "system_type": [ {string} ], "hostname": [ {string} ], "agent_name": [ {string} ], "bios_uuid": [ {string} ], "aws_ec2_instance_id": [ {string} ], "aws_ec2_instance_ami_id": [ {string} ], "aws_owner_id": [ {string} ], "aws_availability_zone": [ {string} ], "aws_region": [ {string} ], "aws_vpc_id": [ {string} ], "aws_ec2_instance_group_name": [ {string} ], "aws_ec2_instance_state_name": [ {string} ], "aws_ec2_instance_type": [ {string} ], "aws_subnet_id": [ {string} ], "aws_ec2_product_code": [ {string} ], "aws_ec2_name": [ {string} ], "azure_vm_id": [ {string} ], "azure_resource_id": [ {string} ], "gcp_project_id": [ {string} ], "gcp_zone": [ {string} ], "gcp_instance_id": [ {string} ], "ssh_fingerprint": [ {string} ], "mcafee_epo_guid": [ {string} ], "mcafee_epo_agent_guid": [ {string} ], "qualys_asset_id": [ {string} ], "qualys_host_id": [ {string} ], "servicenow_sysid": [ {string} ] }

Response Body Attributes

Attribute Type Description
id string

The UUID of the asset.

has_agent boolean

Specifies whether a Nessus agent scan identified the asset.

created_at string

The time and date when Tenable.io created the asset record.

updated_at string

The time and date when the asset record was last updated.

first_seen string

The time and date when a scan first identified the asset.

last_seen string

The time and date of the scan that most recently identified the asset.

last_authenticated_scan_date string

The time and date of the last credentialed scan run on the asset.

last_licensed_scan_date string

The time and date of the last scan that identified the asset as licensed. Tenable.io categorizes an asset as licensed if a scan of that asset has returned results from a non-discovery plugin within the last 90 days.

sources array

The sources of the scans that identified the asset. For more information, see Source Objects.

tags array

Category tags assigned to the asset in Tenable.io. For more information, see Tag Objects.

ipv4 array

The IPv4 addresses that scans have associated with the asset record.

ipv6 array

The IPv6 addresses that scans have associated with the asset record.

fqdn array

The fully-qualified domain names that scans have associated with the asset record.

mac_address array

The MAC addresses that scans have associated with the asset record.

netbios_name array

The NetBIOS names that scans have associated with the asset record.

operating_system array

The operating systems that scans have associated with the asset record.

system_type array

The system types as reported by Plugin ID 54615. Possible values include "router," "general-purpose," "scan-host," and "embedded."

hostname array

The hostnames that scans have associated with the asset record.

agent_name array

The names of any Nessus agents that scanned and identified the asset.

bios_uuid array The BIOS UUID that scans have associated with the asset.
aws_ec2_instance_id array

The unique identifier of the Linux instance in Amazon EC2. For more information, see the Amazon Elastic Compute Cloud Documentation.

aws_ec2_instance_ami_id array

The unique identifier of the Linux AMI image in Amazon Elastic Compute Cloud (Amazon EC2). For more information, see the Amazon Elastic Compute Cloud Documentation.

aws_owner_id array

The canonical user identifier for the AWS account associated with the virtual machine instance. For example, "79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be". For more information, see AWS Account Identifiers in the AWS documentation.

aws_availability_zone array

The availability zone where Amazon Web Services hosts the virtual machine instance, for example, "us-east-1a". Availability zones are subdivisions of AWS regions. For more information, see Regions and Availability Zones in the AWS documentation.

aws_region array

The region where AWS hosts the virtual machine instance, for example, "us-east-1". For more information, see Regions and Availability Zones in the AWS documentation.

aws_vpc_id array

The unique identifier for the virtual public cloud that hosts the AWS virtual machine instance. For more information, see the Amazon Virtual Private Cloud User Guide.

aws_ec2_instance_group_name array

The virtual machine instance's group in AWS.

aws_ec2_instance_state_name array

The state of the virtual machine instance in AWS at the time of the scan.

aws_ec2_instance_type array

The type of instance in AWS EC2.

aws_subnet_id array

The unique identifier of the AWS subnet where the virtual machine instance was running at the time of the scan.

aws_ec2_product_code array

The product code associated with the AMI used to launch the virtual machine instance in AWS EC2.

aws_ec2_name array

The name of the virtual machine instance in AWS EC2.

azure_vm_id array

The unique identifier of the Microsoft Azure virtual machine instance. For more information, see Accessing and Using Azure VM Unique ID in the Microsoft Azure documentation.

azure_resource_id array

The unique identifier of the resource in the Azure Resource Manager. For more information, see the Azure Resource Manager Documentation.

gcp_project_id array

The customized name of the project to which the virtual machine instance belongs in Google Cloud Platform (GCP). For more information, see Creating and Managing Projects in the GCP documentation.

gcp_zone array

The zone where the virtual machine instance runs in GCP. For more information, see Regions and Zones in the GCP documentation.

gcp_instance_id array

The unique identifier of the virtual machine instance in GCP.

ssh_fingerprint array

The SSH key fingerprints that scans have associated with the asset record.

mcafee_epo_guid array

The unique identifier of the asset in McAfee ePolicy Orchestrator (ePO) . For more information, see the McAfee documentation.

mcafee_epo_agent_guid array

The unique identifier of the McAfee ePO agent that identified the asset. For more information, see the McAfee documentation.

qualys_asset_id array

The Asset ID of the asset in Qualys. For more information, see the Qualys documentation.

qualys_host_id array

The Host ID of the asset in Qualys. For more information, see the Qualys documentation.

servicenow_sysid array

The unique record identifier of the asset in ServiceNow. For more information, see the ServiceNow documentation.

Response Body Example

{ "id": "60d5a1e7-aec0-45d3-b196-c2356b1567b9", "has_agent": false, "created_at": "2017-12-14T20:40:44.535Z", "updated_at": "2018-02-23T22:27:58.599Z", "first_seen": "2017-12-14T20:40:23.447Z", "last_seen": "2018-02-23T22:27:52.869Z", "last_authenticated_scan_date": null, "last_licensed_scan_date": null, "sources": [ { "name": "NESSUS_SCAN", "first_seen": "2017-12-14T20:40:23.447Z", "last_seen": "2018-02-23T22:27:52.869Z" } ], "tags": [ { "tag_uuid": "6ee5761f-5c99-434b-aecb-e09b755921b7", "tag_key": "Geographic Area", "tag_value": "APAC", "added_by": "e7ecb50b-1330-4a8c-b8e5-ee00ec8c46f8", "added_at": "2018-02-13T14:53:13.817Z" } ], "ipv4": [ "172.1.2.57" ], "ipv6": [], "fqdn": [ "172-1-2-57.lightspeed.hstntx.sbcglobal.net" ], "mac_address": [], "netbios_name": [], "operating_system": [], "system_type": [], "hostname": [], "agent_name": [], "bios_uuid": [], "aws_ec2_instance_id": [], "aws_ec2_instance_ami_id": [], "aws_owner_id": [], "aws_availability_zone": [], "aws_region": [], "aws_vpc_id": [], "aws_ec2_instance_group_name": [], "aws_ec2_instance_state_name": [], "aws_ec2_instance_type": [], "aws_subnet_id": [], "aws_ec2_product_code": [], "aws_ec2_name": [], "azure_vm_id": [], "azure_resource_id": [], "gcp_project_id": [], "gcp_zone": [], "gcp_instance_id": [], "ssh_fingerprint": [], "mcafee_epo_guid": [], "mcafee_epo_agent_guid": [], "qualys_asset_id": [], "qualys_host_id": [], "servicenow_sysid": [] }

Reference Guide

https://cloud.tenable.com/api#/resources/assets/asset-info

Copyright © 2019 Tenable, Inc. All rights reserved. Tenable, Tenable.io, Tenable Network Security, Nessus, SecurityCenter, SecurityCenter Continuous View and Log Correlation Engine are registered trademarks of Tenable, Inc.. Tenable.sc, Lumin, Assure, and the Cyber Exposure Company are trademarks of Tenable, Inc. All other products or services are trademarks of their respective owners.