AppDynamics Configurations API

openapi: 3.2.0
info:
  title: Cisco Cloud Observability Configurations API
  description: The Cisco Cloud Observability API is the next-generation cloud-native platform for AppDynamics, available through the Cisco DevNet developer portal. It provides REST APIs for managing cloud connections to Amazon Web Services, Microsoft Azure, and Google Cloud Platform. The API also includes Health Rules for defining performance thresholds, a Query Service for retrieving MELT (metrics, events, logs, traces) data using ADQL, and Application Principal Management for access control. The platform uses OpenTelemetry as its data ingestion standard.
  version: 2.0.0
  contact:
    name: Cisco DevNet Support
    url: https://developer.cisco.com/docs/appdynamics/
  termsOfService: https://www.cisco.com/c/en/us/about/legal/cloud-and-software.html
servers:
- url: https://{tenant}.observe.appdynamics.com/cloud
  description: Cisco Cloud Observability Platform
  variables:
    tenant:
      default: example
      description: Your Cisco Cloud Observability tenant name.
security:
- bearerAuth: []
tags:
- name: Configurations
  description: Configure data collection settings for cloud connections including service selection, region filtering, and resource group scoping.
paths:
  /v2/configurations:
    post:
      operationId: createConfiguration
      summary: Create a connection configuration
      description: Creates a data collection configuration for a cloud connection to limit monitoring to specific cloud services, regions, and resource groups.
      tags:
      - Configurations
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConnectionConfiguration'
      responses:
        '201':
          description: Configuration created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectionConfiguration'
        '400':
          description: Bad request - invalid configuration
        '401':
          description: Unauthorized - invalid or expired access token
    get:
      operationId: listConfigurations
      summary: List connection configurations
      description: Returns all data collection configurations for the tenant.
      tags:
      - Configurations
      responses:
        '200':
          description: Successful retrieval of configurations
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    description: Array of connection configuration objects.
                    items:
                      $ref: '#/components/schemas/ConnectionConfiguration'
        '401':
          description: Unauthorized - invalid or expired access token
components:
  schemas:
    ConnectionConfiguration:
      type: object
      description: A data collection configuration that limits monitoring to specific cloud services, regions, and resource groups for a connection.
      properties:
        id:
          type: string
          description: The unique identifier of the configuration.
        connectionId:
          type: string
          description: The ID of the cloud connection this configuration belongs to.
        services:
          type: array
          description: The list of cloud services to monitor.
          items:
            type: string
        regions:
          type: array
          description: The list of cloud regions to monitor.
          items:
            type: string
        resourceGroups:
          type: array
          description: The list of resource groups to monitor (Azure-specific).
          items:
            type: string
        polling:
          type: object
          description: Polling configuration for data collection frequency.
          properties:
            interval:
              type: integer
              description: The polling interval in seconds.
            unit:
              type: string
              description: The time unit for the polling interval.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: OAuth 2.0 access token obtained from the Cisco Observability Platform authentication endpoint.
externalDocs:
  description: Cisco Cloud Observability Documentation
  url: https://developer.cisco.com/docs/appdynamics/