aws-sdk-emr 1.35.0 → 1.40.0
Sign up to get free protection for your applications and to get access to all the features.
- 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
|
|