aws-sdk-emr 1.48.0 → 1.52.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 2e71d51aad190b33c50683ed87c6c51bef0acc6280c0953393aa7412314ad0a2
4
- data.tar.gz: 64d12228d07aa2300363cd7b604b76d474e177c763c2aec04ef813ebd5027df5
3
+ metadata.gz: 42a286ab147260cb668f85ebba3485e70a16d1a2af7556e9ed0dfc81131f651a
4
+ data.tar.gz: 6581d0af1e255d9b3ad6336b9fe4673fa6d0df21db5dd2185b16855944cc8a20
5
5
  SHA512:
6
- metadata.gz: 6afda745bd2287178acec8390a61be757b1c6a4c6df8850d4fcce3e169322fc12d83652e014b66b753ed47e58e6b6e1ad773909d926e56c72413afca06ccb738
7
- data.tar.gz: d937d55d9eb732b17094073942a650724ce2fa7359472f114845eedd855d4a2d5278b111a128ecff91ee9b5fd98bff4f833ee6f44d5df1d950cf34ce04b84cae
6
+ metadata.gz: bac8e32daec1f4f810c2435c62c1516f8aca959fea9b278ab52eefc0cb1408bdea5b0e358bbbbaeff4ba319fff03881ce3a495ed86122fa44f821d216baed31c
7
+ data.tar.gz: 429803b334541b0c3bf8a00ed014a53f36c08795e3e2bfc87e2ba91de81ef50d17037fb6f124fa54f0eb7a29871fc7d2f8ed44370d90153599a20916d9d71fbb
data/CHANGELOG.md CHANGED
@@ -1,6 +1,26 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.52.0 (2021-09-09)
5
+ ------------------
6
+
7
+ * 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.
8
+
9
+ 1.51.0 (2021-09-01)
10
+ ------------------
11
+
12
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
13
+
14
+ 1.50.0 (2021-08-27)
15
+ ------------------
16
+
17
+ * Feature - Amazon EMR now supports auto-terminating idle EMR clusters. You can specify the idle timeout value when enabling auto-termination for both running and new clusters and Amazon EMR automatically terminates the cluster when idle timeout kicks in.
18
+
19
+ 1.49.0 (2021-08-13)
20
+ ------------------
21
+
22
+ * Feature - Amazon EMR customers can now specify custom AMIs at the instance level in their clusters. This allows using custom AMIs in clusters that have instances with different instruction set architectures, e.g. m5.xlarge (x86) and m6g.xlarge (ARM).
23
+
4
24
  1.48.0 (2021-07-30)
5
25
  ------------------
6
26
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.48.0
1
+ 1.52.0
@@ -395,6 +395,7 @@ module Aws::EMR
395
395
  # },
396
396
  # },
397
397
  # ],
398
+ # custom_ami_id: "XmlStringMaxLen256",
398
399
  # },
399
400
  # ],
400
401
  # launch_specifications: {
@@ -518,6 +519,7 @@ module Aws::EMR
518
519
  # },
519
520
  # ],
520
521
  # },
522
+ # custom_ami_id: "XmlStringMaxLen256",
521
523
  # },
522
524
  # ],
523
525
  # job_flow_id: "XmlStringMaxLen256", # required
@@ -616,24 +618,24 @@ module Aws::EMR
616
618
  req.send_request(options)
617
619
  end
618
620
 
619
- # Adds tags to an Amazon EMR resource. Tags make it easier to associate
620
- # clusters in various ways, such as grouping clusters to track your
621
- # Amazon EMR resource allocation costs. For more information, see [Tag
622
- # Clusters][1].
621
+ # Adds tags to an Amazon EMR resource, such as a cluster or an Amazon
622
+ # EMR Studio. Tags make it easier to associate resources in various
623
+ # ways, such as grouping clusters to track your Amazon EMR resource
624
+ # allocation costs. For more information, see [Tag Clusters][1].
623
625
  #
624
626
  #
625
627
  #
626
628
  # [1]: https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-tags.html
627
629
  #
628
630
  # @option params [required, String] :resource_id
