@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.
Files changed (37) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/README.md +3 -4
  3. package/dist-cjs/models/models_0.js +14 -3
  4. package/dist-cjs/protocols/Aws_json1_1.js +24 -0
  5. package/dist-es/models/models_0.js +9 -0
  6. package/dist-es/protocols/Aws_json1_1.js +26 -4
  7. package/dist-types/EMR.d.ts +99 -78
  8. package/dist-types/EMRClient.d.ts +3 -4
  9. package/dist-types/commands/AddInstanceFleetCommand.d.ts +2 -2
  10. package/dist-types/commands/AddJobFlowStepsCommand.d.ts +8 -7
  11. package/dist-types/commands/AddTagsCommand.d.ts +5 -3
  12. package/dist-types/commands/CancelStepsCommand.d.ts +4 -3
  13. package/dist-types/commands/CreateStudioSessionMappingCommand.d.ts +5 -2
  14. package/dist-types/commands/DescribeReleaseLabelCommand.d.ts +3 -1
  15. package/dist-types/commands/DescribeStudioCommand.d.ts +2 -2
  16. package/dist-types/commands/GetBlockPublicAccessConfigurationCommand.d.ts +3 -4
  17. package/dist-types/commands/GetStudioSessionMappingCommand.d.ts +2 -2
  18. package/dist-types/commands/ListClustersCommand.d.ts +5 -5
  19. package/dist-types/commands/ListInstanceFleetsCommand.d.ts +2 -2
  20. package/dist-types/commands/ListStepsCommand.d.ts +4 -1
  21. package/dist-types/commands/ListStudioSessionMappingsCommand.d.ts +2 -2
  22. package/dist-types/commands/ListStudiosCommand.d.ts +2 -2
  23. package/dist-types/commands/ModifyInstanceFleetCommand.d.ts +2 -2
  24. package/dist-types/commands/PutAutoScalingPolicyCommand.d.ts +3 -3
  25. package/dist-types/commands/PutAutoTerminationPolicyCommand.d.ts +7 -2
  26. package/dist-types/commands/PutBlockPublicAccessConfigurationCommand.d.ts +4 -4
  27. package/dist-types/commands/PutManagedScalingPolicyCommand.d.ts +4 -4
  28. package/dist-types/commands/RemoveTagsCommand.d.ts +4 -3
  29. package/dist-types/commands/RunJobFlowCommand.d.ts +4 -4
  30. package/dist-types/commands/SetTerminationProtectionCommand.d.ts +2 -2
  31. package/dist-types/commands/SetVisibleToAllUsersCommand.d.ts +11 -6
  32. package/dist-types/commands/TerminateJobFlowsCommand.d.ts +3 -3
  33. package/dist-types/commands/UpdateStudioCommand.d.ts +2 -1
  34. package/dist-types/commands/UpdateStudioSessionMappingCommand.d.ts +1 -2
  35. package/dist-types/models/models_0.d.ts +616 -435
  36. package/dist-types/ts3.4/models/models_0.d.ts +21 -0
  37. package/package.json +3 -3
@@ -11,8 +11,8 @@ export interface ModifyInstanceFleetCommandOutput extends __MetadataBearer {
11
11
  * specified InstanceFleetID within the cluster specified using ClusterID. The call either
12
12
  * succeeds or fails atomically.</p>
13
13
  * <note>
14
- * <p>The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and
15
- * later, excluding 5.0.x versions.</p>
14
+ * <p>The instance fleet configuration is available only in Amazon EMR versions
15
+ * 4.8.0 and later, excluding 5.0.x versions.</p>
16
16
  * </note>
17
17
  * @example
18
18
  * Use a bare-bones client and the command you need to make an API call.
@@ -8,9 +8,9 @@ export interface PutAutoScalingPolicyCommandOutput extends PutAutoScalingPolicyO
8
8
  }
