---
# generated by https://github.com/hashicorp/terraform-plugin-docs
page_title: "awscc_emr_studio Resource - terraform-provider-awscc"
subcategory: ""
description: |-
  Resource schema for AWS::EMR::Studio
---

# awscc_emr_studio (Resource)

Resource schema for AWS::EMR::Studio



<!-- schema generated by tfplugindocs -->
## Schema

### Required

- `auth_mode` (String) Specifies whether the Studio authenticates users using single sign-on (SSO) or IAM. Amazon EMR Studio currently only supports SSO authentication.
- `default_s3_location` (String) The default Amazon S3 location to back up EMR Studio Workspaces and notebook files. A Studio user can select an alternative Amazon S3 location when creating a Workspace.
- `engine_security_group_id` (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` (String) A descriptive name for the Amazon EMR Studio.
- `service_role` (String) 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.
- `subnet_ids` (List of String) A list of up to 5 subnet IDs to associate with the Studio. The subnets must belong to the VPC specified by VpcId. Studio users can create a Workspace in any of the specified subnets.
- `vpc_id` (String) The ID of the Amazon Virtual Private Cloud (Amazon VPC) to associate with the Studio.
- `workspace_security_group_id` (String) The ID of the Amazon EMR Studio Workspace security group. The Workspace security group allows outbound network traffic to resources in the Engine security group, and it must be in the same VPC specified by VpcId.

### Optional

- `description` (String) A detailed description of the Studio.
- `idp_auth_url` (String) 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.
- `idp_relay_state_parameter_name` (String) The name of relay state parameter for external Identity Provider.
- `tags` (Attributes Set) A list of tags to associate with the Studio. Tags are user-defined key-value pairs that consist of a required key string with a maximum of 128 characters, and an optional value string with a maximum of 256 characters. (see [below for nested schema](#nestedatt--tags))
- `user_role` (String) 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.

### Read-Only

- `arn` (String) The Amazon Resource Name (ARN) of the EMR Studio.
- `id` (String) Uniquely identifies the resource.
- `studio_id` (String) The ID of the EMR Studio.
- `url` (String) The unique Studio access URL.

<a id="nestedatt--tags"></a>
### Nested Schema for `tags`

Optional:

- `key` (String) The key name of the tag. You can specify a value that is 1 to 127 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
- `value` (String) The value for the tag. You can specify a value that is 0 to 255 Unicode characters in length. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.

## Import

Import is supported using the following syntax:

```shell
$ terraform import awscc_emr_studio.example <resource ID>
```