@horietakehiro/aws-cdk-utul 0.41.83 → 0.41.85
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/lib/types/cfn-resource-types/aws-appstream-imagebuilder.d.ts +10 -2
- package/lib/types/cfn-resource-types/aws-appstream-imagebuilder.js +1 -1
- package/lib/types/cfn-resource-types/aws-batch-quotashare.d.ts +69 -0
- package/lib/types/cfn-resource-types/aws-batch-quotashare.js +3 -0
- package/lib/types/cfn-resource-types/aws-bedrockagentcore-gateway.d.ts +15 -0
- package/lib/types/cfn-resource-types/aws-bedrockagentcore-gateway.js +1 -1
- package/lib/types/cfn-resource-types/aws-cloudfront-anycastiplist.d.ts +36 -0
- package/lib/types/cfn-resource-types/aws-cloudfront-anycastiplist.js +1 -1
- package/lib/types/cfn-resource-types/aws-cloudfront-connectionfunction.d.ts +42 -1
- package/lib/types/cfn-resource-types/aws-cloudfront-connectionfunction.js +1 -1
- package/lib/types/cfn-resource-types/aws-cloudfront-distribution.d.ts +33 -0
- package/lib/types/cfn-resource-types/aws-cloudfront-distribution.js +1 -1
- package/lib/types/cfn-resource-types/aws-cloudfront-truststore.d.ts +24 -22
- package/lib/types/cfn-resource-types/aws-cloudfront-truststore.js +1 -1
- package/lib/types/cfn-resource-types/aws-ec2-instanceconnectendpoint.d.ts +80 -6
- package/lib/types/cfn-resource-types/aws-ec2-instanceconnectendpoint.js +1 -1
- package/lib/types/cfn-resource-types/aws-ec2-sqlhastandbydetectedinstance.d.ts +30 -0
- package/lib/types/cfn-resource-types/aws-ec2-sqlhastandbydetectedinstance.js +3 -0
- package/lib/types/cfn-resource-types/aws-ecs-capacityprovider.d.ts +0 -1
- package/lib/types/cfn-resource-types/aws-ecs-capacityprovider.js +1 -1
- package/lib/types/cfn-resource-types/aws-elasticloadbalancing-loadbalancer.d.ts +37 -207
- package/lib/types/cfn-resource-types/aws-elasticloadbalancing-loadbalancer.js +1 -1
- package/lib/types/cfn-resource-types/aws-emr-cluster.d.ts +669 -154
- package/lib/types/cfn-resource-types/aws-emr-cluster.js +1 -1
- package/lib/types/cfn-resource-types/aws-interconnect-connection.d.ts +98 -0
- package/lib/types/cfn-resource-types/aws-interconnect-connection.js +3 -0
- package/lib/types/cfn-resource-types/aws-logs-loggroup.d.ts +1 -0
- package/lib/types/cfn-resource-types/aws-logs-loggroup.js +1 -1
- package/lib/types/cfn-resource-types/aws-medialive-channel.d.ts +4 -0
- package/lib/types/cfn-resource-types/aws-medialive-channel.js +1 -1
- package/lib/types/cfn-resource-types/aws-observabilityadmin-organizationcentralizationrule.d.ts +2 -1
- package/lib/types/cfn-resource-types/aws-observabilityadmin-organizationcentralizationrule.js +1 -1
- package/lib/types/cfn-resource-types/aws-opensearchserverless-collection.d.ts +11 -0
- package/lib/types/cfn-resource-types/aws-opensearchserverless-collection.js +1 -1
- package/lib/types/cfn-resource-types/aws-quicksight-custompermissions.d.ts +217 -36
- package/lib/types/cfn-resource-types/aws-quicksight-custompermissions.js +1 -1
- package/lib/types/cfn-resource-types/aws-uxc-accountcustomization.d.ts +25 -0
- package/lib/types/cfn-resource-types/aws-uxc-accountcustomization.js +3 -0
- package/lib/types/cfn-resource-types.d.ts +8 -0
- package/lib/types/cfn-resource-types.js +38 -30
- package/package.json +1 -1
|
@@ -2,251 +2,766 @@
|
|
|
2
2
|
* Resource Type definition for AWS::EMR::Cluster
|
|
3
3
|
*/
|
|
4
4
|
export interface _AWS_EMR_CLUSTER {
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
EbsRootVolumeSize?: number;
|
|
9
|
-
OSReleaseLabel?: string;
|
|
10
|
-
Name: string;
|
|
11
|
-
ServiceRole: string;
|
|
12
|
-
LogUri?: string;
|
|
13
|
-
BootstrapActions?: BootstrapActionConfig[];
|
|
5
|
+
/**
|
|
6
|
+
* The public DNS name of the master node (instance), such as ec2-12-123-123-123.us-west-2.compute.amazonaws.com.
|
|
7
|
+
*/
|
|
14
8
|
MasterPublicDNS?: string;
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
LogEncryptionKmsKeyId?: string;
|
|
20
|
-
AdditionalInfo?: {
|
|
9
|
+
/**
|
|
10
|
+
* A JSON string for selecting additional features.
|
|
11
|
+
*/
|
|
12
|
+
AdditionalInfo?: ({
|
|
21
13
|
[k: string]: unknown;
|
|
22
|
-
};
|
|
23
|
-
|
|
24
|
-
|
|
14
|
+
} | string);
|
|
15
|
+
/**
|
|
16
|
+
* The applications installed on this cluster.
|
|
17
|
+
*/
|
|
25
18
|
Applications?: Application[];
|
|
19
|
+
/**
|
|
20
|
+
* An IAM role for automatic scaling policies. The default role is EMR_AutoScaling_DefaultRole. The IAM role provides permissions that the automatic scaling feature requires to launch and terminate EC2 instances in an instance group.
|
|
21
|
+
*/
|
|
26
22
|
AutoScalingRole?: string;
|
|
23
|
+
AutoTerminationPolicy?: AutoTerminationPolicy;
|
|
24
|
+
/**
|
|
25
|
+
* A list of bootstrap actions to run before Hadoop starts on the cluster nodes.
|
|
26
|
+
*/
|
|
27
|
+
BootstrapActions?: BootstrapActionConfig[];
|
|
28
|
+
/**
|
|
29
|
+
* Applies only to Amazon EMR releases 4.x and later. The list of Configurations supplied to the EMR cluster.
|
|
30
|
+
*/
|
|
31
|
+
Configurations?: EMRConfiguration[];
|
|
32
|
+
/**
|
|
33
|
+
* Available only in Amazon EMR version 5.7.0 and later. The ID of a custom Amazon EBS-backed Linux AMI if the cluster uses a custom AMI.
|
|
34
|
+
*/
|
|
27
35
|
CustomAmiId?: string;
|
|
28
|
-
|
|
36
|
+
/**
|
|
37
|
+
* The size, in GiB, of the Amazon EBS root device volume of the Linux AMI that is used for each EC2 instance. Available in Amazon EMR version 4.x and later.
|
|
38
|
+
*/
|
|
39
|
+
EbsRootVolumeSize?: number;
|
|
40
|
+
/**
|
|
41
|
+
* The unique identifier for the cluster.
|
|
42
|
+
*/
|
|
43
|
+
Id?: string;
|
|
29
44
|
Instances: JobFlowInstancesConfig;
|
|
30
|
-
|
|
31
|
-
|
|
45
|
+
/**
|
|
46
|
+
* Also called instance profile and EC2 role. An IAM role for an EMR cluster. The EC2 instances of the cluster assume this role. The default role is EMR_EC2_DefaultRole. In order to use the default role, you must have already created it using the CLI or console
|
|
47
|
+
*/
|
|
32
48
|
JobFlowRole: string;
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
StepProperties?: KeyValue[];
|
|
47
|
-
}
|
|
48
|
-
export interface KeyValue {
|
|
49
|
-
Value?: string;
|
|
50
|
-
Key?: string;
|
|
51
|
-
}
|
|
52
|
-
export interface PlacementGroupConfig {
|
|
53
|
-
InstanceRole: string;
|
|
54
|
-
PlacementStrategy?: string;
|
|
55
|
-
}
|
|
56
|
-
export interface BootstrapActionConfig {
|
|
57
|
-
ScriptBootstrapAction: ScriptBootstrapActionConfig;
|
|
49
|
+
KerberosAttributes?: KerberosAttributes;
|
|
50
|
+
/**
|
|
51
|
+
* The AWS KMS key used for encrypting log files. If a value is not provided, the logs remain encrypted by AES-256. This attribute is only available with Amazon EMR version 5.30.0 and later, excluding Amazon EMR 6.0.0.
|
|
52
|
+
*/
|
|
53
|
+
LogEncryptionKmsKeyId?: string;
|
|
54
|
+
/**
|
|
55
|
+
* The location in Amazon S3 to write the log files of the job flow. If a value is not provided, logs are not created.
|
|
56
|
+
*/
|
|
57
|
+
LogUri?: string;
|
|
58
|
+
ManagedScalingPolicy?: ManagedScalingPolicy;
|
|
59
|
+
/**
|
|
60
|
+
* The name of the job flow.
|
|
61
|
+
*/
|
|
58
62
|
Name: string;
|
|
63
|
+
/**
|
|
64
|
+
* The Amazon EMR release label, which determines the version of open-source application packages installed on the cluster. Release labels are in the form emr-x.x.x, where x.x.x is an Amazon EMR release version such as emr-5.14.0.
|
|
65
|
+
*/
|
|
66
|
+
ReleaseLabel?: string;
|
|
67
|
+
/**
|
|
68
|
+
* 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.
|
|
69
|
+
*/
|
|
70
|
+
OSReleaseLabel?: string;
|
|
71
|
+
/**
|
|
72
|
+
* The way that individual Amazon EC2 instances terminate when an automatic scale-in activity occurs or an instance group is resized.
|
|
73
|
+
*/
|
|
74
|
+
ScaleDownBehavior?: ("TERMINATE_AT_INSTANCE_HOUR" | "TERMINATE_AT_TASK_COMPLETION");
|
|
75
|
+
/**
|
|
76
|
+
* The name of the security configuration applied to the cluster.
|
|
77
|
+
*/
|
|
78
|
+
SecurityConfiguration?: string;
|
|
79
|
+
/**
|
|
80
|
+
* The IAM role that Amazon EMR assumes in order to access AWS resources on your behalf.
|
|
81
|
+
*/
|
|
82
|
+
ServiceRole: string;
|
|
83
|
+
/**
|
|
84
|
+
* Specifies the number of steps that can be executed concurrently.
|
|
85
|
+
*/
|
|
86
|
+
StepConcurrencyLevel?: number;
|
|
87
|
+
Steps?: StepConfig[];
|
|
88
|
+
/**
|
|
89
|
+
* Indicates whether the cluster is visible to IAM principals in the AWS account associated with the cluster. When true, IAM principals in the AWS account can perform EMR cluster actions on the cluster that their IAM policies allow. When false, only the IAM principal that created the cluster and the AWS account root user can perform EMR actions, regardless of IAM permissions policies attached to other IAM principals.
|
|
90
|
+
*/
|
|
91
|
+
VisibleToAllUsers?: boolean;
|
|
92
|
+
/**
|
|
93
|
+
* The IOPS, of the Amazon EBS root device volume of the Linux AMI that is used for each Amazon EC2 instance. Available in Amazon EMR releases 6.15.0 and later.
|
|
94
|
+
*/
|
|
95
|
+
EbsRootVolumeIops?: number;
|
|
96
|
+
/**
|
|
97
|
+
* The throughput, in MiB/s, of the Amazon EBS root device volume of the Linux AMI that is used for each Amazon EC2 instance. Available in Amazon EMR releases 6.15.0 and later.
|
|
98
|
+
*/
|
|
99
|
+
EbsRootVolumeThroughput?: number;
|
|
100
|
+
/**
|
|
101
|
+
* The configuration specifies the placement strategy that can be applied to instance roles during cluster creation.
|
|
102
|
+
*/
|
|
103
|
+
PlacementGroupConfigs?: PlacementGroupConfig[];
|
|
104
|
+
Tags?: Tag[];
|
|
105
|
+
MonitoringConfiguration?: MonitoringConfiguration;
|
|
59
106
|
}
|
|
60
|
-
export interface
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
ConfigurationProperties?: {
|
|
107
|
+
export interface Application {
|
|
108
|
+
/**
|
|
109
|
+
* This option is for advanced users only. This is meta information about third-party applications that third-party vendors use for testing purposes.
|
|
110
|
+
*/
|
|
111
|
+
AdditionalInfo?: {
|
|
66
112
|
/**
|
|
67
113
|
* This interface was referenced by `undefined`'s JSON-Schema definition
|
|
68
|
-
* via the `patternProperty` "
|
|
114
|
+
* via the `patternProperty` ".*".
|
|
69
115
|
*/
|
|
70
116
|
[k: string]: string;
|
|
71
117
|
};
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
export interface ComputeLimits {
|
|
85
|
-
MaximumOnDemandCapacityUnits?: number;
|
|
86
|
-
MaximumCapacityUnits: number;
|
|
87
|
-
MaximumCoreCapacityUnits?: number;
|
|
88
|
-
MinimumCapacityUnits: number;
|
|
89
|
-
UnitType: string;
|
|
118
|
+
/**
|
|
119
|
+
* Arguments for Amazon EMR to pass to the application
|
|
120
|
+
*/
|
|
121
|
+
Args?: string[];
|
|
122
|
+
/**
|
|
123
|
+
* The name of the application.
|
|
124
|
+
*/
|
|
125
|
+
Name?: string;
|
|
126
|
+
/**
|
|
127
|
+
* The version of the application.
|
|
128
|
+
*/
|
|
129
|
+
Version?: string;
|
|
90
130
|
}
|
|
131
|
+
/**
|
|
132
|
+
* An auto-termination policy for an Amazon EMR cluster. An auto-termination policy defines the amount of idle time in seconds after which a cluster automatically terminates.
|
|
133
|
+
*/
|
|
91
134
|
export interface AutoTerminationPolicy {
|
|
135
|
+
/**
|
|
136
|
+
* Specifies the amount of idle time in seconds after which the cluster automatically terminates. You can specify a minimum of 60 seconds and a maximum of 604800 seconds (seven days)
|
|
137
|
+
*/
|
|
92
138
|
IdleTimeout?: number;
|
|
93
139
|
}
|
|
94
|
-
export interface
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
140
|
+
export interface BootstrapActionConfig {
|
|
141
|
+
/**
|
|
142
|
+
* The name of the bootstrap action.
|
|
143
|
+
*/
|
|
144
|
+
Name: string;
|
|
145
|
+
ScriptBootstrapAction: ScriptBootstrapActionConfig;
|
|
100
146
|
}
|
|
101
|
-
export interface
|
|
102
|
-
|
|
147
|
+
export interface ScriptBootstrapActionConfig {
|
|
148
|
+
/**
|
|
149
|
+
* A list of command line arguments to pass to the bootstrap action script.
|
|
150
|
+
*/
|
|
151
|
+
Args?: string[];
|
|
152
|
+
/**
|
|
153
|
+
* Location in Amazon S3 of the script to run during a bootstrap action.
|
|
154
|
+
*/
|
|
155
|
+
Path: string;
|
|
156
|
+
}
|
|
157
|
+
export interface EMRConfiguration {
|
|
158
|
+
/**
|
|
159
|
+
* The classification within a configuration.
|
|
160
|
+
*/
|
|
161
|
+
Classification?: string;
|
|
162
|
+
ConfigurationProperties?: {
|
|
103
163
|
/**
|
|
104
164
|
* This interface was referenced by `undefined`'s JSON-Schema definition
|
|
105
|
-
* via the `patternProperty` "
|
|
165
|
+
* via the `patternProperty` ".*".
|
|
106
166
|
*/
|
|
107
167
|
[k: string]: string;
|
|
108
168
|
};
|
|
109
|
-
|
|
110
|
-
Version?: string;
|
|
111
|
-
Name?: string;
|
|
169
|
+
Configurations?: EMRConfiguration[];
|
|
112
170
|
}
|
|
171
|
+
/**
|
|
172
|
+
* A specification of the number and type of Amazon EC2 instances.
|
|
173
|
+
*/
|
|
113
174
|
export interface JobFlowInstancesConfig {
|
|
114
|
-
|
|
175
|
+
/**
|
|
176
|
+
* A list of additional Amazon EC2 security group IDs for the master node.
|
|
177
|
+
*/
|
|
178
|
+
AdditionalMasterSecurityGroups?: string[];
|
|
179
|
+
/**
|
|
180
|
+
* A list of additional Amazon EC2 security group IDs for the core and task nodes.
|
|
181
|
+
*/
|
|
115
182
|
AdditionalSlaveSecurityGroups?: string[];
|
|
116
|
-
|
|
117
|
-
|
|
183
|
+
/**
|
|
184
|
+
* The name of the EC2 key pair that can be used to connect to the master node using SSH as the user called 'hadoop'.
|
|
185
|
+
*/
|
|
186
|
+
Ec2KeyName?: string;
|
|
187
|
+
/**
|
|
188
|
+
* Applies to clusters that use the uniform instance group configuration. To launch the cluster in Amazon Virtual Private Cloud (Amazon VPC), set this parameter to the identifier of the Amazon VPC subnet where you want the cluster to launch. If you do not specify this value and your account supports EC2-Classic, the cluster launches in EC2-Classic.
|
|
189
|
+
*/
|
|
190
|
+
Ec2SubnetId?: string;
|
|
191
|
+
/**
|
|
192
|
+
* Applies to clusters that use the instance fleet configuration. When multiple EC2 subnet IDs are specified, Amazon EMR evaluates them and launches instances in the optimal subnet.
|
|
193
|
+
*/
|
|
118
194
|
Ec2SubnetIds?: string[];
|
|
195
|
+
/**
|
|
196
|
+
* The identifier of the Amazon EC2 security group for the master node. If you specify EmrManagedMasterSecurityGroup, you must also specify EmrManagedSlaveSecurityGroup.
|
|
197
|
+
*/
|
|
198
|
+
EmrManagedMasterSecurityGroup?: string;
|
|
199
|
+
/**
|
|
200
|
+
* The identifier of the Amazon EC2 security group for the core and task nodes. If you specify EmrManagedSlaveSecurityGroup, you must also specify EmrManagedMasterSecurityGroup.
|
|
201
|
+
*/
|
|
202
|
+
EmrManagedSlaveSecurityGroup?: string;
|
|
203
|
+
/**
|
|
204
|
+
* Applies only to Amazon EMR release versions earlier than 4.0. The Hadoop version for the cluster. Valid inputs are "0.18" (no longer maintained), "0.20" (no longer maintained), "0.20.205" (no longer maintained), "1.0.3", "2.2.0", or "2.4.0". If you do not set this value, the default of 0.18 is used, unless the AmiVersion parameter is set in the RunJobFlow call, in which case the default version of Hadoop for that AMI version is used.
|
|
205
|
+
*/
|
|
119
206
|
HadoopVersion?: string;
|
|
120
|
-
|
|
121
|
-
|
|
207
|
+
/**
|
|
208
|
+
* Specifies whether the cluster should remain available after completing all steps. Defaults to true. For more information about configuring cluster termination, see Control Cluster Termination in the EMR Management Guide.
|
|
209
|
+
*/
|
|
122
210
|
KeepJobFlowAliveWhenNoSteps?: boolean;
|
|
123
|
-
|
|
124
|
-
|
|
211
|
+
CoreInstanceFleet?: InstanceFleetConfig;
|
|
212
|
+
MasterInstanceFleet?: InstanceFleetConfig1;
|
|
213
|
+
TaskInstanceFleets?: InstanceFleetConfig1[];
|
|
214
|
+
CoreInstanceGroup?: InstanceGroupConfig;
|
|
215
|
+
MasterInstanceGroup?: InstanceGroupConfig1;
|
|
216
|
+
/**
|
|
217
|
+
* Configuration for the instance groups in a cluster.
|
|
218
|
+
*/
|
|
219
|
+
TaskInstanceGroups?: InstanceGroupConfig2[];
|
|
125
220
|
Placement?: PlacementType;
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
221
|
+
/**
|
|
222
|
+
* The identifier of the Amazon EC2 security group for the Amazon EMR service to access clusters in VPC private subnets.
|
|
223
|
+
*/
|
|
129
224
|
ServiceAccessSecurityGroup?: string;
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
225
|
+
/**
|
|
226
|
+
* Specifies whether to lock the cluster to prevent the Amazon EC2 instances from being terminated by API call, user intervention, or in the event of a job-flow error.
|
|
227
|
+
*/
|
|
228
|
+
TerminationProtected?: boolean;
|
|
229
|
+
/**
|
|
230
|
+
* Indicates whether Amazon EMR should gracefully replace core nodes that have degraded within the cluster.
|
|
231
|
+
*/
|
|
232
|
+
UnhealthyNodeReplacement?: boolean;
|
|
133
233
|
}
|
|
134
234
|
export interface InstanceFleetConfig {
|
|
135
|
-
|
|
136
|
-
TargetSpotCapacity?: number;
|
|
235
|
+
InstanceTypeConfigs?: InstanceTypeConfig[];
|
|
137
236
|
LaunchSpecifications?: InstanceFleetProvisioningSpecifications;
|
|
138
237
|
ResizeSpecifications?: InstanceFleetResizingSpecifications;
|
|
139
|
-
|
|
238
|
+
/**
|
|
239
|
+
* The friendly name of the instance fleet.
|
|
240
|
+
*/
|
|
140
241
|
Name?: string;
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
TimeoutAction: string;
|
|
150
|
-
BlockDurationMinutes?: number;
|
|
151
|
-
}
|
|
152
|
-
export interface OnDemandProvisioningSpecification {
|
|
153
|
-
CapacityReservationOptions?: OnDemandCapacityReservationOptions;
|
|
154
|
-
AllocationStrategy: string;
|
|
155
|
-
}
|
|
156
|
-
export interface OnDemandCapacityReservationOptions {
|
|
157
|
-
UsageStrategy?: string;
|
|
158
|
-
CapacityReservationResourceGroupArn?: string;
|
|
159
|
-
CapacityReservationPreference?: string;
|
|
160
|
-
}
|
|
161
|
-
export interface InstanceFleetResizingSpecifications {
|
|
162
|
-
OnDemandResizeSpecification?: OnDemandResizingSpecification;
|
|
163
|
-
SpotResizeSpecification?: SpotResizingSpecification;
|
|
164
|
-
}
|
|
165
|
-
export interface OnDemandResizingSpecification {
|
|
166
|
-
CapacityReservationOptions?: OnDemandCapacityReservationOptions;
|
|
167
|
-
AllocationStrategy?: string;
|
|
168
|
-
TimeoutDurationMinutes?: number;
|
|
169
|
-
}
|
|
170
|
-
export interface SpotResizingSpecification {
|
|
171
|
-
AllocationStrategy?: string;
|
|
172
|
-
TimeoutDurationMinutes?: number;
|
|
242
|
+
/**
|
|
243
|
+
* The target capacity of On-Demand units for the instance fleet, which determines how many On-Demand Instances to provision
|
|
244
|
+
*/
|
|
245
|
+
TargetOnDemandCapacity?: number;
|
|
246
|
+
/**
|
|
247
|
+
* The target capacity of Spot units for the instance fleet, which determines how many Spot Instances to provision.
|
|
248
|
+
*/
|
|
249
|
+
TargetSpotCapacity?: number;
|
|
173
250
|
}
|
|
174
251
|
export interface InstanceTypeConfig {
|
|
252
|
+
/**
|
|
253
|
+
* The bid price for each EC2 Spot Instance type as defined by InstanceType. Expressed in USD. If neither BidPrice nor BidPriceAsPercentageOfOnDemandPrice is provided, BidPriceAsPercentageOfOnDemandPrice defaults to 100%.
|
|
254
|
+
*/
|
|
175
255
|
BidPrice?: string;
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
256
|
+
/**
|
|
257
|
+
* The bid price, as a percentage of On-Demand price, for each EC2 Spot Instance as defined by InstanceType. Expressed as a number (for example, 20 specifies 20%). If neither BidPrice nor BidPriceAsPercentageOfOnDemandPrice is provided, BidPriceAsPercentageOfOnDemandPrice defaults to 100%.
|
|
258
|
+
*/
|
|
179
259
|
BidPriceAsPercentageOfOnDemandPrice?: number;
|
|
260
|
+
/**
|
|
261
|
+
* A configuration classification that applies when provisioning cluster instances, which can include configurations for applications and software that run on the cluster.
|
|
262
|
+
*/
|
|
263
|
+
Configurations?: EMRConfiguration[];
|
|
264
|
+
/**
|
|
265
|
+
* The custom AMI ID to use for the instance type.
|
|
266
|
+
*/
|
|
180
267
|
CustomAmiId?: string;
|
|
181
|
-
|
|
268
|
+
EbsConfiguration?: EbsConfiguration;
|
|
269
|
+
/**
|
|
270
|
+
* An EC2 instance type, such as m3.xlarge.
|
|
271
|
+
*/
|
|
182
272
|
InstanceType: string;
|
|
273
|
+
/**
|
|
274
|
+
* The priority at which Amazon EMR launches the Amazon EC2 instances with this instance type. Priority starts at 0, which is the highest priority. Amazon EMR considers the highest priority first.
|
|
275
|
+
*/
|
|
276
|
+
Priority?: number;
|
|
277
|
+
/**
|
|
278
|
+
* The number of units that a provisioned instance of this type provides toward fulfilling the target capacities defined in InstanceFleetConfig. This value is 1 for a master instance fleet, and must be 1 or greater for core and task instance fleets. Defaults to 1 if not specified.
|
|
279
|
+
*/
|
|
280
|
+
WeightedCapacity?: number;
|
|
183
281
|
}
|
|
282
|
+
/**
|
|
283
|
+
* The configuration of Amazon Elastic Block Store (Amazon EBS) attached to each instance as defined by InstanceType.
|
|
284
|
+
*/
|
|
184
285
|
export interface EbsConfiguration {
|
|
185
286
|
EbsBlockDeviceConfigs?: EbsBlockDeviceConfig[];
|
|
287
|
+
/**
|
|
288
|
+
* Indicates whether an Amazon EBS volume is EBS-optimized.
|
|
289
|
+
*/
|
|
186
290
|
EbsOptimized?: boolean;
|
|
187
291
|
}
|
|
188
292
|
export interface EbsBlockDeviceConfig {
|
|
189
293
|
VolumeSpecification: VolumeSpecification;
|
|
294
|
+
/**
|
|
295
|
+
* Number of EBS volumes with a specific volume configuration that are associated with every instance in the instance group
|
|
296
|
+
*/
|
|
190
297
|
VolumesPerInstance?: number;
|
|
191
298
|
}
|
|
192
299
|
export interface VolumeSpecification {
|
|
300
|
+
/**
|
|
301
|
+
* The number of I/O operations per second (IOPS) that the volume supports.
|
|
302
|
+
*/
|
|
303
|
+
Iops?: number;
|
|
304
|
+
/**
|
|
305
|
+
* The volume size, in gibibytes (GiB). This can be a number from 1 - 1024. If the volume type is EBS-optimized, the minimum value is 10.
|
|
306
|
+
*/
|
|
193
307
|
SizeInGB: number;
|
|
308
|
+
/**
|
|
309
|
+
* The throughput, in mebibyte per second (MiB/s). This optional parameter can be a number from 125 - 1000 and is valid only for gp3 volumes.
|
|
310
|
+
*/
|
|
194
311
|
Throughput?: number;
|
|
312
|
+
/**
|
|
313
|
+
* The volume type. Volume types supported are gp3, gp2, io1, st1, sc1, and standard.
|
|
314
|
+
*/
|
|
195
315
|
VolumeType: string;
|
|
196
|
-
Iops?: number;
|
|
197
316
|
}
|
|
317
|
+
export interface InstanceFleetProvisioningSpecifications {
|
|
318
|
+
OnDemandSpecification?: OnDemandProvisioningSpecification;
|
|
319
|
+
SpotSpecification?: SpotProvisioningSpecification;
|
|
320
|
+
}
|
|
321
|
+
export interface OnDemandProvisioningSpecification {
|
|
322
|
+
/**
|
|
323
|
+
* Specifies the strategy to use in launching On-Demand instance fleets. Currently, the only option is lowest-price (the default), which launches the lowest price first.
|
|
324
|
+
*/
|
|
325
|
+
AllocationStrategy: string;
|
|
326
|
+
CapacityReservationOptions?: OnDemandCapacityReservationOptions;
|
|
327
|
+
}
|
|
328
|
+
export interface OnDemandCapacityReservationOptions {
|
|
329
|
+
/**
|
|
330
|
+
* Supported values: none, open
|
|
331
|
+
*/
|
|
332
|
+
CapacityReservationPreference?: string;
|
|
333
|
+
CapacityReservationResourceGroupArn?: string;
|
|
334
|
+
/**
|
|
335
|
+
* Supported values: use-capacity-reservations-first
|
|
336
|
+
*/
|
|
337
|
+
UsageStrategy?: string;
|
|
338
|
+
}
|
|
339
|
+
export interface SpotProvisioningSpecification {
|
|
340
|
+
/**
|
|
341
|
+
* Specifies the strategy to use in launching Spot Instance fleets. Currently, the only option is capacity-optimized (the default), which launches instances from Spot Instance pools with optimal capacity for the number of instances that are launching.
|
|
342
|
+
*/
|
|
343
|
+
AllocationStrategy?: string;
|
|
344
|
+
/**
|
|
345
|
+
* The defined duration for Spot Instances (also known as Spot blocks) in minutes. When specified, the Spot Instance does not terminate before the defined duration expires, and defined duration pricing for Spot Instances applies. Valid values are 60, 120, 180, 240, 300, or 360. The duration period starts as soon as a Spot Instance receives its instance ID. At the end of the duration, Amazon EC2 marks the Spot Instance for termination and provides a Spot Instance termination notice, which gives the instance a two-minute warning before it terminates.
|
|
346
|
+
*/
|
|
347
|
+
BlockDurationMinutes?: number;
|
|
348
|
+
/**
|
|
349
|
+
* The action to take when TargetSpotCapacity has not been fulfilled when the TimeoutDurationMinutes has expired; that is, when all Spot Instances could not be provisioned within the Spot provisioning timeout. Valid values are TERMINATE_CLUSTER and SWITCH_TO_ON_DEMAND. SWITCH_TO_ON_DEMAND specifies that if no Spot Instances are available, On-Demand Instances should be provisioned to fulfill any remaining Spot capacity.
|
|
350
|
+
*/
|
|
351
|
+
TimeoutAction: ("SWITCH_TO_ON_DEMAND" | "TERMINATE_CLUSTER");
|
|
352
|
+
/**
|
|
353
|
+
* The spot provisioning timeout period in minutes. If Spot Instances are not provisioned within this time period, the TimeOutAction is taken. Minimum value is 5 and maximum value is 1440. The timeout applies only during initial provisioning, when the cluster is first created.
|
|
354
|
+
*/
|
|
355
|
+
TimeoutDurationMinutes: number;
|
|
356
|
+
}
|
|
357
|
+
export interface InstanceFleetResizingSpecifications {
|
|
358
|
+
SpotResizeSpecification?: SpotResizingSpecification;
|
|
359
|
+
OnDemandResizeSpecification?: OnDemandResizingSpecification;
|
|
360
|
+
}
|
|
361
|
+
export interface SpotResizingSpecification {
|
|
362
|
+
TimeoutDurationMinutes?: number;
|
|
363
|
+
AllocationStrategy?: string;
|
|
364
|
+
}
|
|
365
|
+
export interface OnDemandResizingSpecification {
|
|
366
|
+
TimeoutDurationMinutes?: number;
|
|
367
|
+
AllocationStrategy?: string;
|
|
368
|
+
CapacityReservationOptions?: OnDemandCapacityReservationOptions;
|
|
369
|
+
}
|
|
370
|
+
export interface InstanceFleetConfig1 {
|
|
371
|
+
InstanceTypeConfigs?: InstanceTypeConfig[];
|
|
372
|
+
LaunchSpecifications?: InstanceFleetProvisioningSpecifications;
|
|
373
|
+
ResizeSpecifications?: InstanceFleetResizingSpecifications;
|
|
374
|
+
/**
|
|
375
|
+
* The friendly name of the instance fleet.
|
|
376
|
+
*/
|
|
377
|
+
Name?: string;
|
|
378
|
+
/**
|
|
379
|
+
* The target capacity of On-Demand units for the instance fleet, which determines how many On-Demand Instances to provision
|
|
380
|
+
*/
|
|
381
|
+
TargetOnDemandCapacity?: number;
|
|
382
|
+
/**
|
|
383
|
+
* The target capacity of Spot units for the instance fleet, which determines how many Spot Instances to provision.
|
|
384
|
+
*/
|
|
385
|
+
TargetSpotCapacity?: number;
|
|
386
|
+
}
|
|
387
|
+
/**
|
|
388
|
+
* Configuration for the instance groups in a cluster.
|
|
389
|
+
*/
|
|
198
390
|
export interface InstanceGroupConfig {
|
|
199
391
|
AutoScalingPolicy?: AutoScalingPolicy;
|
|
392
|
+
/**
|
|
393
|
+
* If specified, indicates that the instance group uses Spot Instances. This is the maximum price you are willing to pay for Spot Instances. Specify OnDemandPrice to set the amount equal to the On-Demand price, or specify an amount in USD.
|
|
394
|
+
*/
|
|
200
395
|
BidPrice?: string;
|
|
201
|
-
|
|
202
|
-
|
|
396
|
+
/**
|
|
397
|
+
* The list of configurations supplied for an EMR cluster instance group. You can specify a separate configuration for each instance group (master, core, and task).
|
|
398
|
+
*/
|
|
399
|
+
Configurations?: EMRConfiguration[];
|
|
400
|
+
/**
|
|
401
|
+
* The custom AMI ID to use for the provisioned instance group.
|
|
402
|
+
*/
|
|
203
403
|
CustomAmiId?: string;
|
|
204
|
-
|
|
404
|
+
EbsConfiguration?: EbsConfiguration1;
|
|
405
|
+
/**
|
|
406
|
+
* Target number of instances for the instance group.
|
|
407
|
+
*/
|
|
408
|
+
InstanceCount: number;
|
|
409
|
+
/**
|
|
410
|
+
* The EC2 instance type for all instances in the instance group.
|
|
411
|
+
*/
|
|
205
412
|
InstanceType: string;
|
|
206
|
-
|
|
413
|
+
/**
|
|
414
|
+
* Market type of the EC2 instances used to create a cluster node.
|
|
415
|
+
*/
|
|
416
|
+
Market?: ("ON_DEMAND" | "SPOT");
|
|
417
|
+
/**
|
|
418
|
+
* Friendly name given to the instance group.
|
|
419
|
+
*/
|
|
207
420
|
Name?: string;
|
|
208
421
|
}
|
|
422
|
+
/**
|
|
423
|
+
* An automatic scaling policy for a core instance group or task instance group in an Amazon EMR cluster. The automatic scaling policy defines how an instance group dynamically adds and terminates EC2 instances in response to the value of a CloudWatch metric.
|
|
424
|
+
*/
|
|
209
425
|
export interface AutoScalingPolicy {
|
|
210
|
-
Rules: ScalingRule[];
|
|
211
426
|
Constraints: ScalingConstraints;
|
|
427
|
+
Rules: ScalingRule[];
|
|
428
|
+
}
|
|
429
|
+
export interface ScalingConstraints {
|
|
430
|
+
/**
|
|
431
|
+
* The upper boundary of EC2 instances in an instance group beyond which scaling activities are not allowed to grow. Scale-out activities will not add instances beyond this boundary.
|
|
432
|
+
*/
|
|
433
|
+
MaxCapacity: number;
|
|
434
|
+
/**
|
|
435
|
+
* The lower boundary of EC2 instances in an instance group below which scaling activities are not allowed to shrink. Scale-in activities will not terminate instances below this boundary.
|
|
436
|
+
*/
|
|
437
|
+
MinCapacity: number;
|
|
212
438
|
}
|
|
213
439
|
export interface ScalingRule {
|
|
214
440
|
Action: ScalingAction;
|
|
441
|
+
/**
|
|
442
|
+
* A friendly, more verbose description of the automatic scaling rule.
|
|
443
|
+
*/
|
|
215
444
|
Description?: string;
|
|
216
|
-
|
|
445
|
+
/**
|
|
446
|
+
* The name used to identify an automatic scaling rule. Rule names must be unique within a scaling policy.
|
|
447
|
+
*/
|
|
217
448
|
Name: string;
|
|
449
|
+
Trigger: ScalingTrigger;
|
|
218
450
|
}
|
|
451
|
+
/**
|
|
452
|
+
* The conditions that trigger an automatic scaling activity.
|
|
453
|
+
*/
|
|
219
454
|
export interface ScalingAction {
|
|
220
|
-
|
|
455
|
+
/**
|
|
456
|
+
* Not available for instance groups. Instance groups use the market type specified for the group.
|
|
457
|
+
*/
|
|
458
|
+
Market?: ("ON_DEMAND" | "SPOT");
|
|
221
459
|
SimpleScalingPolicyConfiguration: SimpleScalingPolicyConfiguration;
|
|
222
460
|
}
|
|
461
|
+
/**
|
|
462
|
+
* The type of adjustment the automatic scaling activity makes when triggered, and the periodicity of the adjustment.
|
|
463
|
+
*/
|
|
223
464
|
export interface SimpleScalingPolicyConfiguration {
|
|
224
|
-
|
|
465
|
+
/**
|
|
466
|
+
* The way in which EC2 instances are added (if ScalingAdjustment is a positive number) or terminated (if ScalingAdjustment is a negative number) each time the scaling activity is triggered. CHANGE_IN_CAPACITY is the default. CHANGE_IN_CAPACITY indicates that the EC2 instance count increments or decrements by ScalingAdjustment, which should be expressed as an integer. PERCENT_CHANGE_IN_CAPACITY indicates the instance count increments or decrements by the percentage specified by ScalingAdjustment, which should be expressed as an integer. For example, 20 indicates an increase in 20% increments of cluster capacity. EXACT_CAPACITY indicates the scaling activity results in an instance group with the number of EC2 instances specified by ScalingAdjustment, which should be expressed as a positive integer.
|
|
467
|
+
*/
|
|
468
|
+
AdjustmentType?: ("CHANGE_IN_CAPACITY" | "EXACT_CAPACITY" | "PERCENT_CHANGE_IN_CAPACITY");
|
|
469
|
+
/**
|
|
470
|
+
* The amount of time, in seconds, after a scaling activity completes before any further trigger-related scaling activities can start. The default value is 0.
|
|
471
|
+
*/
|
|
225
472
|
CoolDown?: number;
|
|
226
|
-
|
|
473
|
+
/**
|
|
474
|
+
* The amount by which to scale in or scale out, based on the specified AdjustmentType. A positive value adds to the instance group's EC2 instance count while a negative number removes instances. If AdjustmentType is set to EXACT_CAPACITY, the number should only be a positive integer. If AdjustmentType is set to PERCENT_CHANGE_IN_CAPACITY, the value should express the percentage as an integer. For example, -20 indicates a decrease in 20% increments of cluster capacity.
|
|
475
|
+
*/
|
|
476
|
+
ScalingAdjustment: number;
|
|
227
477
|
}
|
|
478
|
+
/**
|
|
479
|
+
* The CloudWatch alarm definition that determines when automatic scaling activity is triggered.
|
|
480
|
+
*/
|
|
228
481
|
export interface ScalingTrigger {
|
|
229
482
|
CloudWatchAlarmDefinition: CloudWatchAlarmDefinition;
|
|
230
483
|
}
|
|
484
|
+
/**
|
|
485
|
+
* The definition of a CloudWatch metric alarm. When the defined alarm conditions are met along with other trigger parameters, scaling activity begins.
|
|
486
|
+
*/
|
|
231
487
|
export interface CloudWatchAlarmDefinition {
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
488
|
+
/**
|
|
489
|
+
* Determines how the metric specified by MetricName is compared to the value specified by Threshold.
|
|
490
|
+
*/
|
|
491
|
+
ComparisonOperator: ("GREATER_THAN_OR_EQUAL" | "GREATER_THAN" | "LESS_THAN" | "LESS_THAN_OR_EQUAL");
|
|
235
492
|
Dimensions?: MetricDimension[];
|
|
236
|
-
|
|
493
|
+
/**
|
|
494
|
+
* The number of periods, in five-minute increments, during which the alarm condition must exist before the alarm triggers automatic scaling activity. The default value is 1.
|
|
495
|
+
*/
|
|
237
496
|
EvaluationPeriods?: number;
|
|
238
|
-
|
|
497
|
+
/**
|
|
498
|
+
* The name of the CloudWatch metric that is watched to determine an alarm condition.
|
|
499
|
+
*/
|
|
500
|
+
MetricName: string;
|
|
501
|
+
/**
|
|
502
|
+
* The namespace for the CloudWatch metric. The default is AWS/ElasticMapReduce.
|
|
503
|
+
*/
|
|
239
504
|
Namespace?: string;
|
|
505
|
+
/**
|
|
506
|
+
* The period, in seconds, over which the statistic is applied. EMR CloudWatch metrics are emitted every five minutes (300 seconds), so if an EMR CloudWatch metric is specified, specify 300.
|
|
507
|
+
*/
|
|
508
|
+
Period: number;
|
|
509
|
+
/**
|
|
510
|
+
* The statistic to apply to the metric associated with the alarm. The default is AVERAGE.
|
|
511
|
+
*/
|
|
512
|
+
Statistic?: ("SAMPLE_COUNT" | "AVERAGE" | "SUM" | "MINIMUM" | "MAXIMUM");
|
|
513
|
+
/**
|
|
514
|
+
* The value against which the specified statistic is compared.
|
|
515
|
+
*/
|
|
240
516
|
Threshold: number;
|
|
517
|
+
/**
|
|
518
|
+
* The unit of measure associated with the CloudWatch metric being watched. The value specified for Unit must correspond to the units specified in the CloudWatch metric.
|
|
519
|
+
*/
|
|
520
|
+
Unit?: ("NONE" | "SECONDS" | "MICRO_SECONDS" | "MILLI_SECONDS" | "BYTES" | "KILO_BYTES" | "MEGA_BYTES" | "GIGA_BYTES" | "TERA_BYTES" | "BITS" | "KILO_BITS" | "MEGA_BITS" | "GIGA_BITS" | "TERA_BITS" | "PERCENT" | "COUNT" | "BYTES_PER_SECOND" | "KILO_BYTES_PER_SECOND" | "MEGA_BYTES_PER_SECOND" | "GIGA_BYTES_PER_SECOND" | "TERA_BYTES_PER_SECOND" | "BITS_PER_SECOND" | "KILO_BITS_PER_SECOND" | "MEGA_BITS_PER_SECOND" | "GIGA_BITS_PER_SECOND" | "TERA_BITS_PER_SECOND" | "COUNT_PER_SECOND");
|
|
241
521
|
}
|
|
242
522
|
export interface MetricDimension {
|
|
243
|
-
Value: string;
|
|
244
523
|
Key: string;
|
|
524
|
+
Value: string;
|
|
245
525
|
}
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
526
|
+
/**
|
|
527
|
+
* EBS configurations that will be attached to each EC2 instance in the instance group.
|
|
528
|
+
*/
|
|
529
|
+
export interface EbsConfiguration1 {
|
|
530
|
+
EbsBlockDeviceConfigs?: EbsBlockDeviceConfig[];
|
|
531
|
+
/**
|
|
532
|
+
* Indicates whether an Amazon EBS volume is EBS-optimized.
|
|
533
|
+
*/
|
|
534
|
+
EbsOptimized?: boolean;
|
|
535
|
+
}
|
|
536
|
+
/**
|
|
537
|
+
* Configuration for the instance groups in a cluster.
|
|
538
|
+
*/
|
|
539
|
+
export interface InstanceGroupConfig1 {
|
|
540
|
+
AutoScalingPolicy?: AutoScalingPolicy;
|
|
541
|
+
/**
|
|
542
|
+
* If specified, indicates that the instance group uses Spot Instances. This is the maximum price you are willing to pay for Spot Instances. Specify OnDemandPrice to set the amount equal to the On-Demand price, or specify an amount in USD.
|
|
543
|
+
*/
|
|
544
|
+
BidPrice?: string;
|
|
545
|
+
/**
|
|
546
|
+
* The list of configurations supplied for an EMR cluster instance group. You can specify a separate configuration for each instance group (master, core, and task).
|
|
547
|
+
*/
|
|
548
|
+
Configurations?: EMRConfiguration[];
|
|
549
|
+
/**
|
|
550
|
+
* The custom AMI ID to use for the provisioned instance group.
|
|
551
|
+
*/
|
|
552
|
+
CustomAmiId?: string;
|
|
553
|
+
EbsConfiguration?: EbsConfiguration1;
|
|
554
|
+
/**
|
|
555
|
+
* Target number of instances for the instance group.
|
|
556
|
+
*/
|
|
557
|
+
InstanceCount: number;
|
|
558
|
+
/**
|
|
559
|
+
* The EC2 instance type for all instances in the instance group.
|
|
560
|
+
*/
|
|
561
|
+
InstanceType: string;
|
|
562
|
+
/**
|
|
563
|
+
* Market type of the EC2 instances used to create a cluster node.
|
|
564
|
+
*/
|
|
565
|
+
Market?: ("ON_DEMAND" | "SPOT");
|
|
566
|
+
/**
|
|
567
|
+
* Friendly name given to the instance group.
|
|
568
|
+
*/
|
|
569
|
+
Name?: string;
|
|
570
|
+
}
|
|
571
|
+
export interface InstanceGroupConfig2 {
|
|
572
|
+
AutoScalingPolicy?: AutoScalingPolicy;
|
|
573
|
+
/**
|
|
574
|
+
* If specified, indicates that the instance group uses Spot Instances. This is the maximum price you are willing to pay for Spot Instances. Specify OnDemandPrice to set the amount equal to the On-Demand price, or specify an amount in USD.
|
|
575
|
+
*/
|
|
576
|
+
BidPrice?: string;
|
|
577
|
+
/**
|
|
578
|
+
* The list of configurations supplied for an EMR cluster instance group. You can specify a separate configuration for each instance group (master, core, and task).
|
|
579
|
+
*/
|
|
580
|
+
Configurations?: EMRConfiguration[];
|
|
581
|
+
/**
|
|
582
|
+
* The custom AMI ID to use for the provisioned instance group.
|
|
583
|
+
*/
|
|
584
|
+
CustomAmiId?: string;
|
|
585
|
+
EbsConfiguration?: EbsConfiguration1;
|
|
586
|
+
/**
|
|
587
|
+
* Target number of instances for the instance group.
|
|
588
|
+
*/
|
|
589
|
+
InstanceCount: number;
|
|
590
|
+
/**
|
|
591
|
+
* The EC2 instance type for all instances in the instance group.
|
|
592
|
+
*/
|
|
593
|
+
InstanceType: string;
|
|
594
|
+
/**
|
|
595
|
+
* Market type of the EC2 instances used to create a cluster node.
|
|
596
|
+
*/
|
|
597
|
+
Market?: ("ON_DEMAND" | "SPOT");
|
|
598
|
+
/**
|
|
599
|
+
* Friendly name given to the instance group.
|
|
600
|
+
*/
|
|
601
|
+
Name?: string;
|
|
249
602
|
}
|
|
603
|
+
/**
|
|
604
|
+
* The Availability Zone in which the cluster runs.
|
|
605
|
+
*/
|
|
250
606
|
export interface PlacementType {
|
|
607
|
+
/**
|
|
608
|
+
* The Amazon EC2 Availability Zone for the cluster. AvailabilityZone is used for uniform instance groups, while AvailabilityZones (plural) is used for instance fleets.
|
|
609
|
+
*/
|
|
251
610
|
AvailabilityZone: string;
|
|
252
611
|
}
|
|
612
|
+
/**
|
|
613
|
+
* Attributes for Kerberos configuration when Kerberos authentication is enabled using a security configuration. For more information see Use Kerberos Authentication in the Amazon EMR Management Guide.
|
|
614
|
+
*/
|
|
615
|
+
export interface KerberosAttributes {
|
|
616
|
+
/**
|
|
617
|
+
* The Active Directory password for ADDomainJoinUser.
|
|
618
|
+
*/
|
|
619
|
+
ADDomainJoinPassword?: string;
|
|
620
|
+
/**
|
|
621
|
+
* Required only when establishing a cross-realm trust with an Active Directory domain. A user with sufficient privileges to join resources to the domain.
|
|
622
|
+
*/
|
|
623
|
+
ADDomainJoinUser?: string;
|
|
624
|
+
/**
|
|
625
|
+
* Required only when establishing a cross-realm trust with a KDC in a different realm. The cross-realm principal password, which must be identical across realms.
|
|
626
|
+
*/
|
|
627
|
+
CrossRealmTrustPrincipalPassword?: string;
|
|
628
|
+
/**
|
|
629
|
+
* The password used within the cluster for the kadmin service on the cluster-dedicated KDC, which maintains Kerberos principals, password policies, and keytabs for the cluster.
|
|
630
|
+
*/
|
|
631
|
+
KdcAdminPassword: string;
|
|
632
|
+
/**
|
|
633
|
+
* The name of the Kerberos realm to which all nodes in a cluster belong. For example, EC2.INTERNAL.
|
|
634
|
+
*/
|
|
635
|
+
Realm: string;
|
|
636
|
+
}
|
|
637
|
+
/**
|
|
638
|
+
* The specified managed scaling policy for an Amazon EMR cluster.
|
|
639
|
+
*/
|
|
640
|
+
export interface ManagedScalingPolicy {
|
|
641
|
+
UtilizationPerformanceIndex?: number;
|
|
642
|
+
ScalingStrategy?: string;
|
|
643
|
+
ComputeLimits?: ComputeLimits;
|
|
644
|
+
}
|
|
645
|
+
export interface ComputeLimits {
|
|
646
|
+
/**
|
|
647
|
+
* The upper boundary of EC2 units. It is measured through vCPU cores or instances for instance groups and measured through units for instance fleets. Managed scaling activities are not allowed beyond this boundary. The limit only applies to the core and task nodes. The master node cannot be scaled after initial configuration.
|
|
648
|
+
*/
|
|
649
|
+
MaximumCapacityUnits: number;
|
|
650
|
+
/**
|
|
651
|
+
* The upper boundary of EC2 units for core node type in a cluster. It is measured through vCPU cores or instances for instance groups and measured through units for instance fleets. The core units are not allowed to scale beyond this boundary. The parameter is used to split capacity allocation between core and task nodes.
|
|
652
|
+
*/
|
|
653
|
+
MaximumCoreCapacityUnits?: number;
|
|
654
|
+
/**
|
|
655
|
+
* The upper boundary of On-Demand EC2 units. It is measured through vCPU cores or instances for instance groups and measured through units for instance fleets. The On-Demand units are not allowed to scale beyond this boundary. The parameter is used to split capacity allocation between On-Demand and Spot Instances.
|
|
656
|
+
*/
|
|
657
|
+
MaximumOnDemandCapacityUnits?: number;
|
|
658
|
+
/**
|
|
659
|
+
* The lower boundary of EC2 units. It is measured through vCPU cores or instances for instance groups and measured through units for instance fleets. Managed scaling activities are not allowed beyond this boundary. The limit only applies to the core and task nodes. The master node cannot be scaled after initial configuration.
|
|
660
|
+
*/
|
|
661
|
+
MinimumCapacityUnits: number;
|
|
662
|
+
/**
|
|
663
|
+
* The unit type used for specifying a managed scaling policy.
|
|
664
|
+
*/
|
|
665
|
+
UnitType: ("InstanceFleetUnits" | "Instances" | "VCPU");
|
|
666
|
+
}
|
|
667
|
+
export interface StepConfig {
|
|
668
|
+
/**
|
|
669
|
+
* The action to take when the step fails. Use one of the following values:
|
|
670
|
+
*
|
|
671
|
+
* TERMINATE_CLUSTER - Shuts down the cluster.
|
|
672
|
+
*
|
|
673
|
+
* CANCEL_AND_WAIT - Cancels any pending steps and returns the cluster to the WAITING state.
|
|
674
|
+
*
|
|
675
|
+
* CONTINUE - Continues to the next step in the queue.
|
|
676
|
+
*
|
|
677
|
+
* TERMINATE_JOB_FLOW - Shuts down the cluster. TERMINATE_JOB_FLOW is provided for backward compatibility. We recommend using TERMINATE_CLUSTER instead.
|
|
678
|
+
* If a cluster's StepConcurrencyLevel is greater than 1, do not use AddJobFlowSteps to submit a step with this parameter set to CANCEL_AND_WAIT or TERMINATE_CLUSTER. The step is not submitted and the action fails with a message that the ActionOnFailure setting is not valid.
|
|
679
|
+
*
|
|
680
|
+
* If you change a cluster's StepConcurrencyLevel to be greater than 1 while a step is running, the ActionOnFailure parameter may not behave as you expect. In this case, for a step that fails with this parameter set to CANCEL_AND_WAIT, pending steps and the running step are not canceled; for a step that fails with this parameter set to TERMINATE_CLUSTER, the cluster does not terminate.
|
|
681
|
+
*/
|
|
682
|
+
ActionOnFailure?: ("CANCEL_AND_WAIT" | "CONTINUE" | "TERMINATE_CLUSTER" | "TERMINATE_JOB_FLOW");
|
|
683
|
+
HadoopJarStep: HadoopJarStepConfig;
|
|
684
|
+
/**
|
|
685
|
+
* The name of the step.
|
|
686
|
+
*/
|
|
687
|
+
Name: string;
|
|
688
|
+
}
|
|
689
|
+
/**
|
|
690
|
+
* The JAR file used for the step.
|
|
691
|
+
*/
|
|
692
|
+
export interface HadoopJarStepConfig {
|
|
693
|
+
Args?: string[];
|
|
694
|
+
/**
|
|
695
|
+
* A path to a JAR file run during the step.
|
|
696
|
+
*/
|
|
697
|
+
Jar: string;
|
|
698
|
+
/**
|
|
699
|
+
* The name of the main class in the specified Java file. If not specified, the JAR file should specify a Main-Class in its manifest file.
|
|
700
|
+
*/
|
|
701
|
+
MainClass?: string;
|
|
702
|
+
/**
|
|
703
|
+
* A list of Java properties that are set when the step runs. You can use these properties to pass key-value pairs to your main function.
|
|
704
|
+
*/
|
|
705
|
+
StepProperties?: KeyValue[];
|
|
706
|
+
}
|
|
707
|
+
export interface KeyValue {
|
|
708
|
+
Key?: string;
|
|
709
|
+
Value?: string;
|
|
710
|
+
}
|
|
711
|
+
export interface PlacementGroupConfig {
|
|
712
|
+
/**
|
|
713
|
+
* Role of the instance in the cluster.
|
|
714
|
+
*/
|
|
715
|
+
InstanceRole: ("MASTER" | "CORE" | "TASK");
|
|
716
|
+
/**
|
|
717
|
+
* Amazon EC2 Placement Group strategy associated with instance role.
|
|
718
|
+
*/
|
|
719
|
+
PlacementStrategy?: ("SPREAD" | "PARTITION" | "CLUSTER" | "NONE");
|
|
720
|
+
}
|
|
721
|
+
export interface Tag {
|
|
722
|
+
/**
|
|
723
|
+
* A user-defined key, which is the minimum required information for a valid tag. For more information.
|
|
724
|
+
*/
|
|
725
|
+
Key: string;
|
|
726
|
+
/**
|
|
727
|
+
* A user-defined value, which is optional in a tag. For more information
|
|
728
|
+
*/
|
|
729
|
+
Value: string;
|
|
730
|
+
}
|
|
731
|
+
/**
|
|
732
|
+
* Specifies the configuration for cluster logging.
|
|
733
|
+
*/
|
|
734
|
+
export interface MonitoringConfiguration {
|
|
735
|
+
CloudWatchLogConfiguration?: CloudWatchLogConfiguration;
|
|
736
|
+
}
|
|
737
|
+
/**
|
|
738
|
+
* Holds CloudWatch log configuration settings and metadata that specify settings like log files to monitor and where to send them.
|
|
739
|
+
*/
|
|
740
|
+
export interface CloudWatchLogConfiguration {
|
|
741
|
+
/**
|
|
742
|
+
* Specifies if CloudWatch logging is enabled.
|
|
743
|
+
*/
|
|
744
|
+
Enabled: boolean;
|
|
745
|
+
/**
|
|
746
|
+
* The name of the CloudWatch log group where logs are published.
|
|
747
|
+
*/
|
|
748
|
+
LogGroupName?: string;
|
|
749
|
+
/**
|
|
750
|
+
* The prefix of the log stream name.
|
|
751
|
+
*/
|
|
752
|
+
LogStreamNamePrefix?: string;
|
|
753
|
+
/**
|
|
754
|
+
* The ARN of the encryption key used to encrypt the logs.
|
|
755
|
+
*/
|
|
756
|
+
EncryptionKeyArn?: string;
|
|
757
|
+
/**
|
|
758
|
+
* A map of log types to file names for publishing logs to the standard output or standard error streams for CloudWatch. Valid log types include STEP_LOGS, SPARK_DRIVER, and SPARK_EXECUTOR. Valid file names for each type include STDOUT and STDERR.
|
|
759
|
+
*/
|
|
760
|
+
LogTypes?: {
|
|
761
|
+
/**
|
|
762
|
+
* This interface was referenced by `undefined`'s JSON-Schema definition
|
|
763
|
+
* via the `patternProperty` ".*".
|
|
764
|
+
*/
|
|
765
|
+
[k: string]: string[];
|
|
766
|
+
};
|
|
767
|
+
}
|