APIs.io Engineering Platform Hyperdrive API

openapi: 3.0.0
info:
  version: "1.0.0"
  x-release: v4
  title: APIs.io Engineering Platform Amazon API Gateway 2014 11 13 Hyperdrive 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: Hyperdrive
paths:
  /accounts/{account_id}/hyperdrive/configs:
    get:
      description: Returns a list of Hyperdrives
      operationId: list-hyperdrive
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/hyperdrive_identifier'
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - allOf:
                  - $ref: '#/components/schemas/hyperdrive_api-response-single'
                  - properties:
                      result:
                        nullable: true
                        type: object
                    type: object
                - $ref: '#/components/schemas/hyperdrive_api-response-common-failure'
          description: List Hyperdrives Failure Response
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/hyperdrive_api-response-common'
                - properties:
                    result:
                      items:
                        $ref: '#/components/schemas/hyperdrive_hyperdrive-with-identifier'
                      type: array
          description: List Hyperdrives Response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform List Hyperdrives
      tags:
      - Hyperdrive
      x-api-token-group:
      - Hyperdrive Write
      - Hyperdrive Read
      x-cfPermissionsRequired:
        enum:
        - com.cloudflare.edge.hyperdrive.database.list
    post:
      description: Creates and returns a new Hyperdrive configuration.
      operationId: create-hyperdrive
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/hyperdrive_identifier'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/hyperdrive_create-update-hyperdrive-config'
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - allOf:
                  - $ref: '#/components/schemas/hyperdrive_api-response-single'
                  - properties:
                      result:
                        nullable: true
                        type: object
                    type: object
                - $ref: '#/components/schemas/hyperdrive_api-response-common-failure'
          description: Create Hyperdrive Failure Response
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/hyperdrive_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/hyperdrive_hyperdrive-with-identifier'
          description: Create Hyperdrive Response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Create Hyperdrive
      tags:
      - Hyperdrive
      x-api-token-group:
      - Hyperdrive Write
      x-cfPermissionsRequired:
        enum:
        - com.cloudflare.edge.hyperdrive.database.create
  /accounts/{account_id}/hyperdrive/configs/{hyperdrive_id}:
    delete:
      description: Deletes the specified Hyperdrive.
      operationId: delete-hyperdrive
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/hyperdrive_identifier'
      - in: path
        name: hyperdrive_id
        required: true
        schema:
          $ref: '#/components/schemas/hyperdrive_identifier'
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - allOf:
                  - $ref: '#/components/schemas/hyperdrive_api-response-single'
                  - properties:
                      result:
                        nullable: true
                        type: object
                    type: object
                - $ref: '#/components/schemas/hyperdrive_api-response-common-failure'
          description: Delete Hyperdrive Failure
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/hyperdrive_api-response-single'
                - properties:
                    result:
                      nullable: true
                      type: object
          description: Delete Hyperdrive Response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Delete Hyperdrive
      tags:
      - Hyperdrive
      x-api-token-group:
      - Hyperdrive Write
      x-cfPermissionsRequired:
        enum:
        - com.cloudflare.edge.hyperdrive.database.delete
    get:
      description: Returns the specified Hyperdrive configuration.
      operationId: get-hyperdrive
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/hyperdrive_identifier'
      - in: path
        name: hyperdrive_id
        required: true
        schema:
          $ref: '#/components/schemas/hyperdrive_identifier'
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - allOf:
                  - $ref: '#/components/schemas/hyperdrive_api-response-single'
                  - properties:
                      result:
                        nullable: true
                        type: object
                    type: object
                - $ref: '#/components/schemas/hyperdrive_api-response-common-failure'
          description: Get Hyperdrive Failure
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/hyperdrive_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/hyperdrive_hyperdrive-with-identifier'
          description: Get Hyperdrive Response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Get Hyperdrive
      tags:
      - Hyperdrive
      x-api-token-group:
      - Hyperdrive Write
      - Hyperdrive Read
      x-cfPermissionsRequired:
        enum:
        - com.cloudflare.edge.hyperdrive.database.read
    patch:
      description: Patches and returns the specified Hyperdrive configuration. Updates to the origin and caching settings are applied with an all-or-nothing approach.
      operationId: patch-hyperdrive
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/hyperdrive_identifier'
      - in: path
        name: hyperdrive_id
        required: true
        schema:
          $ref: '#/components/schemas/hyperdrive_identifier'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/hyperdrive_patch-hyperdrive-config'
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - allOf:
                  - $ref: '#/components/schemas/hyperdrive_api-response-single'
                  - properties:
                      result:
                        nullable: true
                        type: object
                    type: object
                - $ref: '#/components/schemas/hyperdrive_api-response-common-failure'
          description: Patch Hyperdrive Failure Response
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/hyperdrive_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/hyperdrive_hyperdrive-with-identifier'
          description: Patch Hyperdrive Response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Patch Hyperdrive
      tags:
      - Hyperdrive
      x-api-token-group:
      - Hyperdrive Write
      x-cfPermissionsRequired:
        enum:
        - com.cloudflare.edge.hyperdrive.database.update
    put:
      description: Updates and returns the specified Hyperdrive configuration.
      operationId: update-hyperdrive
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/hyperdrive_identifier'
      - in: path
        name: hyperdrive_id
        required: true
        schema:
          $ref: '#/components/schemas/hyperdrive_identifier'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/hyperdrive_create-update-hyperdrive-config'
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - allOf:
                  - $ref: '#/components/schemas/hyperdrive_api-response-single'
                  - properties:
                      result:
                        nullable: true
                        type: object
                    type: object
                - $ref: '#/components/schemas/hyperdrive_api-response-common-failure'
          description: Update Hyperdrive Failure Response
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/hyperdrive_api-response-single'
                - properties:
                    result:
                      $ref: '#/components/schemas/hyperdrive_hyperdrive-with-identifier'
          description: Update Hyperdrive Response
      security:
      - api_token: []
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Update Hyperdrive
      tags:
      - Hyperdrive
      x-api-token-group:
      - Hyperdrive Write
      x-cfPermissionsRequired:
        enum:
        - com.cloudflare.edge.hyperdrive.database.update
