Amazon Web Services, Inc.

EMR Serverless

Amazon EMR Serverless is a new deployment option for Amazon EMR. Amazon EMR Serverless provides a serverless runtime environment that simplifies running…

Developer tools#openapi

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 Serverless is a new deployment option for Amazon EMR. Amazon EMR Serverless provides a serverless runtime environment that simplifies running analytics applications using the latest open source frameworks such as Apache Spark and Apache Hive. With Amazon EMR Serverless, you don’t have to configure, optimize, secure, or operate clusters to run applications with these frameworks. The API reference to Amazon EMR Serverless is emr-serverless . The emr-serverless prefix is used in the following scenarios: It is the prefix in the CLI commands for Amazon EMR Serverless. For example, aws emr-serverless start-job-run . It is the prefix before IAM policy actions for Amazon EMR Serverless. For example, "Action": ["emr-serverless:StartJobRun"] . For more information, see Policy actions for Amazon EMR Serverless . It is the prefix used in Amazon EMR Serverless service endpoints. For example, emr-serverless.us-east-2.amazonaws.com .

Endpoints 22

Job run

  • GETGet job run/applications/:applicationId/jobruns/:jobRunId?attempt=0Displays detailed information about a job run.
  • DELETECancel job run/applications/:applicationId/jobruns/:jobRunId?shutdownGracePeriodInSeconds=0Cancels a job run.
  • GETGet dashboard for job run/applications/:applicationId/jobruns/:jobRunId/dashboard?attempt=0&accessSystemProfileLogs=trueCreates and returns a URL that you can use to access the application UIs for a job run. For jobs in a running state, the application UI is a live user…
  • GETList job run attempts/applications/:applicationId/jobruns/:jobRunId/attempts?nextToken=string&maxResults=0Lists all attempt of a job run.
  • GETList job runs/applications/:applicationId/jobruns?nextToken=string&maxResults=0&createdAtAfter=string&createdAtBefore=string&states=&mode=stringLists job runs based on a set of parameters.
  • POSTStart job run/applications/:applicationId/jobrunsStarts a job run.

Application

  • GETList applications/applications?nextToken=string&maxResults=0&states=Lists applications based on a set of parameters.
  • POSTCreate application/applicationsCreates an application.
  • GETGet application/applications/:applicationIdDisplays detailed information about a specified application.
  • DELETEDelete application/applications/:applicationIdDeletes an application. An application has to be in a stopped or created state in order to be deleted.
  • PATCHUpdate application/applications/:applicationIdUpdates a specified application. An application has to be in a stopped or created state in order to be updated.
  • GETGet resource dashboard/applications/:applicationId/dashboard?resourceId=string&resourceType=string&accessSystemProfileLogs=trueReturns a URL that you can use to access the application UIs for a specified resource, such as a session. For resources in a running state, the application UI…
  • POSTStart application/applications/:applicationId/startStarts a specified application and initializes initial capacity if configured.
  • POSTStop application/applications/:applicationId/stopStops a specified application and releases initial capacity if configured. All scheduled and running jobs must be completed or cancelled before stopping an…

Session

  • GETGet session/applications/:applicationId/sessions/:sessionIdDisplays detailed information about a session.
  • DELETETerminate session/applications/:applicationId/sessions/:sessionIdTerminates the specified session. After you terminate a session, it enters the TERMINATING state and then the TERMINATED state. You can still access the Spark…
  • GETGet session endpoint/applications/:applicationId/sessions/:sessionId/endpointReturns the session endpoint URL and a time-limited authentication token for the specified session. Use the endpoint and token to connect a client to the…
  • GETList sessions/applications/:applicationId/sessions?nextToken=string&maxResults=0&states=&createdAtAfter=string&createdAtBefore=stringLists sessions for the specified application. You can filter sessions by state and creation time.
  • POSTStart session/applications/:applicationId/sessionsCreates and starts a new session on the specified application. The application must be in the STARTED state or have AutoStart enabled, and have interactive…
  • GETList tags for resource/tags/:resourceArnLists the tags assigned to the resources.
  • POSTTag resource/tags/:resourceArnAssigns tags to resources. A tag is a label that you assign to an Amazon Web Services resource. Each tag consists of a key and an optional value, both of…
  • DELETEUntag resource/tags/:resourceArn?tagKeys=Removes tags from resources.

API details

Base URL
https://emr-serverless.{region}.amazonaws.com
Authentication
AWS Signature Version 4 (requests signed with your AWS access key)
Operations
22 operations on 13 pathsGET 11POST 6DELETE 4PATCH 1
Main resources
Application 8Job run 6Session 5
Description format
AWS Smithy model, API version 2021-07-13

How to test the EMR Serverless 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 EMR Serverless 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 “Get job run” (GET /applications/:applicationId/jobruns/:jobRunId?attempt=0), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the EMR Serverless?

Amazon EMR Serverless is a new deployment option for Amazon EMR. Amazon EMR Serverless provides a serverless runtime environment that simplifies running… It is listed under Developer tools and has 22 endpoints.

Who publishes the EMR Serverless?

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 EMR Serverless?

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

How do I authenticate with the EMR Serverless?

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

How many endpoints does the EMR Serverless have?

22 operations on 13 paths (11 GET, 6 POST, 4 DELETE, 1 PATCH). The largest groups are Application, Job run, Session.

Is forking the EMR Serverless 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.