aws-sdk-emr 1.40.0 → 1.45.0

data/VERSION

@@ -0,0 +1 @@
+1.45.0

data/lib/aws-sdk-emr.rb

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 
@@ -49,6 +49,6 @@ require_relative 'aws-sdk-emr/customizations'
 # @!group service
 module Aws::EMR
 
-  GEM_VERSION = '1.40.0'
+  GEM_VERSION = '1.45.0'
 
 end

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

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 
@@ -406,6 +406,11 @@ module Aws::EMR
     #         },
     #         on_demand_specification: {
     #           allocation_strategy: "lowest-price", # required, accepts lowest-price
+    #           capacity_reservation_options: {
+    #             usage_strategy: "use-capacity-reservations-first", # accepts use-capacity-reservations-first
+    #             capacity_reservation_preference: "open", # accepts open, none
+    #             capacity_reservation_resource_group_arn: "XmlStringMaxLen256",
+    #           },
     #         },
     #       },
     #     },
@@ -741,18 +746,13 @@ module Aws::EMR
       req.send_request(options)
     end
 
-    # <note markdown="1"> The Amazon EMR Studio APIs are in preview release for Amazon EMR and
-    # are subject to change.
-    #
-    #  </note>
-    #
     # Creates a new Amazon EMR Studio.
     #
     # @option params [required, String] :name
     #   A descriptive name for the Amazon EMR Studio.
     #
     # @option params [String] :description
-    #   A detailed description of the Studio.
+    #   A detailed description of the Amazon EMR Studio.
     #
     # @option params [required, String] :auth_mode
     #   Specifies whether the Studio authenticates users using single sign-on
@@ -764,9 +764,10 @@ module Aws::EMR
     #   with the Studio.
     #
     # @option params [required, Array<String>] :subnet_ids
-    #   A list of subnet IDs to associate with the Studio. The subnets must
-    #   belong to the VPC specified by `VpcId`. Studio users can create a
-    #   Workspace in any of the specified subnets.
+    #   A list of subnet IDs to associate with the Amazon EMR Studio. A Studio
+    #   can have a maximum of 5 subnets. The subnets must belong to the VPC
+    #   specified by `VpcId`. Studio users can create a Workspace in any of
+    #   the specified subnets.
     #
     # @option params [required, String] :service_role
     #   The IAM role that will be assumed by the Amazon EMR Studio. The
@@ -775,8 +776,8 @@ module Aws::EMR
     #
     # @option params [required, String] :user_role
     #   The IAM user role that will be assumed by users and groups logged in
-    #   to a Studio. The permissions attached to this IAM role can be scoped
-    #   down for each user or group using session policies.
+    #   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 [required, String] :workspace_security_group_id
     #   The ID of the Amazon EMR Studio Workspace security group. The
@@ -789,16 +790,15 @@ module Aws::EMR
     #   security group allows inbound network traffic from the Workspace
     #   security group, and it must be in the same VPC specified by `VpcId`.
     #
-    # @option params [String] :default_s3_location
-    #   The default Amazon S3 location to back up EMR Studio Workspaces and
-    #   notebook files. A Studio user can select an alternative Amazon S3
-    #   location when creating a Workspace.
+    # @option params [required, String] :default_s3_location
+    #   The Amazon S3 location to back up Amazon EMR Studio Workspaces and
+    #   notebook files.
     #
     # @option params [Array<Types::Tag>] :tags
-    #   A list of tags to associate with the Studio. 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 the Amazon EMR Studio. 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 [Types::CreateStudioOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -817,7 +817,7 @@ module Aws::EMR
     #     user_role: "XmlString", # required
     #     workspace_security_group_id: "XmlStringMaxLen256", # required
     #     engine_security_group_id: "XmlStringMaxLen256", # required
-    #     default_s3_location: "XmlString",
+    #     default_s3_location: "XmlString", # required
     #     tags: [
     #       {
     #         key: "String",
