aws-sdk-emr 1.37.0 → 1.42.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: a2cd74c992df966f52f52c87398a9d107d074d2fe7d0913f7a790bcb90e41b90
4
- data.tar.gz: 73818357d9e4314a0a641b7c4996c87a12cd19026badff2f03ab71a77425e503
3
+ metadata.gz: 68e96349d97188395ba3ea975ab3fd0589653ae531ca19807c46407d7639ec49
4
+ data.tar.gz: 037e4b2757e34ceb62d1dc5fe600861bab2a369a24cc3045accfa635a166ecfa
5
5
  SHA512:
6
- metadata.gz: dbea3cc8b22416ca527fc24c259b5db7c29235359a69bc616656b0673695adacd4128697beaa46d513244e49455f1fe9b2c19132b5e9dd9a3048faabbc8f9ca5
7
- data.tar.gz: 8894261e883852df8891b2290924424f04fc4d2cbff0ba4c031d6622b30d7972dcddc25a08534fbe6a7f3c38647bd751482ad7b1349a48e58f860dc0fc759728
6
+ metadata.gz: 9ba35431f0d6354b274beef48ca39c4d7663f770c99a000e5df2181aaaf611a72f4699381e74995e88c3a26449ea8d743b69c89333efcd4414359585cd8a2c28
7
+ data.tar.gz: 9eb00ca6134c064dd22e0463d3907849cf873737d6f3dc15083de12770b85a518df74fd7bd21d2ef7253d60ea7bc4257991bf16c7557a0b10b63ac32e14983f7
data/lib/aws-sdk-emr.rb CHANGED
@@ -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.37.0'
52
+ GEM_VERSION = '1.42.0'
53
53
 
54
54
  end
@@ -626,7 +626,7 @@ module Aws::EMR
626
626
  #
627
627
  # @option params [required, Array<Types::Tag>] :tags
628
628
  # A list of tags to associate with a cluster and propagate to EC2
629
- # instances. Tags are user-defined key/value pairs that consist of a
629
+ # instances. Tags are user-defined key-value pairs that consist of a
630
630
  # required key string with a maximum of 128 characters, and an optional
631
631
  # value string with a maximum of 256 characters.
632
632
  #
@@ -656,12 +656,12 @@ module Aws::EMR
656
656
  # Cancels a pending step or steps in a running cluster. Available only
657
657
  # in Amazon EMR versions 4.8.0 and later, excluding version 5.0.0. A
658
658
  # maximum of 256 steps are allowed in each CancelSteps request.
659
- # CancelSteps is idempotent but asynchronous; it does not guarantee a
660
- # step will be canceled, even if the request is successfully submitted.
661
- # You can only cancel steps that are in a `PENDING` state.
659
+ # CancelSteps is idempotent but asynchronous; it does not guarantee that
660
+ # a step will be canceled, even if the request is successfully
661
+ # submitted. You can only cancel steps that are in a `PENDING` state.
662
662
  #
663
663
  # @option params [required, String] :cluster_id
664
- # The `ClusterID` for which specified steps will be canceled. Use
664
+ # The `ClusterID` for the specified steps that will be canceled. Use
665
665
  # RunJobFlow and ListClusters to get ClusterIDs.
666
666
  #
667
667
  # @option params [required, Array<String>] :step_ids
@@ -669,8 +669,8 @@ module Aws::EMR
669
669
  # states for the specified cluster.
670
670
  #
671
671
  # @option params [String] :step_cancellation_option
672
- # The option to choose for cancelling `RUNNING` steps. By default, the
673
- # value is `SEND_INTERRUPT`.
672
+ # The option to choose to cancel `RUNNING` steps. By default, the value
673
+ # is `SEND_INTERRUPT`.
674
674
  #
675
675
  # @return [Types::CancelStepsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
676
676
  #
@@ -741,6 +741,160 @@ module Aws::EMR
741
741
  req.send_request(options)
742
742
  end
743
743
 
