# Amazon EMR Containers API > Amazon EMR Containers API on Apizie: 20 endpoints (Displays detailed information about a job run. A job run is a unit of work, such as a Spark jar, PySpark…, Cancels a job run. A job run is a unit of work, such as a Spark jar, PySpark script, or SparkSQL query, that…, Lists job templates based on a set of parameters. Job template stores values of StartJobRun API request in a…, Creates a job template. Job template stores values of StartJobRun API request in a template and can be used…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month. - Project key: `cloud:amazonaws-emr-containers` - Category: Cloud - Status: byok - Source: https://github.com/mermade/aws2openapi - Page: https://zieapi.vercel.app/api/cloud/amazonaws-emr-containers - OpenAPI: https://zieapi.vercel.app/api/cloud/amazonaws-emr-containers/openapi.json Amazon EMR on EKS provides a deployment option for Amazon EMR that allows you to run open-source big data frameworks on Amazon Elastic Kubernetes Service (Amazon EKS). With this deployment option, you can focus on… ## Endpoints ### Displays detailed information about a job run. A job run is a unit of work, such as a Spark jar, PySpark… `GET https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/describe-job-run` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | jobRunId | string | yes | The ID of the job run request. | | virtualClusterId | string | yes | The ID of the virtual cluster for which the job run is submitted. | ### Cancels a job run. A job run is a unit of work, such as a Spark jar, PySpark script, or SparkSQL query, that… `POST https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/cancel-job-run` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | jobRunId | string | yes | The ID of the job run to cancel. | | virtualClusterId | string | yes | The ID of the virtual cluster for which the job run will be canceled. | ### Lists job templates based on a set of parameters. Job template stores values of StartJobRun API request in a… `GET https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/list-job-templates` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | createdAfter | string | no | The date and time after which the job templates were created. | | createdBefore | string | no | The date and time before which the job templates were created. | | maxResults | integer | no | The maximum number of job templates that can be listed. | | nextToken | string | no | The token for the next set of job templates to return. | ### Creates a job template. Job template stores values of StartJobRun API request in a template and can be used… `POST https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/create-job-template` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | body | object | yes | JSON request body | ### Lists managed endpoints based on a set of parameters. A managed endpoint is a gateway that connects Amazon… `GET https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/list-managed-endpoints` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | virtualClusterId | string | yes | The ID of the virtual cluster. | | createdBefore | string | no | The date and time before which the endpoints are created. | | createdAfter | string | no | The date and time after which the endpoints are created. | | types | array | no | The types of the managed endpoints. | | states | array | no | The states of the managed endpoints. | | maxResults | integer | no | The maximum number of managed endpoints that can be listed. | | nextToken | string | no | The token for the next set of managed endpoints to return. | ### Creates a managed endpoint. A managed endpoint is a gateway that connects Amazon EMR Studio to Amazon EMR on… `POST https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/create-managed-endpoint` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | virtualClusterId | string | yes | The ID of the virtual cluster for which a managed endpoint is created. | | body | object | yes | JSON request body | ### Lists information about the specified virtual cluster. Virtual cluster is a managed entity on Amazon EMR on… `GET https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/list-virtual-clusters` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | containerProviderId | string | no | The container provider ID of the virtual cluster. | | containerProviderType | string | no | The container provider type of the virtual cluster. Amazon EKS is the only supported type as of now. | | createdAfter | string | no | The date and time after which the virtual clusters are created. | | createdBefore | string | no | The date and time before which the virtual clusters are created. | | states | array | no | The states of the requested virtual clusters. | | maxResults | integer | no | The maximum number of virtual clusters that can be listed. | | nextToken | string | no | The token for the next set of virtual clusters to return. | ### Creates a virtual cluster. Virtual cluster is a managed entity on Amazon EMR on EKS. You can create,… `POST https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/create-virtual-cluster` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | body | object | yes | JSON request body | ### Displays detailed information about a specified job template. Job template stores values of StartJobRun API… `GET https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/describe-job-template` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | templateId | string | yes | The ID of the job template that will be described. | ### Deletes a job template. Job template stores values of StartJobRun API request in a template and can be used… `POST https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/delete-job-template` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | templateId | string | yes | The ID of the job template that will be deleted. | ### Displays detailed information about a managed endpoint. A managed endpoint is a gateway that connects Amazon… `GET https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/describe-managed-endpoint` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | endpointId | string | yes | This output displays ID of the managed endpoint. | | virtualClusterId | string | yes | The ID of the endpoint's virtual cluster. | ### Deletes a managed endpoint. A managed endpoint is a gateway that connects Amazon EMR Studio to Amazon EMR on… `POST https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/delete-managed-endpoint` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | endpointId | string | yes | The ID of the managed endpoint. | | virtualClusterId | string | yes | The ID of the endpoint's virtual cluster. | ### Displays detailed information about a specified virtual cluster. Virtual cluster is a managed entity on… `GET https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/describe-virtual-cluster` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | virtualClusterId | string | yes | The ID of the virtual cluster that will be described. | ### Deletes a virtual cluster. Virtual cluster is a managed entity on Amazon EMR on EKS. You can create,… `POST https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/delete-virtual-cluster` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | virtualClusterId | string | yes | The ID of the virtual cluster that will be deleted. | ### Generate a session token to connect to a managed endpoint. `POST https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/get-managed-endpoint-session-credentials` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | endpointId | string | yes | The ARN of the managed endpoint for which the request is submitted. | | virtualClusterId | string | yes | The ARN of the Virtual Cluster which the Managed Endpoint belongs to. | | body | object | yes | JSON request body | ### Lists job runs based on a set of parameters. A job run is a unit of work, such as a Spark jar, PySpark… `GET https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/list-job-runs` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | virtualClusterId | string | yes | The ID of the virtual cluster for which to list the job run. | | createdBefore | string | no | The date and time before which the job runs were submitted. | | createdAfter | string | no | The date and time after which the job runs were submitted. | | name | string | no | The name of the job run. | | states | array | no | The states of the job run. | | maxResults | integer | no | The maximum number of job runs that can be listed. | | nextToken | string | no | The token for the next set of job runs to return. | ### Starts a job run. A job run is a unit of work, such as a Spark jar, PySpark script, or SparkSQL query, that… `POST https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/start-job-run` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | virtualClusterId | string | yes | The virtual cluster ID for which the job run request is submitted. | | body | object | yes | JSON request body | ### Lists the tags assigned to the resources. `GET https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/list-tags-for-resource` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | resourceArn | string | yes | The ARN of tagged resources. | ### Assigns tags to resources. A tag is a label that you assign to an Amazon Web Services resource. Each tag… `POST https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/tag-resource` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | resourceArn | string | yes | The ARN of resources. | | body | object | yes | JSON request body | ### Removes tags from resources. `POST https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/untag-resource` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | resourceArn | string | yes | The ARN of resources. | | tagKeys | array | yes | The tag keys of the resources. | ## Example ``` curl "https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/describe-job-run" \ -H "x-api-key: $APIZIE_KEY" \ -H "x-upstream-key: $PROVIDER_KEY" ``` ## FAQ ### How do I call the Amazon EMR Containers API? Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/cloud:amazonaws-emr-containers/describe-job-run with the header x-api-key. Every endpoint returns { project, data, timestamp }. ### Is the Amazon EMR Containers API free on Apizie? Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Amazon EMR Containers itself also needs your own key from amazonaws.com. ### Can AI agents use the Amazon EMR Containers API? Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:amazonaws-emr-containers. ### What is the status of the Amazon EMR Containers API? Needs your own provider key (bring your own key)