aws-sdk-emrserverless 1.5.0 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6e19751a7697ce089c47bf20b290b0529479af2e1a11b4558ddb64852b04dd01
-  data.tar.gz: 6391f798e096bb240c136703d96a290ab15426f3eb9b4ac2411b5ac0cc00471d
+  metadata.gz: cf55390119b88805ae0da75e0d143c59edc292998936970d09da56dcc1c5a077
+  data.tar.gz: b46b5251fae1cbdf20ed5595cbe4ff4c87079498e40c58fe58a52ac3e26519fc
 SHA512:
-  metadata.gz: 8a0763d28b753319251b068ca5e4186334703fde9e170645966bde1e349883e86f4e8d1ee4ff6b1d313d5288d27e5df5e3bd87d3454507a626f834fd495e9049
-  data.tar.gz: 264170dbbd9be88aaf402edbc5a50da3acd87fabec4f3cf7721b95619b7c4d9f35d7a1a66a78563565eeb0750e33c8b3a0b2f3e92b112f846d3c93f931c09524
+  metadata.gz: 8cdc5783077786e8ca342c360ffea3ce0ec6de5091822343a9836a4ee7ef1a55f742c2dfaa185b83b9762eee1b0ed052ad2ce5d59c7c19766b209384cc36e2d9
+  data.tar.gz: 4b8081089c1481521402cc61233d2a19d0a0daaab5f70340e916847deb7e8c0b7f8a36ca9055876629cc0250940466a636f45d974265b40038382dcd6b9e7e98

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.7.0 (2023-04-17)
+------------------
+
+* Feature - The GetJobRun API has been updated to include the job's billed resource utilization. This utilization shows the aggregate vCPU, memory and storage that AWS has billed for the job run. The billed resources include a 1-minute minimum usage for workers, plus additional storage over 20 GB per worker.
+
+1.6.0 (2023-04-11)
+------------------
+
+* Feature - This release extends GetJobRun API to return job run timeout (executionTimeoutMinutes) specified during StartJobRun call (or default timeout of 720 minutes if none was specified).
+
 1.5.0 (2023-01-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.5.0
+1.7.0

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

@@ -612,7 +612,9 @@ module Aws::EMRServerless
       req.send_request(options)
     end
 
-    # Returns a URL to access the job run dashboard.
+    # Returns a URL to access the job run dashboard. The generated URL is
+    # valid for one hour, after which you must invoke the API again to
+    # generate a new URL.
     #
     # @option params [required, String] :application_id
     #   The ID of the application.
@@ -702,6 +704,10 @@ module Aws::EMRServerless
     #   resp.job_run.network_configuration.security_group_ids #=> Array
     #   resp.job_run.network_configuration.security_group_ids[0] #=> String
     #   resp.job_run.total_execution_duration_seconds #=> Integer
+    #   resp.job_run.execution_timeout_minutes #=> Integer
+    #   resp.job_run.billed_resource_utilization.v_cpu_hour #=> Float
+    #   resp.job_run.billed_resource_utilization.memory_gb_hour #=> Float
+    #   resp.job_run.billed_resource_utilization.storage_gb_hour #=> Float
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/emr-serverless-2021-07-13/GetJobRun AWS API Documentation
     #
@@ -1008,12 +1014,13 @@ module Aws::EMRServerless
       req.send_request(options)
     end
 
-    # Assigns tags to resources. A tag is a label that you assign to an AWS
-    # resource. Each tag consists of a key and an optional value, both of
-    # which you define. Tags enable you to categorize your AWS resources by
-    # attributes such as purpose, owner, or environment. When you have many
-    # resources of the same type, you can quickly identify a specific
-    # resource based on the tags you've assigned to it.
+    # Assigns tags to resources. A tag is a label that you assign to an
+    # Amazon Web Services resource. Each tag consists of a key and an
+    # optional value, both of which you define. Tags enable you to
+    # categorize your Amazon Web Services resources by attributes such as
+    # purpose, owner, or environment. When you have many resources of the
+    # same type, you can quickly identify a specific resource based on the
+    # tags you've assigned to it.
     #
     # @option params [required, String] :resource_arn
     #   The Amazon Resource Name (ARN) that identifies the resource to list
@@ -1226,7 +1233,7 @@ module Aws::EMRServerless
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-emrserverless'
-      context[:gem_version] = '1.5.0'
+      context[:gem_version] = '1.7.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -93,6 +93,7 @@ module Aws::EMRServerless
     RequestIdentityUserArn = Shapes::StringShape.new(name: 'RequestIdentityUserArn')
     ResourceArn = Shapes::StringShape.new(name: 'ResourceArn')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
+    ResourceUtilization = Shapes::StructureShape.new(name: 'ResourceUtilization')
     S3MonitoringConfiguration = Shapes::StructureShape.new(name: 'S3MonitoringConfiguration')
     SecurityGroupIds = Shapes::ListShape.new(name: 'SecurityGroupIds')
     SecurityGroupString = Shapes::StringShape.new(name: 'SecurityGroupString')
@@ -291,6 +292,8 @@ module Aws::EMRServerless
     JobRun.add_member(:total_resource_utilization, Shapes::ShapeRef.new(shape: TotalResourceUtilization, location_name: "totalResourceUtilization"))
     JobRun.add_member(:network_configuration, Shapes::ShapeRef.new(shape: NetworkConfiguration, location_name: "networkConfiguration"))
     JobRun.add_member(:total_execution_duration_seconds, Shapes::ShapeRef.new(shape: Integer, location_name: "totalExecutionDurationSeconds"))
+    JobRun.add_member(:execution_timeout_minutes, Shapes::ShapeRef.new(shape: Duration, location_name: "executionTimeoutMinutes", metadata: {"box"=>true}))
+    JobRun.add_member(:billed_resource_utilization, Shapes::ShapeRef.new(shape: ResourceUtilization, location_name: "billedResourceUtilization"))
     JobRun.struct_class = Types::JobRun
 
     JobRunStateSet.member = Shapes::ShapeRef.new(shape: JobRunState)
@@ -358,6 +361,11 @@ module Aws::EMRServerless
     ResourceNotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: String1024, required: true, location_name: "message"))
     ResourceNotFoundException.struct_class = Types::ResourceNotFoundException
 
