cloud9

package
v4.38.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 10, 2022 License: Apache-2.0 Imports: 7 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type EnvironmentEC2

type EnvironmentEC2 struct {
	pulumi.CustomResourceState

	// The ARN of the environment.
	Arn pulumi.StringOutput `pulumi:"arn"`
	// The number of minutes until the running instance is shut down after the environment has last been used.
	AutomaticStopTimeMinutes pulumi.IntPtrOutput `pulumi:"automaticStopTimeMinutes"`
	// The description of the environment.
	Description pulumi.StringPtrOutput `pulumi:"description"`
	// The type of instance to connect to the environment, e.g., `t2.micro`.
	InstanceType pulumi.StringOutput `pulumi:"instanceType"`
	// The name of the environment.
	Name pulumi.StringOutput `pulumi:"name"`
	// The ARN of the environment owner. This can be ARN of any AWS IAM principal. Defaults to the environment's creator.
	OwnerArn pulumi.StringOutput `pulumi:"ownerArn"`
	// The ID of the subnet in Amazon VPC that AWS Cloud9 will use to communicate with the Amazon EC2 instance.
	SubnetId pulumi.StringPtrOutput `pulumi:"subnetId"`
	// Key-value map of resource tags. .If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
	Tags pulumi.StringMapOutput `pulumi:"tags"`
	// A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
	TagsAll pulumi.StringMapOutput `pulumi:"tagsAll"`
	// The type of the environment (e.g., `ssh` or `ec2`)
	Type pulumi.StringOutput `pulumi:"type"`
}

Provides a Cloud9 EC2 Development Environment.

## Example Usage

Basic usage:

```go package main

import (

"github.com/pulumi/pulumi-aws/sdk/v4/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"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

Get the URL of the Cloud9 environment after creation:

```go package main

import (

"fmt"

"github.com/pulumi/pulumi-aws/sdk/v4/go/aws/cloud9"
"github.com/pulumi/pulumi-aws/sdk/v4/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(),
					},
				},
			},
		}, nil)
		ctx.Export("cloud9Url", example.ID().ApplyT(func(id string) (string, error) {
			return fmt.Sprintf("%v%v%v%v", "https://", _var.Region, ".console.aws.amazon.com/cloud9/ide/", id), nil
		}).(pulumi.StringOutput))
		return nil
	})
}

```

Allocate a static IP to the Cloud9 environment:

```go package main

import (

"github.com/pulumi/pulumi-aws/sdk/v4/go/aws/cloud9"
"github.com/pulumi/pulumi-aws/sdk/v4/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(),
					},
				},
			},
		}, nil)
		cloud9Eip, err := ec2.NewEip(ctx, "cloud9Eip", &ec2.EipArgs{
			Instance: cloud9Instance.ApplyT(func(cloud9Instance ec2.GetInstanceResult) (string, error) {
				return cloud9Instance.Id, nil
			}).(pulumi.StringOutput),
			Vpc: pulumi.Bool(true),
		})
		if err != nil {
			return err
		}
		ctx.Export("cloud9PublicIp", cloud9Eip.PublicIp)
		return nil
	})
}

