aws-sdk-synthetics 1.17.0 → 1.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 841d69ff47a41905aeaf6264f227bcf55fc06f7cde8a5efecd5aa8b56cb0c2ca
-  data.tar.gz: d1d303cacbc3d727dbf50a002ba4109d7254482532dfff3c8abd3de921d0c3f2
+  metadata.gz: e6a2d323d4f8e8da87fbb96a21610cc0a1300301c775914314c312551997bd7d
+  data.tar.gz: 918bba5c29030af9c150989cded97852a6fe2e5e4860487607a23ca4eea69219
 SHA512:
-  metadata.gz: e59f452bfbce23183f1545d59817c06e1916a08bcac6e6a3d2eeb4cfb901f591b0288c263fcf31f207f314b6c90bb67b0105ef4fd13aa3d0fc35b519c82610e7
-  data.tar.gz: 646148537ca01d37221f2a149d0078800871f4b39ea0a63ef408e841892e3ddcd0c8941155034616aeebafa865d0097938b264581ad73fd96cf645de9d80386e
+  metadata.gz: e09c8cf6d4e40adff3aa2ee5821ad0ad93442f4b62180cc9de5ae36b970cfbb898a495251b450f274b231bfa847fc109a6e6cc42e91ac213b9b0f1cacf688caa
+  data.tar.gz: 024665774f9b40a8f060c8fbf681d625c36b1b1a14a1b84613ff92bfcce6293c97cf6316a6678fabf9ead00ff9844f304a5c90208cc12c989e2935aceb4081d4

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.18.0 (2021-10-01)
+------------------
+
+* Feature - CloudWatch Synthetics now enables customers to choose a customer managed AWS KMS key or an Amazon S3-managed key instead of an AWS managed key (default) for the encryption of artifacts that the canary stores in Amazon S3. CloudWatch Synthetics also supports artifact S3 location updation now.
+
 1.17.0 (2021-09-01)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.17.0
+1.18.0

data/lib/aws-sdk-synthetics/client.rb

@@ -441,6 +441,11 @@ module Aws::Synthetics
     #   use them to scope user permissions, by granting a user permission to
     #   access or change only the resources that have certain tag values.
     #
+    # @option params [Types::ArtifactConfigInput] :artifact_config
+    #   A structure that contains the configuration for canary artifacts,
+    #   including the encryption-at-rest settings for artifacts that the
+    #   canary uploads to Amazon S3.
+    #
     # @return [Types::CreateCanaryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateCanaryResponse#canary #canary} => Types::Canary
@@ -480,6 +485,12 @@ module Aws::Synthetics
     #     tags: {
     #       "TagKey" => "TagValue",
     #     },
+    #     artifact_config: {
+    #       s3_encryption: {
+    #         encryption_mode: "SSE_S3", # accepts SSE_S3, SSE_KMS
+    #         kms_key_arn: "KmsKeyArn",
+    #       },
+    #     },
     #   })
     #
     # @example Response structure
@@ -518,6 +529,8 @@ module Aws::Synthetics
     #   resp.canary.visual_reference.base_canary_run_id #=> String
     #   resp.canary.tags #=> Hash
     #   resp.canary.tags["TagKey"] #=> String
+    #   resp.canary.artifact_config.s3_encryption.encryption_mode #=> String, one of "SSE_S3", "SSE_KMS"
+    #   resp.canary.artifact_config.s3_encryption.kms_key_arn #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/synthetics-2017-10-11/CreateCanary AWS API Documentation
     #
@@ -649,6 +662,8 @@ module Aws::Synthetics
     #   resp.canaries[0].visual_reference.base_canary_run_id #=> String
     #   resp.canaries[0].tags #=> Hash
     #   resp.canaries[0].tags["TagKey"] #=> String
+    #   resp.canaries[0].artifact_config.s3_encryption.encryption_mode #=> String, one of "SSE_S3", "SSE_KMS"
+    #   resp.canaries[0].artifact_config.s3_encryption.kms_key_arn #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/synthetics-2017-10-11/DescribeCanaries AWS API Documentation
@@ -816,6 +831,8 @@ module Aws::Synthetics
     #   resp.canary.visual_reference.base_canary_run_id #=> String
     #   resp.canary.tags #=> Hash
     #   resp.canary.tags["TagKey"] #=> String
