aws-sdk-emr 1.42.0 → 1.46.0

Sign up to get free protection for your applications and to get access to all the features.
data/VERSION ADDED
@@ -0,0 +1 @@
1
+ 1.46.0
data/lib/aws-sdk-emr.rb CHANGED
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -49,6 +49,6 @@ require_relative 'aws-sdk-emr/customizations'
49
49
  # @!group service
50
50
  module Aws::EMR
51
51
 
52
- GEM_VERSION = '1.42.0'
52
+ GEM_VERSION = '1.46.0'
53
53
 
54
54
  end
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -406,6 +406,11 @@ module Aws::EMR
406
406
  # },
407
407
  # on_demand_specification: {
408
408
  # allocation_strategy: "lowest-price", # required, accepts lowest-price
409
+ # capacity_reservation_options: {
410
+ # usage_strategy: "use-capacity-reservations-first", # accepts use-capacity-reservations-first
411
+ # capacity_reservation_preference: "open", # accepts open, none
412
+ # capacity_reservation_resource_group_arn: "XmlStringMaxLen256",
413
+ # },
409
414
  # },
410
415
  # },
411
416
  # },
@@ -658,7 +663,10 @@ module Aws::EMR
658
663
  # maximum of 256 steps are allowed in each CancelSteps request.
659
664
  # CancelSteps is idempotent but asynchronous; it does not guarantee that
660
665
  # a step will be canceled, even if the request is successfully
661
- # submitted. You can only cancel steps that are in a `PENDING` state.
666
+ # submitted. When you use Amazon EMR versions 5.28.0 and later, you can
667
+ # cancel steps that are in a `PENDING` or `RUNNING` state. In earlier
668
+ # versions of Amazon EMR, you can only cancel steps that are in a
669
+ # `PENDING` state.
662
670
  #
663
671
  # @option params [required, String] :cluster_id
664
672
  # The `ClusterID` for the specified steps that will be canceled. Use
@@ -767,7 +775,7 @@ module Aws::EMR
767
775
  # @option params [required, String] :service_role
768
776
  # The IAM role that will be assumed by the Amazon EMR Studio. The
769
777
  # service role provides a way for Amazon EMR Studio to interoperate with
770
- # other AWS services.
778
+ # other Amazon Web Services services.
771
779
  #
772
780
  # @option params [required, String] :user_role
773
781
  # The IAM user role that will be assumed by users and groups logged in
@@ -786,9 +794,8 @@ module Aws::EMR
786
794
  # security group, and it must be in the same VPC specified by `VpcId`.
787
795
  #
788
796
  # @option params [required, String] :default_s3_location
789
- # The default Amazon S3 location to back up Amazon EMR Studio Workspaces
790
- # and notebook files. A Studio user can select an alternative Amazon S3
791
- # location when creating a Workspace.
797
+ # The Amazon S3 location to back up Amazon EMR Studio Workspaces and
798
+ # notebook files.
792
799
  #
793
800
  # @option params [Array<Types::Tag>] :tags
794
801
  # A list of tags to associate with the Amazon EMR Studio. Tags are
@@ -846,9 +853,10 @@ module Aws::EMR
846
853
  #
847
854
  # @option params [String] :identity_id
848
855
  # The globally unique identifier (GUID) of the user or group from the
849
- # AWS SSO Identity Store. For more information, see [UserId][1] and
850
- # [GroupId][2] in the *AWS SSO Identity Store API Reference*. Either
851
- # `IdentityName` or `IdentityId` must be specified.
856
+ # Amazon Web Services SSO Identity Store. For more information, see
857
+ # [UserId][1] and [GroupId][2] in the *Amazon Web Services SSO Identity
858
+ # Store API Reference*. Either `IdentityName` or `IdentityId` must be
859
+ # specified.
852
860
  #
853
861
  #
854
862
  #
@@ -857,8 +865,9 @@ module Aws::EMR
857
865
  #
858
866
  # @option params [String] :identity_name
859
867
  # The name of the user or group. For more information, see [UserName][1]
