EnvironmentEC2 class
Provides a Cloud9 EC2 Development Environment.
Example Usage
Basic usage:
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = new aws.cloud9.EnvironmentEC2("example", {
instanceType: "t2.micro",
name: "example-env",
imageId: "amazonlinux-2023-x86_64",
});
import pulumi
import pulumi_aws as aws
example = aws.cloud9.EnvironmentEC2("example",
instance_type="t2.micro",
name="example-env",
image_id="amazonlinux-2023-x86_64")
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var example = new Aws.Cloud9.EnvironmentEC2("example", new()
{
InstanceType = "t2.micro",
Name = "example-env",
ImageId = "amazonlinux-2023-x86_64",
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/cloud9"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := cloud9.NewEnvironmentEC2(ctx, "example", &cloud9.EnvironmentEC2Args{
InstanceType: pulumi.String("t2.micro"),
Name: pulumi.String("example-env"),
ImageId: pulumi.String("amazonlinux-2023-x86_64"),
})
if err != nil {
return err
}
return nil
})
}
pulumi {
required_providers {
aws = {
source = "pulumi/aws"
}
}
}
resource "aws_cloud9_environmentec2" "example" {
instance_type = "t2.micro"
name = "example-env"
image_id = "amazonlinux-2023-x86_64"
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.cloud9.EnvironmentEC2;
import com.pulumi.aws.cloud9.EnvironmentEC2Args;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example = new EnvironmentEC2("example", EnvironmentEC2Args.builder()
.instanceType("t2.micro")
.name("example-env")
.imageId("amazonlinux-2023-x86_64")
.build());
}
}
resources:
example:
type: aws:cloud9:EnvironmentEC2
properties:
instanceType: t2.micro
name: example-env
imageId: amazonlinux-2023-x86_64
Get the URL of the Cloud9 environment after creation:
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = new aws.cloud9.EnvironmentEC2("example", {instanceType: "t2.micro"});
const cloud9Instance = aws.ec2.getInstanceOutput({
filters: [{
name: "tag:aws:cloud9:environment",
values: [example.id],
}],
});
export const cloud9Url = pulumi.interpolate`https://${region}.console.aws.amazon.com/cloud9/ide/${example.id}`;
import pulumi
import pulumi_aws as aws
example = aws.cloud9.EnvironmentEC2("example", instance_type="t2.micro")
cloud9_instance = aws.ec2.get_instance_output(filters=[{
"name": "tag:aws:cloud9:environment",
"values": [example.id],
}])
pulumi.export("cloud9Url", example.id.apply(lambda id: f"https://{region}.console.aws.amazon.com/cloud9/ide/{id}"))
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var example = new Aws.Cloud9.EnvironmentEC2("example", new()
{
InstanceType = "t2.micro",
});
var cloud9Instance = Aws.Ec2.GetInstance.Invoke(new()
{
Filters = new[]
{
new Aws.Ec2.Inputs.GetInstanceFilterInputArgs
{
Name = "tag:aws:cloud9:environment",
Values = new[]
{
example.Id,
},
},
},
});
return new Dictionary<string, object?>
{
["cloud9Url"] = example.Id.Apply(id => $"https://{region}.console.aws.amazon.com/cloud9/ide/{id}"),
};
});
package main
import (
"fmt"
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/cloud9"
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/ec2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
example, err := cloud9.NewEnvironmentEC2(ctx, "example", &cloud9.EnvironmentEC2Args{
InstanceType: pulumi.String("t2.micro"),
})
if err != nil {
return err
}
_ = ec2.LookupInstanceOutput(ctx, ec2.GetInstanceOutputArgs{
Filters: ec2.GetInstanceFilterArray{
&ec2.GetInstanceFilterArgs{
Name: pulumi.String("tag:aws:cloud9:environment"),
Values: pulumi.StringArray{
example.ID().ToIDOutput().ToStringOutput(),
},
},
},
}, nil)
ctx.Export("cloud9Url", example.ID().ApplyT(func(id pulumi.ID) (string, error) {
return fmt.Sprintf("https://%v.console.aws.amazon.com/cloud9/ide/%v", region, id), nil
}).(pulumi.StringOutput))
return nil
})
}
pulumi {
required_providers {
aws = {
source = "pulumi/aws"
}
}
}
data "aws_ec2_getinstance" "cloud9Instance" {
filters {
name = "tag:aws:cloud9:environment"
values = [aws_cloud9_environmentec2.example.id]
}
}
resource "aws_cloud9_environmentec2" "example" {
instance_type = "t2.micro"
}
output "cloud9Url" {
value ="https://${region}.console.aws.amazon.com/cloud9/ide/${aws_cloud9_environmentec2.example.id}"
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.cloud9.EnvironmentEC2;
import com.pulumi.aws.cloud9.EnvironmentEC2Args;
import com.pulumi.aws.ec2.Ec2Functions;
import com.pulumi.aws.ec2.inputs.GetInstanceArgs;
import com.pulumi.aws.ec2.inputs.GetInstanceFilterArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example = new EnvironmentEC2("example", EnvironmentEC2Args.builder()
.instanceType("t2.micro")
.build());
final var cloud9Instance = Ec2Functions.getInstance(GetInstanceArgs.builder()
.filters(GetInstanceFilterArgs.builder()
.name("tag:aws:cloud9:environment")
.values(example.id())
.build())
.build());
ctx.export("cloud9Url", example.id().applyValue(_id -> String.format("https://%s.console.aws.amazon.com/cloud9/ide/%s", region,_id)));
}
}
resources:
example:
type: aws:cloud9:EnvironmentEC2
properties:
instanceType: t2.micro
variables:
cloud9Instance:
fn::invoke:
function: aws:ec2:getInstance
arguments:
filters:
- name: tag:aws:cloud9:environment
values:
- ${example.id}
outputs:
cloud9Url: https://${region}.console.aws.amazon.com/cloud9/ide/${example.id}
Allocate a static IP to the Cloud9 environment:
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = new aws.cloud9.EnvironmentEC2("example", {instanceType: "t2.micro"});
const cloud9Instance = aws.ec2.getInstanceOutput({
filters: [{
name: "tag:aws:cloud9:environment",
values: [example.id],
}],
});
const cloud9Eip = new aws.ec2.Eip("cloud9_eip", {
instance: cloud9Instance.id,
domain: "vpc",
});
export const cloud9PublicIp = cloud9Eip.publicIp;
import pulumi
import pulumi_aws as aws
example = aws.cloud9.EnvironmentEC2("example", instance_type="t2.micro")
cloud9_instance = aws.ec2.get_instance_output(filters=[{
"name": "tag:aws:cloud9:environment",
"values": [example.id],
}])
cloud9_eip = aws.ec2.Eip("cloud9_eip",
instance=cloud9_instance.id,
domain="vpc")
pulumi.export("cloud9PublicIp", cloud9_eip.public_ip)
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var example = new Aws.Cloud9.EnvironmentEC2("example", new()
{
InstanceType = "t2.micro",
});
var cloud9Instance = Aws.Ec2.GetInstance.Invoke(new()
{
Filters = new[]
{
new Aws.Ec2.Inputs.GetInstanceFilterInputArgs
{
Name = "tag:aws:cloud9:environment",
Values = new[]
{
example.Id,
},
},
},
});
var cloud9Eip = new Aws.Ec2.Eip("cloud9_eip", new()
{
Instance = cloud9Instance.Apply(getInstanceResult => getInstanceResult.Id),
Domain = "vpc",
});
return new Dictionary<string, object?>
{
["cloud9PublicIp"] = cloud9Eip.PublicIp,
};
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/cloud9"
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/ec2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
example, err := cloud9.NewEnvironmentEC2(ctx, "example", &cloud9.EnvironmentEC2Args{
InstanceType: pulumi.String("t2.micro"),
})
if err != nil {
return err
}
cloud9Instance := ec2.LookupInstanceOutput(ctx, ec2.GetInstanceOutputArgs{
Filters: ec2.GetInstanceFilterArray{
&ec2.GetInstanceFilterArgs{
Name: pulumi.String("tag:aws:cloud9:environment"),
Values: pulumi.StringArray{
example.ID().ToIDOutput().ToStringOutput(),
},
},
},
}, nil)
cloud9Eip, err := ec2.NewEip(ctx, "cloud9_eip", &ec2.EipArgs{
Instance: cloud9Instance.Id(),
Domain: pulumi.String("vpc"),
})
if err != nil {
return err
}
ctx.Export("cloud9PublicIp", cloud9Eip.PublicIp)
return nil
})
}
pulumi {
required_providers {
aws = {
source = "pulumi/aws"
}
}
}
data "aws_ec2_getinstance" "cloud9Instance" {
filters {
name = "tag:aws:cloud9:environment"
values = [aws_cloud9_environmentec2.example.id]
}
}
resource "aws_cloud9_environmentec2" "example" {
instance_type = "t2.micro"
}
resource "aws_ec2_eip" "cloud9_eip" {
instance = data.aws_ec2_getinstance.cloud9Instance.id
domain = "vpc"
}
output "cloud9PublicIp" {
value = aws_ec2_eip.cloud9_eip.public_ip
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.cloud9.EnvironmentEC2;
import com.pulumi.aws.cloud9.EnvironmentEC2Args;
import com.pulumi.aws.ec2.Ec2Functions;
import com.pulumi.aws.ec2.inputs.GetInstanceArgs;
import com.pulumi.aws.ec2.inputs.GetInstanceFilterArgs;
import com.pulumi.aws.ec2.Eip;
import com.pulumi.aws.ec2.EipArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example = new EnvironmentEC2("example", EnvironmentEC2Args.builder()
.instanceType("t2.micro")
.build());
final var cloud9Instance = Ec2Functions.getInstance(GetInstanceArgs.builder()
.filters(GetInstanceFilterArgs.builder()
.name("tag:aws:cloud9:environment")
.values(example.id())
.build())
.build());
var cloud9Eip = new Eip("cloud9Eip", EipArgs.builder()
.instance(cloud9Instance.applyValue(_cloud9Instance -> _cloud9Instance.id()))
.domain("vpc")
.build());
ctx.export("cloud9PublicIp", cloud9Eip.publicIp());
}
}
resources:
example:
type: aws:cloud9:EnvironmentEC2
properties:
instanceType: t2.micro
cloud9Eip:
type: aws:ec2:Eip
name: cloud9_eip
properties:
instance: ${cloud9Instance.id}
domain: vpc
variables:
cloud9Instance:
fn::invoke:
function: aws:ec2:getInstance
arguments:
filters:
- name: tag:aws:cloud9:environment
values:
- ${example.id}
outputs:
cloud9PublicIp: ${cloud9Eip.publicIp}
Constructors
- EnvironmentEC2(String name, {EnvironmentEC2Args? args, CustomResourceOptions? options})
-
Creates a new EnvironmentEC2.
nameThe Pulumi resource name.argsArguments used to configure this EnvironmentEC2. The set of arguments for EnvironmentEC2.optionsResource options controlling this resource's behavior. - EnvironmentEC2.reference(String urn)
- Creates a typed reference to an existing EnvironmentEC2 resource.
Properties
-
arn
↔ Output<
String> -
The ARN of the environment.
latefinal
-
automaticStopTimeMinutes
↔ Output<
int?> -
The number of minutes until the running instance is shut down after the environment has last been used.
latefinal
-
childResources
→ Set<
Resource> -
finalinherited
-
completionSources
↔ Map<
String, IOutputCompletionSource> -
latefinalinherited
-
connectionType
↔ Output<
String?> -
The connection type used for connecting to an Amazon EC2 environment. Valid values are
CONNECT_SSHandCONNECT_SSM. For more information please refer AWS documentation for Cloud9.latefinal -
description
↔ Output<
String?> -
The description of the environment.
latefinal
- hashCode → int
-
The hash code for this object.
no setterinherited
-
id
↔ Output<
String> -
getter/setter pairinherited
-
imageId
↔ Output<
String> -
Identifier for the AMI that's used to create the EC2 instance. Valid values are
latefinal
-
instanceType
↔ Output<
String> -
The type of instance to connect to the environment, e.g.,
t2.micro.latefinal - isCustom → bool
-
Returns whether this resource is provider-managed.
no setterinherited
- isProtected → bool
-
Returns whether this resource is protected from deletion.
no setterinherited
- isRemote → bool
-
Whether this resource is registered as remote.
no setterinherited
- isResourceReference → bool
-
Whether this instance represents a resource value returned over RPC.
finalinherited
-
name
↔ Output<
String> -
The name of the environment.
latefinal
-
ownerArn
↔ Output<
String> -
The ARN of the environment owner. This can be ARN of any AWS IAM principal. Defaults to the environment's creator.
latefinal
-
region
↔ Output<
String> -
Region where this resource will be managed. Defaults to the Region set in the provider configuration.
latefinal
-
resourceTransforms
→ List<
ResourceTransform> -
Inherited/explicit async transforms.
no setterinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
-
subnetId
↔ Output<
String?> -
The ID of the subnet in Amazon VPC that AWS Cloud9 will use to communicate with the Amazon EC2 instance.
latefinal
-
Key-value map of resource tags. .If configured with a provider
defaultTagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level.latefinal -
A map of tags assigned to the resource, including those inherited from the provider
defaultTagsconfiguration block.latefinal -
transformations
→ List<
ResourceTransformation> -
Inherited/explicit legacy transformations.
no setterinherited
-
type
↔ Output<
String> -
The type of the environment (e.g.,
sshorec2).latefinal -
urn
↔ Output<
String> -
latefinalinherited
Methods
-
failId(
Object error) → void -
Completes this resource ID with an error when registration fails.
inherited
-
failOutputs(
Object error) → void -
Completes all output properties with
error.inherited -
failUrn(
Object error) → void -
Completes this resource URN with an error when registration fails.
inherited
-
getProvider(
String moduleMember) → ProviderResource? -
Returns provider for
moduleMember's package, if configured.inherited -
getResourceName(
) → String -
Returns this resource's logical name.
inherited
-
getResourceType(
) → String -
Returns this resource's Pulumi type token.
inherited
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
registerOutput<
T> (String propertyName, {Object? decoder(Object?)?, bool isSecret = false}) → Output< T> -
Registers a dynamic output property for this resource.
inherited
-
resolveId(
String? value, {required bool isKnown}) → void -
Resolves the provider-assigned ID for this resource.
inherited
-
resolveOutputs(
Struct outputs) → void -
Resolves all output properties from a monitor response payload.
inherited
-
resolveUrn(
String value) → void -
Resolves this resource's URN once assigned by the engine.
inherited
-
serializeProperties(
Map< String, dynamic> properties) → Future<Struct> -
Serializes resource properties for RPC transmission.
inherited
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited
Static Methods
-
get(
String name, Input< String> id, {EnvironmentEC2State? state, CustomResourceOptions? options}) → EnvironmentEC2 -
Gets an existing EnvironmentEC2 resource's state with the given
nameandid.