+    #   resp.canary.artifact_config.s3_encryption.encryption_mode #=> String, one of "SSE_S3", "SSE_KMS"
+    #   resp.canary.artifact_config.s3_encryption.kms_key_arn #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/synthetics-2017-10-11/GetCanary AWS API Documentation
     #
@@ -1146,6 +1163,16 @@ module Aws::Synthetics
     #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_SyntheticsLogger_VisualTesting.html
     #   [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_Blueprints_VisualTesting.html
     #
+    # @option params [String] :artifact_s3_location
+    #   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 S3 bucket can't include a period (.).
+    #
+    # @option params [Types::ArtifactConfigInput] :artifact_config
+    #   A structure that contains the configuration for canary artifacts,
+    #   including the encryption-at-rest settings for artifacts that the
+    #   canary uploads to Amazon S3.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -1188,6 +1215,13 @@ module Aws::Synthetics
     #       ],
     #       base_canary_run_id: "String", # required
     #     },
+    #     artifact_s3_location: "String",
+    #     artifact_config: {
+    #       s3_encryption: {
+    #         encryption_mode: "SSE_S3", # accepts SSE_S3, SSE_KMS
+    #         kms_key_arn: "KmsKeyArn",
+    #       },
+    #     },
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/synthetics-2017-10-11/UpdateCanary AWS API Documentation
@@ -1212,7 +1246,7 @@ module Aws::Synthetics
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-synthetics'
-      context[:gem_version] = '1.17.0'
+      context[:gem_version] = '1.18.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-synthetics/client_api.rb

@@ -13,6 +13,8 @@ module Aws::Synthetics
 
     include Seahorse::Model
 
+    ArtifactConfigInput = Shapes::StructureShape.new(name: 'ArtifactConfigInput')
+    ArtifactConfigOutput = Shapes::StructureShape.new(name: 'ArtifactConfigOutput')
     BaseScreenshot = Shapes::StructureShape.new(name: 'BaseScreenshot')
     BaseScreenshotConfigIgnoreCoordinate = Shapes::StringShape.new(name: 'BaseScreenshotConfigIgnoreCoordinate')
     BaseScreenshotIgnoreCoordinates = Shapes::ListShape.new(name: 'BaseScreenshotIgnoreCoordinates')
@@ -51,6 +53,7 @@ module Aws::Synthetics
     DescribeCanariesResponse = Shapes::StructureShape.new(name: 'DescribeCanariesResponse')
     DescribeRuntimeVersionsRequest = Shapes::StructureShape.new(name: 'DescribeRuntimeVersionsRequest')
     DescribeRuntimeVersionsResponse = Shapes::StructureShape.new(name: 'DescribeRuntimeVersionsResponse')
+    EncryptionMode = Shapes::StringShape.new(name: 'EncryptionMode')
     EnvironmentVariableName = Shapes::StringShape.new(name: 'EnvironmentVariableName')
     EnvironmentVariableValue = Shapes::StringShape.new(name: 'EnvironmentVariableValue')
     EnvironmentVariablesMap = Shapes::MapShape.new(name: 'EnvironmentVariablesMap')
@@ -61,6 +64,7 @@ module Aws::Synthetics
     GetCanaryRunsRequest = Shapes::StructureShape.new(name: 'GetCanaryRunsRequest')
     GetCanaryRunsResponse = Shapes::StructureShape.new(name: 'GetCanaryRunsResponse')
     InternalServerException = Shapes::StructureShape.new(name: 'InternalServerException')
+    KmsKeyArn = Shapes::StringShape.new(name: 'KmsKeyArn')
     ListTagsForResourceRequest = Shapes::StructureShape.new(name: 'ListTagsForResourceRequest')
     ListTagsForResourceResponse = Shapes::StructureShape.new(name: 'ListTagsForResourceResponse')
     MaxCanaryResults = Shapes::IntegerShape.new(name: 'MaxCanaryResults')
