This feature allows AWS Synthetics customers to provide code dependencies using lambda layer while creating a canary

Author: aws-sdk-dotnet-automation

generator/ServiceModels/synthetics/synthetics-2017-10-11.api.json

@@ -461,14 +461,16 @@
         "S3Key":{"shape":"String"},
         "S3Version":{"shape":"String"},
         "ZipFile":{"shape":"Blob"},
-        "Handler":{"shape":"CodeHandler"}
+        "Handler":{"shape":"CodeHandler"},
+        "Dependencies":{"shape":"Dependencies"}
       }
     },
     "CanaryCodeOutput":{
       "type":"structure",
       "members":{
         "SourceLocationArn":{"shape":"String"},
-        "Handler":{"shape":"String"}
+        "Handler":{"shape":"String"},
+        "Dependencies":{"shape":"Dependencies"}
       }
     },
     "CanaryDryRunConfigOutput":{
@@ -727,6 +729,24 @@
       "type":"structure",
       "members":{}
     },
+    "Dependencies":{
+      "type":"list",
+      "member":{"shape":"Dependency"},
+      "max":1,
+      "min":0
+    },
+    "Dependency":{
+      "type":"structure",
+      "required":["Reference"],
+      "members":{
+        "Type":{"shape":"DependencyType"},
+        "Reference":{"shape":"String"}
+      }
+    },
+    "DependencyType":{
+      "type":"string",
+      "enum":["LambdaLayer"]
+    },
     "DescribeCanariesLastRunNameFilter":{
       "type":"list",
       "member":{"shape":"CanaryName"},

generator/ServiceModels/synthetics/synthetics-2017-10-11.docs.json

@@ -295,6 +295,25 @@
       "base": null,
       "refs": {}
     },
