Safe Haskell | None |
---|---|
Language | Haskell2010 |
Creates an instance in a specified stack. For more information, see Adding anInstance 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 UserPermissions.
http://docs.aws.amazon.com/opsworks/latest/APIReference/API_CreateInstance.html
- data CreateInstance
- createInstance :: Text -> Text -> CreateInstance
- ciAmiId :: Lens' CreateInstance (Maybe Text)
- ciArchitecture :: Lens' CreateInstance (Maybe Architecture)
- ciAutoScalingType :: Lens' CreateInstance (Maybe AutoScalingType)
- ciAvailabilityZone :: Lens' CreateInstance (Maybe Text)
- ciEbsOptimized :: Lens' CreateInstance (Maybe Bool)
- ciHostname :: Lens' CreateInstance (Maybe Text)
- ciInstallUpdatesOnBoot :: Lens' CreateInstance (Maybe Bool)
- ciInstanceType :: Lens' CreateInstance Text
- ciLayerIds :: Lens' CreateInstance [Text]
- ciOs :: Lens' CreateInstance (Maybe Text)
- ciRootDeviceType :: Lens' CreateInstance (Maybe RootDeviceType)
- ciSshKeyName :: Lens' CreateInstance (Maybe Text)
- ciStackId :: Lens' CreateInstance Text
- ciSubnetId :: Lens' CreateInstance (Maybe Text)
- ciVirtualizationType :: Lens' CreateInstance (Maybe Text)
- data CreateInstanceResponse
- createInstanceResponse :: CreateInstanceResponse
- cirInstanceId :: Lens' CreateInstanceResponse (Maybe Text)
Request
data CreateInstance Source
Request constructor
CreateInstance
constructor.
The fields accessible through corresponding lenses are:
ciAmiId
::
Maybe
Text
ciArchitecture
::
Maybe
Architecture
ciAutoScalingType
::
Maybe
AutoScalingType
ciAvailabilityZone
::
Maybe
Text
ciEbsOptimized
::
Maybe
Bool
ciHostname
::
Maybe
Text
ciInstallUpdatesOnBoot
::
Maybe
Bool
ciInstanceType
::
Text
ciLayerIds
::
[Text
]ciOs
::
Maybe
Text
ciRootDeviceType
::
Maybe
RootDeviceType
ciSshKeyName
::
Maybe
Text
ciStackId
::
Text
ciSubnetId
::
Maybe
Text
ciVirtualizationType
::
Maybe
Text
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 andTypes.
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 andEndpoints.
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 RootDevice.
ciSshKeyName :: Lens' CreateInstance (Maybe Text) Source
The instance SSH key name.
ciStackId :: Lens' CreateInstance Text Source
The stack ID.
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
Response constructor
createInstanceResponse :: CreateInstanceResponse Source
CreateInstanceResponse
constructor.
The fields accessible through corresponding lenses are:
Response lenses
cirInstanceId :: Lens' CreateInstanceResponse (Maybe Text) Source
The instance ID.