@@ -74,6 +78,7 @@ module Aws::Synthetics
     RoleArn = Shapes::StringShape.new(name: 'RoleArn')
     RuntimeVersion = Shapes::StructureShape.new(name: 'RuntimeVersion')
     RuntimeVersionList = Shapes::ListShape.new(name: 'RuntimeVersionList')
+    S3EncryptionConfig = Shapes::StructureShape.new(name: 'S3EncryptionConfig')
     SecurityGroupId = Shapes::StringShape.new(name: 'SecurityGroupId')
     SecurityGroupIds = Shapes::ListShape.new(name: 'SecurityGroupIds')
     StartCanaryRequest = Shapes::StructureShape.new(name: 'StartCanaryRequest')
@@ -103,6 +108,12 @@ module Aws::Synthetics
     VpcConfigOutput = Shapes::StructureShape.new(name: 'VpcConfigOutput')
     VpcId = Shapes::StringShape.new(name: 'VpcId')
 
+    ArtifactConfigInput.add_member(:s3_encryption, Shapes::ShapeRef.new(shape: S3EncryptionConfig, location_name: "S3Encryption"))
+    ArtifactConfigInput.struct_class = Types::ArtifactConfigInput
+
+    ArtifactConfigOutput.add_member(:s3_encryption, Shapes::ShapeRef.new(shape: S3EncryptionConfig, location_name: "S3Encryption"))
+    ArtifactConfigOutput.struct_class = Types::ArtifactConfigOutput
+
     BaseScreenshot.add_member(:screenshot_name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "ScreenshotName"))
     BaseScreenshot.add_member(:ignore_coordinates, Shapes::ShapeRef.new(shape: BaseScreenshotIgnoreCoordinates, location_name: "IgnoreCoordinates"))
     BaseScreenshot.struct_class = Types::BaseScreenshot
@@ -131,6 +142,7 @@ module Aws::Synthetics
     Canary.add_member(:vpc_config, Shapes::ShapeRef.new(shape: VpcConfigOutput, location_name: "VpcConfig"))
     Canary.add_member(:visual_reference, Shapes::ShapeRef.new(shape: VisualReferenceOutput, location_name: "VisualReference"))
     Canary.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "Tags"))
+    Canary.add_member(:artifact_config, Shapes::ShapeRef.new(shape: ArtifactConfigOutput, location_name: "ArtifactConfig"))
     Canary.struct_class = Types::Canary
 
     CanaryCodeInput.add_member(:s3_bucket, Shapes::ShapeRef.new(shape: String, location_name: "S3Bucket"))
@@ -210,6 +222,7 @@ module Aws::Synthetics
     CreateCanaryRequest.add_member(:runtime_version, Shapes::ShapeRef.new(shape: String, required: true, location_name: "RuntimeVersion"))
     CreateCanaryRequest.add_member(:vpc_config, Shapes::ShapeRef.new(shape: VpcConfigInput, location_name: "VpcConfig"))
     CreateCanaryRequest.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "Tags"))
+    CreateCanaryRequest.add_member(:artifact_config, Shapes::ShapeRef.new(shape: ArtifactConfigInput, location_name: "ArtifactConfig"))
     CreateCanaryRequest.struct_class = Types::CreateCanaryRequest
 
     CreateCanaryResponse.add_member(:canary, Shapes::ShapeRef.new(shape: Canary, location_name: "Canary"))
@@ -282,6 +295,10 @@ module Aws::Synthetics
 
     RuntimeVersionList.member = Shapes::ShapeRef.new(shape: RuntimeVersion)
 
+    S3EncryptionConfig.add_member(:encryption_mode, Shapes::ShapeRef.new(shape: EncryptionMode, location_name: "EncryptionMode"))
+    S3EncryptionConfig.add_member(:kms_key_arn, Shapes::ShapeRef.new(shape: KmsKeyArn, location_name: "KmsKeyArn"))
+    S3EncryptionConfig.struct_class = Types::S3EncryptionConfig
+
     SecurityGroupIds.member = Shapes::ShapeRef.new(shape: SecurityGroupId)
 
     StartCanaryRequest.add_member(:name, Shapes::ShapeRef.new(shape: CanaryName, required: true, location: "uri", location_name: "name"))
