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 +4 -4
- data/lib/aws-sdk-emr.rb +1 -1
- data/lib/aws-sdk-emr/client.rb +565 -29
- data/lib/aws-sdk-emr/client_api.rb +271 -0
- data/lib/aws-sdk-emr/types.rb +987 -137
- metadata +4 -4
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 68e96349d97188395ba3ea975ab3fd0589653ae531ca19807c46407d7639ec49
|
4
|
+
data.tar.gz: 037e4b2757e34ceb62d1dc5fe600861bab2a369a24cc3045accfa635a166ecfa
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 9ba35431f0d6354b274beef48ca39c4d7663f770c99a000e5df2181aaaf611a72f4699381e74995e88c3a26449ea8d743b69c89333efcd4414359585cd8a2c28
|
7
|
+
data.tar.gz: 9eb00ca6134c064dd22e0463d3907849cf873737d6f3dc15083de12770b85a518df74fd7bd21d2ef7253d60ea7bc4257991bf16c7557a0b10b63ac32e14983f7
|
data/lib/aws-sdk-emr.rb
CHANGED
data/lib/aws-sdk-emr/client.rb
CHANGED
@@ -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
|
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
|
660
|
-
# step will be canceled, even if the request is successfully
|
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
|
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
|
673
|
-
#
|
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
|
865
|
-
# you use ListClusters, DescribeCluster, ListSteps,
|
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
|
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<Types::SessionMappingSummary>
|
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<Types::StudioSummary>
|
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
|
2203
|
-
#
|
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
|
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
|
2346
|
-
# terminating the Amazon EC2 instances, regardless of the
|
2347
|
-
# boundary. With either behavior, Amazon EMR removes the
|
2348
|
-
# nodes first and blocks instance termination if it could
|
2349
|
-
# corruption. `TERMINATE_AT_TASK_COMPLETION` available only
|
2350
|
-
# EMR version 4.1.0 and later, and is the default for versions
|
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
|
2375
|
-
# is used for each EC2 instance. Available in Amazon EMR
|
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
|
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
|
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.
|
3436
|
+
context[:gem_version] = '1.42.0'
|
2901
3437
|
Seahorse::Client::Request.new(handlers, context)
|
2902
3438
|
end
|
2903
3439
|
|