+    ResourceUtilization.add_member(:v_cpu_hour, Shapes::ShapeRef.new(shape: Double, location_name: "vCPUHour"))
+    ResourceUtilization.add_member(:memory_gb_hour, Shapes::ShapeRef.new(shape: Double, location_name: "memoryGBHour"))
+    ResourceUtilization.add_member(:storage_gb_hour, Shapes::ShapeRef.new(shape: Double, location_name: "storageGBHour"))
+    ResourceUtilization.struct_class = Types::ResourceUtilization
+
     S3MonitoringConfiguration.add_member(:log_uri, Shapes::ShapeRef.new(shape: UriString, location_name: "logUri"))
     S3MonitoringConfiguration.add_member(:encryption_key_arn, Shapes::ShapeRef.new(shape: EncryptionKeyArn, location_name: "encryptionKeyArn"))
     S3MonitoringConfiguration.struct_class = Types::S3MonitoringConfiguration

data/lib/aws-sdk-emrserverless/endpoint_parameters.rb

@@ -50,9 +50,6 @@ module Aws::EMRServerless
 
     def initialize(options = {})
       self[:region] = options[:region]
-      if self[:region].nil?
-        raise ArgumentError, "Missing required EndpointParameter: :region"
-      end
       self[:use_dual_stack] = options[:use_dual_stack]
       self[:use_dual_stack] = false if self[:use_dual_stack].nil?
       if self[:use_dual_stack].nil?

data/lib/aws-sdk-emrserverless/endpoint_provider.rb

@@ -14,36 +14,39 @@ module Aws::EMRServerless
       use_dual_stack = parameters.use_dual_stack
       use_fips = parameters.use_fips
       endpoint = parameters.endpoint
