Amazon Web Services, Inc.

Amazon EMR

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…

Developer tools#openapi#cloud

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

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.

Endpoints 65

  • POSTAdd instance fleet/#X-Amz-Target=ElasticMapReduce.AddInstanceFleetAdds 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.
  • POSTAdd instance groups/#X-Amz-Target=ElasticMapReduce.AddInstanceGroupsAdds one or more instance groups to a running cluster.
  • POSTAdd job flow steps/#X-Amz-Target=ElasticMapReduce.AddJobFlowStepsAddJobFlowSteps 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…
  • POSTAdd tags/#X-Amz-Target=ElasticMapReduce.AddTagsAdds 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…
  • POSTCancel steps/#X-Amz-Target=ElasticMapReduce.CancelStepsCancels 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…
  • POSTCreate persistent app uI/#X-Amz-Target=ElasticMapReduce.CreatePersistentAppUICreates a persistent application user interface.
  • POSTCreate security configuration/#X-Amz-Target=ElasticMapReduce.CreateSecurityConfigurationCreates a security configuration, which is stored in the service and can be specified when a cluster is created.
  • POSTCreate studio/#X-Amz-Target=ElasticMapReduce.CreateStudioCreates a new Amazon EMR Studio.
  • POSTCreate studio session mapping/#X-Amz-Target=ElasticMapReduce.CreateStudioSessionMappingMaps 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…
  • POSTDelete security configuration/#X-Amz-Target=ElasticMapReduce.DeleteSecurityConfigurationDeletes a security configuration.
  • POSTDelete studio/#X-Amz-Target=ElasticMapReduce.DeleteStudioRemoves an Amazon EMR Studio from the Studio metadata store.
  • POSTDelete studio session mapping/#X-Amz-Target=ElasticMapReduce.DeleteStudioSessionMappingRemoves a user or group from an Amazon EMR Studio.
  • POSTDescribe cluster/#X-Amz-Target=ElasticMapReduce.DescribeClusterProvides cluster-level details including status, hardware and software configuration, VPC settings, and so on.
  • POSTDescribe job flows/#X-Amz-Target=ElasticMapReduce.DescribeJobFlowsDeprecated. This API is no longer supported and will eventually be removed. We recommend you use ListClusters , DescribeCluster , ListSteps ,…
  • POSTDescribe notebook execution/#X-Amz-Target=ElasticMapReduce.DescribeNotebookExecutionProvides details of a notebook execution.
  • POSTDescribe persistent app uI/#X-Amz-Target=ElasticMapReduce.DescribePersistentAppUIDescribes a persistent application user interface.
  • POSTDescribe release label/#X-Amz-Target=ElasticMapReduce.DescribeReleaseLabelProvides Amazon EMR release label details, such as the releases available the Region where the API request is run, and the available applications for a…
  • POSTDescribe security configuration/#X-Amz-Target=ElasticMapReduce.DescribeSecurityConfigurationProvides the details of a security configuration by returning the configuration JSON.
  • POSTDescribe step/#X-Amz-Target=ElasticMapReduce.DescribeStepProvides more detail about the cluster step.
  • POSTDescribe studio/#X-Amz-Target=ElasticMapReduce.DescribeStudioReturns details for the specified Amazon EMR Studio including ID, Name, VPC, Studio access URL, and so on.
  • POSTGet auto termination policy/#X-Amz-Target=ElasticMapReduce.GetAutoTerminationPolicyReturns the auto-termination policy for an Amazon EMR cluster.
  • POSTGet block public access configuration/#X-Amz-Target=ElasticMapReduce.GetBlockPublicAccessConfigurationReturns the Amazon EMR block public access configuration for your Amazon Web Services account in the current Region. For more information see Configure Block…
  • POSTGet cluster session credentials/#X-Amz-Target=ElasticMapReduce.GetClusterSessionCredentialsProvides temporary, HTTP basic credentials that are associated with a given runtime IAM role and used by a cluster with fine-grained access control activated.…
  • POSTGet managed scaling policy/#X-Amz-Target=ElasticMapReduce.GetManagedScalingPolicyFetches the attached managed scaling policy for an Amazon EMR cluster.
  • POSTGet on cluster app uI presigned uRL/#X-Amz-Target=ElasticMapReduce.GetOnClusterAppUIPresignedURLThe presigned URL properties for the cluster's application user interface.
  • POSTGet persistent app uI presigned uRL/#X-Amz-Target=ElasticMapReduce.GetPersistentAppUIPresignedURLThe presigned URL properties for the cluster's application user interface.
  • POSTGet session/#X-Amz-Target=ElasticMapReduce.GetSessionReturns detailed information about a session.
  • POSTGet session endpoint/#X-Amz-Target=ElasticMapReduce.GetSessionEndpointReturns the Spark Connect endpoint URL and a time-limited authentication token for the specified session. Use the endpoint and token to connect a PySpark…
  • POSTGet studio session mapping/#X-Amz-Target=ElasticMapReduce.GetStudioSessionMappingFetches mapping details for the specified Amazon EMR Studio and identity (user or group).
  • POSTList bootstrap actions/#X-Amz-Target=ElasticMapReduce.ListBootstrapActionsProvides information about the bootstrap actions associated with a cluster.
  • POSTList clusters/#X-Amz-Target=ElasticMapReduce.ListClustersProvides 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…
  • POSTList instance fleets/#X-Amz-Target=ElasticMapReduce.ListInstanceFleetsLists 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,…
  • POSTList instance groups/#X-Amz-Target=ElasticMapReduce.ListInstanceGroupsProvides all available details about the instance groups in a cluster.
  • POSTList instances/#X-Amz-Target=ElasticMapReduce.ListInstancesProvides 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…
  • POSTList notebook executions/#X-Amz-Target=ElasticMapReduce.ListNotebookExecutionsProvides 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…
  • POSTList release labels/#X-Amz-Target=ElasticMapReduce.ListReleaseLabelsRetrieves release labels of Amazon EMR services in the Region where the API is called.
  • POSTList security configurations/#X-Amz-Target=ElasticMapReduce.ListSecurityConfigurationsLists all the security configurations visible to this account, providing their creation dates and times, and their names. This call returns a maximum of 50…
  • POSTList sessions/#X-Amz-Target=ElasticMapReduce.ListSessionsLists the sessions on a cluster. You can filter the results by session state. Newer sessions are returned first.
  • POSTList steps/#X-Amz-Target=ElasticMapReduce.ListStepsProvides 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…
  • POSTList studio session mappings/#X-Amz-Target=ElasticMapReduce.ListStudioSessionMappingsReturns a list of all user or group session mappings for the Amazon EMR Studio specified by StudioId .
  • POSTList studios/#X-Amz-Target=ElasticMapReduce.ListStudiosReturns 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…
  • POSTList supported instance types/#X-Amz-Target=ElasticMapReduce.ListSupportedInstanceTypesA list of the instance types that Amazon EMR supports. You can filter the list by Amazon Web Services Region and Amazon EMR release.
  • POSTModify cluster/#X-Amz-Target=ElasticMapReduce.ModifyClusterModifies the number of steps that can be executed concurrently for the cluster specified using ClusterID.
  • POSTModify instance fleet/#X-Amz-Target=ElasticMapReduce.ModifyInstanceFleetModifies the target On-Demand and target Spot capacities for the instance fleet with the specified InstanceFleetID within the cluster specified using…
  • POSTModify instance groups/#X-Amz-Target=ElasticMapReduce.ModifyInstanceGroupsModifyInstanceGroups modifies the number of nodes and configuration settings of an instance group. The input parameters include the new target instance count…
  • POSTPut auto scaling policy/#X-Amz-Target=ElasticMapReduce.PutAutoScalingPolicyCreates 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…
  • POSTPut auto termination policy/#X-Amz-Target=ElasticMapReduce.PutAutoTerminationPolicyAuto-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…
  • POSTPut block public access configuration/#X-Amz-Target=ElasticMapReduce.PutBlockPublicAccessConfigurationCreates or updates an Amazon EMR block public access configuration for your Amazon Web Services account in the current Region. For more information see…
  • POSTPut managed scaling policy/#X-Amz-Target=ElasticMapReduce.PutManagedScalingPolicyCreates or updates a managed scaling policy for an Amazon EMR cluster. The managed scaling policy defines the limits for resources, such as Amazon EC2…
  • POSTRemove auto scaling policy/#X-Amz-Target=ElasticMapReduce.RemoveAutoScalingPolicyRemoves an automatic scaling policy from a specified instance group within an Amazon EMR cluster.
  • POSTRemove auto termination policy/#X-Amz-Target=ElasticMapReduce.RemoveAutoTerminationPolicyRemoves an auto-termination policy from an Amazon EMR cluster.
  • POSTRemove managed scaling policy/#X-Amz-Target=ElasticMapReduce.RemoveManagedScalingPolicyRemoves a managed scaling policy from a specified Amazon EMR cluster.
  • POSTRemove tags/#X-Amz-Target=ElasticMapReduce.RemoveTagsRemoves 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…
  • POSTRun job flow/#X-Amz-Target=ElasticMapReduce.RunJobFlowRunJobFlow 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…
  • POSTSet keep job flow alive when no steps/#X-Amz-Target=ElasticMapReduce.SetKeepJobFlowAliveWhenNoStepsYou can use the SetKeepJobFlowAliveWhenNoSteps to configure a cluster (job flow) to terminate after the step execution, i.e., all your steps are executed. If…
  • POSTSet termination protection/#X-Amz-Target=ElasticMapReduce.SetTerminationProtectionSetTerminationProtection locks a cluster (job flow) so the Amazon EC2 instances in the cluster cannot be terminated by user intervention, an API call, or in…
  • POSTSet unhealthy node replacement/#X-Amz-Target=ElasticMapReduce.SetUnhealthyNodeReplacementSpecify whether to enable unhealthy node replacement, which lets Amazon EMR gracefully replace core nodes on a cluster if any nodes become unhealthy. For…
  • POSTSet visible to all users/#X-Amz-Target=ElasticMapReduce.SetVisibleToAllUsersThe SetVisibleToAllUsers parameter is no longer supported. Your cluster may be visible to all users in your account. To restrict cluster access using an IAM…
  • POSTStart notebook execution/#X-Amz-Target=ElasticMapReduce.StartNotebookExecutionStarts a notebook execution.
  • POSTStart session/#X-Amz-Target=ElasticMapReduce.StartSessionCreates and starts a new Spark Connect session on the specified cluster. The cluster must be in the RUNNING or WAITING state and have sessions enabled. This…
  • POSTStop notebook execution/#X-Amz-Target=ElasticMapReduce.StopNotebookExecutionStops a notebook execution.
  • POSTTerminate job flows/#X-Amz-Target=ElasticMapReduce.TerminateJobFlowsTerminateJobFlows 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…
  • POSTTerminate session/#X-Amz-Target=ElasticMapReduce.TerminateSessionTerminates an active session. After you call this operation, the session enters the TERMINATING state and then transitions to TERMINATED .
  • POSTUpdate studio/#X-Amz-Target=ElasticMapReduce.UpdateStudioUpdates an Amazon EMR Studio configuration, including attributes such as name, description, and subnets.
  • POSTUpdate studio session mapping/#X-Amz-Target=ElasticMapReduce.UpdateStudioSessionMappingUpdates the session policy attached to the user or group for the specified Amazon EMR Studio.

API details

Base URL
https://elasticmapreduce.{region}.amazonaws.com
Authentication
AWS Signature Version 4 (requests signed with your AWS access key)
Operations
65 operations on 65 pathsPOST 65
1 marked deprecated
Description format
AWS Smithy model, API version 2009-03-31

How to test the Amazon EMR in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Amazon EMR collection, without the publisher's secrets.
  3. Add your credentialsThis API uses AWS Signature Version 4 (requests signed with your AWS access key). Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Add instance fleet” (POST /#X-Amz-Target=ElasticMapReduce.AddInstanceFleet), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Amazon EMR?

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… It is listed under Developer tools and has 65 endpoints.

Who publishes the Amazon EMR?

It is listed from Amazon Web Services, Inc.'s public API description (an OpenAPI document), not published by Amazon Web Services, Inc. on Swastik Codes. Anyone who controls amazonaws.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Amazon EMR?

Requests go to https://elasticmapreduce.{region}.amazonaws.com. Endpoint paths are added to this base URL.

How do I authenticate with the Amazon EMR?

With AWS Signature Version 4 (requests signed with your AWS access key).

How many endpoints does the Amazon EMR have?

65 operations on 65 paths (65 POST).

Is forking the Amazon EMR free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.