aws-sdk-applicationsignals 1.2.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fc0347757250eeb2d69e447ed3f084fb252ca295f9799428e3dd9422869afacf
-  data.tar.gz: 935ed196043cb754ea641a7111c3606b17dc0112579a53f5c4ee456078476609
+  metadata.gz: e3c01e793d3a6c92aea898deb98cf95a9b72301058a54db90aab19b9933dea5f
+  data.tar.gz: 3da776c18e6162102d7ce6a3e35ce6a986ce7d35115a28a998b7f7a896784425
 SHA512:
-  metadata.gz: a261ec5165f97af39d097383d6dc031adf1f0f584b7ebc5de9ff6435516f44988bf1de615037b15d1622aacc493e678ab26a728fba4d203dbbbaa8c88f116534
-  data.tar.gz: 600a3413d915ee2bb5fbd3016ba3fdbcaf0efaf9c0eaac5e06648e665a8c9813878ea6256163e9213006af9bd662616bde8acfffdbdffd78eaeab7ce04eebe17
+  metadata.gz: 9b062ee412b83f73f388ca5fed6975e98bf441f67ff8a86abcf72dc3fa95b24f438290387cab5382dfdc83d8348e1a57fd2a1e5190384a3417956f08b8767acb
+  data.tar.gz: a09f18cdc5a2b606d46fea895d2f74020d9eb3008db864c7532361100d198dec4dfc27bf248b86ff1ab531f6a8c58d24daff8ec89b962ebd34b4a47d6ada1c7c

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.4.0 (2024-07-25)
+------------------
+
+* Feature - CloudWatch Application Signals now supports application logs correlation with traces and operational health metrics of applications running on EC2 instances. Users can view the most relevant telemetry to troubleshoot application health anomalies such as spikes in latency, errors, and availability.
+
+1.3.0 (2024-07-02)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.2.0 (2024-06-25)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.2.0
+1.4.0

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

@@ -312,6 +312,15 @@ module Aws::ApplicationSignals
     #
     #   @option options [String] :session_token
     #
+    #   @option options [Array] :sigv4a_signing_region_set
+    #     A list of regions that should be signed with SigV4a signing. When
+    #     not passed, a default `:sigv4a_signing_region_set` is searched for
+    #     in the following locations:
+    #
+    #     * `Aws.config[:sigv4a_signing_region_set]`
+    #     * `ENV['AWS_SIGV4A_SIGNING_REGION_SET']`
+    #     * `~/.aws/config`
+    #
     #   @option options [Boolean] :stub_responses (false)
     #     Causes the client to return stubbed responses. By default
     #     fake responses are generated and returned. You can specify
@@ -734,11 +743,15 @@ module Aws::ApplicationSignals
     #   in a raw HTTP Query API, it is formatted as be epoch time in seconds.
     #   For example: `1698778057`
     #
+    #   Your requested start time will be rounded to the nearest hour.
+    #
     # @option params [required, Time,DateTime,Date,Integer,String] :end_time
     #   The end of the time period to retrieve information about. When used in
     #   a raw HTTP Query API, it is formatted as be epoch time in seconds. For
     #   example: `1698778057`
     #
+    #   Your requested start time will be rounded to the nearest hour.
+    #
     # @option params [required, Hash<String,String>] :key_attributes
     #   Use this field to specify which service you want to retrieve
     #   information for. You must specify at least the `Type`, `Name`, and
@@ -768,6 +781,7 @@ module Aws::ApplicationSignals
     #   * {Types::GetServiceOutput#service #service} => Types::Service
     #   * {Types::GetServiceOutput#start_time #start_time} => Time
     #   * {Types::GetServiceOutput#end_time #end_time} => Time
+    #   * {Types::GetServiceOutput#log_group_references #log_group_references} => Array&lt;Hash&lt;String,String&gt;&gt;
     #
     # @example Request syntax with placeholder values
     #
@@ -793,8 +807,14 @@ module Aws::ApplicationSignals
     #   resp.service.metric_references[0].dimensions[0].name #=> String
     #   resp.service.metric_references[0].dimensions[0].value #=> String
     #   resp.service.metric_references[0].metric_name #=> String
+    #   resp.service.log_group_references #=> Array
+    #   resp.service.log_group_references[0] #=> Hash
+    #   resp.service.log_group_references[0]["KeyAttributeName"] #=> String
     #   resp.start_time #=> Time
     #   resp.end_time #=> Time
+    #   resp.log_group_references #=> Array
+    #   resp.log_group_references[0] #=> Hash
+    #   resp.log_group_references[0]["KeyAttributeName"] #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/GetService AWS API Documentation
     #
