aws-sdk-emr 1.51.0 → 1.52.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3ed693aacc3d4a96059288bcfc308229b347a3156e07b6dfc575d9eba5ca9fb5
-  data.tar.gz: dcadb3f2e1c2a534177c8bfbccb4093656f79b34b18e22e762f68d9997f6619f
+  metadata.gz: 42a286ab147260cb668f85ebba3485e70a16d1a2af7556e9ed0dfc81131f651a
+  data.tar.gz: 6581d0af1e255d9b3ad6336b9fe4673fa6d0df21db5dd2185b16855944cc8a20
 SHA512:
-  metadata.gz: 891ef1c6c0f9aaecfcdb33f40612689ea143da87ddf606aec65ee5bc172bcae6108b33faa0e5eb924a7b9d8b66a1bc669e61cf0b28e8b70cded6df3f9ac5d93d
-  data.tar.gz: c7f3148a45d46a59c22fe284e8dc06a4c60f6f8beb949f0f119b67b0d17968f314d75e66b556fcad87766dfd7ee6b8b77a0011004339614324bbc4a92fc4d82d
+  metadata.gz: bac8e32daec1f4f810c2435c62c1516f8aca959fea9b278ab52eefc0cb1408bdea5b0e358bbbbaeff4ba319fff03881ce3a495ed86122fa44f821d216baed31c
+  data.tar.gz: 429803b334541b0c3bf8a00ed014a53f36c08795e3e2bfc87e2ba91de81ef50d17037fb6f124fa54f0eb7a29871fc7d2f8ed44370d90153599a20916d9d71fbb

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.52.0 (2021-09-09)
+------------------
+
+* Feature - This release enables customers to login to EMR Studio using AWS Identity and Access Management (IAM) identities or identities in their Identity Provider (IdP) via IAM.
+
 1.51.0 (2021-09-01)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.51.0
+1.52.0

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

@@ -618,24 +618,24 @@ module Aws::EMR
       req.send_request(options)
     end
 
-    # Adds tags to an Amazon EMR resource. Tags make it easier to associate
-    # clusters in various ways, such as grouping clusters to track your
-    # Amazon EMR resource allocation costs. For more information, see [Tag
-    # Clusters][1].
+    # Adds tags to an Amazon EMR resource, such as a cluster or an Amazon
+    # EMR Studio. Tags make it easier to associate resources in various
+    # ways, such as grouping clusters to track your Amazon EMR resource
+    # allocation costs. For more information, see [Tag Clusters][1].
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-tags.html
     #
     # @option params [required, String] :resource_id
-    #   The Amazon EMR resource identifier to which tags will be added. This
-    #   value must be a cluster identifier.
+    #   The Amazon EMR resource identifier to which tags will be added. For
+    #   example, a cluster identifier or an Amazon EMR Studio ID.
     #
     # @option params [required, Array<Types::Tag>] :tags
-    #   A list of tags to associate with a cluster and propagate to EC2
-    #   instances. Tags are user-defined key-value pairs that consist of a
-    #   required key string with a maximum of 128 characters, and an optional
-    #   value string with a maximum of 256 characters.
+    #   A list of tags to associate with a resource. Tags are user-defined
+    #   key-value pairs that consist of a required key string with a maximum
+    #   of 128 characters, and an optional value string with a maximum of 256
+    #   characters.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -760,9 +760,8 @@ module Aws::EMR
     #   A detailed description of the Amazon EMR Studio.
     #
     # @option params [required, String] :auth_mode
-    #   Specifies whether the Studio authenticates users using single sign-on
-    #   (SSO) or IAM. Amazon EMR Studio currently only supports SSO
-    #   authentication.
+    #   Specifies whether the Studio authenticates users using IAM or Amazon
+    #   Web Services SSO.
     #
     # @option params [required, String] :vpc_id
     #   The ID of the Amazon Virtual Private Cloud (Amazon VPC) to associate