744
+ # Creates a new Amazon EMR Studio.
745
+ #
746
+ # @option params [required, String] :name
747
+ # A descriptive name for the Amazon EMR Studio.
748
+ #
749
+ # @option params [String] :description
750
+ # A detailed description of the Amazon EMR Studio.
751
+ #
752
+ # @option params [required, String] :auth_mode
753
+ # Specifies whether the Studio authenticates users using single sign-on
754
+ # (SSO) or IAM. Amazon EMR Studio currently only supports SSO
755
+ # authentication.
756
+ #
757
+ # @option params [required, String] :vpc_id
758
+ # The ID of the Amazon Virtual Private Cloud (Amazon VPC) to associate
759
+ # with the Studio.
760
+ #
761
+ # @option params [required, Array<String>] :subnet_ids
762
+ # A list of subnet IDs to associate with the Amazon EMR Studio. A Studio
763
+ # can have a maximum of 5 subnets. The subnets must belong to the VPC
764
+ # specified by `VpcId`. Studio users can create a Workspace in any of
765
+ # the specified subnets.
766
+ #
767
+ # @option params [required, String] :service_role
768
+ # The IAM role that will be assumed by the Amazon EMR Studio. The
769
+ # service role provides a way for Amazon EMR Studio to interoperate with
770
+ # other AWS services.
771
+ #
772
+ # @option params [required, String] :user_role
773
+ # The IAM user role that will be assumed by users and groups logged in
774
+ # to an Amazon EMR Studio. The permissions attached to this IAM role can
775
+ # be scoped down for each user or group using session policies.
776
+ #
777
+ # @option params [required, String] :workspace_security_group_id
778
+ # The ID of the Amazon EMR Studio Workspace security group. The
779
+ # Workspace security group allows outbound network traffic to resources
780
+ # in the Engine security group, and it must be in the same VPC specified
781
+ # by `VpcId`.
782
+ #
783
+ # @option params [required, String] :engine_security_group_id
784
+ # The ID of the Amazon EMR Studio Engine security group. The Engine
785
+ # security group allows inbound network traffic from the Workspace
786
+ # security group, and it must be in the same VPC specified by `VpcId`.
787
+ #
788
+ # @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.
792
+ #
793
+ # @option params [Array<Types::Tag>] :tags
794
+ # A list of tags to associate with the Amazon EMR Studio. Tags are
795
+ # user-defined key-value pairs that consist of a required key string
796
+ # with a maximum of 128 characters, and an optional value string with a
797
+ # maximum of 256 characters.
798
+ #
799
+ # @return [Types::CreateStudioOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
800
+ #
801
+ # * {Types::CreateStudioOutput#studio_id #studio_id} => String
802
+ # * {Types::CreateStudioOutput#url #url} => String
803
+ #
804
+ # @example Request syntax with placeholder values
805
+ #
806
+ # resp = client.create_studio({
807
+ # name: "XmlStringMaxLen256", # required
808
+ # description: "XmlStringMaxLen256",
809
+ # auth_mode: "SSO", # required, accepts SSO, IAM
810
+ # vpc_id: "XmlStringMaxLen256", # required
811
+ # subnet_ids: ["String"], # required
812
+ # service_role: "XmlString", # required
813
+ # user_role: "XmlString", # required
814
+ # workspace_security_group_id: "XmlStringMaxLen256", # required
815
+ # engine_security_group_id: "XmlStringMaxLen256", # required
816
+ # default_s3_location: "XmlString", # required
817
+ # tags: [
818
+ # {
819
+ # key: "String",
820
+ # value: "String",
821
+ # },
822
+ # ],
823
+ # })
824
+ #
825
+ # @example Response structure
826
+ #
827
+ # resp.studio_id #=> String
828
+ # resp.url #=> String
829
+ #
830
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/CreateStudio AWS API Documentation
831
+ #
832
+ # @overload create_studio(params = {})
833
+ # @param [Hash] params ({})
834
+ def create_studio(params = {}, options = {})
835
+ req = build_request(:create_studio, params)
836
+ req.send_request(options)
837
+ end
838
+
839
+ # Maps a user or group to the Amazon EMR Studio specified by `StudioId`,
840
+ # and applies a session policy to refine Studio permissions for that
841
+ # user or group.
842
+ #
843
+ # @option params [required, String] :studio_id
844
+ # The ID of the Amazon EMR Studio to which the user or group will be
845
+ # mapped.
846
+ #
847
+ # @option params [String] :identity_id
848
+ # 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.
852
+ #
853
+ #
854
+ #
855
+ # [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId
856
+ # [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId
857
+ #
858
+ # @option params [String] :identity_name
859
+ # 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.
862
+ #
863
+ #
864
+ #
865
+ # [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName
866
+ # [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName
867
+ #
868
+ # @option params [required, String] :identity_type
869
+ # Specifies whether the identity to map to the Amazon EMR Studio is a
870
+ # user or a group.
871
+ #
872
+ # @option params [required, String] :session_policy_arn
873
+ # 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.
876
+ #
877
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
878
+ #
879
+ # @example Request syntax with placeholder values
880
+ #
881
+ # resp = client.create_studio_session_mapping({
882
+ # studio_id: "XmlStringMaxLen256", # required
883
+ # identity_id: "XmlStringMaxLen256",
884
+ # identity_name: "XmlStringMaxLen256",
885
+ # identity_type: "USER", # required, accepts USER, GROUP
886
+ # session_policy_arn: "XmlStringMaxLen256", # required
887
+ # })
888
+ #
889
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/CreateStudioSessionMapping AWS API Documentation
890
+ #
891
+ # @overload create_studio_session_mapping(params = {})
892
+ # @param [Hash] params ({})
893
+ def create_studio_session_mapping(params = {}, options = {})
894
+ req = build_request(:create_studio_session_mapping, params)
895
+ req.send_request(options)
896
+ end
897
+
744
898
  # Deletes a security configuration.