@@ -882,11 +902,15 @@ module Aws::ApplicationSignals
     #   in a raw HTTP Query API, it is formatted as be epoch time in seconds.
     #   For example: `1698778057`
     #
+    #   Your requested start time will be rounded to the nearest hour.
+    #
     # @option params [required, Time,DateTime,Date,Integer,String] :end_time
     #   The end of the time period to retrieve information about. When used in
     #   a raw HTTP Query API, it is formatted as be epoch time in seconds. For
     #   example: `1698778057`
     #
+    #   Your requested end time will be rounded to the nearest hour.
+    #
     # @option params [required, Hash<String,String>] :key_attributes
     #   Use this field to specify which service you want to retrieve
     #   information for. You must specify at least the `Type`, `Name`, and
@@ -977,11 +1001,15 @@ module Aws::ApplicationSignals
     #   in a raw HTTP Query API, it is formatted as be epoch time in seconds.
     #   For example: `1698778057`
     #
+    #   Your requested start time will be rounded to the nearest hour.
+    #
     # @option params [required, Time,DateTime,Date,Integer,String] :end_time
     #   The end of the time period to retrieve information about. When used in
     #   a raw HTTP Query API, it is formatted as be epoch time in seconds. For
     #   example: `1698778057`
     #
+    #   Your requested start time will be rounded to the nearest hour.
+    #
     # @option params [required, Hash<String,String>] :key_attributes
     #   Use this field to specify which service you want to retrieve
     #   information for. You must specify at least the `Type`, `Name`, and
@@ -1145,11 +1173,15 @@ module Aws::ApplicationSignals
     #   in a raw HTTP Query API, it is formatted as be epoch time in seconds.
     #   For example: `1698778057`
     #
+    #   Your requested start time will be rounded to the nearest hour.
+    #
     # @option params [required, Time,DateTime,Date,Integer,String] :end_time
     #   The end of the time period to retrieve information about. When used in
     #   a raw HTTP Query API, it is formatted as be epoch time in seconds. For
     #   example: `1698778057`
     #
+    #   Your requested end time will be rounded to the nearest hour.
+    #
     # @option params [required, Hash<String,String>] :key_attributes
     #   Use this field to specify which service you want to retrieve
     #   information for. You must specify at least the `Type`, `Name`, and
@@ -1237,11 +1269,15 @@ module Aws::ApplicationSignals
     #   in a raw HTTP Query API, it is formatted as be epoch time in seconds.
     #   For example: `1698778057`
     #
+    #   Your requested start time will be rounded to the nearest hour.
+    #
     # @option params [required, Time,DateTime,Date,Integer,String] :end_time
     #   The end of the time period to retrieve information about. When used in
     #   a raw HTTP Query API, it is formatted as be epoch time in seconds. For
     #   example: `1698778057`
     #
+    #   Your requested start time will be rounded to the nearest hour.
+    #
     # @option params [Integer] :max_results
     #   The maximum number of results to return in one operation. If you omit
     #   this parameter, the default of 50 is used.
@@ -1612,7 +1648,7 @@ module Aws::ApplicationSignals
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-applicationsignals'
-      context[:gem_version] = '1.2.0'
+      context[:gem_version] = '1.4.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -62,6 +62,7 @@ module Aws::ApplicationSignals
     ListServicesOutput = Shapes::StructureShape.new(name: 'ListServicesOutput')
     ListTagsForResourceRequest = Shapes::StructureShape.new(name: 'ListTagsForResourceRequest')
     ListTagsForResourceResponse = Shapes::StructureShape.new(name: 'ListTagsForResourceResponse')
+    LogGroupReferences = Shapes::ListShape.new(name: 'LogGroupReferences')
     Metric = Shapes::StructureShape.new(name: 'Metric')
     MetricDataQueries = Shapes::ListShape.new(name: 'MetricDataQueries')
     MetricDataQuery = Shapes::StructureShape.new(name: 'MetricDataQuery')
@@ -204,6 +205,7 @@ module Aws::ApplicationSignals
     GetServiceOutput.add_member(:service, Shapes::ShapeRef.new(shape: Service, required: true, location_name: "Service"))
     GetServiceOutput.add_member(:start_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "StartTime"))
     GetServiceOutput.add_member(:end_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "EndTime"))
+    GetServiceOutput.add_member(:log_group_references, Shapes::ShapeRef.new(shape: LogGroupReferences, location_name: "LogGroupReferences"))
     GetServiceOutput.struct_class = Types::GetServiceOutput
 
     Goal.add_member(:interval, Shapes::ShapeRef.new(shape: Interval, location_name: "Interval"))