860
- # and [DisplayName][2] in the *AWS SSO Identity Store API Reference*.
861
- # Either `IdentityName` or `IdentityId` must be specified.
868
+ # and [DisplayName][2] in the *Amazon Web Services SSO Identity Store
869
+ # API Reference*. Either `IdentityName` or `IdentityId` must be
870
+ # specified.
862
871
  #
863
872
  #
864
873
  #
@@ -871,8 +880,14 @@ module Aws::EMR
871
880
  #
872
881
  # @option params [required, String] :session_policy_arn
873
882
  # The Amazon Resource Name (ARN) for the session policy that will be
874
- # applied to the user or group. Session policies refine Studio user
875
- # permissions without the need to use multiple IAM user roles.
883
+ # applied to the user or group. You should specify the ARN for the
884
+ # session policy that you want to apply, not the ARN of your user role.
885
+ # For more information, see [Create an EMR Studio User Role with Session
886
+ # Policies][1].
887
+ #
888
+ #
889
+ #
890
+ # [1]: https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-studio-user-role.html
876
891
  #
877
892
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
878
893
  #
@@ -947,8 +962,8 @@ module Aws::EMR
947
962
  # @option params [String] :identity_id
948
963
  # The globally unique identifier (GUID) of the user or group to remove
949
964
  # from the Amazon EMR Studio. For more information, see [UserId][1] and
950
- # [GroupId][2] in the *AWS SSO Identity Store API Reference*. Either
951
- # `IdentityName` or `IdentityId` must be specified.
965
+ # [GroupId][2] in the *Amazon Web Services SSO Identity Store API
966
+ # Reference*. Either `IdentityName` or `IdentityId` must be specified.
952
967
  #
953
968
  #
954
969
  #
@@ -958,8 +973,8 @@ module Aws::EMR
958
973
  # @option params [String] :identity_name
959
974
  # The name of the user name or group to remove from the Amazon EMR
960
975
  # Studio. For more information, see [UserName][1] and [DisplayName][2]
961
- # in the *AWS SSO Identity Store API Reference*. Either `IdentityName`
962
- # or `IdentityId` must be specified.
976
+ # in the *Amazon Web Services SSO Store API Reference*. Either
977
+ # `IdentityName` or `IdentityId` must be specified.
963
978
  #
964
979
  #
965
980
  #
@@ -1262,6 +1277,51 @@ module Aws::EMR
1262
1277
  req.send_request(options)
1263
1278
  end
1264
1279
 
1280
+ # Provides EMR release label details, such as releases available the
1281
+ # region where the API request is run, and the available applications
1282
+ # for a specific EMR release label. Can also list EMR release versions
1283
+ # that support a specified version of Spark.
1284
+ #
1285
+ # @option params [String] :release_label
1286
+ # The target release label to be described.
1287
+ #
1288
+ # @option params [String] :next_token
1289
+ # The pagination token. Reserved for future use. Currently set to null.
1290
+ #
1291
+ # @option params [Integer] :max_results
1292
+ # Reserved for future use. Currently set to null.
1293
+ #
1294
+ # @return [Types::DescribeReleaseLabelOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1295
+ #
1296
+ # * {Types::DescribeReleaseLabelOutput#release_label #release_label} => String
1297
+ # * {Types::DescribeReleaseLabelOutput#applications #applications} => Array&lt;Types::SimplifiedApplication&gt;
1298
+ # * {Types::DescribeReleaseLabelOutput#next_token #next_token} => String
1299
+ #
1300
+ # @example Request syntax with placeholder values
1301
+ #
1302
+ # resp = client.describe_release_label({
1303
+ # release_label: "String",
1304
+ # next_token: "String",
1305
+ # max_results: 1,
1306
+ # })
1307
+ #
1308
+ # @example Response structure
1309
+ #
1310
+ # resp.release_label #=> String
1311
+ # resp.applications #=> Array
1312
+ # resp.applications[0].name #=> String
1313
+ # resp.applications[0].version #=> String
1314
+ # resp.next_token #=> String
1315
+ #
1316
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/DescribeReleaseLabel AWS API Documentation
1317
+ #
1318
+ # @overload describe_release_label(params = {})
1319
+ # @param [Hash] params ({})
1320
+ def describe_release_label(params = {}, options = {})
1321
+ req = build_request(:describe_release_label, params)
1322
+ req.send_request(options)
1323
+ end
1324
+
1265
1325
  # Provides the details of a security configuration by returning the
