> **Experimental**
>
> `@aws-cdk/aws-cloud9-alpha` is an [**experimental**](/stability) (alpha) package: its API may change in any release, without a major version bump.
# Ec2EnvironmentProps

Properties for Ec2Environment.

Used as props by: [Ec2Environment](/cdk/api/v2/docs/@aws-cdk_aws-cloud9-alpha.Ec2Environment.html)

- Stability: [Experimental](/cdk/api/stability.html)
- Source: [`lib/environment.ts`](https://github.com/aws/aws-cdk/blob/v2.277.0/packages/@aws-cdk/aws-cloud9-alpha/lib/environment.ts#L72)

## Example

TypeScript:

```ts
import * as iam from 'aws-cdk-lib/aws-iam';

const user = new iam.User(this, 'user');
user.addManagedPolicy(iam.ManagedPolicy.fromAwsManagedPolicyName('AWSCloud9Administrator'));
declare const vpc: ec2.Vpc;
new cloud9.Ec2Environment(this, 'C9Env', {
  vpc,
  imageId: cloud9.ImageId.AMAZON_LINUX_2,

  owner: cloud9.Owner.user(user)
})
```

Python:

```python
import aws_cdk.aws_iam as iam
# vpc: ec2.Vpc

user = iam.User(self, "user")
user.add_managed_policy(iam.ManagedPolicy.from_aws_managed_policy_name("AWSCloud9Administrator"))
cloud9.Ec2Environment(self, "C9Env",
    vpc=vpc,
    image_id=cloud9.ImageId.AMAZON_LINUX_2,

    owner=cloud9.Owner.user(user)
)
```

Java:

```java
import software.amazon.awscdk.services.iam.*;
Vpc vpc;

User user = new User(this, "user");
user.addManagedPolicy(ManagedPolicy.fromAwsManagedPolicyName("AWSCloud9Administrator"));
Ec2Environment.Builder.create(this, "C9Env")
        .vpc(vpc)
        .imageId(ImageId.AMAZON_LINUX_2)

        .owner(Owner.user(user))
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.AWS.Cloud9.Alpha
using Amazon.CDK.AWS.IAM;
Vpc vpc;

var user = new User(this, "user");
user.AddManagedPolicy(ManagedPolicy.FromAwsManagedPolicyName("AWSCloud9Administrator"));
new Ec2Environment(this, "C9Env", new Ec2EnvironmentProps {
    Vpc = vpc,
    ImageId = ImageId.AMAZON_LINUX_2,

    Owner = Owner.User(user)
});
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdkcloud9alpha/v2
import "github.com/aws/aws-cdk-go/awscdk"
var vpc Vpc

user := iam.NewUser(this, jsii.String("user"))
user.AddManagedPolicy(iam.ManagedPolicy_FromAwsManagedPolicyName(jsii.String("AWSCloud9Administrator")))
cloud9.NewEc2Environment(this, jsii.String("C9Env"), &Ec2EnvironmentProps{
	Vpc: Vpc,
	ImageId: cloud9.ImageId_AMAZON_LINUX_2,

	Owner: cloud9.Owner_User(user),
})
```

## Properties

- `automaticStop`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) — The number of minutes until the running instance is shut down after the environment was last used.

  **Default:** The instance will not be shut down automatically.

  Setting a value of 0 means the instance will never be automatically shut down."

- `clonedRepositories`: [CloneRepository](/cdk/api/v2/docs/@aws-cdk_aws-cloud9-alpha.CloneRepository.html)[] — The AWS CodeCommit repository to be cloned.

  **Default:** do not clone any repository

- `connectionType`: [ConnectionType](/cdk/api/v2/docs/@aws-cdk_aws-cloud9-alpha.ConnectionType.html) = CONNECT_SSH — The connection type used for connecting to an Amazon EC2 environment.

  Valid values are: CONNECT_SSH (default) and CONNECT_SSM (connected through AWS Systems Manager)

- `description`: string — Description of the environment.

  **Default:** no description

- `ec2EnvironmentName`: string — Name of the environment.

  **Default:** automatically generated name

- `imageId`: [ImageId](/cdk/api/v2/docs/@aws-cdk_aws-cloud9-alpha.ImageId.html) (required) — The image ID used for creating an Amazon EC2 environment.

- `instanceType`: [InstanceType](/cdk/api/v2/docs/aws-cdk-lib.aws_ec2.InstanceType.html) = t2.micro — The type of instance to connect to the environment.

- `owner`: [Owner](/cdk/api/v2/docs/@aws-cdk_aws-cloud9-alpha.Owner.html) — Owner of the environment.

  **Default:** The identity that CloudFormation executes under will be the owner

  The owner has full control of the environment and can invite additional members.

- `subnetSelection`: [SubnetSelection](/cdk/api/v2/docs/aws-cdk-lib.aws_ec2.SubnetSelection.html) — The subnetSelection of the VPC that AWS Cloud9 will use to communicate with the Amazon EC2 instance.

  **Default:** all public subnets of the VPC are selected.

- `vpc`: [IVpc](/cdk/api/v2/docs/aws-cdk-lib.aws_ec2.IVpc.html) (required) — The VPC that AWS Cloud9 will use to communicate with the Amazon Elastic Compute Cloud (Amazon EC2) instance.
