aws-sdk-emrcontainers 1.18.0 → 1.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 05610d3640609f7c639706fb2da50b6095a15c05b8cdc314104bed98830465ae
-  data.tar.gz: 2922a0dbb1ea2a4d251ac9a03ace43e191d33078885e86503dc374bdc041fc71
+  metadata.gz: e961f7ae43d0324e9507edb28729ce025b3d8ae4ba1ece5e1d179c507bd0e29a
+  data.tar.gz: 3f932da5f078c7a9d64c43080cdb40471bb584b1769ac5448c1b8f3df5dc9bb1
 SHA512:
-  metadata.gz: 54551f0a325da2bc5717ff4eb1d8715a0a8b6d3a12b8db7d58c0257dc666a74df70f3d4389316e2ede69ef74f2f10822ed61763e633a656fe186e800d7338187
-  data.tar.gz: c017686399cf638b3992599e4381c1e231373ecf6d322c6469c65ff0d96409dc6b67ecb8b2e77934398abf814f89617fe56893b3c9fbaff58226ef43003f54d9
+  metadata.gz: 582b02c8072bf8814d642eceea15c5e0948cf73eb3c7a76cbf549188e4954e42a878f78e68c69fb17cfe722be8daa4f63ee8e8be5b7ad94738605ed15c5b048d
+  data.tar.gz: 02f84d5db3e636d3df0490feb6b64ba0101fe59fd209e2aae774fc68ca4d054e3bbbdff6d4dd2fa5d35fc3fd654f92b3f394d7aa8bdf9f1b390945e804d088c5

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.19.0 (2023-02-09)
+------------------
+
+* Feature - EMR on EKS allows configuring retry policies for job runs through the StartJobRun API. Using retry policies, a job cause a driver pod to be restarted automatically if it fails or is deleted. The job's status can be seen in the DescribeJobRun and ListJobRun APIs and monitored using CloudWatch events.
+
 1.18.0 (2023-01-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.18.0
+1.19.0

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

@@ -509,8 +509,8 @@ module Aws::EMRContainers
     end
 
     # Creates a managed endpoint. A managed endpoint is a gateway that
-    # connects EMR Studio to Amazon EMR on EKS so that EMR Studio can
-    # communicate with your virtual cluster.
+    # connects Amazon EMR Studio to Amazon EMR on EKS so that Amazon EMR
+    # Studio can communicate with your virtual cluster.
     #
     # @option params [required, String] :name
     #   The name of the managed endpoint.
@@ -699,8 +699,8 @@ module Aws::EMRContainers
     end
 
     # Deletes a managed endpoint. A managed endpoint is a gateway that
-    # connects EMR Studio to Amazon EMR on EKS so that EMR Studio can
-    # communicate with your virtual cluster.
+    # connects Amazon EMR Studio to Amazon EMR on EKS so that Amazon EMR
+    # Studio can communicate with your virtual cluster.
     #
     # @option params [required, String] :id
     #   The ID of the managed endpoint.
@@ -820,6 +820,8 @@ module Aws::EMRContainers
     #   resp.job_run.failure_reason #=> String, one of "INTERNAL_ERROR", "USER_ERROR", "VALIDATION_ERROR", "CLUSTER_UNAVAILABLE"
     #   resp.job_run.tags #=> Hash
     #   resp.job_run.tags["String128"] #=> String
+    #   resp.job_run.retry_policy_configuration.max_attempts #=> Integer
+    #   resp.job_run.retry_policy_execution.current_attempt_count #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/emr-containers-2020-10-01/DescribeJobRun AWS API Documentation
     #
@@ -893,8 +895,9 @@ module Aws::EMRContainers
     end
 
     # Displays detailed information about a managed endpoint. A managed
-    # endpoint is a gateway that connects EMR Studio to Amazon EMR on EKS so
-    # that EMR Studio can communicate with your virtual cluster.
+    # endpoint is a gateway that connects Amazon EMR Studio to Amazon EMR on
+    # EKS so that Amazon EMR Studio can communicate with your virtual
+    # cluster.
     #
     # @option params [required, String] :id
     #   This output displays ID of the managed endpoint.
@@ -1074,6 +1077,8 @@ module Aws::EMRContainers
     #   resp.job_runs[0].failure_reason #=> String, one of "INTERNAL_ERROR", "USER_ERROR", "VALIDATION_ERROR", "CLUSTER_UNAVAILABLE"
     #   resp.job_runs[0].tags #=> Hash
     #   resp.job_runs[0].tags["String128"] #=> String
+    #   resp.job_runs[0].retry_policy_configuration.max_attempts #=> Integer
+    #   resp.job_runs[0].retry_policy_execution.current_attempt_count #=> Integer
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/emr-containers-2020-10-01/ListJobRuns AWS API Documentation
@@ -1165,8 +1170,9 @@ module Aws::EMRContainers
     end
 
     # Lists managed endpoints based on a set of parameters. A managed
-    # endpoint is a gateway that connects EMR Studio to Amazon EMR on EKS so
-    # that EMR Studio can communicate with your virtual cluster.
+    # endpoint is a gateway that connects Amazon EMR Studio to Amazon EMR on
+    # EKS so that Amazon EMR Studio can communicate with your virtual
+    # cluster.
     #
     # @option params [required, String] :virtual_cluster_id
     #   The ID of the virtual cluster.
@@ -1292,8 +1298,8 @@ module Aws::EMRContainers
     #   The container provider ID of the virtual cluster.
     #
     # @option params [String] :container_provider_type
-    #   The container provider type of the virtual cluster. EKS is the only
-    #   supported type as of now.
+    #   The container provider type of the virtual cluster. Amazon EKS is the
+    #   only supported type as of now.
     #
     # @option params [Time,DateTime,Date,Integer,String] :created_after
     #   The date and time after which the virtual clusters are created.
@@ -1390,6 +1396,9 @@ module Aws::EMRContainers
     # @option params [Hash<String,String>] :job_template_parameters
     #   The values of job template parameters to start a job run.
     #
+    # @option params [Types::RetryPolicyConfiguration] :retry_policy_configuration
+    #   The retry policy configuration for the job run.
+    #
     # @return [Types::StartJobRunResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::StartJobRunResponse#id #id} => String
@@ -1446,6 +1455,9 @@ module Aws::EMRContainers
     #     job_template_parameters: {
     #       "TemplateParameterName" => "String1024",
     #     },
+    #     retry_policy_configuration: {
+    #       max_attempts: 1, # required
+    #     },
     #   })
     #
     # @example Response structure
@@ -1464,16 +1476,17 @@ module Aws::EMRContainers
       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. For example, you
-    # can define a set of tags for your Amazon EMR on EKS clusters to help
-    # you track each cluster's owner and stack level. We recommend that you
-    # devise a consistent set of tag keys for each resource type. You can
-    # then search and filter the resources based on the tags that you add.
+    # 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. For example, you can define a set of tags
+    # for your Amazon EMR on EKS clusters to help you track each cluster's
+    # owner and stack level. We recommend that you devise a consistent set
+    # of tag keys for each resource type. You can then search and filter the
+    # resources based on the tags that you add.
     #
     # @option params [required, String] :resource_arn
     #   The ARN of resources.
@@ -1540,7 +1553,7 @@ module Aws::EMRContainers
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-emrcontainers'
-      context[:gem_version] = '1.18.0'
+      context[:gem_version] = '1.19.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -100,6 +100,8 @@ module Aws::EMRContainers
     ResourceIdString = Shapes::StringShape.new(name: 'ResourceIdString')
     ResourceNameString = Shapes::StringShape.new(name: 'ResourceNameString')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
+    RetryPolicyConfiguration = Shapes::StructureShape.new(name: 'RetryPolicyConfiguration')
+    RetryPolicyExecution = Shapes::StructureShape.new(name: 'RetryPolicyExecution')
     RsiArn = Shapes::StringShape.new(name: 'RsiArn')
     S3MonitoringConfiguration = Shapes::StructureShape.new(name: 'S3MonitoringConfiguration')
     SensitivePropertiesMap = Shapes::MapShape.new(name: 'SensitivePropertiesMap')
@@ -314,6 +316,8 @@ module Aws::EMRContainers
     JobRun.add_member(:state_details, Shapes::ShapeRef.new(shape: String256, location_name: "stateDetails"))
     JobRun.add_member(:failure_reason, Shapes::ShapeRef.new(shape: FailureReason, location_name: "failureReason"))
     JobRun.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "tags"))