1266
1326
  # configuration JSON.
1267
1327
  #
@@ -1395,7 +1455,7 @@ module Aws::EMR
1395
1455
  req.send_request(options)
1396
1456
  end
1397
1457
 
1398
- # Returns the Amazon EMR block public access configuration for your AWS
1458
+ # Returns the Amazon EMR block public access configuration for your
1399
1459
  # account in the current Region. For more information see [Configure
1400
1460
  # Block Public Access for Amazon EMR][1] in the *Amazon EMR Management
1401
1461
  # Guide*.
@@ -1468,9 +1528,9 @@ module Aws::EMR
1468
1528
  #
1469
1529
  # @option params [String] :identity_id
1470
1530
  # The globally unique identifier (GUID) of the user or group. For more
1471
- # information, see [UserId][1] and [GroupId][2] in the *AWS SSO Identity
1472
- # Store API Reference*. Either `IdentityName` or `IdentityId` must be
1473
- # specified.
1531
+ # information, see [UserId][1] and [GroupId][2] in the *Amazon Web
1532
+ # Services SSO Identity Store API Reference*. Either `IdentityName` or
1533
+ # `IdentityId` must be specified.
1474
1534
  #
1475
1535
  #
1476
1536
  #
@@ -1479,8 +1539,9 @@ module Aws::EMR
1479
1539
  #
1480
1540
  # @option params [String] :identity_name
1481
1541
  # The name of the user or group to fetch. For more information, see
1482
- # [UserName][1] and [DisplayName][2] in the *AWS SSO Identity Store API
1483
- # Reference*. Either `IdentityName` or `IdentityId` must be specified.
1542
+ # [UserName][1] and [DisplayName][2] in the *Amazon Web Services SSO
1543
+ # Identity Store API Reference*. Either `IdentityName` or `IdentityId`
1544
+ # must be specified.
1484
1545
  #
1485
1546
  #
1486
1547
  #
@@ -1564,12 +1625,12 @@ module Aws::EMR
1564
1625
  req.send_request(options)
1565
1626
  end
1566
1627
 
1567
- # Provides the status of all clusters visible to this AWS account.
1568
- # Allows you to filter the list of clusters based on certain criteria;
1569
- # for example, filtering by cluster creation date and time or by status.
1570
- # This call returns a maximum of 50 clusters per call, but returns a
1571
- # marker to track the paging of the cluster list across multiple
1572
- # ListClusters calls.
1628
+ # Provides the status of all clusters visible to this account. Allows
1629
+ # you to filter the list of clusters based on certain criteria; for
1630
+ # example, filtering by cluster creation date and time or by status.
1631
+ # This call returns a maximum of 50 clusters in unsorted order per call,
1632
+ # but returns a marker to track the paging of the cluster list across
1633
+ # multiple ListClusters calls.
1573
1634
  #
1574
1635
  # @option params [Time,DateTime,Date,Integer,String] :created_after
1575
1636
  # The creation date and time beginning value filter for listing
@@ -1579,7 +1640,9 @@ module Aws::EMR
1579
1640
  # The creation date and time end value filter for listing clusters.
1580
1641
  #
1581
1642
  # @option params [Array<String>] :cluster_states
1582
- # The cluster state filters to apply when listing clusters.
1643
+ # The cluster state filters to apply when listing clusters. Clusters
1644
+ # that change state while this action runs may be not be returned as
1645
+ # expected in the list of clusters.
1583
1646
  #
1584
1647
  # @option params [String] :marker
1585
1648
  # The pagination token that indicates the next set of results to
