Log Delivery Service API v3

View, update, and delete scheduled log deliveries, and adjust details of your log delivery setup.

Learn more:

Overview

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 Akamai Control Center.

Who should use this API

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

Get started

Before using the API for the first time:

  • 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.

  • Review Get Started with APIs for details on how to set up client tokens to access any Akamai API. These tokens appear as custom hostnames that look like this: https://akzz-XXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXX.luna.akamaiapis.net.

  • To enable this API, choose the API service named Log Delivery Service, and set the access level to READ-WRITE.

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

  • If you need help, provide feedback in the Akamai 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"
        }
    ]
}

Resources

The Log Delivery Service API enables you to retrieve logs for your content on the Akamai edge platform. You can view, update, and delete scheduled log deliveries. Additionally, you can adjust details of your log delivery (your log delivery configuration) including the schedule, log format, delivery mechanism, aggregation method, data completion thresholds, residual data delivery, and requests for redelivery.

You should be familiar with the following LDS concepts:

  • Log Sources. Log sources are all the business objects for which log delivery can be set up, called a logSourceType. Currently available log sources are CP code, DNS zones, domains for Traffic Management, and AnswerX objects. Akamai collect logs for the log sources and sends them as defined in the log delivery configurations you configure in this API. Each log source has a type and a unique ID.

  • Configurations. You can create one LDS configuration for each log source. Once you initially configure an Akamai service for log delivery, you can view, edit, and suspend and reactivate that log delivery configuration.

  • Aggregation. Log deliveries can be aggregated by arrival time or by calendar day. Aggregating by arrival time sends log data in the order in which it arrives from Akamai’s edge platform. This is the fastest way to get log data, but it is more difficult to process. For example, a delivery that covers a 24-hour period usually contains some data from the previous several days. Aggregating by calendar day sends most of the hits for each GMT calendar day in a single delivery. You can set a completion threshold at which you want logs set, and whether you want residual data sent later.

  • Completion Threshold. The completion threshold determines the percentage of expected logs to process before you receive the log data. Setting a high threshold value ensures that the delivered data is as complete as possible, but might cause deliveries to be delayed to meet the threshold. Setting a lower threshold value ensures more timely deliveries, but more of the data (residual data) might be deferred to a leftover delivery.

  • Residual data. You can choose to receive deliveries containing leftover log lines that were not included in either the bulk delivery or a previous leftover delivery.

  • Delivery Method. You can receive log data via email or FTP.

  • Message Size. Logs are broken into parts before compression, so the estimation of message size is based on the uncompressed file size. Compressed message size options range from 1–50 MB compressed (approximately 6–300 MB uncompressed.)

  • Encoding. LDS offers three encoding options: gzipped and uuencoded, MIME with base–64 encoding, and GPG Encrypted (which requires you to upload a key). Otherwise, the main difference is support by mail clients. Your encoding options depend on whether you are receiving log delivery via email or FTP. Note that AnswerX Managed, AnswerX Cloud, and Enterprise Threat Protector services support only GPG encoding.

  • Contacts. LDS requires that you provide email and phone number contact information for announcements about changes to LDS as well as automated delivery failure notices. It is important that you check this email frequently to diagnose and correct delivery failures, as well as arrange log redeliveries if necessary.

  • Redeliveries. You can request redelivery of a log for a specific configuration and a designated time period for which you want logs sent again. Note that Akamai sends log redeliveries at a lower priority than normal log deliveries, and you may not request a redelivery until the original log delivery is complete. The intervals at which redeliveries are sent depends on whether you choose aggregating by arrival time or calendar day when setting up log deliveries. If you aggregate by arrival time, you can choose the date, start, and end times for the redeliveries, which will be sent at the same frequency as the original delivery configuration. If you aggregate by calendar day, you can choose a date for the redelivery; you can request calendar day redeliveries only for an entire day, so there will be no start and end times option.

You typically follow this workflow to create a new configuration for log delivery.

  1. Run the List Log Sources operation to retrieve all available log sources and associated ID numbers to which you have access.

  2. Retrieve the parameter values necessary to create a log delivery configuration. You need to retain the associated IDs to build a valid request object for the configuration.

    1. Run the List Log Formats Per ID operation to retrieve all available log formats and associated log source IDs for this logSourceType and logSourceId.

    2. Run the List Log Encodings operation to retrieve the id for the desired encoding type.

    3. Run the List Delivery Frequencies operation to retrieve the id for desired delivery frequency.

    4. Run the List Message Sizes operation to retrieve the id for the desired log delivery message size.

    5. Run the List Contacts operation to retrieve id values for the desired contacts.

  3. Run the Create a New Log Configuration operation, with the request object built as defined by the Log Configuration Definitions Schema.

API summary

Download the RAML descriptors for this API.

Operation Method Endpoint
Log Configurations  
Get a Log Configuration GET /lds-api/v3/log-configurations/{logConfigurationId}
Update a Log Configuration PUT /lds-api/v3/log-configurations/{logConfigurationId}
Remove a Log Configuration DELETE /lds-api/v3/log-configurations/{logConfigurationId}
Copy a Log Configuration POST /lds-api/v3/log-configurations/{logConfigurationId}/copy
Suspend a Log Configuration POST /lds-api/v3/log-configurations/{logConfigurationId}/suspend
Resume a Log Configuration POST /lds-api/v3/log-configurations/{logConfigurationId}/resume
Log Configuration Parameters  
List Delivery Frequencies GET /lds-api/v3/log-configuration-parameters/delivery-frequencies
Get a Delivery Frequency GET /lds-api/v3/log-configuration-parameters/delivery-frequencies/{deliveryFrequencyId}
List Log Delivery Thresholds GET /lds-api/v3/log-configuration-parameters/delivery-thresholds
Get a Log Delivery Threshold GET /lds-api/v3/log-configuration-parameters/delivery-thresholds/{deliveryThresholdId}
Get a Log Format GET /lds-api/v3/log-configuration-parameters/log-formats/{logFormatId}
List Log Encodings GET /lds-api/v3/log-configuration-parameters/encodings{?deliveryType,logSourceType}
Get a Log Encoding GET /lds-api/v3/log-configuration-parameters/encodings/{encodingId}
List Message Sizes GET /lds-api/v3/log-configuration-parameters/message-sizes
Get a Message Size GET /lds-api/v3/log-configuration-parameters/message-sizes/{messageSizeId}
List Contacts GET /lds-api/v3/log-configuration-parameters/contacts
Get a Contact GET /lds-api/v3/log-configuration-parameters/contacts/{contactId}
Log Redeliveries  
List Log Redeliveries GET /lds-api/v3/log-redeliveries
Create a New Log Redelivery POST /lds-api/v3/log-redeliveries
Get a Log Redelivery GET /lds-api/v3/log-redeliveries/{redeliveryId}
Log Sources  
List Log Sources GET /lds-api/v3/log-sources
List Log Sources by Type GET /lds-api/v3/log-sources/{logSourceType}
List Log Configurations by Type GET /lds-api/v3/log-sources/{logSourceType}/log-configurations
List Log Formats by Type GET /lds-api/v3/log-sources/{logSourceType}/log-formats
List Log Encodings by Type GET /lds-api/v3/log-sources/{logSourceType}/encodings{?deliveryType}
Get a Log Source GET /lds-api/v3/log-sources/{logSourceType}/{logSourceId}
List Log Configurations Per ID GET /lds-api/v3/log-sources/{logSourceType}/{logSourceId}/log-configurations
Create a New Log Configuration POST /lds-api/v3/log-sources/{logSourceType}/{logSourceId}/log-configurations
List Log Formats Per ID GET /lds-api/v3/log-sources/{logSourceType}/{logSourceId}/log-formats

Get a log configuration

Retrieves a specific log delivery configuration.

GET /lds-api/v3/log-configurations/{logConfigurationId}

Sample: /lds-api/v3/log-configurations/163842

Parameter Type Sample Description
URL parameters
logConfigurationId Number 163842 Unique identifier for each log delivery configuration.

Status 200 application/json

Response Body:

