APIs.io Engineering Platform DNS Firewall Analytics API

openapi: 3.0.0
info:
  version: "1.0.0"
  x-release: v4
  title: APIs.io Engineering Platform Amazon API Gateway 2014 11 13 DNS Firewall Analytics API
  description: <fullname>Amazon API Gateway</fullname> <p>Amazon API Gateway helps developers deliver robust, secure, and scalable mobile and web application back ends. API Gateway allows developers to securely connect mobile and web applications to APIs that run on AWS Lambda, Amazon EC2, or other publicly addressable web services that are hosted outside of AWS.</p>
  x-logo:
    url: https://api.apis.guru/v2/cache/logo/https_twitter.com_awscloud_profile_image.png
    backgroundColor: '#FFFFFF'
  termsOfService: https://aws.amazon.com/service-terms/
  contact:
    name: Mike Ralphson
    email: mike.ralphson@gmail.com
    url: https://github.com/mermade/aws2openapi
    x-twitter: PermittedSoc
  license:
    name: Apache 2.0 License
    url: http://www.apache.org/licenses/
  x-providerName: amazonaws.com
  x-serviceName: apigateway
  x-origin:
  - contentType: application/json
    url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/apigateway-2015-07-09.normal.json
    converter:
      url: https://github.com/mermade/aws2openapi
    x-apisguru-driver: external
  x-apiClientRegistration:
    url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct
  x-apisguru-categories:
  - cloud
  x-preferred: true
servers:
- url: http://apigateway.{region}.amazonaws.com
  variables:
    region:
      description: The AWS region
      enum:
      - us-east-1
      - us-east-2
      - us-west-1
      - us-west-2
      - us-gov-west-1
      - us-gov-east-1
      - ca-central-1
      - eu-north-1
      - eu-west-1
      - eu-west-2
      - eu-west-3
      - eu-central-1
      - eu-south-1
      - af-south-1
      - ap-northeast-1
      - ap-northeast-2
      - ap-northeast-3
      - ap-southeast-1
      - ap-southeast-2
      - ap-east-1
      - ap-south-1
      - sa-east-1
      - me-south-1
      default: us-east-1
  description: The Amazon API Gateway multi-region endpoint
- url: https://apigateway.{region}.amazonaws.com
  variables:
    region:
      description: The AWS region
      enum:
      - us-east-1
      - us-east-2
      - us-west-1
      - us-west-2
      - us-gov-west-1
      - us-gov-east-1
      - ca-central-1
      - eu-north-1
      - eu-west-1
      - eu-west-2
      - eu-west-3
      - eu-central-1
      - eu-south-1
      - af-south-1
      - ap-northeast-1
      - ap-northeast-2
      - ap-northeast-3
      - ap-southeast-1
      - ap-southeast-2
      - ap-east-1
      - ap-south-1
      - sa-east-1
      - me-south-1
      default: us-east-1
  description: The Amazon API Gateway multi-region endpoint
- url: http://apigateway.{region}.amazonaws.com.cn
  variables:
    region:
      description: The AWS region
      enum:
      - cn-north-1
      - cn-northwest-1
      default: cn-north-1
  description: The Amazon API Gateway endpoint for China (Beijing) and China (Ningxia)
- url: https://apigateway.{region}.amazonaws.com.cn
  variables:
    region:
      description: The AWS region
      enum:
      - cn-north-1
      - cn-northwest-1
      default: cn-north-1
  description: The Amazon API Gateway endpoint for China (Beijing) and China (Ningxia)
