Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

APIs.io Engineering Platform IP Address Management Address Maps API

The IP Address Management Address Maps API from APIs.io Engineering Platform — 5 operation(s) for ip address management address maps.

This API exposes 11 operations across 5 paths, and defines 26 schemas. It is described by OpenAPI 3.0.0, at version 2015-07-09.

Requests are made against 4 base URLs: http://apigateway.{region}.amazonaws.com, https://apigateway.{region}.amazonaws.com, http://apigateway.{region}.amazonaws.com.cn, https://apigateway.{region}.amazonaws.com.cn.

11 operations 5 paths 26 schemas 4 DELETE2 GET1 PATCH1 POST3 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
2015-07-09
Base URL
https://{bucketname}.s3.amazonaws.com
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

APIs.io Engineering Platform IP Address Management Address Maps API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (hmac). By default, every request must be authenticated.

  • hmac — Amazon Signature authorization v4

Paths & Operations 11

Across 5 paths, the API surfaces 11 operations — 4 DELETE, 2 GET, 1 PATCH, 1 POST, 3 PUT. Each is listed below with its method, path, parameters, and response codes.

IP Address Management Address Maps 11
GET
/accounts/{account_id}/addressing/address_maps
APIs.io Engineering Platform List Address Maps
ip-address-management-address-maps-list-address-maps 1 param → 4XX200
POST
/accounts/{account_id}/addressing/address_maps
APIs.io Engineering Platform Create Address Map
ip-address-management-address-maps-create-address-map 1 param body → 4XX200
DELETE
/accounts/{account_id}/addressing/address_maps/{address_map_id}
APIs.io Engineering Platform Delete Address Map
ip-address-management-address-maps-delete-address-map 2 params body → 4XX200
GET
/accounts/{account_id}/addressing/address_maps/{address_map_id}
APIs.io Engineering Platform Address Map Details
ip-address-management-address-maps-address-map-details 2 params → 4XX200
PATCH
/accounts/{account_id}/addressing/address_maps/{address_map_id}
APIs.io Engineering Platform Update Address Map
ip-address-management-address-maps-update-address-map 2 params body → 4XX200
DELETE
/accounts/{account_id}/addressing/address_maps/{address_map_id}/accounts/{account_id}
APIs.io Engineering Platform Remove an account membership from an Address Map
ip-address-management-address-maps-remove-an-account-membership-from-an-address-map 2 params body → 4XX200
PUT
/accounts/{account_id}/addressing/address_maps/{address_map_id}/accounts/{account_id}
APIs.io Engineering Platform Add an account membership to an Address Map
ip-address-management-address-maps-add-an-account-membership-to-an-address-map 2 params body → 4XX200
DELETE
/accounts/{account_id}/addressing/address_maps/{address_map_id}/ips/{ip_address}
APIs.io Engineering Platform Remove an IP from an Address Map
ip-address-management-address-maps-remove-an-ip-from-an-address-map 3 params body → 4XX200
PUT
/accounts/{account_id}/addressing/address_maps/{address_map_id}/ips/{ip_address}
APIs.io Engineering Platform Add an IP to an Address Map
ip-address-management-address-maps-add-an-ip-to-an-address-map 3 params body → 4XX200
DELETE
/accounts/{account_id}/addressing/address_maps/{address_map_id}/zones/{zone_id}
APIs.io Engineering Platform Remove a zone membership from an Address Map
ip-address-management-address-maps-remove-a-zone-membership-from-an-address-map 3 params body → 4XX200
PUT
/accounts/{account_id}/addressing/address_maps/{address_map_id}/zones/{zone_id}
APIs.io Engineering Platform Add a zone membership to an Address Map
ip-address-management-address-maps-add-a-zone-membership-to-an-address-map 3 params body → 4XX200

Schemas 26

The contract defines 26 schemas that model the data the API accepts and returns. The most detailed are addressing_address-maps (8 properties), addressing_api-response-common-failure (4 properties), addressing_result_info (4 properties), addressing_address-maps-membership (4 properties). Each schema is shown below with its type and property counts.

addressing_memberships
array
Zones and Accounts which will be assigned IPs on this Address Map. A zone membership will take priority over an account membership.
addressing_messages
array
addressing_api-response-collection
object
addressing_kind
string
The type of the membership.
addressing_address-maps
object
8 properties
addressing_default_sni
string
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 h…
addressing_enabled
boolean
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.
addressing_result_info
object
4 properties
addressing_address-maps-ip
object
2 properties
addressing_api-response-common-failure
object
4 properties 4 required
addressing_address-maps-membership
object
4 properties
addressing_timestamp
string
addressing_identifier
string
Identifier
addressing_schemas-description
string
An optional description field which may be used to describe the types of IPs or zones on the map.
addressing_schemas-can_delete
boolean
Controls whether the membership can be deleted via the API or not.
addressing_components-schemas-response_collection
addressing_can_delete
boolean
If set to false, then the Address Map cannot be deleted via API. This is true for Cloudflare-managed maps.
addressing_ip_address
string
An IPv4 or IPv6 address.
addressing_api-response-common
object
3 properties 3 required
addressing_components-schemas-single_response
addressing_schemas-ips
array
The set of IPs on the Address Map.
addressing_api-response-single
object
addressing_full_response
addressing_schemas-identifier
string
The identifier for the membership (eg. a zone or account tag).
addressing_can_modify_ips
boolean
If set to false, then the IPs on the Address Map cannot be modified via the API. This is true for Cloudflare-managed maps.
addressing_ip
string
An IPv4 or IPv6 address.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

engineering-platform-ip-address-management-address-maps-api-openapi.yml Raw ↑