AWS Fundamentals Logo
AWS Fundamentals
L1 ConstructAWS::Cloud9::EnvironmentEC2

CfnEnvironmentEC2

The `AWS::Cloud9::EnvironmentEC2` resource creates an Amazon EC2 development environment in AWS Cloud9 . For more information, see [Creating an Environment](https://docs.aws.amazon.com/cloud9/latest/user-guide/create-environment.html) in the *AWS Cloud9 User Guide* .

Import

import { CfnEnvironmentEC2 } from 'aws-cdk-lib/aws-cloud9';

Or use the module namespace:

import * as cloud9 from 'aws-cdk-lib/aws-cloud9';
// cloud9.CfnEnvironmentEC2

Properties

Configuration passed to the constructor as CfnEnvironmentEC2Props.

imageIdRequired
string

The identifier for the Amazon Machine Image (AMI) that's used to create the EC2 instance. To choose an AMI for the instance, you must specify a valid AMI alias or a valid AWS Systems Manager path. From December 04, 2023, you will be required to include the `ImageId` parameter for the `CreateEnvironmentEC2` action. This change will be reflected across all direct methods of communicating with the API, such as AWS SDK, AWS CLI and AWS CloudFormation. This change will only affect direct API consumers, and not AWS Cloud9 console users. Since Ubuntu 18.04 has ended standard support as of May 31, 2023, we recommend you choose Ubuntu 22.04. *AMI aliases* - Amazon Linux 2: `amazonlinux-2-x86_64` - Amazon Linux 2023 (recommended): `amazonlinux-2023-x86_64` - Ubuntu 18.04: `ubuntu-18.04-x86_64` - Ubuntu 22.04: `ubuntu-22.04-x86_64` *SSM paths* - Amazon Linux 2: `resolve:ssm:/aws/service/cloud9/amis/amazonlinux-2-x86_64` - Amazon Linux 2023 (recommended): `resolve:ssm:/aws/service/cloud9/amis/amazonlinux-2023-x86_64` - Ubuntu 18.04: `resolve:ssm:/aws/service/cloud9/amis/ubuntu-18.04-x86_64` - Ubuntu 22.04: `resolve:ssm:/aws/service/cloud9/amis/ubuntu-22.04-x86_64`

instanceTypeRequired
string

The type of instance to connect to the environment (for example, `t2.micro` ).

automaticStopTimeMinutesOptional
number

The number of minutes until the running instance is shut down after the environment was last used.

connectionTypeOptional
string

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 ).

descriptionOptional
string

The description of the environment to create.

nameOptional
string

The name of the environment.

ownerArnOptional
string

The Amazon Resource Name (ARN) of the environment owner. This ARN can be the ARN of any AWS Identity and Access Management principal. If this value is not specified, the ARN defaults to this environment's creator.

repositoriesOptional
IResolvable | IResolvable | RepositoryProperty[]

Any AWS CodeCommit source code repositories to be cloned into the development environment.

subnetIdOptional
string

The ID of the subnet in Amazon Virtual Private Cloud (Amazon VPC) that AWS Cloud9 will use to communicate with the Amazon Elastic Compute Cloud (Amazon EC2) instance.

tagsOptional
CfnTag[]

An array of key-value pairs that will be associated with the new AWS Cloud9 development environment.

CloudFormation Resource

This L1 construct maps directly to the following CloudFormation resource type.

AWS::Cloud9::EnvironmentEC2View in CloudFormation Explorer

Learn AWS the Practical Way

Our bi-weekly newsletter teaches hands-on AWS fundamentals. No certification fluff - just practical knowledge.

Subscribe to Newsletter

Quick Facts

LevelL1 (CloudFormation)
Moduleaws-cloud9
CFN TypeAWS::Cloud9::EnvironmentEC2
Properties10

Explore This Service

External Links