aws-sdk-emr 1.35.0 → 1.40.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 +2 -1
- data/lib/aws-sdk-emr/client.rb +797 -26
- data/lib/aws-sdk-emr/client_api.rb +374 -0
- data/lib/aws-sdk-emr/types.rb +1410 -139
- 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: ae130b06093280369788d2657115ae767fe186688afacff491a7a3fab7277b4f
|
4
|
+
data.tar.gz: 5dfe7c2fa8337f3f7dea81c3444d443c5a46a7d4807e60b0327de2094b70b3b8
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: dea2fa9b0b91ed4f1fb4ea5cd17c412afa39b548235ad538e265fe076e76870542763ec47238200257237f349062e7234d2a03b120d339a8fd1f54d6e7660d4b
|
7
|
+
data.tar.gz: 8586a11aebc960bc3f4f79531f3f838fc54d07554ae38ad8abae96dcf882a172a9eb919b42cbed5cb1b917c3b4ccbde702cb9de3b3d24f81622a900539e581e1
|
data/lib/aws-sdk-emr.rb
CHANGED
@@ -7,6 +7,7 @@
|
|
7
7
|
#
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
9
9
|
|
10
|
+
|
10
11
|
require 'aws-sdk-core'
|
11
12
|
require 'aws-sigv4'
|
12
13
|
|
@@ -48,6 +49,6 @@ require_relative 'aws-sdk-emr/customizations'
|
|
48
49
|
# @!group service
|
49
50
|
module Aws::EMR
|
50
51
|
|
51
|
-
GEM_VERSION = '1.
|
52
|
+
GEM_VERSION = '1.40.0'
|
52
53
|
|
53
54
|
end
|
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,169 @@ module Aws::EMR
|
|
741
741
|
req.send_request(options)
|
742
742
|
end
|
743
743
|
|
744
|
+
# <note markdown="1"> The Amazon EMR Studio APIs are in preview release for Amazon EMR and
|
745
|
+
# are subject to change.
|
746
|
+
#
|
747
|
+
# </note>
|
748
|
+
#
|
749
|
+
# Creates a new Amazon EMR Studio.
|
750
|
+
#
|
751
|
+
# @option params [required, String] :name
|
752
|
+
# A descriptive name for the Amazon EMR Studio.
|
753
|
+
#
|
754
|
+
# @option params [String] :description
|
755
|
+
# A detailed description of the Studio.
|
756
|
+
#
|
757
|
+
# @option params [required, String] :auth_mode
|
758
|
+
# Specifies whether the Studio authenticates users using single sign-on
|
759
|
+
# (SSO) or IAM. Amazon EMR Studio currently only supports SSO
|
760
|
+
# authentication.
|
761
|
+
#
|
762
|
+
# @option params [required, String] :vpc_id
|
763
|
+
# The ID of the Amazon Virtual Private Cloud (Amazon VPC) to associate
|
764
|
+
# with the Studio.
|
765
|
+
#
|
766
|
+
# @option params [required, Array<String>] :subnet_ids
|
767
|
+
# A list of subnet IDs to associate with the Studio. The subnets must
|
768
|
+
# belong to the VPC specified by `VpcId`. Studio users can create a
|
769
|
+
# Workspace in any of 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 a Studio. The permissions attached to this IAM role can be scoped
|
779
|
+
# 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 [String] :default_s3_location
|
793
|
+
# The default Amazon S3 location to back up EMR Studio Workspaces and
|
794
|
+
# 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 Studio. Tags are user-defined
|
799
|
+
# key-value pairs that consist of a required key string with a maximum
|
800
|
+
# of 128 characters, and an optional value string with a maximum of 256
|
801
|
+
# 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",
|
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
|
+
# <note markdown="1"> The Amazon EMR Studio APIs are in preview release for Amazon EMR and
|
844
|
+
# are subject to change.
|
845
|
+
#
|
846
|
+
# </note>
|
847
|
+
#
|
848
|
+
# Maps a user or group to the Amazon EMR Studio specified by `StudioId`,
|
849
|
+
# and applies a session policy to refine Studio permissions for that
|
850
|
+
# user or group.
|
851
|
+
#
|
852
|
+
# @option params [required, String] :studio_id
|
853
|
+
# The ID of the Amazon EMR Studio to which the user or group will be
|
854
|
+
# mapped.
|
855
|
+
#
|
856
|
+
# @option params [String] :identity_id
|
857
|
+
# The globally unique identifier (GUID) of the user or group from the
|
858
|
+
# AWS SSO Identity Store. For more information, see [UserId][1] and
|
859
|
+
# [GroupId][2] in the *AWS SSO Identity Store API Reference*. Either
|
860
|
+
# `IdentityName` or `IdentityId` must be specified.
|
861
|
+
#
|
862
|
+
#
|
863
|
+
#
|
864
|
+
# [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId
|
865
|
+
# [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId
|
866
|
+
#
|
867
|
+
# @option params [String] :identity_name
|
868
|
+
# The name of the user or group. For more information, see [UserName][1]
|
869
|
+
# and [DisplayName][2] in the *AWS SSO Identity Store API Reference*.
|
870
|
+
# Either `IdentityName` or `IdentityId` must be specified.
|
871
|
+
#
|
872
|
+
#
|
873
|
+
#
|
874
|
+
# [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId
|
875
|
+
# [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName
|
876
|
+
#
|
877
|
+
# @option params [required, String] :identity_type
|
878
|
+
# Specifies whether the identity to map to the Studio is a user or a
|
879
|
+
# group.
|
880
|
+
#
|
881
|
+
# @option params [required, String] :session_policy_arn
|
882
|
+
# The Amazon Resource Name (ARN) for the session policy that will be
|
883
|
+
# applied to the user or group. Session policies refine Studio user
|
884
|
+
# permissions without the need to use multiple IAM user roles.
|
885
|
+
#
|
886
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
887
|
+
#
|
888
|
+
# @example Request syntax with placeholder values
|
889
|
+
#
|
890
|
+
# resp = client.create_studio_session_mapping({
|
891
|
+
# studio_id: "XmlStringMaxLen256", # required
|
892
|
+
# identity_id: "XmlStringMaxLen256",
|
893
|
+
# identity_name: "XmlStringMaxLen256",
|
894
|
+
# identity_type: "USER", # required, accepts USER, GROUP
|
895
|
+
# session_policy_arn: "XmlStringMaxLen256", # required
|
896
|
+
# })
|
897
|
+
#
|
898
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/CreateStudioSessionMapping AWS API Documentation
|
899
|
+
#
|
900
|
+
# @overload create_studio_session_mapping(params = {})
|
901
|
+
# @param [Hash] params ({})
|
902
|
+
def create_studio_session_mapping(params = {}, options = {})
|
903
|
+
req = build_request(:create_studio_session_mapping, params)
|
904
|
+
req.send_request(options)
|
905
|
+
end
|
906
|
+
|
744
907
|
# Deletes a security configuration.
|
745
908
|
#
|
746
909
|
# @option params [required, String] :name
|
@@ -763,6 +926,89 @@ module Aws::EMR
|
|
763
926
|
req.send_request(options)
|
764
927
|
end
|
765
928
|
|
929
|
+
# <note markdown="1"> The Amazon EMR Studio APIs are in preview release for Amazon EMR and
|
930
|
+
# are subject to change.
|
931
|
+
#
|
932
|
+
# </note>
|
933
|
+
#
|
934
|
+
# Removes an Amazon EMR Studio from the Studio metadata store.
|
935
|
+
#
|
936
|
+
# @option params [required, String] :studio_id
|
937
|
+
# The ID of the Amazon EMR Studio.
|
938
|
+
#
|
939
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
940
|
+
#
|
941
|
+
# @example Request syntax with placeholder values
|
942
|
+
#
|
943
|
+
# resp = client.delete_studio({
|
944
|
+
# studio_id: "XmlStringMaxLen256", # required
|
945
|
+
# })
|
946
|
+
#
|
947
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/DeleteStudio AWS API Documentation
|
948
|
+
#
|
949
|
+
# @overload delete_studio(params = {})
|
950
|
+
# @param [Hash] params ({})
|
951
|
+
def delete_studio(params = {}, options = {})
|
952
|
+
req = build_request(:delete_studio, params)
|
953
|
+
req.send_request(options)
|
954
|
+
end
|
955
|
+
|
956
|
+
# <note markdown="1"> The Amazon EMR Studio APIs are in preview release for Amazon EMR and
|
957
|
+
# are subject to change.
|
958
|
+
#
|
959
|
+
# </note>
|
960
|
+
#
|
961
|
+
# Removes a user or group from an Amazon EMR Studio.
|
962
|
+
#
|
963
|
+
# @option params [required, String] :studio_id
|
964
|
+
# The ID of the Amazon EMR Studio.
|
965
|
+
#
|
966
|
+
# @option params [String] :identity_id
|
967
|
+
# The globally unique identifier (GUID) of the user or group to remove
|
968
|
+
# from the Amazon EMR Studio. For more information, see [UserId][1] and
|
969
|
+
# [GroupId][2] in the *AWS SSO Identity Store API Reference*. Either
|
970
|
+
# `IdentityName` or `IdentityId` must be specified.
|
971
|
+
#
|
972
|
+
#
|
973
|
+
#
|
974
|
+
# [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId
|
975
|
+
# [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId
|
976
|
+
#
|
977
|
+
# @option params [String] :identity_name
|
978
|
+
# The name of the user name or group to remove from the Studio. For more
|
979
|
+
# information, see [UserName][1] and [DisplayName][2] in the *AWS SSO
|
980
|
+
# Identity Store API Reference*. Either `IdentityName` or `IdentityId`
|
981
|
+
# must be specified.
|
982
|
+
#
|
983
|
+
#
|
984
|
+
#
|
985
|
+
# [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId
|
986
|
+
# [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName
|
987
|
+
#
|
988
|
+
# @option params [required, String] :identity_type
|
989
|
+
# Specifies whether the identity to delete from the Studio is a user or
|
990
|
+
# a group.
|
991
|
+
#
|
992
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
993
|
+
#
|
994
|
+
# @example Request syntax with placeholder values
|
995
|
+
#
|
996
|
+
# resp = client.delete_studio_session_mapping({
|
997
|
+
# studio_id: "XmlStringMaxLen256", # required
|
998
|
+
# identity_id: "XmlStringMaxLen256",
|
999
|
+
# identity_name: "XmlStringMaxLen256",
|
1000
|
+
# identity_type: "USER", # required, accepts USER, GROUP
|
1001
|
+
# })
|
1002
|
+
#
|
1003
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/DeleteStudioSessionMapping AWS API Documentation
|
1004
|
+
#
|
1005
|
+
# @overload delete_studio_session_mapping(params = {})
|
1006
|
+
# @param [Hash] params ({})
|
1007
|
+
def delete_studio_session_mapping(params = {}, options = {})
|
1008
|
+
req = build_request(:delete_studio_session_mapping, params)
|
1009
|
+
req.send_request(options)
|
1010
|
+
end
|
1011
|
+
|
766
1012
|
# Provides cluster-level details including status, hardware and software
|
767
1013
|
# configuration, VPC settings, and so on.
|
768
1014
|
#
|
@@ -845,6 +1091,9 @@ module Aws::EMR
|
|
845
1091
|
# resp.cluster.cluster_arn #=> String
|
846
1092
|
# resp.cluster.outpost_arn #=> String
|
847
1093
|
# resp.cluster.step_concurrency_level #=> Integer
|
1094
|
+
# resp.cluster.placement_groups #=> Array
|
1095
|
+
# resp.cluster.placement_groups[0].instance_role #=> String, one of "MASTER", "CORE", "TASK"
|
1096
|
+
# resp.cluster.placement_groups[0].placement_strategy #=> String, one of "SPREAD", "PARTITION", "CLUSTER", "NONE"
|
848
1097
|
#
|
849
1098
|
#
|
850
1099
|
# The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
|
@@ -861,9 +1110,9 @@ module Aws::EMR
|
|
861
1110
|
req.send_request(options)
|
862
1111
|
end
|
863
1112
|
|
864
|
-
# This API is
|
865
|
-
# you use ListClusters, DescribeCluster, ListSteps,
|
866
|
-
# and ListBootstrapActions instead.
|
1113
|
+
# This API is no longer supported and will eventually be removed. We
|
1114
|
+
# recommend you use ListClusters, DescribeCluster, ListSteps,
|
1115
|
+
# ListInstanceGroups and ListBootstrapActions instead.
|
867
1116
|
#
|
868
1117
|
# DescribeJobFlows returns a list of job flows that match all of the
|
869
1118
|
# supplied parameters. The parameters can include a list of job flow
|
@@ -988,6 +1237,50 @@ module Aws::EMR
|
|
988
1237
|
req.send_request(options)
|
989
1238
|
end
|
990
1239
|
|
1240
|
+
# Provides details of a notebook execution.
|
1241
|
+
#
|
1242
|
+
# @option params [required, String] :notebook_execution_id
|
1243
|
+
# The unique identifier of the notebook execution.
|
1244
|
+
#
|
1245
|
+
# @return [Types::DescribeNotebookExecutionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1246
|
+
#
|
1247
|
+
# * {Types::DescribeNotebookExecutionOutput#notebook_execution #notebook_execution} => Types::NotebookExecution
|
1248
|
+
#
|
1249
|
+
# @example Request syntax with placeholder values
|
1250
|
+
#
|
1251
|
+
# resp = client.describe_notebook_execution({
|
1252
|
+
# notebook_execution_id: "XmlStringMaxLen256", # required
|
1253
|
+
# })
|
1254
|
+
#
|
1255
|
+
# @example Response structure
|
1256
|
+
#
|
1257
|
+
# resp.notebook_execution.notebook_execution_id #=> String
|
1258
|
+
# resp.notebook_execution.editor_id #=> String
|
1259
|
+
# resp.notebook_execution.execution_engine.id #=> String
|
1260
|
+
# resp.notebook_execution.execution_engine.type #=> String, one of "EMR"
|
1261
|
+
# resp.notebook_execution.execution_engine.master_instance_security_group_id #=> String
|
1262
|
+
# resp.notebook_execution.notebook_execution_name #=> String
|
1263
|
+
# resp.notebook_execution.notebook_params #=> String
|
1264
|
+
# resp.notebook_execution.status #=> String, one of "START_PENDING", "STARTING", "RUNNING", "FINISHING", "FINISHED", "FAILING", "FAILED", "STOP_PENDING", "STOPPING", "STOPPED"
|
1265
|
+
# resp.notebook_execution.start_time #=> Time
|
1266
|
+
# resp.notebook_execution.end_time #=> Time
|
1267
|
+
# resp.notebook_execution.arn #=> String
|
1268
|
+
# resp.notebook_execution.output_notebook_uri #=> String
|
1269
|
+
# resp.notebook_execution.last_state_change_reason #=> String
|
1270
|
+
# resp.notebook_execution.notebook_instance_security_group_id #=> String
|
1271
|
+
# resp.notebook_execution.tags #=> Array
|
1272
|
+
# resp.notebook_execution.tags[0].key #=> String
|
1273
|
+
# resp.notebook_execution.tags[0].value #=> String
|
1274
|
+
#
|
1275
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/DescribeNotebookExecution AWS API Documentation
|
1276
|
+
#
|
1277
|
+
# @overload describe_notebook_execution(params = {})
|
1278
|
+
# @param [Hash] params ({})
|
1279
|
+
def describe_notebook_execution(params = {}, options = {})
|
1280
|
+
req = build_request(:describe_notebook_execution, params)
|
1281
|
+
req.send_request(options)
|
1282
|
+
end
|
1283
|
+
|
991
1284
|
# Provides the details of a security configuration by returning the
|
992
1285
|
# configuration JSON.
|
993
1286
|
#
|
@@ -1075,6 +1368,57 @@ module Aws::EMR
|
|
1075
1368
|
req.send_request(options)
|
1076
1369
|
end
|
1077
1370
|
|
1371
|
+
# <note markdown="1"> The Amazon EMR Studio APIs are in preview release for Amazon EMR and
|
1372
|
+
# are subject to change.
|
1373
|
+
#
|
1374
|
+
# </note>
|
1375
|
+
#
|
1376
|
+
# Returns details for the specified Amazon EMR Studio including ID,
|
1377
|
+
# Name, VPC, Studio access URL, and so on.
|
1378
|
+
#
|
1379
|
+
# @option params [required, String] :studio_id
|
1380
|
+
# The Amazon EMR Studio ID.
|
1381
|
+
#
|
1382
|
+
# @return [Types::DescribeStudioOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1383
|
+
#
|
1384
|
+
# * {Types::DescribeStudioOutput#studio #studio} => Types::Studio
|
1385
|
+
#
|
1386
|
+
# @example Request syntax with placeholder values
|
1387
|
+
#
|
1388
|
+
# resp = client.describe_studio({
|
1389
|
+
# studio_id: "XmlStringMaxLen256", # required
|
1390
|
+
# })
|
1391
|
+
#
|
1392
|
+
# @example Response structure
|
1393
|
+
#
|
1394
|
+
# resp.studio.studio_id #=> String
|
1395
|
+
# resp.studio.studio_arn #=> String
|
1396
|
+
# resp.studio.name #=> String
|
1397
|
+
# resp.studio.description #=> String
|
1398
|
+
# resp.studio.auth_mode #=> String, one of "SSO", "IAM"
|
1399
|
+
# resp.studio.vpc_id #=> String
|
1400
|
+
# resp.studio.subnet_ids #=> Array
|
1401
|
+
# resp.studio.subnet_ids[0] #=> String
|
1402
|
+
# resp.studio.service_role #=> String
|
1403
|
+
# resp.studio.user_role #=> String
|
1404
|
+
# resp.studio.workspace_security_group_id #=> String
|
1405
|
+
# resp.studio.engine_security_group_id #=> String
|
1406
|
+
# resp.studio.url #=> String
|
1407
|
+
# resp.studio.creation_time #=> Time
|
1408
|
+
# resp.studio.default_s3_location #=> String
|
1409
|
+
# resp.studio.tags #=> Array
|
1410
|
+
# resp.studio.tags[0].key #=> String
|
1411
|
+
# resp.studio.tags[0].value #=> String
|
1412
|
+
#
|
1413
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/DescribeStudio AWS API Documentation
|
1414
|
+
#
|
1415
|
+
# @overload describe_studio(params = {})
|
1416
|
+
# @param [Hash] params ({})
|
1417
|
+
def describe_studio(params = {}, options = {})
|
1418
|
+
req = build_request(:describe_studio, params)
|
1419
|
+
req.send_request(options)
|
1420
|
+
end
|
1421
|
+
|
1078
1422
|
# Returns the Amazon EMR block public access configuration for your AWS
|
1079
1423
|
# account in the current Region. For more information see [Configure
|
1080
1424
|
# Block Public Access for Amazon EMR][1] in the *Amazon EMR Management
|
@@ -1140,6 +1484,73 @@ module Aws::EMR
|
|
1140
1484
|
req.send_request(options)
|
1141
1485
|
end
|
1142
1486
|
|
1487
|
+
# <note markdown="1"> The Amazon EMR Studio APIs are in preview release for Amazon EMR and
|
1488
|
+
# are subject to change.
|
1489
|
+
#
|
1490
|
+
# </note>
|
1491
|
+
#
|
1492
|
+
# Fetches mapping details for the specified Amazon EMR Studio and
|
1493
|
+
# identity (user or group).
|
1494
|
+
#
|
1495
|
+
# @option params [required, String] :studio_id
|
1496
|
+
# The ID of the Amazon EMR Studio.
|
1497
|
+
#
|
1498
|
+
# @option params [String] :identity_id
|
1499
|
+
# The globally unique identifier (GUID) of the user or group. For more
|
1500
|
+
# information, see [UserId][1] and [GroupId][2] in the *AWS SSO Identity
|
1501
|
+
# Store API Reference*. Either `IdentityName` or `IdentityId` must be
|
1502
|
+
# specified.
|
1503
|
+
#
|
1504
|
+
#
|
1505
|
+
#
|
1506
|
+
# [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId
|
1507
|
+
# [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId
|
1508
|
+
#
|
1509
|
+
# @option params [String] :identity_name
|
1510
|
+
# The name of the user or group to fetch. For more information, see
|
1511
|
+
# [UserName][1] and [DisplayName][2] in the *AWS SSO Identity Store API
|
1512
|
+
# Reference*. Either `IdentityName` or `IdentityId` must be specified.
|
1513
|
+
#
|
1514
|
+
#
|
1515
|
+
#
|
1516
|
+
# [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId
|
1517
|
+
# [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName
|
1518
|
+
#
|
1519
|
+
# @option params [required, String] :identity_type
|
1520
|
+
# Specifies whether the identity to fetch is a user or a group.
|
1521
|
+
#
|
1522
|
+
# @return [Types::GetStudioSessionMappingOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1523
|
+
#
|
1524
|
+
# * {Types::GetStudioSessionMappingOutput#session_mapping #session_mapping} => Types::SessionMappingDetail
|
1525
|
+
#
|
1526
|
+
# @example Request syntax with placeholder values
|
1527
|
+
#
|
1528
|
+
# resp = client.get_studio_session_mapping({
|
1529
|
+
# studio_id: "XmlStringMaxLen256", # required
|
1530
|
+
# identity_id: "XmlStringMaxLen256",
|
1531
|
+
# identity_name: "XmlStringMaxLen256",
|
1532
|
+
# identity_type: "USER", # required, accepts USER, GROUP
|
1533
|
+
# })
|
1534
|
+
#
|
1535
|
+
# @example Response structure
|
1536
|
+
#
|
1537
|
+
# resp.session_mapping.studio_id #=> String
|
1538
|
+
# resp.session_mapping.identity_id #=> String
|
1539
|
+
# resp.session_mapping.identity_name #=> String
|
1540
|
+
# resp.session_mapping.identity_type #=> String, one of "USER", "GROUP"
|
1541
|
+
# resp.session_mapping.session_policy_arn #=> String
|
1542
|
+
# resp.session_mapping.creation_time #=> Time
|
1543
|
+
# resp.session_mapping.last_modified_time #=> Time
|
1544
|
+
#
|
1545
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/GetStudioSessionMapping AWS API Documentation
|
1546
|
+
#
|
1547
|
+
# @overload get_studio_session_mapping(params = {})
|
1548
|
+
# @param [Hash] params ({})
|
1549
|
+
def get_studio_session_mapping(params = {}, options = {})
|
1550
|
+
req = build_request(:get_studio_session_mapping, params)
|
1551
|
+
req.send_request(options)
|
1552
|
+
end
|
1553
|
+
|
1143
1554
|
# Provides information about the bootstrap actions associated with a
|
1144
1555
|
# cluster.
|
1145
1556
|
#
|
@@ -1499,6 +1910,95 @@ module Aws::EMR
|
|
1499
1910
|
req.send_request(options)
|
1500
1911
|
end
|
1501
1912
|
|
1913
|
+
# Provides summaries of all notebook executions. You can filter the list
|
1914
|
+
# based on multiple criteria such as status, time range, and editor id.
|
1915
|
+
# Returns a maximum of 50 notebook executions and a marker to track the
|
1916
|
+
# paging of a longer notebook execution list across multiple
|
1917
|
+
# `ListNotebookExecution` calls.
|
1918
|
+
#
|
1919
|
+
# @option params [String] :editor_id
|
1920
|
+
# The unique ID of the editor associated with the notebook execution.
|
1921
|
+
#
|
1922
|
+
# @option params [String] :status
|
1923
|
+
# The status filter for listing notebook executions.
|
1924
|
+
#
|
1925
|
+
# * `START_PENDING` indicates that the cluster has received the
|
1926
|
+
# execution request but execution has not begun.
|
1927
|
+
#
|
1928
|
+
# * `STARTING` indicates that the execution is starting on the cluster.
|
1929
|
+
#
|
1930
|
+
# * `RUNNING` indicates that the execution is being processed by the
|
1931
|
+
# cluster.
|
1932
|
+
#
|
1933
|
+
# * `FINISHING` indicates that execution processing is in the final
|
1934
|
+
# stages.
|
1935
|
+
#
|
1936
|
+
# * `FINISHED` indicates that the execution has completed without error.
|
1937
|
+
#
|
1938
|
+
# * `FAILING` indicates that the execution is failing and will not
|
1939
|
+
# finish successfully.
|
1940
|
+
#
|
1941
|
+
# * `FAILED` indicates that the execution failed.
|
1942
|
+
#
|
1943
|
+
# * `STOP_PENDING` indicates that the cluster has received a
|
1944
|
+
# `StopNotebookExecution` request and the stop is pending.
|
1945
|
+
#
|
1946
|
+
# * `STOPPING` indicates that the cluster is in the process of stopping
|
1947
|
+
# the execution as a result of a `StopNotebookExecution` request.
|
1948
|
+
#
|
1949
|
+
# * `STOPPED` indicates that the execution stopped because of a
|
1950
|
+
# `StopNotebookExecution` request.
|
1951
|
+
#
|
1952
|
+
# @option params [Time,DateTime,Date,Integer,String] :from
|
1953
|
+
# The beginning of time range filter for listing notebook executions.
|
1954
|
+
# The default is the timestamp of 30 days ago.
|
1955
|
+
#
|
1956
|
+
# @option params [Time,DateTime,Date,Integer,String] :to
|
1957
|
+
# The end of time range filter for listing notebook executions. The
|
1958
|
+
# default is the current timestamp.
|
1959
|
+
#
|
1960
|
+
# @option params [String] :marker
|
1961
|
+
# The pagination token, returned by a previous `ListNotebookExecutions`
|
1962
|
+
# call, that indicates the start of the list for this
|
1963
|
+
# `ListNotebookExecutions` call.
|
1964
|
+
#
|
1965
|
+
# @return [Types::ListNotebookExecutionsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1966
|
+
#
|
1967
|
+
# * {Types::ListNotebookExecutionsOutput#notebook_executions #notebook_executions} => Array<Types::NotebookExecutionSummary>
|
1968
|
+
# * {Types::ListNotebookExecutionsOutput#marker #marker} => String
|
1969
|
+
#
|
1970
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
1971
|
+
#
|
1972
|
+
# @example Request syntax with placeholder values
|
1973
|
+
#
|
1974
|
+
# resp = client.list_notebook_executions({
|
1975
|
+
# editor_id: "XmlStringMaxLen256",
|
1976
|
+
# status: "START_PENDING", # accepts START_PENDING, STARTING, RUNNING, FINISHING, FINISHED, FAILING, FAILED, STOP_PENDING, STOPPING, STOPPED
|
1977
|
+
# from: Time.now,
|
1978
|
+
# to: Time.now,
|
1979
|
+
# marker: "Marker",
|
1980
|
+
# })
|
1981
|
+
#
|
1982
|
+
# @example Response structure
|
1983
|
+
#
|
1984
|
+
# resp.notebook_executions #=> Array
|
1985
|
+
# resp.notebook_executions[0].notebook_execution_id #=> String
|
1986
|
+
# resp.notebook_executions[0].editor_id #=> String
|
1987
|
+
# resp.notebook_executions[0].notebook_execution_name #=> String
|
1988
|
+
# resp.notebook_executions[0].status #=> String, one of "START_PENDING", "STARTING", "RUNNING", "FINISHING", "FINISHED", "FAILING", "FAILED", "STOP_PENDING", "STOPPING", "STOPPED"
|
1989
|
+
# resp.notebook_executions[0].start_time #=> Time
|
1990
|
+
# resp.notebook_executions[0].end_time #=> Time
|
1991
|
+
# resp.marker #=> String
|
1992
|
+
#
|
1993
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/ListNotebookExecutions AWS API Documentation
|
1994
|
+
#
|
1995
|
+
# @overload list_notebook_executions(params = {})
|
1996
|
+
# @param [Hash] params ({})
|
1997
|
+
def list_notebook_executions(params = {}, options = {})
|
1998
|
+
req = build_request(:list_notebook_executions, params)
|
1999
|
+
req.send_request(options)
|
2000
|
+
end
|
2001
|
+
|
1502
2002
|
# Lists all the security configurations visible to this account,
|
1503
2003
|
# providing their creation dates and times, and their names. This call
|
1504
2004
|
# returns a maximum of 50 clusters per call, but returns a marker to
|
@@ -1604,6 +2104,105 @@ module Aws::EMR
|
|
1604
2104
|
req.send_request(options)
|
1605
2105
|
end
|
1606
2106
|
|
2107
|
+
# <note markdown="1"> The Amazon EMR Studio APIs are in preview release for Amazon EMR and
|
2108
|
+
# are subject to change.
|
2109
|
+
#
|
2110
|
+
# </note>
|
2111
|
+
#
|
2112
|
+
# Returns a list of all user or group session mappings for the EMR
|
2113
|
+
# Studio specified by `StudioId`.
|
2114
|
+
#
|
2115
|
+
# @option params [String] :studio_id
|
2116
|
+
# The ID of the Amazon EMR Studio.
|
2117
|
+
#
|
2118
|
+
# @option params [String] :identity_type
|
2119
|
+
# Specifies whether to return session mappings for users or groups. If
|
2120
|
+
# not specified, the results include session mapping details for both
|
2121
|
+
# users and groups.
|
2122
|
+
#
|
2123
|
+
# @option params [String] :marker
|
2124
|
+
# The pagination token that indicates the set of results to retrieve.
|
2125
|
+
#
|
2126
|
+
# @return [Types::ListStudioSessionMappingsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2127
|
+
#
|
2128
|
+
# * {Types::ListStudioSessionMappingsOutput#session_mappings #session_mappings} => Array<Types::SessionMappingSummary>
|
2129
|
+
# * {Types::ListStudioSessionMappingsOutput#marker #marker} => String
|
2130
|
+
#
|
2131
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
2132
|
+
#
|
2133
|
+
# @example Request syntax with placeholder values
|
2134
|
+
#
|
2135
|
+
# resp = client.list_studio_session_mappings({
|
2136
|
+
# studio_id: "XmlStringMaxLen256",
|
2137
|
+
# identity_type: "USER", # accepts USER, GROUP
|
2138
|
+
# marker: "Marker",
|
2139
|
+
# })
|
2140
|
+
#
|
2141
|
+
# @example Response structure
|
2142
|
+
#
|
2143
|
+
# resp.session_mappings #=> Array
|
2144
|
+
# resp.session_mappings[0].studio_id #=> String
|
2145
|
+
# resp.session_mappings[0].identity_id #=> String
|
2146
|
+
# resp.session_mappings[0].identity_name #=> String
|
2147
|
+
# resp.session_mappings[0].identity_type #=> String, one of "USER", "GROUP"
|
2148
|
+
# resp.session_mappings[0].session_policy_arn #=> String
|
2149
|
+
# resp.session_mappings[0].creation_time #=> Time
|
2150
|
+
# resp.marker #=> String
|
2151
|
+
#
|
2152
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/ListStudioSessionMappings AWS API Documentation
|
2153
|
+
#
|
2154
|
+
# @overload list_studio_session_mappings(params = {})
|
2155
|
+
# @param [Hash] params ({})
|
2156
|
+
def list_studio_session_mappings(params = {}, options = {})
|
2157
|
+
req = build_request(:list_studio_session_mappings, params)
|
2158
|
+
req.send_request(options)
|
2159
|
+
end
|
2160
|
+
|
2161
|
+
# <note markdown="1"> The Amazon EMR Studio APIs are in preview release for Amazon EMR and
|
2162
|
+
# are subject to change.
|
2163
|
+
#
|
2164
|
+
# </note>
|
2165
|
+
#
|
2166
|
+
# Returns a list of all Amazon EMR Studios associated with the AWS
|
2167
|
+
# account. The list includes details such as ID, Studio Access URL, and
|
2168
|
+
# creation time for each Studio.
|
2169
|
+
#
|
2170
|
+
# @option params [String] :marker
|
2171
|
+
# The pagination token that indicates the set of results to retrieve.
|
2172
|
+
#
|
2173
|
+
# @return [Types::ListStudiosOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2174
|
+
#
|
2175
|
+
# * {Types::ListStudiosOutput#studios #studios} => Array<Types::StudioSummary>
|
2176
|
+
# * {Types::ListStudiosOutput#marker #marker} => String
|
2177
|
+
#
|
2178
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
2179
|
+
#
|
2180
|
+
# @example Request syntax with placeholder values
|
2181
|
+
#
|
2182
|
+
# resp = client.list_studios({
|
2183
|
+
# marker: "Marker",
|
2184
|
+
# })
|
2185
|
+
#
|
2186
|
+
# @example Response structure
|
2187
|
+
#
|
2188
|
+
# resp.studios #=> Array
|
2189
|
+
# resp.studios[0].studio_id #=> String
|
2190
|
+
# resp.studios[0].name #=> String
|
2191
|
+
# resp.studios[0].vpc_id #=> String
|
2192
|
+
# resp.studios[0].description #=> String
|
2193
|
+
# resp.studios[0].url #=> String
|
2194
|
+
# resp.studios[0].creation_time #=> Time
|
2195
|
+
# resp.marker #=> String
|
2196
|
+
#
|
2197
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/ListStudios AWS API Documentation
|
2198
|
+
#
|
2199
|
+
# @overload list_studios(params = {})
|
2200
|
+
# @param [Hash] params ({})
|
2201
|
+
def list_studios(params = {}, options = {})
|
2202
|
+
req = build_request(:list_studios, params)
|
2203
|
+
req.send_request(options)
|
2204
|
+
end
|
2205
|
+
|
1607
2206
|
# Modifies the number of steps that can be executed concurrently for the
|
1608
2207
|
# cluster specified using ClusterID.
|
1609
2208
|
#
|
@@ -2066,9 +2665,9 @@ module Aws::EMR
|
|
2066
2665
|
#
|
2067
2666
|
# @option params [String] :log_encryption_kms_key_id
|
2068
2667
|
# The AWS KMS customer master key (CMK) used for encrypting log files.
|
2069
|
-
# If a value is not provided, the logs
|
2070
|
-
#
|
2071
|
-
# excluding EMR 6.0.0.
|
2668
|
+
# If a value is not provided, the logs remain encrypted by AES-256. This
|
2669
|
+
# attribute is only available with Amazon EMR version 5.30.0 and later,
|
2670
|
+
# excluding Amazon EMR 6.0.0.
|
2072
2671
|
#
|
2073
2672
|
# @option params [String] :additional_info
|
2074
2673
|
# A JSON string for selecting additional features.
|
@@ -2209,13 +2808,13 @@ module Aws::EMR
|
|
2209
2808
|
# terminate the instance was submitted. This option is only available
|
2210
2809
|
# with Amazon EMR 5.1.0 and later and is the default for clusters
|
2211
2810
|
# created using that version. `TERMINATE_AT_TASK_COMPLETION` indicates
|
2212
|
-
# that Amazon EMR
|
2213
|
-
# terminating the Amazon EC2 instances, regardless of the
|
2214
|
-
# boundary. With either behavior, Amazon EMR removes the
|
2215
|
-
# nodes first and blocks instance termination if it could
|
2216
|
-
# corruption. `TERMINATE_AT_TASK_COMPLETION` available only
|
2217
|
-
# EMR version 4.1.0 and later, and is the default for versions
|
2218
|
-
# EMR earlier than 5.1.0.
|
2811
|
+
# that Amazon EMR adds nodes to a deny list and drains tasks from nodes
|
2812
|
+
# before terminating the Amazon EC2 instances, regardless of the
|
2813
|
+
# instance-hour boundary. With either behavior, Amazon EMR removes the
|
2814
|
+
# least active nodes first and blocks instance termination if it could
|
2815
|
+
# lead to HDFS corruption. `TERMINATE_AT_TASK_COMPLETION` available only
|
2816
|
+
# in Amazon EMR version 4.1.0 and later, and is the default for versions
|
2817
|
+
# of Amazon EMR earlier than 5.1.0.
|
2219
2818
|
#
|
2220
2819
|
# @option params [String] :custom_ami_id
|
2221
2820
|
# Available only in Amazon EMR version 5.7.0 and later. The ID of a
|
@@ -2238,9 +2837,9 @@ module Aws::EMR
|
|
2238
2837
|
# [3]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html
|
2239
2838
|
#
|
2240
2839
|
# @option params [Integer] :ebs_root_volume_size
|
2241
|
-
# The size, in GiB, of the EBS root device volume of the Linux
|
2242
|
-
# is used for each EC2 instance. Available in Amazon EMR
|
2243
|
-
# later.
|
2840
|
+
# The size, in GiB, of the Amazon EBS root device volume of the Linux
|
2841
|
+
# AMI that is used for each EC2 instance. Available in Amazon EMR
|
2842
|
+
# version 4.x and later.
|
2244
2843
|
#
|
2245
2844
|
# @option params [String] :repo_upgrade_on_boot
|
2246
2845
|
# Applies only when `CustomAmiID` is used. Specifies which updates from
|
@@ -2253,7 +2852,7 @@ module Aws::EMR
|
|
2253
2852
|
# @option params [Types::KerberosAttributes] :kerberos_attributes
|
2254
2853
|
# Attributes for Kerberos configuration when Kerberos authentication is
|
2255
2854
|
# enabled using a security configuration. For more information see [Use
|
2256
|
-
# Kerberos Authentication][1] in the *EMR Management Guide*.
|
2855
|
+
# Kerberos Authentication][1] in the *Amazon EMR Management Guide*.
|
2257
2856
|
#
|
2258
2857
|
#
|
2259
2858
|
#
|
@@ -2266,6 +2865,9 @@ module Aws::EMR
|
|
2266
2865
|
# @option params [Types::ManagedScalingPolicy] :managed_scaling_policy
|
2267
2866
|
# The specified managed scaling policy for an Amazon EMR cluster.
|
2268
2867
|
#
|
2868
|
+
# @option params [Array<Types::PlacementGroupConfig>] :placement_group_configs
|
2869
|
+
# The specified placement group configuration for an Amazon EMR cluster.
|
2870
|
+
#
|
2269
2871
|
# @return [Types::RunJobFlowOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2270
2872
|
#
|
2271
2873
|
# * {Types::RunJobFlowOutput#job_flow_id #job_flow_id} => String
|
@@ -2509,6 +3111,12 @@ module Aws::EMR
|
|
2509
3111
|
# maximum_core_capacity_units: 1,
|
2510
3112
|
# },
|
2511
3113
|
# },
|
3114
|
+
# placement_group_configs: [
|
3115
|
+
# {
|
3116
|
+
# instance_role: "MASTER", # required, accepts MASTER, CORE, TASK
|
3117
|
+
# placement_strategy: "SPREAD", # accepts SPREAD, PARTITION, CLUSTER, NONE
|
3118
|
+
# },
|
3119
|
+
# ],
|
2512
3120
|
# })
|
2513
3121
|
#
|
2514
3122
|
# @example Response structure
|
@@ -2616,6 +3224,109 @@ module Aws::EMR
|
|
2616
3224
|
req.send_request(options)
|
2617
3225
|
end
|
2618
3226
|
|
3227
|
+
# Starts a notebook execution.
|
3228
|
+
#
|
3229
|
+
# @option params [required, String] :editor_id
|
3230
|
+
# The unique identifier of the EMR Notebook to use for notebook
|
3231
|
+
# execution.
|
3232
|
+
#
|
3233
|
+
# @option params [required, String] :relative_path
|
3234
|
+
# The path and file name of the notebook file for this execution,
|
3235
|
+
# relative to the path specified for the EMR Notebook. For example, if
|
3236
|
+
# you specify a path of `s3://MyBucket/MyNotebooks` when you create an
|
3237
|
+
# EMR Notebook for a notebook with an ID of
|
3238
|
+
# `e-ABCDEFGHIJK1234567890ABCD` (the `EditorID` of this request), and
|
3239
|
+
# you specify a `RelativePath` of
|
3240
|
+
# `my_notebook_executions/notebook_execution.ipynb`, the location of the
|
3241
|
+
# file for the notebook execution is
|
3242
|
+
# `s3://MyBucket/MyNotebooks/e-ABCDEFGHIJK1234567890ABCD/my_notebook_executions/notebook_execution.ipynb`.
|
3243
|
+
#
|
3244
|
+
# @option params [String] :notebook_execution_name
|
3245
|
+
# An optional name for the notebook execution.
|
3246
|
+
#
|
3247
|
+
# @option params [String] :notebook_params
|
3248
|
+
# Input parameters in JSON format passed to the EMR Notebook at runtime
|
3249
|
+
# for execution.
|
3250
|
+
#
|
3251
|
+
# @option params [required, Types::ExecutionEngineConfig] :execution_engine
|
3252
|
+
# Specifies the execution engine (cluster) that runs the notebook
|
3253
|
+
# execution.
|
3254
|
+
#
|
3255
|
+
# @option params [required, String] :service_role
|
3256
|
+
# The name or ARN of the IAM role that is used as the service role for
|
3257
|
+
# Amazon EMR (the EMR role) for the notebook execution.
|
3258
|
+
#
|
3259
|
+
# @option params [String] :notebook_instance_security_group_id
|
3260
|
+
# The unique identifier of the Amazon EC2 security group to associate
|
3261
|
+
# with the EMR Notebook for this notebook execution.
|
3262
|
+
#
|
3263
|
+
# @option params [Array<Types::Tag>] :tags
|
3264
|
+
# A list of tags associated with a notebook execution. Tags are
|
3265
|
+
# user-defined key-value pairs that consist of a required key string
|
3266
|
+
# with a maximum of 128 characters and an optional value string with a
|
3267
|
+
# maximum of 256 characters.
|
3268
|
+
#
|
3269
|
+
# @return [Types::StartNotebookExecutionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
3270
|
+
#
|
3271
|
+
# * {Types::StartNotebookExecutionOutput#notebook_execution_id #notebook_execution_id} => String
|
3272
|
+
#
|
3273
|
+
# @example Request syntax with placeholder values
|
3274
|
+
#
|
3275
|
+
# resp = client.start_notebook_execution({
|
3276
|
+
# editor_id: "XmlStringMaxLen256", # required
|
3277
|
+
# relative_path: "XmlString", # required
|
3278
|
+
# notebook_execution_name: "XmlStringMaxLen256",
|
3279
|
+
# notebook_params: "XmlString",
|
3280
|
+
# execution_engine: { # required
|
3281
|
+
# id: "XmlStringMaxLen256", # required
|
3282
|
+
# type: "EMR", # accepts EMR
|
3283
|
+
# master_instance_security_group_id: "XmlStringMaxLen256",
|
3284
|
+
# },
|
3285
|
+
# service_role: "XmlString", # required
|
3286
|
+
# notebook_instance_security_group_id: "XmlStringMaxLen256",
|
3287
|
+
# tags: [
|
3288
|
+
# {
|
3289
|
+
# key: "String",
|
3290
|
+
# value: "String",
|
3291
|
+
# },
|
3292
|
+
# ],
|
3293
|
+
# })
|
3294
|
+
#
|
3295
|
+
# @example Response structure
|
3296
|
+
#
|
3297
|
+
# resp.notebook_execution_id #=> String
|
3298
|
+
#
|
3299
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/StartNotebookExecution AWS API Documentation
|
3300
|
+
#
|
3301
|
+
# @overload start_notebook_execution(params = {})
|
3302
|
+
# @param [Hash] params ({})
|
3303
|
+
def start_notebook_execution(params = {}, options = {})
|
3304
|
+
req = build_request(:start_notebook_execution, params)
|
3305
|
+
req.send_request(options)
|
3306
|
+
end
|
3307
|
+
|
3308
|
+
# Stops a notebook execution.
|
3309
|
+
#
|
3310
|
+
# @option params [required, String] :notebook_execution_id
|
3311
|
+
# The unique identifier of the notebook execution.
|
3312
|
+
#
|
3313
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
3314
|
+
#
|
3315
|
+
# @example Request syntax with placeholder values
|
3316
|
+
#
|
3317
|
+
# resp = client.stop_notebook_execution({
|
3318
|
+
# notebook_execution_id: "XmlStringMaxLen256", # required
|
3319
|
+
# })
|
3320
|
+
#
|
3321
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/StopNotebookExecution AWS API Documentation
|
3322
|
+
#
|
3323
|
+
# @overload stop_notebook_execution(params = {})
|
3324
|
+
# @param [Hash] params ({})
|
3325
|
+
def stop_notebook_execution(params = {}, options = {})
|
3326
|
+
req = build_request(:stop_notebook_execution, params)
|
3327
|
+
req.send_request(options)
|
3328
|
+
end
|
3329
|
+
|
2619
3330
|
# TerminateJobFlows shuts a list of clusters (job flows) down. When a
|
2620
3331
|
# job flow is shut down, any step not yet completed is canceled and the
|
2621
3332
|
# EC2 instances on which the cluster is running are stopped. Any log
|
@@ -2629,7 +3340,7 @@ module Aws::EMR
|
|
2629
3340
|
# EC2 instances.
|
2630
3341
|
#
|
2631
3342
|
# @option params [required, Array<String>] :job_flow_ids
|
2632
|
-
# A list of job flows to be
|
3343
|
+
# A list of job flows to be shut down.
|
2633
3344
|
#
|
2634
3345
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
2635
3346
|
#
|
@@ -2648,6 +3359,66 @@ module Aws::EMR
|
|
2648
3359
|
req.send_request(options)
|
2649
3360
|
end
|
2650
3361
|
|
3362
|
+
# <note markdown="1"> The Amazon EMR Studio APIs are in preview release for Amazon EMR and
|
3363
|
+
# are subject to change.
|
3364
|
+
#
|
3365
|
+
# </note>
|
3366
|
+
#
|
3367
|
+
# Updates the session policy attached to the user or group for the
|
3368
|
+
# specified Amazon EMR Studio.
|
3369
|
+
#
|
3370
|
+
# @option params [required, String] :studio_id
|
3371
|
+
# The ID of the EMR Studio.
|
3372
|
+
#
|
3373
|
+
# @option params [String] :identity_id
|
3374
|
+
# The globally unique identifier (GUID) of the user or group. For more
|
3375
|
+
# information, see [UserId][1] and [GroupId][2] in the *AWS SSO Identity
|
3376
|
+
# Store API Reference*. Either `IdentityName` or `IdentityId` must be
|
3377
|
+
# specified.
|
3378
|
+
#
|
3379
|
+
#
|
3380
|
+
#
|
3381
|
+
# [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId
|
3382
|
+
# [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId
|
3383
|
+
#
|
3384
|
+
# @option params [String] :identity_name
|
3385
|
+
# The name of the user or group to update. For more information, see
|
3386
|
+
# [UserName][1] and [DisplayName][2] in the *AWS SSO Identity Store API
|
3387
|
+
# Reference*. Either `IdentityName` or `IdentityId` must be specified.
|
3388
|
+
#
|
3389
|
+
#
|
3390
|
+
#
|
3391
|
+
# [1]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId
|
3392
|
+
# [2]: https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName
|
3393
|
+
#
|
3394
|
+
# @option params [required, String] :identity_type
|
3395
|
+
# Specifies whether the identity to update is a user or a group.
|
3396
|
+
#
|
3397
|
+
# @option params [required, String] :session_policy_arn
|
3398
|
+
# The Amazon Resource Name (ARN) of the session policy to associate with
|
3399
|
+
# the specified user or group.
|
3400
|
+
#
|
3401
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
3402
|
+
#
|
3403
|
+
# @example Request syntax with placeholder values
|
3404
|
+
#
|
3405
|
+
# resp = client.update_studio_session_mapping({
|
3406
|
+
# studio_id: "XmlStringMaxLen256", # required
|
3407
|
+
# identity_id: "XmlStringMaxLen256",
|
3408
|
+
# identity_name: "XmlStringMaxLen256",
|
3409
|
+
# identity_type: "USER", # required, accepts USER, GROUP
|
3410
|
+
# session_policy_arn: "XmlStringMaxLen256", # required
|
3411
|
+
# })
|
3412
|
+
#
|
3413
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/elasticmapreduce-2009-03-31/UpdateStudioSessionMapping AWS API Documentation
|
3414
|
+
#
|
3415
|
+
# @overload update_studio_session_mapping(params = {})
|
3416
|
+
# @param [Hash] params ({})
|
3417
|
+
def update_studio_session_mapping(params = {}, options = {})
|
3418
|
+
req = build_request(:update_studio_session_mapping, params)
|
3419
|
+
req.send_request(options)
|
3420
|
+
end
|
3421
|
+
|
2651
3422
|
# @!endgroup
|
2652
3423
|
|
2653
3424
|
# @param params ({})
|
@@ -2661,7 +3432,7 @@ module Aws::EMR
|
|
2661
3432
|
params: params,
|
2662
3433
|
config: config)
|
2663
3434
|
context[:gem_name] = 'aws-sdk-emr'
|
2664
|
-
context[:gem_version] = '1.
|
3435
|
+
context[:gem_version] = '1.40.0'
|
2665
3436
|
Seahorse::Client::Request.new(handlers, context)
|
2666
3437
|
end
|
2667
3438
|
|