aws-cdk-lib.aws_emr.CfnStudioProps

interface CfnStudioProps

LanguageType name
.NETAmazon.CDK.AWS.EMR.CfnStudioProps
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awsemr#CfnStudioProps
Javasoftware.amazon.awscdk.services.emr.CfnStudioProps
Pythonaws_cdk.aws_emr.CfnStudioProps
TypeScript aws-cdk-lib » aws_emr » CfnStudioProps

Properties for defining a CfnStudio.

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_emr as emr } from 'aws-cdk-lib';
const cfnStudioProps: emr.CfnStudioProps = {
  authMode: 'authMode',
  defaultS3Location: 'defaultS3Location',
  engineSecurityGroupId: 'engineSecurityGroupId',
  name: 'name',
  serviceRole: 'serviceRole',
  subnetIds: ['subnetIds'],
  vpcId: 'vpcId',
  workspaceSecurityGroupId: 'workspaceSecurityGroupId',

  // the properties below are optional
  description: 'description',
  idpAuthUrl: 'idpAuthUrl',
  idpRelayStateParameterName: 'idpRelayStateParameterName',
  tags: [{
    key: 'key',
    value: 'value',
  }],
  userRole: 'userRole',
};

Properties

NameTypeDescription
authModestringSpecifies whether the Studio authenticates users using IAM Identity Center or IAM.
defaultS3LocationstringThe Amazon S3 location to back up EMR Studio Workspaces and notebook files.
engineSecurityGroupIdstringThe ID of the Amazon EMR Studio Engine security group.
namestringA descriptive name for the Amazon EMR Studio.
serviceRolestringThe Amazon Resource Name (ARN) of the IAM role that will be assumed by the Amazon EMR Studio.
subnetIdsstring[]A list of subnet IDs to associate with the Amazon EMR Studio.
vpcIdstringThe ID of the Amazon Virtual Private Cloud (Amazon VPC) to associate with the Studio.
workspaceSecurityGroupIdstringThe ID of the Workspace security group associated with the Amazon EMR Studio.
description?stringA detailed description of the Amazon EMR Studio.
idpAuthUrl?stringYour identity provider's authentication endpoint.
idpRelayStateParameterName?stringThe name of your identity provider's RelayState parameter.
tags?CfnTag[]An array of key-value pairs to apply to this resource.
userRole?stringThe Amazon Resource Name (ARN) of the IAM user role that will be assumed by users and groups logged in to a Studio.

authMode

Type: string

Specifies whether the Studio authenticates users using IAM Identity Center or IAM.


defaultS3Location

Type: string

The Amazon S3 location to back up EMR Studio Workspaces and notebook files.


engineSecurityGroupId

Type: string

The ID of the Amazon EMR Studio Engine security group.

The Engine security group allows inbound network traffic from the Workspace security group, and it must be in the same VPC specified by VpcId .


name

Type: string

A descriptive name for the Amazon EMR Studio.


serviceRole

Type: string

The Amazon Resource Name (ARN) of the IAM role that will be assumed by the Amazon EMR Studio.

The service role provides a way for Amazon EMR Studio to interoperate with other AWS services.


subnetIds

Type: string[]

A list of subnet IDs to associate with the Amazon EMR Studio.

A Studio can have a maximum of 5 subnets. The subnets must belong to the VPC specified by VpcId . Studio users can create a Workspace in any of the specified subnets.


vpcId

Type: string

The ID of the Amazon Virtual Private Cloud (Amazon VPC) to associate with the Studio.


workspaceSecurityGroupId

Type: string

The ID of the Workspace security group associated with the Amazon EMR Studio.

The Workspace security group allows outbound network traffic to resources in the Engine security group and to the internet.


description?

Type: string (optional)

A detailed description of the Amazon EMR Studio.


idpAuthUrl?

Type: string (optional)

Your identity provider's authentication endpoint.

Amazon EMR Studio redirects federated users to this endpoint for authentication when logging in to a Studio with the Studio URL.


idpRelayStateParameterName?

Type: string (optional)

The name of your identity provider's RelayState parameter.


tags?

Type: CfnTag[] (optional)

An array of key-value pairs to apply to this resource.

For more information, see Tag .


userRole?

Type: string (optional)

The Amazon Resource Name (ARN) of the IAM user role that will be assumed by users and groups logged in to a Studio.

The permissions attached to this IAM role can be scoped down for each user or group using session policies. You only need to specify UserRole when you set AuthMode to SSO .