@@ -286,6 +288,8 @@ module Aws::ApplicationSignals
     ListTagsForResourceResponse.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
     ListTagsForResourceResponse.struct_class = Types::ListTagsForResourceResponse
 
+    LogGroupReferences.member = Shapes::ShapeRef.new(shape: Attributes)
+
     Metric.add_member(:namespace, Shapes::ShapeRef.new(shape: Namespace, location_name: "Namespace"))
     Metric.add_member(:metric_name, Shapes::ShapeRef.new(shape: MetricName, location_name: "MetricName"))
     Metric.add_member(:dimensions, Shapes::ShapeRef.new(shape: Dimensions, location_name: "Dimensions"))
@@ -328,6 +332,7 @@ module Aws::ApplicationSignals
     Service.add_member(:key_attributes, Shapes::ShapeRef.new(shape: Attributes, required: true, location_name: "KeyAttributes"))
     Service.add_member(:attribute_maps, Shapes::ShapeRef.new(shape: AttributeMaps, location_name: "AttributeMaps"))
     Service.add_member(:metric_references, Shapes::ShapeRef.new(shape: MetricReferences, required: true, location_name: "MetricReferences"))
+    Service.add_member(:log_group_references, Shapes::ShapeRef.new(shape: LogGroupReferences, location_name: "LogGroupReferences"))
     Service.struct_class = Types::Service
 
     ServiceDependencies.member = Shapes::ShapeRef.new(shape: ServiceDependency)
@@ -473,6 +478,7 @@ module Aws::ApplicationSignals
 
       api.metadata = {
         "apiVersion" => "2024-04-15",
+        "auth" => ["aws.auth#sigv4"],
         "endpointPrefix" => "application-signals",
         "protocol" => "rest-json",
         "protocols" => ["rest-json"],

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

@@ -224,12 +224,16 @@ module Aws::ApplicationSignals
     #   The start of the time period to retrieve information about. When
     #   used in a raw HTTP Query API, it is formatted as be epoch time in
     #   seconds. For example: `1698778057`
+    #
+    #   Your requested start time will be rounded to the nearest hour.
     #   @return [Time]
     #
     # @!attribute [rw] end_time
     #   The end of the time period to retrieve information about. When used
     #   in a raw HTTP Query API, it is formatted as be epoch time in
     #   seconds. For example: `1698778057`
+    #
+    #   Your requested start time will be rounded to the nearest hour.
     #   @return [Time]
     #
     # @!attribute [rw] key_attributes
@@ -305,20 +309,41 @@ module Aws::ApplicationSignals
     #   The start time of the data included in the response. In a raw HTTP
     #   Query API, it is formatted as be epoch time in seconds. For example:
     #   `1698778057`.
+    #
+    #   This displays the time that Application Signals used for the
+    #   request. It might not match your request exactly, because it was
+    #   rounded to the nearest hour.
     #   @return [Time]
     #
     # @!attribute [rw] end_time
     #   The end time of the data included in the response. In a raw HTTP
     #   Query API, it is formatted as be epoch time in seconds. For example:
     #   `1698778057`.
+    #
+    #   This displays the time that Application Signals used for the
+    #   request. It might not match your request exactly, because it was
+    #   rounded to the nearest hour.
     #   @return [Time]
     #
+    # @!attribute [rw] log_group_references
+    #   An array of string-to-string maps that each contain information
+    #   about one log group associated with this service. Each
+    #   string-to-string map includes the following fields:
+    #
+    #   * `"Type": "AWS::Resource"`
+    #
+    #   * `"ResourceType": "AWS::Logs::LogGroup"`
+    #
+    #   * `"Identifier": "name-of-log-group"`
+    #   @return [Array<Hash<String,String>>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/GetServiceOutput AWS API Documentation
     #
     class GetServiceOutput < Struct.new(
       :service,
       :start_time,
-      :end_time)
+      :end_time,
+      :log_group_references)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -398,12 +423,16 @@ module Aws::ApplicationSignals
     #   The start of the time period to retrieve information about. When
     #   used in a raw HTTP Query API, it is formatted as be epoch time in
     #   seconds. For example: `1698778057`
+    #
+    #   Your requested start time will be rounded to the nearest hour.
     #   @return [Time]
     #
     # @!attribute [rw] end_time
     #   The end of the time period to retrieve information about. When used
     #   in a raw HTTP Query API, it is formatted as be epoch time in
     #   seconds. For example: `1698778057`
+    #
+    #   Your requested end time will be rounded to the nearest hour.
     #   @return [Time]
     #
     # @!attribute [rw] key_attributes
@@ -457,12 +486,20 @@ module Aws::ApplicationSignals
     #   The start of the time period that the returned information applies
     #   to. When used in a raw HTTP Query API, it is formatted as be epoch
     #   time in seconds. For example: `1698778057`
+    #
+    #   This displays the time that Application Signals used for the
+    #   request. It might not match your request exactly, because it was
+    #   rounded to the nearest hour.
     #   @return [Time]
     #
     # @!attribute [rw] end_time
     #   The end of the time period that the returned information applies to.
     #   When used in a raw HTTP Query API, it is formatted as be epoch time
     #   in seconds. For example: `1698778057`
+    #
+    #   This displays the time that Application Signals used for the
+    #   request. It might not match your request exactly, because it was
+    #   rounded to the nearest hour.
     #   @return [Time]
     #
     # @!attribute [rw] service_dependencies
@@ -490,12 +527,16 @@ module Aws::ApplicationSignals
     #   The start of the time period to retrieve information about. When
     #   used in a raw HTTP Query API, it is formatted as be epoch time in
     #   seconds. For example: `1698778057`
+    #
+    #   Your requested start time will be rounded to the nearest hour.
     #   @return [Time]
     #
     # @!attribute [rw] end_time
     #   The end of the time period to retrieve information about. When used
     #   in a raw HTTP Query API, it is formatted as be epoch time in
     #   seconds. For example: `1698778057`
+    #
+    #   Your requested start time will be rounded to the nearest hour.
     #   @return [Time]
     #
     # @!attribute [rw] key_attributes
@@ -549,12 +590,20 @@ module Aws::ApplicationSignals
     #   The start of the time period that the returned information applies
     #   to. When used in a raw HTTP Query API, it is formatted as be epoch
     #   time in seconds. For example: `1698778057`
+    #
+    #   This displays the time that Application Signals used for the
+    #   request. It might not match your request exactly, because it was
+    #   rounded to the nearest hour.
     #   @return [Time]
     #
     # @!attribute [rw] end_time
     #   The end of the time period that the returned information applies to.
     #   When used in a raw HTTP Query API, it is formatted as be epoch time
     #   in seconds. For example: `1698778057`
+    #
+    #   This displays the time that Application Signals used for the
+    #   request. It might not match your request exactly, because it was
+    #   rounded to the nearest hour.
     #   @return [Time]
     #
     # @!attribute [rw] service_dependents
@@ -650,12 +699,16 @@ module Aws::ApplicationSignals
     #   The start of the time period to retrieve information about. When
     #   used in a raw HTTP Query API, it is formatted as be epoch time in
     #   seconds. For example: `1698778057`
+    #
+    #   Your requested start time will be rounded to the nearest hour.
     #   @return [Time]
     #
     # @!attribute [rw] end_time
     #   The end of the time period to retrieve information about. When used
     #   in a raw HTTP Query API, it is formatted as be epoch time in
     #   seconds. For example: `1698778057`
+    #
+    #   Your requested end time will be rounded to the nearest hour.
     #   @return [Time]
     #
     # @!attribute [rw] key_attributes
@@ -709,12 +762,20 @@ module Aws::ApplicationSignals
     #   The start of the time period that the returned information applies
     #   to. When used in a raw HTTP Query API, it is formatted as be epoch
     #   time in seconds. For example: `1698778057`
+    #
+    #   This displays the time that Application Signals used for the
+    #   request. It might not match your request exactly, because it was
+    #   rounded to the nearest hour.
     #   @return [Time]
     #
     # @!attribute [rw] end_time
     #   The end of the time period that the returned information applies to.
     #   When used in a raw HTTP Query API, it is formatted as be epoch time
     #   in seconds. For example: `1698778057`
+    #
+    #   This displays the time that Application Signals used for the
+    #   request. It might not match your request exactly, because it was
+    #   rounded to the nearest hour.
     #   @return [Time]
     #
     # @!attribute [rw] service_operations
@@ -742,12 +803,16 @@ module Aws::ApplicationSignals
     #   The start of the time period to retrieve information about. When
     #   used in a raw HTTP Query API, it is formatted as be epoch time in
     #   seconds. For example: `1698778057`
+    #
+    #   Your requested start time will be rounded to the nearest hour.
     #   @return [Time]
     #
     # @!attribute [rw] end_time
     #   The end of the time period to retrieve information about. When used
     #   in a raw HTTP Query API, it is formatted as be epoch time in
     #   seconds. For example: `1698778057`