745
899
  #
746
900
  # @option params [required, String] :name
@@ -763,6 +917,79 @@ module Aws::EMR
763
917
  req.send_request(options)
764
918
  end
765
919
 
920
+ # Removes an Amazon EMR Studio from the Studio metadata store.
921
+ #
922
+ # @option params [required, String] :studio_id
923
+ # The ID of the Amazon EMR Studio.
924
+ #
925
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
926
+ #
927
+ # @example Request syntax with placeholder values
928
+ #
929
+ # resp = client.delete_studio({
930
+ # studio_id: "XmlStringMaxLen256", # required
931
+ # })
932
+ #
933
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/DeleteStudio AWS API Documentation
934
+ #
935
+ # @overload delete_studio(params = {})
936
+ # @param [Hash] params ({})
937
+ def delete_studio(params = {}, options = {})
938
+ req = build_request(:delete_studio, params)
939
+ req.send_request(options)
940
+ end
941
+
942
+ # Removes a user or group from an Amazon EMR Studio.
943
+ #
944
+ # @option params [required, String] :studio_id
945
+ # The ID of the Amazon EMR Studio.
946
+ #
947
+ # @option params [String] :identity_id
948
+ # The globally unique identifier (GUID) of the user or group to remove
949
+ # 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.
952
+ #
953
+ #
954
+ #
955
+ # [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId
956
+ # [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId
957
+ #
958
+ # @option params [String] :identity_name
959
+ # The name of the user name or group to remove from the Amazon EMR
960
+ # 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.
963
+ #
964
+ #
965
+ #
966
+ # [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName
967
+ # [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName
968
+ #
969
+ # @option params [required, String] :identity_type
970
+ # Specifies whether the identity to delete from the Amazon EMR Studio is
971
+ # a user or a group.
972
+ #
973
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
974
+ #
975
+ # @example Request syntax with placeholder values
976
+ #
977
+ # resp = client.delete_studio_session_mapping({
978
+ # studio_id: "XmlStringMaxLen256", # required
979
+ # identity_id: "XmlStringMaxLen256",
980
+ # identity_name: "XmlStringMaxLen256",
981
+ # identity_type: "USER", # required, accepts USER, GROUP
982
+ # })
983
+ #
984
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/DeleteStudioSessionMapping AWS API Documentation
985
+ #
986
+ # @overload delete_studio_session_mapping(params = {})
987
+ # @param [Hash] params ({})
988
+ def delete_studio_session_mapping(params = {}, options = {})
989
+ req = build_request(:delete_studio_session_mapping, params)
990
+ req.send_request(options)
991
+ end
992
+
766
993
  # Provides cluster-level details including status, hardware and software
767
994
  # configuration, VPC settings, and so on.
768
995
  #
@@ -845,6 +1072,9 @@ module Aws::EMR
845
1072
  # resp.cluster.cluster_arn #=> String