+    "Dependencies": {
+      "base": null,
+      "refs": {
+        "CanaryCodeInput$Dependencies": "<p>A list of dependencies that should be used for running this canary. Specify the dependencies as a key-value pair, where the key is the type of dependency and the value is the dependency reference.</p>",
+        "CanaryCodeOutput$Dependencies": "<p>A list of dependencies that are used for running this canary. The dependencies are specified as a key-value pair, where the key is the type of dependency and the value is the dependency reference.</p>"
+      }
+    },
+    "Dependency": {
+      "base": "<p>A structure that contains information about a dependency for a canary.</p>",
+      "refs": {
+        "Dependencies$member": null
+      }
+    },
+    "DependencyType": {
+      "base": null,
+      "refs": {
+        "Dependency$Type": "<p>The type of dependency. Valid value is <code>LambdaLayer</code>.</p>"
+      }
+    },
     "DescribeCanariesLastRunNameFilter": {
       "base": null,
       "refs": {
@@ -748,6 +767,7 @@
         "CanaryStatus$StateReason": "<p>If the canary creation or update failed, this field provides details on the failure.</p>",
         "CreateCanaryRequest$ArtifactS3Location": "<p>The location in Amazon S3 where Synthetics stores artifacts from the test runs of this canary. Artifacts include the log file, screenshots, and HAR files. The name of the Amazon S3 bucket can't include a period (.).</p>",
         "CreateCanaryRequest$RuntimeVersion": "<p>Specifies the runtime version to use for the canary. For a list of valid runtime versions and more information about runtime versions, see <a href=\"https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_Library.html\"> Canary Runtime Versions</a>.</p>",
+        "Dependency$Reference": "<p>The dependency reference. For Lambda layers, this is the ARN of the Lambda layer. For more information about Lambda ARN format, see <a href=\"https://docs.aws.amazon.com/lambda/latest/api/API_Layer.html\">Lambda</a>.</p>",
         "DryRunConfigOutput$LastDryRunExecutionStatus": "<p>Returns the last execution status for a canary's dry run.</p>",
         "Group$Id": "<p>The unique ID of the group.</p>",
         "GroupSummary$Id": "<p>The unique ID of the group.</p>",

generator/ServiceModels/synthetics/synthetics-2017-10-11.normal.json

@@ -568,6 +568,10 @@
         "Handler":{
           "shape":"CodeHandler",
           "documentation":"<p>The entry point to use for the source code when running the canary. For canaries that use the <code>syn-python-selenium-1.0</code> runtime or a <code>syn-nodejs.puppeteer</code> runtime earlier than <code>syn-nodejs.puppeteer-3.4</code>, the handler must be specified as <code> <i>fileName</i>.handler</code>. For <code>syn-python-selenium-1.1</code>, <code>syn-nodejs.puppeteer-3.4</code>, and later runtimes, the handler can be specified as <code> <i>fileName</i>.<i>functionName</i> </code>, or you can specify a folder where canary scripts reside as <code> <i>folder</i>/<i>fileName</i>.<i>functionName</i> </code>.</p>"
+        },
+        "Dependencies":{
+          "shape":"Dependencies",
+          "documentation":"<p>A list of dependencies that should be used for running this canary. Specify the dependencies as a key-value pair, where the key is the type of dependency and the value is the dependency reference.</p>"
         }
       },
       "documentation":"<p>Use this structure to input your script code for the canary. This structure contains the Lambda handler with the location where the canary should start running the script. If the script is stored in an Amazon S3 bucket, the bucket name, key, and version are also included. If the script was passed into the canary directly, the script code is contained in the value of <code>Zipfile</code>. </p> <p>If you are uploading your canary scripts with an Amazon S3 bucket, your zip file should include your script in a certain folder structure.</p> <ul> <li> <p>For Node.js canaries, the folder structure must be <code>nodejs/node_modules/<i>myCanaryFilename.js</i> </code> For more information, see <a href=\"https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_WritingCanary_Nodejs.html#CloudWatch_Synthetics_Canaries_package\">Packaging your Node.js canary files</a> </p> </li> <li> <p>For Python canaries, the folder structure must be <code>python/<i>myCanaryFilename.py</i> </code> or <code>python/<i>myFolder/myCanaryFilename.py</i> </code> For more information, see <a href=\"https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_WritingCanary_Python.html#CloudWatch_Synthetics_Canaries_WritingCanary_Python_package\">Packaging your Python canary files</a> </p> </li> </ul>"
@@ -582,6 +586,10 @@
         "Handler":{
           "shape":"String",
           "documentation":"<p>The entry point to use for the source code when running the canary.</p>"
+        },
+        "Dependencies":{
+          "shape":"Dependencies",
+          "documentation":"<p>A list of dependencies that are used for running this canary. The dependencies are specified as a key-value pair, where the key is the type of dependency and the value is the dependency reference.</p>"
         }
       },
       "documentation":"<p>This structure contains information about the canary's Lambda handler and where its code is stored by CloudWatch Synthetics.</p>"
@@ -1031,6 +1039,31 @@
       "type":"structure",
       "members":{}
     },
