feat(cloud9): support setting automaticStopTimeMinutes

packages/@aws-cdk/aws-cloud9-alpha/README.md

@@ -134,3 +134,17 @@ new cloud9.Ec2Environment(this, 'C9Env', {
   owner: cloud9.Owner.user(user)
 })
 ```
+
+## Auto-Hibernation
+
+A Cloud9 environemnt can automatically start and stop the associated EC2 instance to reduce costs.
+
+Use `automaticStopTimeMinutes` to specify the number of minutes until the running instance is shut down after the environment was last used.
+
+```ts
+const defaultVpc = ec2.Vpc.fromLookup(this, 'DefaultVPC', { isDefault: true });
+new cloud9.Ec2Environment(this, 'Cloud9Env2', {
+  vpc: defaultVpc,
+  imageId: cloud9.ImageId.AMAZON_LINUX_2,
+  automaticStopTimeMinutes: 30,
+});

packages/@aws-cdk/aws-cloud9-alpha/lib/environment.ts

@@ -124,6 +124,16 @@ export interface Ec2EnvironmentProps {
    *
    */
   readonly imageId: ImageId
+
+  /**
+   * The number of minutes until the running instance is shut down after the
+   * environment was last used.
+   *
+   * Setting a value of 0 means the instance will never be automatically shut down."
+   *
+   * @default - The instance will not be shut down automatically.
+   */
+  readonly automaticStopTimeMinutes?: number
 }
 
 /**
@@ -200,6 +210,7 @@ export class Ec2Environment extends cdk.Resource implements IEc2Environment {
       })) : undefined,
       connectionType: props.connectionType ?? ConnectionType.CONNECT_SSH,
       imageId: props.imageId,
+      automaticStopTimeMinutes: props.automaticStopTimeMinutes,
     });
     this.environmentId = c9env.ref;
     this.ec2EnvironmentArn = c9env.getAtt('Arn').toString();

packages/@aws-cdk/aws-cloud9-alpha/test/cloud9.environment.test.ts

@@ -145,6 +145,20 @@ test('environment owner can be account root', () => {
   });
 });
 
+test('can set automaticStopTimeMinutes', () => {
+  // WHEN
+  const automaticStopTimeMinutes = 30;
+  new cloud9.Ec2Environment(stack, 'C9Env', {
+    vpc,
+    imageId: cloud9.ImageId.AMAZON_LINUX_2,
+    automaticStopTimeMinutes,
+  });
+  // THEN
+  Template.fromStack(stack).hasResourceProperties('AWS::Cloud9::EnvironmentEC2', {
+    AutomaticStopTimeMinutes: automaticStopTimeMinutes,
+  });
+});
+
 test.each([
   [ConnectionType.CONNECT_SSH, 'CONNECT_SSH'],
   [ConnectionType.CONNECT_SSM, 'CONNECT_SSM'],

packages/@aws-cdk/aws-cloud9-alpha/test/integ.automatic-stop-time-minutes.js.snapshot/C9AutomaticStopTimeMinutesStack.assets.json

@@ -0,0 +1,19 @@
+{
+  "version": "31.0.0",
+  "files": {
+    "b4ace33442eb5fb8a32765fb178c8b0cb78d32ae32217070deb47be21b72ce44": {
+      "source": {
+        "path": "C9AutomaticStopTimeMinutesStack.template.json",
+        "packaging": "file"
+      },
+      "destinations": {
+        "current_account-current_region": {
+          "bucketName": "cdk-hnb659fds-assets-${AWS::AccountId}-${AWS::Region}",
+          "objectKey": "b4ace33442eb5fb8a32765fb178c8b0cb78d32ae32217070deb47be21b72ce44.json",
+          "assumeRoleArn": "arn:${AWS::Partition}:iam::${AWS::AccountId}:role/cdk-hnb659fds-file-publishing-role-${AWS::AccountId}-${AWS::Region}"
+        }
+      }
+    }
+  },
+  "dockerImages": {}
+}