APIs.io Engineering Platform IP Address Management Address Maps API

openapi: 3.0.0
info:
  version: "1.0.0"
  x-release: v4
  title: APIs.io Engineering Platform Amazon API Gateway 2014 11 13 IP Address Management Address Maps 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: IP Address Management Address Maps
paths:
  /accounts/{account_id}/addressing/address_maps:
    get:
      description: List all address maps owned by the account.
      operationId: ip-address-management-address-maps-list-address-maps
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/addressing_identifier'
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/addressing_components-schemas-response_collection'
                - $ref: '#/components/schemas/addressing_api-response-common-failure'
          description: List Address Maps response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/addressing_components-schemas-response_collection'
          description: List Address Maps response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform List Address Maps
      tags:
      - IP Address Management Address Maps
      x-api-token-group:
      - Address Maps Write
      - Address Maps Read
    post:
      description: Create a new address map under the account.
      operationId: ip-address-management-address-maps-create-address-map
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/addressing_identifier'
      requestBody:
        content:
          application/json:
            schema:
              properties:
                description:
                  $ref: '#/components/schemas/addressing_schemas-description'
                enabled:
                  $ref: '#/components/schemas/addressing_enabled'
                ips:
                  items:
                    $ref: '#/components/schemas/addressing_ip_address'
                  type: array
                memberships:
                  $ref: '#/components/schemas/addressing_memberships'
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/addressing_full_response'
                - $ref: '#/components/schemas/addressing_api-response-common-failure'
          description: Create Address Map response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/addressing_full_response'
          description: Create Address Map response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Create Address Map
      tags:
      - IP Address Management Address Maps
      x-api-token-group:
      - Address Maps Write
  /accounts/{account_id}/addressing/address_maps/{address_map_id}:
    delete:
      description: Delete a particular address map owned by the account. An Address Map must be disabled before it can be deleted.
      operationId: ip-address-management-address-maps-delete-address-map
      parameters:
      - in: path
        name: address_map_id
        required: true
        schema:
          $ref: '#/components/schemas/addressing_identifier'
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/addressing_identifier'
      requestBody:
        content:
          application/json: {}
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/addressing_api-response-collection'
                - $ref: '#/components/schemas/addressing_api-response-common-failure'
          description: Delete Address Map response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/addressing_api-response-collection'
          description: Delete Address Map response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Delete Address Map
      tags:
      - IP Address Management Address Maps
      x-api-token-group:
      - Address Maps Write
    get:
      description: Show a particular address map owned by the account.
      operationId: ip-address-management-address-maps-address-map-details
      parameters:
      - in: path
        name: address_map_id
        required: true
        schema:
          $ref: '#/components/schemas/addressing_identifier'
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/addressing_identifier'
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/addressing_full_response'
                - $ref: '#/components/schemas/addressing_api-response-common-failure'
          description: Address Map Details response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/addressing_full_response'
          description: Address Map Details response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Address Map Details
      tags:
      - IP Address Management Address Maps
      x-api-token-group:
      - Address Maps Write
      - Address Maps Read
    patch:
      description: Modify properties of an address map owned by the account.
      operationId: ip-address-management-address-maps-update-address-map
      parameters:
      - in: path
        name: address_map_id
        required: true
        schema:
          $ref: '#/components/schemas/addressing_identifier'
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/addressing_identifier'
      requestBody:
        content:
          application/json:
            schema:
              properties:
                default_sni:
                  $ref: '#/components/schemas/addressing_default_sni'
                description:
                  $ref: '#/components/schemas/addressing_schemas-description'
                enabled:
                  $ref: '#/components/schemas/addressing_enabled'
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/addressing_components-schemas-single_response'
                - $ref: '#/components/schemas/addressing_api-response-common-failure'
          description: Update Address Map response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/addressing_components-schemas-single_response'
          description: Update Address Map response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Update Address Map
      tags:
      - IP Address Management Address Maps
      x-api-token-group:
      - Address Maps Write
  /accounts/{account_id}/addressing/address_maps/{address_map_id}/accounts/{account_id}:
    delete:
      description: Remove an account as a member of a particular address map.
      operationId: ip-address-management-address-maps-remove-an-account-membership-from-an-address-map
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/addressing_identifier'
      - in: path
        name: address_map_id
        required: true
        schema:
          $ref: '#/components/schemas/addressing_identifier'
      requestBody:
        content:
          application/json: {}
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/addressing_api-response-collection'
                - $ref: '#/components/schemas/addressing_api-response-common-failure'
          description: Remove an account membership from an Address Map response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/addressing_api-response-collection'
          description: Remove an account membership from an Address Map response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Remove an account membership from an Address Map
      tags:
      - IP Address Management Address Maps
    put:
      description: Add an account as a member of a particular address map.
      operationId: ip-address-management-address-maps-add-an-account-membership-to-an-address-map
      parameters:
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/addressing_identifier'
      - in: path
        name: address_map_id
        required: true
        schema:
          $ref: '#/components/schemas/addressing_identifier'
      requestBody:
        content:
          application/json: {}
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/addressing_api-response-collection'
                - $ref: '#/components/schemas/addressing_api-response-common-failure'
          description: Add an account membership to an Address Map response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/addressing_api-response-collection'
          description: Add an account membership to an Address Map response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Add an account membership to an Address Map
      tags:
      - IP Address Management Address Maps
  /accounts/{account_id}/addressing/address_maps/{address_map_id}/ips/{ip_address}:
    delete:
      description: Remove an IP from a particular address map.
      operationId: ip-address-management-address-maps-remove-an-ip-from-an-address-map
      parameters:
      - in: path
        name: ip_address
        required: true
        schema:
          $ref: '#/components/schemas/addressing_ip_address'
      - in: path
        name: address_map_id
        required: true
        schema:
          $ref: '#/components/schemas/addressing_identifier'
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/addressing_identifier'
      requestBody:
        content:
          application/json: {}
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/addressing_api-response-collection'
                - $ref: '#/components/schemas/addressing_api-response-common-failure'
          description: Remove an IP from an Address Map response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/addressing_api-response-collection'
          description: Remove an IP from an Address Map response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Remove an IP from an Address Map
      tags:
      - IP Address Management Address Maps
      x-api-token-group:
      - Address Maps Write
    put:
      description: Add an IP from a prefix owned by the account to a particular address map.
      operationId: ip-address-management-address-maps-add-an-ip-to-an-address-map
      parameters:
      - in: path
        name: ip_address
        required: true
        schema:
          $ref: '#/components/schemas/addressing_ip_address'
      - in: path
        name: address_map_id
        required: true
        schema:
          $ref: '#/components/schemas/addressing_identifier'
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/addressing_identifier'
      requestBody:
        content:
          application/json: {}
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/addressing_api-response-collection'
                - $ref: '#/components/schemas/addressing_api-response-common-failure'
          description: Add an IP to an Address Map response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/addressing_api-response-collection'
          description: Add an IP to an Address Map response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Add an IP to an Address Map
      tags:
      - IP Address Management Address Maps
      x-api-token-group:
      - Address Maps Write
  /accounts/{account_id}/addressing/address_maps/{address_map_id}/zones/{zone_id}:
    delete:
      description: Remove a zone as a member of a particular address map.
      operationId: ip-address-management-address-maps-remove-a-zone-membership-from-an-address-map
      parameters:
      - in: path
        name: zone_id
        required: true
        schema:
          $ref: '#/components/schemas/addressing_identifier'
      - in: path
        name: address_map_id
        required: true
        schema:
          $ref: '#/components/schemas/addressing_identifier'
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/addressing_identifier'
      requestBody:
        content:
          application/json: {}
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/addressing_api-response-collection'
                - $ref: '#/components/schemas/addressing_api-response-common-failure'
          description: Remove a zone membership from an Address Map response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/addressing_api-response-collection'
          description: Remove a zone membership from an Address Map response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Remove a zone membership from an Address Map
      tags:
      - IP Address Management Address Maps
    put:
      description: Add a zone as a member of a particular address map.
      operationId: ip-address-management-address-maps-add-a-zone-membership-to-an-address-map
      parameters:
      - in: path
        name: zone_id
        required: true
        schema:
          $ref: '#/components/schemas/addressing_identifier'
      - in: path
        name: address_map_id
        required: true
        schema:
          $ref: '#/components/schemas/addressing_identifier'
      - in: path
        name: account_id
        required: true
        schema:
          $ref: '#/components/schemas/addressing_identifier'
      requestBody:
        content:
          application/json: {}
        required: true
      responses:
        4XX:
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/addressing_api-response-collection'
                - $ref: '#/components/schemas/addressing_api-response-common-failure'
          description: Add a zone membership to an Address Map response failure
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/addressing_api-response-collection'
          description: Add a zone membership to an Address Map response
      security:
      - api_email: []
        api_key: []
      summary: APIs.io Engineering Platform Add a zone membership to an Address Map
      tags:
      - IP Address Management Address Maps
