Cloud Insights Integrations API

The Cloud Insights Integrations API lets you programmatically manage AWS and Azure monitoring integrations in ThousandEyes.

What You Can Do

  • Create integrations for:

    • AWS: inventory monitoring and flow logs monitoring.

    • Azure: inventory monitoring and flow logs monitoring.

  • List all integrations.

  • Get details for a specific integration.

  • Delete an existing integration.

  • Fetch AWS IAM policy documents required to configure AWS inventory and flow-logs integrations.

Scope and Tenancy

All operations are scoped to the authenticated account group. Responses include only resources associated with that group.

Payloads and formats

  • Requests: application/json

  • Responses: primarily application/hal+json for resource representations and application/json for policy documents.

  • HAL responses include _links with a self relation for direct navigation.

Integration Types

  • Inventory monitoring

    • AWS: reads inventory and network topology via read-only IAM permissions.

    • Azure: authenticates with a Service Principal to read inventory and network topology.

  • Flow logs monitoring

    • AWS: reads flow logs from S3 buckets and uses SNS for notifications.

    • Azure: reads flow logs via Service Bus Queue (serviceBusQueueUrl).

Policy Helpers (AWS)

Dedicated endpoints return Trusted Policy, Permissions Policy, and SNS Topic Access Policy documents to simplify role setup for inventory and flow logs integrations.

Notes

  • All example values in this specification are fictitious.