+    "Dependencies":{
+      "type":"list",
+      "member":{"shape":"Dependency"},
+      "max":1,
+      "min":0
+    },
+    "Dependency":{
+      "type":"structure",
+      "required":["Reference"],
+      "members":{
+        "Type":{
+          "shape":"DependencyType",
+          "documentation":"<p>The type of dependency. Valid value is <code>LambdaLayer</code>.</p>"
+        },
+        "Reference":{
+          "shape":"String",
+          "documentation":"<p>The dependency reference. For Lambda layers, this is the ARN of the Lambda layer. For more information about Lambda ARN format, see <a href=\"https://docs.aws.amazon.com/lambda/latest/api/API_Layer.html\">Lambda</a>.</p>"
+        }
+      },
+      "documentation":"<p>A structure that contains information about a dependency for a canary.</p>"
+    },
+    "DependencyType":{
+      "type":"string",
+      "enum":["LambdaLayer"]
+    },
     "DescribeCanariesLastRunNameFilter":{
       "type":"list",
       "member":{"shape":"CanaryName"},

sdk/code-analysis/ServiceAnalysis/Synthetics/Generated/PropertyValueRules.xml

@@ -491,6 +491,11 @@
     <min>1</min>
     <max>1024</max>
   </property-value-rule>
+  <property-value-rule>
+    <property>Amazon.Synthetics.Model.Dependency.Reference</property>
+    <min>1</min>
+    <max>1024</max>
+  </property-value-rule>
   <property-value-rule>
     <property>Amazon.Synthetics.Model.DryRunConfigOutput.DryRunId</property>
     <pattern>^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$</pattern>

sdk/src/Services/Synthetics/Generated/Model/CanaryCodeInput.cs

@@ -58,12 +58,39 @@ namespace Amazon.Synthetics.Model
     /// </summary>
     public partial class CanaryCodeInput
     {
+        private List<Dependency> _dependencies = AWSConfigs.InitializeCollections ? new List<Dependency>() : null;
         private string _handler;
         private string _s3Bucket;
         private string _s3Key;
         private string _s3Version;
         private MemoryStream _zipFile;
 
+        /// <summary>
+        /// Gets and sets the property Dependencies. 
+        /// <para>
+        /// A list of dependencies that should be used for running this canary. Specify the dependencies
+        /// as a key-value pair, where the key is the type of dependency and the value is the
+        /// dependency reference.
+        /// </para>
+        /// <para />
+        /// Starting with version 4 of the SDK this property will default to null. If no data for this property is returned
+        /// from the service the property will also be null. This was changed to improve performance and allow the SDK and caller
+        /// to distinguish between a property not set or a property being empty to clear out a value. To retain the previous
+        /// SDK behavior set the AWSConfigs.InitializeCollections static property to true.
+        /// </summary>
+        [AWSProperty(Min=0, Max=1)]
+        public List<Dependency> Dependencies
+        {
+            get { return this._dependencies; }
+            set { this._dependencies = value; }
+        }
+
+        // Check to see if Dependencies property is set
+        internal bool IsSetDependencies()
+        {
+            return this._dependencies != null && (this._dependencies.Count > 0 || !AWSConfigs.InitializeCollections); 
+        }
+
         /// <summary>
         /// Gets and sets the property Handler. 
         /// <para>

sdk/src/Services/Synthetics/Generated/Model/CanaryCodeOutput.cs

@@ -35,9 +35,36 @@ namespace Amazon.Synthetics.Model
     /// </summary>
     public partial class CanaryCodeOutput
     {
+        private List<Dependency> _dependencies = AWSConfigs.InitializeCollections ? new List<Dependency>() : null;
         private string _handler;
         private string _sourceLocationArn;
 
+        /// <summary>
+        /// Gets and sets the property Dependencies. 
+        /// <para>
+        /// A list of dependencies that are used for running this canary. The dependencies are
+        /// specified as a key-value pair, where the key is the type of dependency and the value
+        /// is the dependency reference.
+        /// </para>
+        /// <para />
+        /// Starting with version 4 of the SDK this property will default to null. If no data for this property is returned
+        /// from the service the property will also be null. This was changed to improve performance and allow the SDK and caller
+        /// to distinguish between a property not set or a property being empty to clear out a value. To retain the previous
+        /// SDK behavior set the AWSConfigs.InitializeCollections static property to true.
+        /// </summary>
+        [AWSProperty(Min=0, Max=1)]
+        public List<Dependency> Dependencies
+        {
+            get { return this._dependencies; }
+            set { this._dependencies = value; }
+        }
+
+        // Check to see if Dependencies property is set
+        internal bool IsSetDependencies()
+        {
+            return this._dependencies != null && (this._dependencies.Count > 0 || !AWSConfigs.InitializeCollections); 
+        }
+
         /// <summary>
         /// Gets and sets the property Handler. 
         /// <para>

sdk/src/Services/Synthetics/Generated/Model/Dependency.cs

@@ -0,0 +1,79 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License").
+ * You may not use this file except in compliance with the License.
+ * A copy of the License is located at
+ * 
+ *  http://aws.amazon.com/apache2.0
+ * 
+ * or in the "license" file accompanying this file. This file is distributed
+ * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+ * express or implied. See the License for the specific language governing
+ * permissions and limitations under the License.
+ */
+
+/*
+ * Do not modify this file. This file is generated from the synthetics-2017-10-11.normal.json service model.
+ */
+using System;
+using System.Collections.Generic;
+using System.Xml.Serialization;
+using System.Text;
+using System.IO;
+using System.Net;
+
+using Amazon.Runtime;
+using Amazon.Runtime.Internal;
+
+#pragma warning disable CS0612,CS0618,CS1570
+namespace Amazon.Synthetics.Model
+{
+    /// <summary>
+    /// A structure that contains information about a dependency for a canary.
+    /// </summary>
+    public partial class Dependency
+    {
+        private string _reference;
+        private DependencyType _type;
+
+        /// <summary>
+        /// Gets and sets the property Reference. 
+        /// <para>
+        /// The dependency reference. For Lambda layers, this is the ARN of the Lambda layer.
+        /// For more information about Lambda ARN format, see <a href="https://docs.aws.amazon.com/lambda/latest/api/API_Layer.html">Lambda</a>.
+        /// </para>
+        /// </summary>
+        [AWSProperty(Required=true, Min=1, Max=1024)]
+        public string Reference
+        {
+            get { return this._reference; }
+            set { this._reference = value; }
+        }
+
+        // Check to see if Reference property is set
+        internal bool IsSetReference()
+        {
+            return this._reference != null;
+        }
+
+        /// <summary>
+        /// Gets and sets the property Type. 
+        /// <para>
+        /// The type of dependency. Valid value is <c>LambdaLayer</c>.
+        /// </para>
+        /// </summary>
+        public DependencyType Type
+        {
+            get { return this._type; }
+            set { this._type = value; }
+        }
+
+        // Check to see if Type property is set
+        internal bool IsSetType()
+        {
+            return this._type != null;
+        }
+
+    }
+}

sdk/src/Services/Synthetics/Generated/Model/Internal/MarshallTransformations/CanaryCodeInputMarshaller.cs

@@ -46,6 +46,22 @@ public void Marshall(CanaryCodeInput requestObject, JsonMarshallerContext contex
         {
             if(requestObject == null)
                 return;
+            if(requestObject.IsSetDependencies())
+            {
+                context.Writer.WritePropertyName("Dependencies");
+                context.Writer.WriteStartArray();
+                foreach(var requestObjectDependenciesListValue in requestObject.Dependencies)
+                {
+                    context.Writer.WriteStartObject();
+
+                    var marshaller = DependencyMarshaller.Instance;
+                    marshaller.Marshall(requestObjectDependenciesListValue, context);
+
+                    context.Writer.WriteEndObject();
+                }
+                context.Writer.WriteEndArray();
+            }
+
             if(requestObject.IsSetHandler())
             {
                 context.Writer.WritePropertyName("Handler");

sdk/src/Services/Synthetics/Generated/Model/Internal/MarshallTransformations/CanaryCodeOutputUnmarshaller.cs

@@ -56,6 +56,12 @@ public CanaryCodeOutput Unmarshall(JsonUnmarshallerContext context, ref Streamin
             int targetDepth = context.CurrentDepth;
             while (context.ReadAtDepth(targetDepth, ref reader))
             {
+                if (context.TestExpression("Dependencies", targetDepth))
+                {
+                    var unmarshaller = new JsonListUnmarshaller<Dependency, DependencyUnmarshaller>(DependencyUnmarshaller.Instance);
+                    unmarshalledObject.Dependencies = unmarshaller.Unmarshall(context, ref reader);
+                    continue;
+                }
                 if (context.TestExpression("Handler", targetDepth))
                 {
                     var unmarshaller = StringUnmarshaller.Instance;