846
1073
  # resp.cluster.outpost_arn #=> String
847
1074
  # resp.cluster.step_concurrency_level #=> Integer
1075
+ # resp.cluster.placement_groups #=> Array
1076
+ # resp.cluster.placement_groups[0].instance_role #=> String, one of "MASTER", "CORE", "TASK"
1077
+ # resp.cluster.placement_groups[0].placement_strategy #=> String, one of "SPREAD", "PARTITION", "CLUSTER", "NONE"
848
1078
  #
849
1079
  #
850
1080
  # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
@@ -861,9 +1091,9 @@ module Aws::EMR
861
1091
  req.send_request(options)
862
1092
  end
863
1093
 
864
- # This API is deprecated and will eventually be removed. We recommend
865
- # you use ListClusters, DescribeCluster, ListSteps, ListInstanceGroups
866
- # and ListBootstrapActions instead.
1094
+ # This API is no longer supported and will eventually be removed. We
1095
+ # recommend you use ListClusters, DescribeCluster, ListSteps,
1096
+ # ListInstanceGroups and ListBootstrapActions instead.
867
1097
  #
868
1098
  # DescribeJobFlows returns a list of job flows that match all of the
869
1099
  # supplied parameters. The parameters can include a list of job flow
@@ -1119,6 +1349,52 @@ module Aws::EMR
1119
1349
  req.send_request(options)
1120
1350
  end
1121
1351
 
1352
+ # Returns details for the specified Amazon EMR Studio including ID,
1353
+ # Name, VPC, Studio access URL, and so on.
1354
+ #
1355
+ # @option params [required, String] :studio_id
1356
+ # The Amazon EMR Studio ID.
1357
+ #
1358
+ # @return [Types::DescribeStudioOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1359
+ #
1360
+ # * {Types::DescribeStudioOutput#studio #studio} => Types::Studio
1361
+ #
1362
+ # @example Request syntax with placeholder values
1363
+ #
1364
+ # resp = client.describe_studio({
1365
+ # studio_id: "XmlStringMaxLen256", # required
1366
+ # })
1367
+ #
1368
+ # @example Response structure
1369
+ #
1370
+ # resp.studio.studio_id #=> String
1371
+ # resp.studio.studio_arn #=> String
1372
+ # resp.studio.name #=> String
1373
+ # resp.studio.description #=> String
1374
+ # resp.studio.auth_mode #=> String, one of "SSO", "IAM"
1375
+ # resp.studio.vpc_id #=> String
1376
+ # resp.studio.subnet_ids #=> Array
1377
+ # resp.studio.subnet_ids[0] #=> String
1378
+ # resp.studio.service_role #=> String
1379
+ # resp.studio.user_role #=> String
1380
+ # resp.studio.workspace_security_group_id #=> String
1381
+ # resp.studio.engine_security_group_id #=> String
1382
+ # resp.studio.url #=> String
1383
+ # resp.studio.creation_time #=> Time
1384
+ # resp.studio.default_s3_location #=> String
1385
+ # resp.studio.tags #=> Array
1386
+ # resp.studio.tags[0].key #=> String
1387
+ # resp.studio.tags[0].value #=> String
1388
+ #
1389
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/DescribeStudio AWS API Documentation
1390
+ #
1391
+ # @overload describe_studio(params = {})
1392
+ # @param [Hash] params ({})
1393
+ def describe_studio(params = {}, options = {})
1394
+ req = build_request(:describe_studio, params)
1395
+ req.send_request(options)
1396
+ end
1397
+
1122
1398
  # Returns the Amazon EMR block public access configuration for your AWS
1123
1399
  # account in the current Region. For more information see [Configure
1124
1400
  # Block Public Access for Amazon EMR][1] in the *Amazon EMR Management
@@ -1184,6 +1460,68 @@ module Aws::EMR
1184
1460
  req.send_request(options)
1185
1461
  end
1186
1462
 