@@ -1691,6 +1754,9 @@ module Aws::EMR
1691
1754
  # resp.instance_fleets[0].launch_specifications.spot_specification.block_duration_minutes #=> Integer
1692
1755
  # resp.instance_fleets[0].launch_specifications.spot_specification.allocation_strategy #=> String, one of "capacity-optimized"
1693
1756
  # resp.instance_fleets[0].launch_specifications.on_demand_specification.allocation_strategy #=> String, one of "lowest-price"
1757
+ # resp.instance_fleets[0].launch_specifications.on_demand_specification.capacity_reservation_options.usage_strategy #=> String, one of "use-capacity-reservations-first"
1758
+ # resp.instance_fleets[0].launch_specifications.on_demand_specification.capacity_reservation_options.capacity_reservation_preference #=> String, one of "open", "none"
1759
+ # resp.instance_fleets[0].launch_specifications.on_demand_specification.capacity_reservation_options.capacity_reservation_resource_group_arn #=> String
1694
1760
  # resp.marker #=> String
1695
1761
  #
1696
1762
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/ListInstanceFleets AWS API Documentation
@@ -1970,6 +2036,60 @@ module Aws::EMR
1970
2036
  req.send_request(options)
1971
2037
  end
1972
2038
 
2039
+ # Retrieves release labels of EMR services in the region where the API
2040
+ # is called.
2041
+ #
2042
+ # @option params [Types::ReleaseLabelFilter] :filters
2043
+ # Filters the results of the request. `Prefix` specifies the prefix of
2044
+ # release labels to return. `Application` specifies the application
2045
+ # (with/without version) of release labels to return.
2046
+ #
2047
+ # @option params [String] :next_token
2048
+ # Specifies the next page of results. If `NextToken` is not specified,
2049
+ # which is usually the case for the first request of ListReleaseLabels,
2050
+ # the first page of results are determined by other filtering parameters
2051
+ # or by the latest version. The `ListReleaseLabels` request fails if the
2052
+ # identity (AWS AccountID) and all filtering parameters are different
2053
+ # from the original request, or if the `NextToken` is expired or
2054
+ # tampered with.
2055
+ #
2056
+ # @option params [Integer] :max_results
2057
+ # Defines the maximum number of release labels to return in a single
2058
+ # response. The default is `100`.
2059
+ #
2060
+ # @return [Types::ListReleaseLabelsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2061
+ #
2062
+ # * {Types::ListReleaseLabelsOutput#release_labels #release_labels} => Array&lt;String&gt;
2063
+ # * {Types::ListReleaseLabelsOutput#next_token #next_token} => String
2064
+ #
2065
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2066
+ #
2067
+ # @example Request syntax with placeholder values
2068
+ #
2069
+ # resp = client.list_release_labels({
2070
+ # filters: {
2071
+ # prefix: "String",
2072
+ # application: "String",
2073
+ # },
2074
+ # next_token: "String",
2075
+ # max_results: 1,
2076
+ # })
2077
+ #
2078
+ # @example Response structure
2079
+ #
2080
+ # resp.release_labels #=> Array
2081
+ # resp.release_labels[0] #=> String
2082
+ # resp.next_token #=> String
2083
+ #
2084
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/ListReleaseLabels AWS API Documentation
2085
+ #
2086
+ # @overload list_release_labels(params = {})
2087
+ # @param [Hash] params ({})
2088
+ def list_release_labels(params = {}, options = {})
2089
+ req = build_request(:list_release_labels, params)
2090
+ req.send_request(options)
2091
+ end
2092
+
1973
2093
  # Lists all the security configurations visible to this account,
1974
2094
  # providing their creation dates and times, and their names. This call
1975
2095
  # returns a maximum of 50 clusters per call, but returns a marker to
@@ -2009,8 +2129,11 @@ module Aws::EMR
2009
2129
  end
2010
2130
 
2011
2131
  # Provides a list of steps for the cluster in reverse order unless you
