feat(client-mediatailor): Add support for CloudWatch Vended Logs which allows for delivery of customer logs to CloudWatch Logs, S3, or Firehose.

Author: awstools

clients/client-mediatailor/src/commands/ConfigureLogsForPlaybackConfigurationCommand.ts

@@ -47,12 +47,18 @@ export interface ConfigureLogsForPlaybackConfigurationCommandOutput
  * const input = { // ConfigureLogsForPlaybackConfigurationRequest
  *   PercentEnabled: Number("int"), // required
  *   PlaybackConfigurationName: "STRING_VALUE", // required
+ *   EnabledLoggingStrategies: [ // __listOfLoggingStrategies
+ *     "VENDED_LOGS" || "LEGACY_CLOUDWATCH",
+ *   ],
  * };
  * const command = new ConfigureLogsForPlaybackConfigurationCommand(input);
  * const response = await client.send(command);
  * // { // ConfigureLogsForPlaybackConfigurationResponse
  * //   PercentEnabled: Number("int"), // required
  * //   PlaybackConfigurationName: "STRING_VALUE",
+ * //   EnabledLoggingStrategies: [ // __listOfLoggingStrategies
+ * //     "VENDED_LOGS" || "LEGACY_CLOUDWATCH",
+ * //   ],
  * // };
  *
  * ```

clients/client-mediatailor/src/commands/GetPlaybackConfigurationCommand.ts

@@ -75,6 +75,9 @@ export interface GetPlaybackConfigurationCommandOutput extends GetPlaybackConfig
  * //   },
  * //   LogConfiguration: { // LogConfiguration
  * //     PercentEnabled: Number("int"), // required
+ * //     EnabledLoggingStrategies: [ // __listOfLoggingStrategies
+ * //       "VENDED_LOGS" || "LEGACY_CLOUDWATCH",
+ * //     ],
  * //   },
  * //   ManifestProcessingRules: { // ManifestProcessingRules
  * //     AdMarkerPassthrough: { // AdMarkerPassthrough

clients/client-mediatailor/src/commands/ListPlaybackConfigurationsCommand.ts

@@ -78,6 +78,9 @@ export interface ListPlaybackConfigurationsCommandOutput extends ListPlaybackCon
  * //       },
  * //       LogConfiguration: { // LogConfiguration
  * //         PercentEnabled: Number("int"), // required
+ * //         EnabledLoggingStrategies: [ // __listOfLoggingStrategies
+ * //           "VENDED_LOGS" || "LEGACY_CLOUDWATCH",
+ * //         ],
  * //       },
  * //       ManifestProcessingRules: { // ManifestProcessingRules
  * //         AdMarkerPassthrough: { // AdMarkerPassthrough

clients/client-mediatailor/src/commands/PutPlaybackConfigurationCommand.ts

@@ -118,6 +118,9 @@ export interface PutPlaybackConfigurationCommandOutput extends PutPlaybackConfig
  * //   },
  * //   LogConfiguration: { // LogConfiguration
  * //     PercentEnabled: Number("int"), // required
+ * //     EnabledLoggingStrategies: [ // __listOfLoggingStrategies
+ * //       "VENDED_LOGS" || "LEGACY_CLOUDWATCH",
+ * //     ],
  * //   },
  * //   ManifestProcessingRules: { // ManifestProcessingRules
  * //     AdMarkerPassthrough: { // AdMarkerPassthrough

clients/client-mediatailor/src/models/models_0.ts

@@ -666,6 +666,20 @@ export interface LiveSource {
   Tags?: Record<string, string> | undefined;
 }
 
+/**
+ * @public
+ * @enum
+ */
+export const LoggingStrategy = {
+  LEGACY_CLOUDWATCH: "LEGACY_CLOUDWATCH",
+  VENDED_LOGS: "VENDED_LOGS",
+} as const;
+
+/**
+ * @public
+ */
+export type LoggingStrategy = (typeof LoggingStrategy)[keyof typeof LoggingStrategy];
+
 /**
  * @public
  * @enum
@@ -687,7 +701,10 @@ export type StreamingMediaFileConditioning =
  */
 export interface AdConditioningConfiguration {
   /**
-   * <p>For ads that have media files with streaming delivery, indicates what transcoding action MediaTailor it first receives these ads from the ADS. <code>TRANSCODE</code> indicates that MediaTailor must transcode the ads. <code>NONE</code> 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 <a href="https://docs.aws.amazon.com/precondition-ads.html">https://docs.aws.amazon.com/precondition-ads.html</a>.</p>
+   * <p>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.
+   *             <code>TRANSCODE</code> indicates that MediaTailor must transcode the ads.
+   *             <code>NONE</code> 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 <a href="https://docs.aws.amazon.com/precondition-ads.html">https://docs.aws.amazon.com/precondition-ads.html</a>.</p>
    * @public
    */
   StreamingMediaFileConditioning: StreamingMediaFileConditioning | undefined;
@@ -876,6 +893,12 @@ export interface LogConfiguration {
    * @public
    */
   PercentEnabled: number | undefined;
+
+  /**
+   * <p>The method used for collecting logs from AWS Elemental MediaTailor. <code>LEGACY_CLOUDWATCH</code> indicates that MediaTailor is sending logs directly to Amazon CloudWatch Logs. <code>VENDED_LOGS</code> 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. </p>
+   * @public
+   */
+  EnabledLoggingStrategies?: LoggingStrategy[] | undefined;
 }
 
 /**
@@ -1030,7 +1053,7 @@ export interface PlaybackConfiguration {
   VideoContentSourceUrl?: string | undefined;
 
   /**
-   * <p>The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns.</p>
+   * <p>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.</p>
    * @public
    */
   AdConditioningConfiguration?: AdConditioningConfiguration | undefined;
@@ -2669,6 +2692,14 @@ export interface ConfigureLogsForPlaybackConfigurationRequest {
    * @public
    */
   PlaybackConfigurationName: string | undefined;
+
+  /**
+   * <p>The method used for collecting logs from AWS Elemental MediaTailor. To configure MediaTailor to send logs directly to Amazon CloudWatch Logs, choose <code>LEGACY_CLOUDWATCH</code>. To configure MediaTailor to
+   *             send logs to CloudWatch, which then vends the logs to your destination of choice, choose <code>VENDED_LOGS</code>. Supported destinations are CloudWatch Logs log group, Amazon S3 bucket, and Amazon Data Firehose stream.</p>
+   *          <p>To use vended logs, you must configure the delivery destination in Amazon CloudWatch, as described in <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-vended-logs-permissions-V2">Enable logging from AWS services, Logging that requires additional permissions [V2]</a>.</p>
+   * @public
+   */
+  EnabledLoggingStrategies?: LoggingStrategy[] | undefined;
 }
 
 /**
@@ -2686,6 +2717,12 @@ export interface ConfigureLogsForPlaybackConfigurationResponse {
    * @public
    */
   PlaybackConfigurationName?: string | undefined;
+
+  /**
+   * <p>The method used for collecting logs from AWS Elemental MediaTailor. <code>LEGACY_CLOUDWATCH</code> indicates that MediaTailor is sending logs directly to Amazon CloudWatch Logs. <code>VENDED_LOGS</code> 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. </p>
+   * @public
+   */
+  EnabledLoggingStrategies?: LoggingStrategy[] | undefined;
 }
 
 /**
@@ -3472,7 +3509,7 @@ export interface GetPlaybackConfigurationResponse {
   VideoContentSourceUrl?: string | undefined;
 
   /**
-   * <p>The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns. </p>
+   * <p>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. </p>
    * @public
    */
   AdConditioningConfiguration?: AdConditioningConfiguration | undefined;
@@ -3960,7 +3997,7 @@ export interface PutPlaybackConfigurationRequest {
   VideoContentSourceUrl?: string | undefined;
 
   /**
-   * <p>The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns.</p>
+   * <p>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. </p>
    * @public
    */
   AdConditioningConfiguration?: AdConditioningConfiguration | undefined;
@@ -4091,7 +4128,7 @@ export interface PutPlaybackConfigurationResponse {
   VideoContentSourceUrl?: string | undefined;
 
   /**
-   * <p>The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns.</p>
+   * <p>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. </p>
    * @public
    */
   AdConditioningConfiguration?: AdConditioningConfiguration | undefined;

clients/client-mediatailor/src/protocols/Aws_restJson1.ts

@@ -146,6 +146,7 @@ import {
   KeyValuePair,
   LivePreRollConfiguration,
   LiveSource,
+  LoggingStrategy,
   LogType,
   ManifestProcessingRules,
   PlaybackConfiguration,
@@ -208,6 +209,7 @@ export const se_ConfigureLogsForPlaybackConfigurationCommand = async (
   let body: any;
   body = JSON.stringify(
     take(input, {
+      EnabledLoggingStrategies: (_) => _json(_),
       PercentEnabled: [],
       PlaybackConfigurationName: [],
     })
@@ -1118,6 +1120,7 @@ export const de_ConfigureLogsForPlaybackConfigurationCommand = async (
   });
   const data: Record<string, any> = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
   const doc = take(data, {
+    EnabledLoggingStrategies: _json,
     PercentEnabled: __expectInt32,
     PlaybackConfigurationName: __expectString,
   });
@@ -2190,6 +2193,8 @@ const de_BadRequestExceptionRes = async (parsedOutput: any, context: __SerdeCont
 
 // se___listOfAvailMatchingCriteria omitted.
 
+// se___listOfLoggingStrategies omitted.
+
 // se___listOfSegmentDeliveryConfiguration omitted.
 
 // se___mapOf__string omitted.
@@ -2342,6 +2347,8 @@ const de___listOfLiveSource = (output: any, context: __SerdeContext): LiveSource
   return retVal;
 };
 
+// de___listOfLoggingStrategies omitted.
+
 /**
  * deserializeAws_restJson1__listOfPlaybackConfiguration
  */

codegen/sdk-codegen/aws-models/mediatailor.json

@@ -127,7 +127,7 @@
         "StreamingMediaFileConditioning": {
           "target": "com.amazonaws.mediatailor#StreamingMediaFileConditioning",
           "traits": {
-            "smithy.api#documentation": "<p>For ads that have media files with streaming delivery, indicates what transcoding action MediaTailor it first receives these ads from the ADS. <code>TRANSCODE</code> indicates that MediaTailor must transcode the ads. <code>NONE</code> 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 <a href=\"https://docs.aws.amazon.com/precondition-ads.html\">https://docs.aws.amazon.com/precondition-ads.html</a>.</p>",
+            "smithy.api#documentation": "<p>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. \n            <code>TRANSCODE</code> indicates that MediaTailor must transcode the ads. \n            <code>NONE</code> indicates that you have already transcoded the ads outside of MediaTailor and don't need them transcoded as part of the ad insertion workflow. \n            For more information about ad conditioning see <a href=\"https://docs.aws.amazon.com/precondition-ads.html\">https://docs.aws.amazon.com/precondition-ads.html</a>.</p>",
             "smithy.api#required": {}
           }
         }
@@ -754,6 +754,12 @@
             "smithy.api#documentation": "<p>The name of the playback configuration.</p>",
             "smithy.api#required": {}
           }
+        },
+        "EnabledLoggingStrategies": {
+          "target": "com.amazonaws.mediatailor#__listOfLoggingStrategies",
+          "traits": {
+            "smithy.api#documentation": "<p>The method used for collecting logs from AWS Elemental MediaTailor. To configure MediaTailor to send logs directly to Amazon CloudWatch Logs, choose <code>LEGACY_CLOUDWATCH</code>. To configure MediaTailor to \n            send logs to CloudWatch, which then vends the logs to your destination of choice, choose <code>VENDED_LOGS</code>. Supported destinations are CloudWatch Logs log group, Amazon S3 bucket, and Amazon Data Firehose stream.</p>\n         <p>To use vended logs, you must configure the delivery destination in Amazon CloudWatch, as described in <a href=\"https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-vended-logs-permissions-V2\">Enable logging from AWS services, Logging that requires additional permissions [V2]</a>.</p>"
+          }
         }
       },
       "traits": {
@@ -776,6 +782,12 @@
           "traits": {
             "smithy.api#documentation": "<p>The name of the playback configuration.</p>"
           }
+        },
+        "EnabledLoggingStrategies": {
+          "target": "com.amazonaws.mediatailor#__listOfLoggingStrategies",
+          "traits": {
+            "smithy.api#documentation": "<p>The method used for collecting logs from AWS Elemental MediaTailor. <code>LEGACY_CLOUDWATCH</code> indicates that MediaTailor is sending logs directly to Amazon CloudWatch Logs. <code>VENDED_LOGS</code> 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. </p>"
+          }
         }
       }
     },
@@ -2731,7 +2743,7 @@
         "AdConditioningConfiguration": {
           "target": "com.amazonaws.mediatailor#AdConditioningConfiguration",
           "traits": {
-            "smithy.api#documentation": "<p>The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns. </p>"
+            "smithy.api#documentation": "<p>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. </p>"
           }
         }
       }
@@ -3575,6 +3587,12 @@
             "smithy.api#documentation": "<p>The percentage of session logs that MediaTailor sends to your configured log destination. For example, if your playback configuration has 1000 sessions and <code>percentEnabled</code> is set to <code>60</code>, 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 <a href=\"https://docs.aws.amazon.com/mediatailor/latest/ug/debug-log-mode.html\">debug log mode</a>.</p>\n         <p>Valid values: <code>0</code> - <code>100</code>\n         </p>",
             "smithy.api#required": {}
           }
+        },
+        "EnabledLoggingStrategies": {
+          "target": "com.amazonaws.mediatailor#__listOfLoggingStrategies",
+          "traits": {
+            "smithy.api#documentation": "<p>The method used for collecting logs from AWS Elemental MediaTailor. <code>LEGACY_CLOUDWATCH</code> indicates that MediaTailor is sending logs directly to Amazon CloudWatch Logs. <code>VENDED_LOGS</code> 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. </p>"
+          }
         }
       },
       "traits": {
@@ -3612,6 +3630,23 @@
         "target": "com.amazonaws.mediatailor#LogType"
       }
     },
+    "com.amazonaws.mediatailor#LoggingStrategy": {
+      "type": "enum",
+      "members": {
+        "VENDED_LOGS": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "VENDED_LOGS"
+          }
+        },
+        "LEGACY_CLOUDWATCH": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "LEGACY_CLOUDWATCH"
+          }
+        }
+      }
+    },
     "com.amazonaws.mediatailor#ManifestProcessingRules": {
       "type": "structure",
       "members": {
@@ -4617,7 +4652,7 @@
         "AdConditioningConfiguration": {
           "target": "com.amazonaws.mediatailor#AdConditioningConfiguration",
           "traits": {
-            "smithy.api#documentation": "<p>The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns.</p>"
+            "smithy.api#documentation": "<p>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.</p>"
           }
         }
       },
@@ -4997,7 +5032,7 @@
         "AdConditioningConfiguration": {
           "target": "com.amazonaws.mediatailor#AdConditioningConfiguration",
           "traits": {
-            "smithy.api#documentation": "<p>The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns.</p>"
+            "smithy.api#documentation": "<p>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. </p>"
           }
         }
       }
@@ -5130,7 +5165,7 @@
         "AdConditioningConfiguration": {
           "target": "com.amazonaws.mediatailor#AdConditioningConfiguration",
           "traits": {
-            "smithy.api#documentation": "<p>The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns.</p>"
+            "smithy.api#documentation": "<p>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. </p>"
           }
         }
       }
@@ -6717,6 +6752,12 @@
         "target": "com.amazonaws.mediatailor#LiveSource"
       }
     },
+    "com.amazonaws.mediatailor#__listOfLoggingStrategies": {
+      "type": "list",
+      "member": {
+        "target": "com.amazonaws.mediatailor#LoggingStrategy"
+      }
+    },
     "com.amazonaws.mediatailor#__listOfPlaybackConfiguration": {
       "type": "list",
       "member": {