Network.AWS.OpsWorks.CreateInstance

Creates an instance in a specified stack. For more information, see Adding an Instance to a Layer. Required Permissions: To use this action, an IAM user must have a Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information on user permissions, see Managing User Permissions.

http://docs.aws.amazon.com/opsworks/latest/APIReference/API_CreateInstance.html

Request

data CreateInstance

Instances

Eq CreateInstance

Ord CreateInstance

Show CreateInstance

ToJSON CreateInstance

AWSRequest CreateInstance

ToQuery CreateInstance

ToHeaders CreateInstance

ToPath CreateInstance

type Rs CreateInstance = CreateInstanceResponse

type Sv CreateInstance = OpsWorks

Request constructor

createInstance

Arguments

:: Text

ciStackId

-> Text

ciInstanceType

-> CreateInstance

CreateInstance constructor.

The fields accessible through corresponding lenses are:

• ciAmiId :: Maybe Text
• ciArchitecture :: Maybe Text
• ciAutoScalingType :: Maybe Text
• ciAvailabilityZone :: Maybe Text
• ciEbsOptimized :: Maybe Bool
• ciHostname :: Maybe Text
• ciInstallUpdatesOnBoot :: Maybe Bool
• ciInstanceType :: Text
• ciLayerIds :: [Text]
• ciOs :: Maybe Text
• ciRootDeviceType :: Maybe Text
• ciSshKeyName :: Maybe Text
• ciStackId :: Text
• ciSubnetId :: Maybe Text
• ciVirtualizationType :: Maybe Text

Request lenses

ciAmiId :: Lens' CreateInstance (Maybe Text)

A custom AMI ID to be used to create the instance. The AMI should be based on one of the standard AWS OpsWorks APIs: Amazon Linux or Ubuntu 12.04 LTS. For more information, see Instances.

ciArchitecture :: Lens' CreateInstance (Maybe Text)

The instance architecture. The default option is x86_64. Instance types do not necessarily support both architectures. For a list of the architectures that are supported by the different instance types, see Instance Families and Types.

ciAutoScalingType :: Lens' CreateInstance (Maybe Text)

The instance auto scaling type, which has three possible values: AlwaysRunning: A 24/7 instance, which is not affected by auto scaling. TimeBasedAutoScaling: A time-based auto scaling instance, which is started and stopped based on a specified schedule. To specify the schedule, call SetTimeBasedAutoScaling. LoadBasedAutoScaling: A load-based auto scaling instance, which is started and stopped based on load metrics. To use load-based auto scaling, you must enable it for the instance layer and configure the thresholds by calling SetLoadBasedAutoScaling.

ciAvailabilityZone :: Lens' CreateInstance (Maybe Text)

The instance Availability Zone. For more information, see Regions and Endpoints.

ciEbsOptimized :: Lens' CreateInstance (Maybe Bool)

Whether to create an Amazon EBS-optimized instance.

ciHostname :: Lens' CreateInstance (Maybe Text)

The instance host name.

ciInstallUpdatesOnBoot :: Lens' CreateInstance (Maybe Bool)

Whether to install operating system and package updates when the instance boots. The default value is true. To control when updates are installed, set this value to false. You must then update your instances manually by using CreateDeployment to run the update_dependencies stack command or manually running yum (Amazon Linux) or apt-get (Ubuntu) on the instances.

ciInstanceType :: Lens' CreateInstance Text

The instance type. AWS OpsWorks supports all instance types except Cluster Compute, Cluster GPU, and High Memory Cluster. For more information, see Instance Families and Types. The parameter values that you use to specify the various types are in the API Name column of the Available Instance Types table.

ciLayerIds :: Lens' CreateInstance [Text]

An array that contains the instance layer IDs.

ciOs :: Lens' CreateInstance (Maybe Text)

The instance operating system, which must be set to one of the following. Standard operating systems: Amazon Linux or Ubuntu 12.04 LTS Custom AMIs: Custom The default option is Amazon Linux. If you set this parameter to Custom, you must use the CreateInstance action's AmiId parameter to specify the custom AMI that you want to use. For more information on the standard operating systems, see Operating SystemsFor more information on how to use custom AMIs with OpsWorks, see Using Custom AMIs.

ciRootDeviceType :: Lens' CreateInstance (Maybe Text)

The instance root device type. For more information, see Storage for the Root Device.

ciSshKeyName :: Lens' CreateInstance (Maybe Text)

The instance SSH key name.

ciStackId :: Lens' CreateInstance Text

The stack ID.

ciSubnetId :: Lens' CreateInstance (Maybe Text)

The ID of the instance's subnet. If the stack is running in a VPC, you can use this parameter to override the stack's default subnet ID value and direct AWS OpsWorks to launch the instance in a different subnet.

ciVirtualizationType :: Lens' CreateInstance (Maybe Text)

The instance's virtualization type, paravirtual or hvm.

Response

data CreateInstanceResponse

Instances

Eq CreateInstanceResponse

Ord CreateInstanceResponse

Show CreateInstanceResponse

FromJSON CreateInstanceResponse

Monoid CreateInstanceResponse

Response constructor

createInstanceResponse :: CreateInstanceResponse

CreateInstanceResponse constructor.

The fields accessible through corresponding lenses are:

• cirInstanceId :: Maybe Text

Response lenses

cirInstanceId :: Lens' CreateInstanceResponse (Maybe Text)

The instance ID.