Struct aws_sdk_cloud9::client::fluent_builders::CreateEnvironmentEC2

source ·

pub struct CreateEnvironmentEC2 { /* private fields */ }

Expand description

Fluent builder constructing a request to CreateEnvironmentEC2.

Creates an Cloud9 development environment, launches an Amazon Elastic Compute Cloud (Amazon EC2) instance, and then connects from the instance to the environment.

Implementations§

source §

impl CreateEnvironmentEC2

source

pub async fn customize(
self
) -> Result<CustomizableOperation<CreateEnvironmentEC2, AwsResponseRetryClassifier>, SdkError<CreateEnvironmentEC2Error>>

Consume this builder, creating a customizable operation that can be modified before being sent. The operation’s inner http::Request can be modified as well.

source

pub async fn send(
self
) -> Result<CreateEnvironmentEc2Output, SdkError<CreateEnvironmentEC2Error>>

Sends the request and returns the response.

If an error occurs, an SdkError will be returned with additional details that can be matched against.

By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.

source

pub fn name(self, input: impl Into<String>) -> Self

The name of the environment to create.

This name is visible to other IAM users in the same Amazon Web Services account.

source

pub fn set_name(self, input: Option<String>) -> Self

The name of the environment to create.

This name is visible to other IAM users in the same Amazon Web Services account.

source

pub fn description(self, input: impl Into<String>) -> Self

The description of the environment to create.

source

pub fn set_description(self, input: Option<String>) -> Self

The description of the environment to create.

source

pub fn client_request_token(self, input: impl Into<String>) -> Self

A unique, case-sensitive string that helps Cloud9 to ensure this operation completes no more than one time.

For more information, see Client Tokens in the Amazon EC2 API Reference.

source

pub fn set_client_request_token(self, input: Option<String>) -> Self

A unique, case-sensitive string that helps Cloud9 to ensure this operation completes no more than one time.

For more information, see Client Tokens in the Amazon EC2 API Reference.

source

pub fn instance_type(self, input: impl Into<String>) -> Self

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

source

pub fn set_instance_type(self, input: Option<String>) -> Self

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

source

pub fn subnet_id(self, input: impl Into<String>) -> Self

The ID of the subnet in Amazon VPC that Cloud9 will use to communicate with the Amazon EC2 instance.

source

pub fn set_subnet_id(self, input: Option<String>) -> Self

The ID of the subnet in Amazon VPC that Cloud9 will use to communicate with the Amazon EC2 instance.

source

pub fn image_id(self, input: impl Into<String>) -> Self

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 Amazon EC2 Systems Manager (SSM) path.

The default Amazon Linux AMI is currently used if the parameter isn't explicitly assigned a value in the request.

In the future the parameter for Amazon Linux will no longer be available when you specify an AMI for your instance. Amazon Linux 2 will then become the default AMI, which is used to launch your instance if no parameter is explicitly defined.

AMI aliases

Amazon Linux (default): amazonlinux-1-x86_64
Amazon Linux 2: amazonlinux-2-x86_64
Ubuntu 18.04: ubuntu-18.04-x86_64

SSM paths

Amazon Linux (default): resolve:ssm:/aws/service/cloud9/amis/amazonlinux-1-x86_64
Amazon Linux 2: resolve:ssm:/aws/service/cloud9/amis/amazonlinux-2-x86_64
Ubuntu 18.04: resolve:ssm:/aws/service/cloud9/amis/ubuntu-18.04-x86_64

source

pub fn set_image_id(self, input: Option<String>) -> Self

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 Amazon EC2 Systems Manager (SSM) path.

The default Amazon Linux AMI is currently used if the parameter isn't explicitly assigned a value in the request.

In the future the parameter for Amazon Linux will no longer be available when you specify an AMI for your instance. Amazon Linux 2 will then become the default AMI, which is used to launch your instance if no parameter is explicitly defined.

AMI aliases

Amazon Linux (default): amazonlinux-1-x86_64
Amazon Linux 2: amazonlinux-2-x86_64
Ubuntu 18.04: ubuntu-18.04-x86_64

SSM paths

Amazon Linux (default): resolve:ssm:/aws/service/cloud9/amis/amazonlinux-1-x86_64
Amazon Linux 2: resolve:ssm:/aws/service/cloud9/amis/amazonlinux-2-x86_64
Ubuntu 18.04: resolve:ssm:/aws/service/cloud9/amis/ubuntu-18.04-x86_64

source

pub fn automatic_stop_time_minutes(self, input: i32) -> Self

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

source

pub fn set_automatic_stop_time_minutes(self, input: Option<i32>) -> Self

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

source

pub fn owner_arn(self, input: impl Into<String>) -> Self

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

source

pub fn set_owner_arn(self, input: Option<String>) -> Self

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

source

pub fn tags(self, input: Tag) -> Self

Appends an item to tags.

To override the contents of this collection use set_tags.

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

source

pub fn set_tags(self, input: Option<Vec<Tag>>) -> Self

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

source

pub fn connection_type(self, input: ConnectionType) -> Self

The connection type used for connecting to an Amazon EC2 environment. Valid values are CONNECT_SSH (default) and CONNECT_SSM (connected through Amazon EC2 Systems Manager).

For more information, see Accessing no-ingress EC2 instances with Amazon EC2 Systems Manager in the Cloud9 User Guide.

source

pub fn set_connection_type(self, input: Option<ConnectionType>) -> Self

The connection type used for connecting to an Amazon EC2 environment. Valid values are CONNECT_SSH (default) and CONNECT_SSM (connected through Amazon EC2 Systems Manager).

For more information, see Accessing no-ingress EC2 instances with Amazon EC2 Systems Manager in the Cloud9 User Guide.

source

pub fn dry_run(self, input: bool) -> Self

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

source

pub fn set_dry_run(self, input: Option<bool>) -> Self

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.