Akamai APIs API Documentation
View history
GET https://{{host}}/datastream-config-api/v2/log/streams/:streamId/history
Returns details about all versions of a given stream. It helps you track changes between the versions of the stream, including monitored properties, logged data set fields, and log delivery destinations. Optionally, set both the startVersion and endVersion parameters to get details on all stream versions for a given range. For example, setting startVersion to 1 and endVersion to 3 returns details on the 1, 2, and 3 versions of the stream.
Body
PARAM
| Key | Datatype | Required | Description |
startVersion
|
string | (Optional) Specifies the first stream version in the `startVersion` to `endVersion` range you want to fetch stream history details for. The `startVersion` needs to be less than the `endVersion`. | |
endVersion
|
string | (Optional) Specifies the last stream version in the range you want to fetch stream history details for. The `endVersion` needs to be greater than `startVersion`. |
HEADERS
| Key | Datatype | Required | Description |
Accept
|
string |
RESPONSES
status OK
| [
{
"contractId": "C-0N7RAC71",
"createdBy": "jperez",
"createdDate": "2022-02-05T13:31:30Z",
"datasetFields": [
{
"datasetFieldId": 1000,
"datasetFieldJsonKey": "cp",
"datasetFieldName": "CP code"
},
{
"datasetFieldId": 1002,
"datasetFieldJsonKey": "reqId",
"datasetFieldName": "Request ID"
},
{
"datasetFieldId": 1023,
"datasetFieldJsonKey": "cookie",
"datasetFieldName": "Cookie"
},
{
"datasetFieldId": 1031,
"datasetFieldJsonKey": "range",
"datasetFieldName": "Range"
},
{
"datasetFieldId": 1032,
"datasetFieldJsonKey": "referer",
"datasetFieldName": "Referer"
},
{
"datasetFieldId": 1037,
"datasetFieldJsonKey": "xForwardedFor",
"datasetFieldName": "X-Forwarded-For"
}
],
"deliveryConfiguration": {
"fieldDelimiter": "SPACE",
"format": "STRUCTURED",
"frequency": {
"intervalInSeconds": 30
},
"uploadFilePrefix": "logs",
"uploadFileSuffix": "ds"
},
"destination": {
"bucket": "datastream.akamai.com",
"destinationType": "S3",
"displayName": "S3Destination",
"path": "ds2-logs",
"region": "ap-south-1"
},
"groupId": 32145,
"latestVersion": 2,
"modifiedBy": "adevi",
"modifiedDate": "2022-02-08T15:31:30Z",
"notificationEmails": [
"useremail1@domain.com",
"useremail2@domain.com"
],
"productId": "Dynamic_Site_Accelerator",
"properties": [
{
"propertyId": 349772,
"propertyName": "example.com"
},
{
"propertyId": 349770,
"propertyName": "example.akamai.com"
}
],
"streamId": 7050,
"streamName": "diagnostics-log-stream",
"streamStatus": "ACTIVATING",
"streamVersion": 2
},
{
"contractId": "C-0N7RAC71",
"createdBy": "szhang",
"createdDate": "2022-02-05T13:31:30Z",
"datasetFields": [
{
"datasetFieldId": 1000,
"datasetFieldJsonKey": "cp",
"datasetFieldName": "CP code"
},
{
"datasetFieldId": 1002,
"datasetFieldJsonKey": "reqId",
"datasetFieldName": "Request ID"
},
{
"datasetFieldId": 1023,
"datasetFieldJsonKey": "cookie",
"datasetFieldName": "Cookie"
}
],
"deliveryConfiguration": {
"fieldDelimiter": "SPACE",
"format": "STRUCTURED",
"frequency": {
"intervalInSeconds": 30
},
"uploadFilePrefix": "logs",
"uploadFileSuffix": "ds"
},
"destination": {
"bucket": "datastream.akamai.com",
"destinationType": "S3",
"displayName": "S3Destination",
"path": "ds2-logs",
"region": "ap-south-1"
},
"groupId": 54321,
"latestVersion": 2,
"modifiedBy": "mrossi",
"modifiedDate": "2022-02-05T13:31:30Z",
"notificationEmails": [
"useremail1@domain.com",
"useremail2@domain.com"
],
"productId": "Dynamic_Site_Accelerator",
"properties": [
{
"propertyId": 349772,
"propertyName": "example.com"
},
{
"propertyId": 349770,
"propertyName": "example.akamai.com"
}
],
"streamId": 7050,
"streamName": "diagnostics-log-stream",
"streamStatus": "ACTIVATING",
"streamVersion": 1
}
] |
Curl
curl -X GET 'https://undefined/datastream-config-api/v2/log/streams/:streamId/history?startVersion=&endVersion=' -H 'Accept: application/json'
ENDPOINTS