@@ -775,14 +774,16 @@ module Aws::EMR
     #   the specified subnets.
     #
     # @option params [required, String] :service_role
-    #   The IAM role that will be assumed by the Amazon EMR Studio. The
-    #   service role provides a way for Amazon EMR Studio to interoperate with
-    #   other Amazon Web Services services.
+    #   The IAM role that the Amazon EMR Studio assumes. The service role
+    #   provides a way for Amazon EMR Studio to interoperate with other Amazon
+    #   Web Services services.
     #
-    # @option params [required, String] :user_role
-    #   The IAM user role that will be assumed by users and groups logged in
-    #   to an Amazon EMR Studio. The permissions attached to this IAM role can
-    #   be scoped down for each user or group using session policies.
+    # @option params [String] :user_role
+    #   The IAM user role that users and groups assume when logged in to an
+    #   Amazon EMR Studio. Only specify a `UserRole` when you use Amazon Web
+    #   Services SSO authentication. The permissions attached to the
+    #   `UserRole` can be scoped down for each user or group using session
+    #   policies.
     #
     # @option params [required, String] :workspace_security_group_id
     #   The ID of the Amazon EMR Studio Workspace security group. The
@@ -799,6 +800,20 @@ module Aws::EMR
     #   The Amazon S3 location to back up Amazon EMR Studio Workspaces and
     #   notebook files.
     #
+    # @option params [String] :idp_auth_url
+    #   The authentication endpoint of your identity provider (IdP). Specify
+    #   this value when you use IAM authentication and want to let federated
+    #   users log in to a Studio with the Studio URL and credentials from your
+    #   IdP. Amazon EMR Studio redirects users to this endpoint to enter
+    #   credentials.
+    #
+    # @option params [String] :idp_relay_state_parameter_name
+    #   The name that your identity provider (IdP) uses for its `RelayState`
+    #   parameter. For example, `RelayState` or `TargetSource`. Specify this
+    #   value when you use IAM authentication and want to let federated users
+    #   log in to a Studio using the Studio URL. The `RelayState` parameter
+    #   differs by IdP.
+    #
     # @option params [Array<Types::Tag>] :tags
     #   A list of tags to associate with the Amazon EMR Studio. Tags are
     #   user-defined key-value pairs that consist of a required key string
@@ -819,10 +834,12 @@ module Aws::EMR
     #     vpc_id: "XmlStringMaxLen256", # required
     #     subnet_ids: ["String"], # required
     #     service_role: "XmlString", # required
-    #     user_role: "XmlString", # required
+    #     user_role: "XmlString",
     #     workspace_security_group_id: "XmlStringMaxLen256", # required
     #     engine_security_group_id: "XmlStringMaxLen256", # required
     #     default_s3_location: "XmlString", # required
+    #     idp_auth_url: "XmlString",
+    #     idp_relay_state_parameter_name: "XmlStringMaxLen256",
     #     tags: [
     #       {
     #         key: "String",
@@ -847,7 +864,14 @@ module Aws::EMR
 
     # Maps a user or group to the Amazon EMR Studio specified by `StudioId`,
     # and applies a session policy to refine Studio permissions for that
-    # user or group.
+    # user or group. Use `CreateStudioSessionMapping` to assign users to a
+    # Studio when you use Amazon Web Services SSO authentication. For
+    # instructions on how to assign users to a Studio when you use IAM
+    # authentication, see [Assign a user or group to your EMR Studio][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-studio-manage-users.html#emr-studio-assign-users-groups
     #
     # @option params [required, String] :studio_id
     #   The ID of the Amazon EMR Studio to which the user or group will be
@@ -1445,6 +1469,8 @@ module Aws::EMR
     #   resp.studio.url #=> String
     #   resp.studio.creation_time #=> Time
     #   resp.studio.default_s3_location #=> String