2012
- # specify `stepIds` with the request of filter by `StepStates`. You can
2013
- # specify a maximum of 10 `stepIDs`.
2132
+ # specify `stepIds` with the request or filter by `StepStates`. You can
2133
+ # specify a maximum of 10 `stepIDs`. The CLI automatically paginates
2134
+ # results to return a list greater than 50 steps. To return more than 50
2135
+ # steps using the CLI, specify a `Marker`, which is a pagination token
2136
+ # that indicates the next set of steps to retrieve.
2014
2137
  #
2015
2138
  # @option params [required, String] :cluster_id
2016
2139
  # The identifier of the cluster for which to list the steps.
@@ -2024,8 +2147,10 @@ module Aws::EMR
2024
2147
  # constraint applies to the overall length of the array.
2025
2148
  #
2026
2149
  # @option params [String] :marker
2027
- # The pagination token that indicates the next set of results to
2028
- # retrieve.
2150
+ # The maximum number of steps that a single `ListSteps` action returns
2151
+ # is 50. To return a longer list of steps, use multiple `ListSteps`
2152
+ # actions along with the `Marker` parameter, which is a pagination token
2153
+ # that indicates the next set of results to retrieve.
2029
2154
  #
2030
2155
  # @return [Types::ListStepsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2031
2156
  #
@@ -2124,9 +2249,9 @@ module Aws::EMR
2124
2249
  req.send_request(options)
2125
2250
  end
2126
2251
 
2127
- # Returns a list of all Amazon EMR Studios associated with the AWS
2128
- # account. The list includes details such as ID, Studio Access URL, and
2129
- # creation time for each Studio.
2252
+ # Returns a list of all Amazon EMR Studios associated with the account.
2253
+ # The list includes details such as ID, Studio Access URL, and creation
2254
+ # time for each Studio.
2130
2255
  #
2131
2256
  # @option params [String] :marker
2132
2257
  # The pagination token that indicates the set of results to retrieve.
@@ -2172,7 +2297,10 @@ module Aws::EMR
2172
2297
  #
2173
2298
  # @option params [Integer] :step_concurrency_level
2174
2299
  # The number of steps that can be executed concurrently. You can specify
2175
- # a maximum of 256 steps.
2300
+ # a minimum of 1 step and a maximum of 256 steps. We recommend that you
2301
+ # do not change this parameter while steps are running or the
2302
+ # `ActionOnFailure` setting may not behave as expected. For more
2303
+ # information see Step$ActionOnFailure.
2176
2304
  #
2177
2305
  # @return [Types::ModifyClusterOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2178
2306
  #
@@ -2212,7 +2340,7 @@ module Aws::EMR
2212
2340
  # The unique identifier of the cluster.
2213
2341
  #
2214
2342
  # @option params [required, Types::InstanceFleetModifyConfig] :instance_fleet
2215
- # The unique identifier of the instance fleet.
2343
+ # The configuration parameters of the instance fleet.
2216
2344
  #
2217
2345
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2218
2346
  #
@@ -2398,7 +2526,7 @@ module Aws::EMR
2398
2526
  end
2399
2527
 
2400
2528
  # Creates or updates an Amazon EMR block public access configuration for
2401
- # your AWS account in the current Region. For more information see
2529
+ # your account in the current Region. For more information see
2402
2530
  # [Configure Block Public Access for Amazon EMR][1] in the *Amazon EMR
2403
2531
  # Management Guide*.
2404
2532
  #
@@ -2625,10 +2753,9 @@ module Aws::EMR
2625
2753
  # value is not provided, logs are not created.
2626
2754
  #
2627
2755
  # @option params [String] :log_encryption_kms_key_id
2628
- # The AWS KMS customer master key (CMK) used for encrypting log files.
2629
- # If a value is not provided, the logs remain encrypted by AES-256. This
2630
- # attribute is only available with Amazon EMR version 5.30.0 and later,
2631
- # excluding Amazon EMR 6.0.0.
2756
+ # The KMS key used for encrypting log files. If a value is not provided,
2757
+ # the logs remain encrypted by AES-256. This attribute is only available
2758
+ # with Amazon EMR version 5.30.0 and later, excluding Amazon EMR 6.0.0.
2632
2759
  #
