APIs.io Engineering Platform Magic Static Routes API

openapi: 3.0.0
info:
  version: "1.0.0"
  x-release: v4
  title: APIs.io Engineering Platform Amazon API Gateway 2014 11 13 Magic Static Routes 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: Magic Static Routes
paths:
  /accounts/{account_id}/magic/routes:
    delete:
      description: Delete multiple Magic static routes.
      operationId: magic-static-routes-delete-many-routes
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/magic_identifier'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/magic_route_delete_many_request'
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/magic_multiple_route_delete_response'
                - $ref: '#/components/schemas/magic_api-response-common-failure'
          description: Delete Many Routes response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/magic_multiple_route_delete_response'
          description: Delete Many Routes response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Delete Many Routes
      tags:
      - Magic Static Routes
      x-cfPermissionsRequired:
        enum:
        - '#organization:edit'
      x-cfPlanAvailability:
        business: false
        enterprise: true
        free: false
        pro: false
    get:
      description: List all Magic static routes.
      operationId: magic-static-routes-list-routes
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/magic_identifier'
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/magic_routes_collection_response'
                - $ref: '#/components/schemas/magic_api-response-common-failure'
          description: List Routes response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/magic_routes_collection_response'
          description: List Routes response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform List Routes
      tags:
      - Magic Static Routes
      x-cfPlanAvailability:
        business: false
        enterprise: true
        free: false
        pro: false
    post:
      description: Creates a new Magic static route. Use `?validate_only=true` as an optional query parameter to run validation only without persisting changes.
      operationId: magic-static-routes-create-routes
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/magic_identifier'
      requestBody:
        content:
          application/json:
            schema:
              required:
              - prefix
              - nexthop
              - priority
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/magic_routes_collection_response'
                - $ref: '#/components/schemas/magic_api-response-common-failure'
          description: Create Routes response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/magic_routes_collection_response'
          description: Create Routes response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Create Routes
      tags:
      - Magic Static Routes
      x-cfPermissionsRequired:
        enum:
        - '#organization:edit'
      x-cfPlanAvailability:
        business: false
        enterprise: true
        free: false
        pro: false
    put:
      description: Update multiple Magic static routes. Use `?validate_only=true` as an optional query parameter to run validation only without persisting changes. Only fields for a route that need to be changed need be provided.
      operationId: magic-static-routes-update-many-routes
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/magic_identifier'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/magic_route_update_many_request'
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/magic_multiple_route_modified_response'
                - $ref: '#/components/schemas/magic_api-response-common-failure'
          description: Update Many Routes response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/magic_multiple_route_modified_response'
          description: Update Many Routes response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Update Many Routes
      tags:
      - Magic Static Routes
      x-cfPermissionsRequired:
        enum:
        - '#organization:edit'
      x-cfPlanAvailability:
        business: false
        enterprise: true
        free: false
        pro: false
  /accounts/{account_id}/magic/routes/{route_id}:
    delete:
      description: Disable and remove a specific Magic static route.
      operationId: magic-static-routes-delete-route
      parameters:
      - in: path
        name: route_id
        required: true
        schema:
          $ref: '#/components/schemas/magic_identifier'
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/magic_identifier'
      requestBody:
        content:
          application/json: {}
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/magic_route_deleted_response'
                - $ref: '#/components/schemas/magic_api-response-common-failure'
          description: Delete Route response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/magic_route_deleted_response'
          description: Delete Route response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Delete Route
      tags:
      - Magic Static Routes
      x-cfPermissionsRequired:
        enum:
        - '#organization:edit'
      x-cfPlanAvailability:
        business: false
        enterprise: true
        free: false
        pro: false
    get:
      description: Get a specific Magic static route.
      operationId: magic-static-routes-route-details
      parameters:
      - in: path
        name: route_id
        required: true
        schema:
          $ref: '#/components/schemas/magic_identifier'
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/magic_identifier'
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/magic_route_single_response'
                - $ref: '#/components/schemas/magic_api-response-common-failure'
          description: Route Details response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/magic_route_single_response'
          description: Route Details response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Route Details
      tags:
      - Magic Static Routes
      x-cfPermissionsRequired:
        enum:
        - '#organization:read'
      x-cfPlanAvailability:
        business: false
        enterprise: true
        free: false
        pro: false
    put:
      description: Update a specific Magic static route. Use `?validate_only=true` as an optional query parameter to run validation only without persisting changes.
      operationId: magic-static-routes-update-route
      parameters:
      - in: path
        name: route_id
        required: true
        schema:
          $ref: '#/components/schemas/magic_identifier'
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/magic_identifier'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/magic_route_update_request'
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/magic_route_modified_response'
                - $ref: '#/components/schemas/magic_api-response-common-failure'
          description: Update Route response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/magic_route_modified_response'
          description: Update Route response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Update Route
      tags:
      - Magic Static Routes
      x-cfPermissionsRequired:
        enum:
        - '#organization:edit'
      x-cfPlanAvailability:
        business: false
        enterprise: true
        free: false
        pro: false
