AppDynamics Connections API

openapi: 3.2.0
info:
  title: Cisco Cloud Observability Connections 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: Connections
  description: Manage cloud provider connections for AWS, Azure, and GCP to enable automated cloud monitoring at scale.
paths:
  /v2/connections:
    post:
      operationId: createCloudConnection
      summary: Create a cloud connection
      description: Creates a new cloud provider connection to authenticate and authorize Cisco Cloud Observability with your cloud provider. Supports AWS Role Delegation, AWS Access Key Credentials, Microsoft Azure, and Google Cloud Platform connection types.
      tags:
      - Connections
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CloudConnection'
      responses:
        '201':
          description: Cloud connection created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudConnection'
        '400':
          description: Bad request - invalid connection configuration
        '401':
          description: Unauthorized - invalid or expired access token
    get:
      operationId: listCloudConnections
      summary: List cloud connections
      description: Returns all cloud provider connections configured for the tenant.
      tags:
      - Connections
      responses:
        '200':
          description: Successful retrieval of cloud connections
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    description: Array of cloud connection objects.
                    items:
                      $ref: '#/components/schemas/CloudConnection'
        '401':
          description: Unauthorized - invalid or expired access token
  /v2/connections/{connectionId}:
    get:
      operationId: getCloudConnection
      summary: Get a specific cloud connection
      description: Returns the configuration details for a specific cloud connection.
      tags:
      - Connections
      parameters:
      - $ref: '#/components/parameters/connectionId'
      responses:
        '200':
          description: Successful retrieval of cloud connection
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudConnection'
        '401':
          description: Unauthorized - invalid or expired access token
        '404':
          description: Connection not found
    patch:
      operationId: updateCloudConnection
      summary: Update a cloud connection
      description: Partially updates an existing cloud connection configuration.
      tags:
      - Connections
      parameters:
      - $ref: '#/components/parameters/connectionId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CloudConnection'
      responses:
        '200':
          description: Cloud connection updated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudConnection'
        '400':
          description: Bad request - invalid connection update
        '401':
          description: Unauthorized - invalid or expired access token
        '404':
          description: Connection not found
    delete:
      operationId: deleteCloudConnection
      summary: Delete a cloud connection
      description: Deletes the specified cloud connection and stops monitoring the associated cloud resources.
      tags:
      - Connections
      parameters:
      - $ref: '#/components/parameters/connectionId'
      responses:
        '204':
          description: Cloud connection deleted successfully
        '401':
          description: Unauthorized - invalid or expired access token
        '404':
          description: Connection not found
components:
  parameters:
    connectionId:
      name: connectionId
      in: path
      required: true
      description: The unique identifier of the cloud connection.
      schema:
        type: string
  schemas:
    CloudConnection:
      type: object
      description: A cloud provider connection configuration for authenticating and authorizing Cisco Cloud Observability with a cloud provider.
      properties:
        id:
          type: string
          description: The unique identifier of the cloud connection.
        type:
          type: string
          description: The cloud provider type.
          enum:
          - aws
          - azure
          - gcp
        displayName:
          type: string
          description: A human-readable display name for the connection.
        description:
          type: string
          description: An optional description of the cloud connection.
        state:
          type: string
          description: The current state of the connection.
          enum:
          - active
          - inactive
          - error
        details:
          type: object
          description: Provider-specific connection details including credentials and role configuration.
        createdAt:
          type: string
          format: date-time
          description: The timestamp when the connection was created.
        updatedAt:
          type: string
          format: date-time
          description: The timestamp when the connection was last updated.
  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/