1463
+ # Fetches mapping details for the specified Amazon EMR Studio and
1464
+ # identity (user or group).
1465
+ #
1466
+ # @option params [required, String] :studio_id
1467
+ # The ID of the Amazon EMR Studio.
1468
+ #
1469
+ # @option params [String] :identity_id
1470
+ # 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.
1474
+ #
1475
+ #
1476
+ #
1477
+ # [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId
1478
+ # [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId
1479
+ #
1480
+ # @option params [String] :identity_name
1481
+ # 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.
1484
+ #
1485
+ #
1486
+ #
1487
+ # [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName
1488
+ # [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName
1489
+ #
1490
+ # @option params [required, String] :identity_type
1491
+ # Specifies whether the identity to fetch is a user or a group.
1492
+ #
1493
+ # @return [Types::GetStudioSessionMappingOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1494
+ #
1495
+ # * {Types::GetStudioSessionMappingOutput#session_mapping #session_mapping} => Types::SessionMappingDetail
1496
+ #
1497
+ # @example Request syntax with placeholder values
1498
+ #
1499
+ # resp = client.get_studio_session_mapping({
1500
+ # studio_id: "XmlStringMaxLen256", # required
1501
+ # identity_id: "XmlStringMaxLen256",
1502
+ # identity_name: "XmlStringMaxLen256",
1503
+ # identity_type: "USER", # required, accepts USER, GROUP
1504
+ # })
1505
+ #
1506
+ # @example Response structure
1507
+ #
1508
+ # resp.session_mapping.studio_id #=> String
1509
+ # resp.session_mapping.identity_id #=> String
1510
+ # resp.session_mapping.identity_name #=> String
1511
+ # resp.session_mapping.identity_type #=> String, one of "USER", "GROUP"
1512
+ # resp.session_mapping.session_policy_arn #=> String
1513
+ # resp.session_mapping.creation_time #=> Time
1514
+ # resp.session_mapping.last_modified_time #=> Time
1515
+ #
1516
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/GetStudioSessionMapping AWS API Documentation
1517
+ #
1518
+ # @overload get_studio_session_mapping(params = {})
1519
+ # @param [Hash] params ({})
1520
+ def get_studio_session_mapping(params = {}, options = {})
1521
+ req = build_request(:get_studio_session_mapping, params)
1522
+ req.send_request(options)
1523
+ end
1524
+
1187
1525
  # Provides information about the bootstrap actions associated with a
1188
1526
  # cluster.
1189
1527
  #
@@ -1672,7 +2010,7 @@ module Aws::EMR
1672
2010
 
1673
2011
  # Provides a list of steps for the cluster in reverse order unless you
1674
2012
  # specify `stepIds` with the request of filter by `StepStates`. You can
1675
- # specify a maximum of ten `stepIDs`.
2013
+ # specify a maximum of 10 `stepIDs`.
1676
2014
  #
1677
2015
  # @option params [required, String] :cluster_id
1678
2016
  # The identifier of the cluster for which to list the steps.
@@ -1737,6 +2075,95 @@ module Aws::EMR
1737
2075
  req.send_request(options)
1738
2076
  end
1739
2077
 