629
- # The Amazon EMR resource identifier to which tags will be added. This
630
- # value must be a cluster identifier.
631
+ # The Amazon EMR resource identifier to which tags will be added. For
632
+ # example, a cluster identifier or an Amazon EMR Studio ID.
631
633
  #
632
634
  # @option params [required, Array<Types::Tag>] :tags
633
- # A list of tags to associate with a cluster and propagate to EC2
634
- # instances. Tags are user-defined key-value pairs that consist of a
635
- # required key string with a maximum of 128 characters, and an optional
636
- # value string with a maximum of 256 characters.
635
+ # A list of tags to associate with a resource. Tags are user-defined
636
+ # key-value pairs that consist of a required key string with a maximum
637
+ # of 128 characters, and an optional value string with a maximum of 256
638
+ # characters.
637
639
  #
638
640
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
639
641
  #
@@ -758,9 +760,8 @@ module Aws::EMR
758
760
  # A detailed description of the Amazon EMR Studio.
759
761
  #
760
762
  # @option params [required, String] :auth_mode
761
- # Specifies whether the Studio authenticates users using single sign-on
762
- # (SSO) or IAM. Amazon EMR Studio currently only supports SSO
763
- # authentication.
763
+ # Specifies whether the Studio authenticates users using IAM or Amazon
764
+ # Web Services SSO.
764
765
  #
765
766
  # @option params [required, String] :vpc_id
766
767
  # The ID of the Amazon Virtual Private Cloud (Amazon VPC) to associate
@@ -773,14 +774,16 @@ module Aws::EMR
773
774
  # the specified subnets.
774
775
  #
775
776
  # @option params [required, String] :service_role
776
- # The IAM role that will be assumed by the Amazon EMR Studio. The
777
- # service role provides a way for Amazon EMR Studio to interoperate with
778
- # other Amazon Web Services services.
777
+ # The IAM role that the Amazon EMR Studio assumes. The service role
778
+ # provides a way for Amazon EMR Studio to interoperate with other Amazon
779
+ # Web Services services.
779
780
  #
780
- # @option params [required, String] :user_role
781
- # The IAM user role that will be assumed by users and groups logged in
782
- # to an Amazon EMR Studio. The permissions attached to this IAM role can
783
- # be scoped down for each user or group using session policies.
781
+ # @option params [String] :user_role
782
+ # The IAM user role that users and groups assume when logged in to an
783
+ # Amazon EMR Studio. Only specify a `UserRole` when you use Amazon Web
784
+ # Services SSO authentication. The permissions attached to the
785
+ # `UserRole` can be scoped down for each user or group using session
786
+ # policies.
784
787
  #
785
788
  # @option params [required, String] :workspace_security_group_id
786
789
  # The ID of the Amazon EMR Studio Workspace security group. The
@@ -797,6 +800,20 @@ module Aws::EMR
797
800
  # The Amazon S3 location to back up Amazon EMR Studio Workspaces and
798
801
  # notebook files.
799
802
  #
803
+ # @option params [String] :idp_auth_url
804
+ # The authentication endpoint of your identity provider (IdP). Specify
805
+ # this value when you use IAM authentication and want to let federated
806
+ # users log in to a Studio with the Studio URL and credentials from your
807
+ # IdP. Amazon EMR Studio redirects users to this endpoint to enter
808
+ # credentials.
809
+ #
810
+ # @option params [String] :idp_relay_state_parameter_name
811
+ # The name that your identity provider (IdP) uses for its `RelayState`
812
+ # parameter. For example, `RelayState` or `TargetSource`. Specify this
813
+ # value when you use IAM authentication and want to let federated users
814
+ # log in to a Studio using the Studio URL. The `RelayState` parameter
815
+ # differs by IdP.
816
+ #
800
817
  # @option params [Array<Types::Tag>] :tags
801
818
  # A list of tags to associate with the Amazon EMR Studio. Tags are
802
819
  # user-defined key-value pairs that consist of a required key string
@@ -817,10 +834,12 @@ module Aws::EMR
817
834
  # vpc_id: "XmlStringMaxLen256", # required