{
    "id": "163842",
    "status": "active",
    "startDate": "2013-01-02",
    "logSource": {
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-sources/cpcode-products/200957-1"
            },
            {
                "rel": "cpcode-products",
                "href": "/lds-api/v3/log-sources/cpcode-products"
            },
            {
                "rel": "log-sources",
                "href": "/lds-api/v3/log-sources"
            }
        ],
        "type": "cpcode-products",
        "id": "200957-1",
        "cpCode": "200957 - MOCK CP CODE DESCR ",
        "products": [
            "HTTP Content Delivery"
        ]
    },
    "aggregationDetails": {
        "type": "byLogArrival",
        "deliveryFrequency": {
            "id": "1",
            "value": "Every 24 hours",
            "links": [
                {
                    "rel": "self",
                    "href": "/lds-api/v3/log-configuration-parameters/delivery-frequencies/1"
                },
                {
                    "rel": "deliveryFrequencies",
                    "href": "/lds-api/v3/log-configuration-parameters/delivery-frequencies"
                }
            ]
        }
    },
    "contactDetails": {
        "mailAddresses": [
            "jjudge@akamai.com"
        ],
        "contact": {
            "id": "1-C30O",
            "value": ". Help-Desk - phone: 617.250.3900",
            "links": [
                {
                    "rel": "self",
                    "href": "/lds-api/v3/log-configuration-parameters/contacts/1-C30O"
                },
                {
                    "rel": "contacts",
                    "href": "/lds-api/v3/log-configuration-parameters/contacts"
                }
            ]
        }
    },
    "deliveryDetails": {
        "type": "ftp",
        "machine": "akainsight.upload.akamai.com",
        "login": "insightlds",
        "directory": "/23567/logs/200957",
        "password": ""
    },
    "encodingDetails": {
        "encoding": {
            "id": "3",
            "value": "GZIP",
            "links": [
                {
                    "rel": "self",
                    "href": "/lds-api/v3/log-configuration-parameters/encodings/3"
                },
                {
                    "rel": "encodings",
                    "href": "/lds-api/v3/log-configuration-parameters/encodings"
                }
            ]
        }
    },
    "logFormatDetails": {
        "logIdentifier": "200957",
        "logFormat": {
            "id": "2",
            "value": "combined",
            "links": [
                {
                    "rel": "self",
                    "href": "/lds-api/v3/log-configuration-parameters/log-formats/2"
                },
                {
                    "rel": "logFormats",
                    "href": "/lds-api/v3/log-configuration-parameters/log-formats"
                }
            ]
        }
    },
    "messageSize": {
        "id": "1",
        "value": "50 MB (approx. 300 MB uncompressed logs)",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configuration-parameters/message-sizes/1"
            },
            {
                "rel": "messageSizes",
                "href": "/lds-api/v3/log-configuration-parameters/message-sizes"
            }
        ]
    },
    "links": [
        {
            "rel": "self",
            "href": "/lds-api/v3/log-configuration/163842"
        },
        {
            "rel": "get-log-configurations-for-log-source",
            "href": "/lds-api/v3/log-sources/cpcode-products/200957-1/log-configurations",
            "title": "Get Log Configurations for the same log source"
        },
        {
            "rel": "get-log-configurations-for-log-source-type",
            "href": "/lds-api/v3/log-sources/cpcode-products/log-configurations",
            "title": "Get Log Configurations for the same log source type"
        },
        {
            "rel": "update-log-configuration",
            "href": "/lds-api/v3/log-configuration/163842",
            "method": "PUT",
            "title": "Update Log Configuration"
        },
        {
            "rel": "delete-log-configuration",
            "href": "/lds-api/v3/log-configuration/163842",
            "method": "DELETE",
            "title": "Delete Log Configuration"
        },
        {
            "rel": "suspend-log-configuration",
            "href": "/lds-api/v3/log-configuration/163842/suspend",
            "method": "POST",
            "title": "Suspend Log Configuration"
        }
    ]
}

  1. Run the List Log Sources operation.

  2. Store the logSourceType and logSourceId from the appropriate object in that listing.

  3. Run the List Log Configurations by Type operation to retrieve a list of log configurations for that log source type.

  4. Store the appropriate logConfigurationId from that listing.

  5. Make a GET request to /lds-api/v3/log-configurations/{logConfigurationId}.

  6. The response object includes the full representation of the configuration with the specified logConfigurationId.

Update a log configuration

Modifies a specific log delivery. You need to specify all the data members in the request, or missing members are removed from the configuration. The response’s Location header reflects where you can access the new configuration.

PUT /lds-api/v3/log-configurations/{logConfigurationId}

Sample: /lds-api/v3/log-configurations/163842

Content-Type: application/json

Request Body:

{
    "startDate": "2012-10-31",
    "contactDetails": {
        "contact": {
            "id": "1-2LPWVP"
        },
        "mailAddresses": [
            "asfasf@fa.pl"
        ]
    },
    "logFormatDetails": {
        "logFormat": {
            "id": "12"
        },
        "logIdentifier": "dfgd"
    },
    "messageSize": {
        "id": "2"
    },
    "aggregationDetails": {
        "type": "byLogArrival",
        "deliveryFrequency": {
            "id": "1"
        }
    },
    "encodingDetails": {
        "encoding": {
            "id": "1"
        }
    },
    "deliveryDetails": {
        "type": "email",
        "emailAddress": "asf@fa.pl"
    }
}
Parameter Type Sample Description
URL parameters
logConfigurationId Number 163842 Unique identifier for each log delivery configuration.

Status 201

Headers:

Location: /lds-api/v3/log-configurations/163842

  1. Run the Get Log Configurations by Type operation.

  2. Store the logConfigurationId from the appropriate object in that listing.

  3. When creating the request object, include all required members for the LogConfiguration object.

  4. Make a PUT request to /lds-api/v3/log-configurations/{logConfigurationId}.

Remove a log configuration

Deletes a specific log delivery configuration.

DELETE /lds-api/v3/log-configurations/{logConfigurationId}

Sample: /lds-api/v3/log-configurations/163842

Parameter Type Sample Description
URL parameters
logConfigurationId Number 163842 Unique identifier for each log delivery configuration.

Status 204

  1. Run the List Log Sources operation.

  2. Store the logSourceType for the appropriate object from that listing.

  3. Make a GET request to /lds-api/v3/log-sources/{logSourceType}/log-configurations to get a list of configurations for that logSourceType and their associated configuration IDs. You need the logConfigurationId to make the DELETE request.

  4. Store the logConfigurationId for the appropriate object in that listing.

  5. Make a DELETE request to /lds-api/v3/log-configurations/{logConfigurationId}.

Copy a log configuration

Copies a specific log delivery configuration to a target log source to produce a new log delivery configuration.

POST /lds-api/v3/log-configurations/{logConfigurationId}/copy

Sample: /lds-api/v3/log-configurations/163842/copy

Content-Type: application/json

Request Body:

{
    "copyTarget": {
        "logSource": {
            "type": "gtm",
            "id": "1243"
        }
    }
}
Parameter Type Sample Description
URL parameters
logConfigurationId Number 163842 Unique identifier for each log delivery configuration.

Status 201

Headers:

Location: /lds-api/v3/log-configurations/268230

  1. Run the List Log Sources operation.

  2. Store the logSourceType and logSourceId from the appropriate object in that listing. You need to identify the target source in the request object.

  3. Run the Get Log Configurations by Type operation.

  4. Store the logConfigurationId from the appropriate object in that listing.

  5. Make a POST request to /lds-api/v3/log-configurations/{logConfigurationId}/copy.

Suspend a log configuration

Suspends log delivery for a specific configuration. You will not receive logs for this configuration while it is suspended.

POST /lds-api/v3/log-configurations/{logConfigurationId}/suspend

Sample: /lds-api/v3/log-configurations/163842/suspend

Parameter Type Sample Description
URL parameters
logConfigurationId Number 163842 Unique identifier for each log delivery configuration.

Status 204

  1. Run the Get Log Configurations by Type operation.

  2. Store the logConfigurationId from the appropriate object in that listing.

  3. Make a POST request to /lds-api/v3/log-configurations/{logConfigurationId}/suspend.

Resume a log configuration

Resumes log delivery for a specific configuration.

POST /lds-api/v3/log-configurations/{logConfigurationId}/resume

Sample: /lds-api/v3/log-configurations/163842/resume

Parameter Type Sample Description
URL parameters
logConfigurationId Number 163842 Unique identifier for each log delivery configuration.

Status 204

  1. Run the Get Log Configurations by Type operation.

  2. Store the logConfigurationId from the appropriate object in that listing.

  3. Make a POST request to /lds-api/v3/log-configurations/{logConfigurationId}/resume.

List delivery frequencies

Returns all available delivery frequencies, each with an id and descriptive value. You need the id to create or modify a log delivery configuration.

GET /lds-api/v3/log-configuration-parameters/delivery-frequencies

Status 200 application/json

Response Body:

[
    {
        "id": "1",
        "value": "Every 24 hours",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configuration-parameters/delivery-frequencies/1"
            },
            {
                "rel": "deliveryFrequencies",
                "href": "/lds-api/v3/log-configuration-parameters/delivery-frequencies"
            }
        ]
    },
    {
        "id": "2",
        "value": "Every 12 hours",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configuration-parameters/delivery-frequencies/2"
            },
            {
                "rel": "deliveryFrequencies",
                "href": "/lds-api/v3/log-configuration-parameters/delivery-frequencies"
            }
        ]
    }
]

  1. Make a GET request to /lds-api/v3/log-configuration-parameters/delivery-frequencies to retrieve a list of delivery frequency options value and id.

  2. Store the id to use when creating or updating a log delivery configuration.

Get a delivery frequency

Returns a specific delivery frequency.

GET /lds-api/v3/log-configuration-parameters/delivery-frequencies/{deliveryFrequencyId}

Sample: /lds-api/v3/log-configuration-parameters/delivery-frequencies/1

Parameter Type Sample Description
URL parameters
deliveryFrequencyId Integer 1 Unique identifier for a delivery frequency.

Status 200 application/json

Response Body:

{
    "id": "1",
    "value": "Every 24 hours",
    "links": [
        {
            "rel": "self",
            "href": "/lds-api/v3/log-configuration-parameters/delivery-frequencies/1"
        },
        {
            "rel": "deliveryFrequencies",
            "href": "/lds-api/v3/log-configuration-parameters/delivery-frequencies"
        }
    ]
}

  1. Run the List Delivery Frequencies operation.

  2. Store the id from the appropriate delivery frequency in that listing.

  3. Make a GET request to /lds-api/v3/log-configuration-parameters/delivery-frequencies/{deliveryFrequencyId}.

List log delivery thresholds

Returns all available log delivery thresholds, each with an id and descriptive value.

GET /lds-api/v3/log-configuration-parameters/delivery-thresholds

Status 200 application/json

Response Body:

[
    {
        "id": "1",
        "value": "99",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configuration-parameters/delivery-thresholds/1"
            },
            {
                "rel": "deliveryThresholds",
                "href": "/lds-api/v3/log-configuration-parameters/delivery-thresholds"
            }
        ]
    },
    {
        "id": "2",
        "value": "99.5",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configuration-parameters/delivery-thresholds/2"
            },
            {
                "rel": "deliveryThresholds",
                "href": "/lds-api/v3/log-configuration-parameters/delivery-thresholds"
            }
        ]
    }
]

  1. Make a GET request to /lds-api/v3/log-configuration-parameters/delivery-thresholds retrieve a list of delivery threshold options value and id.

  2. Store the delivery threshold id to use when creating or updating a log delivery configuration.

Get a log delivery threshold

Returns a specific log delivery threshold.

GET /lds-api/v3/log-configuration-parameters/delivery-thresholds/{deliveryThresholdId}

Sample: /lds-api/v3/log-configuration-parameters/delivery-thresholds/1

Parameter Type Sample Description
URL parameters
deliveryThresholdId Integer 1 Unique identifier for a delivery threshold.

Status 200 application/json