@@ -840,11 +840,6 @@ module Aws::EMR
       req.send_request(options)
     end
 
-    # <note markdown="1"> The Amazon EMR Studio APIs are in preview release for Amazon EMR and
-    # are subject to change.
-    #
-    #  </note>
-    #
     # 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.
@@ -871,12 +866,12 @@ module Aws::EMR
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId
+    #   [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName
     #   [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName
     #
     # @option params [required, String] :identity_type
-    #   Specifies whether the identity to map to the Studio is a user or a
-    #   group.
+    #   Specifies whether the identity to map to the Amazon EMR Studio is a
+    #   user or a group.
     #
     # @option params [required, String] :session_policy_arn
     #   The Amazon Resource Name (ARN) for the session policy that will be
@@ -926,11 +921,6 @@ module Aws::EMR
       req.send_request(options)
     end
 
-    # <note markdown="1"> The Amazon EMR Studio APIs are in preview release for Amazon EMR and
-    # are subject to change.
-    #
-    #  </note>
-    #
     # Removes an Amazon EMR Studio from the Studio metadata store.
     #
     # @option params [required, String] :studio_id
@@ -953,11 +943,6 @@ module Aws::EMR
       req.send_request(options)
     end
 
-    # <note markdown="1"> The Amazon EMR Studio APIs are in preview release for Amazon EMR and
-    # are subject to change.
-    #
-    #  </note>
-    #
     # Removes a user or group from an Amazon EMR Studio.
     #
     # @option params [required, String] :studio_id
@@ -975,19 +960,19 @@ module Aws::EMR
     #   [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId
     #
     # @option params [String] :identity_name
-    #   The name of the user name or group to remove from the Studio. For more
-    #   information, see [UserName][1] and [DisplayName][2] in the *AWS SSO
-    #   Identity Store API Reference*. Either `IdentityName` or `IdentityId`
-    #   must be specified.
+    #   The name of the user name or group to remove from the Amazon EMR
+    #   Studio. For more information, see [UserName][1] and [DisplayName][2]
+    #   in the *AWS SSO Identity Store API Reference*. Either `IdentityName`
+    #   or `IdentityId` must be specified.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId
+    #   [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName
     #   [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName
     #
     # @option params [required, String] :identity_type
-    #   Specifies whether the identity to delete from the Studio is a user or
-    #   a group.
+    #   Specifies whether the identity to delete from the Amazon EMR Studio is
+    #   a user or a group.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1368,11 +1353,6 @@ module Aws::EMR
       req.send_request(options)
     end
 
-    # <note markdown="1"> The Amazon EMR Studio APIs are in preview release for Amazon EMR and
-    # are subject to change.
-    #
-    #  </note>
-    #
     # Returns details for the specified Amazon EMR Studio including ID,
     # Name, VPC, Studio access URL, and so on.
     #
@@ -1484,11 +1464,6 @@ module Aws::EMR
       req.send_request(options)
     end
 
-    # <note markdown="1"> The Amazon EMR Studio APIs are in preview release for Amazon EMR and
-    # are subject to change.
-    #
-    #  </note>
-    #
     # Fetches mapping details for the specified Amazon EMR Studio and
     # identity (user or group).
     #
@@ -1513,7 +1488,7 @@ module Aws::EMR
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId
+    #   [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName
     #   [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName
     #
     # @option params [required, String] :identity_type
@@ -1720,6 +1695,9 @@ module Aws::EMR
     #   resp.instance_fleets[0].launch_specifications.spot_specification.block_duration_minutes #=> Integer
     #   resp.instance_fleets[0].launch_specifications.spot_specification.allocation_strategy #=> String, one of "capacity-optimized"
     #   resp.instance_fleets[0].launch_specifications.on_demand_specification.allocation_strategy #=> String, one of "lowest-price"
