Actions, resources, and condition keys for Amazon EMR Serverless
Amazon EMR Serverless (service prefix: emr-serverless) 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 EMR Serverless
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 |
|---|---|---|---|---|
|
CancelJobRun |
Write |
|||
|
CreateApplication |
Write |
|||
Tagging, Write |
||||
|
DeleteApplication |
Write |
|||
|
GetApplication |
Read |
|||
|
GetDashboardForJobRun |
Write |
|||
Read |
||||
Read |
||||
Read |
||||
|
GetJobRun |
Read |
|||
|
GetResourceDashboard |
Read |
|||
|
GetSession |
Read |
|||
|
GetSessionEndpoint |
Read |
|||
|
ListApplications |
List |
|||
|
ListJobRunAttempts |
List |
|||
|
ListJobRuns |
List |
|||
|
ListSessions |
List |
|||
|
ListTagsForResource |
Read |
|||
|
StartApplication |
Write |
|||
|
StartJobRun |
Write |
|||
Tagging, Write |
||||
iam:PassedToService |
emr-serverless.amazonaws.com |
Write |
||
|
StartSession |
Write |
|||
Tagging, Write |
||||
iam:PassedToService |
emr-serverless.amazonaws.com |
Write |
||
|
StopApplication |
Write |
|||
|
TagResource |
Tagging, Write |
|||
|
TerminateSession |
Write |
|||
|
UntagResource |
Tagging, Write |
|||
|
UpdateApplication |
Write |
Actions defined by Amazon EMR Serverless
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 cancel a job run |
Write |
|||
Grants permission to create an Application |
Write |
|||
Grants permission to delete an application |
Write |
|||
Grants permission to get application |
Read |
|||
Grants permission to get job run dashboard |
Read |
|||
Grants permission to get a job run |
Read |
|||
Grants permission to get the resource dashboard |
Read |
|||
Grants permission to get details about a session |
Read |
|||
Grants permission to get the endpoint URL and authentication token for connecting to a session |
Read |
|||
Grants permission to list applications |
List |
|||
Grants permission to list job run attempts associated with a job run |
List |
|||
Grants permission to list job runs associated with an application |
List |
|||
Grants permission to list sessions associated with an application |
List |
|||
Grants permission to list tags for the specified resource |
Read |
|||
Grants permission to Start an application |
Write |
|||
Grants permission to start a job run |
Write |
|||
Grants permission to start a session in an application |
Write |
|||
Grants permission to Stop an application |
Write |
|||
Grants permission to tag the specified resource |
Tagging, Write |
|||
Grants permission to terminate a session |
Write |
|||
Grants permission to untag the specified resource |
Tagging, Write |
|||
Grants permission to Update an application |
Write |
Permission-only actions for Amazon EMR Serverless
The following actions are defined by Amazon EMR Serverless 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 execute interactive workloads on an application |
Write |
|||
Grants permission to execute interactive workloads on Livy Endpoint enabled on an EMR Serverless Application |
Write |
|||
Grants permission to access system profile logs |
Write |
Resource types defined by Amazon EMR Serverless
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}:emr-serverless:${Region}:${Account}:/applications/${ApplicationId} |
||
arn:${Partition}:emr-serverless:${Region}:${Account}:/applications/${ApplicationId}/jobruns/${JobRunId} |
||
arn:${Partition}:emr-serverless:${Region}:${Account}:/applications/${ApplicationId}/sessions/${SessionId} |
Condition keys for Amazon EMR Serverless
Amazon EMR Serverless defines the following condition keys that can be used in the
Condition element of an IAM policy.
| Condition keys | Description | Type |
|---|---|---|
Filters access by the presence of tag key-value pairs in the request |
String |
|
Filters access by tag key-value pairs attached to the resource |
String |
|
Filters access by the presence of tag keys in the request |
ArrayOfString |