components:
  schemas:
    addressing_memberships:
      description: Zones and Accounts which will be assigned IPs on this Address Map. A zone membership will take priority over an account membership.
      items:
        $ref: '#/components/schemas/addressing_address-maps-membership'
      type: array
    addressing_messages:
      example: []
      items:
        properties:
          code:
            minimum: 1000
            type: integer
          message:
            type: string
        required:
        - code
        - message
        type: object
        uniqueItems: true
      type: array
    addressing_api-response-collection:
      allOf:
      - $ref: '#/components/schemas/addressing_api-response-common'
      - properties:
          result_info:
            $ref: '#/components/schemas/addressing_result_info'
      type: object
    addressing_kind:
      description: The type of the membership.
      enum:
      - zone
      - account
      example: zone
      type: string
    addressing_address-maps:
      properties:
        can_delete:
          $ref: '#/components/schemas/addressing_can_delete'
        can_modify_ips:
          $ref: '#/components/schemas/addressing_can_modify_ips'
        created_at:
          $ref: '#/components/schemas/addressing_timestamp'
        default_sni:
          $ref: '#/components/schemas/addressing_default_sni'
        description:
          $ref: '#/components/schemas/addressing_schemas-description'
        enabled:
          $ref: '#/components/schemas/addressing_enabled'
        id:
          $ref: '#/components/schemas/addressing_identifier'
        modified_at:
          $ref: '#/components/schemas/addressing_timestamp'
      type: object
    addressing_default_sni:
      description: If you have legacy TLS clients which do not send the TLS server name indicator, then you can specify one default SNI on the map. If Cloudflare receives a TLS handshake from a client without an SNI, it will respond with the default SNI on those IPs. The default SNI can be any valid zone or subdomain owned by the account.
      example: '*.example.com'
      nullable: true
      type: string
    addressing_enabled:
      default: false
      description: Whether the Address Map is enabled or not. Cloudflare's DNS will not respond with IP addresses on an Address Map until the map is enabled.
      example: true
      nullable: true
      type: boolean
    addressing_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
    addressing_address-maps-ip:
      properties:
        created_at:
          $ref: '#/components/schemas/addressing_timestamp'
        ip:
          $ref: '#/components/schemas/addressing_ip'
      type: object
    addressing_api-response-common-failure:
      properties:
        errors:
          allOf:
          - $ref: '#/components/schemas/addressing_messages'
          example:
          - code: 7003
            message: No route for the URI
          minLength: 1
        messages:
          allOf:
          - $ref: '#/components/schemas/addressing_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
    addressing_address-maps-membership:
      properties:
        can_delete:
          $ref: '#/components/schemas/addressing_schemas-can_delete'
        created_at:
          $ref: '#/components/schemas/addressing_timestamp'
        identifier:
          $ref: '#/components/schemas/addressing_schemas-identifier'
        kind:
          $ref: '#/components/schemas/addressing_kind'
      type: object
    addressing_timestamp:
      example: '2014-01-01T05:20:00.12345Z'
      format: date-time
      type: string
    addressing_identifier:
      description: Identifier
      example: 023e105f4ecef8ad9ca31a8372d0c353
      maxLength: 32
      type: string
    addressing_schemas-description:
      description: An optional description field which may be used to describe the types of IPs or zones on the map.
      example: My Ecommerce zones
      nullable: true
      type: string
    addressing_schemas-can_delete:
      description: Controls whether the membership can be deleted via the API or not.
      example: true
      readOnly: true
      type: boolean
    addressing_components-schemas-response_collection:
      allOf:
      - $ref: '#/components/schemas/addressing_api-response-collection'
      - properties:
          result:
            items:
              $ref: '#/components/schemas/addressing_address-maps'
            type: array
    addressing_can_delete:
      description: If set to false, then the Address Map cannot be deleted via API. This is true for Cloudflare-managed maps.
      example: true
      readOnly: true
      type: boolean
    addressing_ip_address:
      description: An IPv4 or IPv6 address.
      example: 192.0.2.1
      type: string
    addressing_api-response-common:
      properties:
        errors:
          $ref: '#/components/schemas/addressing_messages'
        messages:
          $ref: '#/components/schemas/addressing_messages'
        success:
          description: Whether the API call was successful
          enum:
          - true
          example: true
          type: boolean
      required:
      - success
      - errors
      - messages
      type: object
    addressing_components-schemas-single_response:
      allOf:
      - $ref: '#/components/schemas/addressing_api-response-single'
      - properties:
          result:
            $ref: '#/components/schemas/addressing_address-maps'
    addressing_schemas-ips:
      description: The set of IPs on the Address Map.
      items:
        $ref: '#/components/schemas/addressing_address-maps-ip'
      type: array
    addressing_api-response-single:
      allOf:
      - $ref: '#/components/schemas/addressing_api-response-common'
      type: object
    addressing_full_response:
      allOf:
      - $ref: '#/components/schemas/addressing_api-response-single'
      - properties:
          result:
            allOf:
            - $ref: '#/components/schemas/addressing_address-maps'
            - properties:
                ips:
                  $ref: '#/components/schemas/addressing_schemas-ips'
                memberships:
                  $ref: '#/components/schemas/addressing_memberships'
              type: object
        type: object
    addressing_schemas-identifier:
      description: The identifier for the membership (eg. a zone or account tag).
      example: 023e105f4ecef8ad9ca31a8372d0c353
      maxLength: 32
      type: string
    addressing_can_modify_ips:
      description: If set to false, then the IPs on the Address Map cannot be modified via the API. This is true for Cloudflare-managed maps.
      example: true
      readOnly: true
      type: boolean
    addressing_ip:
      description: An IPv4 or IPv6 address.
      example: 192.0.2.1
      type: string
  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