818
835
  # subnet_ids: ["String"], # required
819
836
  # service_role: "XmlString", # required
820
- # user_role: "XmlString", # required
837
+ # user_role: "XmlString",
821
838
  # workspace_security_group_id: "XmlStringMaxLen256", # required
822
839
  # engine_security_group_id: "XmlStringMaxLen256", # required
823
840
  # default_s3_location: "XmlString", # required
841
+ # idp_auth_url: "XmlString",
842
+ # idp_relay_state_parameter_name: "XmlStringMaxLen256",
824
843
  # tags: [
825
844
  # {
826
845
  # key: "String",
@@ -845,7 +864,14 @@ module Aws::EMR
845
864
 
846
865
  # Maps a user or group to the Amazon EMR Studio specified by `StudioId`,
847
866
  # and applies a session policy to refine Studio permissions for that
848
- # user or group.
867
+ # user or group. Use `CreateStudioSessionMapping` to assign users to a
868
+ # Studio when you use Amazon Web Services SSO authentication. For
869
+ # instructions on how to assign users to a Studio when you use IAM
870
+ # authentication, see [Assign a user or group to your EMR Studio][1].
871
+ #
872
+ #
873
+ #
874
+ # [1]: https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-studio-manage-users.html#emr-studio-assign-users-groups
849
875
  #
850
876
  # @option params [required, String] :studio_id
851
877
  # The ID of the Amazon EMR Studio to which the user or group will be
@@ -856,7 +882,7 @@ module Aws::EMR
856
882
  # Amazon Web Services SSO Identity Store. For more information, see
857
883
  # [UserId][1] and [GroupId][2] in the *Amazon Web Services SSO Identity
858
884
  # Store API Reference*. Either `IdentityName` or `IdentityId` must be
859
- # specified.
885
+ # specified, but not both.
860
886
  #
861
887
  #
862
888
  #
@@ -867,7 +893,7 @@ module Aws::EMR
867
893
  # The name of the user or group. For more information, see [UserName][1]
868
894
  # and [DisplayName][2] in the *Amazon Web Services SSO Identity Store
869
895
  # API Reference*. Either `IdentityName` or `IdentityId` must be
870
- # specified.
896
+ # specified, but not both.
871
897
  #
872
898
  #
873
899
  #
@@ -1187,6 +1213,7 @@ module Aws::EMR
1187
1213
  # resp.job_flows[0].instances.instance_groups[0].start_date_time #=> Time
1188
1214
  # resp.job_flows[0].instances.instance_groups[0].ready_date_time #=> Time
1189
1215
  # resp.job_flows[0].instances.instance_groups[0].end_date_time #=> Time
1216
+ # resp.job_flows[0].instances.instance_groups[0].custom_ami_id #=> String
1190
1217
  # resp.job_flows[0].instances.normalized_instance_hours #=> Integer
1191
1218
  # resp.job_flows[0].instances.ec2_key_name #=> String
1192
1219
  # resp.job_flows[0].instances.ec2_subnet_id #=> String
@@ -1442,6 +1469,8 @@ module Aws::EMR
1442
1469
  # resp.studio.url #=> String
1443
1470
  # resp.studio.creation_time #=> Time
1444
1471
  # resp.studio.default_s3_location #=> String
1472
+ # resp.studio.idp_auth_url #=> String
1473
+ # resp.studio.idp_relay_state_parameter_name #=> String
1445
1474
  # resp.studio.tags #=> Array
1446
1475
  # resp.studio.tags[0].key #=> String
1447
1476
  # resp.studio.tags[0].value #=> String
@@ -1455,10 +1484,39 @@ module Aws::EMR
1455
1484
  req.send_request(options)
1456
1485
  end
1457
1486
 