+    #   resp.studio.idp_auth_url #=> String
+    #   resp.studio.idp_relay_state_parameter_name #=> String
     #   resp.studio.tags #=> Array
     #   resp.studio.tags[0].key #=> String
     #   resp.studio.tags[0].value #=> String
@@ -2311,6 +2337,7 @@ module Aws::EMR
     #   resp.studios[0].vpc_id #=> String
     #   resp.studios[0].description #=> String
     #   resp.studios[0].url #=> String
+    #   resp.studios[0].auth_mode #=> String, one of "SSO", "IAM"
     #   resp.studios[0].creation_time #=> Time
     #   resp.marker #=> String
     #
@@ -2765,10 +2792,10 @@ module Aws::EMR
       req.send_request(options)
     end
 
-    # Removes tags from an Amazon EMR resource. Tags make it easier to
-    # associate clusters in various ways, such as grouping clusters to track
-    # your Amazon EMR resource allocation costs. For more information, see
-    # [Tag Clusters][1].
+    # Removes tags from an Amazon EMR resource, such as a cluster or Amazon
+    # EMR Studio. Tags make it easier to associate resources in various
+    # ways, such as grouping clusters to track your Amazon EMR resource
+    # allocation costs. For more information, see [Tag Clusters][1].
     #
     # The following example removes the stack tag with value Prod from a
     # cluster:
@@ -2779,10 +2806,10 @@ module Aws::EMR
     #
     # @option params [required, String] :resource_id
     #   The Amazon EMR resource identifier from which tags will be removed.
-    #   This value must be a cluster identifier.
+    #   For example, a cluster identifier or an Amazon EMR Studio ID.
     #
     # @option params [required, Array<String>] :tag_keys
-    #   A list of tag keys to remove from a resource.
+    #   A list of tag keys to remove from the resource.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -2979,8 +3006,8 @@ module Aws::EMR
     #   role, you must have already created it using the CLI or console.
     #
     # @option params [String] :service_role
-    #   The IAM role that will be assumed by the Amazon EMR service to access
-    #   Amazon Web Services resources on your behalf.
+    #   The IAM role that Amazon EMR assumes in order to access Amazon Web
+    #   Services resources on your behalf.
     #
     # @option params [Array<Types::Tag>] :tags
     #   A list of tags to associate with a cluster and propagate to Amazon EC2
@@ -3694,7 +3721,7 @@ module Aws::EMR
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-emr'
-      context[:gem_version] = '1.51.0'
+      context[:gem_version] = '1.52.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -512,10 +512,12 @@ module Aws::EMR
     CreateStudioInput.add_member(:vpc_id, Shapes::ShapeRef.new(shape: XmlStringMaxLen256, required: true, location_name: "VpcId"))
     CreateStudioInput.add_member(:subnet_ids, Shapes::ShapeRef.new(shape: SubnetIdList, required: true, location_name: "SubnetIds"))
     CreateStudioInput.add_member(:service_role, Shapes::ShapeRef.new(shape: XmlString, required: true, location_name: "ServiceRole"))
-    CreateStudioInput.add_member(:user_role, Shapes::ShapeRef.new(shape: XmlString, required: true, location_name: "UserRole"))
+    CreateStudioInput.add_member(:user_role, Shapes::ShapeRef.new(shape: XmlString, location_name: "UserRole"))
     CreateStudioInput.add_member(:workspace_security_group_id, Shapes::ShapeRef.new(shape: XmlStringMaxLen256, required: true, location_name: "WorkspaceSecurityGroupId"))
     CreateStudioInput.add_member(:engine_security_group_id, Shapes::ShapeRef.new(shape: XmlStringMaxLen256, required: true, location_name: "EngineSecurityGroupId"))
     CreateStudioInput.add_member(:default_s3_location, Shapes::ShapeRef.new(shape: XmlString, required: true, location_name: "DefaultS3Location"))
