The Log Delivery Service API

Akamai’s infrastructure is constantly gathering the log entries from the thousands of edge servers around the world. Log Delivery Service creates a copy of these logs, separates your logs from other customer logs, and then delivers your logs based on a schedule you define.

The Log Delivery Service API allows you to view, update, and delete scheduled log deliveries. Additionally, the API allows you to adjust details of your log delivery setup, or configuration, including schedule, log format, delivery mechanism, aggregation method, data completion thresholds, residual data delivery, and requests for redelivery. This API provides you with a programmatic interface to the same functionality available in Luna Control Center.

NOTE: This new version of the API increments directly to v3, bypassing an internal-only v2. See version 1 for information on the previous legacy API.

Who Should Use This API

This API is intended for those who receive logs from Akamai and are responsible for processing them.

Getting Started

Before using the API for the first time:

  • Review the OPEN API Introduction on tools that Akamai provides.

  • Review OPEN API Provisioning to create your OPEN API access credentials and authorizations. As detailed in API Identity Model, you then access the API using custom hostnames that looks like this: https://akzz-XXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXX.luna.akamaiapis.net.

  • To use the Log Delivery Service API, you need to be a customer of Log Delivery Service to configure the service and begin receiving logs from that point forward. Logs are not available retroactively, and logs for those who do not subscribe to Log Delivery Service are not retrievable.

  • The API limits the scope of the returned data by the user’s account, its permissions, and access the business objects (for example, a CP code or a DNS zone) that are associated with the user and account.

  • LDS data is generally retained for the last eight days.

  • If you need help, provide feedback at OPEN Developer Community or contact your Akamai representative for support.

Hypermedia

Throughout this API, Hypermedia links members allow automated client applications to navigate to relevant data and execute related operations.

This example from within a description of a log configuration object provides a direct link to a API call necessary to access the object, in this case log-configurations-for-log-source. The href elements included indicate the availability of log configuration data. For example, this references the API operation that lists the existing log delivery configurations of log source type cpcode-products with the specified id. Note that where the necessary operation is not called out specifically after the href element, it is identified in the title and link relation rel.

{
    "links":[
        {
            "title":"Get log delivery configurations for the same log source",
            "rel":"get-log-configurations-for-log-source",
            "href":"/lds-api/v3/cpcode-products/{id}/log-configurations"
        }
    ]
}

Last modified: 4/3/2017