Acronis Customer Alerts Count API

openapi: 3.2.0
info:
  title: Alert Manager Customer Alerts Count API
  version: '1.0'
servers:
- url: https://dev-cloud.acronis.com/api/alert_manager/v1
  variables: {}
tags:
- name: Customer Alerts Count
paths:
  /customer_alerts_count:
    get:
      operationId: Fetch partner's customer alerts count
      description: 'Fetches count of alerts per customer.

        This API uses extended barrier mode by default.

        Response does not include customers with no alerts.'
      parameters:
      - name: deleted_at
        description: 'A filter by date when the alert was dismissed. Must be a Unix timestamp in nanoseconds.


          Available operators:


          * `eq` - equals

          * `lt` - less than

          * `gt` - greater than

          * `le` - less than or equals

          * `ge` - greater than or equals

          '
        required: false
        in: query
        schema:
          description: 'A filter by date when the alert was dismissed. Must be a Unix timestamp in nanoseconds.


            Available operators:


            * `eq` - equals

            * `lt` - less than

            * `gt` - greater than

            * `le` - less than or equals

            * `ge` - greater than or equals

            '
          type: string
          pattern: ^([0-9]+)|(eq\([0-9]+\))$|(le\([0-9]+\))|(lt\([0-9]+\))|(gt\([0-9]+\))|(ge\([0-9]+\))$
      - name: id
        description: Case-insensitive IDs of the alerts to return in the results.
        required: false
        in: query
        schema:
          description: Case-insensitive IDs of the alerts to return in the results.
          example:
          - c106fd7b-338b-4635-8e61-31f6255482d5
          - f71fdcdb-fc43-4b2f-9830-c53fb213de7b
          type: array
          items:
            $ref: '#/components/schemas/uuid'
      - name: query
        description: A text to search for within `planName` or `resourceName` fields of the alerts. The search is case-insensitive.
        required: false
        in: query
        schema:
          description: A text to search for within `planName` or `resourceName` fields of the alerts. The search is case-insensitive.
          type: string
      - name: severity
        description: 'A filter by the alert severity.


          Available operators:


          * `eq` - equals to the specified value: eq(warning)

          * `or` - equals to one of the specified values: or(warning,critical)

          * `lt` - less than the specified value: lt(warning)

          * `gt` - greater than the specified value: gt(warning)

          * `le` - less than or equals to the specified value: le(warning)

          * `ge` - greater than or equals to the specified value: ge(warning)

          '
        required: false
        in: query
        schema:
          description: 'A filter by the alert severity.


            Available operators:


            * `eq` - equals to the specified value: eq(warning)

            * `or` - equals to one of the specified values: or(warning,critical)

            * `lt` - less than the specified value: lt(warning)

            * `gt` - greater than the specified value: gt(warning)

            * `le` - less than or equals to the specified value: le(warning)

            * `ge` - greater than or equals to the specified value: ge(warning)

            '
          enum:
          - ok
          - information
          - warning
          - error
          - critical
          type: string
      - name: show_deleted
        description: If true, dismissed alerts will be included in the response.
        required: false
        in: query
        schema:
          description: If true, dismissed alerts will be included in the response.
          default: false
          type: boolean
      - name: show_deleted_only
        description: If true, only dismissed alerts will be included in the response.
        required: false
        in: query
        schema:
          description: If true, only dismissed alerts will be included in the response.
          default: false
          type: boolean
      - name: source
        description: A filter by the alert producer.
        required: false
        in: query
        schema:
          description: A filter by the alert producer.
          type: string
      - name: source_time_stamp
        description: 'A filter by timestamp that was provided by an alert producer.

          The timestamp may be an arbitrary integer value.


          Available operators:


          * `eq` - equals

          * `lt` - less than

          * `gt` - greater than

          * `le` - less than or equals

          * `ge` - greater than or equals

          '
        required: false
        in: query
        schema:
          description: 'A filter by timestamp that was provided by an alert producer.

            The timestamp may be an arbitrary integer value.


            Available operators:


            * `eq` - equals

            * `lt` - less than

            * `gt` - greater than

            * `le` - less than or equals

            * `ge` - greater than or equals

            '
          type: string
          pattern: ^([0-9]+)|(eq\([0-9]+\))$|(le\([0-9]+\))|(lt\([0-9]+\))|(gt\([0-9]+\))|(ge\([0-9]+\))$
      - name: type
        description: A filter by list of alert types. A list of registered types can be obtained by sending a GET request to the `/types` endpoint.
        required: false
        in: query
        schema:
          description: A filter by list of alert types. A list of registered types can be obtained by sending a GET request to the `/types` endpoint.
          type: array
          items:
            type: string
      - name: updated_at
        description: 'A filter by date when the alert was created or dismissed. Must be a Unix timestamp in nanoseconds.


          Available operators:


          * `eq` - equals

          * `lt` - less than

          * `gt` - greater than

          * `le` - less than or equals

          * `ge` - greater than or equals

          '
        required: false
        in: query
        schema:
          description: 'A filter by date when the alert was created or dismissed. Must be a Unix timestamp in nanoseconds.


            Available operators:


            * `eq` - equals

            * `lt` - less than

            * `gt` - greater than

            * `le` - less than or equals

            * `ge` - greater than or equals

            '
          type: string
          pattern: ^([0-9]+)|(eq\([0-9]+\))$|(le\([0-9]+\))|(lt\([0-9]+\))|(gt\([0-9]+\))|(ge\([0-9]+\))$
      - name: created_at
        description: 'A filter by date when the alert was created. Must be a Unix timestamp in nanoseconds.


          Available operators:


          * `eq` - equals

          * `lt` - less than

          * `gt` - greater than

          * `le` - less than or equals

          * `ge` - greater than or equals

          '
        required: false
        in: query
        schema:
          description: 'A filter by date when the alert was created. Must be a Unix timestamp in nanoseconds.


            Available operators:


            * `eq` - equals

            * `lt` - less than

            * `gt` - greater than

            * `le` - less than or equals

            * `ge` - greater than or equals

            '
          type: string
          pattern: ^([0-9]+)|(eq\([0-9]+\))$|(le\([0-9]+\))|(lt\([0-9]+\))|(gt\([0-9]+\))|(ge\([0-9]+\))$
      - name: category
        description: 'A filter by list of alert categories. A list of registered categories can be obtained by sending a GET request to the `/categories` endpoint.


          * Example: `category=Backup&category=Monitoring`

          '
        required: false
        in: query
        schema:
          description: 'A filter by list of alert categories. A list of registered categories can be obtained by sending a GET request to the `/categories` endpoint.


            * Example: `category=Backup&category=Monitoring`

            '
          type: array
          items:
            type: string
      - name: planId
        description: "Case-insensitive filter for alerts with the specified plan IDs.\n\nThe following rules are applied:\n* planId=BackupPlan01 - matches the exact `BackupPlan01` string in the corresponding parameter\n* planId=or(BackupPlan01,BackupPlan02) - matches the exact `BackupPlan01` or `BackupPlan02` strings in the corresponding parameter\n\nExamples: `planId=A1111&planId=B2222`\n          `planId=or(A1111,B2222)`\n"
        required: false
        in: query
        schema:
          description: "Case-insensitive filter for alerts with the specified plan IDs.\n\nThe following rules are applied:\n* planId=BackupPlan01 - matches the exact `BackupPlan01` string in the corresponding parameter\n* planId=or(BackupPlan01,BackupPlan02) - matches the exact `BackupPlan01` or `BackupPlan02` strings in the corresponding parameter\n\nExamples: `planId=A1111&planId=B2222`\n          `planId=or(A1111,B2222)`\n"
          type: array
          items:
            type: string
      - name: resourceId
        description: "Case-insensitive filter for alerts with the specified resource IDs.\n\nThe following rules are applied:\n* resourceId=FileResource01 - matches the exact `FileResource01` string in the corresponding parameter\n* resourceId=or(FileResource01,FileResource02) - matches the exact `FileResource01` or `FileResource02` strings in the corresponding parameter\n\nExamples: `resourceId=A1111&resourceId=B2222`\n          `resourceId=or(A1111,B2222)`\n"
        required: false
        in: query
        schema:
          description: "Case-insensitive filter for alerts with the specified resource IDs.\n\nThe following rules are applied:\n* resourceId=FileResource01 - matches the exact `FileResource01` string in the corresponding parameter\n* resourceId=or(FileResource01,FileResource02) - matches the exact `FileResource01` or `FileResource02` strings in the corresponding parameter\n\nExamples: `resourceId=A1111&resourceId=B2222`\n          `resourceId=or(A1111,B2222)`\n"
          type: array
          items:
            type: string
      - name: planName
        description: "Case-insensitive filter for alerts with the specified plan names.\n\nThe following rules are applied:\n* planName=Plan01 - matches the substring `Plan01` in the corresponding parameter\n* planName=eq(BackupPlan01) - matches the exact `BackupPlan01` string in the corresponding parameter\n* planName=or(BackupPlan01,BackupPlan02) - matches the exact `BackupPlan01` or `BackupPlan02` strings in the corresponding parameter\n\nExamples: `planName=Plan1&planName=eq(BackupPlan2)`\n          `planName=Plan1&planName=or(BackupPlan2,BackupPlan3)`\n"
        required: false
        in: query
        schema:
          description: "Case-insensitive filter for alerts with the specified plan names.\n\nThe following rules are applied:\n* planName=Plan01 - matches the substring `Plan01` in the corresponding parameter\n* planName=eq(BackupPlan01) - matches the exact `BackupPlan01` string in the corresponding parameter\n* planName=or(BackupPlan01,BackupPlan02) - matches the exact `BackupPlan01` or `BackupPlan02` strings in the corresponding parameter\n\nExamples: `planName=Plan1&planName=eq(BackupPlan2)`\n          `planName=Plan1&planName=or(BackupPlan2,BackupPlan3)`\n"
          type: array
          items:
            type: string
      - name: resourceName
        description: "Case-insensitive filter for alerts with the specified resource names.\n\nThe following rules are applied:\n* resourceName=Resource01 - matches the substring `Resource01` in the corresponding parameter\n* resourceName=eq(FileResource01) - matches the exact `FileResource01` string in the corresponding parameter\n* resourceName=or(FileResource01,FileResource02) - matches the exact `FileResource01` or `FileResource02` strings in the corresponding parameter\n\nExamples: `resourceName=Resource1&resourceName=eq(FileResource2)`\n          `resourceName=Resource1&resourceName=or(FileResource2,FileResource3)`\n"
        required: false
        in: query
        schema:
          description: "Case-insensitive filter for alerts with the specified resource names.\n\nThe following rules are applied:\n* resourceName=Resource01 - matches the substring `Resource01` in the corresponding parameter\n* resourceName=eq(FileResource01) - matches the exact `FileResource01` string in the corresponding parameter\n* resourceName=or(FileResource01,FileResource02) - matches the exact `FileResource01` or `FileResource02` strings in the corresponding parameter\n\nExamples: `resourceName=Resource1&resourceName=eq(FileResource2)`\n          `resourceName=Resource1&resourceName=or(FileResource2,FileResource3)`\n"
          type: array
          items:
            type: string
      responses:
        '200':
          description: List of customer alerts.
          content:
            application/json:
              schema:
                example:
                  items:
                  - customer_id: '14'
                    customer_name: John Dow and Sons
                    parents:
                    - Backup Solutions Inc
                    - London
                    - John Dow and Sons
                    alerts_count: 2
                  - customer_id: '22'
                    customer_name: Jane Smith
                    parents:
                    - Backup Solutions Inc
                    - Manchester
                    - Jane Smith
                    alerts_count: 1
                type: object
                required:
                - items
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/CustomerAlertCount'
        '401':
          description: Request is refused because authentication parameters are invalid.
          content:
            text/plain:
              schema:
                example: "<html>\n  <head>\n    <title>401 Authorization Required</title>\n  </head>\n  <body>\n    <center>\n      <h1>401 Authorization Required</h1>\n    </center>\n    <hr>\n    <center>nginx</center>\n  </body>\n</html>\n"
        '403':
          description: 'A security error due to an issue with tenant security claim: invalid tenant in the access token, tenant resolution failed and etc.

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - oauth_2_0:
        - urn:acronis.com::alert_manager::viewer
      tags:
      - Customer Alerts Count
      summary: Fetch partner's customer alerts count
      x-summary-source: derived