```

func GetEnvironmentEC2

func GetEnvironmentEC2(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *EnvironmentEC2State, opts ...pulumi.ResourceOption) (*EnvironmentEC2, error)

GetEnvironmentEC2 gets an existing EnvironmentEC2 resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewEnvironmentEC2

func NewEnvironmentEC2(ctx *pulumi.Context,
	name string, args *EnvironmentEC2Args, opts ...pulumi.ResourceOption) (*EnvironmentEC2, error)

NewEnvironmentEC2 registers a new resource with the given unique name, arguments, and options.

func (*EnvironmentEC2) ElementType

func (*EnvironmentEC2) ElementType() reflect.Type

func (*EnvironmentEC2) ToEnvironmentEC2Output

func (i *EnvironmentEC2) ToEnvironmentEC2Output() EnvironmentEC2Output

func (*EnvironmentEC2) ToEnvironmentEC2OutputWithContext

func (i *EnvironmentEC2) ToEnvironmentEC2OutputWithContext(ctx context.Context) EnvironmentEC2Output

type EnvironmentEC2Args

type EnvironmentEC2Args struct {
	// The number of minutes until the running instance is shut down after the environment has last been used.
	AutomaticStopTimeMinutes pulumi.IntPtrInput
	// The description of the environment.
	Description pulumi.StringPtrInput
	// The type of instance to connect to the environment, e.g., `t2.micro`.
	InstanceType pulumi.StringInput
	// The name of the environment.
	Name pulumi.StringPtrInput
	// The ARN of the environment owner. This can be ARN of any AWS IAM principal. Defaults to the environment's creator.
	OwnerArn pulumi.StringPtrInput
	// The ID of the subnet in Amazon VPC that AWS Cloud9 will use to communicate with the Amazon EC2 instance.
	SubnetId pulumi.StringPtrInput
	// Key-value map of resource tags. .If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
	Tags pulumi.StringMapInput
}

The set of arguments for constructing a EnvironmentEC2 resource.

func (EnvironmentEC2Args) ElementType

func (EnvironmentEC2Args) ElementType() reflect.Type

type EnvironmentEC2Array

type EnvironmentEC2Array []EnvironmentEC2Input

func (EnvironmentEC2Array) ElementType

func (EnvironmentEC2Array) ElementType() reflect.Type

func (EnvironmentEC2Array) ToEnvironmentEC2ArrayOutput

func (i EnvironmentEC2Array) ToEnvironmentEC2ArrayOutput() EnvironmentEC2ArrayOutput

func (EnvironmentEC2Array) ToEnvironmentEC2ArrayOutputWithContext

func (i EnvironmentEC2Array) ToEnvironmentEC2ArrayOutputWithContext(ctx context.Context) EnvironmentEC2ArrayOutput

type EnvironmentEC2ArrayInput

type EnvironmentEC2ArrayInput interface {
	pulumi.Input

	ToEnvironmentEC2ArrayOutput() EnvironmentEC2ArrayOutput
	ToEnvironmentEC2ArrayOutputWithContext(context.Context) EnvironmentEC2ArrayOutput
}

EnvironmentEC2ArrayInput is an input type that accepts EnvironmentEC2Array and EnvironmentEC2ArrayOutput values. You can construct a concrete instance of `EnvironmentEC2ArrayInput` via:

EnvironmentEC2Array{ EnvironmentEC2Args{...} }

type EnvironmentEC2ArrayOutput

type EnvironmentEC2ArrayOutput struct{ *pulumi.OutputState }

func (EnvironmentEC2ArrayOutput) ElementType

func (EnvironmentEC2ArrayOutput) ElementType() reflect.Type

func (EnvironmentEC2ArrayOutput) Index

func (EnvironmentEC2ArrayOutput) ToEnvironmentEC2ArrayOutput

func (o EnvironmentEC2ArrayOutput) ToEnvironmentEC2ArrayOutput() EnvironmentEC2ArrayOutput

func (EnvironmentEC2ArrayOutput) ToEnvironmentEC2ArrayOutputWithContext

func (o EnvironmentEC2ArrayOutput) ToEnvironmentEC2ArrayOutputWithContext(ctx context.Context) EnvironmentEC2ArrayOutput

type EnvironmentEC2Input

type EnvironmentEC2Input interface {
	pulumi.Input

	ToEnvironmentEC2Output() EnvironmentEC2Output
	ToEnvironmentEC2OutputWithContext(ctx context.Context) EnvironmentEC2Output
}

type EnvironmentEC2Map

type EnvironmentEC2Map map[string]EnvironmentEC2Input

func (EnvironmentEC2Map) ElementType

func (EnvironmentEC2Map) ElementType() reflect.Type

func (EnvironmentEC2Map) ToEnvironmentEC2MapOutput

func (i EnvironmentEC2Map) ToEnvironmentEC2MapOutput() EnvironmentEC2MapOutput

func (EnvironmentEC2Map) ToEnvironmentEC2MapOutputWithContext

func (i EnvironmentEC2Map) ToEnvironmentEC2MapOutputWithContext(ctx context.Context) EnvironmentEC2MapOutput

type EnvironmentEC2MapInput

type EnvironmentEC2MapInput interface {
	pulumi.Input

	ToEnvironmentEC2MapOutput() EnvironmentEC2MapOutput
	ToEnvironmentEC2MapOutputWithContext(context.Context) EnvironmentEC2MapOutput
}

EnvironmentEC2MapInput is an input type that accepts EnvironmentEC2Map and EnvironmentEC2MapOutput values. You can construct a concrete instance of `EnvironmentEC2MapInput` via:

EnvironmentEC2Map{ "key": EnvironmentEC2Args{...} }

type EnvironmentEC2MapOutput

type EnvironmentEC2MapOutput struct{ *pulumi.OutputState }

func (EnvironmentEC2MapOutput) ElementType

func (EnvironmentEC2MapOutput) ElementType() reflect.Type

func (EnvironmentEC2MapOutput) MapIndex

func (EnvironmentEC2MapOutput) ToEnvironmentEC2MapOutput

func (o EnvironmentEC2MapOutput) ToEnvironmentEC2MapOutput() EnvironmentEC2MapOutput

func (EnvironmentEC2MapOutput) ToEnvironmentEC2MapOutputWithContext

func (o EnvironmentEC2MapOutput) ToEnvironmentEC2MapOutputWithContext(ctx context.Context) EnvironmentEC2MapOutput

type EnvironmentEC2Output

type EnvironmentEC2Output struct{ *pulumi.OutputState }

func (EnvironmentEC2Output) ElementType

func (EnvironmentEC2Output) ElementType() reflect.Type

func (EnvironmentEC2Output) ToEnvironmentEC2Output

func (o EnvironmentEC2Output) ToEnvironmentEC2Output() EnvironmentEC2Output

func (EnvironmentEC2Output) ToEnvironmentEC2OutputWithContext

func (o EnvironmentEC2Output) ToEnvironmentEC2OutputWithContext(ctx context.Context) EnvironmentEC2Output

type EnvironmentEC2State

type EnvironmentEC2State struct {
	// The ARN of the environment.
	Arn pulumi.StringPtrInput
	// The number of minutes until the running instance is shut down after the environment has last been used.
	AutomaticStopTimeMinutes pulumi.IntPtrInput
	// The description of the environment.
	Description pulumi.StringPtrInput
	// The type of instance to connect to the environment, e.g., `t2.micro`.
	InstanceType pulumi.StringPtrInput
	// The name of the environment.
	Name pulumi.StringPtrInput
	// The ARN of the environment owner. This can be ARN of any AWS IAM principal. Defaults to the environment's creator.
	OwnerArn pulumi.StringPtrInput
	// The ID of the subnet in Amazon VPC that AWS Cloud9 will use to communicate with the Amazon EC2 instance.
	SubnetId pulumi.StringPtrInput
	// Key-value map of resource tags. .If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
	Tags pulumi.StringMapInput
	// A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
	TagsAll pulumi.StringMapInput
	// The type of the environment (e.g., `ssh` or `ec2`)
	Type pulumi.StringPtrInput
}

func (EnvironmentEC2State) ElementType

func (EnvironmentEC2State) ElementType() reflect.Type

type EnvironmentMembership added in v4.34.0

type EnvironmentMembership struct {
	pulumi.CustomResourceState

	// The ID of the environment that contains the environment member you want to add.
	EnvironmentId pulumi.StringOutput `pulumi:"environmentId"`
	// The type of environment member permissions you want to associate with this environment member. Allowed values are `read-only` and `read-write` .
	Permissions pulumi.StringOutput `pulumi:"permissions"`
	// The Amazon Resource Name (ARN) of the environment member you want to add.
	UserArn pulumi.StringOutput `pulumi:"userArn"`
	// he user ID in AWS Identity and Access Management (AWS IAM) of the environment member.
	UserId pulumi.StringOutput `pulumi:"userId"`
}

Provides an environment member to an AWS Cloud9 development environment.

## Example Usage

```go package main

