openapi: 3.0.0
info:
  version: 2015-07-09
  x-release: v4
  title: APIs.io Engineering Platform Amazon API Gateway 2014 11 13 Account-Level Custom Nameservers 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
      version: 1.0.0
    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: Account-Level Custom Nameservers
paths:
  /accounts/{account_id}/custom_ns:
    get:
      description: List an account's custom nameservers.
      operationId: account-level-custom-nameservers-list-account-custom-nameservers
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/dns-custom-nameservers_identifier'
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/dns-custom-nameservers_acns_response_collection'
                - $ref: '#/components/schemas/dns-custom-nameservers_api-response-common-failure'
          description: List Account Custom Nameservers response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dns-custom-nameservers_acns_response_collection'
          description: List Account Custom Nameservers response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform List Account Custom Nameservers
      tags:
      - Account-Level Custom Nameservers
      x-cfPermissionsRequired:
        enum:
        - '#organization:read'
      x-cfPlanAvailability:
        business: true
        enterprise: true
        free: false
        pro: false
    post:
      operationId: account-level-custom-nameservers-add-account-custom-nameserver
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/dns-custom-nameservers_identifier'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/dns-custom-nameservers_CustomNSInput'
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/dns-custom-nameservers_acns_response_single'
                - $ref: '#/components/schemas/dns-custom-nameservers_api-response-common-failure'
          description: Add Account Custom Nameserver response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dns-custom-nameservers_acns_response_single'
          description: Add Account Custom Nameserver response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Add Account Custom Nameserver
      tags:
      - Account-Level Custom Nameservers
      x-cfPermissionsRequired:
        enum:
        - '#organization:edit'
      x-cfPlanAvailability:
        business: true
        enterprise: true
        free: false
        pro: false
  /accounts/{account_id}/custom_ns/{custom_ns_id}:
    delete:
      operationId: account-level-custom-nameservers-delete-account-custom-nameserver
      parameters:
      - in: path
        name: custom_ns_id
        required: true
        schema:
          $ref: '#/components/schemas/dns-custom-nameservers_ns_name'
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/dns-custom-nameservers_identifier'
      requestBody:
        content:
          application/json: {}
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/dns-custom-nameservers_empty_response'
                - $ref: '#/components/schemas/dns-custom-nameservers_api-response-common-failure'
          description: Delete Account Custom Nameserver response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dns-custom-nameservers_empty_response'
          description: Delete Account Custom Nameserver response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Delete Account Custom Nameserver
      tags:
      - Account-Level Custom Nameservers
      x-cfPermissionsRequired:
        enum:
        - '#organization:edit'
      x-cfPlanAvailability:
        business: true
        enterprise: true
        free: false
        pro: false
  /accounts/{account_id}/custom_ns/availability:
    get:
      operationId: account-level-custom-nameservers-get-eligible-zones-for-account-custom-nameservers
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/dns-custom-nameservers_identifier'
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/dns-custom-nameservers_availability_response'
                - $ref: '#/components/schemas/dns-custom-nameservers_api-response-common-failure'
          description: Get Eligible Zones for Account Custom Nameservers response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dns-custom-nameservers_availability_response'
          description: Get Eligible Zones for Account Custom Nameservers response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Get Eligible Zones for Account Custom Nameservers
      tags:
      - Account-Level Custom Nameservers
      x-cfPermissionsRequired:
        enum:
        - '#organization:read'
      x-cfPlanAvailability:
        business: true
        enterprise: true
        free: false
        pro: false