2078
+ # Returns a list of all user or group session mappings for the Amazon
2079
+ # EMR Studio specified by `StudioId`.
2080
+ #
2081
+ # @option params [String] :studio_id
2082
+ # The ID of the Amazon EMR Studio.
2083
+ #
2084
+ # @option params [String] :identity_type
2085
+ # Specifies whether to return session mappings for users or groups. If
2086
+ # not specified, the results include session mapping details for both
2087
+ # users and groups.
2088
+ #
2089
+ # @option params [String] :marker
2090
+ # The pagination token that indicates the set of results to retrieve.
2091
+ #
2092
+ # @return [Types::ListStudioSessionMappingsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2093
+ #
2094
+ # * {Types::ListStudioSessionMappingsOutput#session_mappings #session_mappings} => Array&lt;Types::SessionMappingSummary&gt;
2095
+ # * {Types::ListStudioSessionMappingsOutput#marker #marker} => String
2096
+ #
2097
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2098
+ #
2099
+ # @example Request syntax with placeholder values
2100
+ #
2101
+ # resp = client.list_studio_session_mappings({
2102
+ # studio_id: "XmlStringMaxLen256",
2103
+ # identity_type: "USER", # accepts USER, GROUP
2104
+ # marker: "Marker",
2105
+ # })
2106
+ #
2107
+ # @example Response structure
2108
+ #
2109
+ # resp.session_mappings #=> Array
2110
+ # resp.session_mappings[0].studio_id #=> String
2111
+ # resp.session_mappings[0].identity_id #=> String
2112
+ # resp.session_mappings[0].identity_name #=> String
2113
+ # resp.session_mappings[0].identity_type #=> String, one of "USER", "GROUP"
2114
+ # resp.session_mappings[0].session_policy_arn #=> String
2115
+ # resp.session_mappings[0].creation_time #=> Time
2116
+ # resp.marker #=> String
2117
+ #
2118
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/ListStudioSessionMappings AWS API Documentation
2119
+ #
2120
+ # @overload list_studio_session_mappings(params = {})
2121
+ # @param [Hash] params ({})
2122
+ def list_studio_session_mappings(params = {}, options = {})
2123
+ req = build_request(:list_studio_session_mappings, params)
2124
+ req.send_request(options)
2125
+ end
2126
+
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.
2130
+ #
2131
+ # @option params [String] :marker
2132
+ # The pagination token that indicates the set of results to retrieve.
2133
+ #
2134
+ # @return [Types::ListStudiosOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2135
+ #
2136
+ # * {Types::ListStudiosOutput#studios #studios} => Array&lt;Types::StudioSummary&gt;
2137
+ # * {Types::ListStudiosOutput#marker #marker} => String
2138
+ #
2139
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2140
+ #
2141
+ # @example Request syntax with placeholder values
2142
+ #
2143
+ # resp = client.list_studios({
2144
+ # marker: "Marker",
2145
+ # })
2146
+ #
2147
+ # @example Response structure
2148
+ #
2149
+ # resp.studios #=> Array
2150
+ # resp.studios[0].studio_id #=> String
2151
+ # resp.studios[0].name #=> String
2152
+ # resp.studios[0].vpc_id #=> String
2153
+ # resp.studios[0].description #=> String
2154
+ # resp.studios[0].url #=> String
2155
+ # resp.studios[0].creation_time #=> Time
2156
+ # resp.marker #=> String
2157
+ #
2158
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/ListStudios AWS API Documentation
2159
+ #
2160
+ # @overload list_studios(params = {})
2161
+ # @param [Hash] params ({})
2162
+ def list_studios(params = {}, options = {})
2163
+ req = build_request(:list_studios, params)
2164
+ req.send_request(options)
2165
+ end
2166
+
1740
2167
  # Modifies the number of steps that can be executed concurrently for the
1741
2168
  # cluster specified using ClusterID.
1742
2169
  #
@@ -2199,9 +2626,9 @@ module Aws::EMR
2199
2626
  #
2200
2627
  # @option params [String] :log_encryption_kms_key_id
2201
2628
  # The AWS KMS customer master key (CMK) used for encrypting log files.
2202
- # If a value is not provided, the logs will remain encrypted by AES-256.
2203
- # This attribute is only available with EMR version 5.30.0 and later,
2204
- # excluding EMR 6.0.0.
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.
2205
2632
  #
2206
2633
  # @option params [String] :additional_info
2207
2634
  # A JSON string for selecting additional features.
@@ -2277,7 +2704,7 @@ module Aws::EMR
2277
2704
  #
2278
2705
  # * "mapr-m7" - launch the cluster using MapR M7 Edition.
2279
2706
  #
2280
- # * "hunk" - launch the cluster with the Hunk Big Data Analtics
2707
+ # * "hunk" - launch the cluster with the Hunk Big Data Analytics
2281
2708
  # Platform.
2282
2709
  #
2283
2710
  # * "hue"- launch the cluster with Hue installed.
@@ -2342,13 +2769,13 @@ module Aws::EMR
2342
2769
  # terminate the instance was submitted. This option is only available
2343
2770
  # with Amazon EMR 5.1.0 and later and is the default for clusters
2344
2771
  # created using that version. `TERMINATE_AT_TASK_COMPLETION` indicates