security:
- hmac: []
tags:
- name: DNS Firewall Analytics
paths:
  /accounts/{account_id}/dns_firewall/{dns_firewall_id}/dns_analytics/report:
    get:
      description: 'Retrieves a list of summarised aggregate metrics over a given time period.


        See [Analytics API properties](https://developers.cloudflare.com/dns/reference/analytics-api-properties/) for detailed information about the available query parameters.'
      operationId: dns-firewall-analytics-table
      parameters:
      - in: path
        name: dns_firewall_id
        required: true
        schema:
          $ref: '#/components/schemas/dns-analytics_identifier'
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/dns-analytics_identifier'
      - in: query
        name: metrics
        schema:
          $ref: '#/components/schemas/dns-analytics_metrics'
      - in: query
        name: dimensions
        schema:
          $ref: '#/components/schemas/dns-analytics_dimensions'
      - in: query
        name: since
        schema:
          $ref: '#/components/schemas/dns-analytics_since'
      - in: query
        name: until
        schema:
          $ref: '#/components/schemas/dns-analytics_until'
      - in: query
        name: limit
        schema:
          $ref: '#/components/schemas/dns-analytics_limit'
      - in: query
        name: sort
        schema:
          $ref: '#/components/schemas/dns-analytics_sort'
      - in: query
        name: filters
        schema:
          $ref: '#/components/schemas/dns-analytics_filters'
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - allOf:
                  - $ref: '#/components/schemas/dns-analytics_api-response-single'
                  - properties:
                      result:
                        $ref: '#/components/schemas/dns-analytics_report'
                    type: object
                - $ref: '#/components/schemas/dns-analytics_api-response-common-failure'
          description: Table response failure
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/dns-analytics_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/dns-analytics_report'
                  type: object
          description: Table response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Table
      tags:
      - DNS Firewall Analytics
      x-cfPermissionsRequired:
        enum:
        - '#analytics:read'
  /accounts/{account_id}/dns_firewall/{dns_firewall_id}/dns_analytics/report/bytime:
    get:
      description: 'Retrieves a list of aggregate metrics grouped by time interval.


        See [Analytics API properties](https://developers.cloudflare.com/dns/reference/analytics-api-properties/) for detailed information about the available query parameters.'
      operationId: dns-firewall-analytics-by-time
      parameters:
      - in: path
        name: dns_firewall_id
        required: true
        schema:
          $ref: '#/components/schemas/dns-analytics_identifier'
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/dns-analytics_identifier'
      - in: query
        name: metrics
        schema:
          $ref: '#/components/schemas/dns-analytics_metrics'
      - in: query
        name: dimensions
        schema:
          $ref: '#/components/schemas/dns-analytics_dimensions'
      - in: query
        name: since
        schema:
          $ref: '#/components/schemas/dns-analytics_since'
      - in: query
        name: until
        schema:
          $ref: '#/components/schemas/dns-analytics_until'
      - in: query
        name: limit
        schema:
          $ref: '#/components/schemas/dns-analytics_limit'
      - in: query
        name: sort
        schema:
          $ref: '#/components/schemas/dns-analytics_sort'
      - in: query
        name: filters
        schema:
          $ref: '#/components/schemas/dns-analytics_filters'
      - in: query
        name: time_delta
        schema:
          $ref: '#/components/schemas/dns-analytics_time_delta'
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - allOf:
                  - $ref: '#/components/schemas/dns-analytics_api-response-single'
                  - properties:
                      result:
                        $ref: '#/components/schemas/dns-analytics_report_bytime'
                    type: object
                - $ref: '#/components/schemas/dns-analytics_api-response-common-failure'
          description: By Time response failure
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/dns-analytics_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/dns-analytics_report_bytime'
                  type: object
          description: By Time response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform By Time
      tags:
      - DNS Firewall Analytics
      x-cfPermissionsRequired:
        enum:
        - '#analytics:read'
components:
  schemas:
    dns-analytics_filters:
      description: Segmentation filter in 'attribute operator value' format.
      example: responseCode==NOERROR,queryType==A
      type: string
    dns-analytics_report_bytime:
      allOf:
      - $ref: '#/components/schemas/dns-analytics_result'
      - properties:
          data:
            items:
              properties:
                metrics:
                  description: Array with one item per requested metric. Each item is an array of values, broken down by time interval.
                  items:
                    description: Nominal metric values, broken down by time interval.
                    items: {}
                    properties:
                      items:
                        description: Nominal metric value.
                        type: number
                    type: array
                  type: array
              required:
              - metrics
          query:
            properties:
              time_delta:
                $ref: '#/components/schemas/dns-analytics_time_delta'
            required:
            - time_delta
            type: object
          time_intervals:
            description: 'Array of time intervals in the response data. Each interval is represented as an array containing two values: the start time, and the end time.

              '
            items:
              description: Array with exactly two items, representing the start and end time (respectively) of this time interval.
              items:
                description: Time value.
                example: '2023-11-11T12:00:00Z'
                format: date-time
                type: string
              type: array
            type: array
        required:
        - time_intervals
        - query
        - data
    dns-analytics_since:
      description: Start date and time of requesting data period in ISO 8601 format.
      example: '2023-11-11T12:00:00Z'
      format: date-time
      type: string
    dns-analytics_limit:
      default: 100000
      description: Limit number of returned metrics.
      example: 100
      type: integer
    dns-analytics_data:
      description: Array with one row per combination of dimension values.
      items:
        properties:
          dimensions:
            description: Array of dimension values, representing the combination of dimension values corresponding to this row.
            items:
              description: Dimension value.
              example: NODATA
              type: string
            type: array
        required:
        - dimensions
        type: object
      type: array
    dns-analytics_api-response-common:
      properties:
        errors:
          $ref: '#/components/schemas/dns-analytics_messages'
        messages:
          $ref: '#/components/schemas/dns-analytics_messages'
        success:
          description: Whether the API call was successful
          enum:
          - true
          example: true
          type: boolean
      required:
      - success
      - errors
      - messages
      type: object
    dns-analytics_sort:
      description: A comma-separated list of dimensions to sort by, where each dimension may be prefixed by - (descending) or + (ascending).
      example: +responseCode,-queryName
      type: string
    dns-analytics_metrics:
      description: A comma-separated list of metrics to query.
      example: queryCount,uncachedCount
      type: string
    dns-analytics_report:
      allOf:
      - $ref: '#/components/schemas/dns-analytics_result'
      - properties:
          data:
            items:
              properties:
                metrics:
                  description: Array with one item per requested metric. Each item is a single value.
                  items:
                    description: Nominal metric value.
                    type: number
                  type: array
              required:
              - metrics
        required:
        - data
    dns-analytics_dimensions:
      description: A comma-separated list of dimensions to group results by.
      example: queryType
      type: string
    dns-analytics_api-response-common-failure:
      properties:
        errors:
          allOf:
          - $ref: '#/components/schemas/dns-analytics_messages'
          example:
          - code: 7003
            message: No route for the URI
          minLength: 1
        messages:
          allOf:
          - $ref: '#/components/schemas/dns-analytics_messages'
          example: []
        result:
          enum:
          - null
          nullable: true
          type: object
        success:
          description: Whether the API call was successful
          enum:
          - false
          example: false
          type: boolean
      required:
      - success
      - errors
      - messages
      - result
      type: object
    dns-analytics_identifier:
      description: Identifier
      example: 023e105f4ecef8ad9ca31a8372d0c353
      maxLength: 32
      type: string
    dns-analytics_until:
      description: End date and time of requesting data period in ISO 8601 format.
      example: '2023-11-11T13:00:00Z'
      format: date-time
      type: string
    dns-analytics_query:
      properties:
        dimensions:
          description: Array of dimension names.
          example:
          - responseCode
          - queryName
          items:
            description: Dimension name.
            example: responseCode
            type: string
          type: array
        filters:
          $ref: '#/components/schemas/dns-analytics_filters'
        limit:
          $ref: '#/components/schemas/dns-analytics_limit'
        metrics:
          description: Array of metric names.
          example:
          - queryCount
          - responseTimeAvg
          items:
            description: Metric name.
            example: queries
            type: string
          type: array
        since:
          $ref: '#/components/schemas/dns-analytics_since'
        sort:
          description: Array of dimensions to sort by, where each dimension may be prefixed by - (descending) or + (ascending).
          example:
          - +responseCode
          - -queryName
          items:
            description: Dimension name (may be prefixed by - (descending) or + (ascending).
            example: +responseCode
            type: string
          type: array
        until:
          $ref: '#/components/schemas/dns-analytics_until'
      required:
      - dimensions
      - metrics
      - since
      - until
      - limit
      type: object
    dns-analytics_api-response-single:
      allOf:
      - $ref: '#/components/schemas/dns-analytics_api-response-common'
      type: object
    dns-analytics_time_delta:
      description: Unit of time to group data by.
      enum:
      - all
      - auto
      - year
      - quarter
      - month
      - week
      - day
      - hour
      - dekaminute
      - minute
      example: hour
      type: string
    dns-analytics_result:
      properties:
        data:
          $ref: '#/components/schemas/dns-analytics_data'
        data_lag:
          description: Number of seconds between current time and last processed event, in another words how many seconds of data could be missing.
          example: 60
          minimum: 0
          type: number
        max:
          description: Maximum results for each metric (object mapping metric names to values). Currently always an empty object.
          type: object
        min:
          description: Minimum results for each metric (object mapping metric names to values). Currently always an empty object.
          type: object
        query:
          $ref: '#/components/schemas/dns-analytics_query'
        rows:
          description: Total number of rows in the result.
          example: 100
          minimum: 0
          type: number
        totals:
          description: Total results for metrics across all data (object mapping metric names to values).
          type: object
      required:
      - rows
      - totals
      - min
      - max
      - data_lag
      - query
      - data
      type: object
    dns-analytics_messages:
      example: []
      items:
        properties:
          code:
            minimum: 1000
            type: integer
          message:
            type: string
        required:
        - code
        - message
        type: object
        uniqueItems: true
      type: array
  securitySchemes:
    hmac:
      type: apiKey
      name: Authorization
      in: header
      description: Amazon Signature authorization v4
      x-amazon-apigateway-authtype: awsSigv4
externalDocs:
  description: Amazon Web Services documentation
  url: https://docs.aws.amazon.com/apigateway/
x-hasEquivalentPaths: true