+    CreateStudioInput.add_member(:idp_auth_url, Shapes::ShapeRef.new(shape: XmlString, location_name: "IdpAuthUrl"))
+    CreateStudioInput.add_member(:idp_relay_state_parameter_name, Shapes::ShapeRef.new(shape: XmlStringMaxLen256, location_name: "IdpRelayStateParameterName"))
     CreateStudioInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
     CreateStudioInput.struct_class = Types::CreateStudioInput
 
@@ -1391,6 +1393,8 @@ module Aws::EMR
     Studio.add_member(:url, Shapes::ShapeRef.new(shape: XmlString, location_name: "Url"))
     Studio.add_member(:creation_time, Shapes::ShapeRef.new(shape: Date, location_name: "CreationTime"))
     Studio.add_member(:default_s3_location, Shapes::ShapeRef.new(shape: XmlString, location_name: "DefaultS3Location"))
+    Studio.add_member(:idp_auth_url, Shapes::ShapeRef.new(shape: XmlString, location_name: "IdpAuthUrl"))
+    Studio.add_member(:idp_relay_state_parameter_name, Shapes::ShapeRef.new(shape: XmlStringMaxLen256, location_name: "IdpRelayStateParameterName"))
     Studio.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
     Studio.struct_class = Types::Studio
 
@@ -1399,6 +1403,7 @@ module Aws::EMR
     StudioSummary.add_member(:vpc_id, Shapes::ShapeRef.new(shape: XmlStringMaxLen256, location_name: "VpcId"))
     StudioSummary.add_member(:description, Shapes::ShapeRef.new(shape: XmlStringMaxLen256, location_name: "Description"))
     StudioSummary.add_member(:url, Shapes::ShapeRef.new(shape: XmlStringMaxLen256, location_name: "Url"))
+    StudioSummary.add_member(:auth_mode, Shapes::ShapeRef.new(shape: AuthMode, location_name: "AuthMode"))
     StudioSummary.add_member(:creation_time, Shapes::ShapeRef.new(shape: Date, location_name: "CreationTime"))
     StudioSummary.struct_class = Types::StudioSummary
 

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

@@ -292,7 +292,8 @@ module Aws::EMR
       include Aws::Structure
     end
 
-    # This input identifies a cluster and a list of tags to attach.
+    # This input identifies an Amazon EMR resource and a list of tags to
+    # attach.
     #
     # @note When making an API call, you may pass AddTagsInput
     #   data as a hash:
@@ -308,15 +309,15 @@ module Aws::EMR
     #       }
     #
     # @!attribute [rw] resource_id
-    #   The Amazon EMR resource identifier to which tags will be added. This
-    #   value must be a cluster identifier.
+    #   The Amazon EMR resource identifier to which tags will be added. For
+    #   example, a cluster identifier or an Amazon EMR Studio ID.
     #   @return [String]
     #
     # @!attribute [rw] tags
-    #   A list of tags to associate with a cluster and propagate to EC2
-    #   instances. Tags are user-defined key-value pairs that consist of a
-    #   required key string with a maximum of 128 characters, and an
-    #   optional value string with a maximum of 256 characters.
+    #   A list of tags to associate with a resource. Tags are user-defined
+    #   key-value pairs that consist of a required key string with a maximum
+    #   of 128 characters, and an optional value string with a maximum of
+    #   256 characters.
     #   @return [Array<Types::Tag>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/AddTagsInput AWS API Documentation
@@ -956,8 +957,8 @@ module Aws::EMR
     #   @return [Array<Types::Tag>]
     #
     # @!attribute [rw] service_role
-    #   The IAM role that will be assumed by the Amazon EMR service to
-    #   access Amazon Web Services resources on your behalf.
+    #   The IAM role that Amazon EMR assumes in order to access Amazon Web
+    #   Services resources on your behalf.
     #   @return [String]
     #
     # @!attribute [rw] normalized_instance_hours
@@ -1411,10 +1412,12 @@ module Aws::EMR
     #         vpc_id: "XmlStringMaxLen256", # required
     #         subnet_ids: ["String"], # required
     #         service_role: "XmlString", # required
