Actions, resources, and condition keys for Amazon Elastic MapReduce
Amazon Elastic MapReduce (service prefix: elasticmapreduce) provides the following
service-specific operations, resources, actions, and condition keys for use in IAM permission
policies.
References:
-
Learn how to configure this service.
-
View a list of the API operations available for this service.
-
Learn how to secure this service and its resources by using IAM permission policies.
-
View the programmatic service authorization reference
for this service.
Topics
API operations defined by Amazon Elastic MapReduce
The following table maps API operations to the IAM actions they authorize. Only condition keys that have static values for the given API and action are listed; for the full set of condition keys supported by each action, see the Actions table.
| Operation | IAM action | Condition key | Possible value(s) | Access level |
|---|---|---|---|---|
|
AddInstanceFleet |
Write |
|||
|
AddInstanceGroups |
Write |
|||
|
AddJobFlowSteps |
Write |
|||
|
AddTags |
Tagging, Write |
|||
|
CancelSteps |
Write |
|||
|
CreatePersistentAppUI |
Write |
|||
Tagging, Write |
||||
Write |
||||
|
CreateSecurityConfiguration |
Write |
|||
|
CreateStudio |
Tagging, Write |
|||
Write |
||||
Write |
||||
|
CreateStudioSessionMapping |
Write |
|||
|
DeleteSecurityConfiguration |
Write |
|||
|
DeleteStudio |
Write |
|||
|
DeleteStudioSessionMapping |
Write |
|||
|
DescribeCluster |
Read |
|||
|
DescribeJobFlows |
Read |
|||
|
DescribeNotebookExecution |
Read |
|||
|
DescribePersistentAppUI |
Read |
|||
|
DescribeReleaseLabel |
Read |
|||
|
DescribeSecurityConfiguration |
Read |
|||
|
DescribeStep |
Read |
|||
|
DescribeStudio |
Read |
|||
|
GetAutoTerminationPolicy |
Read |
|||
|
GetBlockPublicAccessConfiguration |
Read |
|||
|
GetClusterSessionCredentials |
Write |
|||
|
GetManagedScalingPolicy |
Read |
|||
|
GetOnClusterAppUIPresignedURL |
Write |
|||
|
GetPersistentAppUIPresignedURL |
Write |
|||
|
GetStudioSessionMapping |
Read |
|||
|
ListBootstrapActions |
Read |
|||
|
ListClusters |
List |
|||
|
ListInstanceFleets |
Read |
|||
|
ListInstanceGroups |
Read |
|||
|
ListInstances |
Read |
|||
|
ListNotebookExecutions |
List |
|||
|
ListReleaseLabels |
List |
|||
|
ListSecurityConfigurations |
List |
|||
|
ListSteps |
Read |
|||
|
ListStudioSessionMappings |
List |
|||
|
ListStudios |
List |
|||
|
ListSupportedInstanceTypes |
List |
|||
|
ModifyCluster |
Write |
|||
|
ModifyInstanceFleet |
Write |
|||
|
ModifyInstanceGroups |
Write |
|||
|
PutAutoScalingPolicy |
Write |
|||
|
PutAutoTerminationPolicy |
Write |
|||
|
PutBlockPublicAccessConfiguration |
Permissions management, Write |
|||
|
PutManagedScalingPolicy |
Write |
|||
|
RemoveAutoScalingPolicy |
Write |
|||
|
RemoveAutoTerminationPolicy |
Write |
|||
|
RemoveManagedScalingPolicy |
Write |
|||
|
RemoveTags |
Tagging, Write |
|||
|
RunJobFlow |
Tagging, Write |
|||
Write |
||||
iam:PassedToService |
application-autoscaling.amazonaws.com, ec2.amazonaws.com, elasticmapreduce.amazonaws.com |
Write |
||
|
SetKeepJobFlowAliveWhenNoSteps |
Write |
|||
|
SetTerminationProtection |
Write |
|||
|
SetUnhealthyNodeReplacement |
Write |
|||
|
SetVisibleToAllUsers |
Write |
|||
|
StartNotebookExecution |
Tagging, Write |
|||
Write |
||||
Write |
||||
|
StartSession |
Tagging, Write |
|||
iam:PassedToService |
elasticmapreduce.amazonaws.com |
Write |
||
|
StopNotebookExecution |
Write |
|||
|
TerminateJobFlows |
Write |
|||
|
UpdateStudio |
Write |
|||
Write |
||||
|
UpdateStudioSessionMapping |
Write |
Actions defined by Amazon Elastic MapReduce
You can specify the following actions in the Action element of an IAM
policy statement. Use policies to grant permissions to perform an operation in Amazon. When
you use an action in a policy, you usually allow or deny access to the API operation or CLI
command with the same name. However, in some cases, a single action controls access to more
than one operation. Alternatively, some operations require several different actions.
| Actions | Description | Resource types (*required) | Condition keys | Access level |
|---|---|---|---|---|
Grants permission to view all event logs in a persistent application history server |
Write |
|||
Grants permission to add an instance fleet to a running cluster |
Write |
|||
Grants permission to add instance groups to a running cluster |
Write |
|||
Grants permission to add new steps to a running cluster |
Write |
|||
Grants permission to add tags to an Amazon EMR resource |
Tagging, Write |
|||
Grants permission to cancel a pending step or steps in a running cluster |
Write |
|||
Grants permission to create a persistent application history server |
Write |
|||
Grants permission to create a security configuration |
Write |
|||
Grants permission to create an EMR Studio |
Write |
|||
Grants permission to launch an EMR Studio using IAM authentication mode |
Write |
|||
Grants permission to create an EMR Studio session mapping |
Write |
|||
Grants permission to delete a security configuration |
Write |
|||
Grants permission to delete an EMR Studio |
Write |
|||
Grants permission to delete an EMR Studio session mapping |
Write |
|||
Grants permission to get details about a cluster, including status, hardware and software configuration, VPC settings, and so on |
Read |
|||
Grants permission to describe details of clusters (job flows). This API is deprecated and will eventually be removed. We recommend you use ListClusters, DescribeCluster, ListSteps, ListInstanceGroups and ListBootstrapActions instead |
Read |
|||
Grants permission to view information about a notebook execution |
Read |
|||
Grants permission to describe a persistent application history server |
Read |
|||
Grants permission to view information about an EMR release, such as which applications are supported |
Read |
|||
Grants permission to get details of a security configuration |
Read |
|||
Grants permission to get details about a cluster step |
Read |
|||
Grants permission to view information about an EMR Studio |
Read |
|||
Grants permission to retrieve the auto-termination policy associated with a cluster |
Read |
|||
Grants permission to retrieve the EMR block public access configuration for the Amazon Web Services account in the Region |
Read |
|||
Grants permission to retrieve HTTP basic credentials associated with a given execution IAM Role for a fine-grained access control enabled EMR Cluster |
Write |
|||
Grants permission to retrieve the managed scaling policy associated with a cluster |
Read |
|||
Grants permission to get a presigned URL for an application history server running on the cluster |
Write |
|||
Grants permission to get a presigned URL for a persistent application history server |
Write |
|||
Grants permission to view information about an EMR Studio session mapping |
Read |
|||
Grants permission to get details about the bootstrap actions associated with a cluster |
Read |
|||
Grants permission to get the status of accessible clusters |
List |
|||
Grants permission to get details of instance fleets in a cluster |
Read |
|||
Grants permission to get details of instance groups in a cluster |
Read |
|||
Grants permission to get details about the Amazon EC2 instances in a cluster |
Read |
|||
Grants permission to list summary information for notebook executions |
List |
|||
Grants permission to list and filter the available EMR releases in the current region |
List |
|||
Grants permission to list available security configurations in this account by name, along with creation dates and times |
List |
|||
Grants permission to list steps associated with a cluster |
Read |
|||
Grants permission to list summary information about EMR Studio session mappings |
List |
|||
Grants permission to list summary information about EMR Studios |
List |
|||
Grants permission to list the Amazon EC2 instance types that an Amazon EMR release supports |
List |
|||
Grants permission to change cluster settings such as number of steps that can be executed concurrently for a cluster |
Write |
|||
Grants permission to change the target On-Demand and target Spot capacities for a instance fleet |
Write |
|||
Grants permission to change the number and configuration of EC2 instances for an instance group |
Write |
|||
Grants permission to create or update an automatic scaling policy for a core instance group or task instance group |
Write |
|||
Grants permission to create or update the auto-termination policy associated with a cluster |
Write |
|||
Grants permission to create or update the EMR block public access configuration for the Amazon Web Services account in the Region |
Permissions management, Write |
|||
Grants permission to create or update the managed scaling policy associated with a cluster |
Write |
|||
Grants permission to remove an automatic scaling policy from an instance group |
Write |
|||
Grants permission to remove the auto-termination policy associated with a cluster |
Write |
|||
Grants permission to remove the managed scaling policy associated with a cluster |
Write |
|||
Grants permission to remove tags from an Amazon EMR resource |
Tagging, Write |
|||
Grants permission to create and launch a cluster (job flow) |
Write |
|||
Grants permission to add and remove auto terminate after step execution for a cluster |
Write |
|||
Grants permission to add and remove termination protection for a cluster |
Write |
|||
Grants permission to enable or disable unhealthy node replacement for a cluster |
Write |
|||
Grants permission to set whether all Amazon Identity and Access Management (IAM) users in the Amazon Web Services account can view a cluster. This API is deprecated and your cluster may be visible to all users in your account. To restrict cluster access using an IAM policy, see Amazon Identity and Access Management for Amazon EMR (https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-access-iam.html) |
Write |
|||
Grants permission to start an EMR notebook execution |
Write |
|||
Grants permission to stop notebook execution |
Write |
|||
Grants permission to terminate a cluster (job flow) |
Write |
|||
Grants permission to update information about an EMR Studio |
Write |
|||
Grants permission to update an EMR Studio session mapping |
Write |
Permission-only actions for Amazon Elastic MapReduce
The following actions are defined by Amazon Elastic MapReduce but are not directly invocable through any API operation. They can only be used in IAM policy statements to grant or deny permissions.
| Actions | Description | Resource types (*required) | Condition keys | Access level |
|---|---|---|---|---|
Grants permission to attach an EMR notebook to a compute engine |
Write |
|||
Grants permission to create an EMR notebook |
Write |
|||
Grants permission to create an EMR notebook repository |
Write |
|||
Grants permission to delete an EMR notebook |
Write |
|||
Grants permission to delete an EMR notebook repository |
Write |
|||
Grants permission to block an identity from opening a collaborative workspace |
Permissions management, Write |
|||
Grants permission to view information about a notebook, including status, user, role, tags, location, and more |
Read |
|||
Grants permission to describe an EMR notebook repository |
Read |
|||
Grants permission to detach an EMR notebook from a compute engine |
Write |
|||
Grants permission to link an EMR notebook repository to EMR notebooks |
Write |
|||
Grants permission to list summary information for accessible EMR notebooks |
List |
|||
Grants permission to list existing EMR notebook repositories |
List |
|||
Grants permission to list identities that are granted access to a workspace |
List |
|||
Grants permission to launch the Jupyter notebook editor for an EMR notebook from within the console |
Write |
|||
Grants permission to allow an identity to open a collaborative workspace |
Permissions management, Write |
|||
Grants permission to start an EMR notebook |
Write |
|||
Grants permission to shut down an EMR notebook |
Write |
|||
Grants permission to unlink an EMR notebook repository from EMR notebooks |
Write |
|||
Grants permission to update an EMR notebook |
Write |
|||
Grants permission to update an EMR notebook repository |
Write |
|||
Grants permission to use the EMR console to view events from all clusters |
List |
Resource types defined by Amazon Elastic MapReduce
The following resource types are defined by this service and can be used in the
Resource element of IAM permission policy statements.
| Resource types | ARN | Condition keys |
|---|---|---|
arn:${Partition}:elasticmapreduce:${Region}:${Account}:cluster/${ClusterId} |
||
arn:${Partition}:elasticmapreduce:${Region}:${Account}:editor/${EditorId} |
||
arn:${Partition}:elasticmapreduce:${Region}:${Account}:notebook-execution/${NotebookExecutionId} |
||
arn:${Partition}:elasticmapreduce:${Region}:${Account}:studio/${StudioId} |
Condition keys for Amazon Elastic MapReduce
Amazon Elastic MapReduce defines the following condition keys that can be used in the
Condition element of an IAM policy.
| Condition keys | Description | Type |
|---|---|---|
Filters access by whether the tag and value pair is provided with the action |
String |
|
Filters access by the tag and value pair associated with an Amazon EMR resource |
String |
|
Filters access by whether the tag keys are provided with the action regardless of tag value |
ArrayOfString |
|
Filters access by whether the execution role ARN is provided with the action |
ARN |
|
Filters access by whether the tag and value pair is provided with the action |
String |
|
Filters access by the tag and value pair associated with an Amazon EMR resource |
String |