+    #
+    #   Your requested start time will be rounded to the nearest hour.
     #   @return [Time]
     #
     # @!attribute [rw] max_results
@@ -775,12 +840,20 @@ module Aws::ApplicationSignals
     #   The start of the time period that the returned information applies
     #   to. When used in a raw HTTP Query API, it is formatted as be epoch
     #   time in seconds. For example: `1698778057`
+    #
+    #   This displays the time that Application Signals used for the
+    #   request. It might not match your request exactly, because it was
+    #   rounded to the nearest hour.
     #   @return [Time]
     #
     # @!attribute [rw] end_time
     #   The end of the time period that the returned information applies to.
     #   When used in a raw HTTP Query API, it is formatted as be epoch time
     #   in seconds. For example: `1698778057`
+    #
+    #   This displays the time that Application Signals used for the
+    #   request. It might not match your request exactly, because it was
+    #   rounded to the nearest hour.
     #   @return [Time]
     #
     # @!attribute [rw] service_summaries
@@ -1105,7 +1178,7 @@ module Aws::ApplicationSignals
     #   @return [String]
     #
     # @!attribute [rw] resource_id
-    #   Cannot find the resource id.
+    #   Can't find the resource id.
     #   @return [String]
     #
     # @!attribute [rw] message
@@ -1225,12 +1298,25 @@ module Aws::ApplicationSignals
     #   metric associated with this service.
     #   @return [Array<Types::MetricReference>]
     #
+    # @!attribute [rw] log_group_references
+    #   An array of string-to-string maps that each contain information
+    #   about one log group associated with this service. Each
+    #   string-to-string map includes the following fields:
+    #
+    #   * `"Type": "AWS::Resource"`
+    #
+    #   * `"ResourceType": "AWS::Logs::LogGroup"`
+    #
+    #   * `"Identifier": "name-of-log-group"`
+    #   @return [Array<Hash<String,String>>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/application-signals-2024-04-15/Service AWS API Documentation
     #
     class Service < Struct.new(
       :key_attributes,
       :attribute_maps,
-      :metric_references)
+      :metric_references,
+      :log_group_references)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-applicationsignals.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-applicationsignals/customizations'
 # @!group service
 module Aws::ApplicationSignals
 
-  GEM_VERSION = '1.2.0'
+  GEM_VERSION = '1.4.0'
 
 end

data/sig/client.rbs

@@ -48,6 +48,7 @@ module Aws
                       ?sdk_ua_app_id: String,
                       ?secret_access_key: String,
                       ?session_token: String,
+                      ?sigv4a_signing_region_set: Array[String],
                       ?stub_responses: untyped,
                       ?token_provider: untyped,
                       ?use_dualstack_endpoint: bool,
@@ -167,6 +168,7 @@ module Aws
         def service: () -> Types::Service
         def start_time: () -> ::Time
         def end_time: () -> ::Time
+        def log_group_references: () -> ::Array[::Hash[::String, ::String]]
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/ApplicationSignals/Client.html#get_service-instance_method
       def get_service: (

data/sig/resource.rbs

@@ -48,6 +48,7 @@ module Aws
                         ?sdk_ua_app_id: String,
                         ?secret_access_key: String,
                         ?session_token: String,
+                        ?sigv4a_signing_region_set: Array[String],
                         ?stub_responses: untyped,
                         ?token_provider: untyped,
                         ?use_dualstack_endpoint: bool,

data/sig/types.rbs

@@ -87,6 +87,7 @@ module Aws::ApplicationSignals
       attr_accessor service: Types::Service
       attr_accessor start_time: ::Time
       attr_accessor end_time: ::Time
+      attr_accessor log_group_references: ::Array[::Hash[::String, ::String]]
       SENSITIVE: []
     end
 
@@ -253,6 +254,7 @@ module Aws::ApplicationSignals
       attr_accessor key_attributes: ::Hash[::String, ::String]
       attr_accessor attribute_maps: ::Array[::Hash[::String, ::String]]
       attr_accessor metric_references: ::Array[Types::MetricReference]
+      attr_accessor log_group_references: ::Array[::Hash[::String, ::String]]
       SENSITIVE: []
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-applicationsignals
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-25 00:00:00.000000000 Z
+date: 2024-07-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.199.0
+        version: 3.201.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,21 +29,21 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.199.0
+        version: 3.201.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '1.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '1.5'
 description: Official AWS Ruby gem for Amazon CloudWatch Application Signals. This
   gem is part of the AWS SDK for Ruby.
 email: