Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Tenable Cloud Connectors API

The Cloud Connectors API from Tenable — 6 operation(s) for cloud connectors.

Tenable Cloud Connectors API is one of 107 APIs that Tenable publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Cloud Connectors. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 9 operations across 6 paths, and defines 35 schemas. It is described by OpenAPI 3.0.0, at version 1.0.0.

Requests are made against a single base URL, https://www.tenable.com/downloads/api/v2.

9 operations 6 paths 35 schemas 1 DELETE3 GET4 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Base URL
https://cloud.tenable.com
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Tenable Cloud Connectors API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (Bearer). By default, every request must be authenticated.

  • Bearer — Example: Bearer {{token}}

Paths & Operations 9

Across 6 paths, the API surfaces 9 operations — 1 DELETE, 3 GET, 4 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Cloud Connectors 9
POST
/settings/connectors
Create connector
io-connectors-create body → 200400401403429500
GET
/settings/connectors
List connectors
io-connectors-list 3 params → 200401403429500
GET
/settings/connectors/{connector_id}
Get connector details
io-connectors-details 1 param → 200401403404429500
PUT
/settings/connectors/{connector_id}
Update connector
io-connectors-update 1 param body → 200400401403404429500
DELETE
/settings/connectors/{connector_id}
Delete connector
io-connectors-delete 1 param → 200401403404429500
GET
/settings/connectors/azure-fa/{connector_id}/arm-template
Download ARM Template
io-connectors-get-arm-template 1 param → 200400401404429500
POST
/settings/connectors/cloudformation-template
Download CFT Template
io-connectors-get-cft-template body → 200400401403404429500
POST
/settings/connectors/aws/cloudtrails
List AWS cloudtrails
io-connectors-get-aws-cloudtrails body → 200400401403429500
POST
/settings/connectors/{connector_id}/import
Import data
io-connectors-import-assets 1 param → 200401403404429500

Schemas 35

The contract defines 35 schemas that model the data the API accepts and returns. The most detailed are Cloud_Connectors_Response-Connector (17 properties), Cloud_Connectors_response_params (9 properties), Cloud_Connectors_Request-Create_AWS_Keyless_Connector (5 properties), Cloud_Connectors_Request-Create_AWS_Keyed_Connector (5 properties). Each schema is shown below with its type and property counts.

Cloud_Connectors_aws_sub_account
object
5 properties 4 required
Cloud_Connectors_trail
object
4 properties 1 required
Cloud_Connectors_azure_status
object
3 properties
Cloud_Connectors_Response-Connector
object
17 properties
Cloud_Connectors_region
object
2 properties
Cloud_Connectors_Request-ConnectorCreate
Cloud_Connectors_Request-Create_AWS_FA_Connector
object
5 properties 3 required
Cloud_Connectors_Request_Update_Azure_Connector
object
4 properties 3 required
Cloud_Connectors_Request-Create_AWS_Keyless_Connector
object
5 properties 3 required
Cloud_Connectors_ParamsRequestAWSKeyed
object
3 properties 2 required
Cloud_Connectors_Request-Update_AWS_Keyed_Connector
object
4 properties 3 required
Cloud_Connectors_Request_Update_GCP_Connector
object
4 properties 3 required
Cloud_Connectors_Request-Update_AWS_Keyless_Connector
object
4 properties 3 required
Cloud_Connectors_ParamsRequestAWS_FA
object
2 properties
Cloud_Connectors_Request-Update_Azure_FA_Connector
object
3 properties 3 required
Cloud_Connectors_response_params
object
The connector parameters. Note that only the params object for AWS keyed connectors is shown below. The param object for other connector types is not used in t…
9 properties
Cloud_Connectors_schedule
object
The data import schedule.
2 properties
Cloud_Connectors_Response-Pagination
object
An object containing pagination information for the current result set.
4 properties
Cloud_Connectors_ParamsRequestAzure
object
4 properties 3 required
Cloud_Connectors_Request_Update_GCP_Keyless_Connector
object
4 properties 3 required
Cloud_Connectors_tags
object
The AWS tag associated with the hosts you want to assess. Note: You can no longer use Frictionless Assessment tags to create an AWS keyless (awskeyless) connec…
2 properties
Cloud_Connectors_Request-UpdateConnector
Cloud_Connectors_Request-Create_GCP_Keyed_Connector
object
5 properties 3 required
Cloud_Connectors_ParamsRequestGCP
object
1 property 1 required
Cloud_Connectors_AWSCredentials
object
The credentials that the Tenable Vulnerability Management connector uses to communicate with the AWS API, including accesskey and secretkey.
2 properties
Cloud_Connectors_Request-Create_Azure_ConnectorFA
object
4 properties 3 required
Cloud_Connectors_ParamsRequestAWSKeyless
object
4 properties 1 required
Cloud_Connectors_Request-Create_Azure_Connector
object
5 properties 3 required
Cloud_Connectors_Response-PaginationSortObject
object
An object specifying how the current result set is sorted, including the property by which the results were sorted and the sort direction.
2 properties
Cloud_Connectors_Request-Create_GCP_Keyless_Connector
object
5 properties 3 required
Cloud_Connectors_ParamsRequestGCPKeyless
object
1 property 1 required
Cloud_Connectors_Request-Create_AWS_Keyed_Connector
object
5 properties 3 required
Cloud_Connectors_ParamsRequestAzureFA
object
2 properties 3 required
Cloud_Connectors_TargetsAzureFA
object
3 properties 3 required
Cloud_Connectors_ErrorResponse
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tenable-cloud-connectors-api-openapi.yml Raw ↑

Other APIs Tenable publishes across the network.

Tenable About API
Tenable Access Control (API) API
Tenable Access Control (Groups) API
Tenable Access Control (Permissions) API
Tenable Access Control (Roles) API
Tenable Access Control (Users) API
Tenable Access Groups v1 API
Tenable Access Groups v2 API
Tenable Account Groups API
Tenable Accounts API
Tenable Activity Log API
Tenable AD object API