+    #   resp.instance_fleets[0].launch_specifications.on_demand_specification.capacity_reservation_options.usage_strategy #=> String, one of "use-capacity-reservations-first"
+    #   resp.instance_fleets[0].launch_specifications.on_demand_specification.capacity_reservation_options.capacity_reservation_preference #=> String, one of "open", "none"
+    #   resp.instance_fleets[0].launch_specifications.on_demand_specification.capacity_reservation_options.capacity_reservation_resource_group_arn #=> String
     #   resp.marker #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/ListInstanceFleets AWS API Documentation
@@ -2039,7 +2017,7 @@ module Aws::EMR
 
     # Provides a list of steps for the cluster in reverse order unless you
     # specify `stepIds` with the request of filter by `StepStates`. You can
-    # specify a maximum of ten `stepIDs`.
+    # specify a maximum of 10 `stepIDs`.
     #
     # @option params [required, String] :cluster_id
     #   The identifier of the cluster for which to list the steps.
@@ -2104,13 +2082,8 @@ module Aws::EMR
       req.send_request(options)
     end
 
-    # <note markdown="1"> The Amazon EMR Studio APIs are in preview release for Amazon EMR and
-    # are subject to change.
-    #
-    #  </note>
-    #
-    # Returns a list of all user or group session mappings for the EMR
-    # Studio specified by `StudioId`.
+    # Returns a list of all user or group session mappings for the Amazon
+    # EMR Studio specified by `StudioId`.
     #
     # @option params [String] :studio_id
     #   The ID of the Amazon EMR Studio.
@@ -2158,11 +2131,6 @@ module Aws::EMR
       req.send_request(options)
     end
 
-    # <note markdown="1"> The Amazon EMR Studio APIs are in preview release for Amazon EMR and
-    # are subject to change.
-    #
-    #  </note>
-    #
     # Returns a list of all Amazon EMR Studios associated with the AWS
     # account. The list includes details such as ID, Studio Access URL, and
     # creation time for each Studio.
@@ -2211,7 +2179,7 @@ module Aws::EMR
     #
     # @option params [Integer] :step_concurrency_level
     #   The number of steps that can be executed concurrently. You can specify
-    #   a maximum of 256 steps.
+    #   a minimum of 1 step and a maximum of 256 steps.
     #
     # @return [Types::ModifyClusterOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2743,7 +2711,7 @@ module Aws::EMR
     #
     #   * "mapr-m7" - launch the cluster using MapR M7 Edition.
     #
-    #   * "hunk" - launch the cluster with the Hunk Big Data Analtics
+    #   * "hunk" - launch the cluster with the Hunk Big Data Analytics
     #     Platform.
     #
     #   * "hue"- launch the cluster with Hue installed.
@@ -3005,6 +2973,11 @@ module Aws::EMR
     #             },
     #             on_demand_specification: {
     #               allocation_strategy: "lowest-price", # required, accepts lowest-price
+    #               capacity_reservation_options: {
+    #                 usage_strategy: "use-capacity-reservations-first", # accepts use-capacity-reservations-first
+    #                 capacity_reservation_preference: "open", # accepts open, none
+    #                 capacity_reservation_resource_group_arn: "XmlStringMaxLen256",
+    #               },
     #             },
     #           },
     #         },
@@ -3359,16 +3332,55 @@ module Aws::EMR
       req.send_request(options)
     end
 
-    # <note markdown="1"> The Amazon EMR Studio APIs are in preview release for Amazon EMR and
-    # are subject to change.
+    # Updates an Amazon EMR Studio configuration, including attributes such
+    # as name, description, and subnets.
     #
