aws-sdk-emr 1.38.0 → 1.43.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +288 -0
- data/LICENSE.txt +202 -0
- data/VERSION +1 -0
- data/lib/aws-sdk-emr.rb +1 -1
- data/lib/aws-sdk-emr/client.rb +565 -30
- data/lib/aws-sdk-emr/client_api.rb +268 -0
- data/lib/aws-sdk-emr/types.rb +1039 -146
- metadata +8 -5
data/VERSION
ADDED
@@ -0,0 +1 @@
|
|
1
|
+
1.43.0
|
data/lib/aws-sdk-emr.rb
CHANGED
data/lib/aws-sdk-emr/client.rb
CHANGED
@@ -406,6 +406,10 @@ module Aws::EMR
|
|
406
406
|
# },
|
407
407
|
# on_demand_specification: {
|
408
408
|
# allocation_strategy: "lowest-price", # required, accepts lowest-price
|
409
|
+
# capacity_reservation_options: {
|
410
|
+
# usage_strategy: "use-capacity-reservations-first", # accepts use-capacity-reservations-first
|
411
|
+
# capacity_reservation_preference: "open", # accepts open, none
|
412
|
+
# },
|
409
413
|
# },
|
410
414
|
# },
|
411
415
|
# },
|
@@ -626,7 +630,7 @@ module Aws::EMR
|
|
626
630
|
#
|
627
631
|
# @option params [required, Array<Types::Tag>] :tags
|
628
632
|
# A list of tags to associate with a cluster and propagate to EC2
|
629
|
-
# instances. Tags are user-defined key
|
633
|
+
# instances. Tags are user-defined key-value pairs that consist of a
|
630
634
|
# required key string with a maximum of 128 characters, and an optional
|
631
635
|
# value string with a maximum of 256 characters.
|
632
636
|
#
|
@@ -656,12 +660,12 @@ module Aws::EMR
|
|
656
660
|
# Cancels a pending step or steps in a running cluster. Available only
|
657
661
|
# in Amazon EMR versions 4.8.0 and later, excluding version 5.0.0. A
|
658
662
|
# 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.
|
663
|
+
# CancelSteps is idempotent but asynchronous; it does not guarantee that
|
664
|
+
# a step will be canceled, even if the request is successfully
|
665
|
+
# submitted. You can only cancel steps that are in a `PENDING` state.
|
662
666
|
#
|
663
667
|
# @option params [required, String] :cluster_id
|
664
|
-
# The `ClusterID` for
|
668
|
+
# The `ClusterID` for the specified steps that will be canceled. Use
|
665
669
|
# RunJobFlow and ListClusters to get ClusterIDs.
|
666
670
|
#
|
667
671
|
# @option params [required, Array<String>] :step_ids
|
@@ -669,8 +673,8 @@ module Aws::EMR
|
|
669
673
|
# states for the specified cluster.
|
670
674
|
#
|
671
675
|
# @option params [String] :step_cancellation_option
|
672
|
-
# The option to choose
|
673
|
-
#
|
676
|
+
# The option to choose to cancel `RUNNING` steps. By default, the value
|
677
|
+
# is `SEND_INTERRUPT`.
|
674
678
|
#
|
675
679
|
# @return [Types::CancelStepsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
676
680
|
#
|
@@ -741,6 +745,160 @@ module Aws::EMR
|
|
741
745
|
req.send_request(options)
|
742
746
|
end
|
743
747
|
|
748
|
+
# Creates a new Amazon EMR Studio.
|
749
|
+
#
|
750
|
+
# @option params [required, String] :name
|
751
|
+
# A descriptive name for the Amazon EMR Studio.
|
752
|
+
#
|
753
|
+
# @option params [String] :description
|
754
|
+
# A detailed description of the Amazon EMR Studio.
|
755
|
+
#
|
756
|
+
# @option params [required, String] :auth_mode
|
757
|
+
# Specifies whether the Studio authenticates users using single sign-on
|
758
|
+
# (SSO) or IAM. Amazon EMR Studio currently only supports SSO
|
759
|
+
# authentication.
|
760
|
+
#
|
761
|
+
# @option params [required, String] :vpc_id
|
762
|
+
# The ID of the Amazon Virtual Private Cloud (Amazon VPC) to associate
|
763
|
+
# with the Studio.
|
764
|
+
#
|
765
|
+
# @option params [required, Array<String>] :subnet_ids
|
766
|
+
# A list of subnet IDs to associate with the Amazon EMR Studio. A Studio
|
767
|
+
# can have a maximum of 5 subnets. The subnets must belong to the VPC
|
768
|
+
# specified by `VpcId`. Studio users can create a Workspace in any of
|
769
|
+
# the specified subnets.
|
770
|
+
#
|
771
|
+
# @option params [required, String] :service_role
|
772
|
+
# The IAM role that will be assumed by the Amazon EMR Studio. The
|
773
|
+
# service role provides a way for Amazon EMR Studio to interoperate with
|
774
|
+
# other AWS services.
|
775
|
+
#
|
776
|
+
# @option params [required, String] :user_role
|
777
|
+
# The IAM user role that will be assumed by users and groups logged in
|
778
|
+
# to an Amazon EMR Studio. The permissions attached to this IAM role can
|
779
|
+
# be scoped down for each user or group using session policies.
|
780
|
+
#
|
781
|
+
# @option params [required, String] :workspace_security_group_id
|
782
|
+
# The ID of the Amazon EMR Studio Workspace security group. The
|
783
|
+
# Workspace security group allows outbound network traffic to resources
|
784
|
+
# in the Engine security group, and it must be in the same VPC specified
|
785
|
+
# by `VpcId`.
|
786
|
+
#
|
787
|
+
# @option params [required, String] :engine_security_group_id
|
788
|
+
# The ID of the Amazon EMR Studio Engine security group. The Engine
|
789
|
+
# security group allows inbound network traffic from the Workspace
|
790
|
+
# security group, and it must be in the same VPC specified by `VpcId`.
|
791
|
+
#
|
792
|
+
# @option params [required, String] :default_s3_location
|
793
|
+
# The default Amazon S3 location to back up Amazon EMR Studio Workspaces
|
794
|
+
# and notebook files. A Studio user can select an alternative Amazon S3
|
795
|
+
# location when creating a Workspace.
|
796
|
+
#
|
797
|
+
# @option params [Array<Types::Tag>] :tags
|
798
|
+
# A list of tags to associate with the Amazon EMR Studio. Tags are
|
799
|
+
# user-defined key-value pairs that consist of a required key string
|
800
|
+
# with a maximum of 128 characters, and an optional value string with a
|
801
|
+
# maximum of 256 characters.
|
802
|
+
#
|
803
|
+
# @return [Types::CreateStudioOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
804
|
+
#
|
805
|
+
# * {Types::CreateStudioOutput#studio_id #studio_id} => String
|
806
|
+
# * {Types::CreateStudioOutput#url #url} => String
|
807
|
+
#
|
808
|
+
# @example Request syntax with placeholder values
|
809
|
+
#
|
810
|
+
# resp = client.create_studio({
|
811
|
+
# name: "XmlStringMaxLen256", # required
|
812
|
+
# description: "XmlStringMaxLen256",
|
813
|
+
# auth_mode: "SSO", # required, accepts SSO, IAM
|
814
|
+
# vpc_id: "XmlStringMaxLen256", # required
|
815
|
+
# subnet_ids: ["String"], # required
|
816
|
+
# service_role: "XmlString", # required
|
817
|
+
# user_role: "XmlString", # required
|
818
|
+
# workspace_security_group_id: "XmlStringMaxLen256", # required
|
819
|
+
# engine_security_group_id: "XmlStringMaxLen256", # required
|
820
|
+
# default_s3_location: "XmlString", # required
|
821
|
+
# tags: [
|
822
|
+
# {
|
823
|
+
# key: "String",
|
824
|
+
# value: "String",
|
825
|
+
# },
|
826
|
+
# ],
|
827
|
+
# })
|
828
|
+
#
|
829
|
+
# @example Response structure
|
830
|
+
#
|
831
|
+
# resp.studio_id #=> String
|
832
|
+
# resp.url #=> String
|
833
|
+
#
|
834
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/CreateStudio AWS API Documentation
|
835
|
+
#
|
836
|
+
# @overload create_studio(params = {})
|
837
|
+
# @param [Hash] params ({})
|
838
|
+
def create_studio(params = {}, options = {})
|
839
|
+
req = build_request(:create_studio, params)
|
840
|
+
req.send_request(options)
|
841
|
+
end
|
842
|
+
|
843
|
+
# Maps a user or group to the Amazon EMR Studio specified by `StudioId`,
|
844
|
+
# and applies a session policy to refine Studio permissions for that
|
845
|
+
# user or group.
|
846
|
+
#
|
847
|
+
# @option params [required, String] :studio_id
|
848
|
+
# The ID of the Amazon EMR Studio to which the user or group will be
|
849
|
+
# mapped.
|
850
|
+
#
|
851
|
+
# @option params [String] :identity_id
|
852
|
+
# The globally unique identifier (GUID) of the user or group from the
|
853
|
+
# AWS SSO Identity Store. For more information, see [UserId][1] and
|
854
|
+
# [GroupId][2] in the *AWS SSO Identity Store API Reference*. Either
|
855
|
+
# `IdentityName` or `IdentityId` must be specified.
|
856
|
+
#
|
857
|
+
#
|
858
|
+
#
|
859
|
+
# [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId
|
860
|
+
# [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId
|
861
|
+
#
|
862
|
+
# @option params [String] :identity_name
|
863
|
+
# The name of the user or group. For more information, see [UserName][1]
|
864
|
+
# and [DisplayName][2] in the *AWS SSO Identity Store API Reference*.
|
865
|
+
# Either `IdentityName` or `IdentityId` must be specified.
|
866
|
+
#
|
867
|
+
#
|
868
|
+
#
|
869
|
+
# [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName
|
870
|
+
# [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName
|
871
|
+
#
|
872
|
+
# @option params [required, String] :identity_type
|
873
|
+
# Specifies whether the identity to map to the Amazon EMR Studio is a
|
874
|
+
# user or a group.
|
875
|
+
#
|
876
|
+
# @option params [required, String] :session_policy_arn
|
877
|
+
# The Amazon Resource Name (ARN) for the session policy that will be
|
878
|
+
# applied to the user or group. Session policies refine Studio user
|
879
|
+
# permissions without the need to use multiple IAM user roles.
|
880
|
+
#
|
881
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
882
|
+
#
|
883
|
+
# @example Request syntax with placeholder values
|
884
|
+
#
|
885
|
+
# resp = client.create_studio_session_mapping({
|
886
|
+
# studio_id: "XmlStringMaxLen256", # required
|
887
|
+
# identity_id: "XmlStringMaxLen256",
|
888
|
+
# identity_name: "XmlStringMaxLen256",
|
889
|
+
# identity_type: "USER", # required, accepts USER, GROUP
|
890
|
+
# session_policy_arn: "XmlStringMaxLen256", # required
|
891
|
+
# })
|
892
|
+
#
|
893
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/CreateStudioSessionMapping AWS API Documentation
|
894
|
+
#
|
895
|
+
# @overload create_studio_session_mapping(params = {})
|
896
|
+
# @param [Hash] params ({})
|
897
|
+
def create_studio_session_mapping(params = {}, options = {})
|
898
|
+
req = build_request(:create_studio_session_mapping, params)
|
899
|
+
req.send_request(options)
|
900
|
+
end
|
901
|
+
|
744
902
|
# Deletes a security configuration.
|
745
903
|
#
|
746
904
|
# @option params [required, String] :name
|
@@ -763,6 +921,79 @@ module Aws::EMR
|
|
763
921
|
req.send_request(options)
|
764
922
|
end
|
765
923
|
|
924
|
+
# Removes an Amazon EMR Studio from the Studio metadata store.
|
925
|
+
#
|
926
|
+
# @option params [required, String] :studio_id
|
927
|
+
# The ID of the Amazon EMR Studio.
|
928
|
+
#
|
929
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
930
|
+
#
|
931
|
+
# @example Request syntax with placeholder values
|
932
|
+
#
|
933
|
+
# resp = client.delete_studio({
|
934
|
+
# studio_id: "XmlStringMaxLen256", # required
|
935
|
+
# })
|
936
|
+
#
|
937
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/DeleteStudio AWS API Documentation
|
938
|
+
#
|
939
|
+
# @overload delete_studio(params = {})
|
940
|
+
# @param [Hash] params ({})
|
941
|
+
def delete_studio(params = {}, options = {})
|
942
|
+
req = build_request(:delete_studio, params)
|
943
|
+
req.send_request(options)
|
944
|
+
end
|
945
|
+
|
946
|
+
# Removes a user or group from an Amazon EMR Studio.
|
947
|
+
#
|
948
|
+
# @option params [required, String] :studio_id
|
949
|
+
# The ID of the Amazon EMR Studio.
|
950
|
+
#
|
951
|
+
# @option params [String] :identity_id
|
952
|
+
# The globally unique identifier (GUID) of the user or group to remove
|
953
|
+
# from the Amazon EMR Studio. For more information, see [UserId][1] and
|
954
|
+
# [GroupId][2] in the *AWS SSO Identity Store API Reference*. Either
|
955
|
+
# `IdentityName` or `IdentityId` must be specified.
|
956
|
+
#
|
957
|
+
#
|
958
|
+
#
|
959
|
+
# [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId
|
960
|
+
# [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId
|
961
|
+
#
|
962
|
+
# @option params [String] :identity_name
|
963
|
+
# The name of the user name or group to remove from the Amazon EMR
|
964
|
+
# Studio. For more information, see [UserName][1] and [DisplayName][2]
|
965
|
+
# in the *AWS SSO Identity Store API Reference*. Either `IdentityName`
|
966
|
+
# or `IdentityId` must be specified.
|
967
|
+
#
|
968
|
+
#
|
969
|
+
#
|
970
|
+
# [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName
|
971
|
+
# [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName
|
972
|
+
#
|
973
|
+
# @option params [required, String] :identity_type
|
974
|
+
# Specifies whether the identity to delete from the Amazon EMR Studio is
|
975
|
+
# a user or a group.
|
976
|
+
#
|
977
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
978
|
+
#
|
979
|
+
# @example Request syntax with placeholder values
|
980
|
+
#
|
981
|
+
# resp = client.delete_studio_session_mapping({
|
982
|
+
# studio_id: "XmlStringMaxLen256", # required
|
983
|
+
# identity_id: "XmlStringMaxLen256",
|
984
|
+
# identity_name: "XmlStringMaxLen256",
|
985
|
+
# identity_type: "USER", # required, accepts USER, GROUP
|
986
|
+
# })
|
987
|
+
#
|
988
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/DeleteStudioSessionMapping AWS API Documentation
|
989
|
+
#
|
990
|
+
# @overload delete_studio_session_mapping(params = {})
|
991
|
+
# @param [Hash] params ({})
|
992
|
+
def delete_studio_session_mapping(params = {}, options = {})
|
993
|
+
req = build_request(:delete_studio_session_mapping, params)
|
994
|
+
req.send_request(options)
|
995
|
+
end
|
996
|
+
|
766
997
|
# Provides cluster-level details including status, hardware and software
|
767
998
|
# configuration, VPC settings, and so on.
|
768
999
|
#
|
@@ -864,9 +1095,9 @@ module Aws::EMR
|
|
864
1095
|
req.send_request(options)
|
865
1096
|
end
|
866
1097
|
|
867
|
-
# This API is
|
868
|
-
# you use ListClusters, DescribeCluster, ListSteps,
|
869
|
-
# and ListBootstrapActions instead.
|
1098
|
+
# This API is no longer supported and will eventually be removed. We
|
1099
|
+
# recommend you use ListClusters, DescribeCluster, ListSteps,
|
1100
|
+
# ListInstanceGroups and ListBootstrapActions instead.
|
870
1101
|
#
|
871
1102
|
# DescribeJobFlows returns a list of job flows that match all of the
|
872
1103
|
# supplied parameters. The parameters can include a list of job flow
|
@@ -1122,6 +1353,52 @@ module Aws::EMR
|
|
1122
1353
|
req.send_request(options)
|
1123
1354
|
end
|
1124
1355
|
|
1356
|
+
# Returns details for the specified Amazon EMR Studio including ID,
|
1357
|
+
# Name, VPC, Studio access URL, and so on.
|
1358
|
+
#
|
1359
|
+
# @option params [required, String] :studio_id
|
1360
|
+
# The Amazon EMR Studio ID.
|
1361
|
+
#
|
1362
|
+
# @return [Types::DescribeStudioOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1363
|
+
#
|
1364
|
+
# * {Types::DescribeStudioOutput#studio #studio} => Types::Studio
|
1365
|
+
#
|
1366
|
+
# @example Request syntax with placeholder values
|
1367
|
+
#
|
1368
|
+
# resp = client.describe_studio({
|
1369
|
+
# studio_id: "XmlStringMaxLen256", # required
|
1370
|
+
# })
|
1371
|
+
#
|
1372
|
+
# @example Response structure
|
1373
|
+
#
|
1374
|
+
# resp.studio.studio_id #=> String
|
1375
|
+
# resp.studio.studio_arn #=> String
|
1376
|
+
# resp.studio.name #=> String
|
1377
|
+
# resp.studio.description #=> String
|
1378
|
+
# resp.studio.auth_mode #=> String, one of "SSO", "IAM"
|
1379
|
+
# resp.studio.vpc_id #=> String
|
1380
|
+
# resp.studio.subnet_ids #=> Array
|
1381
|
+
# resp.studio.subnet_ids[0] #=> String
|
1382
|
+
# resp.studio.service_role #=> String
|
1383
|
+
# resp.studio.user_role #=> String
|
1384
|
+
# resp.studio.workspace_security_group_id #=> String
|
1385
|
+
# resp.studio.engine_security_group_id #=> String
|
1386
|
+
# resp.studio.url #=> String
|
1387
|
+
# resp.studio.creation_time #=> Time
|
1388
|
+
# resp.studio.default_s3_location #=> String
|
1389
|
+
# resp.studio.tags #=> Array
|
1390
|
+
# resp.studio.tags[0].key #=> String
|
1391
|
+
# resp.studio.tags[0].value #=> String
|
1392
|
+
#
|
1393
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/DescribeStudio AWS API Documentation
|
1394
|
+
#
|
1395
|
+
# @overload describe_studio(params = {})
|
1396
|
+
# @param [Hash] params ({})
|
1397
|
+
def describe_studio(params = {}, options = {})
|
1398
|
+
req = build_request(:describe_studio, params)
|
1399
|
+
req.send_request(options)
|
1400
|
+
end
|
1401
|
+
|
1125
1402
|
# Returns the Amazon EMR block public access configuration for your AWS
|
1126
1403
|
# account in the current Region. For more information see [Configure
|
1127
1404
|
# Block Public Access for Amazon EMR][1] in the *Amazon EMR Management
|
@@ -1187,6 +1464,68 @@ module Aws::EMR
|
|
1187
1464
|
req.send_request(options)
|
1188
1465
|
end
|
1189
1466
|
|
1467
|
+
# Fetches mapping details for the specified Amazon EMR Studio and
|
1468
|
+
# identity (user or group).
|
1469
|
+
#
|
1470
|
+
# @option params [required, String] :studio_id
|
1471
|
+
# The ID of the Amazon EMR Studio.
|
1472
|
+
#
|
1473
|
+
# @option params [String] :identity_id
|
1474
|
+
# The globally unique identifier (GUID) of the user or group. For more
|
1475
|
+
# information, see [UserId][1] and [GroupId][2] in the *AWS SSO Identity
|
1476
|
+
# Store API Reference*. Either `IdentityName` or `IdentityId` must be
|
1477
|
+
# specified.
|
1478
|
+
#
|
1479
|
+
#
|
1480
|
+
#
|
1481
|
+
# [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId
|
1482
|
+
# [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId
|
1483
|
+
#
|
1484
|
+
# @option params [String] :identity_name
|
1485
|
+
# The name of the user or group to fetch. For more information, see
|
1486
|
+
# [UserName][1] and [DisplayName][2] in the *AWS SSO Identity Store API
|
1487
|
+
# Reference*. Either `IdentityName` or `IdentityId` must be specified.
|
1488
|
+
#
|
1489
|
+
#
|
1490
|
+
#
|
1491
|
+
# [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName
|
1492
|
+
# [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName
|
1493
|
+
#
|
1494
|
+
# @option params [required, String] :identity_type
|
1495
|
+
# Specifies whether the identity to fetch is a user or a group.
|
1496
|
+
#
|
1497
|
+
# @return [Types::GetStudioSessionMappingOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1498
|
+
#
|
1499
|
+
# * {Types::GetStudioSessionMappingOutput#session_mapping #session_mapping} => Types::SessionMappingDetail
|
1500
|
+
#
|
1501
|
+
# @example Request syntax with placeholder values
|
1502
|
+
#
|
1503
|
+
# resp = client.get_studio_session_mapping({
|
1504
|
+
# studio_id: "XmlStringMaxLen256", # required
|
1505
|
+
# identity_id: "XmlStringMaxLen256",
|
1506
|
+
# identity_name: "XmlStringMaxLen256",
|
1507
|
+
# identity_type: "USER", # required, accepts USER, GROUP
|
1508
|
+
# })
|
1509
|
+
#
|
1510
|
+
# @example Response structure
|
1511
|
+
#
|
1512
|
+
# resp.session_mapping.studio_id #=> String
|
1513
|
+
# resp.session_mapping.identity_id #=> String
|
1514
|
+
# resp.session_mapping.identity_name #=> String
|
1515
|
+
# resp.session_mapping.identity_type #=> String, one of "USER", "GROUP"
|
1516
|
+
# resp.session_mapping.session_policy_arn #=> String
|
1517
|
+
# resp.session_mapping.creation_time #=> Time
|
1518
|
+
# resp.session_mapping.last_modified_time #=> Time
|
1519
|
+
#
|
1520
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/GetStudioSessionMapping AWS API Documentation
|
1521
|
+
#
|
1522
|
+
# @overload get_studio_session_mapping(params = {})
|
1523
|
+
# @param [Hash] params ({})
|
1524
|
+
def get_studio_session_mapping(params = {}, options = {})
|
1525
|
+
req = build_request(:get_studio_session_mapping, params)
|
1526
|
+
req.send_request(options)
|
1527
|
+
end
|
1528
|
+
|
1190
1529
|
# Provides information about the bootstrap actions associated with a
|
1191
1530
|
# cluster.
|
1192
1531
|
#
|
@@ -1356,6 +1695,8 @@ module Aws::EMR
|
|
1356
1695
|
# resp.instance_fleets[0].launch_specifications.spot_specification.block_duration_minutes #=> Integer
|
1357
1696
|
# resp.instance_fleets[0].launch_specifications.spot_specification.allocation_strategy #=> String, one of "capacity-optimized"
|
1358
1697
|
# resp.instance_fleets[0].launch_specifications.on_demand_specification.allocation_strategy #=> String, one of "lowest-price"
|
1698
|
+
# resp.instance_fleets[0].launch_specifications.on_demand_specification.capacity_reservation_options.usage_strategy #=> String, one of "use-capacity-reservations-first"
|
1699
|
+
# resp.instance_fleets[0].launch_specifications.on_demand_specification.capacity_reservation_options.capacity_reservation_preference #=> String, one of "open", "none"
|
1359
1700
|
# resp.marker #=> String
|
1360
1701
|
#
|
1361
1702
|
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/ListInstanceFleets AWS API Documentation
|
@@ -1675,7 +2016,7 @@ module Aws::EMR
|
|
1675
2016
|
|
1676
2017
|
# Provides a list of steps for the cluster in reverse order unless you
|
1677
2018
|
# specify `stepIds` with the request of filter by `StepStates`. You can
|
1678
|
-
# specify a maximum of
|
2019
|
+
# specify a maximum of 10 `stepIDs`.
|
1679
2020
|
#
|
1680
2021
|
# @option params [required, String] :cluster_id
|
1681
2022
|
# The identifier of the cluster for which to list the steps.
|
@@ -1740,6 +2081,95 @@ module Aws::EMR
|
|
1740
2081
|
req.send_request(options)
|
1741
2082
|
end
|
1742
2083
|
|
2084
|
+
# Returns a list of all user or group session mappings for the Amazon
|
2085
|
+
# EMR Studio specified by `StudioId`.
|
2086
|
+
#
|
2087
|
+
# @option params [String] :studio_id
|
2088
|
+
# The ID of the Amazon EMR Studio.
|
2089
|
+
#
|
2090
|
+
# @option params [String] :identity_type
|
2091
|
+
# Specifies whether to return session mappings for users or groups. If
|
2092
|
+
# not specified, the results include session mapping details for both
|
2093
|
+
# users and groups.
|
2094
|
+
#
|
2095
|
+
# @option params [String] :marker
|
2096
|
+
# The pagination token that indicates the set of results to retrieve.
|
2097
|
+
#
|
2098
|
+
# @return [Types::ListStudioSessionMappingsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2099
|
+
#
|
2100
|
+
# * {Types::ListStudioSessionMappingsOutput#session_mappings #session_mappings} => Array<Types::SessionMappingSummary>
|
2101
|
+
# * {Types::ListStudioSessionMappingsOutput#marker #marker} => String
|
2102
|
+
#
|
2103
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
2104
|
+
#
|
2105
|
+
# @example Request syntax with placeholder values
|
2106
|
+
#
|
2107
|
+
# resp = client.list_studio_session_mappings({
|
2108
|
+
# studio_id: "XmlStringMaxLen256",
|
2109
|
+
# identity_type: "USER", # accepts USER, GROUP
|
2110
|
+
# marker: "Marker",
|
2111
|
+
# })
|
2112
|
+
#
|
2113
|
+
# @example Response structure
|
2114
|
+
#
|
2115
|
+
# resp.session_mappings #=> Array
|
2116
|
+
# resp.session_mappings[0].studio_id #=> String
|
2117
|
+
# resp.session_mappings[0].identity_id #=> String
|
2118
|
+
# resp.session_mappings[0].identity_name #=> String
|
2119
|
+
# resp.session_mappings[0].identity_type #=> String, one of "USER", "GROUP"
|
2120
|
+
# resp.session_mappings[0].session_policy_arn #=> String
|
2121
|
+
# resp.session_mappings[0].creation_time #=> Time
|
2122
|
+
# resp.marker #=> String
|
2123
|
+
#
|
2124
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/ListStudioSessionMappings AWS API Documentation
|
2125
|
+
#
|
2126
|
+
# @overload list_studio_session_mappings(params = {})
|
2127
|
+
# @param [Hash] params ({})
|
2128
|
+
def list_studio_session_mappings(params = {}, options = {})
|
2129
|
+
req = build_request(:list_studio_session_mappings, params)
|
2130
|
+
req.send_request(options)
|
2131
|
+
end
|
2132
|
+
|
2133
|
+
# Returns a list of all Amazon EMR Studios associated with the AWS
|
2134
|
+
# account. The list includes details such as ID, Studio Access URL, and
|
2135
|
+
# creation time for each Studio.
|
2136
|
+
#
|
2137
|
+
# @option params [String] :marker
|
2138
|
+
# The pagination token that indicates the set of results to retrieve.
|
2139
|
+
#
|
2140
|
+
# @return [Types::ListStudiosOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2141
|
+
#
|
2142
|
+
# * {Types::ListStudiosOutput#studios #studios} => Array<Types::StudioSummary>
|
2143
|
+
# * {Types::ListStudiosOutput#marker #marker} => String
|
2144
|
+
#
|
2145
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
2146
|
+
#
|
2147
|
+
# @example Request syntax with placeholder values
|
2148
|
+
#
|
2149
|
+
# resp = client.list_studios({
|
2150
|
+
# marker: "Marker",
|
2151
|
+
# })
|
2152
|
+
#
|
2153
|
+
# @example Response structure
|
2154
|
+
#
|
2155
|
+
# resp.studios #=> Array
|
2156
|
+
# resp.studios[0].studio_id #=> String
|
2157
|
+
# resp.studios[0].name #=> String
|
2158
|
+
# resp.studios[0].vpc_id #=> String
|
2159
|
+
# resp.studios[0].description #=> String
|
2160
|
+
# resp.studios[0].url #=> String
|
2161
|
+
# resp.studios[0].creation_time #=> Time
|
2162
|
+
# resp.marker #=> String
|
2163
|
+
#
|
2164
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/ListStudios AWS API Documentation
|
2165
|
+
#
|
2166
|
+
# @overload list_studios(params = {})
|
2167
|
+
# @param [Hash] params ({})
|
2168
|
+
def list_studios(params = {}, options = {})
|
2169
|
+
req = build_request(:list_studios, params)
|
2170
|
+
req.send_request(options)
|
2171
|
+
end
|
2172
|
+
|
1743
2173
|
# Modifies the number of steps that can be executed concurrently for the
|
1744
2174
|
# cluster specified using ClusterID.
|
1745
2175
|
#
|
@@ -1748,7 +2178,7 @@ module Aws::EMR
|
|
1748
2178
|
#
|
1749
2179
|
# @option params [Integer] :step_concurrency_level
|
1750
2180
|
# The number of steps that can be executed concurrently. You can specify
|
1751
|
-
# a maximum of 256 steps.
|
2181
|
+
# a minimum of 1 step and a maximum of 256 steps.
|
1752
2182
|
#
|
1753
2183
|
# @return [Types::ModifyClusterOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1754
2184
|
#
|
@@ -2202,9 +2632,9 @@ module Aws::EMR
|
|
2202
2632
|
#
|
2203
2633
|
# @option params [String] :log_encryption_kms_key_id
|
2204
2634
|
# The AWS KMS customer master key (CMK) used for encrypting log files.
|
2205
|
-
# If a value is not provided, the logs
|
2206
|
-
#
|
2207
|
-
# excluding EMR 6.0.0.
|
2635
|
+
# If a value is not provided, the logs remain encrypted by AES-256. This
|
2636
|
+
# attribute is only available with Amazon EMR version 5.30.0 and later,
|
2637
|
+
# excluding Amazon EMR 6.0.0.
|
2208
2638
|
#
|
2209
2639
|
# @option params [String] :additional_info
|
2210
2640
|
# A JSON string for selecting additional features.
|
@@ -2280,7 +2710,7 @@ module Aws::EMR
|
|
2280
2710
|
#
|
2281
2711
|
# * "mapr-m7" - launch the cluster using MapR M7 Edition.
|
2282
2712
|
#
|
2283
|
-
# * "hunk" - launch the cluster with the Hunk Big Data
|
2713
|
+
# * "hunk" - launch the cluster with the Hunk Big Data Analytics
|
2284
2714
|
# Platform.
|
2285
2715
|
#
|
2286
2716
|
# * "hue"- launch the cluster with Hue installed.
|
@@ -2345,13 +2775,13 @@ module Aws::EMR
|
|
2345
2775
|
# terminate the instance was submitted. This option is only available
|
2346
2776
|
# with Amazon EMR 5.1.0 and later and is the default for clusters
|
2347
2777
|
# created using that version. `TERMINATE_AT_TASK_COMPLETION` indicates
|
2348
|
-
# that Amazon EMR
|
2349
|
-
# terminating the Amazon EC2 instances, regardless of the
|
2350
|
-
# boundary. With either behavior, Amazon EMR removes the
|
2351
|
-
# nodes first and blocks instance termination if it could
|
2352
|
-
# corruption. `TERMINATE_AT_TASK_COMPLETION` available only
|
2353
|
-
# EMR version 4.1.0 and later, and is the default for versions
|
2354
|
-
# EMR earlier than 5.1.0.
|
2778
|
+
# that Amazon EMR adds nodes to a deny list and drains tasks from nodes
|
2779
|
+
# before terminating the Amazon EC2 instances, regardless of the
|
2780
|
+
# instance-hour boundary. With either behavior, Amazon EMR removes the
|
2781
|
+
# least active nodes first and blocks instance termination if it could
|
2782
|
+
# lead to HDFS corruption. `TERMINATE_AT_TASK_COMPLETION` available only
|
2783
|
+
# in Amazon EMR version 4.1.0 and later, and is the default for versions
|
2784
|
+
# of Amazon EMR earlier than 5.1.0.
|
2355
2785
|
#
|
2356
2786
|
# @option params [String] :custom_ami_id
|
2357
2787
|
# Available only in Amazon EMR version 5.7.0 and later. The ID of a
|
@@ -2374,9 +2804,9 @@ module Aws::EMR
|
|
2374
2804
|
# [3]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html
|
2375
2805
|
#
|
2376
2806
|
# @option params [Integer] :ebs_root_volume_size
|
2377
|
-
# The size, in GiB, of the EBS root device volume of the Linux
|
2378
|
-
# is used for each EC2 instance. Available in Amazon EMR
|
2379
|
-
# later.
|
2807
|
+
# The size, in GiB, of the Amazon EBS root device volume of the Linux
|
2808
|
+
# AMI that is used for each EC2 instance. Available in Amazon EMR
|
2809
|
+
# version 4.x and later.
|
2380
2810
|
#
|
2381
2811
|
# @option params [String] :repo_upgrade_on_boot
|
2382
2812
|
# Applies only when `CustomAmiID` is used. Specifies which updates from
|
@@ -2389,7 +2819,7 @@ module Aws::EMR
|
|
2389
2819
|
# @option params [Types::KerberosAttributes] :kerberos_attributes
|
2390
2820
|
# Attributes for Kerberos configuration when Kerberos authentication is
|
2391
2821
|
# enabled using a security configuration. For more information see [Use
|
2392
|
-
# Kerberos Authentication][1] in the *EMR Management Guide*.
|
2822
|
+
# Kerberos Authentication][1] in the *Amazon EMR Management Guide*.
|
2393
2823
|
#
|
2394
2824
|
#
|
2395
2825
|
#
|
@@ -2403,6 +2833,7 @@ module Aws::EMR
|
|
2403
2833
|
# The specified managed scaling policy for an Amazon EMR cluster.
|
2404
2834
|
#
|
2405
2835
|
# @option params [Array<Types::PlacementGroupConfig>] :placement_group_configs
|
2836
|
+
# The specified placement group configuration for an Amazon EMR cluster.
|
2406
2837
|
#
|
2407
2838
|
# @return [Types::RunJobFlowOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2408
2839
|
#
|
@@ -2541,6 +2972,10 @@ module Aws::EMR
|
|
2541
2972
|
# },
|
2542
2973
|
# on_demand_specification: {
|
2543
2974
|
# allocation_strategy: "lowest-price", # required, accepts lowest-price
|
2975
|
+
# capacity_reservation_options: {
|
2976
|
+
# usage_strategy: "use-capacity-reservations-first", # accepts use-capacity-reservations-first
|
2977
|
+
# capacity_reservation_preference: "open", # accepts open, none
|
2978
|
+
# },
|
2544
2979
|
# },
|
2545
2980
|
# },
|
2546
2981
|
# },
|
@@ -2798,7 +3233,7 @@ module Aws::EMR
|
|
2798
3233
|
#
|
2799
3234
|
# @option params [Array<Types::Tag>] :tags
|
2800
3235
|
# A list of tags associated with a notebook execution. Tags are
|
2801
|
-
# user-defined key
|
3236
|
+
# user-defined key-value pairs that consist of a required key string
|
2802
3237
|
# with a maximum of 128 characters and an optional value string with a
|
2803
3238
|
# maximum of 256 characters.
|
2804
3239
|
#
|
@@ -2876,7 +3311,7 @@ module Aws::EMR
|
|
2876
3311
|
# EC2 instances.
|
2877
3312
|
#
|
2878
3313
|
# @option params [required, Array<String>] :job_flow_ids
|
2879
|
-
# A list of job flows to be
|
3314
|
+
# A list of job flows to be shut down.
|
2880
3315
|
#
|
2881
3316
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
2882
3317
|
#
|
@@ -2895,6 +3330,106 @@ module Aws::EMR
|
|
2895
3330
|
req.send_request(options)
|
2896
3331
|
end
|
2897
3332
|
|
3333
|
+
# Updates an Amazon EMR Studio configuration, including attributes such
|
3334
|
+
# as name, description, and subnets.
|
3335
|
+
#
|
3336
|
+
# @option params [required, String] :studio_id
|
3337
|
+
# The ID of the Amazon EMR Studio to update.
|
3338
|
+
#
|
3339
|
+
# @option params [String] :name
|
3340
|
+
# A descriptive name for the Amazon EMR Studio.
|
3341
|
+
#
|
3342
|
+
# @option params [String] :description
|
3343
|
+
# A detailed description to assign to the Amazon EMR Studio.
|
3344
|
+
#
|
3345
|
+
# @option params [Array<String>] :subnet_ids
|
3346
|
+
# A list of subnet IDs to associate with the Amazon EMR Studio. The list
|
3347
|
+
# can include new subnet IDs, but must also include all of the subnet
|
3348
|
+
# IDs previously associated with the Studio. The list order does not
|
3349
|
+
# matter. A Studio can have a maximum of 5 subnets. The subnets must
|
3350
|
+
# belong to the same VPC as the Studio.
|
3351
|
+
#
|
3352
|
+
# @option params [String] :default_s3_location
|
3353
|
+
# A default Amazon S3 location to back up Workspaces and notebook files
|
3354
|
+
# for the Amazon EMR Studio. A Studio user can select an alternative
|
3355
|
+
# Amazon S3 location when creating a Workspace.
|
3356
|
+
#
|
3357
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
3358
|
+
#
|
3359
|
+
# @example Request syntax with placeholder values
|
3360
|
+
#
|
3361
|
+
# resp = client.update_studio({
|
3362
|
+
# studio_id: "XmlStringMaxLen256", # required
|
3363
|
+
# name: "XmlStringMaxLen256",
|
3364
|
+
# description: "XmlStringMaxLen256",
|
3365
|
+
# subnet_ids: ["String"],
|
3366
|
+
# default_s3_location: "XmlString",
|
3367
|
+
# })
|
3368
|
+
#
|
3369
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/UpdateStudio AWS API Documentation
|
3370
|
+
#
|
3371
|
+
# @overload update_studio(params = {})
|
3372
|
+
# @param [Hash] params ({})
|
3373
|
+
def update_studio(params = {}, options = {})
|
3374
|
+
req = build_request(:update_studio, params)
|
3375
|
+
req.send_request(options)
|
3376
|
+
end
|
3377
|
+
|
3378
|
+
# Updates the session policy attached to the user or group for the
|
3379
|
+
# specified Amazon EMR Studio.
|
3380
|
+
#
|
3381
|
+
# @option params [required, String] :studio_id
|
3382
|
+
# The ID of the Amazon EMR Studio.
|
3383
|
+
#
|
3384
|
+
# @option params [String] :identity_id
|
3385
|
+
# The globally unique identifier (GUID) of the user or group. For more
|
3386
|
+
# information, see [UserId][1] and [GroupId][2] in the *AWS SSO Identity
|
3387
|
+
# Store API Reference*. Either `IdentityName` or `IdentityId` must be
|
3388
|
+
# specified.
|
3389
|
+
#
|
3390
|
+
#
|
3391
|
+
#
|
3392
|
+
# [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId
|
3393
|
+
# [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId
|
3394
|
+
#
|
3395
|
+
# @option params [String] :identity_name
|
3396
|
+
# The name of the user or group to update. For more information, see
|
3397
|
+
# [UserName][1] and [DisplayName][2] in the *AWS SSO Identity Store API
|
3398
|
+
# Reference*. Either `IdentityName` or `IdentityId` must be specified.
|
3399
|
+
#
|
3400
|
+
#
|
3401
|
+
#
|
3402
|
+
# [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName
|
3403
|
+
# [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName
|
3404
|
+
#
|
3405
|
+
# @option params [required, String] :identity_type
|
3406
|
+
# Specifies whether the identity to update is a user or a group.
|
3407
|
+
#
|
3408
|
+
# @option params [required, String] :session_policy_arn
|
3409
|
+
# The Amazon Resource Name (ARN) of the session policy to associate with
|
3410
|
+
# the specified user or group.
|
3411
|
+
#
|
3412
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
3413
|
+
#
|
3414
|
+
# @example Request syntax with placeholder values
|
3415
|
+
#
|
3416
|
+
# resp = client.update_studio_session_mapping({
|
3417
|
+
# studio_id: "XmlStringMaxLen256", # required
|
3418
|
+
# identity_id: "XmlStringMaxLen256",
|
3419
|
+
# identity_name: "XmlStringMaxLen256",
|
3420
|
+
# identity_type: "USER", # required, accepts USER, GROUP
|
3421
|
+
# session_policy_arn: "XmlStringMaxLen256", # required
|
3422
|
+
# })
|
3423
|
+
#
|
3424
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/UpdateStudioSessionMapping AWS API Documentation
|
3425
|
+
#
|
3426
|
+
# @overload update_studio_session_mapping(params = {})
|
3427
|
+
# @param [Hash] params ({})
|
3428
|
+
def update_studio_session_mapping(params = {}, options = {})
|
3429
|
+
req = build_request(:update_studio_session_mapping, params)
|
3430
|
+
req.send_request(options)
|
3431
|
+
end
|
3432
|
+
|
2898
3433
|
# @!endgroup
|
2899
3434
|
|
2900
3435
|
# @param params ({})
|
@@ -2908,7 +3443,7 @@ module Aws::EMR
|
|
2908
3443
|
params: params,
|
2909
3444
|
config: config)
|
2910
3445
|
context[:gem_name] = 'aws-sdk-emr'
|
2911
|
-
context[:gem_version] = '1.
|
3446
|
+
context[:gem_version] = '1.43.0'
|
2912
3447
|
Seahorse::Client::Request.new(handlers, context)
|
2913
3448
|
end
|
2914
3449
|
|