TOC & Recently Viewed

Recently Viewed Topics

Download Asset Export Chunks

User Permissions: Administrator (64)

To download available asset export chunks, use the API endpoint described below.

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/export/{export_uuid}/chunks/{chunk_id}

Request Path Parameters

Parameter Type Description Required
export_uuid string The UUID of the export request. required
chunk_id integer The ID of the asset chunk you want to export. required

Request Path Example

GET https://cloud.tenable.com/assets/export/a483adf8-24e3-4c7f-818a-6867b02310dd/chunks/1

Request Body Syntax

None.

HTTP Response

Response Codes

Status Description
200 Returned if file is downloaded successfully. For more information, see "Response Body Syntax."
400 Returned if the chunk ID is invalid or the chunk is not ready for download.
403 Returned if you do not have permission to export asset data.
404 Returned if a chunk with the specified export chunk is not found.
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

Note: The response attributes listed below represent all available attributes. The API response body excludes an attribute if the attribute is empty in the vulnerability record. For a description of the attributes, see Asset Export Attributes.

[ { "id": {string}, "has_agent": {boolean}, "has_plugin_results": {boolean}, "created_at": {string}, "terminated_at": {string}, "terminated_by": {string}, "updated_at": {string}, "deleted_at": {string}, "deleted_by": {string}, "first_seen": {string}, "last_seen": {string}, "first_scan_time": {string}, "last_scan_time": {string}, "last_authenticated_scan_date": {string}, "last_licensed_scan_date": {string}, "azure_vm_id": {string}, "azure_resource_id": {string}, "aws_ec2_instance_ami_id": {string}, "aws_ec2_instance_id": {string}, "agent_uuid": {string}, "bios_uuid": {string}, "environment_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}, "mcafee_epo_guid": {string}, "mcafee_epo_agent_guid": {string}, "servicenow_sysid": {string}, "agent_names": {array}, "ipv4s": {array}, "ipv6s": {array}, "fqdns": {array}, "mac_addresses": {array}, "netbios_names": {array}, "operating_systems": {array}, "system_types": {array}, "hostnames": {array}, "ssh_fingerprints": {array}, "qualys_asset_ids": {array}, "qualys_host_ids": {array}, "manufacturer_tpm_ids": {array}, "symantec_ep_hardware_keys": {array}, "sources": {array}, "tags": {array}, "network_interfaces": {array}, } ]

Response Body Attributes

See Asset Export Attributes.

Response Body Example

[ { "id": "60d5a1e7-aec0-45d3-b196-c2356b1567b9", "has_agent": false, "has_plugin_results": true, "created_at": "2017-12-14T20:40:44.535Z", "terminated_at": null, "terminated_by": null, "updated_at": "2018-02-23T22:27:58.599Z", "deleted_at": null, "deleted_by": null, "first_seen": "2017-12-14T20:40:23.447Z", "last_seen": "2018-02-23T22:27:52.869Z", "first_scan_time": "2017-12-14T20:40:23.447Z", "last_scan_time": "2018-02-23T22:27:52.869Z", "last_authenticated_scan_date": null, "last_licensed_scan_date": "2018-02-23T22:27:52.869Z", "azure_vm_id": null, "azure_resource_id": null, "aws_ec2_instance_ami_id": null, "aws_ec2_instance_id": null, "agent_uuid": null, "bios_uuid": null, "environment_id": "00000000-0000-0000-0000-000000000000", "aws_owner_id": null, "aws_availability_zone": null, "aws_region": null, "aws_vpc_id": null, "aws_ec2_instance_group_name": null, "aws_ec2_instance_state_name": null, "aws_ec2_instance_type": null, "aws_subnet_id": null, "aws_ec2_product_code": null, "aws_ec2_name": null, "mcafee_epo_guid": null, "mcafee_epo_agent_guid": null, "servicenow_sysid": null, "agent_names": [], "ipv4s": [ "172.1.2.57" ], "ipv6s": [], "fqdns": [ "172-1-2-57.lightspeed.hstntx.sbcglobal.net" ], "mac_addresses": [], "netbios_names": [], "operating_systems": [], "system_types": [], "hostnames": [], "ssh_fingerprints": [], "qualys_asset_ids": [], "qualys_host_ids": [], "manufacturer_tpm_ids": [], "symantec_ep_hardware_keys": [], "sources": [ { "name": "NESSUS_SCAN", "first_seen": "2017-12-14T20:40:23.447Z", "last_seen": "2018-02-23T22:27:52.869Z" } ], "tags": [ { "uuid": "6ee5761f-5c99-434b-aecb-e09b755921b7", "key": "Geographic Area", "value": "APAC", "added_by": "e7ecb50b-1330-4a8c-b8e5-ee00ec8c46f8", "added_at": "2018-02-13T14:53:13.817Z" } ], "network_interfaces": [] } ]

Reference Guide

https://cloud.tenable.com/api#/resources/exports/assets-download-chunk

Examples

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.