Amazon EMR Emr Studio Session Mapping API
The Emr Studio Session Mapping API from Amazon EMR — 5 operation(s) for emr studio session mapping.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/amazon-emr:amazon-emr-studio-session-mapping-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Amazon EMR Studio Session Mapping API
version: '2009-03-31'
description: Generated from AWS's published Smithy model for Amazon EMR. 5 operation(s).
contact:
name: Amazon Web Services
url: https://aws.amazon.com/contact-us/
license:
name: Apache 2.0
identifier: Apache-2.0
url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://elasticmapreduce.{region}.amazonaws.com
variables:
region:
default: us-east-1
security:
- sigv4: []
tags:
- name: Studio Session Mapping
paths:
/#CreateStudioSessionMapping:
post:
operationId: CreateStudioSessionMapping
summary: Create Studio Session Mapping
description: Maps a user or group to the Amazon EMR Studio specified by StudioId, and applies a session policy to refine Studio permissions for that user or group. Use CreateStudioSessionMapping to assign users to a Studio when you use IAM Identity Center authentication. For instructions on how to assign users to a Studio when you use IAM authentication, see Assign a user or group to your EMR Studio.
responses:
'200':
description: Success
content:
application/x-amz-json-1.1:
schema:
type: string
'500':
description: InternalServerError
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/InternalServerError'
'400':
description: InvalidRequestException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/InvalidRequestException'
parameters:
- name: X-Amz-Target
in: header
required: true
schema:
type: string
enum:
- ElasticMapReduce.CreateStudioSessionMapping
requestBody:
required: true
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/CreateStudioSessionMappingInput'
tags:
- Studio Session Mapping
/#DeleteStudioSessionMapping:
post:
operationId: DeleteStudioSessionMapping
summary: Delete Studio Session Mapping
description: Removes a user or group from an Amazon EMR Studio.
responses:
'200':
description: Success
content:
application/x-amz-json-1.1:
schema:
type: string
'500':
description: InternalServerError
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/InternalServerError'
'400':
description: InvalidRequestException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/InvalidRequestException'
parameters:
- name: X-Amz-Target
in: header
required: true
schema:
type: string
enum:
- ElasticMapReduce.DeleteStudioSessionMapping
requestBody:
required: true
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/DeleteStudioSessionMappingInput'
tags:
- Studio Session Mapping
/#GetStudioSessionMapping:
post:
operationId: GetStudioSessionMapping
summary: Get Studio Session Mapping
description: Fetches mapping details for the specified Amazon EMR Studio and identity (user or group).
responses:
'200':
description: Success
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/GetStudioSessionMappingOutput'
'500':
description: InternalServerError
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/InternalServerError'
'400':
description: InvalidRequestException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/InvalidRequestException'
parameters:
- name: X-Amz-Target
in: header
required: true
schema:
type: string
enum:
- ElasticMapReduce.GetStudioSessionMapping
requestBody:
required: true
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/GetStudioSessionMappingInput'
tags:
- Studio Session Mapping
/#ListStudioSessionMappings:
post:
operationId: ListStudioSessionMappings
summary: List Studio Session Mappings
description: Returns a list of all user or group session mappings for the Amazon EMR Studio specified by StudioId.
responses:
'200':
description: Success
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/ListStudioSessionMappingsOutput'
'500':
description: InternalServerError
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/InternalServerError'
'400':
description: InvalidRequestException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/InvalidRequestException'
parameters:
- name: X-Amz-Target
in: header
required: true
schema:
type: string
enum:
- ElasticMapReduce.ListStudioSessionMappings
requestBody:
required: true
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/ListStudioSessionMappingsInput'
tags:
- Studio Session Mapping
/#UpdateStudioSessionMapping:
post:
operationId: UpdateStudioSessionMapping
summary: Update Studio Session Mapping
description: Updates the session policy attached to the user or group for the specified Amazon EMR Studio.
responses:
'200':
description: Success
content:
application/x-amz-json-1.1:
schema:
type: string
'500':
description: InternalServerError
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/InternalServerError'
'400':
description: InvalidRequestException
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/InvalidRequestException'
parameters:
- name: X-Amz-Target
in: header
required: true
schema:
type: string
enum:
- ElasticMapReduce.UpdateStudioSessionMapping
requestBody:
required: true
content:
application/x-amz-json-1.1:
schema:
$ref: '#/components/schemas/UpdateStudioSessionMappingInput'
tags:
- Studio Session Mapping
components:
schemas:
ListStudioSessionMappingsOutput:
type: object
properties:
SessionMappings:
type: array
items:
$ref: '#/components/schemas/SessionMappingSummary'
description: A list of session mapping summary objects. Each object includes session mapping details such as creation time, identity type (user or group), and Amazon EMR Studio ID.
Marker:
type: string
description: The pagination token that indicates the next set of results to retrieve.
CreateStudioSessionMappingInput:
type: object
properties:
StudioId:
type: string
description: The ID of the Amazon EMR Studio to which the user or group will be mapped.
IdentityId:
type: string
description: The globally unique identifier (GUID) of the user or group from the IAM Identity Center Identity Store. For more information, see UserId and GroupId in the IAM Identity Center Identity Store API Reference. Either IdentityName or IdentityId must be specified, but not both.
IdentityName:
type: string
description: The name of the user or group. For more information, see UserName and DisplayName in the IAM Identity Center Identity Store API Reference. Either IdentityName or IdentityId must be specified, but not both.
IdentityType:
type: string
enum:
- USER
- GROUP
description: Specifies whether the identity to map to the Amazon EMR Studio is a user or a group.
SessionPolicyArn:
type: string
description: The Amazon Resource Name (ARN) for the session policy that will be applied to the user or group. You should specify the ARN for the session policy that you want to apply, not the ARN of your user role. For more information, see Create an Amazon EMR Studio User Role with Session Policies.
required:
- StudioId
- IdentityType
- SessionPolicyArn
DeleteStudioSessionMappingInput:
type: object
properties:
StudioId:
type: string
description: The ID of the Amazon EMR Studio.
IdentityId:
type: string
description: The globally unique identifier (GUID) of the user or group to remove from the Amazon EMR Studio. For more information, see UserId and GroupId in the IAM Identity Center Identity Store API Reference. Either IdentityName or IdentityId must be specified.
IdentityName:
type: string
description: The name of the user name or group to remove from the Amazon EMR Studio. For more information, see UserName and DisplayName in the IAM Identity Center Store API Reference. Either IdentityName or IdentityId must be specified.
IdentityType:
type: string
enum:
- USER
- GROUP
description: Specifies whether the identity to delete from the Amazon EMR Studio is a user or a group.
required:
- StudioId
- IdentityType
GetStudioSessionMappingOutput:
type: object
properties:
SessionMapping:
$ref: '#/components/schemas/SessionMappingDetail'
ListStudioSessionMappingsInput:
type: object
properties:
StudioId:
type: string
description: The ID of the Amazon EMR Studio.
IdentityType:
type: string
enum:
- USER
- GROUP
description: Specifies whether to return session mappings for users or groups. If not specified, the results include session mapping details for both users and groups.
Marker:
type: string
description: The pagination token that indicates the set of results to retrieve.
UpdateStudioSessionMappingInput:
type: object
properties:
StudioId:
type: string
description: The ID of the Amazon EMR Studio.
IdentityId:
type: string
description: The globally unique identifier (GUID) of the user or group. For more information, see UserId and GroupId in the IAM Identity Center Identity Store API Reference. Either IdentityName or IdentityId must be specified.
IdentityName:
type: string
description: The name of the user or group to update. For more information, see UserName and DisplayName in the IAM Identity Center Identity Store API Reference. Either IdentityName or IdentityId must be specified.
IdentityType:
type: string
enum:
- USER
- GROUP
description: Specifies whether the identity to update is a user or a group.
SessionPolicyArn:
type: string
description: The Amazon Resource Name (ARN) of the session policy to associate with the specified user or group.
required:
- StudioId
- IdentityType
- SessionPolicyArn
SessionMappingSummary:
type: object
properties:
StudioId:
type: string
description: The ID of the Amazon EMR Studio.
IdentityId:
type: string
description: The globally unique identifier (GUID) of the user or group from the IAM Identity Center Identity Store.
IdentityName:
type: string
description: The name of the user or group. For more information, see UserName and DisplayName in the IAM Identity Center Identity Store API Reference.
IdentityType:
type: string
enum:
- USER
- GROUP
description: Specifies whether the identity mapped to the Amazon EMR Studio is a user or a group.
SessionPolicyArn:
type: string
description: The Amazon Resource Name (ARN) of the session policy associated with the user or group.
CreationTime:
type: string
format: date-time
description: The time the session mapping was created.
InvalidRequestException:
type: object
properties:
ErrorCode:
type: string
description: The error code associated with the exception.
Message:
type: string
description: The message associated with the exception.
SessionMappingDetail:
type: object
properties:
StudioId:
type: string
description: The ID of the Amazon EMR Studio.
IdentityId:
type: string
description: The globally unique identifier (GUID) of the user or group.
IdentityName:
type: string
description: The name of the user or group. For more information, see UserName and DisplayName in the IAM Identity Center Identity Store API Reference.
IdentityType:
type: string
enum:
- USER
- GROUP
description: Specifies whether the identity mapped to the Amazon EMR Studio is a user or a group.
SessionPolicyArn:
type: string
description: The Amazon Resource Name (ARN) of the session policy associated with the user or group.
CreationTime:
type: string
format: date-time
description: The time the session mapping was created.
LastModifiedTime:
type: string
format: date-time
description: The time the session mapping was last modified.
InternalServerError:
type: object
properties: {}
GetStudioSessionMappingInput:
type: object
properties:
StudioId:
type: string
description: The ID of the Amazon EMR Studio.
IdentityId:
type: string
description: The globally unique identifier (GUID) of the user or group. For more information, see UserId and GroupId in the IAM Identity Center Identity Store API Reference. Either IdentityName or IdentityId must be specified.
IdentityName:
type: string
description: The name of the user or group to fetch. For more information, see UserName and DisplayName in the IAM Identity Center Identity Store API Reference. Either IdentityName or IdentityId must be specified.
IdentityType:
type: string
enum:
- USER
- GROUP
description: Specifies whether the identity to fetch is a user or a group.
required:
- StudioId
- IdentityType
securitySchemes:
sigv4:
type: apiKey
in: header
name: Authorization
description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
x-aws-sigv4:
signingName: elasticmapreduce
x-provenance:
method: harvested
publisher: Amazon Web Services
source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/emr/service/2009-03-31/emr-2009-03-31.json
note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)