Response Body:

{
    "id": "1",
    "value": "99",
    "links": [
        {
            "rel": "self",
            "href": "/lds-api/v3/log-configuration-parameters/delivery-thresholds/1"
        },
        {
            "rel": "deliveryThresholds",
            "href": "/lds-api/v3/log-configuration-parameters/delivery-thresholds"
        }
    ]
}

  1. Run the List Log Delivery Thresholds operation.

  2. Store the id from the appropriate delivery threshold in that listing.

  3. Make a GET request to /lds-api/v3/log-configuration-parameters/delivery-thresholds/{deliveryThresholdId}.

Get a log format

Returns a specific log format. You need this id to specify the log format for a log delivery configuration.

GET /lds-api/v3/log-configuration-parameters/log-formats/{logFormatId}

Sample: /lds-api/v3/log-configuration-parameters/log-formats/1

Parameter Type Sample Description
URL parameters
logFormatId Integer 1 Unique identifier for a log format.

Status 200 application/json

Response Body:

{
    "id": "2",
    "value": "combined",
    "links": [
        {
            "rel": "self",
            "href": "/lds-api/v3/log-configuration-parameters/log-formats/2"
        },
        {
            "rel": "logFormats",
            "href": "/lds-api/v3/log-configuration-parameters/log-formats"
        },
        {
            "rel": "logSources",
            "href": "/lds-api/v3/log-sources/cpcode-products/1-17310"
        }
    ]
}

  1. Run the List Log Sources operation.

  2. Store the logSourceType from the appropriate object in that listing.

  3. Make a GET request to /lds-api/v3/log-sources/{logSourceType}/log-formats.

  4. Store the logFormatId from the appropriate object in that listing.

  5. Make a GET request to /lds-api/v3/log-configuration-parameters/log-formats/{logFormatId}.

List log encodings

Returns all available log encoding options. You can restrict the response by specifying optional values for the deliveryType and logSourceType, since available encoding types are based on these characteristics of a log delivery configuration.

GET /lds-api/v3/log-configuration-parameters/encodings{?deliveryType,logSourceType}

Sample: /lds-api/v3/log-configuration-parameters/encodings?deliveryType=email&logSourceType=cpcode-products

Parameter Type Sample Description
Optional query parameters
deliveryType Enumeration email Possible encodings for log configuration are based on chosen type of delivery, either email or ftp.
logSourceType Enumeration cpcode-products Possible encodings for logs configuration are based on type of target log source for which configuration is created, either cpcode-products, gtm, edns, or answerx.

Status 200 application/json

Response Body:

[
    {
        "id": "3",
        "value": "GZIP",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configuration-parameters/encodings/3"
            },
            {
                "rel": "encodings",
                "href": "/lds-api/v3/log-configuration-parameters/encodings"
            }
        ]
    },
    {
        "id": "4",
        "value": "GPG Encrypted",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configuration-parameters/encodings/4"
            },
            {
                "rel": "encodings",
                "href": "/lds-api/v3/log-configuration-parameters/encodings"
            }
        ]
    }
]

  1. You can optionally limit the allowable encodings returned by deliveryType, either email or ftp.

  2. You can optionally limit the allowable encodings returned by logSourceType. Run the List Log Sources by Type operation and store the appropriate logSourceType from that listing.

  3. Make a GET request to /lds-api/v3/log-configuration-parameters/encodings{?deliveryType,logSourceType}.

  4. The response lists the allowable encoding options for the specified deliveryType and logSourceType. Store the encoding id to use when creating and modifying log delivery configurations.

Get a log encoding

Returns a specific log encoding.

GET /lds-api/v3/log-configuration-parameters/encodings/{encodingId}

Sample: /lds-api/v3/log-configuration-parameters/encodings/1

Parameter Type Sample Description
URL parameters
encodingId Integer 1 Unique identifier for an encoding type.

Status 200 application/json

Response Body:

{
    "id": "3",
    "value": "GZIP",
    "links": [
        {
            "rel": "self",
            "href": "/lds-api/v3/log-configuration-parameters/encodings/3"
        },
        {
            "rel": "encodings",
            "href": "/lds-api/v3/log-configuration-parameters/encodings"
        }
    ]
}

  1. Run the List Log Encodings operation.

  2. Store the id from the appropriate encoding in that listing.

  3. Make a GET request to /lds-api/v3/log-configuration-parameters/encodings/{encodingId}.

List message sizes

Returns all available message sizes, each with an id and descriptive value. You need the id to create or modify a log delivery configuration.

GET /lds-api/v3/log-configuration-parameters/message-sizes

Status 200 application/json

Response Body:

[
    {
        "id": "1",
        "value": "50 MB (approx. 300 MB uncompressed logs)",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configuration-parameters/message-sizes/1"
            },
            {
                "rel": "messageSizes",
                "href": "/lds-api/v3/log-configuration-parameters/message-sizes"
            }
        ]
    },
    {
        "id": "2",
        "value": "25 MB (approx. 150 MB uncompressed logs)",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configuration-parameters/message-sizes/2"
            },
            {
                "rel": "messageSizes",
                "href": "/lds-api/v3/log-configuration-parameters/message-sizes"
            }
        ]
    }
]

  1. Make a GET request to /lds-api/v3/log-configuration-parameters/message-sizes.

  2. The response lists the available message sizes with a value and id. Store the message size id to use when creating and modifying log delivery configurations.

Get a message size

Retrieves a specific message size.

GET /lds-api/v3/log-configuration-parameters/message-sizes/{messageSizeId}

Sample: /lds-api/v3/log-configuration-parameters/message-sizes/1

Parameter Type Sample Description
URL parameters
messageSizeId Integer 1 Unique identifier for a message size. You need this message size id to create or modify a log delivery configuration.

Status 200 application/json

Response Body:

{
    "id": "1",
    "value": "50 MB (approx. 300 MB uncompressed logs)",
    "links": [
        {
            "rel": "self",
            "href": "/lds-api/v3/log-configuration-parameters/message-sizes/1"
        },
        {
            "rel": "messageSizes",
            "href": "/lds-api/v3/log-configuration-parameters/message-sizes"
        }
    ]
}

  1. Run the List Message Sizes operation.

  2. Store the appropriate message size id from that listing.

  3. Make a GET request to /lds-api/v3/log-configuration-parameters/message-sizes/{messageSizeId}.

List contacts

Returns all contacts to which you have access.

GET /lds-api/v3/log-configuration-parameters/contacts

Status 200 application/json

Response Body:

{
    "id": "B-C-1JM7ZL1",
    "value": "Bartosz Gula - phone: +48123847337",
    "links": [
        {
            "rel": "self",
            "href": "/lds-api/v3/log-configuration-parameters/contacts/B-C-1JM7ZL1"
        },
        {
            "rel": "contacts",
            "href": "/lds-api/v3/log-configuration-parameters/contacts"
        }
    ]
}

  1. Make a GET request to /lds-api/v3/log-configuration-parameters/contacts.

  2. Store the contactId from the appropriate object in that listing for use in creating or modifying a log delivery configuration.

Get a contact

Returns a specific contact, assuming the identity associated with the API client has access to it.

GET /lds-api/v3/log-configuration-parameters/contacts/{contactId}

Sample: /lds-api/v3/log-configuration-parameters/contacts/1-2LPWVP

Parameter Type Sample Description
URL parameters
contactId String 1-2LPWVP Unique identifier for a specific contact. You need this contact id when you create or modify a log delivery configuration.

Status 200 application/json

Response Body:

[
    {
        "id": "B-C-1JM7ZL1",
        "value": "Bartosz Gula - phone: +48123847337",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configuration-parameters/contacts/B-C-1JM7ZL1"
            },
            {
                "rel": "contacts",
                "href": "/lds-api/v3/log-configuration-parameters/contacts"
            }
        ]
    },
    {
        "id": "1-7SF29",
        "value": "Customer Care - phone: 6172504699",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configuration-parameters/contacts/1-7SF29"
            },
            {
                "rel": "contacts",
                "href": "/lds-api/v3/log-configuration-parameters/contacts"
            }
        ]
    }
]

  1. Run the List Contacts operation.

  2. Store the contactId from the appropriate object in that listing.

  3. Make a GET request to /lds-api/v3/log-configuration-parameters/contacts/{contactId}.

List log redeliveries

Retrieves a list of requests to redeliver logs.

GET /lds-api/v3/log-redeliveries

Status 200 application/json

Response Body:

[
    {
        "logConfiguration": {
            "id": "154519",
            "links": [
                {
                    "rel": "self",
                    "href": "/lds-api/v3/log-configurations/154519"
                }
            ]
        },
        "id": "272480",
        "beginTime": 3,
        "endTime": 6,
        "redeliveryDate": "2016-10-06",
        "status": "new",
        "createdDate": "2016-10-07",
        "modifiedDate": "2016-10-07",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-redeliveries/272480"
            },
            {
                "rel": "get-log-redeliveries",
                "href": "/lds-api/v3/log-redeliveries",
                "title": "Get Log Redeliveries"
            },
            {
                "rel": "create-log-redelivery",
                "href": "/lds-api/v3/log-redeliveries",
                "method": "POST",
                "title": "Create Log Redelivery"
            }
        ]
    },
    {
        "logConfiguration": {
            "id": "154519",
            "links": [
                {
                    "rel": "self",
                    "href": "/lds-api/v3/log-configurations/154519"
                }
            ]
        },
        "id": "272479",
        "beginTime": 2,
        "endTime": 5,
        "redeliveryDate": "2016-10-07",
        "status": "new",
        "createdDate": "2016-10-07",
        "modifiedDate": "2016-10-07",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-redeliveries/272479"
            },
            {
                "rel": "get-log-redeliveries",
                "href": "/lds-api/v3/log-redeliveries",
                "title": "Get Log Redeliveries"
            },
            {
                "rel": "create-log-redelivery",
                "href": "/lds-api/v3/log-redeliveries",
                "method": "POST",
                "title": "Create Log Redelivery"
            }
        ]
    },
    {
        "logConfiguration": {
            "id": "154519",
            "links": [
                {
                    "rel": "self",
                    "href": "/lds-api/v3/log-configurations/154519"
                }
            ]
        },
        "id": "272477",
        "beginTime": 2,
        "endTime": 5,
        "redeliveryDate": "2016-10-05",
        "status": "new",
        "createdDate": "2016-10-07",
        "modifiedDate": "2016-10-07",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-redeliveries/272477"
            },
            {
                "rel": "get-log-redeliveries",
                "href": "/lds-api/v3/log-redeliveries",
                "title": "Get Log Redeliveries"
            },
            {
                "rel": "create-log-redelivery",
                "href": "/lds-api/v3/log-redeliveries",
                "method": "POST",
                "title": "Create Log Redelivery"
            }
        ]
    },
    {
        "logConfiguration": {
            "id": "154519",
            "links": [
                {
                    "rel": "self",
                    "href": "/lds-api/v3/log-configurations/154519"
                }
            ]
        },
        "id": "272478",
        "beginTime": 2,
        "endTime": 5,
        "redeliveryDate": "2016-10-06",
        "status": "new",
        "createdDate": "2016-10-07",
        "modifiedDate": "2016-10-07",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-redeliveries/272478"
            },
            {
                "rel": "get-log-redeliveries",
                "href": "/lds-api/v3/log-redeliveries",
                "title": "Get Log Redeliveries"
            },
            {
                "rel": "create-log-redelivery",
                "href": "/lds-api/v3/log-redeliveries",
                "method": "POST",
                "title": "Create Log Redelivery"
            }
        ]
    }
]

  1. Make a GET request to /lds-api/v3/log-redeliveries/.

  2. The response object returns a list of all log redelivery requests with their associated IDs.

Create a new log redelivery

Creates a new request to resend a log.

POST /lds-api/v3/log-redeliveries

Content-Type: application/json

Request Body:

{
    "logConfiguration": {
        "id": "154519"
    },
    "id": "272480",
    "beginTime": 3,
    "endTime": 6,
    "redeliveryDate": "2016-10-06"
}

Status 201

Headers:

Location: /lds-api/v3/log-redelivery-request/268231

  1. Run the Get Log Configurations by Type operation.

  2. Store the logConfigurationId from the appropriate object in that listing. This is the log delivery configuration for which you want to request that the logs be redelivered.

  3. When creating the request object, you need to specify the logConfiguration, beginTime,endTime, and redeliveryDate members. See the Redelivery object type for details.

  4. Make a POST request to /lds-api/v3/log-redeliveries/.

Get a log redelivery

Retrieves a specific log redelivery request.

GET /lds-api/v3/log-redeliveries/{redeliveryId}

Sample: /lds-api/v3/log-redeliveries/13526

Parameter Type Sample Description
URL parameters
redeliveryId Integer 13526 Unique identifier for the request to resend a log.

Status 200 application/json

Response Body:

{
    "logConfiguration": {
        "id": "154519",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configurations/154519"
            }
        ]
    },
    "id": "272480",
    "beginTime": 3,
    "endTime": 6,
    "redeliveryDate": "2016-10-08",
    "status": "new",
    "createdDate": "2016-10-05",
    "modifiedDate": "2016-10-07",
    "links": [
        {
            "rel": "self",
            "href": "/lds-api/v3/log-redeliveries/272480"
        },
        {
            "rel": "get-log-redeliveries",
            "href": "/lds-api/v3/log-redeliveries",
            "title": "Get Log Redeliveries"
        },
        {
            "rel": "create-log-redelivery",
            "href": "/lds-api/v3/log-redeliveries",
            "method": "POST",
            "title": "Create Log Redelivery"
        }
    ]
}

  1. Run the List Log Redeliveries operation.

  2. Store the redeliveryId from the appropriate object in that listing.

  3. Make a GET request to /lds-api/v3/log-redeliveries/{redeliveryId}.

List log sources

Returns all log sources (logSourceType) and log source ID (logSourceId) to which the user has access. You need the logSourceType and logSourceId to create a log delivery configuration.

GET /lds-api/v3/log-sources

Status 200 application/json

Response Body:

[
    {
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-sources/cpcode-products/23456-4"
            },
            {
                "rel": "cpcode-products",
                "href": "/lds-api/v3/log-sources/cpcode-products"
            },
            {
                "rel": "log-sources",
                "href": "/lds-api/v3/log-sources"
            },
            {
                "rel": "log-configurations",
                "href": "/lds-api/v3/log-sources/cpcode-products/23456-4/log-configurations",
                "method": "POST",
                "title": "Create log configuration for this log source."
            }
        ],
        "type": "cpcode-products",
        "id": "23456-4",
        "cpCode": "23456 - MOCK CP CODE DESCR ",
        "products": [
            "Quicktime Streaming"
        ]
    },
    {
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-sources/gtm/142981"
            },
            {
                "rel": "gtm",
                "href": "/lds-api/v3/log-sources/gtm"
            },
            {
                "rel": "log-sources",
                "href": "/lds-api/v3/log-sources"
            },
            {
                "rel": "log-configurations",
                "href": "/lds-api/v3/log-sources/gtm/142981/log-configurations",
                "method": "POST",
                "title": "Create log configuration for this log source."
            }
        ],
        "type": "gtm",
        "id": "142981",
        "propertyName": "origin-newcolumbus-qa.abgvoice.com.akadns.net"
    }
]

  1. Make a GET request to /lds-api/v3/log-sources/ to retrieve all available log sources to which you have access.

  2. Store the logSourceType and logSourceId to use when creating or modifying a log delivery configuration.

List log sources by type

Returns all log sources of the specified logSourceType.

GET /lds-api/v3/log-sources/{logSourceType}

Sample: /lds-api/v3/log-sources/cpcode-products

Parameter Type Sample Description
URL parameters
logSourceType Enumeration cpcode-products Type of log source for which you can create a log delivery configuration, either cpcode-products, gtm-properties, edns-zones, or answerx-objects. For example, if you have Akamai Traffic Management and want to configure log delivery for it, retrieve the ID of your Traffic Management property by calling /lds-api/v3/log-sources/gtm-properties. Use the logSourceId to create a log delivery configuration.

Status 200 application/json

Response Body:

[
    {
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-sources/cpcode-products/23456-4"
            },
            {
                "rel": "cpcode-products",
                "href": "/lds-api/v3/log-sources/cpcode-products"
            },
            {
                "rel": "log-sources",
                "href": "/lds-api/v3/log-sources"
            },
            {
                "rel": "log-configurations",
                "href": "/lds-api/v3/log-sources/cpcode-products/23456-4/log-configurations",
                "method": "POST",
                "title": "Create log configuration for this log source."
            }
        ],
        "type": "cpcode-products",
        "id": "23456-4",
        "cpCode": "23456 - MOCK CP CODE DESCR ",
        "products": [
            "Quicktime Streaming"
        ]
    },
    {
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-sources/gtm/142981"
            },
            {
                "rel": "gtm",
                "href": "/lds-api/v3/log-sources/gtm"
            },
            {
                "rel": "log-sources",
                "href": "/lds-api/v3/log-sources"
            },
            {
                "rel": "log-configurations",
                "href": "/lds-api/v3/log-sources/gtm/142981/log-configurations",
                "method": "POST",
                "title": "Create log configuration for this log source."
            }
        ],
        "type": "gtm",
        "id": "142981",
        "propertyName": "origin-newcolumbus-qa.abgvoice.com.akadns.net"
    }
]

  1. Make a GET request to /lds-api/v3/log-sources/ to retrieve all available log sources to which you have access.

  2. Determine the logSourceType from the response.

  3. Make a GET request to /lds-api/v3/log-sources/{logSourceType}.

  4. Use the logSourceId for a given logSourceType to create a log delivery configuration.

List log configurations by type

Returns all log delivery configurations of a given logSourceType. You would need the logConfigurationId to modify a log delivery configuration.

GET /lds-api/v3/log-sources/{logSourceType}/log-configurations

Sample: /lds-api/v3/log-sources/cpcode-products/log-configurations

Parameter Type Sample Description
URL parameters
logSourceType Enumeration cpcode-products Type of log source for which you can create a log delivery configuration, either cpcode-products, gtm-properties, edns-zones, or answerx-objects. For example, if you have Akamai Traffic Management and want to configure log delivery for it, retrieve the ID of your Traffic Management property by calling /lds-api/v3/log-sources/gtm-properties. Use the logSourceId to create a log delivery configuration.

Status 200 application/json

Response Body:

[
    {
        "id": "163842",
        "status": "active",
        "startDate": "2013-01-02",
        "logSource": {
            "links": [
                {
                    "rel": "self",
                    "href": "/lds-api/v3/log-sources/cpcode-products/200957-1"
                },
                {
                    "rel": "cpcode-products",
                    "href": "/lds-api/v3/log-sources/cpcode-products"
                },
                {
                    "rel": "log-sources",
                    "href": "/lds-api/v3/log-sources"
                }
            ],
            "type": "cpcode-products",
            "id": "200957-1",
            "cpCode": "200957 - MOCK CP CODE DESCR ",
            "products": [
                "HTTP Content Delivery"
            ]
        },
        "aggregationDetails": {
            "type": "byLogArrival",
            "deliveryFrequency": {
                "id": "1",
                "value": "Every 24 hours",
                "links": [
                    {
                        "rel": "self",
                        "href": "/lds-api/v3/log-configuration-parameters/delivery-frequencies/1"
                    },
                    {
                        "rel": "deliveryFrequencies",
                        "href": "/lds-api/v3/log-configuration-parameters/delivery-frequencies"
                    }
                ]
            }
        },
        "contactDetails": {
            "mailAddresses": [
                "jjudge@akamai.com"
            ],
            "contact": {
                "id": "1-C30O",
                "value": ". Help-Desk - phone: 617.250.3900",
                "links": [
                    {
                        "rel": "self",
                        "href": "/lds-api/v3/log-configuration-parameters/contacts/1-C30O"
                    },
                    {
                        "rel": "contacts",
                        "href": "/lds-api/v3/log-configuration-parameters/contacts"
                    }
                ]
            }
        },
        "deliveryDetails": {
            "type": "ftp",
            "machine": "akainsight.upload.akamai.com",
            "login": "insightlds",
            "directory": "/23567/logs/200957",
            "password": ""
        },
        "encodingDetails": {
            "encoding": {
                "id": "3",
                "value": "GZIP",
                "links": [
                    {
                        "rel": "self",
                        "href": "/lds-api/v3/log-configuration-parameters/encodings/3"
                    },
                    {
                        "rel": "encodings",
                        "href": "/lds-api/v3/log-configuration-parameters/encodings"
                    }
                ]
            }
        },
        "logFormatDetails": {
            "logIdentifier": "200957",
            "logFormat": {
                "id": "2",
                "value": "combined",
                "links": [
                    {
                        "rel": "self",
                        "href": "/lds-api/v3/log-configuration-parameters/log-formats/2"
                    },
                    {
                        "rel": "logFormats",
                        "href": "/lds-api/v3/log-configuration-parameters/log-formats"
                    }
                ]
            }
        },
        "messageSize": {
            "id": "1",
            "value": "50 MB (approx. 300 MB uncompressed logs)",
            "links": [
                {
                    "rel": "self",
                    "href": "/lds-api/v3/log-configuration-parameters/message-sizes/1"
                },
                {
                    "rel": "messageSizes",
                    "href": "/lds-api/v3/log-configuration-parameters/message-sizes"
                }
            ]
        },
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configuration/163842"
            },
            {
                "rel": "get-log-configurations-for-log-source",
                "href": "/lds-api/v3/log-sources/cpcode-products/200957-1/log-configurations",
                "title": "Get Log Configurations for the same log source"
            },
            {
                "rel": "get-log-configurations-for-log-source-type",
                "href": "/lds-api/v3/log-sources/cpcode-products/log-configurations",
                "title": "Get Log Configurations for the same log source type"
            },
            {
                "rel": "update-log-configuration",
                "href": "/lds-api/v3/log-configuration/163842",
                "method": "PUT",
                "title": "Update Log Configuration"
            },
            {
                "rel": "delete-log-configuration",
                "href": "/lds-api/v3/log-configuration/163842",
                "method": "DELETE",
                "title": "Delete Log Configuration"
            },
            {
                "rel": "suspend-log-configuration",
                "href": "/lds-api/v3/log-configuration/163842/suspend",
                "method": "POST",
                "title": "Suspend Log Configuration"
            }
        ]
    },
    {
        "id": "143296",
        "status": "suspended",
        "startDate": "2011-04-05",
        "endDate": "2011-04-08",
        "logSource": {
            "links": [
                {
                    "rel": "self",
                    "href": "/lds-api/v3/log-sources/cpcode-products/104523-1"
                },
                {
                    "rel": "cpcode-products",
                    "href": "/lds-api/v3/log-sources/cpcode-products"
                },
                {
                    "rel": "log-sources",
                    "href": "/lds-api/v3/log-sources"
                }
            ],
            "type": "cpcode-products",
            "id": "104523-1",
            "cpCode": "104523 - MOCK CP CODE DESCR ",
            "products": [
                "Web Application Accelerator"
            ]
        },
        "aggregationDetails": {
            "type": "byLogArrival",
            "deliveryFrequency": {
                "id": "7",
                "value": "Every 1 hour",
                "links": [
                    {
                        "rel": "self",
                        "href": "/lds-api/v3/log-configuration-parameters/delivery-frequencies/7"
                    },
                    {
                        "rel": "deliveryFrequencies",
                        "href": "/lds-api/v3/log-configuration-parameters/delivery-frequencies"
                    }
                ]
            }
        },
        "contactDetails": {
            "mailAddresses": [
                "jad@akamai.com"
            ],
            "contact": {
                "id": "VC-GAKY",
                "value": "Dmitriy Danilevsky - phone: 650.627.5222",
                "links": [
                    {
                        "rel": "self",
                        "href": "/lds-api/v3/log-configuration-parameters/contacts/VC-GAKY"
                    },
                    {
                        "rel": "contacts",
                        "href": "/lds-api/v3/log-configuration-parameters/contacts"
                    }
                ]
            }
        },
        "deliveryDetails": {
            "type": "email",
            "emailAddress": "jad@akamai.com"
        },
        "encodingDetails": {
            "encoding": {
                "id": "1",
                "value": "GZIP & UUENCODED",
                "links": [
                    {
                        "rel": "self",
                        "href": "/lds-api/v3/log-configuration-parameters/encodings/1"
                    },
                    {
                        "rel": "encodings",
                        "href": "/lds-api/v3/log-configuration-parameters/encodings"
                    }
                ]
            }
        },
        "logFormatDetails": {
            "logIdentifier": "edgetoken",
            "logFormat": {
                "id": "13",
                "value": "W3C + Edge Tokenization",
                "links": [
                    {
                        "rel": "self",
                        "href": "/lds-api/v3/log-configuration-parameters/log-formats/13"
                    },
                    {
                        "rel": "logFormats",
                        "href": "/lds-api/v3/log-configuration-parameters/log-formats"
                    }
                ]
            }
        },
        "messageSize": {
            "id": "1",
            "value": "50 MB (approx. 300 MB uncompressed logs)",
            "links": [
                {
                    "rel": "self",
                    "href": "/lds-api/v3/log-configuration-parameters/message-sizes/1"
                },
                {
                    "rel": "messageSizes",
                    "href": "/lds-api/v3/log-configuration-parameters/message-sizes"
                }
            ]
        },
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configuration/143296"
            },
            {
                "rel": "get-log-configurations-for-log-source",
                "href": "/lds-api/v3/log-sources/cpcode-products/104523-1/log-configurations",
                "title": "Get Log Configurations for the same log source"
            },
            {
                "rel": "get-log-configurations-for-log-source-type",
                "href": "/lds-api/v3/log-sources/cpcode-products/log-configurations",
                "title": "Get Log Configurations for the same log source type"
            },
            {
                "rel": "update-log-configuration",
                "href": "/lds-api/v3/log-configuration/143296",
                "method": "PUT",
                "title": "Update Log Configuration"
            },
            {
                "rel": "delete-log-configuration",
                "href": "/lds-api/v3/log-configuration/143296",
                "method": "DELETE",
                "title": "Delete Log Configuration"
            },
            {
                "rel": "resume-log-configuration",
                "href": "/lds-api/v3/log-configuration/143296/resume",
                "method": "POST",
                "title": "Resume Log Configuration"
            }
        ]
    }
]

  1. Run the List Log Sources operation.

  2. Store the logSourceType from the appropriate object in that listing.

  3. Make a GET request to /lds-api/v3/log-sources/{logSourceType}/{logSourceId}/log-configurations.

  4. The response object includes a list of all log delivery configurations with the specified logSourceType and logSourceId.

List log formats by type

Returns all available log formats for the specified logSourceType type. You need the Id of log format to create new log delivery configurations.

GET /lds-api/v3/log-sources/{logSourceType}/log-formats

Sample: /lds-api/v3/log-sources/cpcode-products/log-formats

Parameter Type Sample Description
URL parameters
logSourceType Enumeration cpcode-products Type of log source for which you can create a log delivery configuration, either cpcode-products, gtm-properties, edns-zones, or answerx-objects. For example, if you have Akamai Traffic Management and want to configure log delivery for it, retrieve the ID of your Traffic Management property by calling /lds-api/v3/log-sources/gtm-properties. Use the logSourceId to create a log delivery configuration.

Status 200 application/json

Response Body:

[
    {
        "id": "2",
        "value": "combined",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configuration-parameters/log-formats/2"
            },
            {
                "rel": "logFormats",
                "href": "/lds-api/v3/log-configuration-parameters/log-formats"
            },
            {
                "rel": "logSources",
                "href": "/lds-api/v3/log-sources/cpcode-products/1-17310"
            }
        ]
    },
    {
        "id": "3",
        "value": "W3C",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configuration-parameters/log-formats/3"
            },
            {
                "rel": "logFormats",
                "href": "/lds-api/v3/log-configuration-parameters/log-formats"
            },
            {
                "rel": "logSources",
                "href": "/lds-api/v3/log-sources/cpcode-products/1-17310"
            }
        ]
    }
]

  1. Run the List Log Sources operation.

  2. Store the logSourceType from the appropriate object in that listing.

  3. Make a GET request to /lds-api/v3/log-sources/{logSourceType}/log-formats.

  4. The response object lists the available log format options for the specified logSourceType. Store the id of the desired log format to use when creating or modifying log delivery configurations.

List log encodings by type

Retrieves all allowable log encodings.

GET /lds-api/v3/log-sources/{logSourceType}/encodings{?deliveryType}

Sample: /lds-api/v3/log-sources/cpcode-products/encodings?deliveryType=email

Parameter Type Sample Description
URL parameters
logSourceType Enumeration cpcode-products Type of log source for which you can create a log delivery configuration, either cpcode-products, gtm-properties, edns-zones, or answerx-objects. For example, if you have Akamai Traffic Management and want to configure log delivery for it, retrieve the ID of your Traffic Management property by calling /lds-api/v3/log-sources/gtm-properties. Use the logSourceId to create a log delivery configuration.
Optional query parameters
deliveryType Enumeration email Allowable encodings for log configuration are based on chosen type of delivery, either email or ftp.

Status 200 application/json

Response Body:

[
    {
        "id": "3",
        "value": "GZIP",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configuration-parameters/encodings/3"
            },
            {
                "rel": "encodings",
                "href": "/lds-api/v3/log-configuration-parameters/encodings"
            }
        ]
    },
    {
        "id": "4",
        "value": "GPG Encrypted",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configuration-parameters/encodings/4"
            },
            {
                "rel": "encodings",
                "href": "/lds-api/v3/log-configuration-parameters/encodings"
            }
        ]
    }
]

  1. You can optionally limit the allowable encodings returned by deliveryType, either email or ftp.

  2. Make a GET request to /lds-api/v{version}/log-sources/encodings/{?deliveryType}.

  3. The response lists the allowable encoding options for the specified deliveryType. Store the encoding id to use when creating and modifying log delivery configurations.

