amazonka-opsworks-0.0.1: Amazon OpsWorks SDK.

Safe HaskellNone




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.



Request constructor

Request lenses

ciAmiId :: Lens' CreateInstance (Maybe Text) Source

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 Architecture) Source

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 AutoScalingType) Source

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) Source

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

ciEbsOptimized :: Lens' CreateInstance (Maybe Bool) Source

Whether to create an Amazon EBS-optimized instance.

ciHostname :: Lens' CreateInstance (Maybe Text) Source

The instance host name.

ciInstallUpdatesOnBoot :: Lens' CreateInstance (Maybe Bool) Source

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 Source

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] Source

An array that contains the instance layer IDs.

ciOs :: Lens' CreateInstance (Maybe Text) Source

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 RootDeviceType) Source

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

ciSshKeyName :: Lens' CreateInstance (Maybe Text) Source

The instance SSH key name.

ciSubnetId :: Lens' CreateInstance (Maybe Text) Source

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) Source

The instance's virtualization type, paravirtual or hvm.


Response constructor

createInstanceResponse :: CreateInstanceResponse Source

CreateInstanceResponse constructor.

The fields accessible through corresponding lenses are:

Response lenses