9
9
  /**
10
10
  * <p>Creates or updates an automatic scaling policy for a core instance group or task
11
- * instance group in an Amazon EMR cluster. The automatic scaling policy defines how an
12
- * instance group dynamically adds and terminates EC2 instances in response to the value of a
13
- * CloudWatch metric.</p>
11
+ * instance group in an Amazon EMR cluster. The automatic scaling policy defines how
12
+ * an instance group dynamically adds and terminates EC2 instances in response to the value of
13
+ * a CloudWatch metric.</p>
14
14
  * @example
15
15
  * Use a bare-bones client and the command you need to make an API call.
16
16
  * ```javascript
@@ -8,9 +8,14 @@ export interface PutAutoTerminationPolicyCommandOutput extends PutAutoTerminatio
8
8
  }
9
9
  /**
10
10
  * <note>
11
- * <p>Auto-termination is supported in Amazon EMR versions 5.30.0 and 6.1.0 and later. For more information, see <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-auto-termination-policy.html">Using an auto-termination policy</a>.</p>
11
+ * <p>Auto-termination is supported in Amazon EMR versions 5.30.0 and 6.1.0 and
12
+ * later. For more information, see <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-auto-termination-policy.html">Using an
13
+ * auto-termination policy</a>.</p>
12
14
  * </note>
13
- * <p>Creates or updates 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. For alternative cluster termination options, see <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-termination.html">Control cluster termination</a>.</p>
15
+ * <p>Creates or updates an auto-termination policy for an Amazon EMR cluster. An
16
+ * auto-termination policy defines the amount of idle time in seconds after which a cluster
17
+ * automatically terminates. For alternative cluster termination options, see <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-termination.html">Control
18
+ * cluster termination</a>.</p>
14
19
  * @example
15
20
  * Use a bare-bones client and the command you need to make an API call.
16
21
  * ```javascript
@@ -7,10 +7,10 @@ export interface PutBlockPublicAccessConfigurationCommandInput extends PutBlockP
7
7
  export interface PutBlockPublicAccessConfigurationCommandOutput extends PutBlockPublicAccessConfigurationOutput, __MetadataBearer {
8
8
  }
9
9
  /**
10
- * <p>Creates or updates an Amazon EMR block public access configuration for your Amazon Web Services account
11
- * in the current Region. For more information see <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/configure-block-public-access.html">Configure Block
12
- * Public Access for Amazon EMR</a> in the <i>Amazon EMR Management
13
- * Guide</i>.</p>
10
+ * <p>Creates or updates an Amazon EMR block public access configuration for your
11
+ * Amazon Web Services account in the current Region. For more information see <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/configure-block-public-access.html">Configure Block
12
+ * Public Access for Amazon EMR</a> in the <i>Amazon EMR
13
+ * Management Guide</i>.</p>
14
14
  * @example
15
15
  * Use a bare-bones client and the command you need to make an API call.
16
16
  * ```javascript
@@ -7,10 +7,10 @@ export interface PutManagedScalingPolicyCommandInput extends PutManagedScalingPo
7
7
  export interface PutManagedScalingPolicyCommandOutput extends PutManagedScalingPolicyOutput, __MetadataBearer {
8
8
  }
9
9
  /**
10
- * <p>Creates or updates a managed scaling policy for an Amazon EMR cluster. The managed
11
- * scaling policy defines the limits for resources, such as EC2 instances that can be added or
12
- * terminated from a cluster. The policy only applies to the core and task nodes. The master
13
- * node cannot be scaled after initial configuration. </p>
10
+ * <p>Creates or updates a managed scaling policy for an Amazon EMR cluster. The
11
+ * managed scaling policy defines the limits for resources, such as EC2 instances that can be
12
+ * added or terminated from a cluster. The policy only applies to the core and task nodes. The
13
+ * master node cannot be scaled after initial configuration. </p>
14
14
  * @example
15
15
  * Use a bare-bones client and the command you need to make an API call.
16
16
  * ```javascript
@@ -7,9 +7,10 @@ export interface RemoveTagsCommandInput extends RemoveTagsInput {
7
7
  export interface RemoveTagsCommandOutput extends RemoveTagsOutput, __MetadataBearer {
8
8
  }
9
9
  /**
10
- * <p>Removes tags from an Amazon EMR resource, such as a cluster or Amazon EMR Studio. Tags make it easier to associate resources in
11
- * various ways, such as grouping clusters to track your Amazon EMR resource allocation costs.
12
- * For more information, see <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-tags.html">Tag Clusters</a>. </p>
10
+ * <p>Removes tags from an Amazon EMR resource, such as a cluster or Amazon EMR Studio. Tags make it easier to associate resources in various ways, such as grouping
11
+ * clusters to track your Amazon EMR resource allocation costs. For more information,
12
+ * see <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-tags.html">Tag
13
+ * Clusters</a>. </p>
13
14
  * <p>The following example removes the stack tag with value Prod from a cluster:</p>
14
15
  * @example
15
16
  * Use a bare-bones client and the command you need to make an API call.
@@ -10,7 +10,7 @@ export interface RunJobFlowCommandOutput extends RunJobFlowOutput, __MetadataBea
10
10
  * <p>RunJobFlow creates and starts running a new cluster (job flow). The cluster runs the
11
11
  * steps specified. After the steps complete, the cluster stops and the HDFS partition is
12
12
  * lost. To prevent loss of data, configure the last step of the job flow to store results in
13
- * Amazon S3. If the <a>JobFlowInstancesConfig</a>
13
+ * Amazon S3. If the <a>JobFlowInstancesConfig</a>
14
14
  * <code>KeepJobFlowAliveWhenNoSteps</code> parameter is set to <code>TRUE</code>, the cluster
15
15
  * transitions to the WAITING state rather than shutting down after the steps have completed. </p>
16
16
  * <p>For additional protection, you can set the <a>JobFlowInstancesConfig</a>
@@ -26,9 +26,9 @@ export interface RunJobFlowCommandOutput extends RunJobFlowOutput, __MetadataBea
26
26
  * Cluster</a> in the <i>Amazon EMR Management Guide</i>.</p>
27
27
  * <p>For long running clusters, we recommend that you periodically store your results.</p>
28
28
  * <note>
29
- * <p>The instance fleets configuration is available only in Amazon EMR versions 4.8.0 and
30
- * later, excluding 5.0.x versions. The RunJobFlow request can contain InstanceFleets
31
- * parameters or InstanceGroups parameters, but not both.</p>
29
+ * <p>The instance fleets configuration is available only in Amazon EMR versions
30
+ * 4.8.0 and later, excluding 5.0.x versions. The RunJobFlow request can contain
31
+ * InstanceFleets parameters or InstanceGroups parameters, but not both.</p>
32
32
  * </note>
33
33
  * @example
34
34
  * Use a bare-bones client and the command you need to make an API call.
@@ -10,8 +10,8 @@ export interface SetTerminationProtectionCommandOutput extends __MetadataBearer
10
10
  * <p>SetTerminationProtection locks a cluster (job flow) so the EC2 instances in the cluster
11
11
  * cannot be terminated by user intervention, an API call, or in the event of a job-flow
12
12
  * error. The cluster still terminates upon successful completion of the job flow. Calling
13
- * <code>SetTerminationProtection</code> on a cluster is similar to calling the Amazon EC2
14
- * <code>DisableAPITermination</code> API on all EC2 instances in a cluster.</p>
13
+ * <code>SetTerminationProtection</code> on a cluster is similar to calling the Amazon EC2
14
+ * <code>DisableAPITermination</code> API on all EC2 instances in a cluster.</p>
15
15
  * <p>
16
16
  * <code>SetTerminationProtection</code> is used to prevent accidental termination of a
17
17
  * cluster and to ensure that in the event of an error, the instances persist so that you can
@@ -8,14 +8,19 @@ export interface SetVisibleToAllUsersCommandOutput extends __MetadataBearer {
8
8
  }
9
9
  /**
10
10
  * <important>
11
- * <p>The SetVisibleToAllUsers parameter is no longer supported. Your cluster may be visible to all users in your account.
12
- * To restrict cluster access using an IAM policy, see <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-access-iam.html">Identity and Access Management for EMR</a>.
13
- * </p>
11
+ * <p>The SetVisibleToAllUsers parameter is no longer supported. Your cluster may be
12
+ * visible to all users in your account. To restrict cluster access using an IAM policy, see <a href="https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-access-iam.html">Identity and Access
13
+ * Management for EMR</a>. </p>
14
14
  * </important>
15
- * <p>Sets the <a>Cluster$VisibleToAllUsers</a> value for an EMR cluster. When <code>true</code>, IAM principals in the
16
- * Amazon Web Services account can perform EMR cluster actions that their IAM policies allow. When <code>false</code>, only the IAM principal that created the cluster and the Amazon Web Services account root user can perform EMR actions on the cluster, regardless of IAM permissions policies attached to other IAM principals.</p>
15
+ * <p>Sets the <a>Cluster$VisibleToAllUsers</a> value for an EMR cluster. When
16
+ * <code>true</code>, IAM principals in the Amazon Web Services account can perform EMR
17
+ * cluster actions that their IAM policies allow. When <code>false</code>, only
18
+ * the IAM principal that created the cluster and the Amazon Web Services account root user can
19
+ * perform EMR actions on the cluster, regardless of IAM permissions policies attached to
20
+ * other IAM principals.</p>
17
21
  * <p>This action works on running clusters. When you create a cluster, use the <a>RunJobFlowInput$VisibleToAllUsers</a> parameter.</p>
18
- * <p>For more information, see <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 <i>Amazon EMRManagement Guide</i>.</p>
22
+ * <p>For more information, see <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
23
+ * <i>Amazon EMRManagement Guide</i>.</p>
19
24
  * @example
20
25
  * Use a bare-bones client and the command you need to make an API call.
21
26
  * ```javascript
@@ -9,12 +9,12 @@ export interface TerminateJobFlowsCommandOutput extends __MetadataBearer {
9
9
  /**
10
10
  * <p>TerminateJobFlows shuts a list of clusters (job flows) down. When a job flow is shut
11
11
  * down, any step not yet completed is canceled and the EC2 instances on which the cluster is
12
- * running are stopped. Any log files not already saved are uploaded to Amazon S3 if a LogUri
13
- * was specified when the cluster was created.</p>
12
+ * running are stopped. Any log files not already saved are uploaded to Amazon S3 if a
13
+ * LogUri was specified when the cluster was created.</p>
14
14
  * <p>The maximum number of clusters allowed is 10. The call to <code>TerminateJobFlows</code>
15
15
  * is asynchronous. Depending on the configuration of the cluster, it may take up to 1-5
16
16
  * minutes for the cluster to completely terminate and release allocated resources, such as
17
- * Amazon EC2 instances.</p>
17
+ * Amazon EC2 instances.</p>
18
18
  * @example
19
19
  * Use a bare-bones client and the command you need to make an API call.
20
20
  * ```javascript
@@ -7,7 +7,8 @@ export interface UpdateStudioCommandInput extends UpdateStudioInput {
7
7
  export interface UpdateStudioCommandOutput extends __MetadataBearer {
8
8
  }
9
9
  /**
10
- * <p>Updates an Amazon EMR Studio configuration, including attributes such as name, description, and subnets.</p>
10
+ * <p>Updates an Amazon EMR Studio configuration, including attributes such as name,
11
+ * description, and subnets.</p>
11
12
  * @example
12
13
  * Use a bare-bones client and the command you need to make an API call.
13
14
  * ```javascript
@@ -7,8 +7,7 @@ export interface UpdateStudioSessionMappingCommandInput extends UpdateStudioSess
7
7
  export interface UpdateStudioSessionMappingCommandOutput extends __MetadataBearer {
8
8
  }
9
9
  /**
10
- * <p>Updates the session policy attached to the user or group for the specified Amazon EMR
11
- * Studio.</p>
10
+ * <p>Updates the session policy attached to the user or group for the specified Amazon EMR Studio.</p>
12
11
  * @example
13
12
  * Use a bare-bones client and the command you need to make an API call.
14
13
  * ```javascript