Firewall Rules Notification API Data

This section provides details for each type of data object the API exchanges.

The data schema tables below list membership requirements as follows:

Member is required to be present, regardless of whether the value is empty or null.
Member is optional, and may be omitted in some cases.

Schemas

Subscription

Displays subscriptions for a service.

Sample GET:

{
    "subscriptions": [
        {
            "serviceName": "Test IPs",
            "signupDate": "2017-03-28",
            "serviceId": 13,
            "email": "mp@mail.com"
        },
        {
            "serviceName": "CCUAPI",
            "signupDate": "2017-10-11",
            "serviceId": 15,
            "email": "abcd@akamai.com"
        }
    ]
}

Subscription Members  

Member Type Required Description
email String One or more emails belonging to people subscribing to a service. These email addresses receive the notifications for CIDR block updates.
serviceId Integer A unique identifier for a service.
serviceName String The name of a service. This is often the same as the product you purchased.
signupDate String The date a subscriber signed up for notifications. The date is in ISO format.

Service

Specifies service information.

Sample GET:

{
    "serviceName": "TestIP",
    "serviceId": 3,
    "description": "Test IPs"
}

Service Members  

Member Type Required Description
description String A description of the service.
serviceId Integer A unique identifier for a service.
serviceName String The name of a service. This is often the same as the product you purchased.

CidrBlock

Describes CIDR block and the services they belong to.

Sample GET:

[
    {
        "creationDate": "2017-02-21",
        "minIp": "66.171.230.134",
        "effectiveDate": "2017-02-21",
        "maxIp": "66.171.230.134",
        "serviceId": 9,
        "serviceName": "PERF_ANALYTICS",
        "lastAction": "add",
        "changeDate": "2017-02-21",
        "cidr": "66.171.230.134",
        "cidrId": 13742,
        "port": "80,443",
        "cidrMask": "/32"
    }
]

CidrBlock Members  

Member Type Required Description
changeDate String The ISO 8601 date when the CIDR block was last updated.
cidr String A list of IP addresses belonging to Akamai edge servers for a particular service.
cidrId Integer A unique identifier for a CIDR block.
cidrMask Enumeration Indicates the range (start and end IP) of the CIDR block. /32 and /64 denote whether the IP addresses in the CIDR block are IPv4 or IPv6, respectively.
creationDate String The ISO 8601 date the CIDR block was created.
effectiveDate String The ISO 8601 date the IP addresses start passing traffic. Make sure your firewall rules are updated to accept traffic before this date. This date is typically two weeks after the CIDR block’s creation date.
lastAction Enumeration The last Action, or change, made to the CIDR block. Possible enum values: add, delete, update.
maxIp String The maximum IP is the top of the range for the CIDR block.
minIp String The minimum IP is the base of the range for the CIDR block.
port String The set of comma-delimited ports through which your server receives traffic from Akamai servers.
serviceId Integer A unique identifier for a service.
serviceName String The name of a service. This is often the same as the product you purchased.

Last modified: 6/1/2017