-    #         user_role: "XmlString", # required
+    #         user_role: "XmlString",
     #         workspace_security_group_id: "XmlStringMaxLen256", # required
     #         engine_security_group_id: "XmlStringMaxLen256", # required
     #         default_s3_location: "XmlString", # required
+    #         idp_auth_url: "XmlString",
+    #         idp_relay_state_parameter_name: "XmlStringMaxLen256",
     #         tags: [
     #           {
     #             key: "String",
@@ -1432,9 +1435,8 @@ module Aws::EMR
     #   @return [String]
     #
     # @!attribute [rw] auth_mode
-    #   Specifies whether the Studio authenticates users using single
-    #   sign-on (SSO) or IAM. Amazon EMR Studio currently only supports SSO
-    #   authentication.
+    #   Specifies whether the Studio authenticates users using IAM or Amazon
+    #   Web Services SSO.
     #   @return [String]
     #
     # @!attribute [rw] vpc_id
@@ -1450,15 +1452,17 @@ module Aws::EMR
     #   @return [Array<String>]
     #
     # @!attribute [rw] service_role
-    #   The IAM role that will be assumed by the Amazon EMR Studio. The
-    #   service role provides a way for Amazon EMR Studio to interoperate
-    #   with other Amazon Web Services services.
+    #   The IAM role that the Amazon EMR Studio assumes. The service role
+    #   provides a way for Amazon EMR Studio to interoperate with other
+    #   Amazon Web Services services.
     #   @return [String]
     #
     # @!attribute [rw] user_role
-    #   The IAM user role that will be assumed by users and groups logged in
-    #   to an Amazon EMR Studio. The permissions attached to this IAM role
-    #   can be scoped down for each user or group using session policies.
+    #   The IAM user role that users and groups assume when logged in to an
+    #   Amazon EMR Studio. Only specify a `UserRole` when you use Amazon Web
+    #   Services SSO authentication. The permissions attached to the
+    #   `UserRole` can be scoped down for each user or group using session
+    #   policies.
     #   @return [String]
     #
     # @!attribute [rw] workspace_security_group_id
@@ -1479,6 +1483,22 @@ module Aws::EMR
     #   notebook files.
     #   @return [String]
     #
+    # @!attribute [rw] idp_auth_url
+    #   The authentication endpoint of your identity provider (IdP). Specify
+    #   this value when you use IAM authentication and want to let federated
+    #   users log in to a Studio with the Studio URL and credentials from
+    #   your IdP. Amazon EMR Studio redirects users to this endpoint to
+    #   enter credentials.
+    #   @return [String]
+    #
+    # @!attribute [rw] idp_relay_state_parameter_name
+    #   The name that your identity provider (IdP) uses for its `RelayState`
+    #   parameter. For example, `RelayState` or `TargetSource`. Specify this
+    #   value when you use IAM authentication and want to let federated
+    #   users log in to a Studio using the Studio URL. The `RelayState`
+    #   parameter differs by IdP.
+    #   @return [String]
+    #
     # @!attribute [rw] tags
     #   A list of tags to associate with the Amazon EMR Studio. Tags are
     #   user-defined key-value pairs that consist of a required key string
@@ -1499,6 +1519,8 @@ module Aws::EMR
       :workspace_security_group_id,
       :engine_security_group_id,
       :default_s3_location,
+      :idp_auth_url,
+      :idp_relay_state_parameter_name,
       :tags)
       SENSITIVE = []
       include Aws::Structure
@@ -6051,7 +6073,8 @@ module Aws::EMR
     #
     class RemoveManagedScalingPolicyOutput < Aws::EmptyStructure; end
 
-    # This input identifies a cluster and a list of tags to remove.
+    # This input identifies an Amazon EMR resource and a list of tags to
+    # remove.
     #
     # @note When making an API call, you may pass RemoveTagsInput
     #   data as a hash:
@@ -6063,11 +6086,11 @@ module Aws::EMR
     #
     # @!attribute [rw] resource_id
     #   The Amazon EMR resource identifier from which tags will be removed.
-    #   This value must be a cluster identifier.
+    #   For example, a cluster identifier or an Amazon EMR Studio ID.
     #   @return [String]
     #
     # @!attribute [rw] tag_keys
-    #   A list of tag keys to remove from a resource.
+    #   A list of tag keys to remove from the resource.
     #   @return [Array<String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/RemoveTagsInput AWS API Documentation
@@ -6079,7 +6102,7 @@ module Aws::EMR
       include Aws::Structure
     end
 
-    # This output indicates the result of removing tags from a resource.
+    # This output indicates the result of removing tags from the resource.
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/RemoveTagsOutput AWS API Documentation
     #
@@ -6500,8 +6523,8 @@ module Aws::EMR
     #   @return [String]
     #
     # @!attribute [rw] service_role
-    #   The IAM role that will be assumed by the Amazon EMR service to
-    #   access Amazon Web Services resources on your behalf.
+    #   The IAM role that Amazon EMR assumes in order to access Amazon Web
+    #   Services resources on your behalf.
     #   @return [String]
     #
     # @!attribute [rw] tags
@@ -7654,7 +7677,7 @@ module Aws::EMR
     #
     # @!attribute [rw] auth_mode
     #   Specifies whether the Amazon EMR Studio authenticates users using
-    #   single sign-on (SSO) or IAM.
+    #   IAM or Amazon Web Services SSO.
     #   @return [String]
     #
     # @!attribute [rw] vpc_id
@@ -7672,7 +7695,8 @@ module Aws::EMR
     #
     # @!attribute [rw] user_role
     #   The name of the IAM role assumed by users logged in to the Amazon
-    #   EMR Studio.
+    #   EMR Studio. A Studio only requires a `UserRole` when you use IAM
+    #   authentication.
     #   @return [String]
     #
     # @!attribute [rw] workspace_security_group_id
@@ -7701,6 +7725,16 @@ module Aws::EMR
     #   notebook files.
     #   @return [String]
     #
+    # @!attribute [rw] idp_auth_url
+    #   Your identity provider's authentication endpoint. Amazon EMR Studio
+    #   redirects federated users to this endpoint for authentication when
+    #   logging in to a Studio with the Studio URL.
+    #   @return [String]
+    #
+    # @!attribute [rw] idp_relay_state_parameter_name
+    #   The name of your identity provider's `RelayState` parameter.
+    #   @return [String]
+    #
     # @!attribute [rw] tags
     #   A list of tags associated with the Amazon EMR Studio.
     #   @return [Array<Types::Tag>]
@@ -7722,6 +7756,8 @@ module Aws::EMR
       :url,
       :creation_time,
       :default_s3_location,
+      :idp_auth_url,
+      :idp_relay_state_parameter_name,
       :tags)
       SENSITIVE = []
       include Aws::Structure
@@ -7752,6 +7788,11 @@ module Aws::EMR
     #   The unique access URL of the Amazon EMR Studio.
     #   @return [String]
     #
+    # @!attribute [rw] auth_mode
+    #   Specifies whether the Studio authenticates users using IAM or Amazon
+    #   Web Services SSO.
+    #   @return [String]
+    #
     # @!attribute [rw] creation_time
     #   The time when the Amazon EMR Studio was created.
     #   @return [Time]
@@ -7764,6 +7805,7 @@ module Aws::EMR
       :vpc_id,
       :description,
       :url,
+      :auth_mode,
       :creation_time)
       SENSITIVE = []
       include Aws::Structure

data/lib/aws-sdk-emr.rb

@@ -49,6 +49,6 @@ require_relative 'aws-sdk-emr/customizations'
 # @!group service
 module Aws::EMR
 
-  GEM_VERSION = '1.51.0'
+  GEM_VERSION = '1.52.0'
 
 end

metadata

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