Get a log source

Get a log source of a given logSourceType type and logSourceId.

GET /lds-api/v3/log-sources/{logSourceType}/{logSourceId}

Sample: /lds-api/v3/log-sources/cpcode-products/124

Parameter Type Sample Description
URL parameters
logSourceType Enumeration cpcode-products Type of log source for which you can create a log delivery configuration, either cpcode-products, gtm-properties, edns-zones, or answerx-objects. For example, if you have Akamai Traffic Management and want to configure log delivery for it, retrieve the ID of your Traffic Management property by calling /lds-api/v3/log-sources/gtm-properties. Use the logSourceId to create a log delivery configuration.
logSourceId Integer 124 The ID of the log source - source identity for log delivery. The accompanying example shows how to check log deliveries and possible log configuration actions for an AnswerX object identified with 124.

Status 200 application/json

Response Body:

[
    {
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-sources/cpcode-products/23456-4"
            },
            {
                "rel": "cpcode-products",
                "href": "/lds-api/v3/log-sources/cpcode-products"
            },
            {
                "rel": "log-sources",
                "href": "/lds-api/v3/log-sources"
            },
            {
                "rel": "log-configurations",
                "href": "/lds-api/v3/log-sources/cpcode-products/23456-4/log-configurations",
                "method": "POST",
                "title": "Create log configuration for this log source."
            }
        ],
        "type": "cpcode-products",
        "id": "23456-4",
        "cpCode": "23456 - MOCK CP CODE DESCR ",
        "products": [
            "Quicktime Streaming"
        ]
    },
    {
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-sources/gtm/142981"
            },
            {
                "rel": "gtm",
                "href": "/lds-api/v3/log-sources/gtm"
            },
            {
                "rel": "log-sources",
                "href": "/lds-api/v3/log-sources"
            },
            {
                "rel": "log-configurations",
                "href": "/lds-api/v3/log-sources/gtm/142981/log-configurations",
                "method": "POST",
                "title": "Create log configuration for this log source."
            }
        ],
        "type": "gtm",
        "id": "142981",
        "propertyName": "origin-newcolumbus-qa.abgvoice.com.akadns.net"
    }
]

  1. Run the List Log Sources operation.

  2. Store the logSourceType and logSourceId from the appropriate object in that listing.

  3. Make a GET request to /lds-api/v3/log-sources/{logSourceType}/{logSourceId}.

List log configurations per ID

Get all log configurations of given logSourceType and logSourceId.

GET /lds-api/v3/log-sources/{logSourceType}/{logSourceId}/log-configurations

Sample: /lds-api/v3/log-sources/cpcode-products/124/log-configurations

Parameter Type Sample Description
URL parameters
logSourceType Enumeration cpcode-products Type of log source for which you can create a log delivery configuration, either cpcode-products, gtm-properties, edns-zones, or answerx-objects. For example, if you have Akamai Traffic Management and want to configure log delivery for it, retrieve the ID of your Traffic Management property by calling /lds-api/v3/log-sources/gtm-properties. Use the logSourceId to create a log delivery configuration.
logSourceId Integer 124 The ID of the log source - source identity for log delivery. The accompanying example shows how to check log deliveries and possible log configuration actions for an AnswerX object identified with 124.

Status 200 application/json

Response Body:

[
    {
        "id": "163842",
        "status": "active",
        "startDate": "2013-01-02",
        "logSource": {
            "links": [
                {
                    "rel": "self",
                    "href": "/lds-api/v3/log-sources/cpcode-products/200957-1"
                },
                {
                    "rel": "cpcode-products",
                    "href": "/lds-api/v3/log-sources/cpcode-products"
                },
                {
                    "rel": "log-sources",
                    "href": "/lds-api/v3/log-sources"
                }
            ],
            "type": "cpcode-products",
            "id": "200957-1",
            "cpCode": "200957 - MOCK CP CODE DESCR ",
            "products": [
                "HTTP Content Delivery"
            ]
        },
        "aggregationDetails": {
            "type": "byLogArrival",
            "deliveryFrequency": {
                "id": "1",
                "value": "Every 24 hours",
                "links": [
                    {
                        "rel": "self",
                        "href": "/lds-api/v3/log-configuration-parameters/delivery-frequencies/1"
                    },
                    {
                        "rel": "deliveryFrequencies",
                        "href": "/lds-api/v3/log-configuration-parameters/delivery-frequencies"
                    }
                ]
            }
        },
        "contactDetails": {
            "mailAddresses": [
                "jjudge@akamai.com"
            ],
            "contact": {
                "id": "1-C30O",
                "value": ". Help-Desk - phone: 617.250.3900",
                "links": [
                    {
                        "rel": "self",
                        "href": "/lds-api/v3/log-configuration-parameters/contacts/1-C30O"
                    },
                    {
                        "rel": "contacts",
                        "href": "/lds-api/v3/log-configuration-parameters/contacts"
                    }
                ]
            }
        },
        "deliveryDetails": {
            "type": "ftp",
            "machine": "akainsight.upload.akamai.com",
            "login": "insightlds",
            "directory": "/23567/logs/200957",
            "password": ""
        },
        "encodingDetails": {
            "encoding": {
                "id": "3",
                "value": "GZIP",
                "links": [
                    {
                        "rel": "self",
                        "href": "/lds-api/v3/log-configuration-parameters/encodings/3"
                    },
                    {
                        "rel": "encodings",
                        "href": "/lds-api/v3/log-configuration-parameters/encodings"
                    }
                ]
            }
        },
        "logFormatDetails": {
            "logIdentifier": "200957",
            "logFormat": {
                "id": "2",
                "value": "combined",
                "links": [
                    {
                        "rel": "self",
                        "href": "/lds-api/v3/log-configuration-parameters/log-formats/2"
                    },
                    {
                        "rel": "logFormats",
                        "href": "/lds-api/v3/log-configuration-parameters/log-formats"
                    }
                ]
            }
        },
        "messageSize": {
            "id": "1",
            "value": "50 MB (approx. 300 MB uncompressed logs)",
            "links": [
                {
                    "rel": "self",
                    "href": "/lds-api/v3/log-configuration-parameters/message-sizes/1"
                },
                {
                    "rel": "messageSizes",
                    "href": "/lds-api/v3/log-configuration-parameters/message-sizes"
                }
            ]
        },
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configuration/163842"
            },
            {
                "rel": "get-log-configurations-for-log-source",
                "href": "/lds-api/v3/log-sources/cpcode-products/200957-1/log-configurations",
                "title": "Get Log Configurations for the same log source"
            },
            {
                "rel": "get-log-configurations-for-log-source-type",
                "href": "/lds-api/v3/log-sources/cpcode-products/log-configurations",
                "title": "Get Log Configurations for the same log source type"
            },
            {
                "rel": "update-log-configuration",
                "href": "/lds-api/v3/log-configuration/163842",
                "method": "PUT",
                "title": "Update Log Configuration"
            },
            {
                "rel": "delete-log-configuration",
                "href": "/lds-api/v3/log-configuration/163842",
                "method": "DELETE",
                "title": "Delete Log Configuration"
            },
            {
                "rel": "suspend-log-configuration",
                "href": "/lds-api/v3/log-configuration/163842/suspend",
                "method": "POST",
                "title": "Suspend Log Configuration"
            }
        ]
    },
    {
        "id": "143296",
        "status": "suspended",
        "startDate": "2011-04-05",
        "endDate": "2011-04-08",
        "logSource": {
            "links": [
                {
                    "rel": "self",
                    "href": "/lds-api/v3/log-sources/cpcode-products/104523-1"
                },
                {
                    "rel": "cpcode-products",
                    "href": "/lds-api/v3/log-sources/cpcode-products"
                },
                {
                    "rel": "log-sources",
                    "href": "/lds-api/v3/log-sources"
                }
            ],
            "type": "cpcode-products",
            "id": "104523-1",
            "cpCode": "104523 - MOCK CP CODE DESCR ",
            "products": [
                "Web Application Accelerator"
            ]
        },
        "aggregationDetails": {
            "type": "byLogArrival",
            "deliveryFrequency": {
                "id": "7",
                "value": "Every 1 hour",
                "links": [
                    {
                        "rel": "self",
                        "href": "/lds-api/v3/log-configuration-parameters/delivery-frequencies/7"
                    },
                    {
                        "rel": "deliveryFrequencies",
                        "href": "/lds-api/v3/log-configuration-parameters/delivery-frequencies"
                    }
                ]
            }
        },
        "contactDetails": {
            "mailAddresses": [
                "jad@akamai.com"
            ],
            "contact": {
                "id": "VC-GAKY",
                "value": "Dmitriy Danilevsky - phone: 650.627.5222",
                "links": [
                    {
                        "rel": "self",
                        "href": "/lds-api/v3/log-configuration-parameters/contacts/VC-GAKY"
                    },
                    {
                        "rel": "contacts",
                        "href": "/lds-api/v3/log-configuration-parameters/contacts"
                    }
                ]
            }
        },
        "deliveryDetails": {
            "type": "email",
            "emailAddress": "jad@akamai.com"
        },
        "encodingDetails": {
            "encoding": {
                "id": "1",
                "value": "GZIP & UUENCODED",
                "links": [
                    {
                        "rel": "self",
                        "href": "/lds-api/v3/log-configuration-parameters/encodings/1"
                    },
                    {
                        "rel": "encodings",
                        "href": "/lds-api/v3/log-configuration-parameters/encodings"
                    }
                ]
            }
        },
        "logFormatDetails": {
            "logIdentifier": "edgetoken",
            "logFormat": {
                "id": "13",
                "value": "W3C + Edge Tokenization",
                "links": [
                    {
                        "rel": "self",
                        "href": "/lds-api/v3/log-configuration-parameters/log-formats/13"
                    },
                    {
                        "rel": "logFormats",
                        "href": "/lds-api/v3/log-configuration-parameters/log-formats"
                    }
                ]
            }
        },
        "messageSize": {
            "id": "1",
            "value": "50 MB (approx. 300 MB uncompressed logs)",
            "links": [
                {
                    "rel": "self",
                    "href": "/lds-api/v3/log-configuration-parameters/message-sizes/1"
                },
                {
                    "rel": "messageSizes",
                    "href": "/lds-api/v3/log-configuration-parameters/message-sizes"
                }
            ]
        },
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configuration/143296"
            },
            {
                "rel": "get-log-configurations-for-log-source",
                "href": "/lds-api/v3/log-sources/cpcode-products/104523-1/log-configurations",
                "title": "Get Log Configurations for the same log source"
            },
            {
                "rel": "get-log-configurations-for-log-source-type",
                "href": "/lds-api/v3/log-sources/cpcode-products/log-configurations",
                "title": "Get Log Configurations for the same log source type"
            },
            {
                "rel": "update-log-configuration",
                "href": "/lds-api/v3/log-configuration/143296",
                "method": "PUT",
                "title": "Update Log Configuration"
            },
            {
                "rel": "delete-log-configuration",
                "href": "/lds-api/v3/log-configuration/143296",
                "method": "DELETE",
                "title": "Delete Log Configuration"
            },
            {
                "rel": "resume-log-configuration",
                "href": "/lds-api/v3/log-configuration/143296/resume",
                "method": "POST",
                "title": "Resume Log Configuration"
            }
        ]
    }
]

  1. Run the List Log Sources operation.

  2. Store the logSourceType and logSourceId from the appropriate object in that listing.

  3. Make a GET request to /lds-api/v3/log-sources/{logSourceType}/{logSourceId}/log-configurations.

  4. The response object includes a list of all log delivery configurations with the specified logSourceId.