components:
  schemas:
    magic_api-response-single:
      allOf:
      - $ref: '#/components/schemas/magic_api-response-common'
      - properties:
          result:
            anyOf:
            - nullable: true
              type: object
            - nullable: true
              type: string
      type: object
    magic_scope:
      description: Used only for ECMP routes.
      properties:
        colo_names:
          $ref: '#/components/schemas/magic_colo_names'
        colo_regions:
          $ref: '#/components/schemas/magic_colo_regions'
      type: object
    magic_colo_regions:
      description: List of colo regions for the ECMP scope.
      items:
        $ref: '#/components/schemas/magic_colo_region'
      type: array
    magic_prefix:
      description: IP Prefix in Classless Inter-Domain Routing format.
      example: 192.0.2.0/24
      type: string
    magic_route_deleted_response:
      allOf:
      - $ref: '#/components/schemas/magic_api-response-single'
      - properties:
          result:
            properties:
              deleted:
                example: true
                type: boolean
              deleted_route:
                $ref: '#/components/schemas/magic_route'
            type: object
    magic_colo_name:
      description: Scope colo name.
      example: den01
      type: string
    magic_created_on:
      description: When the route was created.
      example: '2017-06-14T00:00:00Z'
      format: date-time
      readOnly: true
      type: string
    magic_identifier:
      description: Identifier
      example: 023e105f4ecef8ad9ca31a8372d0c353
      maxLength: 32
      readOnly: true
      type: string
    magic_multiple_route_modified_response:
      allOf:
      - $ref: '#/components/schemas/magic_api-response-single'
      - properties:
          result:
            properties:
              modified:
                example: true
                type: boolean
              modified_routes:
                items:
                  $ref: '#/components/schemas/magic_route'
                type: array
    magic_api-response-common:
      properties:
        errors:
          $ref: '#/components/schemas/magic_messages'
        messages:
          $ref: '#/components/schemas/magic_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
    magic_route_update_single_request:
      allOf:
      - properties:
          id:
            $ref: '#/components/schemas/magic_identifier'
        required:
        - id
      - $ref: '#/components/schemas/magic_route_add_single_request'
    magic_colo_names:
      description: List of colo names for the ECMP scope.
      items:
        $ref: '#/components/schemas/magic_colo_name'
      type: array
    magic_route_delete_id:
      allOf:
      - properties:
          id:
            $ref: '#/components/schemas/magic_identifier'
        required:
        - id
    magic_multiple_route_delete_response:
      allOf:
      - $ref: '#/components/schemas/magic_api-response-single'
      - properties:
          result:
            properties:
              deleted:
                example: true
                type: boolean
              deleted_routes:
                items:
                  $ref: '#/components/schemas/magic_route'
                type: array
    magic_route:
      properties:
        created_on:
          $ref: '#/components/schemas/magic_created_on'
        description:
          $ref: '#/components/schemas/magic_description'
        id:
          $ref: '#/components/schemas/magic_identifier'
        modified_on:
          $ref: '#/components/schemas/magic_modified_on'
        nexthop:
          $ref: '#/components/schemas/magic_nexthop'
        prefix:
          $ref: '#/components/schemas/magic_prefix'
        priority:
          $ref: '#/components/schemas/magic_priority'
        scope:
          $ref: '#/components/schemas/magic_scope'
        weight:
          $ref: '#/components/schemas/magic_weight'
      required:
      - prefix
      - nexthop
      - priority
      type: object
    magic_colo_region:
      description: Scope colo region.
      example: APAC
      type: string
    magic_description:
      description: An optional human provided description of the static route.
      example: New route for new prefix 203.0.113.1
      type: string
    magic_messages:
      example: []
      items:
        properties:
          code:
            minimum: 1000
            type: integer
          message:
            type: string
        required:
        - code
        - message
        type: object
        uniqueItems: true
      type: array
    magic_route_modified_response:
      allOf:
      - $ref: '#/components/schemas/magic_api-response-single'
      - properties:
          result:
            properties:
              modified:
                example: true
                type: boolean
              modified_route:
                $ref: '#/components/schemas/magic_route'
            type: object
    magic_nexthop:
      description: The next-hop IP Address for the static route.
      example: 203.0.113.1
      type: string
    magic_routes_collection_response:
      allOf:
      - $ref: '#/components/schemas/magic_api-response-single'
      - properties:
          result:
            properties:
              routes:
                items:
                  $ref: '#/components/schemas/magic_route'
                type: array
    magic_priority:
      description: Priority of the static route.
      type: integer
    magic_route_update_request:
      allOf:
      - $ref: '#/components/schemas/magic_route_add_single_request'
    magic_modified_on:
      description: When the route was last modified.
      example: '2017-06-14T05:20:00Z'
      format: date-time
      readOnly: true
      type: string
    magic_route_single_response:
      allOf:
      - $ref: '#/components/schemas/magic_api-response-single'
      - properties:
          result:
            properties:
              route:
                $ref: '#/components/schemas/magic_route'
            type: object
    magic_route_update_many_request:
      properties:
        routes:
          items:
            $ref: '#/components/schemas/magic_route_update_single_request'
          type: array
      required:
      - routes
      type: object
    magic_route_add_single_request:
      properties:
        description:
          $ref: '#/components/schemas/magic_description'
        nexthop:
          $ref: '#/components/schemas/magic_nexthop'
        prefix:
          $ref: '#/components/schemas/magic_prefix'
        priority:
          $ref: '#/components/schemas/magic_priority'
        scope:
          $ref: '#/components/schemas/magic_scope'
        weight:
          $ref: '#/components/schemas/magic_weight'
      required:
      - prefix
      - nexthop
      - priority
      type: object
    magic_api-response-common-failure:
      properties:
        errors:
          allOf:
          - $ref: '#/components/schemas/magic_messages'
          example:
          - code: 7003
            message: No route for the URI
          minLength: 1
        messages:
          allOf:
          - $ref: '#/components/schemas/magic_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
    magic_weight:
      description: Optional weight of the ECMP scope - if provided.
      type: integer
    magic_route_delete_many_request:
      properties:
        routes:
          items:
            $ref: '#/components/schemas/magic_route_delete_id'
          type: array
      required:
      - routes
      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