Get asset information

GET {{baseUrl}}/workbenches/assets/:asset_id/info?all_fields=deserunt

Returns information about the specified asset.

Note: This endpoint is not intended for large or frequent exports of vulnerability or assets data. If you experience errors, reduce the volume, rate, or concurrency of your requests or narrow your filters. Contact support if you continue to experience errors. Additionally, Tenable recommends the POST /vulns/export endpoint for large or frequent exports of vulnerability data, and the POST /assets/export endpoint for large or frequent exports of assets data.

For information and best practices for retrieving vulnerability and assets data from Tenable.io, see Retrieve Vulnerability Data from Tenable.io and Retrieve Asset Data from Tenable.io.

Requires BASIC [16] user permissions. See Permissions.

Request Params

KeyDatatypeRequiredDescription
all_fieldsstringA value specifying whether you want the returned data to include all fields (full) or only the default fields (default). The schema for this endpoint defines the default fields only. For a definition of the full fields, see Common Asset Attributes.

RESPONSES

status: OK

{"info":{"time_end":"2018-12-31T15:00:25Z","time_start":"2018-12-31T15:00:25Z","id":"7ee5f61c-e768-4dd7-baa6-f76381ca6970","uuid":"7ee5f61c-e768-4dd7-baa6-f76381ca6970","operating_system":["Microsoft Windows Server 2008 R2 Standard Service Pack 1"],"fqdn":["vcenter.dc.demo.io"],"mac_address":["00:50:56:bd:4b:d8"],"counts":{"vulnerabilities":{"total":573,"severities":[{"count":392,"level":0,"name":"Info"},{"count":11,"level":1,"name":"Low"},{"count":122,"level":2,"name":"Medium"},{"count":316,"level":3,"name":"High"},{"count":27,"level":4,"name":"Critical"}]},"audits":{"total":0,"statuses":[{"count":0,"level":1,"name":"Passed"},{"count":0,"level":2,"name":"Warning"},{"count":0,"level":3,"name":"Failed"}]}},"has_agent":false,"created_at":"2018-11-31T15:00:45.684Z","updated_at":"2018-12-31T17:28:46.941Z","first_seen":"2018-11-31T15:00:25.000Z","last_seen":"2018-12-31T17:28:28.000Z","last_authenticated_scan_date":"2018-12-31T17:28:28.000Z","last_licensed_scan_date":"2018-12-31T17:28:28.000Z","last_scan_target":"172.204.81.57","sources":[{"name":"NESSUS_SCAN","first_seen":"2018-12-31T15:00:25.000Z","last_seen":"2018-12-31T17:28:28.000Z"}],"acr_score":8,"acr_drivers":[{"driver_name":"device_type","driver_value":["general_purpose"]},{"driver_name":"device_capability","driver_value":["pci"]},{"driver_name":"internet_exposure","driver_value":["internal"]}],"exposure_score":753,"scan_frequency":[{"interval":90,"frequency":3,"licensed":false},{"interval":30,"frequency":1,"licensed":false},{"interval":60,"frequency":1,"licensed":false}],"tags":[],"ipv4":["172.204.81.57"],"ipv6":[],"netbios_name":["VCENTER"],"system_type":["general-purpose"],"tenable_uuid":["02dfb8d5a8744a4d925dc8aec4c5dffb"],"hostname":["vcenter"],"agent_name":[],"bios_uuid":["32d83d42-beb4-69ee-131a-54ca30e6cc21"],"aws_ec2_instance_id":["i-1234567890abcdef0"],"aws_ec2_instance_ami_id":["abcd1234efgh5678i"],"aws_owner_id":["79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be"],"aws_availability_zone":["us-west-1a"],"aws_region":["us-west-1"],"aws_vpc_id":["vpc-1a2b3c4d"],"aws_ec2_instance_group_name":["my-sg"],"aws_ec2_instance_state_name":["running"],"aws_ec2_instance_type":["t2.micro"],"aws_subnet_id":["subnet-6e7f829e"],"aws_ec2_product_code":["774F4FF8"],"aws_ec2_name":["MyAppAPIServiceInstance"],"azure_vm_id":["BC5BCA47-A882-4096-BB2D-D76E6C170534"],"azure_resource_id":["/subscriptions/12345678-1234-5678-9101-123456789101/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM"],"gcp_project_id":["cloudtest8"],"gcp_zone":["us-west1-a"],"gcp_instance_id":["test-instance"],"ssh_fingerprint":[],"mcafee_epo_guid":[],"mcafee_epo_agent_guid":[],"qualys_asset_id":[],"qualys_host_id":[],"servicenow_sysid":[],"installed_software":["cpe:/a:apple:itunes:12.8","cpe:/a:apple:quicktime:7.7.3","cpe:/a:openbsd:openssh:6.9","cpe:/a:google:chrome"],"bigfix_asset_id":[]}}