+    JobRun.add_member(:retry_policy_configuration, Shapes::ShapeRef.new(shape: RetryPolicyConfiguration, location_name: "retryPolicyConfiguration"))
+    JobRun.add_member(:retry_policy_execution, Shapes::ShapeRef.new(shape: RetryPolicyExecution, location_name: "retryPolicyExecution"))
     JobRun.struct_class = Types::JobRun
 
     JobRunStates.member = Shapes::ShapeRef.new(shape: JobRunState)
@@ -420,6 +424,12 @@ module Aws::EMRContainers
     ResourceNotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: String1024, location_name: "message"))
     ResourceNotFoundException.struct_class = Types::ResourceNotFoundException
 
+    RetryPolicyConfiguration.add_member(:max_attempts, Shapes::ShapeRef.new(shape: JavaInteger, required: true, location_name: "maxAttempts"))
+    RetryPolicyConfiguration.struct_class = Types::RetryPolicyConfiguration
+
+    RetryPolicyExecution.add_member(:current_attempt_count, Shapes::ShapeRef.new(shape: JavaInteger, required: true, location_name: "currentAttemptCount"))
+    RetryPolicyExecution.struct_class = Types::RetryPolicyExecution
+
     S3MonitoringConfiguration.add_member(:log_uri, Shapes::ShapeRef.new(shape: UriString, required: true, location_name: "logUri"))
     S3MonitoringConfiguration.struct_class = Types::S3MonitoringConfiguration
 