-    #  </note>
+    # @option params [required, String] :studio_id
+    #   The ID of the Amazon EMR Studio to update.
+    #
+    # @option params [String] :name
+    #   A descriptive name for the Amazon EMR Studio.
+    #
+    # @option params [String] :description
+    #   A detailed description to assign to the Amazon EMR Studio.
+    #
+    # @option params [Array<String>] :subnet_ids
+    #   A list of subnet IDs to associate with the Amazon EMR Studio. The list
+    #   can include new subnet IDs, but must also include all of the subnet
+    #   IDs previously associated with the Studio. The list order does not
+    #   matter. A Studio can have a maximum of 5 subnets. The subnets must
+    #   belong to the same VPC as the Studio.
+    #
+    # @option params [String] :default_s3_location
+    #   The Amazon S3 location to back up Workspaces and notebook files for
+    #   the Amazon EMR Studio.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_studio({
+    #     studio_id: "XmlStringMaxLen256", # required
+    #     name: "XmlStringMaxLen256",
+    #     description: "XmlStringMaxLen256",
+    #     subnet_ids: ["String"],
+    #     default_s3_location: "XmlString",
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/UpdateStudio AWS API Documentation
+    #
+    # @overload update_studio(params = {})
+    # @param [Hash] params ({})
+    def update_studio(params = {}, options = {})
+      req = build_request(:update_studio, params)
+      req.send_request(options)
+    end
+
     # Updates the session policy attached to the user or group for the
     # specified Amazon EMR Studio.
     #
     # @option params [required, String] :studio_id
-    #   The ID of the EMR Studio.
+    #   The ID of the Amazon EMR Studio.
     #
     # @option params [String] :identity_id
     #   The globally unique identifier (GUID) of the user or group. For more
@@ -3388,7 +3400,7 @@ module Aws::EMR
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId
+    #   [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName
     #   [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName
     #
     # @option params [required, String] :identity_type
@@ -3432,7 +3444,7 @@ module Aws::EMR
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-emr'
-      context[:gem_version] = '1.40.0'
+      context[:gem_version] = '1.45.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 
@@ -207,6 +207,9 @@ module Aws::EMR
     NotebookExecutionStatus = Shapes::StringShape.new(name: 'NotebookExecutionStatus')
     NotebookExecutionSummary = Shapes::StructureShape.new(name: 'NotebookExecutionSummary')
     NotebookExecutionSummaryList = Shapes::ListShape.new(name: 'NotebookExecutionSummaryList')
+    OnDemandCapacityReservationOptions = Shapes::StructureShape.new(name: 'OnDemandCapacityReservationOptions')
+    OnDemandCapacityReservationPreference = Shapes::StringShape.new(name: 'OnDemandCapacityReservationPreference')
+    OnDemandCapacityReservationUsageStrategy = Shapes::StringShape.new(name: 'OnDemandCapacityReservationUsageStrategy')
     OnDemandProvisioningAllocationStrategy = Shapes::StringShape.new(name: 'OnDemandProvisioningAllocationStrategy')
     OnDemandProvisioningSpecification = Shapes::StructureShape.new(name: 'OnDemandProvisioningSpecification')
     OptionalArnType = Shapes::StringShape.new(name: 'OptionalArnType')
@@ -288,6 +291,7 @@ module Aws::EMR
     TagList = Shapes::ListShape.new(name: 'TagList')
     TerminateJobFlowsInput = Shapes::StructureShape.new(name: 'TerminateJobFlowsInput')
     Unit = Shapes::StringShape.new(name: 'Unit')
+    UpdateStudioInput = Shapes::StructureShape.new(name: 'UpdateStudioInput')
     UpdateStudioSessionMappingInput = Shapes::StructureShape.new(name: 'UpdateStudioSessionMappingInput')
     VolumeSpecification = Shapes::StructureShape.new(name: 'VolumeSpecification')
     WholeNumber = Shapes::IntegerShape.new(name: 'WholeNumber')
@@ -493,7 +497,7 @@ module Aws::EMR
     CreateStudioInput.add_member(:user_role, Shapes::ShapeRef.new(shape: XmlString, required: true, 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, location_name: "DefaultS3Location"))
