aws-sdk-emrserverless 1.6.0 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bcc48e158d5cd56b7daa62ed525844fda0be0b2120985b6708ae9dde7ad94c2d
-  data.tar.gz: 2773d06fdaf913d51510e83192171fe79de81045b6b7809ad15156bb03b0df1e
+  metadata.gz: cf55390119b88805ae0da75e0d143c59edc292998936970d09da56dcc1c5a077
+  data.tar.gz: b46b5251fae1cbdf20ed5595cbe4ff4c87079498e40c58fe58a52ac3e26519fc
 SHA512:
-  metadata.gz: 61d6bfe4cbb5e417c213aa9db67eb83849fe19b68ec4be063fa72480758c34c5485cbf0997374efc43659ad1a73d183aca5c74c3e866172c890976b6667e0285
-  data.tar.gz: 03fc24f1c2a26362a0139a02abb1d361d609e83f409561de953beda9e66b50238b324a9eaffd42ad14c4e47dd324443831b29e78ecefd0ede0788e324ddeb74a
+  metadata.gz: 8cdc5783077786e8ca342c360ffea3ce0ec6de5091822343a9836a4ee7ef1a55f742c2dfaa185b83b9762eee1b0ed052ad2ce5d59c7c19766b209384cc36e2d9
+  data.tar.gz: 4b8081089c1481521402cc61233d2a19d0a0daaab5f70340e916847deb7e8c0b7f8a36ca9055876629cc0250940466a636f45d974265b40038382dcd6b9e7e98

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 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)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.6.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.
@@ -703,6 +705,9 @@ module Aws::EMRServerless
     #   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
     #
@@ -1228,7 +1233,7 @@ module Aws::EMRServerless
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-emrserverless'
-      context[:gem_version] = '1.6.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')
@@ -292,6 +293,7 @@ module Aws::EMRServerless
     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)
@@ -359,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/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
@@ -722,10 +722,19 @@ module Aws::EMRServerless
     #   @return [Integer]
     #
     # @!attribute [rw] execution_timeout_minutes
-    #   Maximum duration for the job run to run. If the job run runs beyond
-    #   this duration, it will be automatically cancelled.
+    #   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(
@@ -746,7 +755,8 @@ module Aws::EMRServerless
       :total_resource_utilization,
       :network_configuration,
       :total_execution_duration_seconds,
-      :execution_timeout_minutes)
+      :execution_timeout_minutes,
+      :billed_resource_utilization)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1045,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.
     #

data/lib/aws-sdk-emrserverless.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-emrserverless/customizations'
 # @!group service
 module Aws::EMRServerless
 
-  GEM_VERSION = '1.6.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.6.0
+  version: 1.7.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-04-11 00:00:00.000000000 Z
+date: 2023-04-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core