@@ -445,6 +455,7 @@ module Aws::EMRContainers
     StartJobRunRequest.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "tags"))
     StartJobRunRequest.add_member(:job_template_id, Shapes::ShapeRef.new(shape: ResourceIdString, location_name: "jobTemplateId"))
     StartJobRunRequest.add_member(:job_template_parameters, Shapes::ShapeRef.new(shape: TemplateParameterInputMap, location_name: "jobTemplateParameters"))
+    StartJobRunRequest.add_member(:retry_policy_configuration, Shapes::ShapeRef.new(shape: RetryPolicyConfiguration, location_name: "retryPolicyConfiguration"))
     StartJobRunRequest.struct_class = Types::StartJobRunRequest
 
     StartJobRunResponse.add_member(:id, Shapes::ShapeRef.new(shape: ResourceIdString, location_name: "id"))

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

@@ -50,6 +50,9 @@ module Aws::EMRContainers
 
     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-emrcontainers/endpoint_provider.rb

@@ -15,7 +15,7 @@ module Aws::EMRContainers
       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.set?(endpoint)
           if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
             raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
           end

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

@@ -145,7 +145,7 @@ module Aws::EMRContainers
     # @note ContainerInfo is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of ContainerInfo corresponding to the set member.
     #
     # @!attribute [rw] eks_info
-    #   The information about the EKS cluster.
+    #   The information about the Amazon EKS cluster.
     #   @return [Types::EksInfo]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/emr-containers-2020-10-01/ContainerInfo AWS API Documentation
@@ -164,8 +164,8 @@ module Aws::EMRContainers
     # The information about the container provider.
     #
     # @!attribute [rw] type
-    #   The type of the container provider. EKS is the only supported type
-    #   as of now.
+    #   The type of the container provider. Amazon EKS is the only supported
+    #   type as of now.
     #   @return [String]
     #
     # @!attribute [rw] id
@@ -576,10 +576,10 @@ module Aws::EMRContainers
       include Aws::Structure
     end
 
-    # The information about the EKS cluster.
+    # The information about the Amazon EKS cluster.
     #
     # @!attribute [rw] namespace