Create a new log configuration

Creates new log configuration. The response’s Location header reflects where you can access the new configuration.

POST /lds-api/v3/log-sources/{logSourceType}/{logSourceId}/log-configurations

Sample: /lds-api/v3/log-sources/cpcode-products/124/log-configurations

Content-Type: application/json

Request Body:

{
    "startDate": "2012-10-31",
    "contactDetails": {
        "contact": {
            "id": "1-2LPWVP"
        },
        "mailAddresses": [
            "asfasf@fa.pl"
        ]
    },
    "logFormatDetails": {
        "logFormat": {
            "id": "12"
        },
        "logIdentifier": "dfgd"
    },
    "messageSize": {
        "id": "2"
    },
    "aggregationDetails": {
        "type": "byLogArrival",
        "deliveryFrequency": {
            "id": "1"
        }
    },
    "encodingDetails": {
        "encoding": {
            "id": "1"
        }
    },
    "deliveryDetails": {
        "type": "email",
        "emailAddress": "asf@fa.pl"
    }
}
Parameter Type Sample Description
URL parameters
logSourceType Enumeration cpcode-products Type of log source for which you can create a log delivery configuration, either cpcode-products, gtm-properties, edns-zones, or answerx-objects. For example, if you have Akamai Traffic Management and want to configure log delivery for it, retrieve the ID of your Traffic Management property by calling /lds-api/v3/log-sources/gtm-properties. Use the logSourceId to create a log delivery configuration.
logSourceId Integer 124 The ID of the log source - source identity for log delivery. The accompanying example shows how to check log deliveries and possible log configuration actions for an AnswerX object identified with 124.

Status 201

Headers:

Location: /lds-api/v3/log-configurations/268234

  1. Run the Get Log Configurations by Type operation.

  2. Store the logConfigurationId from the appropriate object in that listing.

  3. Run the Get a Log Configuration operation if you need to review this configuration’s parameters before modifying them.

  4. When creating the request object, you need to specify the full representation of the log delivery configuration. To omit any member is to remove it from the log configuration.

  5. Make a POST request to /lds-api/v3/log-sources/{logSourceType}/{logSourceId}/log-configurations.

List log formats per ID

Gets log formats of given logSourceType and logSourceId.

GET /lds-api/v3/log-sources/{logSourceType}/{logSourceId}/log-formats

Sample: /lds-api/v3/log-sources/cpcode-products/124/log-formats

Parameter Type Sample Description
URL parameters
logSourceType Enumeration cpcode-products Type of log source for which you can create a log delivery configuration, either cpcode-products, gtm-properties, edns-zones, or answerx-objects. For example, if you have Akamai Traffic Management and want to configure log delivery for it, retrieve the ID of your Traffic Management property by calling /lds-api/v3/log-sources/gtm-properties. Use the logSourceId to create a log delivery configuration.
logSourceId Integer 124 The ID of the log source - source identity for log delivery. The accompanying example shows how to check log deliveries and possible log configuration actions for an AnswerX object identified with 124.

Status 200 application/json

Response Body:

[
    {
        "id": "2",
        "value": "combined",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configuration-parameters/log-formats/2"
            },
            {
                "rel": "logFormats",
                "href": "/lds-api/v3/log-configuration-parameters/log-formats"
            },
            {
                "rel": "logSources",
                "href": "/lds-api/v3/log-sources/cpcode-products/1-17310"
            }
        ]
    },
    {
        "id": "3",
        "value": "W3C",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configuration-parameters/log-formats/3"
            },
            {
                "rel": "logFormats",
                "href": "/lds-api/v3/log-configuration-parameters/log-formats"
            },
            {
                "rel": "logSources",
                "href": "/lds-api/v3/log-sources/cpcode-products/1-17310"
            }
        ]
    }
]

  1. Run the List Log Sources operation.

  2. Store the logSourceType and logSourceId from the appropriate object in that listing.

  3. Make a GET request to /lds-api/v3/log-sources/{logSourceType}/{logSourceId}/log-formats.

  4. The response object lists the available log format options for the specified logSourceId. Store the log format id to use when creating or modifying log delivery configurations.

Data

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

Download the JSON schemas for this API.

The data schema tables below list membership requirements as follows:

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

LogConfiguration

Represents the main log delivery configuration object that creates and updates a log delivery configuration.

Download schema: doc-log-config.json

Sample GET response:

{
    "id": "163842",
    "status": "active",
    "startDate": "2013-01-02",
    "logSource": {
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-sources/cpcode-products/200957-1"
            },
            {
                "rel": "cpcode-products",
                "href": "/lds-api/v3/log-sources/cpcode-products"
            },
            {
                "rel": "log-sources",
                "href": "/lds-api/v3/log-sources"
            }
        ],
        "type": "cpcode-products",
        "id": "200957-1",
        "cpCode": "200957 - MOCK CP CODE DESCR ",
        "products": [
            "HTTP Content Delivery"
        ]
    },
    "aggregationDetails": {
        "type": "byLogArrival",
        "deliveryFrequency": {
            "id": "1",
            "value": "Every 24 hours",
            "links": [
                {
                    "rel": "self",
                    "href": "/lds-api/v3/log-configuration-parameters/delivery-frequencies/1"
                },
                {
                    "rel": "deliveryFrequencies",
                    "href": "/lds-api/v3/log-configuration-parameters/delivery-frequencies"
                }
            ]
        }
    },
    "contactDetails": {
        "mailAddresses": [
            "jjudge@akamai.com"
        ],
        "contact": {
            "id": "1-C30O",
            "value": ". Help-Desk - phone: 617.250.3900",
            "links": [
                {
                    "rel": "self",
                    "href": "/lds-api/v3/log-configuration-parameters/contacts/1-C30O"
                },
                {
                    "rel": "contacts",
                    "href": "/lds-api/v3/log-configuration-parameters/contacts"
                }
            ]
        }
    },
    "deliveryDetails": {
        "type": "ftp",
        "machine": "akainsight.upload.akamai.com",
        "login": "insightlds",
        "directory": "/23567/logs/200957",
        "password": ""
    },
    "encodingDetails": {
        "encoding": {
            "id": "3",
            "value": "GZIP",
            "links": [
                {
                    "rel": "self",
                    "href": "/lds-api/v3/log-configuration-parameters/encodings/3"
                },
                {
                    "rel": "encodings",
                    "href": "/lds-api/v3/log-configuration-parameters/encodings"
                }
            ]
        }
    },
    "logFormatDetails": {
        "logIdentifier": "200957",
        "logFormat": {
            "id": "2",
            "value": "combined",
            "links": [
                {
                    "rel": "self",
                    "href": "/lds-api/v3/log-configuration-parameters/log-formats/2"
                },
                {
                    "rel": "logFormats",
                    "href": "/lds-api/v3/log-configuration-parameters/log-formats"
                }
            ]
        }
    },
    "messageSize": {
        "id": "1",
        "value": "50 MB (approx. 300 MB uncompressed logs)",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configuration-parameters/message-sizes/1"
            },
            {
                "rel": "messageSizes",
                "href": "/lds-api/v3/log-configuration-parameters/message-sizes"
            }
        ]
    },
    "links": [
        {
            "rel": "self",
            "href": "/lds-api/v3/log-configuration/163842"
        },
        {
            "rel": "get-log-configurations-for-log-source",
            "href": "/lds-api/v3/log-sources/cpcode-products/200957-1/log-configurations",
            "title": "Get Log Configurations for the same log source"
        },
        {
            "rel": "get-log-configurations-for-log-source-type",
            "href": "/lds-api/v3/log-sources/cpcode-products/log-configurations",
            "title": "Get Log Configurations for the same log source type"
        },
        {
            "rel": "update-log-configuration",
            "href": "/lds-api/v3/log-configuration/163842",
            "method": "PUT",
            "title": "Update Log Configuration"
        },
        {
            "rel": "delete-log-configuration",
            "href": "/lds-api/v3/log-configuration/163842",
            "method": "DELETE",
            "title": "Delete Log Configuration"
        },
        {
            "rel": "suspend-log-configuration",
            "href": "/lds-api/v3/log-configuration/163842/suspend",
            "method": "POST",
            "title": "Suspend Log Configuration"
        }
    ]
}