2345
- # that Amazon EMR blacklists and drains tasks from nodes before
2346
- # terminating the Amazon EC2 instances, regardless of the instance-hour
2347
- # boundary. With either behavior, Amazon EMR removes the least active
2348
- # nodes first and blocks instance termination if it could lead to HDFS
2349
- # corruption. `TERMINATE_AT_TASK_COMPLETION` available only in Amazon
2350
- # EMR version 4.1.0 and later, and is the default for versions of Amazon
2351
- # EMR earlier than 5.1.0.
2772
+ # that Amazon EMR adds nodes to a deny list and drains tasks from nodes
2773
+ # before terminating the Amazon EC2 instances, regardless of the
2774
+ # instance-hour boundary. With either behavior, Amazon EMR removes the
2775
+ # least active nodes first and blocks instance termination if it could
2776
+ # lead to HDFS corruption. `TERMINATE_AT_TASK_COMPLETION` available only
2777
+ # in Amazon EMR version 4.1.0 and later, and is the default for versions
2778
+ # of Amazon EMR earlier than 5.1.0.
2352
2779
  #
2353
2780
  # @option params [String] :custom_ami_id
2354
2781
  # Available only in Amazon EMR version 5.7.0 and later. The ID of a
@@ -2371,9 +2798,9 @@ module Aws::EMR
2371
2798
  # [3]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html
2372
2799
  #
2373
2800
  # @option params [Integer] :ebs_root_volume_size
2374
- # The size, in GiB, of the EBS root device volume of the Linux AMI that
2375
- # is used for each EC2 instance. Available in Amazon EMR version 4.x and
2376
- # later.
2801
+ # The size, in GiB, of the Amazon EBS root device volume of the Linux
2802
+ # AMI that is used for each EC2 instance. Available in Amazon EMR
2803
+ # version 4.x and later.
2377
2804
  #
2378
2805
  # @option params [String] :repo_upgrade_on_boot
2379
2806
  # Applies only when `CustomAmiID` is used. Specifies which updates from
@@ -2386,7 +2813,7 @@ module Aws::EMR
2386
2813
  # @option params [Types::KerberosAttributes] :kerberos_attributes
2387
2814
  # Attributes for Kerberos configuration when Kerberos authentication is
2388
2815
  # enabled using a security configuration. For more information see [Use
2389
- # Kerberos Authentication][1] in the *EMR Management Guide*.
2816
+ # Kerberos Authentication][1] in the *Amazon EMR Management Guide*.
2390
2817
  #
2391
2818
  #
2392
2819
  #
@@ -2399,6 +2826,9 @@ module Aws::EMR
2399
2826
  # @option params [Types::ManagedScalingPolicy] :managed_scaling_policy
2400
2827
  # The specified managed scaling policy for an Amazon EMR cluster.
2401
2828
  #
2829
+ # @option params [Array<Types::PlacementGroupConfig>] :placement_group_configs
2830
+ # The specified placement group configuration for an Amazon EMR cluster.
2831
+ #
2402
2832
  # @return [Types::RunJobFlowOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2403
2833
  #
2404
2834
  # * {Types::RunJobFlowOutput#job_flow_id #job_flow_id} => String
@@ -2642,6 +3072,12 @@ module Aws::EMR
2642
3072
  # maximum_core_capacity_units: 1,
2643
3073
  # },
2644
3074
  # },
3075
+ # placement_group_configs: [
3076
+ # {
3077
+ # instance_role: "MASTER", # required, accepts MASTER, CORE, TASK
3078
+ # placement_strategy: "SPREAD", # accepts SPREAD, PARTITION, CLUSTER, NONE
3079
+ # },
3080
+ # ],
2645
3081
  # })
2646
3082
  #
2647
3083
  # @example Response structure
@@ -2787,7 +3223,7 @@ module Aws::EMR
2787
3223
  #
2788
3224
  # @option params [Array<Types::Tag>] :tags
2789
3225
  # A list of tags associated with a notebook execution. Tags are
2790
- # user-defined key value pairs that consist of a required key string
3226
+ # user-defined key-value pairs that consist of a required key string
2791
3227
  # with a maximum of 128 characters and an optional value string with a
2792
3228
  # maximum of 256 characters.
2793
3229
  #
@@ -2865,7 +3301,7 @@ module Aws::EMR
2865
3301
  # EC2 instances.
2866
3302
  #
2867
3303
  # @option params [required, Array<String>] :job_flow_ids
2868
- # A list of job flows to be shutdown.
3304
+ # A list of job flows to be shut down.
2869
3305
  #
2870
3306
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2871
3307
  #
@@ -2884,6 +3320,106 @@ module Aws::EMR
2884
3320
  req.send_request(options)