@@ -323,6 +340,8 @@ module Aws::Synthetics
     UpdateCanaryRequest.add_member(:failure_retention_period_in_days, Shapes::ShapeRef.new(shape: MaxSize1024, location_name: "FailureRetentionPeriodInDays"))
     UpdateCanaryRequest.add_member(:vpc_config, Shapes::ShapeRef.new(shape: VpcConfigInput, location_name: "VpcConfig"))
     UpdateCanaryRequest.add_member(:visual_reference, Shapes::ShapeRef.new(shape: VisualReferenceInput, location_name: "VisualReference"))
+    UpdateCanaryRequest.add_member(:artifact_s3_location, Shapes::ShapeRef.new(shape: String, location_name: "ArtifactS3Location"))
+    UpdateCanaryRequest.add_member(:artifact_config, Shapes::ShapeRef.new(shape: ArtifactConfigInput, location_name: "ArtifactConfig"))
     UpdateCanaryRequest.struct_class = Types::UpdateCanaryRequest
 
     UpdateCanaryResponse.struct_class = Types::UpdateCanaryResponse

data/lib/aws-sdk-synthetics/types.rb

@@ -10,6 +10,58 @@
 module Aws::Synthetics
   module Types
 
+    # A structure that contains the configuration for canary artifacts,
+    # including the encryption-at-rest settings for artifacts that the
+    # canary uploads to Amazon S3.
+    #
+    # @note When making an API call, you may pass ArtifactConfigInput
+    #   data as a hash:
+    #
+    #       {
+    #         s3_encryption: {
+    #           encryption_mode: "SSE_S3", # accepts SSE_S3, SSE_KMS
+    #           kms_key_arn: "KmsKeyArn",
+    #         },
+    #       }
+    #
+    # @!attribute [rw] s3_encryption
+    #   A structure that contains the configuration of the
+    #   encryption-at-rest settings for artifacts that the canary uploads to
+    #   Amazon S3. Artifact encryption functionality is available only for
+    #   canaries that use Synthetics runtime version
+    #   syn-nodejs-puppeteer-3.3 or later. For more information, see
+    #   [Encrypting canary artifacts][1]
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_artifact_encryption.html
+    #   @return [Types::S3EncryptionConfig]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/synthetics-2017-10-11/ArtifactConfigInput AWS API Documentation
+    #
+    class ArtifactConfigInput < Struct.new(
+      :s3_encryption)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # A structure that contains the configuration for canary artifacts,
+    # including the encryption-at-rest settings for artifacts that the
+    # canary uploads to Amazon S3.
+    #
+    # @!attribute [rw] s3_encryption
+    #   A structure that contains the configuration of encryption settings
+    #   for canary artifacts that are stored in Amazon S3.
+    #   @return [Types::S3EncryptionConfig]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/synthetics-2017-10-11/ArtifactConfigOutput AWS API Documentation
+    #
+    class ArtifactConfigOutput < Struct.new(
+      :s3_encryption)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A structure representing a screenshot that is used as a baseline
     # during visual monitoring comparisons made by the canary.
     #
@@ -139,6 +191,12 @@ module Aws::Synthetics
     #   The list of key-value pairs that are associated with the canary.
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] artifact_config
+    #   A structure that contains the configuration for canary artifacts,
+    #   including the encryption-at-rest settings for artifacts that the
+    #   canary uploads to Amazon S3.
+    #   @return [Types::ArtifactConfigOutput]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/synthetics-2017-10-11/Canary AWS API Documentation
     #
     class Canary < Struct.new(
@@ -157,7 +215,8 @@ module Aws::Synthetics
       :runtime_version,
       :vpc_config,
       :visual_reference,
-      :tags)
+      :tags,
+      :artifact_config)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -642,6 +701,12 @@ module Aws::Synthetics
     #         tags: {
     #           "TagKey" => "TagValue",
     #         },
+    #         artifact_config: {
+    #           s3_encryption: {
+    #             encryption_mode: "SSE_S3", # accepts SSE_S3, SSE_KMS
+    #             kms_key_arn: "KmsKeyArn",
+    #           },
+    #         },
     #       }
     #
     # @!attribute [rw] name