LogConfiguration members

Member Type Required Description
aggregationDetails Object ✓ Defines how to aggregate logs: by log arrival or by hit time. The value is either an AggregationByHitTime or AggregationByLogArrival object.
contactDetails LogConfiguration.contactDetails ✓ Contains details about contact person for this log delivery configuration.
deliveryDetails Object ✓ Either an EmailDelivery or FtpDelivery object.
encodingDetails LogConfiguration.encodingDetails ✓ Describes the log encoding.
endDate String ○ End date to which logs will be collected.
id String ○ Read-only. Unique identifier of this configuration.
logFormatDetails LogConfiguration.logFormatDetails ✓ Describes the log format.
logSource Object ○ Read-only. This member appears in log configurations only in server responses. For creating and modifying log configuration, all required information to identify configuration is in the URL. The type is either an AnswerXLogSource, CpCodeLogSource, EdnsLogSource, or GtmLogSource.
messageSize Object ✓ Packed log message’s approximate size, a simple KeyValuePair object.
startDate String ✓ Start date from which logs will be collected.
status Enumeration ○ Read-only. Log configuration status, either active, expired, or suspended. Only active configurations are used in the actual log delivery process.
LogConfiguration.contactDetails: Contains details about contact person for this log delivery configuration.
contact Object ✓ Contact information provided as a simple KeyValuePair object.
mailAddresses Array ✓ List of email addresses for contacts for this log format configuration.
LogConfiguration.encodingDetails: Describes the log encoding.
encoding Object ✓ Selected encoding option used to encode logs, a simple KeyValuePair object.
encodingKey String ○ Public key value for encrypted encoding. You need to set the public key value if GPG encrypted encoding is used.
LogConfiguration.logFormatDetails: Describes the log format.
logFormat Object ✓ Selected format for log delivery, a simple KeyValuePair object.
logIdentifier String ✓ Represents the first token of the log filename.

LogConfigurationCopy

Encapsulates information needed to copy a log configuration.

Download schema: doc-log-copy.json

Sample GET response:

{
    "copyTarget": {
        "logSource": {
            "type": "gtm",
            "id": "1243"
        }
    }
}

LogConfigurationCopy members

Member Type Required Description
copyTarget LogConfigurationCopy.copyTarget ✓ Represents target log source for configuration copy request.
LogConfigurationCopy.copyTarget: Represents target log source for configuration copy request.
logSource Object ✓ Describes detailed log source information for configuration, one of these object types: AnswerXLogSource, CpCodeLogSource, EdnsLogSource, or GtmLogSource.

Redelivery

Collects information needed to create a log redelivery request.

Download schema: doc-redelivery.json

Sample GET response:

{
    "logConfiguration": {
        "id": "154519",
        "links": [
            {
                "rel": "self",
                "href": "/lds-api/v3/log-configurations/154519"
            }
        ]
    },
    "id": "272480",
    "beginTime": 3,
    "endTime": 6,
    "redeliveryDate": "2016-10-08",
    "status": "new",
    "createdDate": "2016-10-05",
    "modifiedDate": "2016-10-07",
    "links": [
        {
            "rel": "self",
            "href": "/lds-api/v3/log-redeliveries/272480"
        },
        {
            "rel": "get-log-redeliveries",
            "href": "/lds-api/v3/log-redeliveries",
            "title": "Get Log Redeliveries"
        },
        {
            "rel": "create-log-redelivery",
            "href": "/lds-api/v3/log-redeliveries",
            "method": "POST",
            "title": "Create Log Redelivery"
        }
    ]
}

Redelivery members

Member Type Required Description
beginTime Integer ✓ First hour of time range (0–23) for which log redelivery is requested.
createdDate String ○ Read-only. Date the request for redelivery was created.
endTime Integer ✓ Last hour of time range (1–24) for which log redelivery is requested.
id String ○ Read-only. Unique ID of this redelivery request.
logConfiguration Redelivery.logConfiguration ✓ Log delivery configuration for which this redelivery request was created.
modifiedDate String ○ Read-only. Date of the last time the redelivery request was modified.
redeliveryDate String ✓ Date from which log redelivery is requested.
status Enumeration ○ Read-only. Status of the redelivery, either new, scheduled, success, or failed.
Redelivery.logConfiguration: Log delivery configuration for which this redelivery request was created.
id String ✓ Unique ID for the log delivery configuration.

KeyValuePair

A simple data type used for pairs of IDs and values.

Download schema: doc-pair.json

Sample GET response:

{
    "id": "1",
    "value": "Every 24 hours",
    "links": [
        {
            "rel": "self",
            "href": "/lds-api/v3/log-configuration-parameters/delivery-frequencies/1"
        },
        {
            "rel": "deliveryFrequencies",
            "href": "/lds-api/v3/log-configuration-parameters/delivery-frequencies"
        }
    ]
}

KeyValuePair members

Member Type Required Description
id String ✓ Unique identifier for the object.
value String ○ Read-only. Human-readable value for the object.

AggregationByHitTime

This aggregation option allows to receive most of the hits for each GMT calendar day in a single delivery.

Download schema: doc-aggregation-by-hit-time.json

AggregationByHitTime members

Member Type Required Description
deliverResidualData Boolean ✓ Indicates whether residual data should be sent at regular intervals after each day.
deliveryThreshold Object ✓ Data completion threshold, or the percentage of expected logs to be processed before the log data is sent to you, provided as a simple KeyValuePair object.
type Enumeration ✓ Identifies the type of aggregation, byHitTime in this case.

AggregationByLogArrival

This aggregation option allows you to receive log data in the order in which it arrives from edge servers.

Download schema: doc-aggregation-by-log-arrival.json

AggregationByLogArrival members

Member Type Required Description
deliveryFrequency Object ✓ Period of time that will be covered by log delivery, provided as a simple KeyValuePair object.
type Enumeration ✓ Identifies the type of aggregation, byLogArrival in this case.

FtpDelivery

Encapsulates log delivery via FTP.

Download schema: doc-ftp-delivery.json

FtpDelivery members

Member Type Required Description
directory String ✓ Target directory to which logs will be sent by FTP.
login String ✓ Login used to authenticate to FTP machine.
machine String ✓ Machine to which log will be sent by FTP.
password String ✓ Password used to authenticate to FTP machine. Keep in mind that this field will be empty in all responses from the server.
type Enumeration ✓ Identifies this type of delivery, ftp in this case.

EmailDelivery

Encapsulates log delivery sent by email.

Download schema: doc-email-delivery.json

EmailDelivery members

Member Type Required Description
emailAddress String ✓ Email address to which log will be sent.
type Enumeration ✓ Identifies this type of delivery, email in this case.

AnswerXLogSource

Identifies an AnswerX object for which you can create a log delivery configuration.

Download schema: doc-log-source-answerx.json

AnswerXLogSource members

Member Type Required Description
id Integer ✓ Unique identifier for each log source.
logRetentionDays Integer ○ Read-only. Number of days that Akamai should keep logs collected for that log source. You can create log redelivery requests only for this retention period.
name String ○ Read-only. The AnswerX object name.
type Enumeration ✓ Identifies the type of this log source, in this case answerx.

CpCodeLogSource

Identifies a group of CP code products, for which the log delivery configuration is being created.

Download schema: doc-log-source-cpcode.json

CpCodeLogSource members

Member Type Required Description
cpCode String ○ Read-only. CP code ID and name for which logs will be collected.
id Integer ✓ Unique identifier for each log source.
logRetentionDays Integer ○ Read-only. Number of days that Akamai should keep logs collected for that log source. You can create log redelivery requests only for this retention period.
products Array ○ Read-only. Products for which logs will be collected.
type Enumeration ✓ Identifies the type of this log source, in this case cpcode-products.

EdnsLogSource

Identifies a DNS zone for which you can create a log delivery configuration.

Download schema: doc-log-source-edns.json

EdnsLogSource members

Member Type Required Description
id Integer ✓ Unique identifier for each log source.
logRetentionDays Integer ○ Read-only. Number of days that Akamai should keep logs collected for that log source. You can create log redelivery requests only for this retention period.
type Enumeration ✓ Identifies the type of this log source, in this case edns.
zoneName String ○ Read-only. The full name of the EDNS zone.

GtmLogSource

Identifies a Traffic Management property for which you can create a log delivery configuration.

Download schema: doc-log-source-gtm.json

GtmLogSource members

Member Type Required Description
id Integer ✓ Unique identifier for each log source.
logRetentionDays Integer ○ Read-only. Number of days that Akamai should keep logs collected for that log source. You can create log redelivery requests only for this retention period.
propertyName String ○ Read-only. The full name of the Traffic Management domain property.
type Enumeration ✓ Identifies the type of this log source, in this case gtm.

Errors

This section provides information on the data object that reflects the API’s common response to error cases, and lists the API’s range of response status codes for both error and success cases.

Please note that with log delivery you may also encounter issues with the delivery mechanisms, email and FTP. You can learn more about possible email and FTP delivery errors in the LDS User Guide on Control Center.

Error responses

The following is an example of a response with an authorization error.

HTTP/1.1 401
Content-Type: application/json
Reply Body:

{
    "details": [
        {
            "code": "requested.action.not.allowed",
            "message": "You do not have permission for this action.",
            "data": {
                "action": "View Log Configuration"
            }
        }
    ],
    "code": "error.authorization.fail",
    "title": "Missing access rights to resource",
    "incidentId": "0afe0260-8800-4921-bc4e-439219946d96"
}

All JSON responses for error cases follow the Problem Details specification.

HTTP status codes

The following lists the range of HTTP response codes the API may produce for both success and error cases:

Code Description
200 Request OK
201 Resource created.
204 No content. Displays when a DELETE operation is successful.
400 Bad request. Please provide all the required parameters.
401 Unauthorized request. You don’t have permission to perform this action.
403 Forbidden. User is not authenticated.
404 Resource not found. The object you were trying to reach could not be found.
405 Method not allowed.
415 Unsupported media type
429 Too many requests
500 Internal Server Error
503 Service Unavailable