components:
  schemas:
    uuid:
      type: string
      pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
    kbLinkInfo:
      description: Components for kblink
      type: object
      required:
      - lineTag
      - serCode
      - version
      - build
      - product
      - os
      properties:
        lineTag:
          type: string
        serCode:
          type: string
        version:
          type: string
        build:
          type: integer
        product:
          type: string
        os:
          type: string
    Error:
      description: Base error object
      type: object
      required:
      - domain
      - code
      properties:
        domain:
          description: Error type or category. Can be ['Licensing','Access'] or name of service (for example 'PolicyManager' or 'VaultManager')
          type: string
        code:
          description: Error id or code, unique in the domain. Same as in 'reason' field
          type: string
        reason:
          description: Obsolete. Error id or code, unique in the domain. Same as in 'code' field
          type: string
        context:
          description: Error context dictionary
          type: object
        kbLink:
          $ref: '#/components/schemas/kbLinkInfo'
        debug:
          $ref: '#/components/schemas/debugInfo'
    CustomerAlertCount:
      type: object
      required:
      - customer_id
      - customer_name
      - parents
      - alerts_count
      properties:
        customer_id:
          description: Customer ID.
          type: string
        customer_name:
          description: Customer name.
          type: string
        parents:
          description: List of parent tenant names.
          type: array
          items:
            type: string
        alerts_count:
          description: Amount of customer's alerts.
          type: integer
    debugInfo:
      description: Error debug information (map type)
      type: object
  securitySchemes:
    oauth_2_0:
      type: oauth2
      description: OAuth 2.0 security scheme definition for a user authorization.
      flows:
        clientCredentials:
          scopes:
            urn:acronis.com::alert_manager::admin: ''
            urn:acronis.com::alert_manager::viewer: ''
          tokenUrl: https://dev-cloud.acronis.com/api/2/idp/token
        password:
          scopes:
            urn:acronis.com::alert_manager::admin: ''
            urn:acronis.com::alert_manager::viewer: ''
          tokenUrl: https://dev-cloud.acronis.com/api/2/idp/token
        authorizationCode:
          scopes:
            urn:acronis.com::alert_manager::admin: ''
            urn:acronis.com::alert_manager::viewer: ''
          authorizationUrl: https://dev-cloud.acronis.com/api/2/idp/authorize
          tokenUrl: https://dev-cloud.acronis.com/api/2/idp/token
x-roles:
- name: public
  id: '1'
  description: public role
  x-tags:
  - public
- name: private
  id: '2'
  description: private role
  x-tags:
  - private