@aws-sdk/client-emr 3.85.0 → 3.92.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.
- package/CHANGELOG.md +27 -0
- package/README.md +3 -4
- package/dist-cjs/models/models_0.js +14 -3
- package/dist-cjs/protocols/Aws_json1_1.js +24 -0
- package/dist-es/models/models_0.js +9 -0
- package/dist-es/protocols/Aws_json1_1.js +26 -4
- package/dist-types/EMR.d.ts +99 -78
- package/dist-types/EMRClient.d.ts +3 -4
- package/dist-types/commands/AddInstanceFleetCommand.d.ts +2 -2
- package/dist-types/commands/AddJobFlowStepsCommand.d.ts +8 -7
- package/dist-types/commands/AddTagsCommand.d.ts +5 -3
- package/dist-types/commands/CancelStepsCommand.d.ts +4 -3
- package/dist-types/commands/CreateStudioSessionMappingCommand.d.ts +5 -2
- package/dist-types/commands/DescribeReleaseLabelCommand.d.ts +3 -1
- package/dist-types/commands/DescribeStudioCommand.d.ts +2 -2
- package/dist-types/commands/GetBlockPublicAccessConfigurationCommand.d.ts +3 -4
- package/dist-types/commands/GetStudioSessionMappingCommand.d.ts +2 -2
- package/dist-types/commands/ListClustersCommand.d.ts +5 -5
- package/dist-types/commands/ListInstanceFleetsCommand.d.ts +2 -2
- package/dist-types/commands/ListStepsCommand.d.ts +4 -1
- package/dist-types/commands/ListStudioSessionMappingsCommand.d.ts +2 -2
- package/dist-types/commands/ListStudiosCommand.d.ts +2 -2
- package/dist-types/commands/ModifyInstanceFleetCommand.d.ts +2 -2
- package/dist-types/commands/PutAutoScalingPolicyCommand.d.ts +3 -3
- package/dist-types/commands/PutAutoTerminationPolicyCommand.d.ts +7 -2
- package/dist-types/commands/PutBlockPublicAccessConfigurationCommand.d.ts +4 -4
- package/dist-types/commands/PutManagedScalingPolicyCommand.d.ts +4 -4
- package/dist-types/commands/RemoveTagsCommand.d.ts +4 -3
- package/dist-types/commands/RunJobFlowCommand.d.ts +4 -4
- package/dist-types/commands/SetTerminationProtectionCommand.d.ts +2 -2
- package/dist-types/commands/SetVisibleToAllUsersCommand.d.ts +11 -6
- package/dist-types/commands/TerminateJobFlowsCommand.d.ts +3 -3
- package/dist-types/commands/UpdateStudioCommand.d.ts +2 -1
- package/dist-types/commands/UpdateStudioSessionMappingCommand.d.ts +1 -2
- package/dist-types/models/models_0.d.ts +616 -435
- package/dist-types/ts3.4/models/models_0.d.ts +21 -0
- package/package.json +3 -3
|
@@ -63,7 +63,8 @@ export declare namespace EbsBlockDeviceConfig {
|
|
|
63
63
|
*/
|
|
64
64
|
export interface EbsConfiguration {
|
|
65
65
|
/**
|
|
66
|
-
* <p>An array of Amazon EBS volume specifications attached to a cluster
|
|
66
|
+
* <p>An array of Amazon EBS volume specifications attached to a cluster
|
|
67
|
+
* instance.</p>
|
|
67
68
|
*/
|
|
68
69
|
EbsBlockDeviceConfigs?: EbsBlockDeviceConfig[];
|
|
69
70
|
/**
|
|
@@ -88,25 +89,37 @@ export declare enum OnDemandCapacityReservationUsageStrategy {
|
|
|
88
89
|
USE_CAPACITY_RESERVATIONS_FIRST = "use-capacity-reservations-first"
|
|
89
90
|
}
|
|
90
91
|
/**
|
|
91
|
-
* <p>Describes the strategy for using unused Capacity Reservations for fulfilling On-Demand
|
|
92
|
+
* <p>Describes the strategy for using unused Capacity Reservations for fulfilling On-Demand
|
|
93
|
+
* capacity.</p>
|
|
92
94
|
*/
|
|
93
95
|
export interface OnDemandCapacityReservationOptions {
|
|
94
96
|
/**
|
|
95
|
-
* <p>Indicates whether to use unused Capacity Reservations for fulfilling On-Demand
|
|
96
|
-
*
|
|
97
|
-
* <p>If you
|
|
97
|
+
* <p>Indicates whether to use unused Capacity Reservations for fulfilling On-Demand
|
|
98
|
+
* capacity.</p>
|
|
99
|
+
* <p>If you specify <code>use-capacity-reservations-first</code>, the fleet uses unused
|
|
100
|
+
* Capacity Reservations to fulfill On-Demand capacity up to the target On-Demand capacity. If
|
|
101
|
+
* multiple instance pools have unused Capacity Reservations, the On-Demand allocation
|
|
102
|
+
* strategy (<code>lowest-price</code>) is applied. If the number of unused Capacity
|
|
103
|
+
* Reservations is less than the On-Demand target capacity, the remaining On-Demand target
|
|
104
|
+
* capacity is launched according to the On-Demand allocation strategy
|
|
105
|
+
* (<code>lowest-price</code>).</p>
|
|
106
|
+
* <p>If you do not specify a value, the fleet fulfills the On-Demand capacity according to
|
|
107
|
+
* the chosen On-Demand allocation strategy.</p>
|
|
98
108
|
*/
|
|
99
109
|
UsageStrategy?: OnDemandCapacityReservationUsageStrategy | string;
|
|
100
110
|
/**
|
|
101
|
-
* <p>Indicates the instance's Capacity Reservation preferences. Possible preferences
|
|
111
|
+
* <p>Indicates the instance's Capacity Reservation preferences. Possible preferences
|
|
112
|
+
* include:</p>
|
|
102
113
|
* <ul>
|
|
103
114
|
* <li>
|
|
104
115
|
* <p>
|
|
105
|
-
* <code>open</code> - The instance can run in any open Capacity Reservation that has
|
|
116
|
+
* <code>open</code> - The instance can run in any open Capacity Reservation that has
|
|
117
|
+
* matching attributes (instance type, platform, Availability Zone).</p>
|
|
106
118
|
* </li>
|
|
107
119
|
* <li>
|
|
108
120
|
* <p>
|
|
109
|
-
* <code>none</code> - The instance avoids running in a Capacity Reservation even if
|
|
121
|
+
* <code>none</code> - The instance avoids running in a Capacity Reservation even if
|
|
122
|
+
* one is available. The instance runs as an On-Demand Instance.</p>
|
|
110
123
|
* </li>
|
|
111
124
|
* </ul>
|
|
112
125
|
*/
|
|
@@ -126,18 +139,21 @@ export declare namespace OnDemandCapacityReservationOptions {
|
|
|
126
139
|
* <p> The launch specification for On-Demand Instances in the instance fleet, which
|
|
127
140
|
* determines the allocation strategy. </p>
|
|
128
141
|
* <note>
|
|
129
|
-
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
130
|
-
* later, excluding 5.0.x versions. On-Demand Instances allocation strategy is
|
|
131
|
-
* Amazon EMR version 5.12.1 and later.</p>
|
|
142
|
+
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
143
|
+
* 4.8.0 and later, excluding 5.0.x versions. On-Demand Instances allocation strategy is
|
|
144
|
+
* available in Amazon EMR version 5.12.1 and later.</p>
|
|
132
145
|
* </note>
|
|
133
146
|
*/
|
|
134
147
|
export interface OnDemandProvisioningSpecification {
|
|
135
148
|
/**
|
|
136
|
-
* <p>Specifies the strategy to use in launching On-Demand instance fleets. Currently, the
|
|
149
|
+
* <p>Specifies the strategy to use in launching On-Demand instance fleets. Currently, the
|
|
150
|
+
* only option is <code>lowest-price</code> (the default), which launches the lowest price
|
|
151
|
+
* first.</p>
|
|
137
152
|
*/
|
|
138
153
|
AllocationStrategy: OnDemandProvisioningAllocationStrategy | string | undefined;
|
|
139
154
|
/**
|
|
140
|
-
* <p>The launch specification for On-Demand instances in the instance fleet, which determines
|
|
155
|
+
* <p>The launch specification for On-Demand instances in the instance fleet, which determines
|
|
156
|
+
* the allocation strategy.</p>
|
|
141
157
|
*/
|
|
142
158
|
CapacityReservationOptions?: OnDemandCapacityReservationOptions;
|
|
143
159
|
}
|
|
@@ -155,13 +171,15 @@ export declare type SpotProvisioningTimeoutAction = "SWITCH_TO_ON_DEMAND" | "TER
|
|
|
155
171
|
* <p>The launch specification for Spot Instances in the instance fleet, which determines the
|
|
156
172
|
* defined duration, provisioning timeout behavior, and allocation strategy.</p>
|
|
157
173
|
* <note>
|
|
158
|
-
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
159
|
-
* later, excluding 5.0.x versions. Spot Instance allocation strategy is
|
|
160
|
-
* Amazon EMR version 5.12.1 and later.</p>
|
|
174
|
+
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
175
|
+
* 4.8.0 and later, excluding 5.0.x versions. Spot Instance allocation strategy is
|
|
176
|
+
* available in Amazon EMR version 5.12.1 and later.</p>
|
|
161
177
|
* </note>
|
|
162
178
|
* <note>
|
|
163
|
-
* <p>Spot Instances with a defined duration (also known as Spot blocks) are no longer
|
|
164
|
-
*
|
|
179
|
+
* <p>Spot Instances with a defined duration (also known as Spot blocks) are no longer
|
|
180
|
+
* available to new customers from July 1, 2021. For customers who have previously used the
|
|
181
|
+
* feature, we will continue to support Spot Instances with a defined duration until
|
|
182
|
+
* December 31, 2022. </p>
|
|
165
183
|
* </note>
|
|
166
184
|
*/
|
|
167
185
|
export interface SpotProvisioningSpecification {
|
|
@@ -186,12 +204,14 @@ export interface SpotProvisioningSpecification {
|
|
|
186
204
|
* specified, the Spot Instance does not terminate before the defined duration expires, and
|
|
187
205
|
* defined duration pricing for Spot Instances applies. Valid values are 60, 120, 180, 240,
|
|
188
206
|
* 300, or 360. The duration period starts as soon as a Spot Instance receives its instance
|
|
189
|
-
* ID. At the end of the duration, Amazon EC2 marks the Spot Instance for termination
|
|
190
|
-
* provides a Spot Instance termination notice, which gives the instance a two-minute
|
|
191
|
-
* before it terminates. </p>
|
|
207
|
+
* ID. At the end of the duration, Amazon EC2 marks the Spot Instance for termination
|
|
208
|
+
* and provides a Spot Instance termination notice, which gives the instance a two-minute
|
|
209
|
+
* warning before it terminates. </p>
|
|
192
210
|
* <note>
|
|
193
|
-
* <p>Spot Instances with a defined duration (also known as Spot blocks) are no longer
|
|
194
|
-
*
|
|
211
|
+
* <p>Spot Instances with a defined duration (also known as Spot blocks) are no longer
|
|
212
|
+
* available to new customers from July 1, 2021. For customers who have previously used the
|
|
213
|
+
* feature, we will continue to support Spot Instances with a defined duration until
|
|
214
|
+
* December 31, 2022. </p>
|
|
195
215
|
* </note>
|
|
196
216
|
*/
|
|
197
217
|
BlockDurationMinutes?: number;
|
|
@@ -212,9 +232,9 @@ export declare namespace SpotProvisioningSpecification {
|
|
|
212
232
|
* <p>The launch specification for Spot Instances in the fleet, which determines the defined
|
|
213
233
|
* duration, provisioning timeout behavior, and allocation strategy.</p>
|
|
214
234
|
* <note>
|
|
215
|
-
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
216
|
-
* later, excluding 5.0.x versions. On-Demand and Spot Instance allocation
|
|
217
|
-
* available in Amazon EMR version 5.12.1 and later.</p>
|
|
235
|
+
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
236
|
+
* 4.8.0 and later, excluding 5.0.x versions. On-Demand and Spot Instance allocation
|
|
237
|
+
* strategies are available in Amazon EMR version 5.12.1 and later.</p>
|
|
218
238
|
* </note>
|
|
219
239
|
*/
|
|
220
240
|
export interface InstanceFleetProvisioningSpecifications {
|
|
@@ -227,9 +247,9 @@ export interface InstanceFleetProvisioningSpecifications {
|
|
|
227
247
|
* <p> The launch specification for On-Demand Instances in the instance fleet, which
|
|
228
248
|
* determines the allocation strategy. </p>
|
|
229
249
|
* <note>
|
|
230
|
-
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
231
|
-
* later, excluding 5.0.x versions. On-Demand Instances allocation strategy is
|
|
232
|
-
* Amazon EMR version 5.12.1 and later.</p>
|
|
250
|
+
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
251
|
+
* 4.8.0 and later, excluding 5.0.x versions. On-Demand Instances allocation strategy is
|
|
252
|
+
* available in Amazon EMR version 5.12.1 and later.</p>
|
|
233
253
|
* </note>
|
|
234
254
|
*/
|
|
235
255
|
OnDemandSpecification?: OnDemandProvisioningSpecification;
|
|
@@ -401,10 +421,10 @@ export declare enum ComparisonOperator {
|
|
|
401
421
|
}
|
|
402
422
|
/**
|
|
403
423
|
* <p>A CloudWatch dimension, which is specified using a <code>Key</code> (known as a
|
|
404
|
-
* <code>Name</code> in CloudWatch), <code>Value</code> pair. By default, Amazon EMR uses
|
|
405
|
-
*
|
|
406
|
-
*
|
|
407
|
-
*
|
|
424
|
+
* <code>Name</code> in CloudWatch), <code>Value</code> pair. By default, Amazon EMR uses one dimension whose <code>Key</code> is <code>JobFlowID</code> and
|
|
425
|
+
* <code>Value</code> is a variable representing the cluster ID, which is
|
|
426
|
+
* <code>${emr.clusterId}</code>. This enables the rule to bootstrap when the cluster ID
|
|
427
|
+
* becomes available.</p>
|
|
408
428
|
*/
|
|
409
429
|
export interface MetricDimension {
|
|
410
430
|
/**
|
|
@@ -567,9 +587,9 @@ export declare namespace ScalingRule {
|
|
|
567
587
|
}
|
|
568
588
|
/**
|
|
569
589
|
* <p>An automatic scaling policy for a core instance group or task instance group in an
|
|
570
|
-
*
|
|
571
|
-
* adds and terminates EC2 instances in response to the value of a CloudWatch
|
|
572
|
-
*
|
|
590
|
+
* Amazon EMR cluster. An automatic scaling policy defines how an instance group
|
|
591
|
+
* dynamically adds and terminates EC2 instances in response to the value of a CloudWatch
|
|
592
|
+
* metric. See <a>PutAutoScalingPolicy</a>.</p>
|
|
573
593
|
*/
|
|
574
594
|
export interface AutoScalingPolicy {
|
|
575
595
|
/**
|
|
@@ -693,7 +713,8 @@ export interface StepConfig {
|
|
|
693
713
|
* </li>
|
|
694
714
|
* <li>
|
|
695
715
|
* <p>
|
|
696
|
-
* <code>CANCEL_AND_WAIT</code> - Cancels any pending steps and returns the cluster
|
|
716
|
+
* <code>CANCEL_AND_WAIT</code> - Cancels any pending steps and returns the cluster
|
|
717
|
+
* to the <code>WAITING</code> state.</p>
|
|
697
718
|
* </li>
|
|
698
719
|
* <li>
|
|
699
720
|
* <p>
|
|
@@ -701,11 +722,22 @@ export interface StepConfig {
|
|
|
701
722
|
* </li>
|
|
702
723
|
* <li>
|
|
703
724
|
* <p>
|
|
704
|
-
* <code>TERMINATE_JOB_FLOW</code> - Shuts down the cluster.
|
|
725
|
+
* <code>TERMINATE_JOB_FLOW</code> - Shuts down the cluster.
|
|
726
|
+
* <code>TERMINATE_JOB_FLOW</code> is provided for backward compatibility. We
|
|
727
|
+
* recommend using <code>TERMINATE_CLUSTER</code> instead.</p>
|
|
705
728
|
* </li>
|
|
706
729
|
* </ul>
|
|
707
|
-
* <p>If a cluster's <code>StepConcurrencyLevel</code> is greater than <code>1</code>, do not
|
|
708
|
-
*
|
|
730
|
+
* <p>If a cluster's <code>StepConcurrencyLevel</code> is greater than <code>1</code>, do not
|
|
731
|
+
* use <code>AddJobFlowSteps</code> to submit a step with this parameter set to
|
|
732
|
+
* <code>CANCEL_AND_WAIT</code> or <code>TERMINATE_CLUSTER</code>. The step is not
|
|
733
|
+
* submitted and the action fails with a message that the <code>ActionOnFailure</code> setting
|
|
734
|
+
* is not valid.</p>
|
|
735
|
+
* <p>If you change a cluster's <code>StepConcurrencyLevel</code> to be greater than 1 while a
|
|
736
|
+
* step is running, the <code>ActionOnFailure</code> parameter may not behave as you expect.
|
|
737
|
+
* In this case, for a step that fails with this parameter set to
|
|
738
|
+
* <code>CANCEL_AND_WAIT</code>, pending steps and the running step are not canceled; for a
|
|
739
|
+
* step that fails with this parameter set to <code>TERMINATE_CLUSTER</code>, the cluster does
|
|
740
|
+
* not terminate.</p>
|
|
709
741
|
*/
|
|
710
742
|
ActionOnFailure?: ActionOnFailure | string;
|
|
711
743
|
/**
|
|
@@ -755,10 +787,9 @@ export declare namespace AddJobFlowStepsOutput {
|
|
|
755
787
|
const filterSensitiveLog: (obj: AddJobFlowStepsOutput) => any;
|
|
756
788
|
}
|
|
757
789
|
/**
|
|
758
|
-
* <p>A key-value pair containing user-defined metadata that you can associate with an Amazon EMR resource. Tags make it easier to associate clusters in various ways, such as
|
|
759
|
-
* clusters to track your Amazon EMR resource allocation costs. For more
|
|
760
|
-
*
|
|
761
|
-
* Clusters</a>. </p>
|
|
790
|
+
* <p>A key-value pair containing user-defined metadata that you can associate with an Amazon EMR resource. Tags make it easier to associate clusters in various ways, such as
|
|
791
|
+
* grouping clusters to track your Amazon EMR resource allocation costs. For more
|
|
792
|
+
* information, see <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-tags.html">Tag Clusters</a>. </p>
|
|
762
793
|
*/
|
|
763
794
|
export interface Tag {
|
|
764
795
|
/**
|
|
@@ -779,7 +810,8 @@ export declare namespace Tag {
|
|
|
779
810
|
const filterSensitiveLog: (obj: Tag) => any;
|
|
780
811
|
}
|
|
781
812
|
/**
|
|
782
|
-
* <p>This input identifies an Amazon EMR resource and a list of tags to
|
|
813
|
+
* <p>This input identifies an Amazon EMR resource and a list of tags to
|
|
814
|
+
* attach.</p>
|
|
783
815
|
*/
|
|
784
816
|
export interface AddTagsInput {
|
|
785
817
|
/**
|
|
@@ -788,9 +820,9 @@ export interface AddTagsInput {
|
|
|
788
820
|
*/
|
|
789
821
|
ResourceId: string | undefined;
|
|
790
822
|
/**
|
|
791
|
-
* <p>A list of tags to associate with a resource. Tags are
|
|
792
|
-
*
|
|
793
|
-
*
|
|
823
|
+
* <p>A list of tags to associate with a resource. Tags are user-defined key-value pairs that
|
|
824
|
+
* consist of a required key string with a maximum of 128 characters, and an optional value
|
|
825
|
+
* string with a maximum of 256 characters.</p>
|
|
794
826
|
*/
|
|
795
827
|
Tags: Tag[] | undefined;
|
|
796
828
|
}
|
|
@@ -812,15 +844,14 @@ export declare namespace AddTagsOutput {
|
|
|
812
844
|
const filterSensitiveLog: (obj: AddTagsOutput) => any;
|
|
813
845
|
}
|
|
814
846
|
/**
|
|
815
|
-
* <p>With Amazon EMR release version 4.0 and later, the only accepted parameter is
|
|
816
|
-
* application name. To pass arguments to applications, you use configuration
|
|
817
|
-
* specified using configuration JSON objects. For more information, see
|
|
818
|
-
* Applications</a>.</p>
|
|
819
|
-
* <p>With earlier Amazon EMR releases, the application is any Amazon or third-party
|
|
820
|
-
* that you can add to the cluster. This structure contains a list of strings that
|
|
821
|
-
* the software to use with the cluster and accepts a user argument list. Amazon EMR accepts
|
|
822
|
-
*
|
|
823
|
-
* argument.</p>
|
|
847
|
+
* <p>With Amazon EMR release version 4.0 and later, the only accepted parameter is
|
|
848
|
+
* the application name. To pass arguments to applications, you use configuration
|
|
849
|
+
* classifications specified using configuration JSON objects. For more information, see
|
|
850
|
+
* <a href="https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-configure-apps.html">Configuring Applications</a>.</p>
|
|
851
|
+
* <p>With earlier Amazon EMR releases, the application is any Amazon or third-party
|
|
852
|
+
* software that you can add to the cluster. This structure contains a list of strings that
|
|
853
|
+
* indicates the software to use with the cluster and accepts a user argument list. Amazon EMR accepts and forwards the argument list to the corresponding installation
|
|
854
|
+
* script as bootstrap action argument.</p>
|
|
824
855
|
*/
|
|
825
856
|
export interface Application {
|
|
826
857
|
/**
|
|
@@ -911,9 +942,9 @@ export declare namespace AutoScalingPolicyStatus {
|
|
|
911
942
|
}
|
|
912
943
|
/**
|
|
913
944
|
* <p>An automatic scaling policy for a core instance group or task instance group in an
|
|
914
|
-
*
|
|
915
|
-
* adds and terminates EC2 instances in response to the value of a CloudWatch
|
|
916
|
-
*
|
|
945
|
+
* Amazon EMR cluster. The automatic scaling policy defines how an instance group
|
|
946
|
+
* dynamically adds and terminates EC2 instances in response to the value of a CloudWatch
|
|
947
|
+
* metric. See <a>PutAutoScalingPolicy</a>.</p>
|
|
917
948
|
*/
|
|
918
949
|
export interface AutoScalingPolicyDescription {
|
|
919
950
|
/**
|
|
@@ -938,11 +969,16 @@ export declare namespace AutoScalingPolicyDescription {
|
|
|
938
969
|
const filterSensitiveLog: (obj: AutoScalingPolicyDescription) => any;
|
|
939
970
|
}
|
|
940
971
|
/**
|
|
941
|
-
* <p>An auto-termination policy for an Amazon EMR cluster. An auto-termination policy
|
|
972
|
+
* <p>An auto-termination policy for an Amazon EMR cluster. An auto-termination policy
|
|
973
|
+
* defines the amount of idle time in seconds after which a cluster automatically terminates.
|
|
974
|
+
* For alternative cluster termination options, see <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-termination.html">Control cluster
|
|
975
|
+
* termination</a>.</p>
|
|
942
976
|
*/
|
|
943
977
|
export interface AutoTerminationPolicy {
|
|
944
978
|
/**
|
|
945
|
-
* <p>Specifies the amount of idle time in seconds after which the cluster automatically
|
|
979
|
+
* <p>Specifies the amount of idle time in seconds after which the cluster automatically
|
|
980
|
+
* terminates. You can specify a minimum of 60 seconds and a maximum of 604800 seconds (seven
|
|
981
|
+
* days).</p>
|
|
946
982
|
*/
|
|
947
983
|
IdleTimeout?: number;
|
|
948
984
|
}
|
|
@@ -1080,8 +1116,7 @@ export declare enum CancelStepsRequestStatus {
|
|
|
1080
1116
|
SUBMITTED = "SUBMITTED"
|
|
1081
1117
|
}
|
|
1082
1118
|
/**
|
|
1083
|
-
* <p>Specification of the status of a CancelSteps request. Available only in Amazon EMR
|
|
1084
|
-
* version 4.8.0 and later, excluding version 5.0.0.</p>
|
|
1119
|
+
* <p>Specification of the status of a CancelSteps request. Available only in Amazon EMR version 4.8.0 and later, excluding version 5.0.0.</p>
|
|
1085
1120
|
*/
|
|
1086
1121
|
export interface CancelStepsInfo {
|
|
1087
1122
|
/**
|
|
@@ -1125,27 +1160,27 @@ export declare namespace CancelStepsOutput {
|
|
|
1125
1160
|
*/
|
|
1126
1161
|
export interface Ec2InstanceAttributes {
|
|
1127
1162
|
/**
|
|
1128
|
-
* <p>The name of the Amazon EC2 key pair to use when connecting with SSH into the
|
|
1129
|
-
* as a user named "hadoop".</p>
|
|
1163
|
+
* <p>The name of the Amazon EC2 key pair to use when connecting with SSH into the
|
|
1164
|
+
* master node as a user named "hadoop".</p>
|
|
1130
1165
|
*/
|
|
1131
1166
|
Ec2KeyName?: string;
|
|
1132
1167
|
/**
|
|
1133
|
-
* <p>Set this parameter to the identifier of the Amazon VPC subnet where you want the
|
|
1134
|
-
* to launch. If you do not specify this value, and your account supports EC2-Classic,
|
|
1135
|
-
* cluster launches in EC2-Classic.</p>
|
|
1168
|
+
* <p>Set this parameter to the identifier of the Amazon VPC subnet where you want the
|
|
1169
|
+
* cluster to launch. If you do not specify this value, and your account supports EC2-Classic,
|
|
1170
|
+
* the cluster launches in EC2-Classic.</p>
|
|
1136
1171
|
*/
|
|
1137
1172
|
Ec2SubnetId?: string;
|
|
1138
1173
|
/**
|
|
1139
1174
|
* <p>Applies to clusters configured with the instance fleets option. Specifies the unique
|
|
1140
|
-
* identifier of one or more Amazon EC2 subnets in which to launch EC2 cluster
|
|
1141
|
-
* Subnets must exist within the same VPC. Amazon EMR chooses the EC2
|
|
1142
|
-
* from among the list of <code>RequestedEc2SubnetIds</code>, and
|
|
1143
|
-
* instances within that Subnet. If this value is not specified, and
|
|
1144
|
-
* support EC2-Classic networks, the cluster launches instances in the
|
|
1145
|
-
* uses <code>RequestedEc2AvailabilityZones</code> instead of this
|
|
1146
|
-
* not supported, and no Subnet is specified, Amazon EMR
|
|
1147
|
-
*
|
|
1148
|
-
*
|
|
1175
|
+
* identifier of one or more Amazon EC2 subnets in which to launch EC2 cluster
|
|
1176
|
+
* instances. Subnets must exist within the same VPC. Amazon EMR chooses the EC2
|
|
1177
|
+
* subnet with the best fit from among the list of <code>RequestedEc2SubnetIds</code>, and
|
|
1178
|
+
* then launches all cluster instances within that Subnet. If this value is not specified, and
|
|
1179
|
+
* the account and Region support EC2-Classic networks, the cluster launches instances in the
|
|
1180
|
+
* EC2-Classic network and uses <code>RequestedEc2AvailabilityZones</code> instead of this
|
|
1181
|
+
* setting. If EC2-Classic is not supported, and no Subnet is specified, Amazon EMR
|
|
1182
|
+
* chooses the subnet for you. <code>RequestedEc2SubnetIDs</code> and
|
|
1183
|
+
* <code>RequestedEc2AvailabilityZones</code> cannot be specified together.</p>
|
|
1149
1184
|
*/
|
|
1150
1185
|
RequestedEc2SubnetIds?: string[];
|
|
1151
1186
|
/**
|
|
@@ -1155,11 +1190,12 @@ export interface Ec2InstanceAttributes {
|
|
|
1155
1190
|
/**
|
|
1156
1191
|
* <p>Applies to clusters configured with the instance fleets option. Specifies one or more
|
|
1157
1192
|
* Availability Zones in which to launch EC2 cluster instances when the EC2-Classic network
|
|
1158
|
-
* configuration is supported. Amazon EMR chooses the Availability Zone with the best
|
|
1159
|
-
* among the list of <code>RequestedEc2AvailabilityZones</code>, and then launches
|
|
1160
|
-
* instances within that Availability Zone. If you do not specify this value,
|
|
1161
|
-
*
|
|
1162
|
-
* <code>RequestedEc2AvailabilityZones</code> cannot
|
|
1193
|
+
* configuration is supported. Amazon EMR chooses the Availability Zone with the best
|
|
1194
|
+
* fit from among the list of <code>RequestedEc2AvailabilityZones</code>, and then launches
|
|
1195
|
+
* all cluster instances within that Availability Zone. If you do not specify this value,
|
|
1196
|
+
* Amazon EMR chooses the Availability Zone for you.
|
|
1197
|
+
* <code>RequestedEc2SubnetIDs</code> and <code>RequestedEc2AvailabilityZones</code> cannot
|
|
1198
|
+
* be specified together.</p>
|
|
1163
1199
|
*/
|
|
1164
1200
|
RequestedEc2AvailabilityZones?: string[];
|
|
1165
1201
|
/**
|
|
@@ -1172,12 +1208,13 @@ export interface Ec2InstanceAttributes {
|
|
|
1172
1208
|
*/
|
|
1173
1209
|
EmrManagedMasterSecurityGroup?: string;
|
|
1174
1210
|
/**
|
|
1175
|
-
* <p>The identifier of the Amazon EC2 security group for the core and task
|
|
1211
|
+
* <p>The identifier of the Amazon EC2 security group for the core and task
|
|
1212
|
+
* nodes.</p>
|
|
1176
1213
|
*/
|
|
1177
1214
|
EmrManagedSlaveSecurityGroup?: string;
|
|
1178
1215
|
/**
|
|
1179
|
-
* <p>The identifier of the Amazon EC2 security group for the Amazon EMR
|
|
1180
|
-
* clusters in VPC private subnets.</p>
|
|
1216
|
+
* <p>The identifier of the Amazon EC2 security group for the Amazon EMR
|
|
1217
|
+
* service to access clusters in VPC private subnets.</p>
|
|
1181
1218
|
*/
|
|
1182
1219
|
ServiceAccessSecurityGroup?: string;
|
|
1183
1220
|
/**
|
|
@@ -1185,7 +1222,8 @@ export interface Ec2InstanceAttributes {
|
|
|
1185
1222
|
*/
|
|
1186
1223
|
AdditionalMasterSecurityGroups?: string[];
|
|
1187
1224
|
/**
|
|
1188
|
-
* <p>A list of additional Amazon EC2 security group IDs for the core and task
|
|
1225
|
+
* <p>A list of additional Amazon EC2 security group IDs for the core and task
|
|
1226
|
+
* nodes.</p>
|
|
1189
1227
|
*/
|
|
1190
1228
|
AdditionalSlaveSecurityGroups?: string[];
|
|
1191
1229
|
}
|
|
@@ -1244,8 +1282,9 @@ export declare enum PlacementGroupStrategy {
|
|
|
1244
1282
|
SPREAD = "SPREAD"
|
|
1245
1283
|
}
|
|
1246
1284
|
/**
|
|
1247
|
-
* <p>Placement group configuration for an Amazon EMR cluster. The configuration
|
|
1248
|
-
* placement strategy that can be applied to instance roles during cluster
|
|
1285
|
+
* <p>Placement group configuration for an Amazon EMR cluster. The configuration
|
|
1286
|
+
* specifies the placement strategy that can be applied to instance roles during cluster
|
|
1287
|
+
* creation.</p>
|
|
1249
1288
|
* <p>To use this configuration, consider attaching managed policy
|
|
1250
1289
|
* AmazonElasticMapReducePlacementGroupPolicy to the EMR role.</p>
|
|
1251
1290
|
*/
|
|
@@ -1258,8 +1297,8 @@ export interface PlacementGroupConfig {
|
|
|
1258
1297
|
InstanceRole: InstanceRoleType | string | undefined;
|
|
1259
1298
|
/**
|
|
1260
1299
|
* <p>EC2 Placement Group strategy associated with instance role.</p>
|
|
1261
|
-
* <p>Starting with Amazon EMR version 5.23.0, the only supported placement strategy
|
|
1262
|
-
*
|
|
1300
|
+
* <p>Starting with Amazon EMR version 5.23.0, the only supported placement strategy
|
|
1301
|
+
* is <code>SPREAD</code> for the <code>MASTER</code> instance role.</p>
|
|
1263
1302
|
*/
|
|
1264
1303
|
PlacementStrategy?: PlacementGroupStrategy | string;
|
|
1265
1304
|
}
|
|
@@ -1482,8 +1521,8 @@ export interface CreateSecurityConfigurationInput {
|
|
|
1482
1521
|
/**
|
|
1483
1522
|
* <p>The security configuration details in JSON format. For JSON parameters and examples, see
|
|
1484
1523
|
* <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-security-configurations.html">Use Security
|
|
1485
|
-
* Configurations to Set Up Cluster Security</a> in the <i>Amazon EMR
|
|
1486
|
-
* Guide</i>.</p>
|
|
1524
|
+
* Configurations to Set Up Cluster Security</a> in the <i>Amazon EMR
|
|
1525
|
+
* Management Guide</i>.</p>
|
|
1487
1526
|
*/
|
|
1488
1527
|
SecurityConfiguration: string | undefined;
|
|
1489
1528
|
}
|
|
@@ -1528,50 +1567,60 @@ export interface CreateStudioInput {
|
|
|
1528
1567
|
*/
|
|
1529
1568
|
VpcId: string | undefined;
|
|
1530
1569
|
/**
|
|
1531
|
-
* <p>A list of subnet IDs to associate with the Amazon EMR Studio. A Studio can have
|
|
1532
|
-
*
|
|
1533
|
-
* specified subnets.</p>
|
|
1570
|
+
* <p>A list of subnet IDs to associate with the Amazon EMR Studio. A Studio can have
|
|
1571
|
+
* a maximum of 5 subnets. The subnets must belong to the VPC specified by <code>VpcId</code>.
|
|
1572
|
+
* Studio users can create a Workspace in any of the specified subnets.</p>
|
|
1534
1573
|
*/
|
|
1535
1574
|
SubnetIds: string[] | undefined;
|
|
1536
1575
|
/**
|
|
1537
|
-
* <p>The IAM role that the Amazon EMR Studio assumes. The service role provides a
|
|
1538
|
-
*
|
|
1576
|
+
* <p>The IAM role that the Amazon EMR Studio assumes. The service role provides a way
|
|
1577
|
+
* for Amazon EMR Studio to interoperate with other Amazon Web Services
|
|
1578
|
+
* services.</p>
|
|
1539
1579
|
*/
|
|
1540
1580
|
ServiceRole: string | undefined;
|
|
1541
1581
|
/**
|
|
1542
|
-
* <p>The IAM user role that users and groups assume when logged in to an Amazon EMR
|
|
1543
|
-
*
|
|
1544
|
-
*
|
|
1582
|
+
* <p>The IAM user role that users and groups assume when logged in to an Amazon EMR
|
|
1583
|
+
* Studio. Only specify a <code>UserRole</code> when you use Amazon Web Services SSO
|
|
1584
|
+
* authentication. The permissions attached to the <code>UserRole</code> can be scoped down
|
|
1585
|
+
* for each user or group using session policies.</p>
|
|
1545
1586
|
*/
|
|
1546
1587
|
UserRole?: string;
|
|
1547
1588
|
/**
|
|
1548
|
-
* <p>The ID of the Amazon EMR Studio Workspace security group. The Workspace security
|
|
1549
|
-
* allows outbound network traffic to resources in the Engine security group, and it
|
|
1550
|
-
* in the same VPC specified by <code>VpcId</code>.</p>
|
|
1589
|
+
* <p>The ID of the Amazon EMR Studio Workspace security group. The Workspace security
|
|
1590
|
+
* group allows outbound network traffic to resources in the Engine security group, and it
|
|
1591
|
+
* must be in the same VPC specified by <code>VpcId</code>.</p>
|
|
1551
1592
|
*/
|
|
1552
1593
|
WorkspaceSecurityGroupId: string | undefined;
|
|
1553
1594
|
/**
|
|
1554
|
-
* <p>The ID of the Amazon EMR Studio Engine security group. The Engine security group
|
|
1555
|
-
* inbound network traffic from the Workspace security group, and it must be in the
|
|
1556
|
-
* specified by <code>VpcId</code>.</p>
|
|
1595
|
+
* <p>The ID of the Amazon EMR Studio Engine security group. The Engine security group
|
|
1596
|
+
* allows inbound network traffic from the Workspace security group, and it must be in the
|
|
1597
|
+
* same VPC specified by <code>VpcId</code>.</p>
|
|
1557
1598
|
*/
|
|
1558
1599
|
EngineSecurityGroupId: string | undefined;
|
|
1559
1600
|
/**
|
|
1560
|
-
* <p>The Amazon S3 location to back up Amazon EMR Studio Workspaces and
|
|
1601
|
+
* <p>The Amazon S3 location to back up Amazon EMR Studio Workspaces and
|
|
1602
|
+
* notebook files.</p>
|
|
1561
1603
|
*/
|
|
1562
1604
|
DefaultS3Location: string | undefined;
|
|
1563
1605
|
/**
|
|
1564
|
-
* <p>The authentication endpoint of your identity provider (IdP). Specify this value when you
|
|
1606
|
+
* <p>The authentication endpoint of your identity provider (IdP). Specify this value when you
|
|
1607
|
+
* use IAM authentication and want to let federated users log in to a Studio
|
|
1608
|
+
* with the Studio URL and credentials from your IdP. Amazon EMR Studio redirects
|
|
1609
|
+
* users to this endpoint to enter credentials.</p>
|
|
1565
1610
|
*/
|
|
1566
1611
|
IdpAuthUrl?: string;
|
|
1567
1612
|
/**
|
|
1568
|
-
* <p>The name that your identity provider (IdP) uses for its <code>RelayState</code>
|
|
1613
|
+
* <p>The name that your identity provider (IdP) uses for its <code>RelayState</code>
|
|
1614
|
+
* parameter. For example, <code>RelayState</code> or <code>TargetSource</code>. Specify this
|
|
1615
|
+
* value when you use IAM authentication and want to let federated users log in
|
|
1616
|
+
* to a Studio using the Studio URL. The <code>RelayState</code> parameter differs by
|
|
1617
|
+
* IdP.</p>
|
|
1569
1618
|
*/
|
|
1570
1619
|
IdpRelayStateParameterName?: string;
|
|
1571
1620
|
/**
|
|
1572
|
-
* <p>A list of tags to associate with the Amazon EMR Studio. Tags are user-defined
|
|
1573
|
-
* consist of a required key string with a maximum of 128 characters, and
|
|
1574
|
-
* string with a maximum of 256 characters.</p>
|
|
1621
|
+
* <p>A list of tags to associate with the Amazon EMR Studio. Tags are user-defined
|
|
1622
|
+
* key-value pairs that consist of a required key string with a maximum of 128 characters, and
|
|
1623
|
+
* an optional value string with a maximum of 256 characters.</p>
|
|
1575
1624
|
*/
|
|
1576
1625
|
Tags?: Tag[];
|
|
1577
1626
|
}
|
|
@@ -1603,27 +1652,33 @@ export declare enum IdentityType {
|
|
|
1603
1652
|
}
|
|
1604
1653
|
export interface CreateStudioSessionMappingInput {
|
|
1605
1654
|
/**
|
|
1606
|
-
* <p>The ID of the Amazon EMR Studio to which the user or group will be
|
|
1655
|
+
* <p>The ID of the Amazon EMR Studio to which the user or group will be
|
|
1656
|
+
* mapped.</p>
|
|
1607
1657
|
*/
|
|
1608
1658
|
StudioId: string | undefined;
|
|
1609
1659
|
/**
|
|
1610
|
-
* <p>The globally unique identifier (GUID) of the user or group from the Amazon Web Services SSO
|
|
1611
|
-
* Store. For more information, see <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId">UserId</a> and <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId">GroupId</a> in the <i>Amazon Web Services SSO Identity Store API
|
|
1612
|
-
*
|
|
1660
|
+
* <p>The globally unique identifier (GUID) of the user or group from the Amazon Web Services SSO
|
|
1661
|
+
* Identity Store. For more information, see <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId">UserId</a> and <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId">GroupId</a> in the <i>Amazon Web Services SSO Identity Store API
|
|
1662
|
+
* Reference</i>. Either <code>IdentityName</code> or <code>IdentityId</code> must
|
|
1663
|
+
* be specified, but not both.</p>
|
|
1613
1664
|
*/
|
|
1614
1665
|
IdentityId?: string;
|
|
1615
1666
|
/**
|
|
1616
|
-
* <p>The name of the user or group. For more information, see <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName">UserName</a> and <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName">DisplayName</a> in the <i>Amazon Web Services SSO Identity Store API
|
|
1617
|
-
*
|
|
1667
|
+
* <p>The name of the user or group. For more information, see <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName">UserName</a> and <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName">DisplayName</a> in the <i>Amazon Web Services SSO Identity Store API
|
|
1668
|
+
* Reference</i>. Either <code>IdentityName</code> or <code>IdentityId</code> must
|
|
1669
|
+
* be specified, but not both.</p>
|
|
1618
1670
|
*/
|
|
1619
1671
|
IdentityName?: string;
|
|
1620
1672
|
/**
|
|
1621
|
-
* <p>Specifies whether the identity to map to the Amazon EMR Studio is a user or a
|
|
1673
|
+
* <p>Specifies whether the identity to map to the Amazon EMR Studio is a user or a
|
|
1674
|
+
* group.</p>
|
|
1622
1675
|
*/
|
|
1623
1676
|
IdentityType: IdentityType | string | undefined;
|
|
1624
1677
|
/**
|
|
1625
1678
|
* <p>The Amazon Resource Name (ARN) for the session policy that will be applied to the user
|
|
1626
|
-
* or group. You should specify the ARN for the session policy that you want to apply, not the
|
|
1679
|
+
* or group. You should specify the ARN for the session policy that you want to apply, not the
|
|
1680
|
+
* ARN of your user role. For more information, see <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-studio-user-role.html">Create an EMR Studio User
|
|
1681
|
+
* Role with Session Policies</a>.</p>
|
|
1627
1682
|
*/
|
|
1628
1683
|
SessionPolicyArn: string | undefined;
|
|
1629
1684
|
}
|
|
@@ -1671,19 +1726,20 @@ export interface DeleteStudioSessionMappingInput {
|
|
|
1671
1726
|
*/
|
|
1672
1727
|
StudioId: string | undefined;
|
|
1673
1728
|
/**
|
|
1674
|
-
* <p>The globally unique identifier (GUID) of the user or group to remove from the Amazon EMR
|
|
1675
|
-
*
|
|
1676
|
-
*
|
|
1729
|
+
* <p>The globally unique identifier (GUID) of the user or group to remove from the Amazon EMR Studio. For more information, see <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId">UserId</a> and <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId">GroupId</a> in the <i>Amazon Web Services SSO Identity Store API
|
|
1730
|
+
* Reference</i>. Either <code>IdentityName</code> or <code>IdentityId</code> must
|
|
1731
|
+
* be specified.</p>
|
|
1677
1732
|
*/
|
|
1678
1733
|
IdentityId?: string;
|
|
1679
1734
|
/**
|
|
1680
|
-
* <p>The name of the user name or group to remove from the Amazon EMR Studio. For
|
|
1681
|
-
*
|
|
1735
|
+
* <p>The name of the user name or group to remove from the Amazon EMR Studio. For
|
|
1736
|
+
* more information, see <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName">UserName</a> and <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName">DisplayName</a> in the <i>Amazon Web Services SSO Store API Reference</i>.
|
|
1682
1737
|
* Either <code>IdentityName</code> or <code>IdentityId</code> must be specified.</p>
|
|
1683
1738
|
*/
|
|
1684
1739
|
IdentityName?: string;
|
|
1685
1740
|
/**
|
|
1686
|
-
* <p>Specifies whether the identity to delete from the Amazon EMR Studio is a user or
|
|
1741
|
+
* <p>Specifies whether the identity to delete from the Amazon EMR Studio is a user or
|
|
1742
|
+
* a group.</p>
|
|
1687
1743
|
*/
|
|
1688
1744
|
IdentityType: IdentityType | string | undefined;
|
|
1689
1745
|
}
|
|
@@ -1814,7 +1870,9 @@ export interface InstanceGroupDetail {
|
|
|
1814
1870
|
*/
|
|
1815
1871
|
InstanceRole: InstanceRoleType | string | undefined;
|
|
1816
1872
|
/**
|
|
1817
|
-
* <p>If specified, indicates that the instance group uses Spot Instances. This is the maximum
|
|
1873
|
+
* <p>If specified, indicates that the instance group uses Spot Instances. This is the maximum
|
|
1874
|
+
* price you are willing to pay for Spot Instances. Specify <code>OnDemandPrice</code> to set
|
|
1875
|
+
* the amount equal to the On-Demand price, or specify an amount in USD.</p>
|
|
1818
1876
|
*/
|
|
1819
1877
|
BidPrice?: string;
|
|
1820
1878
|
/**
|
|
@@ -1830,8 +1888,8 @@ export interface InstanceGroupDetail {
|
|
|
1830
1888
|
*/
|
|
1831
1889
|
InstanceRunningCount: number | undefined;
|
|
1832
1890
|
/**
|
|
1833
|
-
* <p>State of instance group. The following values are no longer supported: STARTING,
|
|
1834
|
-
* FAILED.</p>
|
|
1891
|
+
* <p>State of instance group. The following values are no longer supported: STARTING,
|
|
1892
|
+
* TERMINATED, and FAILED.</p>
|
|
1835
1893
|
*/
|
|
1836
1894
|
State: InstanceGroupState | string | undefined;
|
|
1837
1895
|
/**
|
|
@@ -1870,19 +1928,19 @@ export declare namespace InstanceGroupDetail {
|
|
|
1870
1928
|
*/
|
|
1871
1929
|
export interface PlacementType {
|
|
1872
1930
|
/**
|
|
1873
|
-
* <p>The Amazon EC2 Availability Zone for the cluster. <code>AvailabilityZone</code>
|
|
1874
|
-
* for uniform instance groups, while <code>AvailabilityZones</code> (plural) is used
|
|
1875
|
-
* instance fleets.</p>
|
|
1931
|
+
* <p>The Amazon EC2 Availability Zone for the cluster. <code>AvailabilityZone</code>
|
|
1932
|
+
* is used for uniform instance groups, while <code>AvailabilityZones</code> (plural) is used
|
|
1933
|
+
* for instance fleets.</p>
|
|
1876
1934
|
*/
|
|
1877
1935
|
AvailabilityZone?: string;
|
|
1878
1936
|
/**
|
|
1879
|
-
* <p>When multiple Availability Zones are specified, Amazon EMR evaluates them and
|
|
1880
|
-
* instances in the optimal Availability Zone. <code>AvailabilityZones</code> is used
|
|
1881
|
-
* instance fleets, while <code>AvailabilityZone</code> (singular) is used for uniform
|
|
1937
|
+
* <p>When multiple Availability Zones are specified, Amazon EMR evaluates them and
|
|
1938
|
+
* launches instances in the optimal Availability Zone. <code>AvailabilityZones</code> is used
|
|
1939
|
+
* for instance fleets, while <code>AvailabilityZone</code> (singular) is used for uniform
|
|
1882
1940
|
* instance groups.</p>
|
|
1883
1941
|
* <note>
|
|
1884
|
-
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
1885
|
-
* later, excluding 5.0.x versions.</p>
|
|
1942
|
+
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
1943
|
+
* 4.8.0 and later, excluding 5.0.x versions.</p>
|
|
1886
1944
|
* </note>
|
|
1887
1945
|
*/
|
|
1888
1946
|
AvailabilityZones?: string[];
|
|
@@ -1894,7 +1952,8 @@ export declare namespace PlacementType {
|
|
|
1894
1952
|
const filterSensitiveLog: (obj: PlacementType) => any;
|
|
1895
1953
|
}
|
|
1896
1954
|
/**
|
|
1897
|
-
* <p>Specify the type of Amazon EC2 instances that the cluster (job flow) runs
|
|
1955
|
+
* <p>Specify the type of Amazon EC2 instances that the cluster (job flow) runs
|
|
1956
|
+
* on.</p>
|
|
1898
1957
|
*/
|
|
1899
1958
|
export interface JobFlowInstancesDetail {
|
|
1900
1959
|
/**
|
|
@@ -1915,9 +1974,9 @@ export interface JobFlowInstancesDetail {
|
|
|
1915
1974
|
*/
|
|
1916
1975
|
SlaveInstanceType: string | undefined;
|
|
1917
1976
|
/**
|
|
1918
|
-
* <p>The number of Amazon EC2 instances in the cluster. If the value is 1, the same
|
|
1919
|
-
* serves as both the master and core and task node. If the value is greater than 1,
|
|
1920
|
-
* instance is the master node and all others are core and task nodes.</p>
|
|
1977
|
+
* <p>The number of Amazon EC2 instances in the cluster. If the value is 1, the same
|
|
1978
|
+
* instance serves as both the master and core and task node. If the value is greater than 1,
|
|
1979
|
+
* one instance is the master node and all others are core and task nodes.</p>
|
|
1921
1980
|
*/
|
|
1922
1981
|
InstanceCount: number | undefined;
|
|
1923
1982
|
/**
|
|
@@ -1927,14 +1986,15 @@ export interface JobFlowInstancesDetail {
|
|
|
1927
1986
|
/**
|
|
1928
1987
|
* <p>An approximation of the cost of the cluster, represented in m1.small/hours. This value
|
|
1929
1988
|
* is increased one time for every hour that an m1.small instance runs. Larger instances are
|
|
1930
|
-
* weighted more heavily, so an Amazon EC2 instance that is roughly four times more
|
|
1931
|
-
* would result in the normalized instance hours being increased incrementally four
|
|
1932
|
-
* This result is only an approximation and does not reflect the actual billing
|
|
1989
|
+
* weighted more heavily, so an Amazon EC2 instance that is roughly four times more
|
|
1990
|
+
* expensive would result in the normalized instance hours being increased incrementally four
|
|
1991
|
+
* times. This result is only an approximation and does not reflect the actual billing
|
|
1992
|
+
* rate.</p>
|
|
1933
1993
|
*/
|
|
1934
1994
|
NormalizedInstanceHours?: number;
|
|
1935
1995
|
/**
|
|
1936
|
-
* <p>The name of an Amazon EC2 key pair that can be used to connect to the master
|
|
1937
|
-
* SSH.</p>
|
|
1996
|
+
* <p>The name of an Amazon EC2 key pair that can be used to connect to the master
|
|
1997
|
+
* node using SSH.</p>
|
|
1938
1998
|
*/
|
|
1939
1999
|
Ec2KeyName?: string;
|
|
1940
2000
|
/**
|
|
@@ -1951,8 +2011,8 @@ export interface JobFlowInstancesDetail {
|
|
|
1951
2011
|
*/
|
|
1952
2012
|
KeepJobFlowAliveWhenNoSteps?: boolean;
|
|
1953
2013
|
/**
|
|
1954
|
-
* <p>Specifies whether the Amazon EC2 instances in the cluster are protected from
|
|
1955
|
-
* by API calls, user intervention, or in the event of a job-flow error.</p>
|
|
2014
|
+
* <p>Specifies whether the Amazon EC2 instances in the cluster are protected from
|
|
2015
|
+
* termination by API calls, user intervention, or in the event of a job-flow error.</p>
|
|
1956
2016
|
*/
|
|
1957
2017
|
TerminationProtected?: boolean;
|
|
1958
2018
|
/**
|
|
@@ -2034,13 +2094,13 @@ export interface JobFlowDetail {
|
|
|
2034
2094
|
*/
|
|
2035
2095
|
LogUri?: string;
|
|
2036
2096
|
/**
|
|
2037
|
-
* <p>The KMS key used for encrypting log files. This attribute is
|
|
2038
|
-
*
|
|
2097
|
+
* <p>The KMS key used for encrypting log files. This attribute is only
|
|
2098
|
+
* available with EMR version 5.30.0 and later, excluding EMR 6.0.0.</p>
|
|
2039
2099
|
*/
|
|
2040
2100
|
LogEncryptionKmsKeyId?: string;
|
|
2041
2101
|
/**
|
|
2042
|
-
* <p>Applies only to Amazon EMR AMI versions 3.x and 2.x. For Amazon EMR
|
|
2043
|
-
* later, <code>ReleaseLabel</code> is used. To specify a custom AMI, use
|
|
2102
|
+
* <p>Applies only to Amazon EMR AMI versions 3.x and 2.x. For Amazon EMR
|
|
2103
|
+
* releases 4.0 and later, <code>ReleaseLabel</code> is used. To specify a custom AMI, use
|
|
2044
2104
|
* <code>CustomAmiID</code>.</p>
|
|
2045
2105
|
*/
|
|
2046
2106
|
AmiVersion?: string;
|
|
@@ -2066,9 +2126,11 @@ export interface JobFlowDetail {
|
|
|
2066
2126
|
*/
|
|
2067
2127
|
SupportedProducts?: string[];
|
|
2068
2128
|
/**
|
|
2069
|
-
* <p>Indicates whether the cluster is visible to IAM principals in the Amazon Web Services account associated
|
|
2070
|
-
*
|
|
2071
|
-
*
|
|
2129
|
+
* <p>Indicates whether the cluster is visible to IAM principals in the Amazon Web Services account associated with the cluster. When <code>true</code>, IAM principals
|
|
2130
|
+
* in the Amazon Web Services account can perform EMR cluster actions that their IAM policies
|
|
2131
|
+
* allow. When <code>false</code>, only the IAM principal that created the cluster and the
|
|
2132
|
+
* Amazon Web Services account root user can perform EMR actions, regardless of IAM
|
|
2133
|
+
* permissions policies attached to other IAM principals.</p>
|
|
2072
2134
|
* <p>The default value is <code>true</code> if a value is not provided when creating a
|
|
2073
2135
|
* cluster using the EMR API <a>RunJobFlow</a> command, the CLI
|
|
2074
2136
|
* <a href="https://docs.aws.amazon.com/cli/latest/reference/emr/create-cluster.html">create-cluster</a> command, or the Amazon Web Services Management Console.</p>
|
|
@@ -2080,8 +2142,7 @@ export interface JobFlowDetail {
|
|
|
2080
2142
|
*/
|
|
2081
2143
|
JobFlowRole?: string;
|
|
2082
2144
|
/**
|
|
2083
|
-
* <p>The IAM role that is assumed by the Amazon EMR service to access Amazon Web Services resources on your
|
|
2084
|
-
* behalf.</p>
|
|
2145
|
+
* <p>The IAM role that is assumed by the Amazon EMR service to access Amazon Web Services resources on your behalf.</p>
|
|
2085
2146
|
*/
|
|
2086
2147
|
ServiceRole?: string;
|
|
2087
2148
|
/**
|
|
@@ -2092,17 +2153,16 @@ export interface JobFlowDetail {
|
|
|
2092
2153
|
*/
|
|
2093
2154
|
AutoScalingRole?: string;
|
|
2094
2155
|
/**
|
|
2095
|
-
* <p>The way that individual Amazon EC2 instances terminate when an automatic
|
|
2096
|
-
* activity occurs or an instance group is resized.
|
|
2097
|
-
*
|
|
2098
|
-
*
|
|
2099
|
-
*
|
|
2100
|
-
*
|
|
2101
|
-
*
|
|
2102
|
-
*
|
|
2103
|
-
* first and blocks instance termination if it could lead to
|
|
2104
|
-
*
|
|
2105
|
-
* later, and is the default for versions of Amazon EMR earlier than 5.1.0.</p>
|
|
2156
|
+
* <p>The way that individual Amazon EC2 instances terminate when an automatic
|
|
2157
|
+
* scale-in activity occurs or an instance group is resized.
|
|
2158
|
+
* <code>TERMINATE_AT_INSTANCE_HOUR</code> indicates that Amazon EMR terminates
|
|
2159
|
+
* nodes at the instance-hour boundary, regardless of when the request to terminate the
|
|
2160
|
+
* instance was submitted. This option is only available with Amazon EMR 5.1.0 and
|
|
2161
|
+
* later and is the default for clusters created using that version.
|
|
2162
|
+
* <code>TERMINATE_AT_TASK_COMPLETION</code> indicates that Amazon EMR adds nodes
|
|
2163
|
+
* to a deny list and drains tasks from nodes before terminating the Amazon EC2
|
|
2164
|
+
* instances, regardless of the instance-hour boundary. With either behavior, Amazon EMR removes the least active nodes first and blocks instance termination if it could lead to
|
|
2165
|
+
* HDFS corruption. <code>TERMINATE_AT_TASK_COMPLETION</code> available only in Amazon EMR version 4.1.0 and later, and is the default for versions of Amazon EMR earlier than 5.1.0.</p>
|
|
2106
2166
|
*/
|
|
2107
2167
|
ScaleDownBehavior?: ScaleDownBehavior | string;
|
|
2108
2168
|
}
|
|
@@ -2357,19 +2417,45 @@ export declare namespace SimplifiedApplication {
|
|
|
2357
2417
|
*/
|
|
2358
2418
|
const filterSensitiveLog: (obj: SimplifiedApplication) => any;
|
|
2359
2419
|
}
|
|
2420
|
+
/**
|
|
2421
|
+
* <p>The Amazon Linux release specified for a cluster in the RunJobFlow request.</p>
|
|
2422
|
+
*/
|
|
2423
|
+
export interface OSRelease {
|
|
2424
|
+
/**
|
|
2425
|
+
* <p>The Amazon Linux release specified for a cluster in the RunJobFlow request. The format is as shown in <a href="https://docs.aws.amazon.com/AL2/latest/relnotes/relnotes-20220218.html">
|
|
2426
|
+
* <i>Amazon Linux 2 Release Notes</i>
|
|
2427
|
+
* </a>. For example, 2.0.20220218.1.</p>
|
|
2428
|
+
*/
|
|
2429
|
+
Label?: string;
|
|
2430
|
+
}
|
|
2431
|
+
export declare namespace OSRelease {
|
|
2432
|
+
/**
|
|
2433
|
+
* @internal
|
|
2434
|
+
*/
|
|
2435
|
+
const filterSensitiveLog: (obj: OSRelease) => any;
|
|
2436
|
+
}
|
|
2360
2437
|
export interface DescribeReleaseLabelOutput {
|
|
2361
2438
|
/**
|
|
2362
2439
|
* <p>The target release label described in the response.</p>
|
|
2363
2440
|
*/
|
|
2364
2441
|
ReleaseLabel?: string;
|
|
2365
2442
|
/**
|
|
2366
|
-
* <p>The list of applications available for the target release label. <code>Name</code> is
|
|
2443
|
+
* <p>The list of applications available for the target release label. <code>Name</code> is
|
|
2444
|
+
* the name of the application. <code>Version</code> is the concise version of the
|
|
2445
|
+
* application.</p>
|
|
2367
2446
|
*/
|
|
2368
2447
|
Applications?: SimplifiedApplication[];
|
|
2369
2448
|
/**
|
|
2370
2449
|
* <p>The pagination token. Reserved for future use. Currently set to null.</p>
|
|
2371
2450
|
*/
|
|
2372
2451
|
NextToken?: string;
|
|
2452
|
+
/**
|
|
2453
|
+
* <p>The list of available Amazon Linux release versions for an Amazon EMR release.
|
|
2454
|
+
* Contains a Label field that is formatted as shown in <a href="https://docs.aws.amazon.com/AL2/latest/relnotes/relnotes-al2.html">
|
|
2455
|
+
* <i>Amazon Linux 2 Release Notes</i>
|
|
2456
|
+
* </a>. For example, <a href="https://docs.aws.amazon.com/AL2/latest/relnotes/relnotes-20220218.html">2.0.20220218.1</a>.</p>
|
|
2457
|
+
*/
|
|
2458
|
+
AvailableOSReleases?: OSRelease[];
|
|
2373
2459
|
}
|
|
2374
2460
|
export declare namespace DescribeReleaseLabelOutput {
|
|
2375
2461
|
/**
|
|
@@ -2473,9 +2559,9 @@ export interface FailureDetails {
|
|
|
2473
2559
|
*/
|
|
2474
2560
|
Reason?: string;
|
|
2475
2561
|
/**
|
|
2476
|
-
* <p>The descriptive message including the error the Amazon EMR service has
|
|
2477
|
-
* cause of step failure. This is text from an error log that describes the
|
|
2478
|
-
* failure.</p>
|
|
2562
|
+
* <p>The descriptive message including the error the Amazon EMR service has
|
|
2563
|
+
* identified as the cause of step failure. This is text from an error log that describes the
|
|
2564
|
+
* root cause of the failure.</p>
|
|
2479
2565
|
*/
|
|
2480
2566
|
Message?: string;
|
|
2481
2567
|
/**
|
|
@@ -2588,11 +2674,21 @@ export interface Step {
|
|
|
2588
2674
|
*/
|
|
2589
2675
|
Config?: HadoopStepConfig;
|
|
2590
2676
|
/**
|
|
2591
|
-
* <p>The action to take when the cluster step fails. Possible values are
|
|
2592
|
-
*
|
|
2593
|
-
*
|
|
2594
|
-
*
|
|
2595
|
-
* <p>If
|
|
2677
|
+
* <p>The action to take when the cluster step fails. Possible values are
|
|
2678
|
+
* <code>TERMINATE_CLUSTER</code>, <code>CANCEL_AND_WAIT</code>, and <code>CONTINUE</code>.
|
|
2679
|
+
* <code>TERMINATE_JOB_FLOW</code> is provided for backward compatibility. We recommend
|
|
2680
|
+
* using <code>TERMINATE_CLUSTER</code> instead.</p>
|
|
2681
|
+
* <p>If a cluster's <code>StepConcurrencyLevel</code> is greater than <code>1</code>, do not
|
|
2682
|
+
* use <code>AddJobFlowSteps</code> to submit a step with this parameter set to
|
|
2683
|
+
* <code>CANCEL_AND_WAIT</code> or <code>TERMINATE_CLUSTER</code>. The step is not
|
|
2684
|
+
* submitted and the action fails with a message that the <code>ActionOnFailure</code> setting
|
|
2685
|
+
* is not valid.</p>
|
|
2686
|
+
* <p>If you change a cluster's <code>StepConcurrencyLevel</code> to be greater than 1 while a
|
|
2687
|
+
* step is running, the <code>ActionOnFailure</code> parameter may not behave as you expect.
|
|
2688
|
+
* In this case, for a step that fails with this parameter set to
|
|
2689
|
+
* <code>CANCEL_AND_WAIT</code>, pending steps and the running step are not canceled; for a
|
|
2690
|
+
* step that fails with this parameter set to <code>TERMINATE_CLUSTER</code>, the cluster does
|
|
2691
|
+
* not terminate.</p>
|
|
2596
2692
|
*/
|
|
2597
2693
|
ActionOnFailure?: ActionOnFailure | string;
|
|
2598
2694
|
/**
|
|
@@ -2634,7 +2730,8 @@ export declare namespace DescribeStudioInput {
|
|
|
2634
2730
|
const filterSensitiveLog: (obj: DescribeStudioInput) => any;
|
|
2635
2731
|
}
|
|
2636
2732
|
/**
|
|
2637
|
-
* <p>Details for an Amazon EMR Studio including ID, creation time, name, and so
|
|
2733
|
+
* <p>Details for an Amazon EMR Studio including ID, creation time, name, and so
|
|
2734
|
+
* on.</p>
|
|
2638
2735
|
*/
|
|
2639
2736
|
export interface Studio {
|
|
2640
2737
|
/**
|
|
@@ -2670,19 +2767,21 @@ export interface Studio {
|
|
|
2670
2767
|
*/
|
|
2671
2768
|
ServiceRole?: string;
|
|
2672
2769
|
/**
|
|
2673
|
-
* <p>The name of the IAM role assumed by users logged in to the Amazon EMR Studio. A
|
|
2770
|
+
* <p>The name of the IAM role assumed by users logged in to the Amazon EMR Studio. A
|
|
2771
|
+
* Studio only requires a <code>UserRole</code> when you use IAM
|
|
2772
|
+
* authentication.</p>
|
|
2674
2773
|
*/
|
|
2675
2774
|
UserRole?: string;
|
|
2676
2775
|
/**
|
|
2677
|
-
* <p>The ID of the Workspace security group associated with the Amazon EMR Studio.
|
|
2678
|
-
* Workspace security group allows outbound network traffic to resources in the Engine
|
|
2776
|
+
* <p>The ID of the Workspace security group associated with the Amazon EMR Studio.
|
|
2777
|
+
* The Workspace security group allows outbound network traffic to resources in the Engine
|
|
2679
2778
|
* security group and to the internet.</p>
|
|
2680
2779
|
*/
|
|
2681
2780
|
WorkspaceSecurityGroupId?: string;
|
|
2682
2781
|
/**
|
|
2683
|
-
* <p>The ID of the Engine security group associated with the Amazon EMR Studio. The
|
|
2684
|
-
* security group allows inbound network traffic from resources in the Workspace
|
|
2685
|
-
* group.</p>
|
|
2782
|
+
* <p>The ID of the Engine security group associated with the Amazon EMR Studio. The
|
|
2783
|
+
* Engine security group allows inbound network traffic from resources in the Workspace
|
|
2784
|
+
* security group.</p>
|
|
2686
2785
|
*/
|
|
2687
2786
|
EngineSecurityGroupId?: string;
|
|
2688
2787
|
/**
|
|
@@ -2694,12 +2793,14 @@ export interface Studio {
|
|
|
2694
2793
|
*/
|
|
2695
2794
|
CreationTime?: Date;
|
|
2696
2795
|
/**
|
|
2697
|
-
* <p>The Amazon S3 location to back up Amazon EMR Studio Workspaces and
|
|
2698
|
-
* files.</p>
|
|
2796
|
+
* <p>The Amazon S3 location to back up Amazon EMR Studio Workspaces and
|
|
2797
|
+
* notebook files.</p>
|
|
2699
2798
|
*/
|
|
2700
2799
|
DefaultS3Location?: string;
|
|
2701
2800
|
/**
|
|
2702
|
-
* <p>Your identity provider's authentication endpoint. Amazon EMR Studio redirects
|
|
2801
|
+
* <p>Your identity provider's authentication endpoint. Amazon EMR Studio redirects
|
|
2802
|
+
* federated users to this endpoint for authentication when logging in to a Studio with the
|
|
2803
|
+
* Studio URL.</p>
|
|
2703
2804
|
*/
|
|
2704
2805
|
IdpAuthUrl?: string;
|
|
2705
2806
|
/**
|
|
@@ -2770,7 +2871,8 @@ export declare namespace EbsVolume {
|
|
|
2770
2871
|
}
|
|
2771
2872
|
export interface GetAutoTerminationPolicyInput {
|
|
2772
2873
|
/**
|
|
2773
|
-
* <p>Specifies the ID of the Amazon EMR cluster for which the auto-termination policy
|
|
2874
|
+
* <p>Specifies the ID of the Amazon EMR cluster for which the auto-termination policy
|
|
2875
|
+
* will be fetched.</p>
|
|
2774
2876
|
*/
|
|
2775
2877
|
ClusterId: string | undefined;
|
|
2776
2878
|
}
|
|
@@ -2782,7 +2884,8 @@ export declare namespace GetAutoTerminationPolicyInput {
|
|
|
2782
2884
|
}
|
|
2783
2885
|
export interface GetAutoTerminationPolicyOutput {
|
|
2784
2886
|
/**
|
|
2785
|
-
* <p>Specifies the auto-termination policy that is attached to an Amazon EMR cluster.
|
|
2887
|
+
* <p>Specifies the auto-termination policy that is attached to an Amazon EMR cluster.
|
|
2888
|
+
* </p>
|
|
2786
2889
|
*/
|
|
2787
2890
|
AutoTerminationPolicy?: AutoTerminationPolicy;
|
|
2788
2891
|
}
|
|
@@ -2814,9 +2917,10 @@ export declare namespace GetManagedScalingPolicyInput {
|
|
|
2814
2917
|
const filterSensitiveLog: (obj: GetManagedScalingPolicyInput) => any;
|
|
2815
2918
|
}
|
|
2816
2919
|
/**
|
|
2817
|
-
* <p> Managed scaling policy for an Amazon EMR cluster. The policy specifies the
|
|
2818
|
-
* resources that can be added or terminated from a cluster. The policy only
|
|
2819
|
-
* core and task nodes. The master node cannot be scaled after initial
|
|
2920
|
+
* <p> Managed scaling policy for an Amazon EMR cluster. The policy specifies the
|
|
2921
|
+
* limits for resources that can be added or terminated from a cluster. The policy only
|
|
2922
|
+
* applies to the core and task nodes. The master node cannot be scaled after initial
|
|
2923
|
+
* configuration. </p>
|
|
2820
2924
|
*/
|
|
2821
2925
|
export interface ManagedScalingPolicy {
|
|
2822
2926
|
/**
|
|
@@ -2834,7 +2938,8 @@ export declare namespace ManagedScalingPolicy {
|
|
|
2834
2938
|
}
|
|
2835
2939
|
export interface GetManagedScalingPolicyOutput {
|
|
2836
2940
|
/**
|
|
2837
|
-
* <p>Specifies the managed scaling policy that is attached to an Amazon EMR cluster.
|
|
2941
|
+
* <p>Specifies the managed scaling policy that is attached to an Amazon EMR cluster.
|
|
2942
|
+
* </p>
|
|
2838
2943
|
*/
|
|
2839
2944
|
ManagedScalingPolicy?: ManagedScalingPolicy;
|
|
2840
2945
|
}
|
|
@@ -2851,13 +2956,15 @@ export interface GetStudioSessionMappingInput {
|
|
|
2851
2956
|
StudioId: string | undefined;
|
|
2852
2957
|
/**
|
|
2853
2958
|
* <p>The globally unique identifier (GUID) of the user or group. For more information, see
|
|
2854
|
-
* <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId">UserId</a> and <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId">GroupId</a> in the <i>Amazon Web Services SSO Identity Store API
|
|
2855
|
-
*
|
|
2959
|
+
* <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId">UserId</a> and <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId">GroupId</a> in the <i>Amazon Web Services SSO Identity Store API
|
|
2960
|
+
* Reference</i>. Either <code>IdentityName</code> or <code>IdentityId</code> must
|
|
2961
|
+
* be specified.</p>
|
|
2856
2962
|
*/
|
|
2857
2963
|
IdentityId?: string;
|
|
2858
2964
|
/**
|
|
2859
|
-
* <p>The name of the user or group to fetch. For more information, see <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName">UserName</a> and <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName">DisplayName</a> in the <i>Amazon Web Services SSO Identity Store API
|
|
2860
|
-
*
|
|
2965
|
+
* <p>The name of the user or group to fetch. For more information, see <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName">UserName</a> and <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName">DisplayName</a> in the <i>Amazon Web Services SSO Identity Store API
|
|
2966
|
+
* Reference</i>. Either <code>IdentityName</code> or <code>IdentityId</code> must
|
|
2967
|
+
* be specified.</p>
|
|
2861
2968
|
*/
|
|
2862
2969
|
IdentityName?: string;
|
|
2863
2970
|
/**
|
|
@@ -2872,8 +2979,8 @@ export declare namespace GetStudioSessionMappingInput {
|
|
|
2872
2979
|
const filterSensitiveLog: (obj: GetStudioSessionMappingInput) => any;
|
|
2873
2980
|
}
|
|
2874
2981
|
/**
|
|
2875
|
-
* <p>Details for an Amazon EMR Studio session mapping including creation time, user
|
|
2876
|
-
* ID, Studio ID, and so on.</p>
|
|
2982
|
+
* <p>Details for an Amazon EMR Studio session mapping including creation time, user
|
|
2983
|
+
* or group ID, Studio ID, and so on.</p>
|
|
2877
2984
|
*/
|
|
2878
2985
|
export interface SessionMappingDetail {
|
|
2879
2986
|
/**
|
|
@@ -2886,11 +2993,12 @@ export interface SessionMappingDetail {
|
|
|
2886
2993
|
IdentityId?: string;
|
|
2887
2994
|
/**
|
|
2888
2995
|
* <p>The name of the user or group. For more information, see <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName">UserName</a> and <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName">DisplayName</a> in the <i>Amazon Web Services SSO Identity Store API
|
|
2889
|
-
*
|
|
2996
|
+
* Reference</i>.</p>
|
|
2890
2997
|
*/
|
|
2891
2998
|
IdentityName?: string;
|
|
2892
2999
|
/**
|
|
2893
|
-
* <p>Specifies whether the identity mapped to the Amazon EMR Studio is a user or a
|
|
3000
|
+
* <p>Specifies whether the identity mapped to the Amazon EMR Studio is a user or a
|
|
3001
|
+
* group.</p>
|
|
2894
3002
|
*/
|
|
2895
3003
|
IdentityType?: IdentityType | string;
|
|
2896
3004
|
/**
|
|
@@ -2915,8 +3023,8 @@ export declare namespace SessionMappingDetail {
|
|
|
2915
3023
|
}
|
|
2916
3024
|
export interface GetStudioSessionMappingOutput {
|
|
2917
3025
|
/**
|
|
2918
|
-
* <p>The session mapping details for the specified Amazon EMR Studio and identity,
|
|
2919
|
-
* session policy ARN and creation time.</p>
|
|
3026
|
+
* <p>The session mapping details for the specified Amazon EMR Studio and identity,
|
|
3027
|
+
* including session policy ARN and creation time.</p>
|
|
2920
3028
|
*/
|
|
2921
3029
|
SessionMapping?: SessionMappingDetail;
|
|
2922
3030
|
}
|
|
@@ -2978,7 +3086,8 @@ export interface ListClustersInput {
|
|
|
2978
3086
|
*/
|
|
2979
3087
|
CreatedBefore?: Date;
|
|
2980
3088
|
/**
|
|
2981
|
-
* <p>The cluster state filters to apply when listing clusters. Clusters that change state
|
|
3089
|
+
* <p>The cluster state filters to apply when listing clusters. Clusters that change state
|
|
3090
|
+
* while this action runs may be not be returned as expected in the list of clusters.</p>
|
|
2982
3091
|
*/
|
|
2983
3092
|
ClusterStates?: (ClusterState | string)[];
|
|
2984
3093
|
/**
|
|
@@ -3046,8 +3155,8 @@ export declare enum InstanceFleetStateChangeReasonCode {
|
|
|
3046
3155
|
/**
|
|
3047
3156
|
* <p>Provides status change reason details for the instance fleet.</p>
|
|
3048
3157
|
* <note>
|
|
3049
|
-
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
3050
|
-
* later, excluding 5.0.x versions.</p>
|
|
3158
|
+
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
3159
|
+
* 4.8.0 and later, excluding 5.0.x versions.</p>
|
|
3051
3160
|
* </note>
|
|
3052
3161
|
*/
|
|
3053
3162
|
export interface InstanceFleetStateChangeReason {
|
|
@@ -3070,8 +3179,8 @@ export declare namespace InstanceFleetStateChangeReason {
|
|
|
3070
3179
|
* <p>Provides historical timestamps for the instance fleet, including the time of creation,
|
|
3071
3180
|
* the time it became ready to run jobs, and the time of termination.</p>
|
|
3072
3181
|
* <note>
|
|
3073
|
-
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
3074
|
-
* later, excluding 5.0.x versions.</p>
|
|
3182
|
+
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
3183
|
+
* 4.8.0 and later, excluding 5.0.x versions.</p>
|
|
3075
3184
|
* </note>
|
|
3076
3185
|
*/
|
|
3077
3186
|
export interface InstanceFleetTimeline {
|
|
@@ -3097,8 +3206,8 @@ export declare namespace InstanceFleetTimeline {
|
|
|
3097
3206
|
/**
|
|
3098
3207
|
* <p>The status of the instance fleet.</p>
|
|
3099
3208
|
* <note>
|
|
3100
|
-
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
3101
|
-
* later, excluding 5.0.x versions.</p>
|
|
3209
|
+
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
3210
|
+
* 4.8.0 and later, excluding 5.0.x versions.</p>
|
|
3102
3211
|
* </note>
|
|
3103
3212
|
*/
|
|
3104
3213
|
export interface InstanceFleetStatus {
|
|
@@ -3582,7 +3691,8 @@ export declare namespace ListNotebookExecutionsInput {
|
|
|
3582
3691
|
const filterSensitiveLog: (obj: ListNotebookExecutionsInput) => any;
|
|
3583
3692
|
}
|
|
3584
3693
|
/**
|
|
3585
|
-
* <p>Details for a notebook execution. The details include information such as the unique ID
|
|
3694
|
+
* <p>Details for a notebook execution. The details include information such as the unique ID
|
|
3695
|
+
* and status of the notebook execution.</p>
|
|
3586
3696
|
*/
|
|
3587
3697
|
export interface NotebookExecutionSummary {
|
|
3588
3698
|
/**
|
|
@@ -3705,15 +3815,23 @@ export declare namespace ReleaseLabelFilter {
|
|
|
3705
3815
|
}
|
|
3706
3816
|
export interface ListReleaseLabelsInput {
|
|
3707
3817
|
/**
|
|
3708
|
-
* <p>Filters the results of the request. <code>Prefix</code> specifies the prefix of release
|
|
3818
|
+
* <p>Filters the results of the request. <code>Prefix</code> specifies the prefix of release
|
|
3819
|
+
* labels to return. <code>Application</code> specifies the application (with/without version)
|
|
3820
|
+
* of release labels to return.</p>
|
|
3709
3821
|
*/
|
|
3710
3822
|
Filters?: ReleaseLabelFilter;
|
|
3711
3823
|
/**
|
|
3712
|
-
* <p>Specifies the next page of results. If <code>NextToken</code> is not specified, which is
|
|
3824
|
+
* <p>Specifies the next page of results. If <code>NextToken</code> is not specified, which is
|
|
3825
|
+
* usually the case for the first request of ListReleaseLabels, the first page of results are
|
|
3826
|
+
* determined by other filtering parameters or by the latest version. The
|
|
3827
|
+
* <code>ListReleaseLabels</code> request fails if the identity (Amazon Web Services account
|
|
3828
|
+
* ID) and all filtering parameters are different from the original request, or if the
|
|
3829
|
+
* <code>NextToken</code> is expired or tampered with.</p>
|
|
3713
3830
|
*/
|
|
3714
3831
|
NextToken?: string;
|
|
3715
3832
|
/**
|
|
3716
|
-
* <p>Defines the maximum number of release labels to return in a single response. The default
|
|
3833
|
+
* <p>Defines the maximum number of release labels to return in a single response. The default
|
|
3834
|
+
* is <code>100</code>.</p>
|
|
3717
3835
|
*/
|
|
3718
3836
|
MaxResults?: number;
|
|
3719
3837
|
}
|
|
@@ -3729,7 +3847,8 @@ export interface ListReleaseLabelsOutput {
|
|
|
3729
3847
|
*/
|
|
3730
3848
|
ReleaseLabels?: string[];
|
|
3731
3849
|
/**
|
|
3732
|
-
* <p>Used to paginate the next page of results if specified in the next
|
|
3850
|
+
* <p>Used to paginate the next page of results if specified in the next
|
|
3851
|
+
* <code>ListReleaseLabels</code> request.</p>
|
|
3733
3852
|
*/
|
|
3734
3853
|
NextToken?: string;
|
|
3735
3854
|
}
|
|
@@ -3807,7 +3926,10 @@ export interface ListStepsInput {
|
|
|
3807
3926
|
*/
|
|
3808
3927
|
StepIds?: string[];
|
|
3809
3928
|
/**
|
|
3810
|
-
* <p>The maximum number of steps that a single <code>ListSteps</code> action returns is 50.
|
|
3929
|
+
* <p>The maximum number of steps that a single <code>ListSteps</code> action returns is 50.
|
|
3930
|
+
* To return a longer list of steps, use multiple <code>ListSteps</code> actions along with
|
|
3931
|
+
* the <code>Marker</code> parameter, which is a pagination token that indicates the next set
|
|
3932
|
+
* of results to retrieve.</p>
|
|
3811
3933
|
*/
|
|
3812
3934
|
Marker?: string;
|
|
3813
3935
|
}
|
|
@@ -3835,7 +3957,8 @@ export interface StepSummary {
|
|
|
3835
3957
|
Config?: HadoopStepConfig;
|
|
3836
3958
|
/**
|
|
3837
3959
|
* <p>The action to take when the cluster step fails. Possible values are TERMINATE_CLUSTER,
|
|
3838
|
-
* CANCEL_AND_WAIT, and CONTINUE. TERMINATE_JOB_FLOW is available for backward
|
|
3960
|
+
* CANCEL_AND_WAIT, and CONTINUE. TERMINATE_JOB_FLOW is available for backward
|
|
3961
|
+
* compatibility.</p>
|
|
3839
3962
|
*/
|
|
3840
3963
|
ActionOnFailure?: ActionOnFailure | string;
|
|
3841
3964
|
/**
|
|
@@ -3859,7 +3982,10 @@ export interface ListStepsOutput {
|
|
|
3859
3982
|
*/
|
|
3860
3983
|
Steps?: StepSummary[];
|
|
3861
3984
|
/**
|
|
3862
|
-
* <p>The maximum number of steps that a single <code>ListSteps</code> action returns is 50.
|
|
3985
|
+
* <p>The maximum number of steps that a single <code>ListSteps</code> action returns is 50.
|
|
3986
|
+
* To return a longer list of steps, use multiple <code>ListSteps</code> actions along with
|
|
3987
|
+
* the <code>Marker</code> parameter, which is a pagination token that indicates the next set
|
|
3988
|
+
* of results to retrieve.</p>
|
|
3863
3989
|
*/
|
|
3864
3990
|
Marker?: string;
|
|
3865
3991
|
}
|
|
@@ -3882,8 +4008,8 @@ export declare namespace ListStudiosInput {
|
|
|
3882
4008
|
const filterSensitiveLog: (obj: ListStudiosInput) => any;
|
|
3883
4009
|
}
|
|
3884
4010
|
/**
|
|
3885
|
-
* <p>Details for an Amazon EMR Studio, including ID, Name, VPC, and Description. The
|
|
3886
|
-
* do not include subnets, IAM roles, security groups, or tags associated with the
|
|
4011
|
+
* <p>Details for an Amazon EMR Studio, including ID, Name, VPC, and Description. The
|
|
4012
|
+
* details do not include subnets, IAM roles, security groups, or tags associated with the
|
|
3887
4013
|
* Studio.</p>
|
|
3888
4014
|
*/
|
|
3889
4015
|
export interface StudioSummary {
|
|
@@ -3896,8 +4022,7 @@ export interface StudioSummary {
|
|
|
3896
4022
|
*/
|
|
3897
4023
|
Name?: string;
|
|
3898
4024
|
/**
|
|
3899
|
-
* <p>The ID of the Virtual Private Cloud (Amazon VPC) associated with the Amazon EMR
|
|
3900
|
-
* Studio.</p>
|
|
4025
|
+
* <p>The ID of the Virtual Private Cloud (Amazon VPC) associated with the Amazon EMR Studio.</p>
|
|
3901
4026
|
*/
|
|
3902
4027
|
VpcId?: string;
|
|
3903
4028
|
/**
|
|
@@ -3961,8 +4086,8 @@ export declare namespace ListStudioSessionMappingsInput {
|
|
|
3961
4086
|
const filterSensitiveLog: (obj: ListStudioSessionMappingsInput) => any;
|
|
3962
4087
|
}
|
|
3963
4088
|
/**
|
|
3964
|
-
* <p>Details for an Amazon EMR Studio session mapping. The details do not include the
|
|
3965
|
-
* the session mapping was last modified.</p>
|
|
4089
|
+
* <p>Details for an Amazon EMR Studio session mapping. The details do not include the
|
|
4090
|
+
* time the session mapping was last modified.</p>
|
|
3966
4091
|
*/
|
|
3967
4092
|
export interface SessionMappingSummary {
|
|
3968
4093
|
/**
|
|
@@ -3970,17 +4095,18 @@ export interface SessionMappingSummary {
|
|
|
3970
4095
|
*/
|
|
3971
4096
|
StudioId?: string;
|
|
3972
4097
|
/**
|
|
3973
|
-
* <p>The globally unique identifier (GUID) of the user or group from the Amazon Web Services SSO
|
|
3974
|
-
* Store.</p>
|
|
4098
|
+
* <p>The globally unique identifier (GUID) of the user or group from the Amazon Web Services SSO
|
|
4099
|
+
* Identity Store.</p>
|
|
3975
4100
|
*/
|
|
3976
4101
|
IdentityId?: string;
|
|
3977
4102
|
/**
|
|
3978
4103
|
* <p>The name of the user or group. For more information, see <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName">UserName</a> and <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName">DisplayName</a> in the <i>Amazon Web Services SSO Identity Store API
|
|
3979
|
-
*
|
|
4104
|
+
* Reference</i>.</p>
|
|
3980
4105
|
*/
|
|
3981
4106
|
IdentityName?: string;
|
|
3982
4107
|
/**
|
|
3983
|
-
* <p>Specifies whether the identity mapped to the Amazon EMR Studio is a user or a
|
|
4108
|
+
* <p>Specifies whether the identity mapped to the Amazon EMR Studio is a user or a
|
|
4109
|
+
* group.</p>
|
|
3984
4110
|
*/
|
|
3985
4111
|
IdentityType?: IdentityType | string;
|
|
3986
4112
|
/**
|
|
@@ -4002,7 +4128,8 @@ export declare namespace SessionMappingSummary {
|
|
|
4002
4128
|
export interface ListStudioSessionMappingsOutput {
|
|
4003
4129
|
/**
|
|
4004
4130
|
* <p>A list of session mapping summary objects. Each object includes session mapping details
|
|
4005
|
-
* such as creation time, identity type (user or group), and Amazon EMR Studio
|
|
4131
|
+
* such as creation time, identity type (user or group), and Amazon EMR Studio
|
|
4132
|
+
* ID.</p>
|
|
4006
4133
|
*/
|
|
4007
4134
|
SessionMappings?: SessionMappingSummary[];
|
|
4008
4135
|
/**
|
|
@@ -4022,7 +4149,10 @@ export interface ModifyClusterInput {
|
|
|
4022
4149
|
*/
|
|
4023
4150
|
ClusterId: string | undefined;
|
|
4024
4151
|
/**
|
|
4025
|
-
* <p>The number of steps that can be executed concurrently. You can specify a minimum of 1
|
|
4152
|
+
* <p>The number of steps that can be executed concurrently. You can specify a minimum of 1
|
|
4153
|
+
* step and a maximum of 256 steps. We recommend that you do not change this parameter while
|
|
4154
|
+
* steps are running or the <code>ActionOnFailure</code> setting may not behave as expected.
|
|
4155
|
+
* For more information see <a>Step$ActionOnFailure</a>.</p>
|
|
4026
4156
|
*/
|
|
4027
4157
|
StepConcurrencyLevel?: number;
|
|
4028
4158
|
}
|
|
@@ -4047,8 +4177,8 @@ export declare namespace ModifyClusterOutput {
|
|
|
4047
4177
|
/**
|
|
4048
4178
|
* <p>Configuration parameters for an instance fleet modification request.</p>
|
|
4049
4179
|
* <note>
|
|
4050
|
-
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
4051
|
-
* later, excluding 5.0.x versions.</p>
|
|
4180
|
+
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
4181
|
+
* 4.8.0 and later, excluding 5.0.x versions.</p>
|
|
4052
4182
|
* </note>
|
|
4053
4183
|
*/
|
|
4054
4184
|
export interface InstanceFleetModifyConfig {
|
|
@@ -4089,6 +4219,10 @@ export declare namespace ModifyInstanceFleetInput {
|
|
|
4089
4219
|
*/
|
|
4090
4220
|
const filterSensitiveLog: (obj: ModifyInstanceFleetInput) => any;
|
|
4091
4221
|
}
|
|
4222
|
+
export declare enum ReconfigurationType {
|
|
4223
|
+
MERGE = "MERGE",
|
|
4224
|
+
OVERWRITE = "OVERWRITE"
|
|
4225
|
+
}
|
|
4092
4226
|
export interface PutAutoScalingPolicyInput {
|
|
4093
4227
|
/**
|
|
4094
4228
|
* <p>Specifies the ID of a cluster. The instance group to which the automatic scaling policy
|
|
@@ -4138,7 +4272,8 @@ export declare namespace PutAutoScalingPolicyOutput {
|
|
|
4138
4272
|
}
|
|
4139
4273
|
export interface PutAutoTerminationPolicyInput {
|
|
4140
4274
|
/**
|
|
4141
|
-
* <p>Specifies the ID of the Amazon EMR cluster to which the auto-termination policy
|
|
4275
|
+
* <p>Specifies the ID of the Amazon EMR cluster to which the auto-termination policy
|
|
4276
|
+
* will be attached.</p>
|
|
4142
4277
|
*/
|
|
4143
4278
|
ClusterId: string | undefined;
|
|
4144
4279
|
/**
|
|
@@ -4219,7 +4354,8 @@ export declare namespace RemoveAutoScalingPolicyOutput {
|
|
|
4219
4354
|
}
|
|
4220
4355
|
export interface RemoveAutoTerminationPolicyInput {
|
|
4221
4356
|
/**
|
|
4222
|
-
* <p>Specifies the ID of the Amazon EMR cluster from which the auto-termination
|
|
4357
|
+
* <p>Specifies the ID of the Amazon EMR cluster from which the auto-termination
|
|
4358
|
+
* policy will be removed.</p>
|
|
4223
4359
|
*/
|
|
4224
4360
|
ClusterId: string | undefined;
|
|
4225
4361
|
}
|
|
@@ -4259,12 +4395,13 @@ export declare namespace RemoveManagedScalingPolicyOutput {
|
|
|
4259
4395
|
const filterSensitiveLog: (obj: RemoveManagedScalingPolicyOutput) => any;
|
|
4260
4396
|
}
|
|
4261
4397
|
/**
|
|
4262
|
-
* <p>This input identifies an Amazon EMR resource and a list of tags to
|
|
4398
|
+
* <p>This input identifies an Amazon EMR resource and a list of tags to
|
|
4399
|
+
* remove.</p>
|
|
4263
4400
|
*/
|
|
4264
4401
|
export interface RemoveTagsInput {
|
|
4265
4402
|
/**
|
|
4266
|
-
* <p>The Amazon EMR resource identifier from which tags will be removed. For example,
|
|
4267
|
-
* cluster identifier or an Amazon EMR Studio ID.</p>
|
|
4403
|
+
* <p>The Amazon EMR resource identifier from which tags will be removed. For example,
|
|
4404
|
+
* a cluster identifier or an Amazon EMR Studio ID.</p>
|
|
4268
4405
|
*/
|
|
4269
4406
|
ResourceId: string | undefined;
|
|
4270
4407
|
/**
|
|
@@ -4339,8 +4476,7 @@ export interface SetTerminationProtectionInput {
|
|
|
4339
4476
|
*/
|
|
4340
4477
|
JobFlowIds: string[] | undefined;
|
|
4341
4478
|
/**
|
|
4342
|
-
* <p>A Boolean that indicates whether to protect the cluster and prevent the Amazon EC2
|
|
4343
|
-
* instances in the cluster from shutting down due to API calls, user intervention, or
|
|
4479
|
+
* <p>A Boolean that indicates whether to protect the cluster and prevent the Amazon EC2 instances in the cluster from shutting down due to API calls, user intervention, or
|
|
4344
4480
|
* job-flow error.</p>
|
|
4345
4481
|
*/
|
|
4346
4482
|
TerminationProtected: boolean | undefined;
|
|
@@ -4360,9 +4496,10 @@ export interface SetVisibleToAllUsersInput {
|
|
|
4360
4496
|
*/
|
|
4361
4497
|
JobFlowIds: string[] | undefined;
|
|
4362
4498
|
/**
|
|
4363
|
-
* <p>A value of <code>true</code> indicates that an IAM principal in the Amazon Web Services account can perform
|
|
4364
|
-
*
|
|
4365
|
-
*
|
|
4499
|
+
* <p>A value of <code>true</code> indicates that an IAM principal in the Amazon Web Services account can perform EMR actions on the cluster that the IAM policies attached
|
|
4500
|
+
* to the principal allow. A value of <code>false</code> indicates that only the IAM principal
|
|
4501
|
+
* that created the cluster and the Amazon Web Services root user can perform EMR actions on
|
|
4502
|
+
* the cluster.</p>
|
|
4366
4503
|
*/
|
|
4367
4504
|
VisibleToAllUsers: boolean | undefined;
|
|
4368
4505
|
}
|
|
@@ -4402,8 +4539,8 @@ export interface StartNotebookExecutionInput {
|
|
|
4402
4539
|
*/
|
|
4403
4540
|
ExecutionEngine: ExecutionEngineConfig | undefined;
|
|
4404
4541
|
/**
|
|
4405
|
-
* <p>The name or ARN of the IAM role that is used as the service role for Amazon EMR
|
|
4406
|
-
* role) for the notebook execution.</p>
|
|
4542
|
+
* <p>The name or ARN of the IAM role that is used as the service role for Amazon EMR
|
|
4543
|
+
* (the EMR role) for the notebook execution.</p>
|
|
4407
4544
|
*/
|
|
4408
4545
|
ServiceRole: string | undefined;
|
|
4409
4546
|
/**
|
|
@@ -4477,7 +4614,10 @@ export interface UpdateStudioInput {
|
|
|
4477
4614
|
*/
|
|
4478
4615
|
Description?: string;
|
|
4479
4616
|
/**
|
|
4480
|
-
* <p>A list of subnet IDs to associate with the Amazon EMR Studio. The list can
|
|
4617
|
+
* <p>A list of subnet IDs to associate with the Amazon EMR Studio. The list can
|
|
4618
|
+
* include new subnet IDs, but must also include all of the subnet IDs previously associated
|
|
4619
|
+
* with the Studio. The list order does not matter. A Studio can have a maximum of 5 subnets.
|
|
4620
|
+
* The subnets must belong to the same VPC as the Studio. </p>
|
|
4481
4621
|
*/
|
|
4482
4622
|
SubnetIds?: string[];
|
|
4483
4623
|
/**
|
|
@@ -4498,13 +4638,15 @@ export interface UpdateStudioSessionMappingInput {
|
|
|
4498
4638
|
StudioId: string | undefined;
|
|
4499
4639
|
/**
|
|
4500
4640
|
* <p>The globally unique identifier (GUID) of the user or group. For more information, see
|
|
4501
|
-
* <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId">UserId</a> and <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId">GroupId</a> in the <i>Amazon Web Services SSO Identity Store API
|
|
4502
|
-
*
|
|
4641
|
+
* <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId">UserId</a> and <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId">GroupId</a> in the <i>Amazon Web Services SSO Identity Store API
|
|
4642
|
+
* Reference</i>. Either <code>IdentityName</code> or <code>IdentityId</code> must
|
|
4643
|
+
* be specified.</p>
|
|
4503
4644
|
*/
|
|
4504
4645
|
IdentityId?: string;
|
|
4505
4646
|
/**
|
|
4506
|
-
* <p>The name of the user or group to update. For more information, see <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName">UserName</a> and <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName">DisplayName</a> in the <i>Amazon Web Services SSO Identity Store API
|
|
4507
|
-
*
|
|
4647
|
+
* <p>The name of the user or group to update. For more information, see <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName">UserName</a> and <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName">DisplayName</a> in the <i>Amazon Web Services SSO Identity Store API
|
|
4648
|
+
* Reference</i>. Either <code>IdentityName</code> or <code>IdentityId</code> must
|
|
4649
|
+
* be specified.</p>
|
|
4508
4650
|
*/
|
|
4509
4651
|
IdentityName?: string;
|
|
4510
4652
|
/**
|
|
@@ -4528,11 +4670,10 @@ export declare namespace UpdateStudioSessionMappingInput {
|
|
|
4528
4670
|
* <p>Amazon EMR releases 4.x or later.</p>
|
|
4529
4671
|
* </note>
|
|
4530
4672
|
* <p>An optional configuration specification to be used when provisioning cluster instances,
|
|
4531
|
-
* which can include configurations for applications and software bundled with Amazon EMR. A
|
|
4532
|
-
*
|
|
4533
|
-
*
|
|
4534
|
-
*
|
|
4535
|
-
* Applications</a>.</p>
|
|
4673
|
+
* which can include configurations for applications and software bundled with Amazon EMR. A configuration consists of a classification, properties, and optional
|
|
4674
|
+
* nested configurations. A classification refers to an application-specific configuration
|
|
4675
|
+
* file. Properties are the settings you want to change in that file. For more information,
|
|
4676
|
+
* see <a href="https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-configure-apps.html">Configuring Applications</a>.</p>
|
|
4536
4677
|
*/
|
|
4537
4678
|
export interface Configuration {
|
|
4538
4679
|
/**
|
|
@@ -4558,15 +4699,14 @@ export declare namespace Configuration {
|
|
|
4558
4699
|
}
|
|
4559
4700
|
/**
|
|
4560
4701
|
* <p>A configuration for Amazon EMR block public access. When
|
|
4561
|
-
* <code>BlockPublicSecurityGroupRules</code> is set to <code>true</code>, Amazon EMR
|
|
4562
|
-
* prevents cluster creation if one of the cluster's security groups has a rule that allows
|
|
4702
|
+
* <code>BlockPublicSecurityGroupRules</code> is set to <code>true</code>, Amazon EMR prevents cluster creation if one of the cluster's security groups has a rule that allows
|
|
4563
4703
|
* inbound traffic from 0.0.0.0/0 or ::/0 on a port, unless the port is specified as an
|
|
4564
4704
|
* exception using <code>PermittedPublicSecurityGroupRuleRanges</code>.</p>
|
|
4565
4705
|
*/
|
|
4566
4706
|
export interface BlockPublicAccessConfiguration {
|
|
4567
4707
|
/**
|
|
4568
|
-
* <p>Indicates whether Amazon EMR block public access is enabled (<code>true</code>)
|
|
4569
|
-
* disabled (<code>false</code>). By default, the value is <code>false</code> for accounts
|
|
4708
|
+
* <p>Indicates whether Amazon EMR block public access is enabled (<code>true</code>)
|
|
4709
|
+
* or disabled (<code>false</code>). By default, the value is <code>false</code> for accounts
|
|
4570
4710
|
* that have created EMR clusters before July 2019. For accounts created after this, the
|
|
4571
4711
|
* default is <code>true</code>.</p>
|
|
4572
4712
|
*/
|
|
@@ -4574,9 +4714,10 @@ export interface BlockPublicAccessConfiguration {
|
|
|
4574
4714
|
/**
|
|
4575
4715
|
* <p>Specifies ports and port ranges that are permitted to have security group rules that
|
|
4576
4716
|
* allow inbound traffic from all public sources. For example, if Port 23 (Telnet) is
|
|
4577
|
-
* specified for <code>PermittedPublicSecurityGroupRuleRanges</code>, Amazon EMR
|
|
4578
|
-
* cluster creation if a security group associated with the cluster has a rule that
|
|
4579
|
-
* inbound traffic on Port 23 from IPv4 0.0.0.0/0 or IPv6 port ::/0 as the
|
|
4717
|
+
* specified for <code>PermittedPublicSecurityGroupRuleRanges</code>, Amazon EMR
|
|
4718
|
+
* allows cluster creation if a security group associated with the cluster has a rule that
|
|
4719
|
+
* allows inbound traffic on Port 23 from IPv4 0.0.0.0/0 or IPv6 port ::/0 as the
|
|
4720
|
+
* source.</p>
|
|
4580
4721
|
* <p>By default, Port 22, which is used for SSH access to the cluster EC2 instances, is in
|
|
4581
4722
|
* the list of <code>PermittedPublicSecurityGroupRuleRanges</code>.</p>
|
|
4582
4723
|
*/
|
|
@@ -4625,8 +4766,8 @@ export interface Cluster {
|
|
|
4625
4766
|
Ec2InstanceAttributes?: Ec2InstanceAttributes;
|
|
4626
4767
|
/**
|
|
4627
4768
|
* <note>
|
|
4628
|
-
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
4629
|
-
* later, excluding 5.0.x versions.</p>
|
|
4769
|
+
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
4770
|
+
* 4.8.0 and later, excluding 5.0.x versions.</p>
|
|
4630
4771
|
* </note>
|
|
4631
4772
|
* <p>The instance group configuration of the cluster. A value of <code>INSTANCE_GROUP</code>
|
|
4632
4773
|
* indicates a uniform instance group configuration. A value of <code>INSTANCE_FLEET</code>
|
|
@@ -4634,12 +4775,13 @@ export interface Cluster {
|
|
|
4634
4775
|
*/
|
|
4635
4776
|
InstanceCollectionType?: InstanceCollectionType | string;
|
|
4636
4777
|
/**
|
|
4637
|
-
* <p>The path to the Amazon S3 location where logs for this cluster are
|
|
4778
|
+
* <p>The path to the Amazon S3 location where logs for this cluster are
|
|
4779
|
+
* stored.</p>
|
|
4638
4780
|
*/
|
|
4639
4781
|
LogUri?: string;
|
|
4640
4782
|
/**
|
|
4641
|
-
* <p> The KMS key used for encrypting log files. This attribute is
|
|
4642
|
-
*
|
|
4783
|
+
* <p> The KMS key used for encrypting log files. This attribute is only
|
|
4784
|
+
* available with EMR version 5.30.0 and later, excluding EMR 6.0.0. </p>
|
|
4643
4785
|
*/
|
|
4644
4786
|
LogEncryptionKmsKeyId?: string;
|
|
4645
4787
|
/**
|
|
@@ -4651,13 +4793,12 @@ export interface Cluster {
|
|
|
4651
4793
|
*/
|
|
4652
4794
|
RunningAmiVersion?: string;
|
|
4653
4795
|
/**
|
|
4654
|
-
* <p>The Amazon EMR release label, which determines the version of open-source
|
|
4655
|
-
* packages installed on the cluster. Release labels are in the form
|
|
4656
|
-
*
|
|
4657
|
-
*
|
|
4658
|
-
* features, see <a href="https://docs.aws.amazon.com/emr/latest/ReleaseGuide/">https://docs.aws.amazon.com/emr/latest/ReleaseGuide/</a>. The release
|
|
4659
|
-
*
|
|
4660
|
-
* <code>AmiVersion</code>.</p>
|
|
4796
|
+
* <p>The Amazon EMR release label, which determines the version of open-source
|
|
4797
|
+
* application packages installed on the cluster. Release labels are in the form
|
|
4798
|
+
* <code>emr-x.x.x</code>, where x.x.x is an Amazon EMR release version such as
|
|
4799
|
+
* <code>emr-5.14.0</code>. For more information about Amazon EMR release versions
|
|
4800
|
+
* and included application versions and features, see <a href="https://docs.aws.amazon.com/emr/latest/ReleaseGuide/">https://docs.aws.amazon.com/emr/latest/ReleaseGuide/</a>. The release label applies only to Amazon EMR
|
|
4801
|
+
* releases version 4.0 and later. Earlier versions use <code>AmiVersion</code>.</p>
|
|
4661
4802
|
*/
|
|
4662
4803
|
ReleaseLabel?: string;
|
|
4663
4804
|
/**
|
|
@@ -4665,15 +4806,17 @@ export interface Cluster {
|
|
|
4665
4806
|
*/
|
|
4666
4807
|
AutoTerminate?: boolean;
|
|
4667
4808
|
/**
|
|
4668
|
-
* <p>Indicates whether Amazon EMR will lock the cluster to prevent the EC2 instances
|
|
4669
|
-
* being terminated by an API call or user intervention, or in the event of a cluster
|
|
4809
|
+
* <p>Indicates whether Amazon EMR will lock the cluster to prevent the EC2 instances
|
|
4810
|
+
* from being terminated by an API call or user intervention, or in the event of a cluster
|
|
4670
4811
|
* error.</p>
|
|
4671
4812
|
*/
|
|
4672
4813
|
TerminationProtected?: boolean;
|
|
4673
4814
|
/**
|
|
4674
|
-
* <p>Indicates whether the cluster is visible to IAM principals in the Amazon Web Services account associated
|
|
4675
|
-
*
|
|
4676
|
-
*
|
|
4815
|
+
* <p>Indicates whether the cluster is visible to IAM principals in the Amazon Web Services account associated with the cluster. When <code>true</code>, IAM principals
|
|
4816
|
+
* in the Amazon Web Services account can perform EMR cluster actions on the cluster that their
|
|
4817
|
+
* IAM policies allow. When <code>false</code>, only the IAM principal that created the
|
|
4818
|
+
* cluster and the Amazon Web Services account root user can perform EMR actions, regardless of
|
|
4819
|
+
* IAM permissions policies attached to other IAM principals.</p>
|
|
4677
4820
|
* <p>The default value is <code>true</code> if a value is not provided when creating a
|
|
4678
4821
|
* cluster using the EMR API <a>RunJobFlow</a> command, the CLI
|
|
4679
4822
|
* <a href="https://docs.aws.amazon.com/cli/latest/reference/emr/create-cluster.html">create-cluster</a> command, or the Amazon Web Services Management Console.</p>
|
|
@@ -4688,8 +4831,8 @@ export interface Cluster {
|
|
|
4688
4831
|
*/
|
|
4689
4832
|
Tags?: Tag[];
|
|
4690
4833
|
/**
|
|
4691
|
-
* <p>The IAM role that Amazon EMR assumes in order to access Amazon Web Services
|
|
4692
|
-
* your behalf.</p>
|
|
4834
|
+
* <p>The IAM role that Amazon EMR assumes in order to access Amazon Web Services
|
|
4835
|
+
* resources on your behalf.</p>
|
|
4693
4836
|
*/
|
|
4694
4837
|
ServiceRole?: string;
|
|
4695
4838
|
/**
|
|
@@ -4706,8 +4849,8 @@ export interface Cluster {
|
|
|
4706
4849
|
*/
|
|
4707
4850
|
MasterPublicDnsName?: string;
|
|
4708
4851
|
/**
|
|
4709
|
-
* <p>Applies only to Amazon EMR releases 4.x and later. The list of Configurations
|
|
4710
|
-
* to the EMR cluster.</p>
|
|
4852
|
+
* <p>Applies only to Amazon EMR releases 4.x and later. The list of Configurations
|
|
4853
|
+
* supplied to the EMR cluster.</p>
|
|
4711
4854
|
*/
|
|
4712
4855
|
Configurations?: Configuration[];
|
|
4713
4856
|
/**
|
|
@@ -4722,17 +4865,16 @@ export interface Cluster {
|
|
|
4722
4865
|
*/
|
|
4723
4866
|
AutoScalingRole?: string;
|
|
4724
4867
|
/**
|
|
4725
|
-
* <p>The way that individual Amazon EC2 instances terminate when an automatic
|
|
4726
|
-
* activity occurs or an instance group is resized.
|
|
4727
|
-
*
|
|
4728
|
-
*
|
|
4729
|
-
*
|
|
4730
|
-
*
|
|
4731
|
-
*
|
|
4732
|
-
*
|
|
4733
|
-
* first and blocks instance termination if it could lead to
|
|
4734
|
-
*
|
|
4735
|
-
* and later, and is the default for versions of Amazon EMR earlier than 5.1.0.</p>
|
|
4868
|
+
* <p>The way that individual Amazon EC2 instances terminate when an automatic
|
|
4869
|
+
* scale-in activity occurs or an instance group is resized.
|
|
4870
|
+
* <code>TERMINATE_AT_INSTANCE_HOUR</code> indicates that Amazon EMR terminates
|
|
4871
|
+
* nodes at the instance-hour boundary, regardless of when the request to terminate the
|
|
4872
|
+
* instance was submitted. This option is only available with Amazon EMR 5.1.0 and
|
|
4873
|
+
* later and is the default for clusters created using that version.
|
|
4874
|
+
* <code>TERMINATE_AT_TASK_COMPLETION</code> indicates that Amazon EMR adds nodes
|
|
4875
|
+
* to a deny list and drains tasks from nodes before terminating the Amazon EC2
|
|
4876
|
+
* instances, regardless of the instance-hour boundary. With either behavior, Amazon EMR removes the least active nodes first and blocks instance termination if it could lead to
|
|
4877
|
+
* HDFS corruption. <code>TERMINATE_AT_TASK_COMPLETION</code> is available only in Amazon EMR version 4.1.0 and later, and is the default for versions of Amazon EMR earlier than 5.1.0.</p>
|
|
4736
4878
|
*/
|
|
4737
4879
|
ScaleDownBehavior?: ScaleDownBehavior | string;
|
|
4738
4880
|
/**
|
|
@@ -4741,8 +4883,8 @@ export interface Cluster {
|
|
|
4741
4883
|
*/
|
|
4742
4884
|
CustomAmiId?: string;
|
|
4743
4885
|
/**
|
|
4744
|
-
* <p>The size, in GiB, of the Amazon EBS root device volume of the Linux AMI that is
|
|
4745
|
-
* each EC2 instance. Available in Amazon EMR version 4.x and later.</p>
|
|
4886
|
+
* <p>The size, in GiB, of the Amazon EBS root device volume of the Linux AMI that is
|
|
4887
|
+
* used for each EC2 instance. Available in Amazon EMR version 4.x and later.</p>
|
|
4746
4888
|
*/
|
|
4747
4889
|
EbsRootVolumeSize?: number;
|
|
4748
4890
|
/**
|
|
@@ -4773,6 +4915,10 @@ export interface Cluster {
|
|
|
4773
4915
|
* <p>Placement group configured for an Amazon EMR cluster.</p>
|
|
4774
4916
|
*/
|
|
4775
4917
|
PlacementGroups?: PlacementGroupConfig[];
|
|
4918
|
+
/**
|
|
4919
|
+
* <p>The Amazon Linux release specified in a cluster launch RunJobFlow request. If no Amazon Linux release was specified, the default Amazon Linux release is shown in the response.</p>
|
|
4920
|
+
*/
|
|
4921
|
+
OSReleaseLabel?: string;
|
|
4776
4922
|
}
|
|
4777
4923
|
export declare namespace Cluster {
|
|
4778
4924
|
/**
|
|
@@ -4797,7 +4943,9 @@ export interface InstanceGroupConfig {
|
|
|
4797
4943
|
*/
|
|
4798
4944
|
InstanceRole: InstanceRoleType | string | undefined;
|
|
4799
4945
|
/**
|
|
4800
|
-
* <p>If specified, indicates that the instance group uses Spot Instances. This is the maximum
|
|
4946
|
+
* <p>If specified, indicates that the instance group uses Spot Instances. This is the maximum
|
|
4947
|
+
* price you are willing to pay for Spot Instances. Specify <code>OnDemandPrice</code> to set
|
|
4948
|
+
* the amount equal to the On-Demand price, or specify an amount in USD.</p>
|
|
4801
4949
|
*/
|
|
4802
4950
|
BidPrice?: string;
|
|
4803
4951
|
/**
|
|
@@ -4823,9 +4971,9 @@ export interface InstanceGroupConfig {
|
|
|
4823
4971
|
EbsConfiguration?: EbsConfiguration;
|
|
4824
4972
|
/**
|
|
4825
4973
|
* <p>An automatic scaling policy for a core instance group or task instance group in an
|
|
4826
|
-
*
|
|
4827
|
-
* adds and terminates EC2 instances in response to the value of a CloudWatch
|
|
4828
|
-
*
|
|
4974
|
+
* Amazon EMR cluster. The automatic scaling policy defines how an instance group
|
|
4975
|
+
* dynamically adds and terminates EC2 instances in response to the value of a CloudWatch
|
|
4976
|
+
* metric. See <a>PutAutoScalingPolicy</a>.</p>
|
|
4829
4977
|
*/
|
|
4830
4978
|
AutoScalingPolicy?: AutoScalingPolicy;
|
|
4831
4979
|
/**
|
|
@@ -4860,6 +5008,10 @@ export interface InstanceGroupModifyConfig {
|
|
|
4860
5008
|
* <p>Policy for customizing shrink operations.</p>
|
|
4861
5009
|
*/
|
|
4862
5010
|
ShrinkPolicy?: ShrinkPolicy;
|
|
5011
|
+
/**
|
|
5012
|
+
* <p>Type of reconfiguration requested. Valid values are MERGE and OVERWRITE.</p>
|
|
5013
|
+
*/
|
|
5014
|
+
ReconfigurationType?: ReconfigurationType | string;
|
|
4863
5015
|
/**
|
|
4864
5016
|
* <p>A list of new or modified configurations to apply for an instance group.</p>
|
|
4865
5017
|
*/
|
|
@@ -4873,11 +5025,15 @@ export declare namespace InstanceGroupModifyConfig {
|
|
|
4873
5025
|
}
|
|
4874
5026
|
/**
|
|
4875
5027
|
* <p>An instance type configuration for each instance type in an instance fleet, which
|
|
4876
|
-
* determines the EC2 instances Amazon EMR attempts to provision to fulfill On-Demand
|
|
4877
|
-
* target capacities. When you use an allocation strategy, you can include a maximum
|
|
5028
|
+
* determines the EC2 instances Amazon EMR attempts to provision to fulfill On-Demand
|
|
5029
|
+
* and Spot target capacities. When you use an allocation strategy, you can include a maximum
|
|
5030
|
+
* of 30 instance type configurations for a fleet. For more information about how to use an
|
|
5031
|
+
* allocation strategy, see <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-instance-fleet.html">Configure Instance
|
|
5032
|
+
* Fleets</a>. Without an allocation strategy, you may specify a maximum of five
|
|
5033
|
+
* instance type configurations for a fleet.</p>
|
|
4878
5034
|
* <note>
|
|
4879
|
-
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
4880
|
-
* later, excluding 5.0.x versions.</p>
|
|
5035
|
+
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
5036
|
+
* 4.8.0 and later, excluding 5.0.x versions.</p>
|
|
4881
5037
|
* </note>
|
|
4882
5038
|
*/
|
|
4883
5039
|
export interface InstanceTypeConfig {
|
|
@@ -4907,8 +5063,8 @@ export interface InstanceTypeConfig {
|
|
|
4907
5063
|
*/
|
|
4908
5064
|
BidPriceAsPercentageOfOnDemandPrice?: number;
|
|
4909
5065
|
/**
|
|
4910
|
-
* <p>The configuration of Amazon Elastic Block Store (Amazon EBS) attached to each
|
|
4911
|
-
* as defined by <code>InstanceType</code>. </p>
|
|
5066
|
+
* <p>The configuration of Amazon Elastic Block Store (Amazon EBS) attached to each
|
|
5067
|
+
* instance as defined by <code>InstanceType</code>. </p>
|
|
4912
5068
|
*/
|
|
4913
5069
|
EbsConfiguration?: EbsConfiguration;
|
|
4914
5070
|
/**
|
|
@@ -4930,8 +5086,8 @@ export declare namespace InstanceTypeConfig {
|
|
|
4930
5086
|
/**
|
|
4931
5087
|
* <p>The configuration specification for each instance type in an instance fleet.</p>
|
|
4932
5088
|
* <note>
|
|
4933
|
-
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
4934
|
-
* later, excluding 5.0.x versions.</p>
|
|
5089
|
+
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
5090
|
+
* 4.8.0 and later, excluding 5.0.x versions.</p>
|
|
4935
5091
|
* </note>
|
|
4936
5092
|
*/
|
|
4937
5093
|
export interface InstanceTypeSpecification {
|
|
@@ -4962,8 +5118,8 @@ export interface InstanceTypeSpecification {
|
|
|
4962
5118
|
*/
|
|
4963
5119
|
Configurations?: Configuration[];
|
|
4964
5120
|
/**
|
|
4965
|
-
* <p>The configuration of Amazon Elastic Block Store (Amazon EBS) attached to each
|
|
4966
|
-
* as defined by <code>InstanceType</code>.</p>
|
|
5121
|
+
* <p>The configuration of Amazon Elastic Block Store (Amazon EBS) attached to each
|
|
5122
|
+
* instance as defined by <code>InstanceType</code>.</p>
|
|
4967
5123
|
*/
|
|
4968
5124
|
EbsBlockDevices?: EbsBlockDevice[];
|
|
4969
5125
|
/**
|
|
@@ -4999,8 +5155,8 @@ export declare namespace DescribeClusterOutput {
|
|
|
4999
5155
|
}
|
|
5000
5156
|
export interface GetBlockPublicAccessConfigurationOutput {
|
|
5001
5157
|
/**
|
|
5002
|
-
* <p>A configuration for Amazon EMR block public access. The configuration applies to
|
|
5003
|
-
* clusters created in your account for the current Region. The configuration specifies
|
|
5158
|
+
* <p>A configuration for Amazon EMR block public access. The configuration applies to
|
|
5159
|
+
* all clusters created in your account for the current Region. The configuration specifies
|
|
5004
5160
|
* whether block public access is enabled. If block public access is enabled, security groups
|
|
5005
5161
|
* associated with the cluster cannot have rules that allow inbound traffic from 0.0.0.0/0 or
|
|
5006
5162
|
* ::/0 on a port, unless the port is specified as an exception using
|
|
@@ -5033,8 +5189,8 @@ export declare namespace GetBlockPublicAccessConfigurationOutput {
|
|
|
5033
5189
|
}
|
|
5034
5190
|
export interface PutBlockPublicAccessConfigurationInput {
|
|
5035
5191
|
/**
|
|
5036
|
-
* <p>A configuration for Amazon EMR block public access. The configuration applies to
|
|
5037
|
-
* clusters created in your account for the current Region. The configuration specifies
|
|
5192
|
+
* <p>A configuration for Amazon EMR block public access. The configuration applies to
|
|
5193
|
+
* all clusters created in your account for the current Region. The configuration specifies
|
|
5038
5194
|
* whether block public access is enabled. If block public access is enabled, security groups
|
|
5039
5195
|
* associated with the cluster cannot have rules that allow inbound traffic from 0.0.0.0/0 or
|
|
5040
5196
|
* ::/0 on a port, unless the port is specified as an exception using
|
|
@@ -5078,12 +5234,12 @@ export declare namespace AddInstanceGroupsInput {
|
|
|
5078
5234
|
}
|
|
5079
5235
|
/**
|
|
5080
5236
|
* <p>Describes an instance fleet, which is a group of EC2 instances that host a particular
|
|
5081
|
-
* node type (master, core, or task) in an Amazon EMR cluster. Instance fleets can
|
|
5082
|
-
* a mix of instance types and On-Demand and Spot Instances, which are provisioned
|
|
5083
|
-
* defined target capacity. </p>
|
|
5237
|
+
* node type (master, core, or task) in an Amazon EMR cluster. Instance fleets can
|
|
5238
|
+
* consist of a mix of instance types and On-Demand and Spot Instances, which are provisioned
|
|
5239
|
+
* to meet a defined target capacity. </p>
|
|
5084
5240
|
* <note>
|
|
5085
|
-
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
5086
|
-
* later, excluding 5.0.x versions.</p>
|
|
5241
|
+
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
5242
|
+
* 4.8.0 and later, excluding 5.0.x versions.</p>
|
|
5087
5243
|
* </note>
|
|
5088
5244
|
*/
|
|
5089
5245
|
export interface InstanceFleet {
|
|
@@ -5106,13 +5262,12 @@ export interface InstanceFleet {
|
|
|
5106
5262
|
InstanceFleetType?: InstanceFleetType | string;
|
|
5107
5263
|
/**
|
|
5108
5264
|
* <p>The target capacity of On-Demand units for the instance fleet, which determines how many
|
|
5109
|
-
* On-Demand Instances to provision. When the instance fleet launches, Amazon EMR
|
|
5110
|
-
* provision On-Demand Instances as specified by <a>InstanceTypeConfig</a>. Each
|
|
5111
|
-
*
|
|
5112
|
-
*
|
|
5113
|
-
*
|
|
5114
|
-
*
|
|
5115
|
-
* capacity, and Amazon EMR can only provision an instance with a
|
|
5265
|
+
* On-Demand Instances to provision. When the instance fleet launches, Amazon EMR
|
|
5266
|
+
* tries to provision On-Demand Instances as specified by <a>InstanceTypeConfig</a>. Each instance configuration has a specified <code>WeightedCapacity</code>. When an
|
|
5267
|
+
* On-Demand Instance is provisioned, the <code>WeightedCapacity</code> units count toward the
|
|
5268
|
+
* target capacity. Amazon EMR provisions instances until the target capacity is
|
|
5269
|
+
* totally fulfilled, even if this results in an overage. For example, if there are 2 units
|
|
5270
|
+
* remaining to fulfill capacity, and Amazon EMR can only provision an instance with a
|
|
5116
5271
|
* <code>WeightedCapacity</code> of 5 units, the instance is provisioned, and the target
|
|
5117
5272
|
* capacity is exceeded by 3 units. You can use <a>InstanceFleet$ProvisionedOnDemandCapacity</a> to determine the Spot capacity
|
|
5118
5273
|
* units that have been provisioned for the instance fleet.</p>
|
|
@@ -5128,12 +5283,12 @@ export interface InstanceFleet {
|
|
|
5128
5283
|
TargetOnDemandCapacity?: number;
|
|
5129
5284
|
/**
|
|
5130
5285
|
* <p>The target capacity of Spot units for the instance fleet, which determines how many Spot
|
|
5131
|
-
* Instances to provision. When the instance fleet launches, Amazon EMR tries to
|
|
5132
|
-
* Spot Instances as specified by <a>InstanceTypeConfig</a>. Each
|
|
5133
|
-
* configuration has a specified <code>WeightedCapacity</code>. When a Spot instance
|
|
5134
|
-
* provisioned, the <code>WeightedCapacity</code> units count toward the target capacity.
|
|
5135
|
-
*
|
|
5136
|
-
* this results in an overage. For example, if there are 2 units remaining to fulfill
|
|
5286
|
+
* Instances to provision. When the instance fleet launches, Amazon EMR tries to
|
|
5287
|
+
* provision Spot Instances as specified by <a>InstanceTypeConfig</a>. Each
|
|
5288
|
+
* instance configuration has a specified <code>WeightedCapacity</code>. When a Spot instance
|
|
5289
|
+
* is provisioned, the <code>WeightedCapacity</code> units count toward the target capacity.
|
|
5290
|
+
* Amazon EMR provisions instances until the target capacity is totally fulfilled,
|
|
5291
|
+
* even if this results in an overage. For example, if there are 2 units remaining to fulfill
|
|
5137
5292
|
* capacity, and Amazon EMR can only provision an instance with a
|
|
5138
5293
|
* <code>WeightedCapacity</code> of 5 units, the instance is provisioned, and the target
|
|
5139
5294
|
* capacity is exceeded by 3 units. You can use <a>InstanceFleet$ProvisionedSpotCapacity</a> to determine the Spot capacity units
|
|
@@ -5160,7 +5315,8 @@ export interface InstanceFleet {
|
|
|
5160
5315
|
*/
|
|
5161
5316
|
ProvisionedSpotCapacity?: number;
|
|
5162
5317
|
/**
|
|
5163
|
-
* <p>An array of specifications for the instance types that comprise an instance
|
|
5318
|
+
* <p>An array of specifications for the instance types that comprise an instance
|
|
5319
|
+
* fleet.</p>
|
|
5164
5320
|
*/
|
|
5165
5321
|
InstanceTypeSpecifications?: InstanceTypeSpecification[];
|
|
5166
5322
|
/**
|
|
@@ -5177,8 +5333,8 @@ export declare namespace InstanceFleet {
|
|
|
5177
5333
|
/**
|
|
5178
5334
|
* <p>The configuration that defines an instance fleet.</p>
|
|
5179
5335
|
* <note>
|
|
5180
|
-
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
5181
|
-
* later, excluding 5.0.x versions.</p>
|
|
5336
|
+
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
5337
|
+
* 4.8.0 and later, excluding 5.0.x versions.</p>
|
|
5182
5338
|
* </note>
|
|
5183
5339
|
*/
|
|
5184
5340
|
export interface InstanceFleetConfig {
|
|
@@ -5193,13 +5349,12 @@ export interface InstanceFleetConfig {
|
|
|
5193
5349
|
InstanceFleetType: InstanceFleetType | string | undefined;
|
|
5194
5350
|
/**
|
|
5195
5351
|
* <p>The target capacity of On-Demand units for the instance fleet, which determines how many
|
|
5196
|
-
* On-Demand Instances to provision. When the instance fleet launches, Amazon EMR
|
|
5197
|
-
* provision On-Demand Instances as specified by <a>InstanceTypeConfig</a>. Each
|
|
5198
|
-
*
|
|
5199
|
-
*
|
|
5200
|
-
*
|
|
5201
|
-
*
|
|
5202
|
-
* capacity, and Amazon EMR can only provision an instance with a
|
|
5352
|
+
* On-Demand Instances to provision. When the instance fleet launches, Amazon EMR
|
|
5353
|
+
* tries to provision On-Demand Instances as specified by <a>InstanceTypeConfig</a>. Each instance configuration has a specified <code>WeightedCapacity</code>. When an
|
|
5354
|
+
* On-Demand Instance is provisioned, the <code>WeightedCapacity</code> units count toward the
|
|
5355
|
+
* target capacity. Amazon EMR provisions instances until the target capacity is
|
|
5356
|
+
* totally fulfilled, even if this results in an overage. For example, if there are 2 units
|
|
5357
|
+
* remaining to fulfill capacity, and Amazon EMR can only provision an instance with a
|
|
5203
5358
|
* <code>WeightedCapacity</code> of 5 units, the instance is provisioned, and the target
|
|
5204
5359
|
* capacity is exceeded by 3 units.</p>
|
|
5205
5360
|
* <note>
|
|
@@ -5214,12 +5369,12 @@ export interface InstanceFleetConfig {
|
|
|
5214
5369
|
TargetOnDemandCapacity?: number;
|
|
5215
5370
|
/**
|
|
5216
5371
|
* <p>The target capacity of Spot units for the instance fleet, which determines how many Spot
|
|
5217
|
-
* Instances to provision. When the instance fleet launches, Amazon EMR tries to
|
|
5218
|
-
* Spot Instances as specified by <a>InstanceTypeConfig</a>. Each
|
|
5219
|
-
* configuration has a specified <code>WeightedCapacity</code>. When a Spot Instance
|
|
5220
|
-
* provisioned, the <code>WeightedCapacity</code> units count toward the target capacity.
|
|
5221
|
-
*
|
|
5222
|
-
* this results in an overage. For example, if there are 2 units remaining to fulfill
|
|
5372
|
+
* Instances to provision. When the instance fleet launches, Amazon EMR tries to
|
|
5373
|
+
* provision Spot Instances as specified by <a>InstanceTypeConfig</a>. Each
|
|
5374
|
+
* instance configuration has a specified <code>WeightedCapacity</code>. When a Spot Instance
|
|
5375
|
+
* is provisioned, the <code>WeightedCapacity</code> units count toward the target capacity.
|
|
5376
|
+
* Amazon EMR provisions instances until the target capacity is totally fulfilled,
|
|
5377
|
+
* even if this results in an overage. For example, if there are 2 units remaining to fulfill
|
|
5223
5378
|
* capacity, and Amazon EMR can only provision an instance with a
|
|
5224
5379
|
* <code>WeightedCapacity</code> of 5 units, the instance is provisioned, and the target
|
|
5225
5380
|
* capacity is exceeded by 3 units.</p>
|
|
@@ -5306,7 +5461,9 @@ export interface InstanceGroup {
|
|
|
5306
5461
|
*/
|
|
5307
5462
|
InstanceGroupType?: InstanceGroupType | string;
|
|
5308
5463
|
/**
|
|
5309
|
-
* <p>If specified, indicates that the instance group uses Spot Instances. This is the maximum
|
|
5464
|
+
* <p>If specified, indicates that the instance group uses Spot Instances. This is the maximum
|
|
5465
|
+
* price you are willing to pay for Spot Instances. Specify <code>OnDemandPrice</code> to set
|
|
5466
|
+
* the amount equal to the On-Demand price, or specify an amount in USD.</p>
|
|
5310
5467
|
*/
|
|
5311
5468
|
BidPrice?: string;
|
|
5312
5469
|
/**
|
|
@@ -5329,8 +5486,9 @@ export interface InstanceGroup {
|
|
|
5329
5486
|
* <note>
|
|
5330
5487
|
* <p>Amazon EMR releases 4.x or later.</p>
|
|
5331
5488
|
* </note>
|
|
5332
|
-
* <p>The list of configurations supplied for an Amazon EMR cluster instance group.
|
|
5333
|
-
* separate configuration for each instance group (master, core, and
|
|
5489
|
+
* <p>The list of configurations supplied for an Amazon EMR cluster instance group.
|
|
5490
|
+
* You can specify a separate configuration for each instance group (master, core, and
|
|
5491
|
+
* task).</p>
|
|
5334
5492
|
*/
|
|
5335
5493
|
Configurations?: Configuration[];
|
|
5336
5494
|
/**
|
|
@@ -5354,8 +5512,7 @@ export interface InstanceGroup {
|
|
|
5354
5512
|
EbsBlockDevices?: EbsBlockDevice[];
|
|
5355
5513
|
/**
|
|
5356
5514
|
* <p>If the instance group is EBS-optimized. An Amazon EBS-optimized instance uses an
|
|
5357
|
-
* optimized configuration stack and provides additional, dedicated capacity for Amazon EBS
|
|
5358
|
-
* I/O.</p>
|
|
5515
|
+
* optimized configuration stack and provides additional, dedicated capacity for Amazon EBS I/O.</p>
|
|
5359
5516
|
*/
|
|
5360
5517
|
EbsOptimized?: boolean;
|
|
5361
5518
|
/**
|
|
@@ -5364,9 +5521,9 @@ export interface InstanceGroup {
|
|
|
5364
5521
|
ShrinkPolicy?: ShrinkPolicy;
|
|
5365
5522
|
/**
|
|
5366
5523
|
* <p>An automatic scaling policy for a core instance group or task instance group in an
|
|
5367
|
-
*
|
|
5368
|
-
* adds and terminates EC2 instances in response to the value of a CloudWatch
|
|
5369
|
-
* PutAutoScalingPolicy.</p>
|
|
5524
|
+
* Amazon EMR cluster. The automatic scaling policy defines how an instance group
|
|
5525
|
+
* dynamically adds and terminates EC2 instances in response to the value of a CloudWatch
|
|
5526
|
+
* metric. See PutAutoScalingPolicy.</p>
|
|
5370
5527
|
*/
|
|
5371
5528
|
AutoScalingPolicy?: AutoScalingPolicyDescription;
|
|
5372
5529
|
/**
|
|
@@ -5416,10 +5573,11 @@ export declare namespace ListInstanceGroupsOutput {
|
|
|
5416
5573
|
const filterSensitiveLog: (obj: ListInstanceGroupsOutput) => any;
|
|
5417
5574
|
}
|
|
5418
5575
|
/**
|
|
5419
|
-
* <p>A description of the Amazon EC2 instance on which the cluster (job flow) runs. A
|
|
5420
|
-
* JobFlowInstancesConfig must contain either InstanceGroups or InstanceFleets. They
|
|
5421
|
-
* used together. You may also have MasterInstanceType, SlaveInstanceType, and
|
|
5422
|
-
* (all three must be present), but we don't recommend this
|
|
5576
|
+
* <p>A description of the Amazon EC2 instance on which the cluster (job flow) runs. A
|
|
5577
|
+
* valid JobFlowInstancesConfig must contain either InstanceGroups or InstanceFleets. They
|
|
5578
|
+
* cannot be used together. You may also have MasterInstanceType, SlaveInstanceType, and
|
|
5579
|
+
* InstanceCount (all three must be present), but we don't recommend this
|
|
5580
|
+
* configuration.</p>
|
|
5423
5581
|
*/
|
|
5424
5582
|
export interface JobFlowInstancesConfig {
|
|
5425
5583
|
/**
|
|
@@ -5440,8 +5598,8 @@ export interface JobFlowInstancesConfig {
|
|
|
5440
5598
|
InstanceGroups?: InstanceGroupConfig[];
|
|
5441
5599
|
/**
|
|
5442
5600
|
* <note>
|
|
5443
|
-
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
5444
|
-
* later, excluding 5.0.x versions.</p>
|
|
5601
|
+
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
5602
|
+
* 4.8.0 and later, excluding 5.0.x versions.</p>
|
|
5445
5603
|
* </note>
|
|
5446
5604
|
* <p>Describes the EC2 instances and instance configurations for clusters that use the
|
|
5447
5605
|
* instance fleet configuration.</p>
|
|
@@ -5457,28 +5615,33 @@ export interface JobFlowInstancesConfig {
|
|
|
5457
5615
|
*/
|
|
5458
5616
|
Placement?: PlacementType;
|
|
5459
5617
|
/**
|
|
5460
|
-
* <p>Specifies whether the cluster should remain available after completing all steps.
|
|
5618
|
+
* <p>Specifies whether the cluster should remain available after completing all steps.
|
|
5619
|
+
* Defaults to <code>true</code>. For more information about configuring cluster termination,
|
|
5620
|
+
* see <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-termination.html">Control Cluster Termination</a> in the <i>EMR Management
|
|
5621
|
+
* Guide</i>.</p>
|
|
5461
5622
|
*/
|
|
5462
5623
|
KeepJobFlowAliveWhenNoSteps?: boolean;
|
|
5463
5624
|
/**
|
|
5464
|
-
* <p>Specifies whether to lock the cluster to prevent the Amazon EC2 instances from
|
|
5465
|
-
* terminated by API call, user intervention, or in the event of a job-flow
|
|
5625
|
+
* <p>Specifies whether to lock the cluster to prevent the Amazon EC2 instances from
|
|
5626
|
+
* being terminated by API call, user intervention, or in the event of a job-flow
|
|
5627
|
+
* error.</p>
|
|
5466
5628
|
*/
|
|
5467
5629
|
TerminationProtected?: boolean;
|
|
5468
5630
|
/**
|
|
5469
|
-
* <p>Applies only to Amazon EMR release versions earlier than 4.0. The Hadoop version
|
|
5470
|
-
* cluster. Valid inputs are "0.18" (no longer maintained), "0.20" (no longer
|
|
5471
|
-
* "0.20.205" (no longer maintained), "1.0.3", "2.2.0", or "2.4.0". If you do not
|
|
5472
|
-
* value, the default of 0.18 is used, unless the <code>AmiVersion</code> parameter
|
|
5473
|
-
* the RunJobFlow call, in which case the default version of Hadoop for that AMI
|
|
5474
|
-
* used.</p>
|
|
5631
|
+
* <p>Applies only to Amazon EMR release versions earlier than 4.0. The Hadoop version
|
|
5632
|
+
* for the cluster. Valid inputs are "0.18" (no longer maintained), "0.20" (no longer
|
|
5633
|
+
* maintained), "0.20.205" (no longer maintained), "1.0.3", "2.2.0", or "2.4.0". If you do not
|
|
5634
|
+
* set this value, the default of 0.18 is used, unless the <code>AmiVersion</code> parameter
|
|
5635
|
+
* is set in the RunJobFlow call, in which case the default version of Hadoop for that AMI
|
|
5636
|
+
* version is used.</p>
|
|
5475
5637
|
*/
|
|
5476
5638
|
HadoopVersion?: string;
|
|
5477
5639
|
/**
|
|
5478
5640
|
* <p>Applies to clusters that use the uniform instance group configuration. To launch the
|
|
5479
|
-
* cluster in Amazon Virtual Private Cloud (Amazon VPC), set this parameter to the
|
|
5480
|
-
* of the Amazon VPC subnet where you want the cluster to launch. If you do
|
|
5481
|
-
* value and your account supports EC2-Classic, the cluster launches in
|
|
5641
|
+
* cluster in Amazon Virtual Private Cloud (Amazon VPC), set this parameter to the
|
|
5642
|
+
* identifier of the Amazon VPC subnet where you want the cluster to launch. If you do
|
|
5643
|
+
* not specify this value and your account supports EC2-Classic, the cluster launches in
|
|
5644
|
+
* EC2-Classic.</p>
|
|
5482
5645
|
*/
|
|
5483
5646
|
Ec2SubnetId?: string;
|
|
5484
5647
|
/**
|
|
@@ -5486,22 +5649,26 @@ export interface JobFlowInstancesConfig {
|
|
|
5486
5649
|
* IDs are specified, Amazon EMR evaluates them and launches instances in the optimal
|
|
5487
5650
|
* subnet.</p>
|
|
5488
5651
|
* <note>
|
|
5489
|
-
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
5490
|
-
* later, excluding 5.0.x versions.</p>
|
|
5652
|
+
* <p>The instance fleet configuration is available only in Amazon EMR versions
|
|
5653
|
+
* 4.8.0 and later, excluding 5.0.x versions.</p>
|
|
5491
5654
|
* </note>
|
|
5492
5655
|
*/
|
|
5493
5656
|
Ec2SubnetIds?: string[];
|
|
5494
5657
|
/**
|
|
5495
|
-
* <p>The identifier of the Amazon EC2 security group for the master node. If you
|
|
5658
|
+
* <p>The identifier of the Amazon EC2 security group for the master node. If you
|
|
5659
|
+
* specify <code>EmrManagedMasterSecurityGroup</code>, you must also specify
|
|
5660
|
+
* <code>EmrManagedSlaveSecurityGroup</code>.</p>
|
|
5496
5661
|
*/
|
|
5497
5662
|
EmrManagedMasterSecurityGroup?: string;
|
|
5498
5663
|
/**
|
|
5499
|
-
* <p>The identifier of the Amazon EC2 security group for the core and task nodes. If
|
|
5664
|
+
* <p>The identifier of the Amazon EC2 security group for the core and task nodes. If
|
|
5665
|
+
* you specify <code>EmrManagedSlaveSecurityGroup</code>, you must also specify
|
|
5666
|
+
* <code>EmrManagedMasterSecurityGroup</code>.</p>
|
|
5500
5667
|
*/
|
|
5501
5668
|
EmrManagedSlaveSecurityGroup?: string;
|
|
5502
5669
|
/**
|
|
5503
|
-
* <p>The identifier of the Amazon EC2 security group for the Amazon EMR
|
|
5504
|
-
* clusters in VPC private subnets.</p>
|
|
5670
|
+
* <p>The identifier of the Amazon EC2 security group for the Amazon EMR
|
|
5671
|
+
* service to access clusters in VPC private subnets.</p>
|
|
5505
5672
|
*/
|
|
5506
5673
|
ServiceAccessSecurityGroup?: string;
|
|
5507
5674
|
/**
|
|
@@ -5509,7 +5676,8 @@ export interface JobFlowInstancesConfig {
|
|
|
5509
5676
|
*/
|
|
5510
5677
|
AdditionalMasterSecurityGroups?: string[];
|
|
5511
5678
|
/**
|
|
5512
|
-
* <p>A list of additional Amazon EC2 security group IDs for the core and task
|
|
5679
|
+
* <p>A list of additional Amazon EC2 security group IDs for the core and task
|
|
5680
|
+
* nodes.</p>
|
|
5513
5681
|
*/
|
|
5514
5682
|
AdditionalSlaveSecurityGroups?: string[];
|
|
5515
5683
|
}
|
|
@@ -5528,14 +5696,14 @@ export interface RunJobFlowInput {
|
|
|
5528
5696
|
*/
|
|
5529
5697
|
Name: string | undefined;
|
|
5530
5698
|
/**
|
|
5531
|
-
* <p>The location in Amazon S3 to write the log files of the job flow. If a value is
|
|
5532
|
-
* provided, logs are not created.</p>
|
|
5699
|
+
* <p>The location in Amazon S3 to write the log files of the job flow. If a value is
|
|
5700
|
+
* not provided, logs are not created.</p>
|
|
5533
5701
|
*/
|
|
5534
5702
|
LogUri?: string;
|
|
5535
5703
|
/**
|
|
5536
5704
|
* <p>The KMS key used for encrypting log files. If a value is not
|
|
5537
5705
|
* provided, the logs remain encrypted by AES-256. This attribute is only available with
|
|
5538
|
-
*
|
|
5706
|
+
* Amazon EMR version 5.30.0 and later, excluding Amazon EMR 6.0.0.</p>
|
|
5539
5707
|
*/
|
|
5540
5708
|
LogEncryptionKmsKeyId?: string;
|
|
5541
5709
|
/**
|
|
@@ -5543,19 +5711,18 @@ export interface RunJobFlowInput {
|
|
|
5543
5711
|
*/
|
|
5544
5712
|
AdditionalInfo?: string;
|
|
5545
5713
|
/**
|
|
5546
|
-
* <p>Applies only to Amazon EMR AMI versions 3.x and 2.x. For Amazon EMR
|
|
5547
|
-
* later, <code>ReleaseLabel</code> is used. To specify a custom AMI, use
|
|
5714
|
+
* <p>Applies only to Amazon EMR AMI versions 3.x and 2.x. For Amazon EMR
|
|
5715
|
+
* releases 4.0 and later, <code>ReleaseLabel</code> is used. To specify a custom AMI, use
|
|
5548
5716
|
* <code>CustomAmiID</code>.</p>
|
|
5549
5717
|
*/
|
|
5550
5718
|
AmiVersion?: string;
|
|
5551
5719
|
/**
|
|
5552
|
-
* <p>The Amazon EMR release label, which determines the version of open-source
|
|
5553
|
-
* packages installed on the cluster. Release labels are in the form
|
|
5554
|
-
*
|
|
5555
|
-
*
|
|
5556
|
-
* features, see <a href="https://docs.aws.amazon.com/emr/latest/ReleaseGuide/">https://docs.aws.amazon.com/emr/latest/ReleaseGuide/</a>. The release
|
|
5557
|
-
*
|
|
5558
|
-
* <code>AmiVersion</code>.</p>
|
|
5720
|
+
* <p>The Amazon EMR release label, which determines the version of open-source
|
|
5721
|
+
* application packages installed on the cluster. Release labels are in the form
|
|
5722
|
+
* <code>emr-x.x.x</code>, where x.x.x is an Amazon EMR release version such as
|
|
5723
|
+
* <code>emr-5.14.0</code>. For more information about Amazon EMR release versions
|
|
5724
|
+
* and included application versions and features, see <a href="https://docs.aws.amazon.com/emr/latest/ReleaseGuide/">https://docs.aws.amazon.com/emr/latest/ReleaseGuide/</a>. The release label applies only to Amazon EMR
|
|
5725
|
+
* releases version 4.0 and later. Earlier versions use <code>AmiVersion</code>.</p>
|
|
5559
5726
|
*/
|
|
5560
5727
|
ReleaseLabel?: string;
|
|
5561
5728
|
/**
|
|
@@ -5572,12 +5739,11 @@ export interface RunJobFlowInput {
|
|
|
5572
5739
|
BootstrapActions?: BootstrapActionConfig[];
|
|
5573
5740
|
/**
|
|
5574
5741
|
* <note>
|
|
5575
|
-
* <p>For Amazon EMR releases 3.x and 2.x. For Amazon EMR releases 4.x and
|
|
5576
|
-
* Applications.</p>
|
|
5742
|
+
* <p>For Amazon EMR releases 3.x and 2.x. For Amazon EMR releases 4.x and
|
|
5743
|
+
* later, use Applications.</p>
|
|
5577
5744
|
* </note>
|
|
5578
5745
|
* <p>A list of strings that indicates third-party software to use. For more information, see
|
|
5579
|
-
* the <a href="https://docs.aws.amazon.com/emr/latest/DeveloperGuide/emr-dg.pdf">Amazon EMR
|
|
5580
|
-
* Developer Guide</a>. Currently supported values are:</p>
|
|
5746
|
+
* the <a href="https://docs.aws.amazon.com/emr/latest/DeveloperGuide/emr-dg.pdf">Amazon EMR Developer Guide</a>. Currently supported values are:</p>
|
|
5581
5747
|
* <ul>
|
|
5582
5748
|
* <li>
|
|
5583
5749
|
* <p>"mapr-m3" - launch the job flow using MapR M3 Edition.</p>
|
|
@@ -5590,14 +5756,14 @@ export interface RunJobFlowInput {
|
|
|
5590
5756
|
SupportedProducts?: string[];
|
|
5591
5757
|
/**
|
|
5592
5758
|
* <note>
|
|
5593
|
-
* <p>For Amazon EMR releases 3.x and 2.x. For Amazon EMR releases 4.x and
|
|
5594
|
-
* Applications.</p>
|
|
5759
|
+
* <p>For Amazon EMR releases 3.x and 2.x. For Amazon EMR releases 4.x and
|
|
5760
|
+
* later, use Applications.</p>
|
|
5595
5761
|
* </note>
|
|
5596
5762
|
* <p>A list of strings that indicates third-party software to use with the job flow that
|
|
5597
5763
|
* accepts a user argument list. EMR accepts and forwards the argument list to the
|
|
5598
5764
|
* corresponding installation script as bootstrap action arguments. For more information, see
|
|
5599
|
-
* "Launch a Job Flow on the MapR Distribution for Hadoop" in the <a href="https://docs.aws.amazon.com/emr/latest/DeveloperGuide/emr-dg.pdf">Amazon EMR Developer Guide</a>.
|
|
5600
|
-
* values are:</p>
|
|
5765
|
+
* "Launch a Job Flow on the MapR Distribution for Hadoop" in the <a href="https://docs.aws.amazon.com/emr/latest/DeveloperGuide/emr-dg.pdf">Amazon EMR Developer Guide</a>.
|
|
5766
|
+
* Supported values are:</p>
|
|
5601
5767
|
* <ul>
|
|
5602
5768
|
* <li>
|
|
5603
5769
|
* <p>"mapr-m3" - launch the cluster using MapR M3 Edition.</p>
|
|
@@ -5629,23 +5795,32 @@ export interface RunJobFlowInput {
|
|
|
5629
5795
|
*/
|
|
5630
5796
|
NewSupportedProducts?: SupportedProductConfig[];
|
|
5631
5797
|
/**
|
|
5632
|
-
* <p>Applies to Amazon EMR releases 4.0 and later. A case-insensitive list of
|
|
5633
|
-
* for Amazon EMR to install and configure when launching the cluster.
|
|
5634
|
-
* applications available for each Amazon EMR release version, see the
|
|
5635
|
-
*
|
|
5798
|
+
* <p>Applies to Amazon EMR releases 4.0 and later. A case-insensitive list of
|
|
5799
|
+
* applications for Amazon EMR to install and configure when launching the cluster.
|
|
5800
|
+
* For a list of applications available for each Amazon EMR release version, see the
|
|
5801
|
+
* <a href="https://docs.aws.amazon.com/emr/latest/ReleaseGuide/">Amazon EMRRelease
|
|
5802
|
+
* Guide</a>.</p>
|
|
5636
5803
|
*/
|
|
5637
5804
|
Applications?: Application[];
|
|
5638
5805
|
/**
|
|
5639
|
-
* <p>For Amazon EMR releases 4.0 and later. The list of configurations supplied for
|
|
5640
|
-
* cluster you are creating.</p>
|
|
5806
|
+
* <p>For Amazon EMR releases 4.0 and later. The list of configurations supplied for
|
|
5807
|
+
* the EMR cluster you are creating.</p>
|
|
5641
5808
|
*/
|
|
5642
5809
|
Configurations?: Configuration[];
|
|
5643
5810
|
/**
|
|
5644
5811
|
* <important>
|
|
5645
|
-
* <p>The VisibleToAllUsers parameter is no longer supported. By default, the value is set
|
|
5812
|
+
* <p>The VisibleToAllUsers parameter is no longer supported. By default, the value is set
|
|
5813
|
+
* to <code>true</code>. Setting it to <code>false</code> now has no effect.</p>
|
|
5646
5814
|
* </important>
|
|
5647
|
-
* <p>Set this value to <code>true</code> so that IAM principals in the Amazon Web Services account associated with the cluster can perform EMR actions on the cluster
|
|
5648
|
-
*
|
|
5815
|
+
* <p>Set this value to <code>true</code> so that IAM principals in the Amazon Web Services account associated with the cluster can perform EMR actions on the cluster
|
|
5816
|
+
* that their IAM policies allow. This value defaults to <code>true</code> for clusters
|
|
5817
|
+
* created using the EMR API or the CLI
|
|
5818
|
+
* <a href="https://docs.aws.amazon.com/cli/latest/reference/emr/create-cluster.html">create-cluster</a> command.</p>
|
|
5819
|
+
* <p>When set to <code>false</code>, only the IAM principal that created the cluster and the
|
|
5820
|
+
* Amazon Web Services account root user can perform EMR actions for the cluster, regardless
|
|
5821
|
+
* of the IAM permissions policies attached to other IAM principals. For more information, see
|
|
5822
|
+
* <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/security_iam_emr-with-iam.html#security_set_visible_to_all_users">Understanding the EMR Cluster VisibleToAllUsers Setting</a> in the
|
|
5823
|
+
* <i>Amazon EMRManagement Guide</i>.</p>
|
|
5649
5824
|
*/
|
|
5650
5825
|
VisibleToAllUsers?: boolean;
|
|
5651
5826
|
/**
|
|
@@ -5656,12 +5831,13 @@ export interface RunJobFlowInput {
|
|
|
5656
5831
|
*/
|
|
5657
5832
|
JobFlowRole?: string;
|
|
5658
5833
|
/**
|
|
5659
|
-
* <p>The IAM role that Amazon EMR assumes in order to access Amazon Web Services
|
|
5660
|
-
* your behalf.</p>
|
|
5834
|
+
* <p>The IAM role that Amazon EMR assumes in order to access Amazon Web Services
|
|
5835
|
+
* resources on your behalf.</p>
|
|
5661
5836
|
*/
|
|
5662
5837
|
ServiceRole?: string;
|
|
5663
5838
|
/**
|
|
5664
|
-
* <p>A list of tags to associate with a cluster and propagate to Amazon EC2
|
|
5839
|
+
* <p>A list of tags to associate with a cluster and propagate to Amazon EC2
|
|
5840
|
+
* instances.</p>
|
|
5665
5841
|
*/
|
|
5666
5842
|
Tags?: Tag[];
|
|
5667
5843
|
/**
|
|
@@ -5676,36 +5852,34 @@ export interface RunJobFlowInput {
|
|
|
5676
5852
|
*/
|
|
5677
5853
|
AutoScalingRole?: string;
|
|
5678
5854
|
/**
|
|
5679
|
-
* <p>Specifies the way that individual Amazon EC2 instances terminate when an
|
|
5680
|
-
* scale-in activity occurs or an instance group is resized.
|
|
5681
|
-
* <code>TERMINATE_AT_INSTANCE_HOUR</code> indicates that Amazon EMR terminates
|
|
5682
|
-
* the instance-hour boundary, regardless of when the request to terminate the
|
|
5683
|
-
* submitted. This option is only available with Amazon EMR 5.1.0 and
|
|
5684
|
-
* for clusters created using that version.
|
|
5685
|
-
*
|
|
5686
|
-
*
|
|
5687
|
-
* behavior, Amazon EMR removes the least active nodes first and blocks instance termination
|
|
5688
|
-
*
|
|
5689
|
-
* only in Amazon EMR version 4.1.0 and later, and is the default for versions of Amazon EMR
|
|
5690
|
-
* earlier than 5.1.0.</p>
|
|
5855
|
+
* <p>Specifies the way that individual Amazon EC2 instances terminate when an
|
|
5856
|
+
* automatic scale-in activity occurs or an instance group is resized.
|
|
5857
|
+
* <code>TERMINATE_AT_INSTANCE_HOUR</code> indicates that Amazon EMR terminates
|
|
5858
|
+
* nodes at the instance-hour boundary, regardless of when the request to terminate the
|
|
5859
|
+
* instance was submitted. This option is only available with Amazon EMR 5.1.0 and
|
|
5860
|
+
* later and is the default for clusters created using that version.
|
|
5861
|
+
* <code>TERMINATE_AT_TASK_COMPLETION</code> indicates that Amazon EMR adds nodes
|
|
5862
|
+
* to a deny list and drains tasks from nodes before terminating the Amazon EC2
|
|
5863
|
+
* instances, regardless of the instance-hour boundary. With either behavior, Amazon EMR removes the least active nodes first and blocks instance termination if it could lead to
|
|
5864
|
+
* HDFS corruption. <code>TERMINATE_AT_TASK_COMPLETION</code> available only in Amazon EMR version 4.1.0 and later, and is the default for versions of Amazon EMR earlier than 5.1.0.</p>
|
|
5691
5865
|
*/
|
|
5692
5866
|
ScaleDownBehavior?: ScaleDownBehavior | string;
|
|
5693
5867
|
/**
|
|
5694
5868
|
* <p>Available only in Amazon EMR version 5.7.0 and later. The ID of a custom Amazon
|
|
5695
|
-
* EBS-backed Linux AMI. If specified, Amazon EMR uses this AMI when it launches
|
|
5696
|
-
* instances. For more information about custom AMIs in Amazon EMR, see
|
|
5697
|
-
*
|
|
5698
|
-
*
|
|
5699
|
-
*
|
|
5700
|
-
*
|
|
5701
|
-
*
|
|
5869
|
+
* EBS-backed Linux AMI. If specified, Amazon EMR uses this AMI when it launches
|
|
5870
|
+
* cluster EC2 instances. For more information about custom AMIs in Amazon EMR, see
|
|
5871
|
+
* <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-custom-ami.html">Using a
|
|
5872
|
+
* Custom AMI</a> in the <i>Amazon EMR Management Guide</i>. If
|
|
5873
|
+
* omitted, the cluster uses the base Linux AMI for the <code>ReleaseLabel</code> specified.
|
|
5874
|
+
* For Amazon EMR versions 2.x and 3.x, use <code>AmiVersion</code> instead.</p>
|
|
5875
|
+
* <p>For information about creating a custom AMI, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/creating-an-ami-ebs.html">Creating an Amazon EBS-Backed Linux AMI</a> in the <i>Amazon Elastic Compute Cloud User Guide for Linux
|
|
5702
5876
|
* Instances</i>. For information about finding an AMI ID, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html">Finding a Linux
|
|
5703
5877
|
* AMI</a>. </p>
|
|
5704
5878
|
*/
|
|
5705
5879
|
CustomAmiId?: string;
|
|
5706
5880
|
/**
|
|
5707
|
-
* <p>The size, in GiB, of the Amazon EBS root device volume of the Linux AMI that is
|
|
5708
|
-
* each EC2 instance. Available in Amazon EMR version 4.x and later.</p>
|
|
5881
|
+
* <p>The size, in GiB, of the Amazon EBS root device volume of the Linux AMI that is
|
|
5882
|
+
* used for each EC2 instance. Available in Amazon EMR version 4.x and later.</p>
|
|
5709
5883
|
*/
|
|
5710
5884
|
EbsRootVolumeSize?: number;
|
|
5711
5885
|
/**
|
|
@@ -5736,9 +5910,16 @@ export interface RunJobFlowInput {
|
|
|
5736
5910
|
*/
|
|
5737
5911
|
PlacementGroupConfigs?: PlacementGroupConfig[];
|
|
5738
5912
|
/**
|
|
5739
|
-
* <p>An auto-termination policy for an Amazon EMR cluster. An auto-termination policy
|
|
5913
|
+
* <p>An auto-termination policy for an Amazon EMR cluster. An auto-termination policy
|
|
5914
|
+
* defines the amount of idle time in seconds after which a cluster automatically terminates.
|
|
5915
|
+
* For alternative cluster termination options, see <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-termination.html">Control cluster
|
|
5916
|
+
* termination</a>.</p>
|
|
5740
5917
|
*/
|
|
5741
5918
|
AutoTerminationPolicy?: AutoTerminationPolicy;
|
|
5919
|
+
/**
|
|
5920
|
+
* <p>Specifies a particular Amazon Linux release for all nodes in a cluster launch RunJobFlow request. If a release is not specified, Amazon EMR uses the latest validated Amazon Linux release for cluster launch.</p>
|
|
5921
|
+
*/
|
|
5922
|
+
OSReleaseLabel?: string;
|
|
5742
5923
|
}
|
|
5743
5924
|
export declare namespace RunJobFlowInput {
|
|
5744
5925
|
/**
|