/* * Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with * the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions * and limitations under the License. */ package com.amazonaws.services.elasticmapreduce; import javax.annotation.Generated; import com.amazonaws.services.elasticmapreduce.model.*; /** * Interface for accessing Amazon EMR asynchronously. Each asynchronous method will return a Java Future object * representing the asynchronous operation; overloads which accept an {@code AsyncHandler} can be used to receive * notification when an asynchronous operation completes. *
* Note: Do not directly implement this interface, new methods are added to it regularly. Extend from * {@link com.amazonaws.services.elasticmapreduce.AbstractAmazonElasticMapReduceAsync} instead. *
**
* Amazon EMR is a web service that makes it easier to process large amounts of data efficiently. Amazon EMR uses Hadoop * processing combined with several Amazon Web Services services to do tasks such as web indexing, data mining, log file * analysis, machine learning, scientific simulation, and data warehouse management. *
*/ @Generated("com.amazonaws:aws-java-sdk-code-generator") public interface AmazonElasticMapReduceAsync extends AmazonElasticMapReduce { /** ** Adds an instance fleet to a running cluster. *
** The instance fleet configuration is available only in Amazon EMR releases 4.8.0 and later, excluding 5.0.x. *
** Adds an instance fleet to a running cluster. *
** The instance fleet configuration is available only in Amazon EMR releases 4.8.0 and later, excluding 5.0.x. *
** Adds one or more instance groups to a running cluster. *
* * @param addInstanceGroupsRequest * Input to an AddInstanceGroups call. * @return A Java Future containing the result of the AddInstanceGroups operation returned by the service. * @sample AmazonElasticMapReduceAsync.AddInstanceGroups * @see AWS API Documentation */ java.util.concurrent.Future* Adds one or more instance groups to a running cluster. *
* * @param addInstanceGroupsRequest * Input to an AddInstanceGroups call. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the AddInstanceGroups operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.AddInstanceGroups * @see AWS API Documentation */ java.util.concurrent.Future* AddJobFlowSteps adds new steps to a running cluster. A maximum of 256 steps are allowed in each job flow. *
** If your cluster is long-running (such as a Hive data warehouse) or complex, you may require more than 256 steps * to process your data. You can bypass the 256-step limitation in various ways, including using SSH to connect to * the master node and submitting queries directly to the software running on the master node, such as Hive and * Hadoop. *
** A step specifies the location of a JAR file stored either on the master node of the cluster or in Amazon S3. Each * step is performed by the main function of the main class of the JAR file. The main class can be specified either * in the manifest of the JAR or by using the MainFunction parameter of the step. *
** Amazon EMR executes each step in the order listed. For a step to be considered complete, the main function must * exit with a zero exit code and all Hadoop jobs started while the step was running must have completed and run * successfully. *
** You can only add steps to a cluster that is in one of the following states: STARTING, BOOTSTRAPPING, RUNNING, or * WAITING. *
*
* The string values passed into HadoopJarStep
object cannot exceed a total of 10240 characters.
*
* AddJobFlowSteps adds new steps to a running cluster. A maximum of 256 steps are allowed in each job flow. *
** If your cluster is long-running (such as a Hive data warehouse) or complex, you may require more than 256 steps * to process your data. You can bypass the 256-step limitation in various ways, including using SSH to connect to * the master node and submitting queries directly to the software running on the master node, such as Hive and * Hadoop. *
** A step specifies the location of a JAR file stored either on the master node of the cluster or in Amazon S3. Each * step is performed by the main function of the main class of the JAR file. The main class can be specified either * in the manifest of the JAR or by using the MainFunction parameter of the step. *
** Amazon EMR executes each step in the order listed. For a step to be considered complete, the main function must * exit with a zero exit code and all Hadoop jobs started while the step was running must have completed and run * successfully. *
** You can only add steps to a cluster that is in one of the following states: STARTING, BOOTSTRAPPING, RUNNING, or * WAITING. *
*
* The string values passed into HadoopJarStep
object cannot exceed a total of 10240 characters.
*
* Adds tags to an Amazon EMR resource, such as a cluster or an Amazon EMR Studio. Tags make it easier to associate * resources in various ways, such as grouping clusters to track your Amazon EMR resource allocation costs. For more * information, see Tag * Clusters. *
* * @param addTagsRequest * This input identifies an Amazon EMR resource and a list of tags to attach. * @return A Java Future containing the result of the AddTags operation returned by the service. * @sample AmazonElasticMapReduceAsync.AddTags * @see AWS API * Documentation */ java.util.concurrent.Future* Adds tags to an Amazon EMR resource, such as a cluster or an Amazon EMR Studio. Tags make it easier to associate * resources in various ways, such as grouping clusters to track your Amazon EMR resource allocation costs. For more * information, see Tag * Clusters. *
* * @param addTagsRequest * This input identifies an Amazon EMR resource and a list of tags to attach. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the AddTags operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.AddTags * @see AWS API * Documentation */ java.util.concurrent.Future
* Cancels a pending step or steps in a running cluster. Available only in Amazon EMR versions 4.8.0 and later,
* excluding version 5.0.0. A maximum of 256 steps are allowed in each CancelSteps request. CancelSteps is
* idempotent but asynchronous; it does not guarantee that a step will be canceled, even if the request is
* successfully submitted. When you use Amazon EMR releases 5.28.0 and later, you can cancel steps that are in a
* PENDING
or RUNNING
state. In earlier versions of Amazon EMR, you can only cancel steps
* that are in a PENDING
state.
*
* Cancels a pending step or steps in a running cluster. Available only in Amazon EMR versions 4.8.0 and later,
* excluding version 5.0.0. A maximum of 256 steps are allowed in each CancelSteps request. CancelSteps is
* idempotent but asynchronous; it does not guarantee that a step will be canceled, even if the request is
* successfully submitted. When you use Amazon EMR releases 5.28.0 and later, you can cancel steps that are in a
* PENDING
or RUNNING
state. In earlier versions of Amazon EMR, you can only cancel steps
* that are in a PENDING
state.
*
* Creates a security configuration, which is stored in the service and can be specified when a cluster is created. *
* * @param createSecurityConfigurationRequest * @return A Java Future containing the result of the CreateSecurityConfiguration operation returned by the service. * @sample AmazonElasticMapReduceAsync.CreateSecurityConfiguration * @see AWS API Documentation */ java.util.concurrent.Future* Creates a security configuration, which is stored in the service and can be specified when a cluster is created. *
* * @param createSecurityConfigurationRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateSecurityConfiguration operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.CreateSecurityConfiguration * @see AWS API Documentation */ java.util.concurrent.Future* Creates a new Amazon EMR Studio. *
* * @param createStudioRequest * @return A Java Future containing the result of the CreateStudio operation returned by the service. * @sample AmazonElasticMapReduceAsync.CreateStudio * @see AWS * API Documentation */ java.util.concurrent.Future* Creates a new Amazon EMR Studio. *
* * @param createStudioRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateStudio operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.CreateStudio * @see AWS * API Documentation */ java.util.concurrent.Future
* Maps a user or group to the Amazon EMR Studio specified by StudioId
, and applies a session policy to
* refine Studio permissions for that user or group. Use CreateStudioSessionMapping
to assign users to
* a Studio when you use IAM Identity Center authentication. For instructions on how to assign users to a Studio
* when you use IAM authentication, see Assign a user or group to your EMR Studio.
*
* Maps a user or group to the Amazon EMR Studio specified by StudioId
, and applies a session policy to
* refine Studio permissions for that user or group. Use CreateStudioSessionMapping
to assign users to
* a Studio when you use IAM Identity Center authentication. For instructions on how to assign users to a Studio
* when you use IAM authentication, see Assign a user or group to your EMR Studio.
*
* Deletes a security configuration. *
* * @param deleteSecurityConfigurationRequest * @return A Java Future containing the result of the DeleteSecurityConfiguration operation returned by the service. * @sample AmazonElasticMapReduceAsync.DeleteSecurityConfiguration * @see AWS API Documentation */ java.util.concurrent.Future* Deletes a security configuration. *
* * @param deleteSecurityConfigurationRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteSecurityConfiguration operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.DeleteSecurityConfiguration * @see AWS API Documentation */ java.util.concurrent.Future* Removes an Amazon EMR Studio from the Studio metadata store. *
* * @param deleteStudioRequest * @return A Java Future containing the result of the DeleteStudio operation returned by the service. * @sample AmazonElasticMapReduceAsync.DeleteStudio * @see AWS * API Documentation */ java.util.concurrent.Future* Removes an Amazon EMR Studio from the Studio metadata store. *
* * @param deleteStudioRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteStudio operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.DeleteStudio * @see AWS * API Documentation */ java.util.concurrent.Future* Removes a user or group from an Amazon EMR Studio. *
* * @param deleteStudioSessionMappingRequest * @return A Java Future containing the result of the DeleteStudioSessionMapping operation returned by the service. * @sample AmazonElasticMapReduceAsync.DeleteStudioSessionMapping * @see AWS API Documentation */ java.util.concurrent.Future* Removes a user or group from an Amazon EMR Studio. *
* * @param deleteStudioSessionMappingRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteStudioSessionMapping operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.DeleteStudioSessionMapping * @see AWS API Documentation */ java.util.concurrent.Future* Provides cluster-level details including status, hardware and software configuration, VPC settings, and so on. *
* * @param describeClusterRequest * This input determines which cluster to describe. * @return A Java Future containing the result of the DescribeCluster operation returned by the service. * @sample AmazonElasticMapReduceAsync.DescribeCluster * @see AWS API Documentation */ java.util.concurrent.Future* Provides cluster-level details including status, hardware and software configuration, VPC settings, and so on. *
* * @param describeClusterRequest * This input determines which cluster to describe. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeCluster operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.DescribeCluster * @see AWS API Documentation */ java.util.concurrent.Future* This API is no longer supported and will eventually be removed. We recommend you use ListClusters, * DescribeCluster, ListSteps, ListInstanceGroups and ListBootstrapActions instead. *
** DescribeJobFlows returns a list of job flows that match all of the supplied parameters. The parameters can * include a list of job flow IDs, job flow states, and restrictions on job flow creation date and time. *
** Regardless of supplied parameters, only job flows created within the last two months are returned. *
** If no parameters are supplied, then job flows matching either of the following criteria are returned: *
** Job flows created and completed in the last two weeks *
*
* Job flows created within the last two months that are in one of the following states: RUNNING
,
* WAITING
, SHUTTING_DOWN
, STARTING
*
* Amazon EMR can return a maximum of 512 job flow descriptions. *
* * @param describeJobFlowsRequest * The input for the DescribeJobFlows operation. * @return A Java Future containing the result of the DescribeJobFlows operation returned by the service. * @sample AmazonElasticMapReduceAsync.DescribeJobFlows * @see AWS API Documentation */ @Deprecated java.util.concurrent.Future* This API is no longer supported and will eventually be removed. We recommend you use ListClusters, * DescribeCluster, ListSteps, ListInstanceGroups and ListBootstrapActions instead. *
** DescribeJobFlows returns a list of job flows that match all of the supplied parameters. The parameters can * include a list of job flow IDs, job flow states, and restrictions on job flow creation date and time. *
** Regardless of supplied parameters, only job flows created within the last two months are returned. *
** If no parameters are supplied, then job flows matching either of the following criteria are returned: *
** Job flows created and completed in the last two weeks *
*
* Job flows created within the last two months that are in one of the following states: RUNNING
,
* WAITING
, SHUTTING_DOWN
, STARTING
*
* Amazon EMR can return a maximum of 512 job flow descriptions. *
* * @param describeJobFlowsRequest * The input for the DescribeJobFlows operation. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeJobFlows operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.DescribeJobFlows * @see AWS API Documentation */ @Deprecated java.util.concurrent.Future* Provides details of a notebook execution. *
* * @param describeNotebookExecutionRequest * @return A Java Future containing the result of the DescribeNotebookExecution operation returned by the service. * @sample AmazonElasticMapReduceAsync.DescribeNotebookExecution * @see AWS API Documentation */ java.util.concurrent.Future* Provides details of a notebook execution. *
* * @param describeNotebookExecutionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeNotebookExecution operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.DescribeNotebookExecution * @see AWS API Documentation */ java.util.concurrent.Future* Provides Amazon EMR release label details, such as the releases available the Region where the API request is * run, and the available applications for a specific Amazon EMR release label. Can also list Amazon EMR releases * that support a specified version of Spark. *
* * @param describeReleaseLabelRequest * @return A Java Future containing the result of the DescribeReleaseLabel operation returned by the service. * @sample AmazonElasticMapReduceAsync.DescribeReleaseLabel * @see AWS API Documentation */ java.util.concurrent.Future* Provides Amazon EMR release label details, such as the releases available the Region where the API request is * run, and the available applications for a specific Amazon EMR release label. Can also list Amazon EMR releases * that support a specified version of Spark. *
* * @param describeReleaseLabelRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeReleaseLabel operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.DescribeReleaseLabel * @see AWS API Documentation */ java.util.concurrent.Future* Provides the details of a security configuration by returning the configuration JSON. *
* * @param describeSecurityConfigurationRequest * @return A Java Future containing the result of the DescribeSecurityConfiguration operation returned by the * service. * @sample AmazonElasticMapReduceAsync.DescribeSecurityConfiguration * @see AWS API Documentation */ java.util.concurrent.Future* Provides the details of a security configuration by returning the configuration JSON. *
* * @param describeSecurityConfigurationRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeSecurityConfiguration operation returned by the * service. * @sample AmazonElasticMapReduceAsyncHandler.DescribeSecurityConfiguration * @see AWS API Documentation */ java.util.concurrent.Future* Provides more detail about the cluster step. *
* * @param describeStepRequest * This input determines which step to describe. * @return A Java Future containing the result of the DescribeStep operation returned by the service. * @sample AmazonElasticMapReduceAsync.DescribeStep * @see AWS * API Documentation */ java.util.concurrent.Future* Provides more detail about the cluster step. *
* * @param describeStepRequest * This input determines which step to describe. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeStep operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.DescribeStep * @see AWS * API Documentation */ java.util.concurrent.Future* Returns details for the specified Amazon EMR Studio including ID, Name, VPC, Studio access URL, and so on. *
* * @param describeStudioRequest * @return A Java Future containing the result of the DescribeStudio operation returned by the service. * @sample AmazonElasticMapReduceAsync.DescribeStudio * @see AWS API Documentation */ java.util.concurrent.Future* Returns details for the specified Amazon EMR Studio including ID, Name, VPC, Studio access URL, and so on. *
* * @param describeStudioRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeStudio operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.DescribeStudio * @see AWS API Documentation */ java.util.concurrent.Future* Returns the auto-termination policy for an Amazon EMR cluster. *
* * @param getAutoTerminationPolicyRequest * @return A Java Future containing the result of the GetAutoTerminationPolicy operation returned by the service. * @sample AmazonElasticMapReduceAsync.GetAutoTerminationPolicy * @see AWS API Documentation */ java.util.concurrent.Future* Returns the auto-termination policy for an Amazon EMR cluster. *
* * @param getAutoTerminationPolicyRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetAutoTerminationPolicy operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.GetAutoTerminationPolicy * @see AWS API Documentation */ java.util.concurrent.Future* Returns the Amazon EMR block public access configuration for your Amazon Web Services account in the current * Region. For more information see Configure Block * Public Access for Amazon EMR in the Amazon EMR Management Guide. *
* * @param getBlockPublicAccessConfigurationRequest * @return A Java Future containing the result of the GetBlockPublicAccessConfiguration operation returned by the * service. * @sample AmazonElasticMapReduceAsync.GetBlockPublicAccessConfiguration * @see AWS API Documentation */ java.util.concurrent.Future* Returns the Amazon EMR block public access configuration for your Amazon Web Services account in the current * Region. For more information see Configure Block * Public Access for Amazon EMR in the Amazon EMR Management Guide. *
* * @param getBlockPublicAccessConfigurationRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetBlockPublicAccessConfiguration operation returned by the * service. * @sample AmazonElasticMapReduceAsyncHandler.GetBlockPublicAccessConfiguration * @see AWS API Documentation */ java.util.concurrent.Future* Provides temporary, HTTP basic credentials that are associated with a given runtime IAM role and used by a * cluster with fine-grained access control activated. You can use these credentials to connect to cluster endpoints * that support username and password authentication. *
* * @param getClusterSessionCredentialsRequest * @return A Java Future containing the result of the GetClusterSessionCredentials operation returned by the * service. * @sample AmazonElasticMapReduceAsync.GetClusterSessionCredentials * @see AWS API Documentation */ java.util.concurrent.Future* Provides temporary, HTTP basic credentials that are associated with a given runtime IAM role and used by a * cluster with fine-grained access control activated. You can use these credentials to connect to cluster endpoints * that support username and password authentication. *
* * @param getClusterSessionCredentialsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetClusterSessionCredentials operation returned by the * service. * @sample AmazonElasticMapReduceAsyncHandler.GetClusterSessionCredentials * @see AWS API Documentation */ java.util.concurrent.Future* Fetches the attached managed scaling policy for an Amazon EMR cluster. *
* * @param getManagedScalingPolicyRequest * @return A Java Future containing the result of the GetManagedScalingPolicy operation returned by the service. * @sample AmazonElasticMapReduceAsync.GetManagedScalingPolicy * @see AWS API Documentation */ java.util.concurrent.Future* Fetches the attached managed scaling policy for an Amazon EMR cluster. *
* * @param getManagedScalingPolicyRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetManagedScalingPolicy operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.GetManagedScalingPolicy * @see AWS API Documentation */ java.util.concurrent.Future* Fetches mapping details for the specified Amazon EMR Studio and identity (user or group). *
* * @param getStudioSessionMappingRequest * @return A Java Future containing the result of the GetStudioSessionMapping operation returned by the service. * @sample AmazonElasticMapReduceAsync.GetStudioSessionMapping * @see AWS API Documentation */ java.util.concurrent.Future* Fetches mapping details for the specified Amazon EMR Studio and identity (user or group). *
* * @param getStudioSessionMappingRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetStudioSessionMapping operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.GetStudioSessionMapping * @see AWS API Documentation */ java.util.concurrent.Future* Provides information about the bootstrap actions associated with a cluster. *
* * @param listBootstrapActionsRequest * This input determines which bootstrap actions to retrieve. * @return A Java Future containing the result of the ListBootstrapActions operation returned by the service. * @sample AmazonElasticMapReduceAsync.ListBootstrapActions * @see AWS API Documentation */ java.util.concurrent.Future* Provides information about the bootstrap actions associated with a cluster. *
* * @param listBootstrapActionsRequest * This input determines which bootstrap actions to retrieve. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListBootstrapActions operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.ListBootstrapActions * @see AWS API Documentation */ java.util.concurrent.Future* Provides the status of all clusters visible to this Amazon Web Services account. Allows you to filter the list of * clusters based on certain criteria; for example, filtering by cluster creation date and time or by status. This * call returns a maximum of 50 clusters in unsorted order per call, but returns a marker to track the paging of the * cluster list across multiple ListClusters calls. *
* * @param listClustersRequest * This input determines how the ListClusters action filters the list of clusters that it returns. * @return A Java Future containing the result of the ListClusters operation returned by the service. * @sample AmazonElasticMapReduceAsync.ListClusters * @see AWS * API Documentation */ java.util.concurrent.Future* Provides the status of all clusters visible to this Amazon Web Services account. Allows you to filter the list of * clusters based on certain criteria; for example, filtering by cluster creation date and time or by status. This * call returns a maximum of 50 clusters in unsorted order per call, but returns a marker to track the paging of the * cluster list across multiple ListClusters calls. *
* * @param listClustersRequest * This input determines how the ListClusters action filters the list of clusters that it returns. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListClusters operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.ListClusters * @see AWS * API Documentation */ java.util.concurrent.Future* Lists all available details about the instance fleets in a cluster. *
** The instance fleet configuration is available only in Amazon EMR releases 4.8.0 and later, excluding 5.0.x * versions. *
** Lists all available details about the instance fleets in a cluster. *
** The instance fleet configuration is available only in Amazon EMR releases 4.8.0 and later, excluding 5.0.x * versions. *
** Provides all available details about the instance groups in a cluster. *
* * @param listInstanceGroupsRequest * This input determines which instance groups to retrieve. * @return A Java Future containing the result of the ListInstanceGroups operation returned by the service. * @sample AmazonElasticMapReduceAsync.ListInstanceGroups * @see AWS API Documentation */ java.util.concurrent.Future* Provides all available details about the instance groups in a cluster. *
* * @param listInstanceGroupsRequest * This input determines which instance groups to retrieve. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListInstanceGroups operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.ListInstanceGroups * @see AWS API Documentation */ java.util.concurrent.Future* Provides information for all active Amazon EC2 instances and Amazon EC2 instances terminated in the last 30 days, * up to a maximum of 2,000. Amazon EC2 instances in any of the following states are considered active: * AWAITING_FULFILLMENT, PROVISIONING, BOOTSTRAPPING, RUNNING. *
* * @param listInstancesRequest * This input determines which instances to list. * @return A Java Future containing the result of the ListInstances operation returned by the service. * @sample AmazonElasticMapReduceAsync.ListInstances * @see AWS * API Documentation */ java.util.concurrent.Future* Provides information for all active Amazon EC2 instances and Amazon EC2 instances terminated in the last 30 days, * up to a maximum of 2,000. Amazon EC2 instances in any of the following states are considered active: * AWAITING_FULFILLMENT, PROVISIONING, BOOTSTRAPPING, RUNNING. *
* * @param listInstancesRequest * This input determines which instances to list. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListInstances operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.ListInstances * @see AWS * API Documentation */ java.util.concurrent.Future
* Provides summaries of all notebook executions. You can filter the list based on multiple criteria such as status,
* time range, and editor id. Returns a maximum of 50 notebook executions and a marker to track the paging of a
* longer notebook execution list across multiple ListNotebookExecutions
calls.
*
* Provides summaries of all notebook executions. You can filter the list based on multiple criteria such as status,
* time range, and editor id. Returns a maximum of 50 notebook executions and a marker to track the paging of a
* longer notebook execution list across multiple ListNotebookExecutions
calls.
*
* Retrieves release labels of Amazon EMR services in the Region where the API is called. *
* * @param listReleaseLabelsRequest * @return A Java Future containing the result of the ListReleaseLabels operation returned by the service. * @sample AmazonElasticMapReduceAsync.ListReleaseLabels * @see AWS API Documentation */ java.util.concurrent.Future* Retrieves release labels of Amazon EMR services in the Region where the API is called. *
* * @param listReleaseLabelsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListReleaseLabels operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.ListReleaseLabels * @see AWS API Documentation */ java.util.concurrent.Future* Lists all the security configurations visible to this account, providing their creation dates and times, and * their names. This call returns a maximum of 50 clusters per call, but returns a marker to track the paging of the * cluster list across multiple ListSecurityConfigurations calls. *
* * @param listSecurityConfigurationsRequest * @return A Java Future containing the result of the ListSecurityConfigurations operation returned by the service. * @sample AmazonElasticMapReduceAsync.ListSecurityConfigurations * @see AWS API Documentation */ java.util.concurrent.Future* Lists all the security configurations visible to this account, providing their creation dates and times, and * their names. This call returns a maximum of 50 clusters per call, but returns a marker to track the paging of the * cluster list across multiple ListSecurityConfigurations calls. *
* * @param listSecurityConfigurationsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListSecurityConfigurations operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.ListSecurityConfigurations * @see AWS API Documentation */ java.util.concurrent.Future
* Provides a list of steps for the cluster in reverse order unless you specify stepIds
with the
* request or filter by StepStates
. You can specify a maximum of 10 stepIDs
. The CLI
* automatically paginates results to return a list greater than 50 steps. To return more than 50 steps using the
* CLI, specify a Marker
, which is a pagination token that indicates the next set of steps to retrieve.
*
* Provides a list of steps for the cluster in reverse order unless you specify stepIds
with the
* request or filter by StepStates
. You can specify a maximum of 10 stepIDs
. The CLI
* automatically paginates results to return a list greater than 50 steps. To return more than 50 steps using the
* CLI, specify a Marker
, which is a pagination token that indicates the next set of steps to retrieve.
*
* Returns a list of all user or group session mappings for the Amazon EMR Studio specified by StudioId
* .
*
* Returns a list of all user or group session mappings for the Amazon EMR Studio specified by StudioId
* .
*
* Returns a list of all Amazon EMR Studios associated with the Amazon Web Services account. The list includes * details such as ID, Studio Access URL, and creation time for each Studio. *
* * @param listStudiosRequest * @return A Java Future containing the result of the ListStudios operation returned by the service. * @sample AmazonElasticMapReduceAsync.ListStudios * @see AWS * API Documentation */ java.util.concurrent.Future* Returns a list of all Amazon EMR Studios associated with the Amazon Web Services account. The list includes * details such as ID, Studio Access URL, and creation time for each Studio. *
* * @param listStudiosRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListStudios operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.ListStudios * @see AWS * API Documentation */ java.util.concurrent.Future* A list of the instance types that Amazon EMR supports. You can filter the list by Amazon Web Services Region and * Amazon EMR release. *
* * @param listSupportedInstanceTypesRequest * @return A Java Future containing the result of the ListSupportedInstanceTypes operation returned by the service. * @sample AmazonElasticMapReduceAsync.ListSupportedInstanceTypes * @see AWS API Documentation */ java.util.concurrent.Future* A list of the instance types that Amazon EMR supports. You can filter the list by Amazon Web Services Region and * Amazon EMR release. *
* * @param listSupportedInstanceTypesRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListSupportedInstanceTypes operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.ListSupportedInstanceTypes * @see AWS API Documentation */ java.util.concurrent.Future* Modifies the number of steps that can be executed concurrently for the cluster specified using ClusterID. *
* * @param modifyClusterRequest * @return A Java Future containing the result of the ModifyCluster operation returned by the service. * @sample AmazonElasticMapReduceAsync.ModifyCluster * @see AWS * API Documentation */ java.util.concurrent.Future* Modifies the number of steps that can be executed concurrently for the cluster specified using ClusterID. *
* * @param modifyClusterRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ModifyCluster operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.ModifyCluster * @see AWS * API Documentation */ java.util.concurrent.Future* Modifies the target On-Demand and target Spot capacities for the instance fleet with the specified * InstanceFleetID within the cluster specified using ClusterID. The call either succeeds or fails atomically. *
** The instance fleet configuration is available only in Amazon EMR releases 4.8.0 and later, excluding 5.0.x * versions. *
** Modifies the target On-Demand and target Spot capacities for the instance fleet with the specified * InstanceFleetID within the cluster specified using ClusterID. The call either succeeds or fails atomically. *
** The instance fleet configuration is available only in Amazon EMR releases 4.8.0 and later, excluding 5.0.x * versions. *
** ModifyInstanceGroups modifies the number of nodes and configuration settings of an instance group. The input * parameters include the new target instance count for the group and the instance group ID. The call will either * succeed or fail atomically. *
* * @param modifyInstanceGroupsRequest * Change the size of some instance groups. * @return A Java Future containing the result of the ModifyInstanceGroups operation returned by the service. * @sample AmazonElasticMapReduceAsync.ModifyInstanceGroups * @see AWS API Documentation */ java.util.concurrent.Future* ModifyInstanceGroups modifies the number of nodes and configuration settings of an instance group. The input * parameters include the new target instance count for the group and the instance group ID. The call will either * succeed or fail atomically. *
* * @param modifyInstanceGroupsRequest * Change the size of some instance groups. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ModifyInstanceGroups operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.ModifyInstanceGroups * @see AWS API Documentation */ java.util.concurrent.Future* Creates or updates 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 Amazon EC2 * instances in response to the value of a CloudWatch metric. *
* * @param putAutoScalingPolicyRequest * @return A Java Future containing the result of the PutAutoScalingPolicy operation returned by the service. * @sample AmazonElasticMapReduceAsync.PutAutoScalingPolicy * @see AWS API Documentation */ java.util.concurrent.Future* Creates or updates 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 Amazon EC2 * instances in response to the value of a CloudWatch metric. *
* * @param putAutoScalingPolicyRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the PutAutoScalingPolicy operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.PutAutoScalingPolicy * @see AWS API Documentation */ java.util.concurrent.Future* Auto-termination is supported in Amazon EMR releases 5.30.0 and 6.1.0 and later. For more information, see Using an * auto-termination policy. *
** 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 Control cluster * termination. *
* * @param putAutoTerminationPolicyRequest * @return A Java Future containing the result of the PutAutoTerminationPolicy operation returned by the service. * @sample AmazonElasticMapReduceAsync.PutAutoTerminationPolicy * @see AWS API Documentation */ java.util.concurrent.Future* Auto-termination is supported in Amazon EMR releases 5.30.0 and 6.1.0 and later. For more information, see Using an * auto-termination policy. *
** 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 Control cluster * termination. *
* * @param putAutoTerminationPolicyRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the PutAutoTerminationPolicy operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.PutAutoTerminationPolicy * @see AWS API Documentation */ java.util.concurrent.Future* Creates or updates an Amazon EMR block public access configuration for your Amazon Web Services account in the * current Region. For more information see Configure Block * Public Access for Amazon EMR in the Amazon EMR Management Guide. *
* * @param putBlockPublicAccessConfigurationRequest * @return A Java Future containing the result of the PutBlockPublicAccessConfiguration operation returned by the * service. * @sample AmazonElasticMapReduceAsync.PutBlockPublicAccessConfiguration * @see AWS API Documentation */ java.util.concurrent.Future* Creates or updates an Amazon EMR block public access configuration for your Amazon Web Services account in the * current Region. For more information see Configure Block * Public Access for Amazon EMR in the Amazon EMR Management Guide. *
* * @param putBlockPublicAccessConfigurationRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the PutBlockPublicAccessConfiguration operation returned by the * service. * @sample AmazonElasticMapReduceAsyncHandler.PutBlockPublicAccessConfiguration * @see AWS API Documentation */ java.util.concurrent.Future* Creates or updates a managed scaling policy for an Amazon EMR cluster. The managed scaling policy defines the * limits for resources, such as Amazon EC2 instances that can be added or terminated from a cluster. The policy * only applies to the core and task nodes. The master node cannot be scaled after initial configuration. *
* * @param putManagedScalingPolicyRequest * @return A Java Future containing the result of the PutManagedScalingPolicy operation returned by the service. * @sample AmazonElasticMapReduceAsync.PutManagedScalingPolicy * @see AWS API Documentation */ java.util.concurrent.Future* Creates or updates a managed scaling policy for an Amazon EMR cluster. The managed scaling policy defines the * limits for resources, such as Amazon EC2 instances that can be added or terminated from a cluster. The policy * only applies to the core and task nodes. The master node cannot be scaled after initial configuration. *
* * @param putManagedScalingPolicyRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the PutManagedScalingPolicy operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.PutManagedScalingPolicy * @see AWS API Documentation */ java.util.concurrent.Future* Removes an automatic scaling policy from a specified instance group within an Amazon EMR cluster. *
* * @param removeAutoScalingPolicyRequest * @return A Java Future containing the result of the RemoveAutoScalingPolicy operation returned by the service. * @sample AmazonElasticMapReduceAsync.RemoveAutoScalingPolicy * @see AWS API Documentation */ java.util.concurrent.Future* Removes an automatic scaling policy from a specified instance group within an Amazon EMR cluster. *
* * @param removeAutoScalingPolicyRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the RemoveAutoScalingPolicy operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.RemoveAutoScalingPolicy * @see AWS API Documentation */ java.util.concurrent.Future* Removes an auto-termination policy from an Amazon EMR cluster. *
* * @param removeAutoTerminationPolicyRequest * @return A Java Future containing the result of the RemoveAutoTerminationPolicy operation returned by the service. * @sample AmazonElasticMapReduceAsync.RemoveAutoTerminationPolicy * @see AWS API Documentation */ java.util.concurrent.Future* Removes an auto-termination policy from an Amazon EMR cluster. *
* * @param removeAutoTerminationPolicyRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the RemoveAutoTerminationPolicy operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.RemoveAutoTerminationPolicy * @see AWS API Documentation */ java.util.concurrent.Future* Removes a managed scaling policy from a specified Amazon EMR cluster. *
* * @param removeManagedScalingPolicyRequest * @return A Java Future containing the result of the RemoveManagedScalingPolicy operation returned by the service. * @sample AmazonElasticMapReduceAsync.RemoveManagedScalingPolicy * @see AWS API Documentation */ java.util.concurrent.Future* Removes a managed scaling policy from a specified Amazon EMR cluster. *
* * @param removeManagedScalingPolicyRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the RemoveManagedScalingPolicy operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.RemoveManagedScalingPolicy * @see AWS API Documentation */ java.util.concurrent.Future* 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 clusters to track your Amazon EMR resource allocation * costs. For more information, see Tag Clusters. *
** The following example removes the stack tag with value Prod from a cluster: *
* * @param removeTagsRequest * This input identifies an Amazon EMR resource and a list of tags to remove. * @return A Java Future containing the result of the RemoveTags operation returned by the service. * @sample AmazonElasticMapReduceAsync.RemoveTags * @see AWS * API Documentation */ java.util.concurrent.Future* 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 clusters to track your Amazon EMR resource allocation * costs. For more information, see Tag Clusters. *
** The following example removes the stack tag with value Prod from a cluster: *
* * @param removeTagsRequest * This input identifies an Amazon EMR resource and a list of tags to remove. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the RemoveTags operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.RemoveTags * @see AWS * API Documentation */ java.util.concurrent.Future
* RunJobFlow creates and starts running a new cluster (job flow). The cluster runs the steps specified. After the
* steps complete, the cluster stops and the HDFS partition is lost. To prevent loss of data, configure the last
* step of the job flow to store results in Amazon S3. If the JobFlowInstancesConfig
* KeepJobFlowAliveWhenNoSteps
parameter is set to TRUE
, the cluster transitions to the
* WAITING state rather than shutting down after the steps have completed.
*
* For additional protection, you can set the JobFlowInstancesConfig TerminationProtected
* parameter to TRUE
to lock the cluster and prevent it from being terminated by API call, user
* intervention, or in the event of a job flow error.
*
* A maximum of 256 steps are allowed in each job flow. *
** If your cluster is long-running (such as a Hive data warehouse) or complex, you may require more than 256 steps * to process your data. You can bypass the 256-step limitation in various ways, including using the SSH shell to * connect to the master node and submitting queries directly to the software running on the master node, such as * Hive and Hadoop. *
** For long-running clusters, we recommend that you periodically store your results. *
** The instance fleets configuration is available only in Amazon EMR releases 4.8.0 and later, excluding 5.0.x * versions. The RunJobFlow request can contain InstanceFleets parameters or InstanceGroups parameters, but not * both. *
*
* RunJobFlow creates and starts running a new cluster (job flow). The cluster runs the steps specified. After the
* steps complete, the cluster stops and the HDFS partition is lost. To prevent loss of data, configure the last
* step of the job flow to store results in Amazon S3. If the JobFlowInstancesConfig
* KeepJobFlowAliveWhenNoSteps
parameter is set to TRUE
, the cluster transitions to the
* WAITING state rather than shutting down after the steps have completed.
*
* For additional protection, you can set the JobFlowInstancesConfig TerminationProtected
* parameter to TRUE
to lock the cluster and prevent it from being terminated by API call, user
* intervention, or in the event of a job flow error.
*
* A maximum of 256 steps are allowed in each job flow. *
** If your cluster is long-running (such as a Hive data warehouse) or complex, you may require more than 256 steps * to process your data. You can bypass the 256-step limitation in various ways, including using the SSH shell to * connect to the master node and submitting queries directly to the software running on the master node, such as * Hive and Hadoop. *
** For long-running clusters, we recommend that you periodically store your results. *
** The instance fleets configuration is available only in Amazon EMR releases 4.8.0 and later, excluding 5.0.x * versions. The RunJobFlow request can contain InstanceFleets parameters or InstanceGroups parameters, but not * both. *
*
* SetTerminationProtection locks a cluster (job flow) so the Amazon EC2 instances in the cluster cannot be
* terminated by user intervention, an API call, or in the event of a job-flow error. The cluster still terminates
* upon successful completion of the job flow. Calling SetTerminationProtection
on a cluster is similar
* to calling the Amazon EC2 DisableAPITermination
API on all Amazon EC2 instances in a cluster.
*
* SetTerminationProtection
is used to prevent accidental termination of a cluster and to ensure that
* in the event of an error, the instances persist so that you can recover any data stored in their ephemeral
* instance storage.
*
* To terminate a cluster that has been locked by setting SetTerminationProtection
to true
* , you must first unlock the job flow by a subsequent call to SetTerminationProtection
in which you
* set the value to false
.
*
* For more information, seeManaging * Cluster Termination in the Amazon EMR Management Guide. *
* * @param setTerminationProtectionRequest * The input argument to the TerminationProtection operation. * @return A Java Future containing the result of the SetTerminationProtection operation returned by the service. * @sample AmazonElasticMapReduceAsync.SetTerminationProtection * @see AWS API Documentation */ java.util.concurrent.Future
* SetTerminationProtection locks a cluster (job flow) so the Amazon EC2 instances in the cluster cannot be
* terminated by user intervention, an API call, or in the event of a job-flow error. The cluster still terminates
* upon successful completion of the job flow. Calling SetTerminationProtection
on a cluster is similar
* to calling the Amazon EC2 DisableAPITermination
API on all Amazon EC2 instances in a cluster.
*
* SetTerminationProtection
is used to prevent accidental termination of a cluster and to ensure that
* in the event of an error, the instances persist so that you can recover any data stored in their ephemeral
* instance storage.
*
* To terminate a cluster that has been locked by setting SetTerminationProtection
to true
* , you must first unlock the job flow by a subsequent call to SetTerminationProtection
in which you
* set the value to false
.
*
* For more information, seeManaging * Cluster Termination in the Amazon EMR Management Guide. *
* * @param setTerminationProtectionRequest * The input argument to the TerminationProtection operation. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the SetTerminationProtection operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.SetTerminationProtection * @see AWS API Documentation */ java.util.concurrent.Future* The SetVisibleToAllUsers parameter is no longer supported. Your cluster may be visible to all users in your * account. To restrict cluster access using an IAM policy, see Identity and Access * Management for Amazon EMR. *
*
* Sets the Cluster$VisibleToAllUsers value for an Amazon EMR cluster. When true
, IAM principals
* in the Amazon Web Services account can perform Amazon EMR cluster actions that their IAM policies allow. When
* false
, only the IAM principal that created the cluster and the Amazon Web Services account root user
* can perform Amazon EMR actions on the cluster, regardless of IAM permissions policies attached to other IAM
* principals.
*
* This action works on running clusters. When you create a cluster, use the * RunJobFlowInput$VisibleToAllUsers parameter. *
** For more information, see Understanding the Amazon EMR Cluster VisibleToAllUsers Setting in the Amazon EMR Management Guide. *
* * @param setVisibleToAllUsersRequest * The input to the SetVisibleToAllUsers action. * @return A Java Future containing the result of the SetVisibleToAllUsers operation returned by the service. * @sample AmazonElasticMapReduceAsync.SetVisibleToAllUsers * @see AWS API Documentation */ java.util.concurrent.Future* The SetVisibleToAllUsers parameter is no longer supported. Your cluster may be visible to all users in your * account. To restrict cluster access using an IAM policy, see Identity and Access * Management for Amazon EMR. *
*
* Sets the Cluster$VisibleToAllUsers value for an Amazon EMR cluster. When true
, IAM principals
* in the Amazon Web Services account can perform Amazon EMR cluster actions that their IAM policies allow. When
* false
, only the IAM principal that created the cluster and the Amazon Web Services account root user
* can perform Amazon EMR actions on the cluster, regardless of IAM permissions policies attached to other IAM
* principals.
*
* This action works on running clusters. When you create a cluster, use the * RunJobFlowInput$VisibleToAllUsers parameter. *
** For more information, see Understanding the Amazon EMR Cluster VisibleToAllUsers Setting in the Amazon EMR Management Guide. *
* * @param setVisibleToAllUsersRequest * The input to the SetVisibleToAllUsers action. * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the SetVisibleToAllUsers operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.SetVisibleToAllUsers * @see AWS API Documentation */ java.util.concurrent.Future* Starts a notebook execution. *
* * @param startNotebookExecutionRequest * @return A Java Future containing the result of the StartNotebookExecution operation returned by the service. * @sample AmazonElasticMapReduceAsync.StartNotebookExecution * @see AWS API Documentation */ java.util.concurrent.Future* Starts a notebook execution. *
* * @param startNotebookExecutionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the StartNotebookExecution operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.StartNotebookExecution * @see AWS API Documentation */ java.util.concurrent.Future* Stops a notebook execution. *
* * @param stopNotebookExecutionRequest * @return A Java Future containing the result of the StopNotebookExecution operation returned by the service. * @sample AmazonElasticMapReduceAsync.StopNotebookExecution * @see AWS API Documentation */ java.util.concurrent.Future* Stops a notebook execution. *
* * @param stopNotebookExecutionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the StopNotebookExecution operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.StopNotebookExecution * @see AWS API Documentation */ java.util.concurrent.Future* TerminateJobFlows shuts a list of clusters (job flows) down. When a job flow is shut down, any step not yet * completed is canceled and the Amazon EC2 instances on which the cluster is running are stopped. Any log files not * already saved are uploaded to Amazon S3 if a LogUri was specified when the cluster was created. *
*
* The maximum number of clusters allowed is 10. The call to TerminateJobFlows
is asynchronous.
* Depending on the configuration of the cluster, it may take up to 1-5 minutes for the cluster to completely
* terminate and release allocated resources, such as Amazon EC2 instances.
*
* TerminateJobFlows shuts a list of clusters (job flows) down. When a job flow is shut down, any step not yet * completed is canceled and the Amazon EC2 instances on which the cluster is running are stopped. Any log files not * already saved are uploaded to Amazon S3 if a LogUri was specified when the cluster was created. *
*
* The maximum number of clusters allowed is 10. The call to TerminateJobFlows
is asynchronous.
* Depending on the configuration of the cluster, it may take up to 1-5 minutes for the cluster to completely
* terminate and release allocated resources, such as Amazon EC2 instances.
*
* Updates an Amazon EMR Studio configuration, including attributes such as name, description, and subnets. *
* * @param updateStudioRequest * @return A Java Future containing the result of the UpdateStudio operation returned by the service. * @sample AmazonElasticMapReduceAsync.UpdateStudio * @see AWS * API Documentation */ java.util.concurrent.Future* Updates an Amazon EMR Studio configuration, including attributes such as name, description, and subnets. *
* * @param updateStudioRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UpdateStudio operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.UpdateStudio * @see AWS * API Documentation */ java.util.concurrent.Future* Updates the session policy attached to the user or group for the specified Amazon EMR Studio. *
* * @param updateStudioSessionMappingRequest * @return A Java Future containing the result of the UpdateStudioSessionMapping operation returned by the service. * @sample AmazonElasticMapReduceAsync.UpdateStudioSessionMapping * @see AWS API Documentation */ java.util.concurrent.Future* Updates the session policy attached to the user or group for the specified Amazon EMR Studio. *
* * @param updateStudioSessionMappingRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UpdateStudioSessionMapping operation returned by the service. * @sample AmazonElasticMapReduceAsyncHandler.UpdateStudioSessionMapping * @see AWS API Documentation */ java.util.concurrent.Future