@@ -745,6 +810,12 @@ module Aws::Synthetics
     #   tag values.
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] artifact_config
+    #   A structure that contains the configuration for canary artifacts,
+    #   including the encryption-at-rest settings for artifacts that the
+    #   canary uploads to Amazon S3.
+    #   @return [Types::ArtifactConfigInput]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/synthetics-2017-10-11/CreateCanaryRequest AWS API Documentation
     #
     class CreateCanaryRequest < Struct.new(
@@ -758,7 +829,8 @@ module Aws::Synthetics
       :failure_retention_period_in_days,
       :runtime_version,
       :vpc_config,
-      :tags)
+      :tags,
+      :artifact_config)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1138,6 +1210,47 @@ module Aws::Synthetics
       include Aws::Structure
     end
 
+    # A structure that contains the configuration of encryption-at-rest
+    # settings for canary artifacts that the canary uploads to Amazon S3.
+    #
+    # For more information, see [Encrypting canary artifacts][1]
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_artifact_encryption.html
+    #
+    # @note When making an API call, you may pass S3EncryptionConfig
+    #   data as a hash:
+    #
+    #       {
+    #         encryption_mode: "SSE_S3", # accepts SSE_S3, SSE_KMS
+    #         kms_key_arn: "KmsKeyArn",
+    #       }
+    #
+    # @!attribute [rw] encryption_mode
+    #   The encryption method to use for artifacts created by this canary.
+    #   Specify `SSE_S3` to use server-side encryption (SSE) with an Amazon
+    #   S3-managed key. Specify `SSE-KMS` to use server-side encryption with
+    #   a customer-managed KMS key.
+    #
+    #   If you omit this parameter, an Amazon Web Services-managed KMS key
+    #   is used.
+    #   @return [String]
+    #
+    # @!attribute [rw] kms_key_arn
+    #   The ARN of the customer-managed KMS key to use, if you specify
+    #   `SSE-KMS` for `EncryptionMode`
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/synthetics-2017-10-11/S3EncryptionConfig AWS API Documentation
+    #
+    class S3EncryptionConfig < Struct.new(
+      :encryption_mode,
+      :kms_key_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass StartCanaryRequest
     #   data as a hash:
     #
@@ -1301,6 +1414,13 @@ module Aws::Synthetics
     #           ],
     #           base_canary_run_id: "String", # required
     #         },
+    #         artifact_s3_location: "String",
+    #         artifact_config: {
+    #           s3_encryption: {
+    #             encryption_mode: "SSE_S3", # accepts SSE_S3, SSE_KMS
+    #             kms_key_arn: "KmsKeyArn",
+    #           },
+    #         },
     #       }
     #
     # @!attribute [rw] name
@@ -1397,6 +1517,19 @@ module Aws::Synthetics
     #   [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_Blueprints_VisualTesting.html
     #   @return [Types::VisualReferenceInput]
     #
+    # @!attribute [rw] artifact_s3_location
+    #   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 S3 bucket can't include
+    #   a period (.).
+    #   @return [String]
+    #
+    # @!attribute [rw] artifact_config
+    #   A structure that contains the configuration for canary artifacts,
+    #   including the encryption-at-rest settings for artifacts that the
+    #   canary uploads to Amazon S3.
+    #   @return [Types::ArtifactConfigInput]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/synthetics-2017-10-11/UpdateCanaryRequest AWS API Documentation
     #
     class UpdateCanaryRequest < Struct.new(
@@ -1409,7 +1542,9 @@ module Aws::Synthetics
       :success_retention_period_in_days,
       :failure_retention_period_in_days,
       :vpc_config,
-      :visual_reference)
+      :visual_reference,
+      :artifact_s3_location,
+      :artifact_config)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-synthetics.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-synthetics/customizations'
 # @!group service
 module Aws::Synthetics
 
-  GEM_VERSION = '1.17.0'
+  GEM_VERSION = '1.18.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-synthetics
 version: !ruby/object:Gem::Version
-  version: 1.17.0
+  version: 1.18.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-09-01 00:00:00.000000000 Z
+date: 2021-10-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core