1487
+ # Returns the auto-termination policy for an Amazon EMR cluster.
1488
+ #
1489
+ # @option params [required, String] :cluster_id
1490
+ # Specifies the ID of the Amazon EMR cluster for which the
1491
+ # auto-termination policy will be fetched.
1492
+ #
1493
+ # @return [Types::GetAutoTerminationPolicyOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1494
+ #
1495
+ # * {Types::GetAutoTerminationPolicyOutput#auto_termination_policy #auto_termination_policy} => Types::AutoTerminationPolicy
1496
+ #
1497
+ # @example Request syntax with placeholder values
1498
+ #
1499
+ # resp = client.get_auto_termination_policy({
1500
+ # cluster_id: "ClusterId", # required
1501
+ # })
1502
+ #
1503
+ # @example Response structure
1504
+ #
1505
+ # resp.auto_termination_policy.idle_timeout #=> Integer
1506
+ #
1507
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/GetAutoTerminationPolicy AWS API Documentation
1508
+ #
1509
+ # @overload get_auto_termination_policy(params = {})
1510
+ # @param [Hash] params ({})
1511
+ def get_auto_termination_policy(params = {}, options = {})
1512
+ req = build_request(:get_auto_termination_policy, params)
1513
+ req.send_request(options)
1514
+ end
1515
+
1458
1516
  # Returns the Amazon EMR block public access configuration for your
1459
- # account in the current Region. For more information see [Configure
1460
- # Block Public Access for Amazon EMR][1] in the *Amazon EMR Management
1461
- # Guide*.
1517
+ # Amazon Web Services account in the current Region. For more
1518
+ # information see [Configure Block Public Access for Amazon EMR][1] in
1519
+ # the *Amazon EMR Management Guide*.
1462
1520
  #
1463
1521
  #
1464
1522
  #
@@ -1625,12 +1683,12 @@ module Aws::EMR
1625
1683
  req.send_request(options)
1626
1684
  end
1627
1685
 
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.
1686
+ # Provides the status of all clusters visible to this Amazon Web
1687
+ # Services account. Allows you to filter the list of clusters based on
1688
+ # certain criteria; for example, filtering by cluster creation date and
1689
+ # time or by status. This call returns a maximum of 50 clusters in
1690
+ # unsorted order per call, but returns a marker to track the paging of
1691
+ # the cluster list across multiple ListClusters calls.
1634
1692
  #
1635
1693
  # @option params [Time,DateTime,Date,Integer,String] :created_after
1636
1694
  # The creation date and time beginning value filter for listing
@@ -1749,6 +1807,7 @@ module Aws::EMR
1749
1807
  # resp.instance_fleets[0].instance_type_specifications[0].ebs_block_devices[0].volume_specification.size_in_gb #=> Integer
1750
1808
  # resp.instance_fleets[0].instance_type_specifications[0].ebs_block_devices[0].device #=> String
1751
1809
  # resp.instance_fleets[0].instance_type_specifications[0].ebs_optimized #=> Boolean
1810
+ # resp.instance_fleets[0].instance_type_specifications[0].custom_ami_id #=> String
1752
1811
  # resp.instance_fleets[0].launch_specifications.spot_specification.timeout_duration_minutes #=> Integer
1753
1812
  # resp.instance_fleets[0].launch_specifications.spot_specification.timeout_action #=> String, one of "SWITCH_TO_ON_DEMAND", "TERMINATE_CLUSTER"
1754
1813
  # resp.instance_fleets[0].launch_specifications.spot_specification.block_duration_minutes #=> Integer
@@ -1855,6 +1914,7 @@ module Aws::EMR
1855
1914
  # resp.instance_groups[0].auto_scaling_policy.rules[0].trigger.cloud_watch_alarm_definition.dimensions #=> Array
1856
1915
  # resp.instance_groups[0].auto_scaling_policy.rules[0].trigger.cloud_watch_alarm_definition.dimensions[0].key #=> String
1857
1916
  # resp.instance_groups[0].auto_scaling_policy.rules[0].trigger.cloud_watch_alarm_definition.dimensions[0].value #=> String
1917
+ # resp.instance_groups[0].custom_ami_id #=> String
1858
1918
  # resp.marker #=> String
1859
1919
  #
1860
1920
  # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/ListInstanceGroups AWS API Documentation
@@ -2049,9 +2109,9 @@ module Aws::EMR
2049
2109
  # which is usually the case for the first request of ListReleaseLabels,
2050
2110
  # the first page of results are determined by other filtering parameters
2051
2111
  # 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.
2112
+ # identity (Amazon Web Services account ID) and all filtering parameters
2113
+ # are different from the original request, or if the `NextToken` is
2114
+ # expired or tampered with.
2055
2115
  #
2056
2116
  # @option params [Integer] :max_results
2057
2117
  # Defines the maximum number of release labels to return in a single
@@ -2249,9 +2309,9 @@ module Aws::EMR
2249
2309
  req.send_request(options)
2250
2310
  end
2251
2311
 
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.
2312
+ # Returns a list of all Amazon EMR Studios associated with the Amazon
2313
+ # Web Services account. The list includes details such as ID, Studio
2314
+ # Access URL, and creation time for each Studio.
2255
2315
  #
2256
2316
  # @option params [String] :marker
2257
2317
  # The pagination token that indicates the set of results to retrieve.
@@ -2277,6 +2337,7 @@ module Aws::EMR
2277
2337
  # resp.studios[0].vpc_id #=> String
2278
2338
  # resp.studios[0].description #=> String
2279
2339
  # resp.studios[0].url #=> String
2340
+ # resp.studios[0].auth_mode #=> String, one of "SSO", "IAM"
2280
2341
  # resp.studios[0].creation_time #=> Time
2281
2342
  # resp.marker #=> String
2282
2343
  #
@@ -2525,10 +2586,47 @@ module Aws::EMR
2525
2586
  req.send_request(options)
2526
2587
  end
2527
2588
 
2589
+ # Creates or updates an auto-termination policy for an Amazon EMR
2590
+ # cluster. An auto-termination policy defines the amount of idle time in
2591
+ # seconds after which a cluster automatically terminates. For
2592
+ # alternative cluster termination options, see [Control cluster
2593
+ # termination][1].
2594
+ #
2595
+ #
2596
+ #
2597
+ # [1]: https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-termination.html
2598
+ #
2599
+ # @option params [required, String] :cluster_id
2600
+ # Specifies the ID of the Amazon EMR cluster to which the
2601
+ # auto-termination policy will be attached.
2602
+ #
2603
+ # @option params [Types::AutoTerminationPolicy] :auto_termination_policy
2604
+ # Specifies the auto-termination policy to attach to the cluster.
2605
+ #
2606
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2607
+ #
2608
+ # @example Request syntax with placeholder values
2609
+ #
2610
+ # resp = client.put_auto_termination_policy({
2611
+ # cluster_id: "ClusterId", # required
2612
+ # auto_termination_policy: {
2613
+ # idle_timeout: 1,
2614
+ # },
2615
+ # })
2616
+ #
2617
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/PutAutoTerminationPolicy AWS API Documentation
2618
+ #
2619
+ # @overload put_auto_termination_policy(params = {})
2620
+ # @param [Hash] params ({})
2621
+ def put_auto_termination_policy(params = {}, options = {})
2622
+ req = build_request(:put_auto_termination_policy, params)
2623
+ req.send_request(options)
2624
+ end
2625
+
2528
2626
  # Creates or updates an Amazon EMR block public access configuration for
2529
- # your account in the current Region. For more information see
2530
- # [Configure Block Public Access for Amazon EMR][1] in the *Amazon EMR
2531
- # Management Guide*.
2627
+ # your Amazon Web Services account in the current Region. For more
2628
+ # information see [Configure Block Public Access for Amazon EMR][1] in
2629
+ # the *Amazon EMR Management Guide*.
2532
2630
  #
2533
2631
  #
2534
2632
  #
@@ -2648,6 +2746,29 @@ module Aws::EMR
2648
2746
  req.send_request(options)
2649
2747
  end
2650
2748
 
2749
+ # Removes an auto-termination policy from an Amazon EMR cluster.
2750
+ #
2751
+ # @option params [required, String] :cluster_id
2752
+ # Specifies the ID of the Amazon EMR cluster from which the
2753
+ # auto-termination policy will be removed.
2754
+ #
2755
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2756
+ #
2757
+ # @example Request syntax with placeholder values
2758
+ #
2759
+ # resp = client.remove_auto_termination_policy({
2760
+ # cluster_id: "ClusterId", # required
2761
+ # })
2762
+ #
2763
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/RemoveAutoTerminationPolicy AWS API Documentation
2764
+ #
2765
+ # @overload remove_auto_termination_policy(params = {})
2766
+ # @param [Hash] params ({})
2767
+ def remove_auto_termination_policy(params = {}, options = {})
2768
+ req = build_request(:remove_auto_termination_policy, params)
2769
+ req.send_request(options)
2770
+ end
2771
+
2651
2772
  # Removes a managed scaling policy from a specified EMR cluster.
2652
2773
  #
2653
2774
  # @option params [required, String] :cluster_id
@@ -2671,10 +2792,10 @@ module Aws::EMR
2671
2792
  req.send_request(options)
2672
2793
  end
2673
2794
 
2674
- # Removes tags from an Amazon EMR resource. Tags make it easier to
2675
- # associate clusters in various ways, such as grouping clusters to track
2676
- # your Amazon EMR resource allocation costs. For more information, see
2677
- # [Tag Clusters][1].
2795
+ # Removes tags from an Amazon EMR resource, such as a cluster or Amazon
2796
+ # EMR Studio. Tags make it easier to associate resources in various
2797
+ # ways, such as grouping clusters to track your Amazon EMR resource
2798
+ # allocation costs. For more information, see [Tag Clusters][1].
2678
2799
  #
2679
2800
  # The following example removes the stack tag with value Prod from a
2680
2801
  # cluster:
@@ -2685,10 +2806,10 @@ module Aws::EMR
2685
2806
  #
2686
2807
  # @option params [required, String] :resource_id
2687
2808
  # The Amazon EMR resource identifier from which tags will be removed.
2688
- # This value must be a cluster identifier.
2809
+ # For example, a cluster identifier or an Amazon EMR Studio ID.
2689
2810
  #
2690
2811
  # @option params [required, Array<String>] :tag_keys
2691
- # A list of tag keys to remove from a resource.
2812
+ # A list of tag keys to remove from the resource.
2692
2813
  #
2693
2814
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2694
2815
  #
@@ -2860,17 +2981,18 @@ module Aws::EMR
2860
2981
  # supplied for the EMR cluster you are creating.
2861
2982
  #
2862
2983
  # @option params [Boolean] :visible_to_all_users
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.
2984
+ # Set this value to `true` so that IAM principals in the Amazon Web
2985
+ # Services account associated with the cluster can perform EMR actions
2986
+ # on the cluster that their IAM policies allow. This value defaults to
2987
+ # `true` for clusters created using the EMR API or the CLI
2988
+ # [create-cluster][1] command.
2868
2989
  #
2869
2990
  # 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*.
2991
+ # and the Amazon Web Services account root user can perform EMR actions
2992
+ # for the cluster, regardless of the IAM permissions policies attached
2993
+ # to other IAM principals. For more information, see [Understanding the
2994
+ # EMR Cluster VisibleToAllUsers Setting][2] in the *Amazon EMRManagement
2995
+ # Guide*.
2874
2996
  #
2875
2997
  #
2876
2998
  #
@@ -2884,8 +3006,8 @@ module Aws::EMR
2884
3006
  # role, you must have already created it using the CLI or console.
2885
3007
  #
2886
3008
  # @option params [String] :service_role
2887
- # The IAM role that will be assumed by the Amazon EMR service to access
2888
- # Amazon Web Services resources on your behalf.
3009
+ # The IAM role that Amazon EMR assumes in order to access Amazon Web
3010
+ # Services resources on your behalf.
2889
3011
  #
2890
3012
  # @option params [Array<Types::Tag>] :tags
2891
3013
  # A list of tags to associate with a cluster and propagate to Amazon EC2
@@ -2968,6 +3090,16 @@ module Aws::EMR
2968
3090
  # @option params [Array<Types::PlacementGroupConfig>] :placement_group_configs
2969
3091
  # The specified placement group configuration for an Amazon EMR cluster.
2970
3092
  #
3093
+ # @option params [Types::AutoTerminationPolicy] :auto_termination_policy
3094
+ # An auto-termination policy for an Amazon EMR cluster. An
3095
+ # auto-termination policy defines the amount of idle time in seconds
3096
+ # after which a cluster automatically terminates. For alternative
3097
+ # cluster termination options, see [Control cluster termination][1].
3098
+ #
3099
+ #
3100
+ #
3101
+ # [1]: https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-termination.html
3102
+ #
2971
3103
  # @return [Types::RunJobFlowOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2972
3104
  #
2973
3105
  # * {Types::RunJobFlowOutput#job_flow_id #job_flow_id} => String
@@ -3056,6 +3188,7 @@ module Aws::EMR
3056
3188
  # },
3057
3189
  # ],
3058
3190
  # },
3191
+ # custom_ami_id: "XmlStringMaxLen256",
3059
3192
  # },
3060
3193
  # ],
3061
3194
  # instance_fleets: [
@@ -3094,6 +3227,7 @@ module Aws::EMR
3094
3227
  # },
3095
3228
  # },
3096
3229
  # ],
3230
+ # custom_ami_id: "XmlStringMaxLen256",
3097
3231
  # },
3098
3232
  # ],
3099
3233
  # launch_specifications: {
@@ -3222,6 +3356,9 @@ module Aws::EMR
3222
3356
  # placement_strategy: "SPREAD", # accepts SPREAD, PARTITION, CLUSTER, NONE
3223
3357
  # },
3224
3358
  # ],
3359
+ # auto_termination_policy: {
3360
+ # idle_timeout: 1,
3361
+ # },
3225
3362
  # })
3226
3363
  #
3227
3364
  # @example Response structure
@@ -3292,17 +3429,17 @@ module Aws::EMR
3292
3429
  end
3293
3430
 
3294
3431
  # 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.
3432
+ # `true`, IAM principals in the Amazon Web Services account can perform
3433
+ # EMR cluster actions that their IAM policies allow. When `false`, only
3434
+ # the IAM principal that created the cluster and the Amazon Web Services
3435
+ # account root user can perform EMR actions on the cluster, regardless
3436
+ # of IAM permissions policies attached to other IAM principals.
3300
3437
  #
3301
3438
  # This action works on running clusters. When you create a cluster, use
3302
3439
  # the RunJobFlowInput$VisibleToAllUsers parameter.
3303
3440
  #
3304
3441
  # For more information, see [Understanding the EMR Cluster
3305
- # VisibleToAllUsers Setting][1] in the *Amazon EMR Management Guide*.
3442
+ # VisibleToAllUsers Setting][1] in the *Amazon EMRManagement Guide*.
3306
3443
  #
3307
3444
  #
3308
3445
  #
@@ -3312,11 +3449,11 @@ module Aws::EMR
3312
3449
  # The unique identifier of the job flow (cluster).
3313
3450
  #
3314
3451
  # @option params [required, Boolean] :visible_to_all_users
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.
3452
+ # A value of `true` indicates that an IAM principal in the Amazon Web
3453
+ # Services account can perform EMR actions on the cluster that the IAM
3454
+ # policies attached to the principal allow. A value of `false` indicates
3455
+ # that only the IAM principal that created the cluster and the Amazon
3456
+ # Web Services root user can perform EMR actions on the cluster.
3320
3457
  #
3321
3458
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3322
3459
  #
@@ -3584,7 +3721,7 @@ module Aws::EMR
3584
3721
  params: params,
3585
3722
  config: config)
3586
3723
  context[:gem_name] = 'aws-sdk-emr'
3587
- context[:gem_version] = '1.48.0'
3724
+ context[:gem_version] = '1.52.0'
3588
3725
  Seahorse::Client::Request.new(handlers, context)
3589
3726
  end
3590
3727