Skip to content

get_studio_session_mapping async

get_studio_session_mapping(
    *,
    config_overrides: Optional[AsyncEMRClientConfig] = None,
    studio_id: Optional[XmlStringMaxLen256] = None,
    identity_id: Optional[XmlStringMaxLen256] = None,
    identity_name: Optional[XmlStringMaxLen256] = None,
    identity_type: Optional[IdentityType] = None,
) -> GetStudioSessionMappingOutput

Fetches mapping details for the specified Amazon EMR Studio and identity (user or group).

Parameters:

  • studio_id (Optional[XmlStringMaxLen256], default: None ) –

    The ID of the Amazon EMR Studio.

  • identity_id (Optional[XmlStringMaxLen256], default: None ) –

    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.

  • identity_name (Optional[XmlStringMaxLen256], default: None ) –

    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.

  • identity_type (Optional[IdentityType], default: None ) –

    Specifies whether the identity to fetch is a user or a group.

Raises:

  • InternalServerError –

    Indicates that an error occurred while processing the request and that the request was not completed.

  • InvalidRequestException –

    This exception occurs when there is something wrong with user input.

  • UnknownServiceError –

    The service returned an error code this client does not model.

Source code in docs_src/capo_emr/_services/async_emr.py
async def get_studio_session_mapping(
    self,
    *,
    config_overrides: Optional[AsyncEMRClientConfig] = None,
    studio_id: Optional[
        "capo_emr.types.xml_string_max_len256.XmlStringMaxLen256"
    ] = None,
    identity_id: Optional[
        "capo_emr.types.xml_string_max_len256.XmlStringMaxLen256"
    ] = None,
    identity_name: Optional[
        "capo_emr.types.xml_string_max_len256.XmlStringMaxLen256"
    ] = None,
    identity_type: Optional["capo_emr.types.identity_type.IdentityType"] = None,
) -> (
    "capo_emr.types.get_studio_session_mapping_output.GetStudioSessionMappingOutput"
):
    """<p>Fetches mapping details for the specified Amazon EMR Studio and identity (user or group).</p>

    Args:
        studio_id: <p>The ID of the Amazon EMR Studio.</p>
        identity_id: <p>The globally unique identifier (GUID) of the user or group. For more information, see <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserId">UserId</a> and <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-GroupId">GroupId</a> in the <i>IAM Identity Center Identity Store API Reference</i>. Either <code>IdentityName</code> or <code>IdentityId</code> must be specified.</p>
        identity_name: <p>The name of the user or group to fetch. For more information, see <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_User.html#singlesignon-Type-User-UserName">UserName</a> and <a href="https://docs.aws.amazon.com/singlesignon/latest/IdentityStoreAPIReference/API_Group.html#singlesignon-Type-Group-DisplayName">DisplayName</a> in the <i>IAM Identity Center Identity Store API Reference</i>. Either <code>IdentityName</code> or <code>IdentityId</code> must be specified.</p>
        identity_type: <p>Specifies whether the identity to fetch is a user or a group.</p>

    Raises:
        capo_emr.errors.internal_server_error.InternalServerError: <p>Indicates that an error occurred while processing the request and that the request was not completed.</p>
        capo_emr.errors.invalid_request_exception.InvalidRequestException: <p>This exception occurs when there is something wrong with user input.</p>
        capo_emr.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_emr.types.get_studio_session_mapping_input.GetStudioSessionMappingInput]",
    ) -> AsyncOperationResponse[
        "capo_emr.types.get_studio_session_mapping_output.GetStudioSessionMappingOutput"
    ]:
        import capo_emr._operations.elastic_map_reduce.get_studio_session_mapping

        (
            output,
            http_response,
        ) = await capo_emr._operations.elastic_map_reduce.get_studio_session_mapping.async_get_studio_session_mapping(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("GetStudioSessionMapping")
    )
    input_: capo_emr.types.get_studio_session_mapping_input.GetStudioSessionMappingInput = {}
    if studio_id is not None:
        input_["studio_id"] = studio_id
    if identity_id is not None:
        input_["identity_id"] = identity_id
    if identity_name is not None:
        input_["identity_name"] = identity_name
    if identity_type is not None:
        input_["identity_type"] = identity_type

    response = await aexecute_pipeline(
        AsyncOperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    await response.response.aclose()
    return response.output