+    CreateStudioInput.add_member(:default_s3_location, Shapes::ShapeRef.new(shape: XmlString, required: true, location_name: "DefaultS3Location"))
     CreateStudioInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
     CreateStudioInput.struct_class = Types::CreateStudioInput
 
@@ -1057,7 +1061,13 @@ module Aws::EMR
 
     NotebookExecutionSummaryList.member = Shapes::ShapeRef.new(shape: NotebookExecutionSummary)
 
+    OnDemandCapacityReservationOptions.add_member(:usage_strategy, Shapes::ShapeRef.new(shape: OnDemandCapacityReservationUsageStrategy, location_name: "UsageStrategy"))
+    OnDemandCapacityReservationOptions.add_member(:capacity_reservation_preference, Shapes::ShapeRef.new(shape: OnDemandCapacityReservationPreference, location_name: "CapacityReservationPreference"))
+    OnDemandCapacityReservationOptions.add_member(:capacity_reservation_resource_group_arn, Shapes::ShapeRef.new(shape: XmlStringMaxLen256, location_name: "CapacityReservationResourceGroupArn"))
+    OnDemandCapacityReservationOptions.struct_class = Types::OnDemandCapacityReservationOptions
+
     OnDemandProvisioningSpecification.add_member(:allocation_strategy, Shapes::ShapeRef.new(shape: OnDemandProvisioningAllocationStrategy, required: true, location_name: "AllocationStrategy"))
+    OnDemandProvisioningSpecification.add_member(:capacity_reservation_options, Shapes::ShapeRef.new(shape: OnDemandCapacityReservationOptions, location_name: "CapacityReservationOptions"))
     OnDemandProvisioningSpecification.struct_class = Types::OnDemandProvisioningSpecification
 
     PlacementGroupConfig.add_member(:instance_role, Shapes::ShapeRef.new(shape: InstanceRoleType, required: true, location_name: "InstanceRole"))
@@ -1341,6 +1351,13 @@ module Aws::EMR
     TerminateJobFlowsInput.add_member(:job_flow_ids, Shapes::ShapeRef.new(shape: XmlStringList, required: true, location_name: "JobFlowIds"))
     TerminateJobFlowsInput.struct_class = Types::TerminateJobFlowsInput
 
+    UpdateStudioInput.add_member(:studio_id, Shapes::ShapeRef.new(shape: XmlStringMaxLen256, required: true, location_name: "StudioId"))
+    UpdateStudioInput.add_member(:name, Shapes::ShapeRef.new(shape: XmlStringMaxLen256, location_name: "Name"))
+    UpdateStudioInput.add_member(:description, Shapes::ShapeRef.new(shape: XmlStringMaxLen256, location_name: "Description"))
+    UpdateStudioInput.add_member(:subnet_ids, Shapes::ShapeRef.new(shape: SubnetIdList, location_name: "SubnetIds"))
+    UpdateStudioInput.add_member(:default_s3_location, Shapes::ShapeRef.new(shape: XmlString, location_name: "DefaultS3Location"))
+    UpdateStudioInput.struct_class = Types::UpdateStudioInput
+
     UpdateStudioSessionMappingInput.add_member(:studio_id, Shapes::ShapeRef.new(shape: XmlStringMaxLen256, required: true, location_name: "StudioId"))
     UpdateStudioSessionMappingInput.add_member(:identity_id, Shapes::ShapeRef.new(shape: XmlStringMaxLen256, location_name: "IdentityId"))
     UpdateStudioSessionMappingInput.add_member(:identity_name, Shapes::ShapeRef.new(shape: XmlStringMaxLen256, location_name: "IdentityName"))
@@ -1859,6 +1876,16 @@ module Aws::EMR
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
       end)
 
+      api.add_operation(:update_studio, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "UpdateStudio"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: UpdateStudioInput)
+        o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+      end)
+
       api.add_operation(:update_studio_session_mapping, Seahorse::Model::Operation.new.tap do |o|
         o.name = "UpdateStudioSessionMapping"
         o.http_method = "POST"