From 5031e54e42288dd342897b38ae94a5d116d6d4a2 Mon Sep 17 00:00:00 2001 From: AWS <> Date: Mon, 3 Feb 2025 19:05:42 +0000 Subject: [PATCH] AWS MediaTailor Update: Add support for CloudWatch Vended Logs which allows for delivery of customer logs to CloudWatch Logs, S3, or Firehose. --- .../feature-AWSMediaTailor-bfe0de0.json | 6 ++++ .../codegen-resources/service-2.json | 33 ++++++++++++++++--- 2 files changed, 34 insertions(+), 5 deletions(-) create mode 100644 .changes/next-release/feature-AWSMediaTailor-bfe0de0.json diff --git a/.changes/next-release/feature-AWSMediaTailor-bfe0de0.json b/.changes/next-release/feature-AWSMediaTailor-bfe0de0.json new file mode 100644 index 00000000000..410bc1991ae --- /dev/null +++ b/.changes/next-release/feature-AWSMediaTailor-bfe0de0.json @@ -0,0 +1,6 @@ +{ + "type": "feature", + "category": "AWS MediaTailor", + "contributor": "", + "description": "Add support for CloudWatch Vended Logs which allows for delivery of customer logs to CloudWatch Logs, S3, or Firehose." +} diff --git a/services/mediatailor/src/main/resources/codegen-resources/service-2.json b/services/mediatailor/src/main/resources/codegen-resources/service-2.json index 0366d86d89d..ba2350b7a31 100644 --- a/services/mediatailor/src/main/resources/codegen-resources/service-2.json +++ b/services/mediatailor/src/main/resources/codegen-resources/service-2.json @@ -611,7 +611,7 @@ "members":{ "StreamingMediaFileConditioning":{ "shape":"StreamingMediaFileConditioning", - "documentation":"

For ads that have media files with streaming delivery, indicates what transcoding action MediaTailor it first receives these ads from the ADS. TRANSCODE indicates that MediaTailor must transcode the ads. NONE indicates that you have already transcoded the ads outside of MediaTailor and don't need them transcoded as part of the ad insertion workflow. For more information about ad conditioning see https://docs.aws.amazon.com/precondition-ads.html.

" + "documentation":"

For ads that have media files with streaming delivery and supported file extensions, indicates what transcoding action MediaTailor takes when it first receives these ads from the ADS. TRANSCODE indicates that MediaTailor must transcode the ads. NONE indicates that you have already transcoded the ads outside of MediaTailor and don't need them transcoded as part of the ad insertion workflow. For more information about ad conditioning see https://docs.aws.amazon.com/precondition-ads.html.

" } }, "documentation":"

The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns.

" @@ -957,6 +957,10 @@ "PlaybackConfigurationName":{ "shape":"__string", "documentation":"

The name of the playback configuration.

" + }, + "EnabledLoggingStrategies":{ + "shape":"__listOfLoggingStrategies", + "documentation":"

The method used for collecting logs from AWS Elemental MediaTailor. To configure MediaTailor to send logs directly to Amazon CloudWatch Logs, choose LEGACY_CLOUDWATCH. To configure MediaTailor to send logs to CloudWatch, which then vends the logs to your destination of choice, choose VENDED_LOGS. Supported destinations are CloudWatch Logs log group, Amazon S3 bucket, and Amazon Data Firehose stream.

To use vended logs, you must configure the delivery destination in Amazon CloudWatch, as described in Enable logging from AWS services, Logging that requires additional permissions [V2].

" } }, "documentation":"

Configures Amazon CloudWatch log settings for a playback configuration.

" @@ -972,6 +976,10 @@ "PlaybackConfigurationName":{ "shape":"__string", "documentation":"

The name of the playback configuration.

" + }, + "EnabledLoggingStrategies":{ + "shape":"__listOfLoggingStrategies", + "documentation":"

The method used for collecting logs from AWS Elemental MediaTailor. LEGACY_CLOUDWATCH indicates that MediaTailor is sending logs directly to Amazon CloudWatch Logs. VENDED_LOGS indicates that MediaTailor is sending logs to CloudWatch, which then vends the logs to your destination of choice. Supported destinations are CloudWatch Logs log group, Amazon S3 bucket, and Amazon Data Firehose stream.

" } } }, @@ -2170,7 +2178,7 @@ }, "AdConditioningConfiguration":{ "shape":"AdConditioningConfiguration", - "documentation":"

The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns.

" + "documentation":"

The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns, and what priority MediaTailor uses when inserting ads.

" } } }, @@ -2639,6 +2647,10 @@ "PercentEnabled":{ "shape":"__integer", "documentation":"

The percentage of session logs that MediaTailor sends to your configured log destination. For example, if your playback configuration has 1000 sessions and percentEnabled is set to 60, MediaTailor sends logs for 600 of the sessions to CloudWatch Logs. MediaTailor decides at random which of the playback configuration sessions to send logs for. If you want to view logs for a specific session, you can use the debug log mode.

Valid values: 0 - 100

" + }, + "EnabledLoggingStrategies":{ + "shape":"__listOfLoggingStrategies", + "documentation":"

The method used for collecting logs from AWS Elemental MediaTailor. LEGACY_CLOUDWATCH indicates that MediaTailor is sending logs directly to Amazon CloudWatch Logs. VENDED_LOGS indicates that MediaTailor is sending logs to CloudWatch, which then vends the logs to your destination of choice. Supported destinations are CloudWatch Logs log group, Amazon S3 bucket, and Amazon Data Firehose stream.

" } }, "documentation":"

Defines where AWS Elemental MediaTailor sends logs for the playback configuration.

" @@ -2661,6 +2673,13 @@ "type":"list", "member":{"shape":"LogType"} }, + "LoggingStrategy":{ + "type":"string", + "enum":[ + "VENDED_LOGS", + "LEGACY_CLOUDWATCH" + ] + }, "Long":{ "type":"long", "box":true @@ -2793,7 +2812,7 @@ }, "AdConditioningConfiguration":{ "shape":"AdConditioningConfiguration", - "documentation":"

The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns.

" + "documentation":"

The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns, and what priority MediaTailor uses when inserting ads.

" } }, "documentation":"

A playback configuration. For information about MediaTailor configurations, see Working with configurations in AWS Elemental MediaTailor.

" @@ -2971,7 +2990,7 @@ }, "AdConditioningConfiguration":{ "shape":"AdConditioningConfiguration", - "documentation":"

The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns.

" + "documentation":"

The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns, and what priority MediaTailor uses when inserting ads.

" } } }, @@ -3061,7 +3080,7 @@ }, "AdConditioningConfiguration":{ "shape":"AdConditioningConfiguration", - "documentation":"

The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns.

" + "documentation":"

The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns, and what priority MediaTailor uses when inserting ads.

" } } }, @@ -4026,6 +4045,10 @@ "type":"list", "member":{"shape":"LiveSource"} }, + "__listOfLoggingStrategies":{ + "type":"list", + "member":{"shape":"LoggingStrategy"} + }, "__listOfPlaybackConfiguration":{ "type":"list", "member":{"shape":"PlaybackConfiguration"}