components:
  schemas:
    hyperdrive_api-response-single:
      allOf:
      - $ref: '#/components/schemas/hyperdrive_api-response-common'
      - properties:
          result:
            anyOf:
            - type: object
            - type: string
            nullable: true
            type: object
      type: object
    hyperdrive_hyperdrive-with-identifier:
      allOf:
      - $ref: '#/components/schemas/hyperdrive_hyperdrive'
      properties:
        id:
          $ref: '#/components/schemas/hyperdrive_identifier'
      type: object
    hyperdrive_api-response-common-failure:
      properties:
        errors:
          allOf:
          - $ref: '#/components/schemas/hyperdrive_messages'
          example:
          - code: 7003
            message: No route for the URI
          minLength: 1
        messages:
          allOf:
          - $ref: '#/components/schemas/hyperdrive_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
    hyperdrive_identifier:
      description: Identifier
      example: 023e105f4ecef8ad9ca31a8372d0c353
      maxLength: 32
      readOnly: true
      type: string
    hyperdrive_messages:
      example: []
      items:
        properties:
          code:
            minimum: 1000
            type: integer
          message:
            type: string
        required:
        - code
        - message
        type: object
        uniqueItems: true
      type: array
    hyperdrive_hyperdrive-scheme:
      default: postgres
      description: Specifies the URL scheme used to connect to your origin database.
      enum:
      - postgres
      - postgresql
      - mysql
      type: string
    hyperdrive_api-response-common:
      properties:
        errors:
          $ref: '#/components/schemas/hyperdrive_messages'
        messages:
          $ref: '#/components/schemas/hyperdrive_messages'
        result:
          anyOf:
          - type: object
          - items: {}
            type: array
          - type: string
        success:
          description: Whether the API call was successful
          enum:
          - true
          example: true
          type: boolean
      required:
      - success
      - errors
      - messages
      - result
      type: object
    hyperdrive_hyperdrive:
      properties:
        caching:
          $ref: '#/components/schemas/hyperdrive_hyperdrive-caching'
        name:
          $ref: '#/components/schemas/hyperdrive_hyperdrive-name'
        origin:
          $ref: '#/components/schemas/hyperdrive_hyperdrive-origin'
      type: object
    hyperdrive_create-update-hyperdrive-config:
      allOf:
      - $ref: '#/components/schemas/hyperdrive_hyperdrive'
      properties:
        origin:
          $ref: '#/components/schemas/hyperdrive_hyperdrive-origin-with-secrets'
      required:
      - name
      - origin
      type: object
    hyperdrive_hyperdrive-caching:
      properties:
        disabled:
          description: 'When set to true, disables the caching of SQL responses. (Default: false)'
          example: false
          type: boolean
        max_age:
          description: 'When present, specifies max duration for which items should persist in the cache. (Default: 60)'
          example: 60
          type: integer
        stale_while_revalidate:
          description: 'When present, indicates the number of seconds cache may serve the response after it becomes stale. (Default: 15)'
          example: 15
          type: integer
      type: object
    hyperdrive_hyperdrive-origin:
      properties:
        access_client_id:
          description: The Client ID of the Access token to use when connecting to the origin database
          example: 0123456789abcdef0123456789abcdef.access
          type: string
        database:
          description: The name of your origin database.
          example: postgres
          type: string
        host:
          description: The host (hostname or IP) of your origin database.
          example: database.example.com
          type: string
        port:
          description: 'The port (default: 5432 for Postgres) of your origin database.'
          example: '5432'
          type: integer
        scheme:
          $ref: '#/components/schemas/hyperdrive_hyperdrive-scheme'
        user:
          description: The user of your origin database.
          example: postgres
          type: string
      required:
      - host
      - scheme
      - database
      - user
      type: object
    hyperdrive_patch-hyperdrive-config:
      allOf:
      - $ref: '#/components/schemas/hyperdrive_hyperdrive'
      properties:
        origin:
          $ref: '#/components/schemas/hyperdrive_hyperdrive-origin-with-secrets'
      type: object
    hyperdrive_hyperdrive-name:
      example: example-hyperdrive
      type: string
    hyperdrive_hyperdrive-origin-with-secrets:
      allOf:
      - $ref: '#/components/schemas/hyperdrive_hyperdrive-origin'
      properties:
        access_client_secret:
          description: The Client Secret of the Access token to use when connecting to the origin database
          example: 0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef
          type: string
        password:
          description: The password required to access your origin database. This value is write-only and never returned by the API.
          example: password1234!
          type: string
      required:
      - password
      type: object
  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