-      if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
-        if Aws::Endpoints::Matchers.set?(endpoint) && (url = Aws::Endpoints::Matchers.parse_url(endpoint))
-          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-            raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
-          end
-          if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-            raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
-          end
-          return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
-        end
-        if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-            return Aws::Endpoints::Endpoint.new(url: "https://emr-serverless-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
-          end
-          raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
-        end
+      if Aws::Endpoints::Matchers.set?(endpoint)
         if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
-            return Aws::Endpoints::Endpoint.new(url: "https://emr-serverless-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
-          end
-          raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
+          raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
         end
         if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-            return Aws::Endpoints::Endpoint.new(url: "https://emr-serverless.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+          raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
+        end
+        return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
+      end
+      if Aws::Endpoints::Matchers.set?(region)
+        if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
+          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+              return Aws::Endpoints::Endpoint.new(url: "https://emr-serverless-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
+          end
+          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
+              return Aws::Endpoints::Endpoint.new(url: "https://emr-serverless-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
+          end
+          if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+              return Aws::Endpoints::Endpoint.new(url: "https://emr-serverless.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
           end
-          raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
+          return Aws::Endpoints::Endpoint.new(url: "https://emr-serverless.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
         end
-        return Aws::Endpoints::Endpoint.new(url: "https://emr-serverless.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
       end
+      raise ArgumentError, "Invalid Configuration: Missing Region"
       raise ArgumentError, 'No endpoint could be resolved'
 
     end

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

@@ -707,8 +707,8 @@ module Aws::EMRServerless
     #
     # @!attribute [rw] total_resource_utilization
     #   The aggregate vCPU, memory, and storage resources used from the time
-    #   job start executing till the time job is terminated, rounded up to
-    #   the nearest second.
+    #   the job starts to execute, until the time the job terminates,
+    #   rounded up to the nearest second.
     #   @return [Types::TotalResourceUtilization]
     #
     # @!attribute [rw] network_configuration
@@ -721,6 +721,20 @@ module Aws::EMRServerless
     #   state.
     #   @return [Integer]
     #
+    # @!attribute [rw] execution_timeout_minutes
+    #   Returns the job run timeout value from the `StartJobRun` call. If no
+    #   timeout was specified, then it returns the default timeout of 720
+    #   minutes.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] billed_resource_utilization
+    #   The aggregate vCPU, memory, and storage that AWS has billed for the
+    #   job run. The billed resources include a 1-minute minimum usage for
+    #   workers, plus additional storage over 20 GB per worker. Note that
+    #   billed resources do not include usage for idle pre-initialized
+    #   workers.
+    #   @return [Types::ResourceUtilization]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/emr-serverless-2021-07-13/JobRun AWS API Documentation
     #
     class JobRun < Struct.new(
@@ -740,7 +754,9 @@ module Aws::EMRServerless
       :tags,
       :total_resource_utilization,
       :network_configuration,
-      :total_execution_duration_seconds)
+      :total_execution_duration_seconds,
+      :execution_timeout_minutes,
+      :billed_resource_utilization)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1039,6 +1055,33 @@ module Aws::EMRServerless
       include Aws::Structure
     end
 
+    # The resource utilization for memory, storage, and vCPU for jobs.
+    #
+    # @!attribute [rw] v_cpu_hour
+    #   The aggregated vCPU used per hour from the time the job starts
+    #   executing until the job is terminated.
+    #   @return [Float]
+    #
+    # @!attribute [rw] memory_gb_hour
+    #   The aggregated memory used per hour from the time the job starts
+    #   executing until the job is terminated.
+    #   @return [Float]
+    #
+    # @!attribute [rw] storage_gb_hour
+    #   The aggregated storage used per hour from the time the job starts
+    #   executing until the job is terminated.
+    #   @return [Float]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/emr-serverless-2021-07-13/ResourceUtilization AWS API Documentation
+    #
+    class ResourceUtilization < Struct.new(
+      :v_cpu_hour,
+      :memory_gb_hour,
+      :storage_gb_hour)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The Amazon S3 configuration for monitoring log publishing. You can
     # configure your jobs to send log information to Amazon S3.
     #
@@ -1175,7 +1218,7 @@ module Aws::EMRServerless
     #   @return [String]
     #
     # @!attribute [rw] arn
-    #   The output lists the execution role ARN of the job run.
+    #   This output displays the ARN of the job run..
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/emr-serverless-2021-07-13/StartJobRunResponse AWS API Documentation
@@ -1366,8 +1409,8 @@ module Aws::EMRServerless
       include Aws::Structure
     end
 
-    # The input fails to satisfy the constraints specified by an AWS
-    # service.
+    # The input fails to satisfy the constraints specified by an Amazon Web
+    # Services service.
     #
     # @!attribute [rw] message
     #   @return [String]

data/lib/aws-sdk-emrserverless.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-emrserverless/customizations'
 # @!group service
 module Aws::EMRServerless
 
-  GEM_VERSION = '1.5.0'
+  GEM_VERSION = '1.7.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-emrserverless
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.7.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-01-18 00:00:00.000000000 Z
+date: 2023-04-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core