{
  "opencollection": "1.0.0",
  "info": {
    "name": "Downloads About Cloud Connectors API",
    "version": "1.0.0"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "Authorization",
      "value": "{{Authorization}}",
      "placement": "header"
    }
  },
  "items": [
    {
      "info": {
        "name": "Cloud Connectors",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List connectors",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/settings/connectors",
            "params": [
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "The number of records to retrieve. If this parameter is omitted, Tenable Vulnerability Management uses the default value of `1000`."
              },
              {
                "name": "offset",
                "value": "",
                "type": "query",
                "description": "The starting record to retrieve. If this parameter is omitted, Tenable Vulnerability Management uses the default value of `0`."
              },
              {
                "name": "sort",
                "value": "",
                "type": "query",
                "description": "The field you want to use to sort the results by along with the sort order. The field is specified first, followed by a colon, and the order is specified second (`asc` or `desc`). For example, `name:desc` would sort results by the `name` field in descending order.\n\nIf you specify multiple fields, the fields must be separated by commas. For example, `name:desc,date_created:asc` would first sort results by the `name` field in descending order and then by the `date_created` field in ascending order."
              }
            ]
          },
          "docs": "Returns a list of connectors.<p>For information about connector error codes, see [Connectors](doc:io-connectors).</p><div class=\"perms-callout\">Requires the Administrator [64] user role. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "Create connector",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://www.tenable.com/downloads/api/v2/settings/connectors",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Creates a Tenable Vulnerability Management cloud connector.\n\n**Note:** For AWS cloud connectors, you can get the available AWS cloudtrails for your account via the [POST /settings/connectors/aws/cloudtrails](#io-connectors-get-aws-cloudtrails) endpoint.\n\n**Note:** Frictionless Assessment has reached the End-of-Provisioning phase of its product lifecycle. For more information, see [Frictionless Assessment End-of-Provisioning](https://developer.tenable.com/changelog/tenableio-frictionless-assessme"
        },
        {
          "info": {
            "name": "Get connector details",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/settings/connectors/:connector_id",
            "params": [
              {
                "name": "connector_id",
                "value": "",
                "type": "path",
                "description": "The UUID of the connector to return details for."
              }
            ]
          },
          "docs": "Returns the details for the specified connector.<p>For information about connector error codes, see [Connectors](doc:io-connectors).</p><div class=\"perms-callout\">Requires the Administrator [64] user role. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "Update connector",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://www.tenable.com/downloads/api/v2/settings/connectors/:connector_id",
            "params": [
              {
                "name": "connector_id",
                "value": "",
                "type": "path",
                "description": "The UUID of the connector to update."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Updates the specified connector. You can change the connector name, associated service accounts, and schedule. You cannot change the connector type for an existing connector.\n\n**Note:** Frictionless Assessment has reached the End-of-Provisioning phase of its product lifecycle. For more information, see [Frictionless Assessment End-of-Provisioning](https://developer.tenable.com/changelog/tenableio-frictionless-assessment-end-of-provisioning). <div class=\"perms-callout\">Requires the Administrator "
        },
        {
          "info": {
            "name": "Delete connector",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://www.tenable.com/downloads/api/v2/settings/connectors/:connector_id",
            "params": [
              {
                "name": "connector_id",
                "value": "",
                "type": "path",
                "description": "The UUID of the connector to delete."
              }
            ]
          },
          "docs": "Deletes the specified connector.<div class=\"perms-callout\">Requires the Administrator [64] user role. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "Download ARM Template",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/settings/connectors/azure-fa/:connector_id/arm-template",
            "params": [
              {
                "name": "connector_id",
                "value": "",
                "type": "path",
                "description": "The UUID of the connector to download an ARM template for."
              }
            ]
          },
          "docs": "Returns an Azure Resource Manager (ARM) template for Microsoft Azure Frictionless Assessment connectors.<div class=\"perms-callout\">Requires the Administrator [64] user role. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "Download CFT Template",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://www.tenable.com/downloads/api/v2/settings/connectors/cloudformation-template",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Returns a Cloud Formation Template (CFT) for AWS Frictionless Assessment connectors.<div class=\"perms-callout\">Requires the Administrator [64] user role. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "List AWS cloudtrails",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://www.tenable.com/downloads/api/v2/settings/connectors/aws/cloudtrails",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Returns a list of available AWS cloudtrails. You can then use the cloudtrails to [create an AWS connector](ref:io-connectors-create).<div class=\"perms-callout\">Requires the Administrator [64] user role. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "Import data",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://www.tenable.com/downloads/api/v2/settings/connectors/:connector_id/import",
            "params": [
              {
                "name": "connector_id",
                "value": "",
                "type": "path",
                "description": "The UUID of the connector for which to import the data."
              }
            ]
          },
          "docs": "Imports data using a cloud connector. This creates an asynchronous import job in Tenable Vulnerability Management. You can check the import status by examining the `status_message` property in [connector details](ref:io-connectors-details).<div class=\"perms-callout\">Requires the Administrator [64] user role. See [Roles](doc:roles).</div>"
        }
      ]
    }
  ],
  "bundled": true
}