2633
2760
  # @option params [String] :additional_info
2634
2761
  # A JSON string for selecting additional features.
@@ -2733,10 +2860,22 @@ module Aws::EMR
2733
2860
  # supplied for the EMR cluster you are creating.
2734
2861
  #
2735
2862
  # @option params [Boolean] :visible_to_all_users
2736
- # A value of `true` indicates that all IAM users in the AWS account can
2737
- # perform cluster actions if they have the proper IAM policy
2738
- # permissions. This is the default. A value of `false` indicates that
2739
- # only the IAM user who created the cluster can perform actions.
2863
+ # Set this value to `true` so that IAM principals in the account
2864
+ # associated with the cluster can perform EMR actions on the cluster
2865
+ # that their IAM policies allow. This value defaults to `false` for
2866
+ # clusters created using the EMR API or the CLI [create-cluster][1]
2867
+ # command.
2868
+ #
2869
+ # When set to `false`, only the IAM principal that created the cluster
2870
+ # and the account root user can perform EMR actions for the cluster,
2871
+ # regardless of the IAM permissions policies attached to other IAM
2872
+ # principals. For more information, see [Understanding the EMR Cluster
2873
+ # VisibleToAllUsers Setting][2] in the *Amazon EMR Management Guide*.
2874
+ #
2875
+ #
2876
+ #
2877
+ # [1]: https://docs.aws.amazon.com/cli/latest/reference/emr/create-cluster.html
2878
+ # [2]: https://docs.aws.amazon.com/emr/latest/ManagementGuide/security_iam_emr-with-iam.html#security_set_visible_to_all_users
2740
2879
  #
2741
2880
  # @option params [String] :job_flow_role
2742
2881
  # Also called instance profile and EC2 role. An IAM role for an EMR
@@ -2746,7 +2885,7 @@ module Aws::EMR
2746
2885
  #
2747
2886
  # @option params [String] :service_role
2748
2887
  # The IAM role that will be assumed by the Amazon EMR service to access
2749
- # AWS resources on your behalf.
2888
+ # Amazon Web Services resources on your behalf.
2750
2889
  #
2751
2890
  # @option params [Array<Types::Tag>] :tags
2752
2891
  # A list of tags to associate with a cluster and propagate to Amazon EC2
@@ -2966,6 +3105,11 @@ module Aws::EMR
2966
3105
  # },
2967
3106
  # on_demand_specification: {
2968
3107
  # allocation_strategy: "lowest-price", # required, accepts lowest-price
3108
+ # capacity_reservation_options: {
3109
+ # usage_strategy: "use-capacity-reservations-first", # accepts use-capacity-reservations-first
3110
+ # capacity_reservation_preference: "open", # accepts open, none
3111
+ # capacity_reservation_resource_group_arn: "XmlStringMaxLen256",
3112
+ # },
2969
3113
  # },
2970
3114
  # },
2971
3115
  # },
@@ -3147,25 +3291,32 @@ module Aws::EMR
3147
3291
  req.send_request(options)
3148
3292
  end
3149
3293
 
3150
- # Sets the Cluster$VisibleToAllUsers value, which determines whether the
3151
- # cluster is visible to all IAM users of the AWS account associated with
3152
- # the cluster. Only the IAM user who created the cluster or the AWS
3153
- # account root user can call this action. The default value, `true`,
3154
- # indicates that all IAM users in the AWS account can perform cluster
3155
- # actions if they have the proper IAM policy permissions. If set to
3156
- # `false`, only the IAM user that created the cluster can perform
3157
- # actions. This action works on running clusters. You can override the
3158
- # default `true` setting when you create a cluster by using the
3159
- # `VisibleToAllUsers` parameter with `RunJobFlow`.
3294
+ # Sets the Cluster$VisibleToAllUsers value for an EMR cluster. When
3295
+ # `true`, IAM principals in the account can perform EMR cluster actions
3296
+ # that their IAM policies allow. When `false`, only the IAM principal
3297
+ # that created the cluster and the account root user can perform EMR
3298
+ # actions on the cluster, regardless of IAM permissions policies
3299
+ # attached to other IAM principals.
3300
+ #
3301
+ # This action works on running clusters. When you create a cluster, use
3302
+ # the RunJobFlowInput$VisibleToAllUsers parameter.
3303
+ #
3304
+ # For more information, see [Understanding the EMR Cluster
3305
+ # VisibleToAllUsers Setting][1] in the *Amazon EMR Management Guide*.
3306
+ #
3307
+ #
3308
+ #
3309
+ # [1]: https://docs.aws.amazon.com/emr/latest/ManagementGuide/security_iam_emr-with-iam.html#security_set_visible_to_all_users
3160
3310
  #