import (

"github.com/pulumi/pulumi-aws/sdk/v4/go/aws/cloud9"
"github.com/pulumi/pulumi-aws/sdk/v4/go/aws/iam"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		testEnvironmentEC2, err := cloud9.NewEnvironmentEC2(ctx, "testEnvironmentEC2", &cloud9.EnvironmentEC2Args{
			InstanceType: pulumi.String("t2.micro"),
		})
		if err != nil {
			return err
		}
		testUser, err := iam.NewUser(ctx, "testUser", nil)
		if err != nil {
			return err
		}
		_, err = cloud9.NewEnvironmentMembership(ctx, "testEnvironmentMembership", &cloud9.EnvironmentMembershipArgs{
			EnvironmentId: testEnvironmentEC2.ID(),
			Permissions:   pulumi.String("read-only"),
			UserArn:       testUser.Arn,
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Cloud9 environment membership can be imported using the `environment-id#user-arn`, e.g.

```sh

$ pulumi import aws:cloud9/environmentMembership:EnvironmentMembership test environment-id#user-arn

```

func GetEnvironmentMembership added in v4.34.0

func GetEnvironmentMembership(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *EnvironmentMembershipState, opts ...pulumi.ResourceOption) (*EnvironmentMembership, error)

GetEnvironmentMembership gets an existing EnvironmentMembership resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewEnvironmentMembership added in v4.34.0

func NewEnvironmentMembership(ctx *pulumi.Context,
	name string, args *EnvironmentMembershipArgs, opts ...pulumi.ResourceOption) (*EnvironmentMembership, error)

NewEnvironmentMembership registers a new resource with the given unique name, arguments, and options.

func (*EnvironmentMembership) ElementType added in v4.34.0

func (*EnvironmentMembership) ElementType() reflect.Type

func (*EnvironmentMembership) ToEnvironmentMembershipOutput added in v4.34.0

func (i *EnvironmentMembership) ToEnvironmentMembershipOutput() EnvironmentMembershipOutput

func (*EnvironmentMembership) ToEnvironmentMembershipOutputWithContext added in v4.34.0

func (i *EnvironmentMembership) ToEnvironmentMembershipOutputWithContext(ctx context.Context) EnvironmentMembershipOutput

type EnvironmentMembershipArgs added in v4.34.0

type EnvironmentMembershipArgs struct {
	// The ID of the environment that contains the environment member you want to add.
	EnvironmentId pulumi.StringInput
	// The type of environment member permissions you want to associate with this environment member. Allowed values are `read-only` and `read-write` .
	Permissions pulumi.StringInput
	// The Amazon Resource Name (ARN) of the environment member you want to add.
	UserArn pulumi.StringInput
}

The set of arguments for constructing a EnvironmentMembership resource.

func (EnvironmentMembershipArgs) ElementType added in v4.34.0

func (EnvironmentMembershipArgs) ElementType() reflect.Type

type EnvironmentMembershipArray added in v4.34.0

type EnvironmentMembershipArray []EnvironmentMembershipInput

func (EnvironmentMembershipArray) ElementType added in v4.34.0

func (EnvironmentMembershipArray) ElementType() reflect.Type

func (EnvironmentMembershipArray) ToEnvironmentMembershipArrayOutput added in v4.34.0

func (i EnvironmentMembershipArray) ToEnvironmentMembershipArrayOutput() EnvironmentMembershipArrayOutput

func (EnvironmentMembershipArray) ToEnvironmentMembershipArrayOutputWithContext added in v4.34.0

func (i EnvironmentMembershipArray) ToEnvironmentMembershipArrayOutputWithContext(ctx context.Context) EnvironmentMembershipArrayOutput

type EnvironmentMembershipArrayInput added in v4.34.0

type EnvironmentMembershipArrayInput interface {
	pulumi.Input

	ToEnvironmentMembershipArrayOutput() EnvironmentMembershipArrayOutput
	ToEnvironmentMembershipArrayOutputWithContext(context.Context) EnvironmentMembershipArrayOutput
}

EnvironmentMembershipArrayInput is an input type that accepts EnvironmentMembershipArray and EnvironmentMembershipArrayOutput values. You can construct a concrete instance of `EnvironmentMembershipArrayInput` via:

EnvironmentMembershipArray{ EnvironmentMembershipArgs{...} }

type EnvironmentMembershipArrayOutput added in v4.34.0

type EnvironmentMembershipArrayOutput struct{ *pulumi.OutputState }

func (EnvironmentMembershipArrayOutput) ElementType added in v4.34.0

func (EnvironmentMembershipArrayOutput) Index added in v4.34.0

func (EnvironmentMembershipArrayOutput) ToEnvironmentMembershipArrayOutput added in v4.34.0

func (o EnvironmentMembershipArrayOutput) ToEnvironmentMembershipArrayOutput() EnvironmentMembershipArrayOutput

func (EnvironmentMembershipArrayOutput) ToEnvironmentMembershipArrayOutputWithContext added in v4.34.0

func (o EnvironmentMembershipArrayOutput) ToEnvironmentMembershipArrayOutputWithContext(ctx context.Context) EnvironmentMembershipArrayOutput

type EnvironmentMembershipInput added in v4.34.0

type EnvironmentMembershipInput interface {
	pulumi.Input

	ToEnvironmentMembershipOutput() EnvironmentMembershipOutput
	ToEnvironmentMembershipOutputWithContext(ctx context.Context) EnvironmentMembershipOutput
}

type EnvironmentMembershipMap added in v4.34.0

type EnvironmentMembershipMap map[string]EnvironmentMembershipInput

func (EnvironmentMembershipMap) ElementType added in v4.34.0

func (EnvironmentMembershipMap) ElementType() reflect.Type

func (EnvironmentMembershipMap) ToEnvironmentMembershipMapOutput added in v4.34.0

func (i EnvironmentMembershipMap) ToEnvironmentMembershipMapOutput() EnvironmentMembershipMapOutput

func (EnvironmentMembershipMap) ToEnvironmentMembershipMapOutputWithContext added in v4.34.0

func (i EnvironmentMembershipMap) ToEnvironmentMembershipMapOutputWithContext(ctx context.Context) EnvironmentMembershipMapOutput

type EnvironmentMembershipMapInput added in v4.34.0

type EnvironmentMembershipMapInput interface {
	pulumi.Input

	ToEnvironmentMembershipMapOutput() EnvironmentMembershipMapOutput
	ToEnvironmentMembershipMapOutputWithContext(context.Context) EnvironmentMembershipMapOutput
}

EnvironmentMembershipMapInput is an input type that accepts EnvironmentMembershipMap and EnvironmentMembershipMapOutput values. You can construct a concrete instance of `EnvironmentMembershipMapInput` via:

EnvironmentMembershipMap{ "key": EnvironmentMembershipArgs{...} }

type EnvironmentMembershipMapOutput added in v4.34.0

type EnvironmentMembershipMapOutput struct{ *pulumi.OutputState }

func (EnvironmentMembershipMapOutput) ElementType added in v4.34.0

func (EnvironmentMembershipMapOutput) MapIndex added in v4.34.0

func (EnvironmentMembershipMapOutput) ToEnvironmentMembershipMapOutput added in v4.34.0

func (o EnvironmentMembershipMapOutput) ToEnvironmentMembershipMapOutput() EnvironmentMembershipMapOutput

func (EnvironmentMembershipMapOutput) ToEnvironmentMembershipMapOutputWithContext added in v4.34.0

func (o EnvironmentMembershipMapOutput) ToEnvironmentMembershipMapOutputWithContext(ctx context.Context) EnvironmentMembershipMapOutput

type EnvironmentMembershipOutput added in v4.34.0

type EnvironmentMembershipOutput struct{ *pulumi.OutputState }

func (EnvironmentMembershipOutput) ElementType added in v4.34.0

func (EnvironmentMembershipOutput) ToEnvironmentMembershipOutput added in v4.34.0

func (o EnvironmentMembershipOutput) ToEnvironmentMembershipOutput() EnvironmentMembershipOutput

func (EnvironmentMembershipOutput) ToEnvironmentMembershipOutputWithContext added in v4.34.0

func (o EnvironmentMembershipOutput) ToEnvironmentMembershipOutputWithContext(ctx context.Context) EnvironmentMembershipOutput

type EnvironmentMembershipState added in v4.34.0

type EnvironmentMembershipState struct {
	// The ID of the environment that contains the environment member you want to add.
	EnvironmentId pulumi.StringPtrInput
	// The type of environment member permissions you want to associate with this environment member. Allowed values are `read-only` and `read-write` .
	Permissions pulumi.StringPtrInput
	// The Amazon Resource Name (ARN) of the environment member you want to add.
	UserArn pulumi.StringPtrInput
	// he user ID in AWS Identity and Access Management (AWS IAM) of the environment member.
	UserId pulumi.StringPtrInput
}

func (EnvironmentMembershipState) ElementType added in v4.34.0

func (EnvironmentMembershipState) ElementType() reflect.Type

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL