Own AWS? Customize your docs with AI search, analytics, and more.

POST

/virtualclusters/{virtualClusterId}/endpoints

http://emr-containers.{region}.amazonaws.com/virtualclusters/{virtualClusterId}/endpoints

Creates a managed endpoint. A managed endpoint is a gateway that connects Amazon EMR Studio to Amazon EMR on EKS so that Amazon EMR Studio can communicate with your virtual cluster.

Access Token Required: API Key

Path Parameters

virtualClusterIdstringrequired

The ID of the virtual cluster for which a managed endpoint is created.

Body Params

namestringrequired

The name of the managed endpoint.

tagsobject

The tags of the managed endpoint.

typestringrequired

The type of the managed endpoint.

clientTokenstringrequired

The client idempotency token for this create call.

releaseLabelstringrequired

The Amazon EMR release version.

certificateArnstring

The certificate ARN provided by users for the managed endpoint. This field is under deprecation and will be removed in future releases.

executionRoleArnstringrequired

The ARN of the execution role.

configurationOverridesobject

A configuration specification to be used to override existing configurations.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'http://emr-containers.{region}.amazonaws.com/virtualclusters/{virtualClusterId}/endpoints' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}