3161
3311
  # @option params [required, Array<String>] :job_flow_ids
3162
3312
  # The unique identifier of the job flow (cluster).
3163
3313
  #
3164
3314
  # @option params [required, Boolean] :visible_to_all_users
3165
- # A value of `true` indicates that all IAM users in the AWS account can
3166
- # perform cluster actions if they have the proper IAM policy
3167
- # permissions. This is the default. A value of `false` indicates that
3168
- # only the IAM user who created the cluster can perform actions.
3315
+ # A value of `true` indicates that an IAM principal in the account can
3316
+ # perform EMR actions on the cluster that the IAM policies attached to
3317
+ # the principal allow. A value of `false` indicates that only the IAM
3318
+ # principal that created the cluster and the Amazon Web Services root
3319
+ # user can perform EMR actions on the cluster.
3169
3320
  #
3170
3321
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3171
3322
  #
@@ -3340,9 +3491,8 @@ module Aws::EMR
3340
3491
  # belong to the same VPC as the Studio.
3341
3492
  #
3342
3493
  # @option params [String] :default_s3_location
3343
- # A default Amazon S3 location to back up Workspaces and notebook files
3344
- # for the Amazon EMR Studio. A Studio user can select an alternative
3345
- # Amazon S3 location when creating a Workspace.
3494
+ # The Amazon S3 location to back up Workspaces and notebook files for
3495
+ # the Amazon EMR Studio.
3346
3496
  #
3347
3497
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3348
3498
  #
@@ -3373,9 +3523,9 @@ module Aws::EMR
3373
3523
  #
3374
3524
  # @option params [String] :identity_id
3375
3525
  # The globally unique identifier (GUID) of the user or group. For more
3376
- # information, see [UserId][1] and [GroupId][2] in the *AWS SSO Identity
3377
- # Store API Reference*. Either `IdentityName` or `IdentityId` must be
3378
- # specified.
3526
+ # information, see [UserId][1] and [GroupId][2] in the *Amazon Web
3527
+ # Services SSO Identity Store API Reference*. Either `IdentityName` or
3528
+ # `IdentityId` must be specified.
3379
3529
  #
3380
3530
  #
3381
3531
  #
@@ -3384,8 +3534,9 @@ module Aws::EMR
3384
3534
  #
3385
3535
  # @option params [String] :identity_name
3386
3536
  # The name of the user or group to update. For more information, see
3387
- # [UserName][1] and [DisplayName][2] in the *AWS SSO Identity Store API
3388
- # Reference*. Either `IdentityName` or `IdentityId` must be specified.
3537
+ # [UserName][1] and [DisplayName][2] in the *Amazon Web Services SSO
3538
+ # Identity Store API Reference*. Either `IdentityName` or `IdentityId`
3539
+ # must be specified.
3389
3540
  #
3390
3541
  #
3391
3542
  #
@@ -3433,7 +3584,7 @@ module Aws::EMR
3433
3584
  params: params,
3434
3585
  config: config)
3435
3586
  context[:gem_name] = 'aws-sdk-emr'
3436
- context[:gem_version] = '1.42.0'
3587
+ context[:gem_version] = '1.46.0'
3437
3588
  Seahorse::Client::Request.new(handlers, context)
3438
3589
  end
3439
3590