WHERE DO I START?
You are here:... (Miscellaneous) > API > Datasources
  • Top ↑

Datasources

The datasources API allows you to access and manage your integrations.

Tip   To explore Netuitive's REST API and test some requests, go here.

Get a list of integrations

This method will return a list of integrations associated with a tenant.

Method GET URL https://api.app.netuitive.com/datasources
Parameters Required/Optional Description
N/A N/A N/A

Input JSON Format for Request Header

Header Name Header Value
Content-Type application/json
Authorization: Basic (Base64 encoded authentication value)

Create an integration

This method creates an integration for a tenant.

Method POST URL https://api.app.netuitive.com/datasources
Parameters Required/Optional Description
wrapper Optional Body parameter; see below.

Input JSON Format for Request Header

Header Name Header Value
Content-Type application/json
Authorization: Basic (Base64 encoded authentication value)

Input JSON Format for Request Body

Attribute Required/Optional Description
apiId Optional

The API key associated with the integration.

collectors Optional The collectors associated with a particular integration. Collectors contains several attributes:
  • datasource (optional)
    • The datasource ID for the datasource the collector is associated with.
  • elements (optional)
    • A comma-delimited list of element IDs that are associated with this collector.
  • id (optional)
    • The ID for the collector.
  • lastSeen (optional)
    • When the collector last sent data.
  • name (optional)
    • The name for the collector.
  • package (optional)
    • The name of the package associated with the collector.
  • packageEnabled (optional)
    • Whether the listed package is enabled.
  • properties (optional)
    • The fields available for the collector (unique to each collector).
deleted Optional Whether the integration is deleted.
enabled Optional Whether the integration is enabled or not.
name Optional The name of the integration (displayed in the Inventory Explorer).
properties Optional The fields available for the integration (unique to each integration type).
type Required

The type of integration. Can be one of the following:

  • AWS
  • BROWSER
  • COLLECTD
  • CUSTOM
  • DIAMOND
  • GRAPHITE
  • INFRASTRUCTURE
  • JAVA
  • STATSD
  • AWSCOST
  • WINDOWS
  • RUBY
  • WEBHOOK
  • AZURE

Delete an integration

This method will delete a given integration.

Method DELETE URL https://api.app.netuitive.com/datasources/{id}
Important   Replace {id} in the above URL with the ID from any of your integrations.
Parameters Required/Optional Description
id Required URL (path) parameter. The ID of the integration.

Input JSON Format for Request Header

Header Name Header Value
Content-Type application/json
Authorization: Basic (Base64 encoded authentication value)

Get an integration by ID

This method will return an integration for the given ID.

Method GET URL https://api.app.netuitive.com/datasources/{id}
Important   Replace {id} in the above URL with the ID from any of your integrations.
Parameters Required/Optional Description
id Required URL (path) parameter. The ID of the integration.

Input JSON Format for Request Header

Header Name Header Value
Content-Type application/json
Authorization: Basic (Base64 encoded authentication value)

Replace an integration

This method will allow you to replace a given integration.

Method PUT URL https://api.app.netuitive.com/datasources/{id}
Important   Replace {id} in the above URL with the ID from any of your integration.
Parameters Required/Optional Description
id Required URL (path) parameter. The ID of the integration.
wrapper Optional Body parameter; see below.

Input JSON Format for Request Header

Header Name Header Value
Content-Type application/json
Authorization: Basic (Base64 encoded authentication value)

Input JSON Format for Request Body

Attribute Required/Optional Description
apiId Optional

The API key associated with the integration.

collectors Optional The collectors associated with a particular integration. Collectors contains several attributes:
  • datasource (optional)
    • The datasource ID for the datasource the collector is associated with.
  • elements (optional)
    • A comma-delimited list of element IDs that are associated with this collector.
  • id (optional)
    • The ID for the collector.
  • lastSeen (optional)
    • When the collector last sent data.
  • name (optional)
    • The name for the collector.
  • package (optional)
    • The name of the package associated with the collector.
  • packageEnabled (optional)
    • Whether the listed package is enabled.
  • properties (optional)
    • The fields available for the collector (unique to each collector).
enabled Optional Whether the integration is enabled or not.
id Optional

The ID for the integration.

properties Optional The fields available for the integration (unique to each integration type).
tenantId Optional

The ID for the tenant that the integration will be created for.

type Required

The type of integration. Can be one of the following:

  • AWS
  • BROWSER
  • COLLECTD
  • CUSTOM
  • DIAMOND
  • GRAPHITE
  • INFRASTRUCTURE
  • JAVA
  • STATSD
  • AWSCOST
  • WINDOWS
  • RUBY
  • WEBHOOK
  • AZURE