-    #   The namespaces of the EKS cluster.
+    #   The namespaces of the Amazon EKS cluster.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/emr-containers-2020-10-01/EksInfo AWS API Documentation
@@ -796,6 +796,14 @@ module Aws::EMRContainers
     #   The assigned tags of the job run.
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] retry_policy_configuration
+    #   The configuration of the retry policy that the job runs on.
+    #   @return [Types::RetryPolicyConfiguration]
+    #
+    # @!attribute [rw] retry_policy_execution
+    #   The current status of the retry policy executed on the job.
+    #   @return [Types::RetryPolicyExecution]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/emr-containers-2020-10-01/JobRun AWS API Documentation
     #
     class JobRun < Struct.new(
@@ -814,7 +822,9 @@ module Aws::EMRContainers
       :finished_at,
       :state_details,
       :failure_reason,
-      :tags)
+      :tags,
+      :retry_policy_configuration,
+      :retry_policy_execution)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1111,8 +1121,8 @@ module Aws::EMRContainers
     #   @return [String]
     #
     # @!attribute [rw] container_provider_type
-    #   The container provider type of the virtual cluster. EKS is the only
-    #   supported type as of now.
+    #   The container provider type of the virtual cluster. Amazon EKS is
+    #   the only supported type as of now.
     #   @return [String]
     #
     # @!attribute [rw] created_after
@@ -1286,6 +1296,34 @@ module Aws::EMRContainers
       include Aws::Structure
     end
 
+    # The configuration of the retry policy that the job runs on.
+    #
+    # @!attribute [rw] max_attempts
+    #   The maximum number of attempts on the job's driver.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/emr-containers-2020-10-01/RetryPolicyConfiguration AWS API Documentation
+    #
+    class RetryPolicyConfiguration < Struct.new(
+      :max_attempts)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The current status of the retry policy executed on the job.
+    #
+    # @!attribute [rw] current_attempt_count
+    #   The current number of attempts made on the driver of the job.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/emr-containers-2020-10-01/RetryPolicyExecution AWS API Documentation
+    #
+    class RetryPolicyExecution < Struct.new(
+      :current_attempt_count)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Amazon S3 configuration for monitoring log publishing. You can
     # configure your jobs to send log information to Amazon S3.
     #
@@ -1387,6 +1425,10 @@ module Aws::EMRContainers
     #   The values of job template parameters to start a job run.
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] retry_policy_configuration
+    #   The retry policy configuration for the job run.
+    #   @return [Types::RetryPolicyConfiguration]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/emr-containers-2020-10-01/StartJobRunRequest AWS API Documentation
     #
     class StartJobRunRequest < Struct.new(
@@ -1399,7 +1441,8 @@ module Aws::EMRContainers
       :configuration_overrides,
       :tags,
       :job_template_id,
-      :job_template_parameters)
+      :job_template_parameters,
+      :retry_policy_configuration)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1457,7 +1500,7 @@ module Aws::EMRContainers
     #
     # @!attribute [rw] type
     #   The type of the job template parameter. Allowed values are:
-    #   ‘String’, ‘Number’.
+    #   ‘STRING’, ‘NUMBER’.
     #   @return [String]
     #
     # @!attribute [rw] default_value
@@ -1511,9 +1554,9 @@ module Aws::EMRContainers
     # Kubernetes namespace that Amazon EMR is registered with. Amazon EMR
     # uses virtual clusters to run jobs and host endpoints. Multiple virtual
     # clusters can be backed by the same physical cluster. However, each
-    # virtual cluster maps to one namespace on an EKS cluster. Virtual
-    # clusters do not create any active resources that contribute to your
-    # bill or that require lifecycle management outside the service.
+    # virtual cluster maps to one namespace on an Amazon EKS cluster.
+    # Virtual clusters do not create any active resources that contribute to
+    # your bill or that require lifecycle management outside the service.
     #
     # @!attribute [rw] id
     #   The ID of the virtual cluster.

data/lib/aws-sdk-emrcontainers.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-emrcontainers/customizations'
 # @!group service
 module Aws::EMRContainers
 
-  GEM_VERSION = '1.18.0'
+  GEM_VERSION = '1.19.0'
 
 end

metadata

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