2885
3321
  end
2886
3322
 
3323
+ # Updates an Amazon EMR Studio configuration, including attributes such
3324
+ # as name, description, and subnets.
3325
+ #
3326
+ # @option params [required, String] :studio_id
3327
+ # The ID of the Amazon EMR Studio to update.
3328
+ #
3329
+ # @option params [String] :name
3330
+ # A descriptive name for the Amazon EMR Studio.
3331
+ #
3332
+ # @option params [String] :description
3333
+ # A detailed description to assign to the Amazon EMR Studio.
3334
+ #
3335
+ # @option params [Array<String>] :subnet_ids
3336
+ # A list of subnet IDs to associate with the Amazon EMR Studio. The list
3337
+ # can include new subnet IDs, but must also include all of the subnet
3338
+ # IDs previously associated with the Studio. The list order does not
3339
+ # matter. A Studio can have a maximum of 5 subnets. The subnets must
3340
+ # belong to the same VPC as the Studio.
3341
+ #
3342
+ # @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.
3346
+ #
3347
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3348
+ #
3349
+ # @example Request syntax with placeholder values
3350
+ #
3351
+ # resp = client.update_studio({
3352
+ # studio_id: "XmlStringMaxLen256", # required
3353
+ # name: "XmlStringMaxLen256",
3354
+ # description: "XmlStringMaxLen256",
3355
+ # subnet_ids: ["String"],
3356
+ # default_s3_location: "XmlString",
3357
+ # })
3358
+ #
3359
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/UpdateStudio AWS API Documentation
3360
+ #
3361
+ # @overload update_studio(params = {})
3362
+ # @param [Hash] params ({})
3363
+ def update_studio(params = {}, options = {})
3364
+ req = build_request(:update_studio, params)
3365
+ req.send_request(options)
3366
+ end
3367
+
3368
+ # Updates the session policy attached to the user or group for the
3369
+ # specified Amazon EMR Studio.
3370
+ #
3371
+ # @option params [required, String] :studio_id
3372
+ # The ID of the Amazon EMR Studio.
3373
+ #
3374
+ # @option params [String] :identity_id
3375
+ # 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.
3379
+ #
3380
+ #
3381
+ #
3382
+ # [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId
3383
+ # [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId
3384
+ #
3385
+ # @option params [String] :identity_name
3386
+ # 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.
3389
+ #
3390
+ #
3391
+ #
3392
+ # [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName
3393
+ # [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName
3394
+ #
3395
+ # @option params [required, String] :identity_type
3396
+ # Specifies whether the identity to update is a user or a group.
3397
+ #
3398
+ # @option params [required, String] :session_policy_arn
3399
+ # The Amazon Resource Name (ARN) of the session policy to associate with
3400
+ # the specified user or group.
3401
+ #
3402
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3403
+ #
3404
+ # @example Request syntax with placeholder values
3405
+ #
3406
+ # resp = client.update_studio_session_mapping({
3407
+ # studio_id: "XmlStringMaxLen256", # required
3408
+ # identity_id: "XmlStringMaxLen256",
3409
+ # identity_name: "XmlStringMaxLen256",
3410
+ # identity_type: "USER", # required, accepts USER, GROUP
3411
+ # session_policy_arn: "XmlStringMaxLen256", # required
3412
+ # })
3413
+ #
3414
+ # @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/UpdateStudioSessionMapping AWS API Documentation
3415
+ #
3416
+ # @overload update_studio_session_mapping(params = {})
3417
+ # @param [Hash] params ({})
3418
+ def update_studio_session_mapping(params = {}, options = {})
3419
+ req = build_request(:update_studio_session_mapping, params)
3420
+ req.send_request(options)
3421
+ end
3422
+
2887
3423
  # @!endgroup
2888
3424
 
2889
3425
  # @param params ({})
@@ -2897,7 +3433,7 @@ module Aws::EMR
2897
3433
  params: params,
2898
3434
  config: config)
2899
3435
  context[:gem_name] = 'aws-sdk-emr'
2900
- context[:gem_version] = '1.37.0'
3436
+ context[:gem_version] = '1.42.0'
2901
3437
  Seahorse::Client::Request.new(handlers, context)
2902
3438
  end
2903
3439