components:
  schemas:
    dns-custom-nameservers_result_info:
      properties:
        count:
          description: Total number of results for the requested service
          example: 1
          type: number
        page:
          description: Current page within paginated list of results
          example: 1
          type: number
        per_page:
          description: Number of results per page of results
          example: 20
          type: number
        total_count:
          description: Total results available without any search parameters
          example: 2000
          type: number
      type: object
    dns-custom-nameservers_messages:
      example: []
      items:
        properties:
          code:
            minimum: 1000
            type: integer
          message:
            type: string
        required:
        - code
        - message
        type: object
        uniqueItems: true
      type: array
    dns-custom-nameservers_api-response-collection:
      allOf:
      - $ref: '#/components/schemas/dns-custom-nameservers_api-response-common'
      - properties:
          result_info:
            $ref: '#/components/schemas/dns-custom-nameservers_result_info'
      type: object
    dns-custom-nameservers_acns_response_collection:
      allOf:
      - $ref: '#/components/schemas/dns-custom-nameservers_api-response-collection'
      - properties:
          result:
            items:
              $ref: '#/components/schemas/dns-custom-nameservers_CustomNS'
            type: array
        type: object
    dns-custom-nameservers_empty_response:
      allOf:
      - $ref: '#/components/schemas/dns-custom-nameservers_api-response-collection'
      - properties:
          result:
            items:
              description: Unused
              type: string
            maxItems: 0
            type: array
        type: object
    dns-custom-nameservers_acns_response_single:
      allOf:
      - $ref: '#/components/schemas/dns-custom-nameservers_api-response-single'
      - properties:
          result:
            $ref: '#/components/schemas/dns-custom-nameservers_CustomNS'
        type: object
    dns-custom-nameservers_ns_name:
      description: The FQDN of the name server.
      example: ns1.example.com
      format: hostname
      type: string
    dns-custom-nameservers_api-response-common:
      properties:
        errors:
          $ref: '#/components/schemas/dns-custom-nameservers_messages'
        messages:
          $ref: '#/components/schemas/dns-custom-nameservers_messages'
        success:
          description: Whether the API call was successful
          enum:
          - true
          example: true
          type: boolean
      required:
      - success
      - errors
      - messages
      type: object
    dns-custom-nameservers_CustomNSInput:
      properties:
        ns_name:
          $ref: '#/components/schemas/dns-custom-nameservers_ns_name'
        ns_set:
          $ref: '#/components/schemas/dns-custom-nameservers_ns_set'
      required:
      - ns_name
      title: Custom NS Input
    dns-custom-nameservers_identifier:
      description: Account identifier tag.
      example: 372e67954025e0ba6aaa6d586b9e0b59
      maxLength: 32
      readOnly: true
      type: string
    dns-custom-nameservers_api-response-single:
      allOf:
      - $ref: '#/components/schemas/dns-custom-nameservers_api-response-common'
      type: object
    dns-custom-nameservers_schemas-identifier:
      description: Identifier
      example: 023e105f4ecef8ad9ca31a8372d0c353
      maxLength: 32
      type: string
    dns-custom-nameservers_ns_set:
      default: 1
      description: The number of the set that this name server belongs to.
      example: 1
      maximum: 5
      minimum: 1
      type: number
    dns-custom-nameservers_api-response-common-failure:
      properties:
        errors:
          allOf:
          - $ref: '#/components/schemas/dns-custom-nameservers_messages'
          example:
          - code: 7003
            message: No route for the URI
          minLength: 1
        messages:
          allOf:
          - $ref: '#/components/schemas/dns-custom-nameservers_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-custom-nameservers_CustomNS:
      description: A single account custom nameserver.
      properties:
        dns_records:
          description: A and AAAA records associated with the nameserver.
          items:
            properties:
              type:
                description: DNS record type.
                enum:
                - A
                - AAAA
                example: A
                type: string
              value:
                description: DNS record contents (an IPv4 or IPv6 address).
                example: 1.1.1.1
                type: string
          type: array
        ns_name:
          $ref: '#/components/schemas/dns-custom-nameservers_ns_name'
        ns_set:
          $ref: '#/components/schemas/dns-custom-nameservers_ns_set'
        status:
          deprecated: true
          description: Verification status of the nameserver.
          enum:
          - moved
          - pending
          - verified
          example: verified
          type: string
        zone_tag:
          $ref: '#/components/schemas/dns-custom-nameservers_schemas-identifier'
      required:
      - dns_records
      - ns_name
      - status
      - zone_tag
      title: Custom NS
      type: object
    dns-custom-nameservers_availability_response:
      allOf:
      - $ref: '#/components/schemas/dns-custom-nameservers_api-response-collection'
      - properties:
          result:
            items:
              description: Name of zone based on which account custom nameservers can be created. For example, if example.com is returned, then ns1.example.com can be used as an account custom nameserver.
              example: example.com
              format: hostname
              readOnly: true
              type: string
            type: array
        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