Fetches mapping details for the specified Amazon EMR Studio and identity (user or group).
Request Syntax
{
"IdentityId": "string",
"IdentityName": "string",
"IdentityType": "string",
"StudioId": "string"
}Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
The request accepts the following data in JSON format.
- IdentityId
-
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
IdentityNameorIdentityIdmust be specified.Type: String
Length Constraints: Minimum length of 0. Maximum length of 256.
Pattern:
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*Required: No
- IdentityName
-
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
IdentityNameorIdentityIdmust be specified.Type: String
Length Constraints: Minimum length of 0. Maximum length of 256.
Pattern:
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*Required: No
- IdentityType
-
Specifies whether the identity to fetch is a user or a group.
Type: String
Valid Values:
USER | GROUPRequired: Yes
- StudioId
-
The ID of the Amazon EMR Studio.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 256.
Pattern:
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*Required: Yes
Response Syntax
{
"SessionMapping": {
"CreationTime": number,
"IdentityId": "string",
"IdentityName": "string",
"IdentityType": "string",
"LastModifiedTime": number,
"SessionPolicyArn": "string",
"StudioId": "string"
}
}Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- SessionMapping
-
The session mapping details for the specified Amazon EMR Studio and identity, including session policy ARN and creation time.
Type: SessionMappingDetail object
Errors
For information about the errors that are common to all actions, see Common Errors.
- InternalServerError
-
Indicates that an error occurred while processing the request and that the request was not completed.
HTTP Status Code: 400
- InvalidRequestException
-
This exception occurs when there is something wrong with user input.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
