Beruflich Dokumente
Kultur Dokumente
org
ii
current
current
Table of Contents
HOT reference overview ................................................................................................. vi
Conventions ............................................................................................................ vi
1. OpenStack Resource Types .......................................................................................... 1
OS::Ceilometer::Alarm ............................................................................................. 2
OS::Ceilometer::CombinationAlarm .......................................................................... 6
OS::Cinder::Volume ................................................................................................. 8
OS::Cinder::VolumeAttachment ............................................................................. 11
OS::Glance::Image ................................................................................................. 12
OS::Heat::AccessPolicy ............................................................................................ 15
OS::Heat::AutoScalingGroup .................................................................................. 16
OS::Heat::CWLiteAlarm .......................................................................................... 18
OS::Heat::CloudConfig ........................................................................................... 21
OS::Heat::HARestarter ........................................................................................... 23
OS::Heat::InstanceGroup ........................................................................................ 24
OS::Heat::MultipartMime ....................................................................................... 25
OS::Heat::RandomString ........................................................................................ 27
OS::Heat::ResourceGroup ....................................................................................... 30
OS::Heat::ScalingPolicy ........................................................................................... 34
OS::Heat::SoftwareComponent .............................................................................. 35
OS::Heat::SoftwareConfig ...................................................................................... 39
OS::Heat::SoftwareDeployment ............................................................................. 43
OS::Heat::SoftwareDeployments ............................................................................ 45
OS::Heat::StructuredConfig .................................................................................... 48
OS::Heat::StructuredDeployment ........................................................................... 51
OS::Heat::StructuredDeployments .......................................................................... 53
OS::Heat::SwiftSignal ............................................................................................. 55
OS::Heat::SwiftSignalHandle .................................................................................. 57
OS::Heat::UpdateWaitConditionHandle .................................................................. 58
OS::Heat::WaitCondition ........................................................................................ 59
OS::Heat::WaitConditionHandle ............................................................................. 60
OS::Neutron::Firewall ............................................................................................. 61
OS::Neutron::FirewallPolicy .................................................................................... 63
OS::Neutron::FirewallRule ...................................................................................... 64
OS::Neutron::FloatingIP ......................................................................................... 68
OS::Neutron::FloatingIPAssociation ........................................................................ 69
OS::Neutron::HealthMonitor .................................................................................. 71
OS::Neutron::IKEPolicy ........................................................................................... 73
OS::Neutron::IPsecPolicy ........................................................................................ 76
OS::Neutron::IPsecSiteConnection .......................................................................... 79
OS::Neutron::LoadBalancer .................................................................................... 83
OS::Neutron::MeteringLabel .................................................................................. 84
OS::Neutron::MeteringRule .................................................................................... 85
OS::Neutron::Net ................................................................................................... 87
OS::Neutron::NetworkGateway .............................................................................. 89
OS::Neutron::Pool .................................................................................................. 92
OS::Neutron::PoolMember ..................................................................................... 96
OS::Neutron::Port .................................................................................................. 98
OS::Neutron::ProviderNet .................................................................................... 102
iii
current
OS::Neutron::Router ............................................................................................
OS::Neutron::RouterGateway ...............................................................................
OS::Neutron::RouterInterface ...............................................................................
OS::Neutron::SecurityGroup .................................................................................
OS::Neutron::Subnet ............................................................................................
OS::Neutron::VPNService ......................................................................................
OS::Nova::FloatingIP ............................................................................................
OS::Nova::FloatingIPAssociation ...........................................................................
OS::Nova::KeyPair ................................................................................................
OS::Nova::Server ..................................................................................................
OS::Nova::ServerGroup ........................................................................................
OS::Sahara::Cluster ..............................................................................................
OS::Sahara::ClusterTemplate ................................................................................
OS::Sahara::NodeGroupTemplate .........................................................................
OS::Swift::Container .............................................................................................
OS::Trove::Instance ..............................................................................................
2. CloudFormation Compatible Resource Types ............................................................
AWS::AutoScaling::AutoScalingGroup ..................................................................
AWS::AutoScaling::LaunchConfiguration ..............................................................
AWS::AutoScaling::ScalingPolicy ...........................................................................
AWS::CloudFormation::Stack ................................................................................
AWS::CloudFormation::WaitCondition .................................................................
AWS::CloudFormation::WaitConditionHandle .......................................................
AWS::CloudWatch::Alarm ....................................................................................
AWS::EC2::EIP ......................................................................................................
AWS::EC2::EIPAssociation .....................................................................................
AWS::EC2::Instance ..............................................................................................
AWS::EC2::InternetGateway .................................................................................
AWS::EC2::NetworkInterface ...............................................................................
AWS::EC2::RouteTable .........................................................................................
AWS::EC2::SecurityGroup .....................................................................................
AWS::EC2::Subnet ................................................................................................
AWS::EC2::SubnetRouteTableAssociation .............................................................
AWS::EC2::VPC ....................................................................................................
AWS::EC2::VPCGatewayAttachment .....................................................................
AWS::EC2::Volume ...............................................................................................
AWS::EC2::VolumeAttachment .............................................................................
AWS::ElasticLoadBalancing::LoadBalancer ............................................................
AWS::IAM::AccessKey ..........................................................................................
AWS::IAM::User ...................................................................................................
AWS::RDS::DBInstance .........................................................................................
AWS::S3::Bucket ..................................................................................................
3. CloudFormation Compatible Functions .....................................................................
Ref ......................................................................................................................
Fn::Base64 ...........................................................................................................
Fn::FindInMap .....................................................................................................
Fn::GetAtt ...........................................................................................................
Fn::GetAZs ...........................................................................................................
Fn::Join ................................................................................................................
Fn::Select .............................................................................................................
Fn::Split ...............................................................................................................
iv
104
107
108
109
113
116
118
119
120
122
130
131
133
136
139
141
146
146
149
154
155
157
158
159
161
162
164
171
172
174
175
178
180
181
182
183
185
187
190
191
193
195
198
198
198
199
199
199
200
200
200
current
Fn::Replace ..........................................................................................................
Fn::ResourceFacade .............................................................................................
Fn::MemberListToMap .........................................................................................
A. Community support ................................................................................................
Documentation ...................................................................................................
ask.openstack.org ................................................................................................
OpenStack mailing lists ........................................................................................
The OpenStack wiki .............................................................................................
The Launchpad Bugs area ...................................................................................
The OpenStack IRC channel .................................................................................
Documentation feedback ....................................................................................
OpenStack distribution packages .........................................................................
201
201
202
203
203
204
204
205
205
206
206
206
current
Conventions
The OpenStack documentation uses several typesetting conventions.
Notices
Notices take these forms:
Note
A handy tip or reminder.
Important
Something you must be aware of before proceeding.
Warning
Critical information about the risk of data loss or security issues.
Command prompts
$ prompt
Any user, including the root user, can run commands that are prefixed with
the $ prompt.
# prompt
The root user must run commands that are prefixed with the # prompt. You
can also prefix these commands with the sudo command, if available, to run
them.
vi
current
current
OS::Neutron::SecurityGroup .........................................................................................
OS::Neutron::Subnet ....................................................................................................
OS::Neutron::VPNService ..............................................................................................
OS::Nova::FloatingIP ....................................................................................................
OS::Nova::FloatingIPAssociation ...................................................................................
OS::Nova::KeyPair ........................................................................................................
OS::Nova::Server ..........................................................................................................
OS::Nova::ServerGroup ................................................................................................
OS::Sahara::Cluster ......................................................................................................
OS::Sahara::ClusterTemplate ........................................................................................
OS::Sahara::NodeGroupTemplate .................................................................................
OS::Swift::Container .....................................................................................................
OS::Trove::Instance ......................................................................................................
109
113
116
118
119
120
122
130
131
133
136
139
141
OS::Ceilometer::Alarm
Properties
alarm_actions
comparison_operator
description
enabled
evaluation_periods
insufficient_data_actions
current
meter_name
ok_actions
period
query
current
Comparison operator
Updates cause replacement.
Optional property.
Allowed values: le, ge, eq, lt, gt, ne
value
repeat_actions
statistic
threshold
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Ceilometer::Alarm
properties:
alarm_actions: [Value, Value, ...]
comparison_operator: String
description: String
enabled: Boolean
evaluation_periods: Integer
insufficient_data_actions: [Value, Value, ...]
current
matching_metadata: {...}
meter_name: String
ok_actions: [Value, Value, ...]
period: Integer
query: [{"field": String, "value": String, "op": String}, {"field":
String, "value": String, "op": String}, ...]
repeat_actions: Boolean
statistic: String
threshold: Number
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Ceilometer::Alarm
Properties:
alarm_actions: [Value, Value, ...]
comparison_operator: String
description: String
enabled: Boolean
evaluation_periods: Integer
insufficient_data_actions: [Value, Value, ...]
matching_metadata: {...}
meter_name: String
ok_actions: [Value, Value, ...]
period: Integer
query: [{"field": String, "value": String, "op": String}, {"field":
String, "value": String, "op": String}, ...]
repeat_actions: Boolean
statistic: String
threshold: Number
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Ceilometer::Alarm",
"Properties": {
"alarm_actions": [Value, Value, ...],
"comparison_operator": String,
"description": String,
"enabled": Boolean,
"evaluation_periods": Integer,
"insufficient_data_actions": [Value, Value, ...],
"matching_metadata": {...},
"meter_name": String,
"ok_actions": [Value, Value, ...],
"period": Integer,
"query": [{"field": String, "value": String, "op": String}, {"field":
String, "value": String, "op": String}, ...],
"repeat_actions": Boolean,
"statistic": String,
"threshold": Number
current
}
}
}
}
OS::Ceilometer::CombinationAlarm
Available since 2014.1 (Icehouse).
Properties
alarm_actions
alarm_ids
description
enabled
insufficient_data_actions
ok_actions
operator
current
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Ceilometer::CombinationAlarm
properties:
alarm_actions: [Value, Value, ...]
alarm_ids: [Value, Value, ...]
description: String
enabled: Boolean
insufficient_data_actions: [Value, Value, ...]
ok_actions: [Value, Value, ...]
operator: String
repeat_actions: Boolean
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Ceilometer::CombinationAlarm
Properties:
alarm_actions: [Value, Value, ...]
alarm_ids: [Value, Value, ...]
description: String
enabled: Boolean
insufficient_data_actions: [Value, Value, ...]
ok_actions: [Value, Value, ...]
operator: String
repeat_actions: Boolean
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
current
"TheResource": {
"Type": "OS::Ceilometer::CombinationAlarm",
"Properties": {
"alarm_actions": [Value, Value, ...],
"alarm_ids": [Value, Value, ...],
"description": String,
"enabled": Boolean,
"insufficient_data_actions": [Value, Value, ...],
"ok_actions": [Value, Value, ...],
"operator": String,
"repeat_actions": Boolean
}
}
}
}
OS::Cinder::Volume
Properties
availability_zone
backup_id
description
image
metadata
name
current
Optional property.
scheduler_hints
size
snapshot_id
source_volid
volume_type
imageRef
Note
DEPRECATED - Use property image.
The ID of the image to create the volume from.
Updates cause replacement.
Optional property.
Attributes
attachments
availability_zone
bootable
current
created_at
display_description
display_name
encrypted
metadata
metadata_values
size
snapshot_id
source_volid
status
volume_type
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Cinder::Volume
properties:
availability_zone: String
backup_id: String
description: String
image: String
metadata: {...}
name: String
scheduler_hints: {...}
size: Integer
snapshot_id: String
source_volid: String
volume_type: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Cinder::Volume
Properties:
availability_zone: String
backup_id: String
description: String
image: String
10
current
metadata: {...}
name: String
scheduler_hints: {...}
size: Integer
snapshot_id: String
source_volid: String
volume_type: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Cinder::Volume",
"Properties": {
"availability_zone": String,
"backup_id": String,
"description": String,
"image": String,
"metadata": {...},
"name": String,
"scheduler_hints": {...},
"size": Integer,
"snapshot_id": String,
"source_volid": String,
"volume_type": String
}
}
}
}
OS::Cinder::VolumeAttachment
Properties
instance_uuid
mountpoint
The location where the volume is exposed on the instance. This assignment may not be honored and it is advised that the path /dev/disk/byid/virtio-<VolumeId> be used instead.
Can be updated without replacement.
Optional property.
volume_id
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Cinder::VolumeAttachment
properties:
instance_uuid: String
mountpoint: String
volume_id: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Cinder::VolumeAttachment
Properties:
instance_uuid: String
mountpoint: String
volume_id: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Cinder::VolumeAttachment",
"Properties": {
"instance_uuid": String,
"mountpoint": String,
"volume_id": String
}
}
}
}
OS::Glance::Image
A resource managing for image in Glance.
Available since 2014.2 (Juno).
Properties
container_format
current
current
id
is_public
location
URL where the data for this image already resides. For example,
if the image data is stored in swift, you could specify "swift://
example.com/container/obj".
Updates cause replacement.
Required property.
min_disk
Amount of disk space (in GB) required to boot image. Default value is 0 if not specified and means no limit on the disk size.
Updates cause replacement.
Optional property.
The value must be at least 0.
min_ram
name
Name for the image. The name of an image is not unique to a Image Service node.
Updates cause replacement.
Optional property.
13
current
Whether the image can be deleted. If the value is True, the image
is protected and cannot be deleted.
Updates cause replacement.
Optional property.
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Glance::Image
properties:
container_format: String
disk_format: String
id: String
is_public: Boolean
location: String
min_disk: Integer
min_ram: Integer
name: String
protected: Boolean
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Glance::Image
Properties:
container_format: String
disk_format: String
id: String
is_public: Boolean
location: String
min_disk: Integer
min_ram: Integer
name: String
protected: Boolean
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Glance::Image",
"Properties": {
"container_format": String,
"disk_format": String,
"id": String,
"is_public": Boolean,
14
current
"location": String,
"min_disk": Integer,
"min_ram": Integer,
"name": String,
"protected": Boolean
}
}
}
}
OS::Heat::AccessPolicy
Properties
AllowedResources
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Heat::AccessPolicy
properties:
AllowedResources: [Value, Value, ...]
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Heat::AccessPolicy
Properties:
AllowedResources: [Value, Value, ...]
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Heat::AccessPolicy",
"Properties": {
"AllowedResources": [Value, Value, ...]
}
}
}
}
15
current
OS::Heat::AutoScalingGroup
An autoscaling group that can scale arbitrary resources.
Available since 2014.1 (Icehouse).
Properties
cooldown
desired_capacity
max_size
min_size
resource
rolling_updates
16
current
pause_time
Attributes
current_size
outputs
outputs_list
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Heat::AutoScalingGroup
properties:
cooldown: Integer
desired_capacity: Integer
max_size: Integer
min_size: Integer
resource: {...}
rolling_updates: {"min_in_service": Number, "pause_time": Number,
"max_batch_size": Number}
17
current
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Heat::AutoScalingGroup
Properties:
cooldown: Integer
desired_capacity: Integer
max_size: Integer
min_size: Integer
resource: {...}
rolling_updates: {"min_in_service": Number, "pause_time": Number,
"max_batch_size": Number}
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Heat::AutoScalingGroup",
"Properties": {
"cooldown": Integer,
"desired_capacity": Integer,
"max_size": Integer,
"min_size": Integer,
"resource": {...},
"rolling_updates": {"min_in_service": Number, "pause_time": Number,
"max_batch_size": Number}
}
}
}
}
OS::Heat::CWLiteAlarm
Note
DEPRECATED - OS::Heat::CWLiteAlarm is deprecated, use OS::Ceilometer::Alarm
instead.
Properties
AlarmActions
AlarmDescription
current
Dimensions
EvaluationPeriods
InsufficientDataActions
MetricName
Namespace
OKActions
Period
current
Threshold
Units
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Heat::CWLiteAlarm
properties:
AlarmActions: [Value, Value, ...]
AlarmDescription: String
ComparisonOperator: String
Dimensions: [Value, Value, ...]
EvaluationPeriods: String
InsufficientDataActions: [Value, Value, ...]
MetricName: String
Namespace: String
OKActions: [Value, Value, ...]
Period: String
Statistic: String
Threshold: String
Units: String
20
current
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Heat::CWLiteAlarm
Properties:
AlarmActions: [Value, Value, ...]
AlarmDescription: String
ComparisonOperator: String
Dimensions: [Value, Value, ...]
EvaluationPeriods: String
InsufficientDataActions: [Value, Value, ...]
MetricName: String
Namespace: String
OKActions: [Value, Value, ...]
Period: String
Statistic: String
Threshold: String
Units: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Heat::CWLiteAlarm",
"Properties": {
"AlarmActions": [Value, Value, ...],
"AlarmDescription": String,
"ComparisonOperator": String,
"Dimensions": [Value, Value, ...],
"EvaluationPeriods": String,
"InsufficientDataActions": [Value, Value, ...],
"MetricName": String,
"Namespace": String,
"OKActions": [Value, Value, ...],
"Period": String,
"Statistic": String,
"Threshold": String,
"Units": String
}
}
}
}
OS::Heat::CloudConfig
A configuration resource for representing cloud-init cloud-config.
This resource allows cloud-config YAML to be defined and stored by the config API. Any intrinsic functions called in the config will be resolved before storing the result.
21
current
Properties
cloud_config
Map representing the cloud-config data structure which will be formatted as YAML.
Updates cause replacement.
Optional property.
Attributes
config
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Heat::CloudConfig
properties:
cloud_config: {...}
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Heat::CloudConfig
Properties:
cloud_config: {...}
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Heat::CloudConfig",
"Properties": {
"cloud_config": {...}
}
}
}
}
22
OS::Heat::HARestarter
Properties
InstanceId
Instance ID to be restarted.
Updates cause replacement.
Required property.
Attributes
AlarmUrl
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Heat::HARestarter
properties:
InstanceId: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Heat::HARestarter
Properties:
InstanceId: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Heat::HARestarter",
"Properties": {
"InstanceId": String
}
}
}
}
23
current
OS::Heat::InstanceGroup
Properties
AvailabilityZones
Not Implemented.
Updates cause replacement.
Required property.
LaunchConfigurationName
LoadBalancerNames
Size
Tags
Value
Attributes
InstanceList
current
current
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Heat::InstanceGroup
properties:
AvailabilityZones: [Value, Value, ...]
LaunchConfigurationName: String
LoadBalancerNames: [Value, Value, ...]
Size: Integer
Tags: [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Heat::InstanceGroup
Properties:
AvailabilityZones: [Value, Value, ...]
LaunchConfigurationName: String
LoadBalancerNames: [Value, Value, ...]
Size: Integer
Tags: [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Heat::InstanceGroup",
"Properties": {
"AvailabilityZones": [Value, Value, ...],
"LaunchConfigurationName": String,
"LoadBalancerNames": [Value, Value, ...],
"Size": Integer,
"Tags": [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
}
}
}
}
OS::Heat::MultipartMime
A resource which assembles a collection of software configurations as a multi-part mime
message.
25
current
Parts in the message can be populated with inline configuration or references to other config resources. If the referenced resource is itself a valid multi-part mime message, that will
be broken into parts and those parts appended to this message.
The resulting multi-part mime message will be stored by the configs API and can be referenced in properties such as OS::Nova::Server user_data.
This resource is generally used to build a list of cloud-init configuration elements including
scripts and cloud-config. Since cloud-init is boot-only configuration, any changes to the definition will result in the replacement of all servers which reference it.
Available since 2014.1 (Icehouse).
Properties
parts
filename
subtype
type
26
current
Attributes
config
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Heat::MultipartMime
properties:
parts: [{"type": String, "subtype": String, "config": String,
"filename": String}, {"type": String, "subtype": String, "config": String,
"filename": String}, ...]
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Heat::MultipartMime
Properties:
parts: [{"type": String, "subtype": String, "config": String,
"filename": String}, {"type": String, "subtype": String, "config": String,
"filename": String}, ...]
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Heat::MultipartMime",
"Properties": {
"parts": [{"type": String, "subtype": String, "config": String,
"filename": String}, {"type": String, "subtype": String, "config": String,
"filename": String}, ...]
}
}
}
}
OS::Heat::RandomString
A resource which generates a random string.
This is useful for configuring passwords and secrets on services.
Available since 2014.1 (Icehouse).
27
current
Properties
character_classes
A character class and its corresponding min constraint to generate the random string from.
Updates cause replacement.
Optional property, defaults to "lettersdigits".
Allowed values: lettersdigits, letters, lowercase,
uppercase, digits, hexdigits, octdigits
min
character_sequences
28
current
length
salt
sequence
Note
DEPRECATED - Use property character_classes.
Sequence of characters to build the random string from.
Updates cause replacement.
Optional property.
Allowed values: lettersdigits, letters, lowercase, uppercase, digits, hexdigits, octdigits
Attributes
value
The random string generated by this resource. This value is also available by referencing the resource.
29
current
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Heat::RandomString
properties:
character_classes: [{"class": String, "min": Integer}, {"class": String,
"min": Integer}, ...]
character_sequences: [{"min": Integer, "sequence": String}, {"min":
Integer, "sequence": String}, ...]
length: Integer
salt: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Heat::RandomString
Properties:
character_classes: [{"class": String, "min": Integer}, {"class": String,
"min": Integer}, ...]
character_sequences: [{"min": Integer, "sequence": String}, {"min":
Integer, "sequence": String}, ...]
length: Integer
salt: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Heat::RandomString",
"Properties": {
"character_classes": [{"class": String, "min": Integer}, {"class":
String, "min": Integer}, ...],
"character_sequences": [{"min": Integer, "sequence": String}, {"min":
Integer, "sequence": String}, ...],
"length": Integer,
"salt": String
}
}
}
}
OS::Heat::ResourceGroup
A resource that creates one or more identically configured nested resources.
30
current
In addition to the refs attribute, this resource implements synthetic attributes that mirror
those of the resources in the group. When getting an attribute from this resource, however, a list of attribute values for each resource in the group is returned. To get attribute values for a single resource in the group, synthetic attributes of the form resource.{resource
index}.{attribute name} can be used. The resource ID of a particular resource in the group
can be obtained via the synthetic attribute resource.{resource index}.
While each resource in the group will be identically configured, this resource does allow for
some index-based customization of the properties of the resources in the group. For example:
resources:
my_indexed_group:
type: OS::Heat::ResourceGroup
properties:
count: 3
resource_def:
type: OS::Nova::Server
properties:
# create a unique name for each server
# using its index in the group
name: my_server_%index%
image: CentOS 6.5
flavor: 4GB Performance
would result in a group of three servers having the same image and flavor, but names of
my_server_0, my_server_1, and my_server_2. The variable used for substitution can be customized by using the index_var property.
Available since 2014.1 (Icehouse).
Properties
count
index_var
A variable that this resource will use to replace with the current index of a given resource in the group. Can be used, for example, to
customize the name property of grouped servers in order to differentiate them when listed with nova client.
Updates cause replacement.
Optional property, defaults to "%index%".
The length must be at least 3.
removal_policies
current
Policy to be processed when doing an update which requires removal of specific resources.
Updates cause replacement.
Optional property.
Map properties:
resource_list
resource_def
type
32
current
Attributes
attributes
refs
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Heat::ResourceGroup
properties:
count: Integer
index_var: String
removal_policies: [{"resource_list": [Value, Value, ...]},
{"resource_list": [Value, Value, ...]}, ...]
resource_def: {"type": String, "properties": {...}}
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Heat::ResourceGroup
Properties:
count: Integer
index_var: String
removal_policies: [{"resource_list": [Value, Value, ...]},
{"resource_list": [Value, Value, ...]}, ...]
resource_def: {"type": String, "properties": {...}}
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Heat::ResourceGroup",
"Properties": {
"count": Integer,
"index_var": String,
"removal_policies": [{"resource_list": [Value, Value, ...]},
{"resource_list": [Value, Value, ...]}, ...],
"resource_def": {"type": String, "properties": {...}}
}
}
}
}
33
current
OS::Heat::ScalingPolicy
A resource to manage scaling of OS::Heat::AutoScalingGroup.
while it may incidentally support AWS::AutoScaling::AutoScalingGroup for now, please
don't use it for that purpose and use AWS::AutoScaling::ScalingPolicy instead.
Properties
adjustment_type
auto_scaling_group_id
cooldown
scaling_adjustment
Size of adjustment.
Can be updated without replacement.
Required property.
Attributes
alarm_url
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Heat::ScalingPolicy
properties:
adjustment_type: String
auto_scaling_group_id: String
cooldown: Number
scaling_adjustment: Number
34
current
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Heat::ScalingPolicy
Properties:
adjustment_type: String
auto_scaling_group_id: String
cooldown: Number
scaling_adjustment: Number
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Heat::ScalingPolicy",
"Properties": {
"adjustment_type": String,
"auto_scaling_group_id": String,
"cooldown": Number,
"scaling_adjustment": Number
}
}
}
}
OS::Heat::SoftwareComponent
A resource for describing and storing a software component.
This resource is similar to OS::Heat::SoftwareConfig. In contrast to SoftwareConfig which
allows for storing only one configuration (e.g. one script), SoftwareComponent allows for
storing multiple configurations to address handling of all lifecycle hooks (CREATE, UPDATE,
SUSPEND, RESUME, DELETE) for a software component in one place.
This resource is backed by the persistence layer and the API of the SoftwareConfig resource, and only adds handling for the additional 'configs' property and attribute.
Available since 2014.2 (Juno).
Properties
configs
The list of configurations for the different lifecycle actions of the represented
software component.
Updates cause replacement.
Required property.
35
current
config
tool
inputs
current
Map properties:
default
description
name
type
options
outputs
Schema representing the outputs that this software config will produce.
Updates cause replacement.
Optional property.
List contents:
*
37
current
name
type
Attributes
config
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Heat::SoftwareComponent
properties:
configs: [{"tool": String, "config": String, "actions": [String, String,
...]}, {"tool": String, "config": String, "actions": [String, String, ...]},
...]
inputs: [{"default": String, "type": String, "name": String,
"description": String}, {"default": String, "type": String, "name": String,
"description": String}, ...]
options: {...}
outputs: [{"type": String, "name": String, "error_output": Boolean,
"description": String}, {"type": String, "name": String, "error_output":
Boolean, "description": String}, ...]
38
current
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Heat::SoftwareComponent
Properties:
configs: [{"tool": String, "config": String, "actions": [String, String,
...]}, {"tool": String, "config": String, "actions": [String, String, ...]},
...]
inputs: [{"default": String, "type": String, "name": String,
"description": String}, {"default": String, "type": String, "name": String,
"description": String}, ...]
options: {...}
outputs: [{"type": String, "name": String, "error_output": Boolean,
"description": String}, {"type": String, "name": String, "error_output":
Boolean, "description": String}, ...]
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Heat::SoftwareComponent",
"Properties": {
"configs": [{"tool": String, "config": String, "actions": [String,
String, ...]}, {"tool": String, "config": String, "actions": [String, String,
...]}, ...],
"inputs": [{"default": String, "type": String, "name": String,
"description": String}, {"default": String, "type": String, "name": String,
"description": String}, ...],
"options": {...},
"outputs": [{"type": String, "name": String, "error_output": Boolean,
"description": String}, {"type": String, "name": String, "error_output":
Boolean, "description": String}, ...]
}
}
}
}
OS::Heat::SoftwareConfig
A resource for describing and storing software configuration.
The software_configs API which backs this resource creates immutable configs, so any
change to the template resource definition will result in a new config being created, and
the old one being deleted.
Configs can be defined in the same template which uses them, or they can be created in
one stack, and passed to another stack via a parameter.
39
current
A config resource can be referenced in other resource properties which are config-aware.
This includes the properties OS::Nova::Server user_data, OS::Heat::SoftwareDeployment
config and OS::Heat::MultipartMime parts config.
Along with the config script itself, this resource can define schemas for inputs and outputs
which the config script is expected to consume and produce. Inputs and outputs are optional and will map to concepts which are specific to the configuration tool being used.
Available since 2014.1 (Icehouse).
Properties
config
group
inputs
description
name
40
current
Required property.
type
options
outputs
Schema representing the outputs that this software config will produce.
Updates cause replacement.
Optional property.
List contents:
*
error_output
name
type
current
Attributes
config
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Heat::SoftwareConfig
properties:
config: String
group: String
inputs: [{"default": String, "type": String, "name": String,
"description": String}, {"default": String, "type": String, "name": String,
"description": String}, ...]
options: {...}
outputs: [{"type": String, "name": String, "error_output": Boolean,
"description": String}, {"type": String, "name": String, "error_output":
Boolean, "description": String}, ...]
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Heat::SoftwareConfig
Properties:
config: String
group: String
inputs: [{"default": String, "type": String, "name": String,
"description": String}, {"default": String, "type": String, "name": String,
"description": String}, ...]
options: {...}
outputs: [{"type": String, "name": String, "error_output": Boolean,
"description": String}, {"type": String, "name": String, "error_output":
Boolean, "description": String}, ...]
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Heat::SoftwareConfig",
42
current
"Properties": {
"config": String,
"group": String,
"inputs": [{"default": String, "type": String, "name": String,
"description": String}, {"default": String, "type": String, "name": String,
"description": String}, ...],
"options": {...},
"outputs": [{"type": String, "name": String, "error_output": Boolean,
"description": String}, {"type": String, "name": String, "error_output":
Boolean, "description": String}, ...]
}
}
}
}
OS::Heat::SoftwareDeployment
This resource associates a server with some configuration which is to be deployed to that
server.
A deployment allows input values to be specified which map to the inputs schema defined
in the config resource. These input values are interpreted by the configuration tool in a
tool-specific manner.
Whenever this resource goes to an IN_PROGRESS state, it creates an ephemeral config that
includes the inputs values plus a number of extra inputs which have names prefixed with
deploy_. The extra inputs relate to the current state of the stack, along with the information and credentials required to signal back the deployment results.
Unless signal_transport=NO_SIGNAL, this resource will remain in an IN_PROGRESS state
until the server signals it with the output values for that deployment. Those output values
are then available as resource attributes, along with the default attributes deploy_stdout,
deploy_stderr and deploy_status_code.
Specifying actions other than the default CREATE and UPDATE will result in the deployment
being triggered in those actions. For example this would allow cleanup configuration to be
performed during actions SUSPEND and DELETE. A config could be designed to only work
with some specific actions, or a config can read the value of the deploy_action input to allow conditional logic to perform different configuration for different actions.
Available since 2014.1 (Icehouse).
Properties
actions
config
current
name
server
signal_transport
How the server should signal to heat with the deployment output values. CFN_SIGNAL will allow an HTTP POST to a CFN keypair signed URL. HEAT_SIGNAL will allow calls to the Heat API resource-signal using the provided keystone credentials. NO_SIGNAL
will result in the resource going to the COMPLETE state without
waiting for any signal.
Updates cause replacement.
Optional property, defaults to "CFN_SIGNAL".
Allowed values: CFN_SIGNAL, HEAT_SIGNAL, NO_SIGNAL
Attributes
deploy_status_code
deploy_stderr
deploy_stdout
44
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Heat::SoftwareDeployment
properties:
actions: [Value, Value, ...]
config: String
input_values: {...}
name: String
server: String
signal_transport: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Heat::SoftwareDeployment
Properties:
actions: [Value, Value, ...]
config: String
input_values: {...}
name: String
server: String
signal_transport: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Heat::SoftwareDeployment",
"Properties": {
"actions": [Value, Value, ...],
"config": String,
"input_values": {...},
"name": String,
"server": String,
"signal_transport": String
}
}
}
}
OS::Heat::SoftwareDeployments
Available since 2014.2 (Juno).
45
current
current
Properties
actions
config
input_values
name
servers
signal_transport
How the server should signal to heat with the deployment output values. CFN_SIGNAL will allow an HTTP POST to a CFN keypair signed URL. HEAT_SIGNAL will allow calls to the Heat API resource-signal using the provided keystone credentials. NO_SIGNAL
will result in the resource going to the COMPLETE state without
waiting for any signal.
Updates cause replacement.
Optional property, defaults to "CFN_SIGNAL".
Allowed values: CFN_SIGNAL, HEAT_SIGNAL, NO_SIGNAL
Attributes
deploy_status_codes
A map of Nova names and returned status code from the configuration execution
46
current
deploy_stderrs
A map of Nova names and captured stderrs from the configuration execution to each server.
deploy_stdouts
A map of Nova names and captured stdouts from the configuration execution to each server.
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Heat::SoftwareDeployments
properties:
actions: [Value, Value, ...]
config: String
input_values: {...}
name: String
servers: {...}
signal_transport: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Heat::SoftwareDeployments
Properties:
actions: [Value, Value, ...]
config: String
input_values: {...}
name: String
servers: {...}
signal_transport: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Heat::SoftwareDeployments",
"Properties": {
"actions": [Value, Value, ...],
"config": String,
"input_values": {...},
"name": String,
"servers": {...},
"signal_transport": String
}
}
}
}
47
current
OS::Heat::StructuredConfig
This resource is like OS::Heat::SoftwareConfig except that the config property is represented by a Map rather than a String.
This is useful for configuration tools which use YAML or JSON as their configuration syntax.
The resulting configuration is transferred, stored and returned by the software_configs API
as parsed JSON.
Available since 2014.1 (Icehouse).
Properties
config
group
inputs
description
name
48
current
options
outputs
Schema representing the outputs that this software config will produce.
Updates cause replacement.
Optional property.
List contents:
*
error_output
name
type
Type 49
of the value of the output.
current
Attributes
config
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Heat::StructuredConfig
properties:
config: {...}
group: String
inputs: [{"default": String, "type": String, "name": String,
"description": String}, {"default": String, "type": String, "name": String,
"description": String}, ...]
options: {...}
outputs: [{"type": String, "name": String, "error_output": Boolean,
"description": String}, {"type": String, "name": String, "error_output":
Boolean, "description": String}, ...]
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Heat::StructuredConfig
Properties:
config: {...}
group: String
inputs: [{"default": String, "type": String, "name": String,
"description": String}, {"default": String, "type": String, "name": String,
"description": String}, ...]
options: {...}
outputs: [{"type": String, "name": String, "error_output": Boolean,
"description": String}, {"type": String, "name": String, "error_output":
Boolean, "description": String}, ...]
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
50
current
"Type": "OS::Heat::StructuredConfig",
"Properties": {
"config": {...},
"group": String,
"inputs": [{"default": String, "type": String, "name": String,
"description": String}, {"default": String, "type": String, "name": String,
"description": String}, ...],
"options": {...},
"outputs": [{"type": String, "name": String, "error_output": Boolean,
"description": String}, {"type": String, "name": String, "error_output":
Boolean, "description": String}, ...]
}
}
}
}
OS::Heat::StructuredDeployment
A deployment resource like OS::Heat::SoftwareDeployment, but which performs input value substitution on the config defined by a OS::Heat::StructuredConfig resource.
Some configuration tools have no concept of inputs, so the input value substitution needs
to occur in the deployment resource. An example of this is the JSON metadata consumed
by the cfn-init tool.
Where the config contains {get_input: input_name} this will be substituted with the value
of input_name in this resource's input_values. If get_input needs to be passed through to
the substituted configuration then a different input_key property value can be specified.
Available since 2014.1 (Icehouse).
Properties
actions
config
input_key
input_values
current
server
signal_transport
How the server should signal to heat with the deployment output values. CFN_SIGNAL will allow an HTTP POST to a CFN keypair signed URL. HEAT_SIGNAL will allow calls to the Heat API resource-signal using the provided keystone credentials. NO_SIGNAL
will result in the resource going to the COMPLETE state without
waiting for any signal.
Updates cause replacement.
Optional property, defaults to "CFN_SIGNAL".
Allowed values: CFN_SIGNAL, HEAT_SIGNAL, NO_SIGNAL
Attributes
deploy_status_code
deploy_stderr
deploy_stdout
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Heat::StructuredDeployment
properties:
actions: [Value, Value, ...]
config: String
input_key: String
input_values: {...}
name: String
server: String
signal_transport: String
52
current
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Heat::StructuredDeployment
Properties:
actions: [Value, Value, ...]
config: String
input_key: String
input_values: {...}
name: String
server: String
signal_transport: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Heat::StructuredDeployment",
"Properties": {
"actions": [Value, Value, ...],
"config": String,
"input_key": String,
"input_values": {...},
"name": String,
"server": String,
"signal_transport": String
}
}
}
}
OS::Heat::StructuredDeployments
Available since 2014.2 (Juno).
Properties
actions
config
53
current
Optional property.
input_key
input_values
name
servers
signal_transport
How the server should signal to heat with the deployment output values. CFN_SIGNAL will allow an HTTP POST to a CFN keypair signed URL. HEAT_SIGNAL will allow calls to the Heat API resource-signal using the provided keystone credentials. NO_SIGNAL
will result in the resource going to the COMPLETE state without
waiting for any signal.
Updates cause replacement.
Optional property, defaults to "CFN_SIGNAL".
Allowed values: CFN_SIGNAL, HEAT_SIGNAL, NO_SIGNAL
Attributes
deploy_status_codes
A map of Nova names and returned status code from the configuration execution
deploy_stderrs
A map of Nova names and captured stderrs from the configuration execution to each server.
deploy_stdouts
A map of Nova names and captured stdouts from the configuration execution to each server.
54
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Heat::StructuredDeployments
properties:
actions: [Value, Value, ...]
config: String
input_key: String
input_values: {...}
name: String
servers: {...}
signal_transport: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Heat::StructuredDeployments
Properties:
actions: [Value, Value, ...]
config: String
input_key: String
input_values: {...}
name: String
servers: {...}
signal_transport: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Heat::StructuredDeployments",
"Properties": {
"actions": [Value, Value, ...],
"config": String,
"input_key": String,
"input_values": {...},
"name": String,
"servers": {...},
"signal_transport": String
}
}
}
}
OS::Heat::SwiftSignal
Available since 2014.2 (Juno).
55
current
current
Properties
count
The number of success signals that must be received before the stack creation
process continues.
Updates cause replacement.
Optional property, defaults to "1".
The value must be in the range 1 to 1000.
handle
URL of TempURL where resource will signal completion and optionally upload
data.
Updates cause replacement.
Required property.
timeout
The maximum number of seconds to wait for the resource to signal completion.
Once the timeout is reached, creation of the signal resource will fail.
Updates cause replacement.
Required property.
The value must be in the range 1 to 43200.
Attributes
data
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Heat::SwiftSignal
properties:
count: Number
handle: String
timeout: Number
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Heat::SwiftSignal
Properties:
count: Number
handle: String
timeout: Number
56
current
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Heat::SwiftSignal",
"Properties": {
"count": Number,
"handle": String,
"timeout": Number
}
}
}
}
OS::Heat::SwiftSignalHandle
Available since 2014.2 (Juno).
Attributes
curl_cli
Convenience attribute, provides curl CLI command prefix, which can be used
for signalling handle completion or failure. You can signal success by adding
--data-binary '{"status": "SUCCESS"}' , or signal failure by adding --data-binary
'{"status": "FAILURE"}'
endpoint
token
Tokens are not needed for Swift TempURLs. This attribute is being kept for
compatibility with the OS::Heat::WaitConditionHandle resource
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Heat::SwiftSignalHandle
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Heat::SwiftSignalHandle
57
current
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Heat::SwiftSignalHandle"
}
}
}
OS::Heat::UpdateWaitConditionHandle
This works identically to a regular WaitConditionHandle, except that on update it clears all
signals received and changes the handle. Using this handle means that you must setup the
signal senders to send their signals again any time the update handle changes. This allows
us to roll out new configurations and be confident that they are rolled out once UPDATE
COMPLETE is reached.
Available since 2014.1 (Icehouse).
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Heat::UpdateWaitConditionHandle
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Heat::UpdateWaitConditionHandle
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Heat::UpdateWaitConditionHandle"
}
}
}
58
current
OS::Heat::WaitCondition
Properties
count
The number of success signals that must be received before the stack creation
process continues.
Can be updated without replacement.
Optional property, defaults to "1".
The value must be at least 1.
handle
A reference to the wait condition handle used to signal this wait condition.
Updates cause replacement.
Required property.
timeout
The number of seconds to wait for the correct number of signals to arrive.
Updates cause replacement.
Required property.
The value must be in the range 1 to 43200.
Attributes
data
JSON serialized dict containing data associated with wait condition signals sent to
the handle.
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Heat::WaitCondition
properties:
count: Number
handle: String
timeout: Number
59
current
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Heat::WaitCondition
Properties:
count: Number
handle: String
timeout: Number
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Heat::WaitCondition",
"Properties": {
"count": Number,
"handle": String,
"timeout": Number
}
}
}
}
OS::Heat::WaitConditionHandle
Attributes
curl_cli
Convenience attribute, provides curl CLI command prefix, which can be used
for signalling handle completion or failure. You can signal success by adding
--data-binary '{"status": "SUCCESS"}' , or signal failure by adding --data-binary
'{"status": "FAILURE"}'
endpoint
token
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Heat::WaitConditionHandle
60
current
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Heat::WaitConditionHandle
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Heat::WaitConditionHandle"
}
}
}
OS::Neutron::Firewall
A resource for the Firewall resource in Neutron FWaaS.
Properties
admin_state_up
description
firewall_policy_id
name
current
Attributes
admin_state_up
description
firewall_policy_id
name
show
All attributes.
status
tenant_id
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::Firewall
properties:
admin_state_up: Boolean
description: String
firewall_policy_id: String
name: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Neutron::Firewall
Properties:
admin_state_up: Boolean
description: String
firewall_policy_id: String
name: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::Firewall",
"Properties": {
"admin_state_up": Boolean,
"description": String,
"firewall_policy_id": String,
62
current
"name": String
}
}
}
}
OS::Neutron::FirewallPolicy
A resource for the FirewallPolicy resource in Neutron FWaaS.
Properties
audited
Whether this policy should be audited. When set to True, each time
the firewall policy or the associated firewall rules are changed, this
attribute will be set to False and will have to be explicitly set to True
through an update operation.
Can be updated without replacement.
Optional property, defaults to "False".
description
firewall_rules
name
shared
Attributes
audited
description
firewall_rules
name
63
shared
tenant_id
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::FirewallPolicy
properties:
audited: Boolean
description: String
firewall_rules: [Value, Value, ...]
name: String
shared: Boolean
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Neutron::FirewallPolicy
Properties:
audited: Boolean
description: String
firewall_rules: [Value, Value, ...]
name: String
shared: Boolean
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::FirewallPolicy",
"Properties": {
"audited": Boolean,
"description": String,
"firewall_rules": [Value, Value, ...],
"name": String,
"shared": Boolean
}
}
}
}
OS::Neutron::FirewallRule
A resource for the FirewallRule resource in Neutron FWaaS.
64
current
current
Properties
action
description
destination_ip_address
destination_port
enabled
ip_version
name
protocol
current
source_ip_address
source_port
Attributes
action
description
destination_ip_address
destination_port
enabled
firewall_policy_id
Unique identifier of the firewall policy to which this firewall rule belongs.
ip_version
name
position
protocol
shared
source_ip_address
source_port
tenant_id
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
66
type: OS::Neutron::FirewallRule
properties:
action: String
description: String
destination_ip_address: String
destination_port: String
enabled: Boolean
ip_version: String
name: String
protocol: String
shared: Boolean
source_ip_address: String
source_port: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Neutron::FirewallRule
Properties:
action: String
description: String
destination_ip_address: String
destination_port: String
enabled: Boolean
ip_version: String
name: String
protocol: String
shared: Boolean
source_ip_address: String
source_port: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::FirewallRule",
"Properties": {
"action": String,
"description": String,
"destination_ip_address": String,
"destination_port": String,
"enabled": Boolean,
"ip_version": String,
"name": String,
"protocol": String,
"shared": Boolean,
"source_ip_address": String,
"source_port": String
}
}
}
}
67
current
current
OS::Neutron::FloatingIP
Properties
fixed_ip_address
floating_network
port_id
value_specs
Extra parameters to include in the "floatingip" object in the creation request. Parameters are often specific to installed hardware or extensions.
Updates cause replacement.
Optional property, defaults to "{}".
floating_network_id
Note
DEPRECATED - Use property floating_network.
Updates cause replacement.
Optional property.
Attributes
fixed_ip_address
floating_ip_address
floating_network_id
port_id
router_id
show
All attributes.
68
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::FloatingIP
properties:
fixed_ip_address: String
floating_network: String
port_id: String
value_specs: {...}
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Neutron::FloatingIP
Properties:
fixed_ip_address: String
floating_network: String
port_id: String
value_specs: {...}
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::FloatingIP",
"Properties": {
"fixed_ip_address": String,
"floating_network": String,
"port_id": String,
"value_specs": {...}
}
}
}
}
OS::Neutron::FloatingIPAssociation
Properties
fixed_ip_address
current
current
Optional property.
floatingip_id
port_id
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::FloatingIPAssociation
properties:
fixed_ip_address: String
floatingip_id: String
port_id: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Neutron::FloatingIPAssociation
Properties:
fixed_ip_address: String
floatingip_id: String
port_id: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::FloatingIPAssociation",
"Properties": {
"fixed_ip_address": String,
"floatingip_id": String,
"port_id": String
}
}
}
}
70
current
OS::Neutron::HealthMonitor
A resource for managing health monitors for load balancers in Neutron.
Properties
admin_state_up
delay
expected_codes
The list of HTTP status codes expected in response from the member
to declare it healthy.
Can be updated without replacement.
Optional property.
http_method
The HTTP method used for requests by the monitor of type HTTP.
Can be updated without replacement.
Optional property.
max_retries
Number of permissible connection failures before changing the member status to INACTIVE.
Can be updated without replacement.
Required property.
timeout
type
current
The HTTP path used in the HTTP request used by the monitor to test a
member health.
Can be updated without replacement.
Optional property.
Attributes
admin_state_up
delay
expected_codes
The list of HTTP status codes expected in response from the member
to declare it healthy.
http_method
The HTTP method used for requests by the monitor of type HTTP.
max_retries
Number of permissible connection failures before changing the member status to INACTIVE.
show
All attributes.
tenant_id
timeout
type
url_path
The HTTP path used in the HTTP request used by the monitor to test a
member health.
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::HealthMonitor
properties:
admin_state_up: Boolean
delay: Integer
expected_codes: String
http_method: String
max_retries: Integer
timeout: Integer
type: String
url_path: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
72
...
Resources:
...
TheResource:
Type: OS::Neutron::HealthMonitor
Properties:
admin_state_up: Boolean
delay: Integer
expected_codes: String
http_method: String
max_retries: Integer
timeout: Integer
type: String
url_path: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::HealthMonitor",
"Properties": {
"admin_state_up": Boolean,
"delay": Integer,
"expected_codes": String,
"http_method": String,
"max_retries": Integer,
"timeout": Integer,
"type": String,
"url_path": String
}
}
}
}
OS::Neutron::IKEPolicy
A resource for IKE policy in Neutron.
Properties
auth_algorithm
description
current
current
ike_version
lifetime
value
name
pfs
phase1_negotiation_mode
74
Negotiation
mode for the ike policy.
current
Attributes
auth_algorithm
description
encryption_algorithm
ike_version
lifetime
name
pfs
phase1_negotiation_mode
tenant_id
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::IKEPolicy
properties:
auth_algorithm: String
description: String
encryption_algorithm: String
ike_version: String
lifetime: {"units": String, "value": Integer}
name: String
pfs: String
phase1_negotiation_mode: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Neutron::IKEPolicy
75
Properties:
auth_algorithm: String
description: String
encryption_algorithm: String
ike_version: String
lifetime: {"units": String, "value": Integer}
name: String
pfs: String
phase1_negotiation_mode: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::IKEPolicy",
"Properties": {
"auth_algorithm": String,
"description": String,
"encryption_algorithm": String,
"ike_version": String,
"lifetime": {"units": String, "value": Integer},
"name": String,
"pfs": String,
"phase1_negotiation_mode": String
}
}
}
}
OS::Neutron::IPsecPolicy
A resource for IPsec policy in Neutron.
Properties
auth_algorithm
description
encapsulation_mode
current
current
lifetime
value
name
pfs
transform_protocol
77
current
Attributes
auth_algorithm
description
encapsulation_mode
encryption_algorithm
lifetime
name
pfs
tenant_id
transform_protocol
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::IPsecPolicy
properties:
auth_algorithm: String
description: String
encapsulation_mode: String
encryption_algorithm: String
lifetime: {"units": String, "value": Integer}
name: String
pfs: String
transform_protocol: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Neutron::IPsecPolicy
Properties:
auth_algorithm: String
description: String
encapsulation_mode: String
encryption_algorithm: String
lifetime: {"units": String, "value": Integer}
name: String
pfs: String
78
current
transform_protocol: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::IPsecPolicy",
"Properties": {
"auth_algorithm": String,
"description": String,
"encapsulation_mode": String,
"encryption_algorithm": String,
"lifetime": {"units": String, "value": Integer},
"name": String,
"pfs": String,
"transform_protocol": String
}
}
}
}
OS::Neutron::IPsecSiteConnection
A resource for IPsec site connection in Neutron.
Properties
admin_state_up
description
dpd
Dead Peer Detection protocol configuration for the ipsec site connection.
Updates cause replacement.
Optional property.
Map properties:
actions
current
timeout
ikepolicy_id
Unique identifier for the ike policy associated with the ipsec site connection.
Updates cause replacement.
Required property.
initiator
ipsecpolicy_id
Unique identifier for the ipsec policy associated with the ipsec site
connection.
Updates cause replacement.
Required property.
mtu
Maximum transmission unit size (in bytes) for the ipsec site connection.
Updates cause replacement.
Optional property, defaults to "1500".
name
peer_address
80
current
Required property.
peer_cidrs
peer_id
psk
vpnservice_id
Unique identifier for the vpn service associated with the ipsec site connection.
Updates cause replacement.
Required property.
Attributes
admin_state_up
auth_mode
description
dpd
The dead peer detection protocol configuration of the ipsec site connection.
ikepolicy_id
The unique identifier of ike policy associated with the ipsec site connection.
initiator
ipsecpolicy_id
The unique identifier of ipsec policy associated with the ipsec site connection.
mtu
The maximum transmission unit size (in bytes) of the ipsec site connection.
name
peer_address
81
current
peer_cidrs
peer_id
psk
route_mode
status
tenant_id
The unique identifier of the tenant owning the ipsec site connection.
vpnservice_id
The unique identifier of vpn service associated with the ipsec site connection.
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::IPsecSiteConnection
properties:
admin_state_up: Boolean
description: String
dpd: {"interval": Integer, "timeout": Integer, "actions": String}
ikepolicy_id: String
initiator: String
ipsecpolicy_id: String
mtu: Integer
name: String
peer_address: String
peer_cidrs: [Value, Value, ...]
peer_id: String
psk: String
vpnservice_id: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Neutron::IPsecSiteConnection
Properties:
admin_state_up: Boolean
description: String
dpd: {"interval": Integer, "timeout": Integer, "actions": String}
ikepolicy_id: String
initiator: String
ipsecpolicy_id: String
mtu: Integer
name: String
peer_address: String
82
current
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::IPsecSiteConnection",
"Properties": {
"admin_state_up": Boolean,
"description": String,
"dpd": {"interval": Integer, "timeout": Integer, "actions": String},
"ikepolicy_id": String,
"initiator": String,
"ipsecpolicy_id": String,
"mtu": Integer,
"name": String,
"peer_address": String,
"peer_cidrs": [Value, Value, ...],
"peer_id": String,
"psk": String,
"vpnservice_id": String
}
}
}
}
OS::Neutron::LoadBalancer
A resource to link a neutron pool with servers.
Properties
members
pool_id
protocol_port
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::LoadBalancer
properties:
members: [Value, Value, ...]
pool_id: String
protocol_port: Integer
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Neutron::LoadBalancer
Properties:
members: [Value, Value, ...]
pool_id: String
protocol_port: Integer
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::LoadBalancer",
"Properties": {
"members": [Value, Value, ...],
"pool_id": String,
"protocol_port": Integer
}
}
}
}
OS::Neutron::MeteringLabel
A resource for creating neutron metering label.
Available since 2014.1 (Icehouse).
Properties
description
current
Attributes
description
name
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::MeteringLabel
properties:
description: String
name: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Neutron::MeteringLabel
Properties:
description: String
name: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::MeteringLabel",
"Properties": {
"description": String,
"name": String
}
}
}
}
OS::Neutron::MeteringRule
A resource to create rule for some label.
Available since 2014.1 (Icehouse).
85
current
current
Properties
direction
excluded
metering_label_id
remote_ip_prefix
Attributes
direction
excluded
metering_label_id
remote_ip_prefix
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::MeteringRule
properties:
direction: String
excluded: Boolean
metering_label_id: String
remote_ip_prefix: String
86
current
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Neutron::MeteringRule
Properties:
direction: String
excluded: Boolean
metering_label_id: String
remote_ip_prefix: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::MeteringRule",
"Properties": {
"direction": String,
"excluded": Boolean,
"metering_label_id": String,
"remote_ip_prefix": String
}
}
}
}
OS::Neutron::Net
Properties
admin_state_up
dhcp_agent_ids
The IDs of the DHCP agent to schedule the network. Note that the
default policy setting in Neutron restricts usage of this property to administrative users only.
Can be updated without replacement.
Optional property.
name
A string specifying a symbolic name for the network, which is not required to be unique.
Can be updated without replacement.
87
current
Optional property.
shared
Whether this network should be shared across all tenants. Note that
the default policy setting restricts usage of this attribute to administrative users only.
Can be updated without replacement.
Optional property, defaults to "False".
tenant_id
The ID of the tenant which will own the network. Only administrative
users can set the tenant identifier; this cannot be changed using authorization policies.
Updates cause replacement.
Optional property.
value_specs
Extra parameters to include in the "network" object in the creation request. Parameters are often specific to installed hardware or extensions.
Can be updated without replacement.
Optional property, defaults to "{}".
Attributes
admin_state_up
name
show
All attributes.
status
subnets
tenant_id
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::Net
properties:
admin_state_up: Boolean
dhcp_agent_ids: [Value, Value, ...]
name: String
shared: Boolean
tenant_id: String
value_specs: {...}
88
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Neutron::Net
Properties:
admin_state_up: Boolean
dhcp_agent_ids: [Value, Value, ...]
name: String
shared: Boolean
tenant_id: String
value_specs: {...}
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::Net",
"Properties": {
"admin_state_up": Boolean,
"dhcp_agent_ids": [Value, Value, ...],
"name": String,
"shared": Boolean,
"tenant_id": String,
"value_specs": {...}
}
}
}
}
OS::Neutron::NetworkGateway
A resource for the Network Gateway resource in Neutron Network Gateway.
Available since 2014.1 (Icehouse).
Properties
connections
current
current
Map properties:
network
segmentation_id
segmentation_type
Note
network_id
current
name
Attributes
default
show
All attributes.
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::NetworkGateway
properties:
connections: [{"network_id": String, "segmentation_id": Integer,
"segmentation_type": String, "network": String}, {"network_id": String,
"segmentation_id": Integer, "segmentation_type": String, "network": String},
...]
devices: [{"interface_name": String, "id": String}, {"interface_name":
String, "id": String}, ...]
name: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Neutron::NetworkGateway
Properties:
connections: [{"network_id": String, "segmentation_id": Integer,
"segmentation_type": String, "network": String}, {"network_id": String,
"segmentation_id": Integer, "segmentation_type": String, "network": String},
...]
devices: [{"interface_name": String, "id": String}, {"interface_name":
String, "id": String}, ...]
name: String
91
current
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::NetworkGateway",
"Properties": {
"connections": [{"network_id": String, "segmentation_id": Integer,
"segmentation_type": String, "network": String}, {"network_id": String,
"segmentation_id": Integer, "segmentation_type": String, "network": String},
...],
"devices": [{"interface_name": String, "id": String},
{"interface_name": String, "id": String}, ...],
"name": String
}
}
}
}
OS::Neutron::Pool
A resource for managing load balancer pools in Neutron.
Properties
admin_state_up
description
lb_method
monitors
name
current
subnet
The subnet for the port on which the members of the pool will be
connected.
Updates cause replacement.
Optional property.
vip
admin_state_up
connection_limit
description
name
93
current
Optional property.
protocol_port
TCP port on which to listen for client traffic that is associated with the vip address.
Updates cause replacement.
Required property.
session_persistence
type
subnet
subnet_id
Note
DEPRECATED - Use property subnet.
Updates cause replacement.
Optional property.
94
current
Attributes
admin_state_up
description
lb_method
name
protocol
Protocol to balance.
subnet_id
The subnet for the port on which the members of the pool will be
connected.
tenant_id
vip
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::Pool
properties:
admin_state_up: Boolean
description: String
lb_method: String
monitors: [Value, Value, ...]
name: String
protocol: String
subnet: String
vip: {"session_persistence": {"cookie_name": String, "type": String},
"subnet": String, "name": String, "address": String, "protocol_port":
Integer, "connection_limit": Integer, "admin_state_up": Boolean,
"description": String}
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Neutron::Pool
Properties:
admin_state_up: Boolean
description: String
lb_method: String
monitors: [Value, Value, ...]
name: String
95
current
protocol: String
subnet: String
vip: {"session_persistence": {"cookie_name": String, "type": String},
"subnet": String, "name": String, "address": String, "protocol_port":
Integer, "connection_limit": Integer, "admin_state_up": Boolean,
"description": String}
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::Pool",
"Properties": {
"admin_state_up": Boolean,
"description": String,
"lb_method": String,
"monitors": [Value, Value, ...],
"name": String,
"protocol": String,
"subnet": String,
"vip": {"session_persistence": {"cookie_name": String,
"type": String}, "subnet": String, "name": String, "address": String,
"protocol_port": Integer, "connection_limit": Integer, "admin_state_up":
Boolean, "description": String}
}
}
}
}
OS::Neutron::PoolMember
A resource to handle load balancer members.
Available since 2014.1 (Icehouse).
Properties
address
admin_state_up
pool_id
current
Required property.
protocol_port
TCP port on which the pool member listens for requests or connections.
Updates cause replacement.
Required property.
The value must be in the range 0 to 65535.
weight
Attributes
address
admin_state_up
pool_id
protocol_port
TCP port on which the pool member listens for requests or connections.
show
All attributes.
tenant_id
weight
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::PoolMember
properties:
address: String
admin_state_up: Boolean
pool_id: String
protocol_port: Integer
weight: Integer
97
current
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Neutron::PoolMember
Properties:
address: String
admin_state_up: Boolean
pool_id: String
protocol_port: Integer
weight: Integer
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::PoolMember",
"Properties": {
"address": String,
"admin_state_up": Boolean,
"pool_id": String,
"protocol_port": Integer,
"weight": Integer
}
}
}
}
OS::Neutron::Port
Properties
admin_state_up
allowed_address_pairs
98
current
Map properties:
ip_address
mac_address
device_id
device_owner
Name of the network owning the port. The value is typically network:floatingip or network:router_interface or
network:dhcp
Can be updated without replacement.
Optional property.
fixed_ips
subnet
99
current
Optional property.
Note
subnet_id
name
network
replacement_policy
Policy on how to respond to a stack-update for this resource. REPLACE_ALWAYS will replace the port regardless
of any property changes. AUTO will update the existing port
for any changed update-allowed property.
Can be updated without replacement.
Optional property, defaults to "REPLACE_ALWAYS".
Allowed values: REPLACE_ALWAYS, AUTO
security_groups
value_specs
current
Note
network_id
Attributes
admin_state_up
allowed_address_pairs
device_id
device_owner
fixed_ips
Fixed IP addresses.
mac_address
name
network_id
security_groups
show
All attributes.
status
subnets
tenant_id
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::Port
properties:
admin_state_up: Boolean
allowed_address_pairs: [{"ip_address": String, "mac_address": String},
{"ip_address": String, "mac_address": String}, ...]
device_id: String
device_owner: String
fixed_ips: [{"subnet_id": String, "subnet": String, "ip_address":
String}, {"subnet_id": String, "subnet": String, "ip_address": String}, ...]
mac_address: String
name: String
network: String
replacement_policy: String
101
current
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Neutron::Port
Properties:
admin_state_up: Boolean
allowed_address_pairs: [{"ip_address": String, "mac_address": String},
{"ip_address": String, "mac_address": String}, ...]
device_id: String
device_owner: String
fixed_ips: [{"subnet_id": String, "subnet": String, "ip_address":
String}, {"subnet_id": String, "subnet": String, "ip_address": String}, ...]
mac_address: String
name: String
network: String
replacement_policy: String
security_groups: [Value, Value, ...]
value_specs: {...}
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::Port",
"Properties": {
"admin_state_up": Boolean,
"allowed_address_pairs": [{"ip_address": String, "mac_address":
String}, {"ip_address": String, "mac_address": String}, ...],
"device_id": String,
"device_owner": String,
"fixed_ips": [{"subnet_id": String, "subnet": String, "ip_address":
String}, {"subnet_id": String, "subnet": String, "ip_address": String}, ...],
"mac_address": String,
"name": String,
"network": String,
"replacement_policy": String,
"security_groups": [Value, Value, ...],
"value_specs": {...}
}
}
}
}
OS::Neutron::ProviderNet
Available since 2014.1 (Icehouse).
102
current
Properties
admin_state_up
name
network_type
physical_network
segmentation_id
shared
Attributes
show
All attributes.
status
subnets
103
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::ProviderNet
properties:
admin_state_up: Boolean
name: String
network_type: String
physical_network: String
segmentation_id: String
shared: Boolean
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Neutron::ProviderNet
Properties:
admin_state_up: Boolean
name: String
network_type: String
physical_network: String
segmentation_id: String
shared: Boolean
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::ProviderNet",
"Properties": {
"admin_state_up": Boolean,
"name": String,
"network_type": String,
"physical_network": String,
"segmentation_id": String,
"shared": Boolean
}
}
}
}
OS::Neutron::Router
Properties
admin_state_up
current
current
Enables Source NAT on the router gateway. NOTE: The default policy setting in
Neutron restricts usage of this property to
administrative users only.
Can be updated without replacement.
Optional property.
network
l3_agent_id
ID of the L3 agent. NOTE: The default policy setting in Neutron restricts usage of this property to administrative users
only.
Can be updated without replacement.
Optional property.
name
value_specs
Attributes
admin_state_up
external_gateway_info
name
show
All attributes.
status
tenant_id
current
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::Router
properties:
admin_state_up: Boolean
external_gateway_info: {"enable_snat": Boolean, "network": String}
l3_agent_id: String
name: String
value_specs: {...}
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Neutron::Router
Properties:
admin_state_up: Boolean
external_gateway_info: {"enable_snat": Boolean, "network": String}
l3_agent_id: String
name: String
value_specs: {...}
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::Router",
"Properties": {
"admin_state_up": Boolean,
"external_gateway_info": {"enable_snat": Boolean, "network": String},
"l3_agent_id": String,
"name": String,
"value_specs": {...}
}
}
}
}
106
current
OS::Neutron::RouterGateway
Note
DEPRECATED - RouterGateway resource is deprecated and should not be used.
Instead use the `external_gateway_info` property in the router resource to set
up the gateway.
Properties
network
router_id
ID of the router.
Updates cause replacement.
Required property.
network_id
Note
DEPRECATED - Use property network.
Updates cause replacement.
Optional property.
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::RouterGateway
properties:
network: String
router_id: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Neutron::RouterGateway
Properties:
network: String
router_id: String
107
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::RouterGateway",
"Properties": {
"network": String,
"router_id": String
}
}
}
}
OS::Neutron::RouterInterface
Properties
port_id
router_id
subnet
subnet_id
Note
DEPRECATED - Use property subnet.
Updates cause replacement.
Optional property.
108
current
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::RouterInterface
properties:
port_id: String
router_id: String
subnet: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Neutron::RouterInterface
Properties:
port_id: String
router_id: String
subnet: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::RouterInterface",
"Properties": {
"port_id": String,
"router_id": String,
"subnet": String
}
}
}
}
OS::Neutron::SecurityGroup
Available since 2014.1 (Icehouse).
Properties
description
current
current
A string specifying a symbolic name for the security group, which is not required to be unique.
Can be updated without replacement.
Optional property.
rules
ethertype
port_range_max
port_range_min
110
current
remote_group_id
remote_ip_prefix
remote_mode
111
current
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::SecurityGroup
properties:
description: String
name: String
rules: [{"remote_group_id": String, "direction": String,
"remote_ip_prefix": String, "port_range_min": Integer, "remote_mode":
String, "ethertype": String, "port_range_max": Integer, "protocol": String},
{"remote_group_id": String, "direction": String, "remote_ip_prefix": String,
"port_range_min": Integer, "remote_mode": String, "ethertype": String,
"port_range_max": Integer, "protocol": String}, ...]
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Neutron::SecurityGroup
Properties:
description: String
name: String
rules: [{"remote_group_id": String, "direction": String,
"remote_ip_prefix": String, "port_range_min": Integer, "remote_mode":
String, "ethertype": String, "port_range_max": Integer, "protocol": String},
{"remote_group_id": String, "direction": String, "remote_ip_prefix": String,
"port_range_min": Integer, "remote_mode": String, "ethertype": String,
"port_range_max": Integer, "protocol": String}, ...]
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::SecurityGroup",
"Properties": {
"description": String,
"name": String,
"rules": [{"remote_group_id": String, "direction": String,
"remote_ip_prefix": String, "port_range_min": Integer, "remote_mode":
String, "ethertype": String, "port_range_max": Integer, "protocol": String},
{"remote_group_id": String, "direction": String, "remote_ip_prefix": String,
"port_range_min": Integer, "remote_mode": String, "ethertype": String,
"port_range_max": Integer, "protocol": String}, ...]
}
}
}
}
112
OS::Neutron::Subnet
Properties
allocation_pools
start
cidr
The CIDR.
Updates cause replacement.
Required property.
dns_nameservers
enable_dhcp
gateway_ip
host_routes
current
current
List contents:
*
nexthop
ip_version
name
network
tenant_id
value_specs
network_id
Note
DEPRECATED - Use property network.
Updates cause replacement.
114
current
Optional property.
Attributes
allocation_pools
cidr
dns_nameservers
enable_dhcp
gateway_ip
host_routes
ip_version
name
network_id
show
All attributes.
tenant_id
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::Subnet
properties:
allocation_pools: [{"start": String, "end": String}, {"start": String,
"end": String}, ...]
cidr: String
dns_nameservers: [Value, Value, ...]
enable_dhcp: Boolean
gateway_ip: String
host_routes: [{"nexthop": String, "destination": String}, {"nexthop":
String, "destination": String}, ...]
ip_version: Integer
name: String
network: String
tenant_id: String
value_specs: {...}
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
115
current
Resources:
...
TheResource:
Type: OS::Neutron::Subnet
Properties:
allocation_pools: [{"start": String, "end": String}, {"start": String,
"end": String}, ...]
cidr: String
dns_nameservers: [Value, Value, ...]
enable_dhcp: Boolean
gateway_ip: String
host_routes: [{"nexthop": String, "destination": String}, {"nexthop":
String, "destination": String}, ...]
ip_version: Integer
name: String
network: String
tenant_id: String
value_specs: {...}
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::Subnet",
"Properties": {
"allocation_pools": [{"start": String, "end": String}, {"start":
String, "end": String}, ...],
"cidr": String,
"dns_nameservers": [Value, Value, ...],
"enable_dhcp": Boolean,
"gateway_ip": String,
"host_routes": [{"nexthop": String, "destination": String},
{"nexthop": String, "destination": String}, ...],
"ip_version": Integer,
"name": String,
"network": String,
"tenant_id": String,
"value_specs": {...}
}
}
}
}
OS::Neutron::VPNService
A resource for VPN service in Neutron.
Properties
admin_state_up
current
name
router_id
Unique identifier for the router to which the vpn service will be inserted.
Updates cause replacement.
Required property.
subnet
subnet_id
Note
DEPRECATED - Use property subnet.
Updates cause replacement.
Optional property.
Attributes
admin_state_up
description
name
router_id
The unique identifier of the router to which the vpn service was inserted.
show
All attributes.
status
subnet_id
The unique identifier of the subnet in which the vpn service was created.
tenant_id
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Neutron::VPNService
properties:
admin_state_up: Boolean
description: String
name: String
router_id: String
subnet: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Neutron::VPNService
Properties:
admin_state_up: Boolean
description: String
name: String
router_id: String
subnet: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Neutron::VPNService",
"Properties": {
"admin_state_up": Boolean,
"description": String,
"name": String,
"router_id": String,
"subnet": String
}
}
}
}
OS::Nova::FloatingIP
Available since 2014.1 (Icehouse).
Properties
pool
current
Attributes
ip
pool
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Nova::FloatingIP
properties:
pool: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Nova::FloatingIP
Properties:
pool: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Nova::FloatingIP",
"Properties": {
"pool": String
}
}
}
}
OS::Nova::FloatingIPAssociation
Available since 2014.1 (Icehouse).
Properties
floating_ip
119
current
current
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Nova::FloatingIPAssociation
properties:
floating_ip: String
server_id: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Nova::FloatingIPAssociation
Properties:
floating_ip: String
server_id: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Nova::FloatingIPAssociation",
"Properties": {
"floating_ip": String,
"server_id": String
}
}
}
}
OS::Nova::KeyPair
A resource for creating Nova key pairs.
that if a new key is generated setting save_private_key to True results in the system saving
the private key which can then be retrieved via the private_key attribute of this resource.
120
current
Setting the public_key property means that the private_key attribute of this resource will always return an empty string regardless of the save_private_key setting since there will be
no private key data to save.
Available since 2014.1 (Icehouse).
Properties
name
public_key
The optional public key. This allows users to supply the public key
from a pre-existing key pair. If not supplied, a new key pair will be
generated.
Updates cause replacement.
Optional property.
save_private_key
Attributes
private_key
public_key
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Nova::KeyPair
properties:
name: String
public_key: String
save_private_key: Boolean
121
current
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Nova::KeyPair
Properties:
name: String
public_key: String
save_private_key: Boolean
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Nova::KeyPair",
"Properties": {
"name": String,
"public_key": String,
"save_private_key": Boolean
}
}
}
}
OS::Nova::Server
Properties
admin_pass
availability_zone
block_device_mapping
current
Optional property.
Map properties:
delete_on_termination
device_name
A device name
where the volume
will be attached in
the system at /dev/
device_name. This
value is typically vda.
Updates cause replacement.
Required property.
snapshot_id
volume_id
volume_size
123
current
Updates cause replacement.
Optional property.
config_drive
diskConfig
flavor
flavor_update_policy
Policy on how to apply a flavor update; either by requesting a server resize or by replacing the entire server.
Can be updated without replacement.
Optional property, defaults to "RESIZE".
Allowed values: RESIZE, REPLACE
image
image_update_policy
Policy on how to apply an image-id update; either by requesting a server rebuild or by replacing the entire server
Can be updated without replacement.
Optional property, defaults to "REPLACE".
Allowed values: REBUILD, REPLACE,
REBUILD_PRESERVE_EPHEMERAL
key_name
124
current
name
Server name.
Can be updated without replacement.
Optional property.
networks
network
port
125
current
Updates cause replacement.
Optional property.
Note
uuid
reservation_id
scheduler_hints
security_groups
software_config_transport
126
current
user_data_format
Note
admin_user
DEPRECATED
Name of the administrative user to use on the server.
This property will be removed from Juno in favor of
the default cloud-init user set up for each image (e.g.
"ubuntu" for Ubuntu 12.04+, "fedora" for Fedora 19+
and "cloud-user" for CentOS/RHEL 6.5).
Updates cause replacement.
Optional property.
Attributes
accessIPv4
accessIPv6
addresses
first_address
Note
DEPRECATED - Use the networks attribute instead of
first_address. For example: "{get_attr: [<server name>, networks, <network name>, 0]}"
127
current
name
networks
show
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Nova::Server
properties:
admin_pass: String
availability_zone: String
block_device_mapping: [{"volume_size": Integer, "volume_id": String,
"snapshot_id": String, "delete_on_termination": Boolean, "device_name":
String}, {"volume_size": Integer, "volume_id": String, "snapshot_id": String,
"delete_on_termination": Boolean, "device_name": String}, ...]
config_drive: Boolean
diskConfig: String
flavor: String
flavor_update_policy: String
image: String
image_update_policy: String
key_name: String
metadata: {...}
name: String
networks: [{"port": String, "fixed_ip": String, "uuid": String,
"network": String}, {"port": String, "fixed_ip": String, "uuid": String,
"network": String}, ...]
personality: {...}
reservation_id: String
scheduler_hints: {...}
security_groups: [Value, Value, ...]
software_config_transport: String
user_data: String
user_data_format: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Nova::Server
Properties:
128
current
admin_pass: String
availability_zone: String
block_device_mapping: [{"volume_size": Integer, "volume_id": String,
"snapshot_id": String, "delete_on_termination": Boolean, "device_name":
String}, {"volume_size": Integer, "volume_id": String, "snapshot_id": String,
"delete_on_termination": Boolean, "device_name": String}, ...]
config_drive: Boolean
diskConfig: String
flavor: String
flavor_update_policy: String
image: String
image_update_policy: String
key_name: String
metadata: {...}
name: String
networks: [{"port": String, "fixed_ip": String, "uuid": String,
"network": String}, {"port": String, "fixed_ip": String, "uuid": String,
"network": String}, ...]
personality: {...}
reservation_id: String
scheduler_hints: {...}
security_groups: [Value, Value, ...]
software_config_transport: String
user_data: String
user_data_format: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Nova::Server",
"Properties": {
"admin_pass": String,
"availability_zone": String,
"block_device_mapping": [{"volume_size": Integer, "volume_id": String,
"snapshot_id": String, "delete_on_termination": Boolean, "device_name":
String}, {"volume_size": Integer, "volume_id": String, "snapshot_id": String,
"delete_on_termination": Boolean, "device_name": String}, ...],
"config_drive": Boolean,
"diskConfig": String,
"flavor": String,
"flavor_update_policy": String,
"image": String,
"image_update_policy": String,
"key_name": String,
"metadata": {...},
"name": String,
"networks": [{"port": String, "fixed_ip": String, "uuid": String,
"network": String}, {"port": String, "fixed_ip": String, "uuid": String,
"network": String}, ...],
"personality": {...},
"reservation_id": String,
"scheduler_hints": {...},
"security_groups": [Value, Value, ...],
"software_config_transport": String,
"user_data": String,
"user_data_format": String
129
}
}
}
}
OS::Nova::ServerGroup
A resource for managing a Nova server group.
Available since 2014.2 (Juno).
Properties
name
policies
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Nova::ServerGroup
properties:
name: String
policies: [String, String, ...]
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Nova::ServerGroup
Properties:
name: String
policies: [String, String, ...]
130
current
current
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Nova::ServerGroup",
"Properties": {
"name": String,
"policies": [String, String, ...]
}
}
}
}
OS::Sahara::Cluster
Properties
cluster_template_id
hadoop_version
image
key_name
name
Plugin name.
Updates cause replacement.
Required property.
Attributes
info
Cluster information.
status
Cluster status.
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Sahara::Cluster
properties:
cluster_template_id: String
hadoop_version: String
image: String
key_name: String
name: String
neutron_management_network: String
plugin_name: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Sahara::Cluster
Properties:
cluster_template_id: String
hadoop_version: String
image: String
key_name: String
name: String
neutron_management_network: String
plugin_name: String
132
current
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Sahara::Cluster",
"Properties": {
"cluster_template_id": String,
"hadoop_version": String,
"image": String,
"key_name": String,
"name": String,
"neutron_management_network": String,
"plugin_name": String
}
}
}
}
OS::Sahara::ClusterTemplate
Available since 2014.2 (Juno).
Properties
anti_affinity
cluster_configs
default_image_id
description
current
current
name
Node groups.
Updates cause replacement.
Optional property.
List contents:
*
134
current
Name of the Node
group.
Updates cause replacement.
Required property.
node_group_template_id
ID of the Node
Group Template.
Updates cause replacement.
Required property.
plugin_name
Plugin name.
Updates cause replacement.
Required property.
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Sahara::ClusterTemplate
properties:
anti_affinity: [String, String, ...]
cluster_configs: {...}
default_image_id: String
description: String
hadoop_version: String
name: String
neutron_management_network: String
node_groups: [{"count": Integer, "name": String,
"node_group_template_id": String}, {"count": Integer, "name": String,
"node_group_template_id": String}, ...]
plugin_name: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Sahara::ClusterTemplate
Properties:
anti_affinity: [String, String, ...]
cluster_configs: {...}
default_image_id: String
description: String
135
hadoop_version: String
name: String
neutron_management_network: String
node_groups: [{"count": Integer, "name": String,
"node_group_template_id": String}, {"count": Integer, "name": String,
"node_group_template_id": String}, ...]
plugin_name: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Sahara::ClusterTemplate",
"Properties": {
"anti_affinity": [String, String, ...],
"cluster_configs": {...},
"default_image_id": String,
"description": String,
"hadoop_version": String,
"name": String,
"neutron_management_network": String,
"node_groups": [{"count": Integer, "name": String,
"node_group_template_id": String}, {"count": Integer, "name": String,
"node_group_template_id": String}, ...],
"plugin_name": String
}
}
}
}
OS::Sahara::NodeGroupTemplate
Available since 2014.2 (Juno).
Properties
description
flavor
floating_ip_pool
current
current
name
node_configs
node_processes
plugin_name
Plugin name.
Updates cause replacement.
Required property.
volumes_per_node
volumes_size
137
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Sahara::NodeGroupTemplate
properties:
description: String
flavor: String
floating_ip_pool: String
hadoop_version: String
name: String
node_configs: {...}
node_processes: [String, String, ...]
plugin_name: String
volumes_per_node: Integer
volumes_size: Integer
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Sahara::NodeGroupTemplate
Properties:
description: String
flavor: String
floating_ip_pool: String
hadoop_version: String
name: String
node_configs: {...}
node_processes: [String, String, ...]
plugin_name: String
volumes_per_node: Integer
volumes_size: Integer
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Sahara::NodeGroupTemplate",
"Properties": {
"description": String,
"flavor": String,
"floating_ip_pool": String,
"hadoop_version": String,
138
current
current
"name": String,
"node_configs": {...},
"node_processes": [String, String, ...],
"plugin_name": String,
"volumes_per_node": Integer,
"volumes_size": Integer
}
}
}
}
OS::Swift::Container
Properties
X-Account-Meta
X-Container-Meta
X-Container-Read
Specify the ACL permissions on who can read objects in the container.
Updates cause replacement.
Optional property.
X-Container-Write
Specify the ACL permissions on who can write objects to the container.
Updates cause replacement.
Optional property.
name
Attributes
BytesUsed
139
DomainName
HeadContainer
ObjectCount
RootURL
WebsiteURL
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Swift::Container
properties:
X-Account-Meta: {...}
X-Container-Meta: {...}
X-Container-Read: String
X-Container-Write: String
name: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Swift::Container
Properties:
X-Account-Meta: {...}
X-Container-Meta: {...}
X-Container-Read: String
X-Container-Write: String
name: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Swift::Container",
"Properties": {
"X-Account-Meta": {...},
"X-Container-Meta": {...},
"X-Container-Read": String,
"X-Container-Write": String,
"name": String
}
}
}
140
current
current
OS::Trove::Instance
OpenStack cloud database instance resource.
Available since 2014.1 (Icehouse).
Properties
availability_zone
databases
collate
name
141
current
datastore_version
Name of the registered datastore version. It must exist for provided datastore type. Defaults to using single active version. If several active versions exist for provided datastore type, explicit value
for this parameter must be specified.
Updates cause replacement.
Optional property.
The length must be no greater than 255.
flavor
name
networks
network
current
restore_point
size
users
143
current
name
password
Attributes
hostname
href
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: OS::Trove::Instance
properties:
availability_zone: String
databases: [{"character_set": String, "name": String, "collate":
String}, {"character_set": String, "name": String, "collate": String}, ...]
datastore_type: String
datastore_version: String
flavor: String
name: String
networks: [{"fixed_ip": String, "network": String, "port": String},
{"fixed_ip": String, "network": String, "port": String}, ...]
restore_point: String
size: Integer
144
current
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: OS::Trove::Instance
Properties:
availability_zone: String
databases: [{"character_set": String, "name": String, "collate":
String}, {"character_set": String, "name": String, "collate": String}, ...]
datastore_type: String
datastore_version: String
flavor: String
name: String
networks: [{"fixed_ip": String, "network": String, "port": String},
{"fixed_ip": String, "network": String, "port": String}, ...]
restore_point: String
size: Integer
users: [{"host": String, "password": String, "name": String,
"databases": [String, String, ...]}, {"host": String, "password": String,
"name": String, "databases": [String, String, ...]}, ...]
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "OS::Trove::Instance",
"Properties": {
"availability_zone": String,
"databases": [{"character_set": String, "name": String, "collate":
String}, {"character_set": String, "name": String, "collate": String}, ...],
"datastore_type": String,
"datastore_version": String,
"flavor": String,
"name": String,
"networks": [{"fixed_ip": String, "network": String, "port": String},
{"fixed_ip": String, "network": String, "port": String}, ...],
"restore_point": String,
"size": Integer,
"users": [{"host": String, "password": String, "name": String,
"databases": [String, String, ...]}, {"host": String, "password": String,
"name": String, "databases": [String, String, ...]}, ...]
}
}
}
}
145
current
AWS::AutoScaling::AutoScalingGroup
Available since 2014.1 (Icehouse).
Properties
AvailabilityZones
Not Implemented.
Updates cause replacement.
Required property.
Cooldown
DesiredCapacity
146
146
149
154
155
157
158
159
161
162
164
171
172
174
175
178
180
181
182
183
185
187
190
191
193
195
Note
HealthCheckGracePeriod
Not implemented.
Note
HealthCheckType
Not implemented.
LaunchConfigurationName
LoadBalancerNames
MaxSize
MinSize
Tags
Value
147
current
current
Attributes
InstanceList
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::AutoScaling::AutoScalingGroup
properties:
AvailabilityZones: [Value, Value, ...]
Cooldown: Number
DesiredCapacity: Integer
LaunchConfigurationName: String
LoadBalancerNames: [Value, Value, ...]
MaxSize: Integer
MinSize: Integer
Tags: [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
VPCZoneIdentifier: [String, String, ...]
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::AutoScaling::AutoScalingGroup
Properties:
AvailabilityZones: [Value, Value, ...]
Cooldown: Number
DesiredCapacity: Integer
LaunchConfigurationName: String
LoadBalancerNames: [Value, Value, ...]
MaxSize: Integer
148
current
MinSize: Integer
Tags: [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
VPCZoneIdentifier: [String, String, ...]
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::AutoScaling::AutoScalingGroup",
"Properties": {
"AvailabilityZones": [Value, Value, ...],
"Cooldown": Number,
"DesiredCapacity": Integer,
"LaunchConfigurationName": String,
"LoadBalancerNames": [Value, Value, ...],
"MaxSize": Integer,
"MinSize": Integer,
"Tags": [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...],
"VPCZoneIdentifier": [String, String, ...]
}
}
}
}
AWS::AutoScaling::LaunchConfiguration
Properties
BlockDeviceMappings
Ebs
149
current
Indicate
whether
the volume
should be
deleted
when the instance is terminated.
Updates
cause replacement.
Optional
property,
defaults to
"True".
Note
Iops
Not
implemented.
SnapshotId
The ID of the
snapshot to
create a volume from.
Updates
cause replacement.
Optional
property.
VolumeSize
150
The size of
the volume,
in GB. Must
be equal or
greater than
the size of
the snapshot. It is
current
safe to leave
this blank
and have the
Compute service infer the
size.
Updates
cause replacement.
Optional
property.
VolumeType
Note
Not
implemented.
NoDevice
Note
Not implemented.
VirtualName
Note
Not implemented.
ImageId
InstanceType
KernelId
Note
Not implemented.
KeyName
NovaSchedulerHints
Value
RamDiskId
Note
Not implemented.
SecurityGroups
UserData
152
current
current
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::AutoScaling::LaunchConfiguration
properties:
BlockDeviceMappings: [{"DeviceName": String, "Ebs":
{"DeleteOnTermination": Boolean, "VolumeSize": String, "SnapshotId":
String}}, {"DeviceName": String, "Ebs": {"DeleteOnTermination": Boolean,
"VolumeSize": String, "SnapshotId": String}}, ...]
ImageId: String
InstanceType: String
KeyName: String
NovaSchedulerHints: [{"Value": String, "Key": String}, {"Value": String,
"Key": String}, ...]
SecurityGroups: [Value, Value, ...]
UserData: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::AutoScaling::LaunchConfiguration
Properties:
BlockDeviceMappings: [{"DeviceName": String, "Ebs":
{"DeleteOnTermination": Boolean, "VolumeSize": String, "SnapshotId":
String}}, {"DeviceName": String, "Ebs": {"DeleteOnTermination": Boolean,
"VolumeSize": String, "SnapshotId": String}}, ...]
ImageId: String
InstanceType: String
KeyName: String
NovaSchedulerHints: [{"Value": String, "Key": String}, {"Value": String,
"Key": String}, ...]
SecurityGroups: [Value, Value, ...]
UserData: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::AutoScaling::LaunchConfiguration",
"Properties": {
"BlockDeviceMappings": [{"DeviceName": String, "Ebs":
{"DeleteOnTermination": Boolean, "VolumeSize": String, "SnapshotId":
String}}, {"DeviceName": String, "Ebs": {"DeleteOnTermination": Boolean,
"VolumeSize": String, "SnapshotId": String}}, ...],
"ImageId": String,
"InstanceType": String,
"KeyName": String,
153
current
AWS::AutoScaling::ScalingPolicy
Properties
AdjustmentType
AutoScalingGroupName
Cooldown
ScalingAdjustment
Size of adjustment.
Can be updated without replacement.
Required property.
Attributes
AlarmUrl
154
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::AutoScaling::ScalingPolicy
properties:
AdjustmentType: String
AutoScalingGroupName: String
Cooldown: Number
ScalingAdjustment: Number
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::AutoScaling::ScalingPolicy
Properties:
AdjustmentType: String
AutoScalingGroupName: String
Cooldown: Number
ScalingAdjustment: Number
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::AutoScaling::ScalingPolicy",
"Properties": {
"AdjustmentType": String,
"AutoScalingGroupName": String,
"Cooldown": Number,
"ScalingAdjustment": Number
}
}
}
}
AWS::CloudFormation::Stack
A Resource representing a child stack to allow composition of templates.
Properties
Parameters
155
current
current
TimeoutInMinutes
The length of time, in minutes, to wait for the nested stack creation.
Can be updated without replacement.
Optional property.
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::CloudFormation::Stack
properties:
Parameters: {...}
TemplateURL: String
TimeoutInMinutes: Number
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::CloudFormation::Stack
Properties:
Parameters: {...}
TemplateURL: String
TimeoutInMinutes: Number
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::CloudFormation::Stack",
"Properties": {
"Parameters": {...},
"TemplateURL": String,
"TimeoutInMinutes": Number
}
}
}
}
156
current
AWS::CloudFormation::WaitCondition
Available since 2014.2 (Juno).
Properties
Count
The number of success signals that must be received before the stack creation
process continues.
Can be updated without replacement.
Optional property, defaults to "1".
The value must be at least 1.
Handle
A reference to the wait condition handle used to signal this wait condition.
Updates cause replacement.
Required property.
Timeout
The number of seconds to wait for the correct number of signals to arrive.
Updates cause replacement.
Required property.
The value must be in the range 1 to 43200.
Attributes
Data
JSON serialized dict containing data associated with wait condition signals sent to
the handle.
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::CloudFormation::WaitCondition
properties:
Count: Number
Handle: String
Timeout: Number
157
current
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::CloudFormation::WaitCondition
Properties:
Count: Number
Handle: String
Timeout: Number
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::CloudFormation::WaitCondition",
"Properties": {
"Count": Number,
"Handle": String,
"Timeout": Number
}
}
}
}
AWS::CloudFormation::WaitConditionHandle
the main point of this class is to : have no dependencies (so the instance can reference it)
generate a unique url (to be returned in the reference) then the cfn-signal will use this url
to post to and WaitCondition will poll it to see if has been written to.
Available since 2014.2 (Juno).
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::CloudFormation::WaitConditionHandle
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::CloudFormation::WaitConditionHandle
158
current
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::CloudFormation::WaitConditionHandle"
}
}
}
AWS::CloudWatch::Alarm
Properties
AlarmActions
AlarmDescription
ComparisonOperator
Dimensions
EvaluationPeriods
InsufficientDataActions
MetricName
Namespace
OKActions
159
current
Statistic
Threshold
Units
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::CloudWatch::Alarm
properties:
AlarmActions: [Value, Value, ...]
AlarmDescription: String
ComparisonOperator: String
Dimensions: [Value, Value, ...]
EvaluationPeriods: String
InsufficientDataActions: [Value, Value, ...]
MetricName: String
Namespace: String
OKActions: [Value, Value, ...]
Period: String
Statistic: String
Threshold: String
Units: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
160
TheResource:
Type: AWS::CloudWatch::Alarm
Properties:
AlarmActions: [Value, Value, ...]
AlarmDescription: String
ComparisonOperator: String
Dimensions: [Value, Value, ...]
EvaluationPeriods: String
InsufficientDataActions: [Value, Value, ...]
MetricName: String
Namespace: String
OKActions: [Value, Value, ...]
Period: String
Statistic: String
Threshold: String
Units: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::CloudWatch::Alarm",
"Properties": {
"AlarmActions": [Value, Value, ...],
"AlarmDescription": String,
"ComparisonOperator": String,
"Dimensions": [Value, Value, ...],
"EvaluationPeriods": String,
"InsufficientDataActions": [Value, Value, ...],
"MetricName": String,
"Namespace": String,
"OKActions": [Value, Value, ...],
"Period": String,
"Statistic": String,
"Threshold": String,
"Units": String
}
}
}
}
AWS::EC2::EIP
Properties
Domain
InstanceId
current
current
Attributes
AllocationId
ID that AWS assigns to represent the allocation of the address for use
with Amazon VPC. Returned only for VPC elastic IP addresses.
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::EC2::EIP
properties:
Domain: String
InstanceId: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::EC2::EIP
Properties:
Domain: String
InstanceId: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::EC2::EIP",
"Properties": {
"Domain": String,
"InstanceId": String
}
}
}
}
AWS::EC2::EIPAssociation
Properties
AllocationId
162
current
InstanceId
NetworkInterfaceId
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::EC2::EIPAssociation
properties:
AllocationId: String
EIP: String
InstanceId: String
NetworkInterfaceId: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::EC2::EIPAssociation
Properties:
AllocationId: String
EIP: String
InstanceId: String
NetworkInterfaceId: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
163
current
"Type": "AWS::EC2::EIPAssociation",
"Properties": {
"AllocationId": String,
"EIP": String,
"InstanceId": String,
"NetworkInterfaceId": String
}
}
}
}
AWS::EC2::Instance
Properties
AvailabilityZone
BlockDeviceMappings
Ebs
164
Indicate
whether
the vol-
current
ume
should be
deleted
when the
instance is
terminated.
Updates
cause replacement.
Optional
property,
defaults to
"True".
Note
Iops
Not
implemented.
SnapshotId
The ID of
the snapshot to
create a
volume
from.
Updates
cause replacement.
Optional
property.
VolumeSize
165
The size
of the volume, in
GB. Must
be equal
or greater
than the
size of the
snapshot.
It is safe
to leave
current
this blank
and have
the Compute service infer
the size.
Updates
cause replacement.
Optional
property.
VolumeType
Note
Not
implemented.
NoDevice
Note
Not implemented.
VirtualName
Note
Not implemented.
Note
DisableApiTermination
Not implemented.
ImageId
InstanceType
Note
KernelId
166
Not implemented.
Note
Monitoring
Not implemented.
NetworkInterfaces
NovaSchedulerHints
Value
Note
PlacementGroupName
Not implemented.
Note
PrivateIpAddress
Not implemented.
Note
RamDiskId
Not implemented.
SecurityGroupIds
167
current
SecurityGroups
Note
SourceDestCheck
Not implemented.
SubnetId
Tags
Value
Note
Tenancy
Not implemented.
UserData
Volumes
168
current
current
List contents:
*
VolumeId
Attributes
AvailabilityZone
PrivateDnsName
PrivateIp
PublicDnsName
PublicIp
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::EC2::Instance
properties:
AvailabilityZone: String
BlockDeviceMappings: [{"DeviceName": String, "Ebs":
{"DeleteOnTermination": Boolean, "VolumeSize": String, "SnapshotId":
String}}, {"DeviceName": String, "Ebs": {"DeleteOnTermination": Boolean,
"VolumeSize": String, "SnapshotId": String}}, ...]
ImageId: String
InstanceType: String
KeyName: String
NetworkInterfaces: [Value, Value, ...]
NovaSchedulerHints: [{"Value": String, "Key": String}, {"Value": String,
"Key": String}, ...]
169
current
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::EC2::Instance
Properties:
AvailabilityZone: String
BlockDeviceMappings: [{"DeviceName": String, "Ebs":
{"DeleteOnTermination": Boolean, "VolumeSize": String, "SnapshotId":
String}}, {"DeviceName": String, "Ebs": {"DeleteOnTermination": Boolean,
"VolumeSize": String, "SnapshotId": String}}, ...]
ImageId: String
InstanceType: String
KeyName: String
NetworkInterfaces: [Value, Value, ...]
NovaSchedulerHints: [{"Value": String, "Key": String}, {"Value": String,
"Key": String}, ...]
SecurityGroupIds: [Value, Value, ...]
SecurityGroups: [Value, Value, ...]
SubnetId: String
Tags: [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
UserData: String
Volumes: [{"Device": String, "VolumeId": String}, {"Device": String,
"VolumeId": String}, ...]
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::EC2::Instance",
"Properties": {
"AvailabilityZone": String,
"BlockDeviceMappings": [{"DeviceName": String, "Ebs":
{"DeleteOnTermination": Boolean, "VolumeSize": String, "SnapshotId":
String}}, {"DeviceName": String, "Ebs": {"DeleteOnTermination": Boolean,
"VolumeSize": String, "SnapshotId": String}}, ...],
"ImageId": String,
"InstanceType": String,
"KeyName": String,
"NetworkInterfaces": [Value, Value, ...],
"NovaSchedulerHints": [{"Value": String, "Key": String}, {"Value":
String, "Key": String}, ...],
"SecurityGroupIds": [Value, Value, ...],
170
current
AWS::EC2::InternetGateway
Properties
Tags
Note
Not implemented.
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::EC2::InternetGateway
properties:
Tags: [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::EC2::InternetGateway
Properties:
Tags: [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
171
current
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::EC2::InternetGateway",
"Properties": {
"Tags": [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
}
}
}
}
AWS::EC2::NetworkInterface
Properties
Description
GroupSet
PrivateIpAddress
Note
SourceDestCheck
Not implemented.
SubnetId
Tags
Note
Not implemented.
172
current
Attributes
PrivateIpAddress
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::EC2::NetworkInterface
properties:
Description: String
GroupSet: [Value, Value, ...]
PrivateIpAddress: String
SubnetId: String
Tags: [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::EC2::NetworkInterface
Properties:
Description: String
GroupSet: [Value, Value, ...]
PrivateIpAddress: String
SubnetId: String
Tags: [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::EC2::NetworkInterface",
"Properties": {
"Description": String,
"GroupSet": [Value, Value, ...],
"PrivateIpAddress": String,
"SubnetId": String,
"Tags": [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
}
}
}
}
173
AWS::EC2::RouteTable
Available since 2014.1 (Icehouse).
Properties
Tags
Note
Not implemented.
VpcId
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::EC2::RouteTable
properties:
Tags: [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
VpcId: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::EC2::RouteTable
Properties:
Tags: [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
VpcId: String
174
current
current
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::EC2::RouteTable",
"Properties": {
"Tags": [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...],
"VpcId": String
}
}
}
}
AWS::EC2::SecurityGroup
Properties
GroupDescription
SecurityGroupEgress
FromPort
IpProtocol
175
current
Updates cause replacement.
Optional property.
SourceSecurityGroupName
SourceSecurityGroupOwnerId
Note
Not implemented.
ToPort
SecurityGroupIngress
FromPort
IpProtocol
SourceSecurityGroupId
176
current
Updates cause replacement.
Optional property.
Note
SourceSecurityGroupOwnerId
Not implemented.
ToPort
VpcId
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::EC2::SecurityGroup
properties:
GroupDescription: String
SecurityGroupEgress: [{"CidrIp": String, "SourceSecurityGroupId":
String, "FromPort": String, "SourceSecurityGroupName": String, "ToPort":
String, "IpProtocol": String}, {"CidrIp": String, "SourceSecurityGroupId":
String, "FromPort": String, "SourceSecurityGroupName": String, "ToPort":
String, "IpProtocol": String}, ...]
SecurityGroupIngress: [{"CidrIp": String, "SourceSecurityGroupId":
String, "FromPort": String, "SourceSecurityGroupName": String, "ToPort":
String, "IpProtocol": String}, {"CidrIp": String, "SourceSecurityGroupId":
String, "FromPort": String, "SourceSecurityGroupName": String, "ToPort":
String, "IpProtocol": String}, ...]
VpcId: String
177
current
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::EC2::SecurityGroup
Properties:
GroupDescription: String
SecurityGroupEgress: [{"CidrIp": String, "SourceSecurityGroupId":
String, "FromPort": String, "SourceSecurityGroupName": String, "ToPort":
String, "IpProtocol": String}, {"CidrIp": String, "SourceSecurityGroupId":
String, "FromPort": String, "SourceSecurityGroupName": String, "ToPort":
String, "IpProtocol": String}, ...]
SecurityGroupIngress: [{"CidrIp": String, "SourceSecurityGroupId":
String, "FromPort": String, "SourceSecurityGroupName": String, "ToPort":
String, "IpProtocol": String}, {"CidrIp": String, "SourceSecurityGroupId":
String, "FromPort": String, "SourceSecurityGroupName": String, "ToPort":
String, "IpProtocol": String}, ...]
VpcId: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::EC2::SecurityGroup",
"Properties": {
"GroupDescription": String,
"SecurityGroupEgress": [{"CidrIp": String, "SourceSecurityGroupId":
String, "FromPort": String, "SourceSecurityGroupName": String, "ToPort":
String, "IpProtocol": String}, {"CidrIp": String, "SourceSecurityGroupId":
String, "FromPort": String, "SourceSecurityGroupName": String, "ToPort":
String, "IpProtocol": String}, ...],
"SecurityGroupIngress": [{"CidrIp": String, "SourceSecurityGroupId":
String, "FromPort": String, "SourceSecurityGroupName": String, "ToPort":
String, "IpProtocol": String}, {"CidrIp": String, "SourceSecurityGroupId":
String, "FromPort": String, "SourceSecurityGroupName": String, "ToPort":
String, "IpProtocol": String}, ...],
"VpcId": String
}
}
}
}
AWS::EC2::Subnet
Properties
AvailabilityZone
178
current
Tags
Note
Not implemented.
VpcId
Ref structure that contains the ID of the VPC on which you want to
create the subnet.
Updates cause replacement.
Required property.
Attributes
AvailabilityZone
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::EC2::Subnet
properties:
AvailabilityZone: String
CidrBlock: String
Tags: [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
VpcId: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::EC2::Subnet
Properties:
AvailabilityZone: String
CidrBlock: String
Tags: [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
VpcId: String
179
current
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::EC2::Subnet",
"Properties": {
"AvailabilityZone": String,
"CidrBlock": String,
"Tags": [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...],
"VpcId": String
}
}
}
}
AWS::EC2::SubnetRouteTableAssociation
Properties
RouteTableId
SubnetId
Subnet ID.
Updates cause replacement.
Required property.
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::EC2::SubnetRouteTableAssociation
properties:
RouteTableId: String
SubnetId: String
180
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::EC2::SubnetRouteTableAssociation
Properties:
RouteTableId: String
SubnetId: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::EC2::SubnetRouteTableAssociation",
"Properties": {
"RouteTableId": String,
"SubnetId": String
}
}
}
}
AWS::EC2::VPC
Properties
CidrBlock
Note
InstanceTenancy
Not implemented.
Tags
Note
Not implemented.
181
current
current
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::EC2::VPC
properties:
CidrBlock: String
Tags: [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::EC2::VPC
Properties:
CidrBlock: String
Tags: [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::EC2::VPC",
"Properties": {
"CidrBlock": String,
"Tags": [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
}
}
}
}
AWS::EC2::VPCGatewayAttachment
Properties
InternetGatewayId
ID of the InternetGateway.
Updates cause replacement.
Optional property.
VpcId
182
current
Required property.
Note
VpnGatewayId
Not implemented.
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::EC2::VPCGatewayAttachment
properties:
InternetGatewayId: String
VpcId: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::EC2::VPCGatewayAttachment
Properties:
InternetGatewayId: String
VpcId: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::EC2::VPCGatewayAttachment",
"Properties": {
"InternetGatewayId": String,
"VpcId": String
}
}
}
}
AWS::EC2::Volume
Properties
AvailabilityZone
183
current
Required property.
Size
SnapshotId
Tags
Value
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::EC2::Volume
properties:
AvailabilityZone: String
Size: Integer
SnapshotId: String
Tags: [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
184
current
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::EC2::Volume
Properties:
AvailabilityZone: String
Size: Integer
SnapshotId: String
Tags: [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::EC2::Volume",
"Properties": {
"AvailabilityZone": String,
"Size": Integer,
"SnapshotId": String,
"Tags": [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
}
}
}
}
AWS::EC2::VolumeAttachment
Properties
Device
The device where the volume is exposed on the instance. This assignment
may not be honored and it is advised that the path /dev/disk/by-id/virtio-<VolumeId> be used instead.
Updates are not supported. Resource update will fail on any attempt to update this property.
Required property.
Value must match pattern: /dev/vd[b-z]
InstanceId
current
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::EC2::VolumeAttachment
properties:
Device: String
InstanceId: String
VolumeId: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::EC2::VolumeAttachment
Properties:
Device: String
InstanceId: String
VolumeId: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::EC2::VolumeAttachment",
"Properties": {
"Device": String,
"InstanceId": String,
"VolumeId": String
}
}
}
}
186
current
AWS::ElasticLoadBalancing::LoadBalancer
Properties
Note
AppCookieStickinessPolicy
Not implemented.
AvailabilityZones
HealthCheck
Interval
Target
Timeout
187
current
The number of consecutive health probe failures required before moving the instance to the unhealthy state
Updates cause replacement.
Required property.
Instances
Note
LBCookieStickinessPolicy
Not implemented.
Listeners
LoadBalancerPort
PolicyNames
Note
Not implemented.
Protocol
188
current
Updates cause replacement.
Required property.
Allowed values: TCP, HTTP
SSLCertificateId
Note
Not implemented.
Note
SecurityGroups
Not implemented.
Note
Subnets
Not implemented.
Attributes
CanonicalHostedZoneName
CanonicalHostedZoneNameID
DNSName
SourceSecurityGroup.GroupName The security group that you can use as part of your inbound rules for your LoadBalancer's back-end instances.
SourceSecurityGroup.OwnerAlias Owner of the source security group.
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::ElasticLoadBalancing::LoadBalancer
properties:
AvailabilityZones: [Value, Value, ...]
HealthCheck: {"HealthyThreshold": Number, "Interval": Number, "Target":
String, "Timeout": Number, "UnhealthyThreshold": Number}
Instances: [Value, Value, ...]
Listeners: [{"InstancePort": Number, "LoadBalancerPort": Number,
"Protocol": String}, {"InstancePort": Number, "LoadBalancerPort": Number,
"Protocol": String}, ...]
189
current
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::ElasticLoadBalancing::LoadBalancer
Properties:
AvailabilityZones: [Value, Value, ...]
HealthCheck: {"HealthyThreshold": Number, "Interval": Number, "Target":
String, "Timeout": Number, "UnhealthyThreshold": Number}
Instances: [Value, Value, ...]
Listeners: [{"InstancePort": Number, "LoadBalancerPort": Number,
"Protocol": String}, {"InstancePort": Number, "LoadBalancerPort": Number,
"Protocol": String}, ...]
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::ElasticLoadBalancing::LoadBalancer",
"Properties": {
"AvailabilityZones": [Value, Value, ...],
"HealthCheck": {"HealthyThreshold": Number, "Interval": Number,
"Target": String, "Timeout": Number, "UnhealthyThreshold": Number},
"Instances": [Value, Value, ...],
"Listeners": [{"InstancePort": Number, "LoadBalancerPort": Number,
"Protocol": String}, {"InstancePort": Number, "LoadBalancerPort": Number,
"Protocol": String}, ...]
}
}
}
}
AWS::IAM::AccessKey
Properties
Serial
Note
Not implemented.
Status
Note
Not implemented.
UserName
The name of the user that the new key will belong to.
Updates cause replacement.
Required property.
190
Attributes
SecretAccessKey
UserName
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::IAM::AccessKey
properties:
UserName: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::IAM::AccessKey
Properties:
UserName: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::IAM::AccessKey",
"Properties": {
"UserName": String
}
}
}
}
AWS::IAM::User
Properties
Groups
Not Implemented.
Updates cause replacement.
Optional property.
LoginProfile
191
current
Optional property.
Map properties:
Password
Path
Not Implemented.
Updates cause replacement.
Optional property.
Policies
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::IAM::User
properties:
Groups: [Value, Value, ...]
LoginProfile: {"Password": String}
Path: String
Policies: [Value, Value, ...]
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::IAM::User
Properties:
Groups: [Value, Value, ...]
LoginProfile: {"Password": String}
Path: String
Policies: [Value, Value, ...]
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::IAM::User",
"Properties": {
192
current
AWS::RDS::DBInstance
Properties
AllocatedStorage
DBInstanceClass
DBName
DBSecurityGroups
Engine
KeyName
MasterUserPassword
MasterUsername
Port
Attributes
Endpoint.Address
???
Endpoint.Port
???
193
current
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::RDS::DBInstance
properties:
AllocatedStorage: String
DBInstanceClass: String
DBName: String
DBSecurityGroups: [Value, Value, ...]
Engine: String
KeyName: String
MasterUserPassword: String
MasterUsername: String
Port: String
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::RDS::DBInstance
Properties:
AllocatedStorage: String
DBInstanceClass: String
DBName: String
DBSecurityGroups: [Value, Value, ...]
Engine: String
KeyName: String
MasterUserPassword: String
MasterUsername: String
Port: String
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::RDS::DBInstance",
"Properties": {
"AllocatedStorage": String,
"DBInstanceClass": String,
"DBName": String,
"DBSecurityGroups": [Value, Value, ...],
"Engine": String,
"KeyName": String,
"MasterUserPassword": String,
"MasterUsername": String,
"Port": String
}
}
}
194
current
current
AWS::S3::Bucket
Properties
AccessControl
Tags
Value
WebsiteConfiguration
195
current
Optional property.
IndexDocument
Attributes
DomainName
WebsiteURL
HOT Syntax
heat_template_version: 2013-05-23
...
resources:
...
the_resource:
type: AWS::S3::Bucket
properties:
AccessControl: String
Tags: [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
WebsiteConfiguration: {"IndexDocument": String, "ErrorDocument": String}
YAML Syntax
HeatTemplateFormatVersion: '2012-12-12'
...
Resources:
...
TheResource:
Type: AWS::S3::Bucket
Properties:
AccessControl: String
Tags: [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...]
WebsiteConfiguration: {"IndexDocument": String, "ErrorDocument": String}
196
current
JSON Syntax
{
"AWSTemplateFormatVersion" : "2010-09-09",
...
"Resources" : {
"TheResource": {
"Type": "AWS::S3::Bucket",
"Properties": {
"AccessControl": String,
"Tags": [{"Value": String, "Key": String}, {"Value": String, "Key":
String}, ...],
"WebsiteConfiguration": {"IndexDocument": String, "ErrorDocument":
String}
}
}
}
}
197
current
198
198
199
199
199
200
200
200
201
201
202
There are a number of functions that you can use to help you write CloudFormation compatible templates. While most CloudFormation functions are supported in HOT version
'2013-05-23', Fn::Select is the only CloudFormation function supported in HOT templates
since version '2014-10-16' which is introduced in Juno.
All of these functions (except Ref) start with Fn::.
Ref
Returns the value of the named parameter or resource.
Parameters
name The name of the resource or parameter.
Usage
{Ref: my_server}
Fn::Base64
This returns the Base64 representation of the input string.
Parameters
value
Usage
{Base64: "convert this string please."}
current
Fn::FindInMap
Returns the value corresponding to keys into a two-level map declared in the Mappings section.
Parameters
map_name
top_level_key
second_level_key
The second-level key name, which is set to one of the keys from the
list assigned to top_level_key.
Usage
Mapping:
MyContacts:
jone: {phone: 337, email: a@b.com}
jim: {phone: 908, email: g@b.com}
{"Fn::FindInMap": ["MyContacts", "jim", "phone" ] }
Returns 908.
Fn::GetAtt
Returns an attribute of a resource within the template.
Parameters
resource
attribute
Usage
{Fn::GetAtt: [my_server, PublicIp]}
Fn::GetAZs
Returns the Availability Zones within the given region.
Note: AZ's and regions are not fully implemented in Heat.
Parameters
region
Usage
{Fn::GetAZs: ""}
Fn::Join
Like python join, it joins a list of strings with the given delimiter.
Parameters
delimiter
list
Usage
{Fn::Join: [",", ["beer", "wine", "more beer"]]}
Fn::Select
Select an item from a list.
Heat extension: Select an item from a map
Parameters
selector
The number of item in the list or the name of the item in the map.
collection
Usage
For a list lookup:
{ "Fn::Select" : [ "2", [ "apples", "grapes", "mangoes" ] ] }
Returns mangoes.
For a map lookup:
{ "Fn::Select" : [ "red", {"red": "a", "flu": "b"} ] }
Returns a.
Fn::Split
This is the reverse of Join. Convert a string into a list based on the delimiter.
200
current
current
Parameters
delimiter
string
Usage
{ "Fn::Split" : [ ",", "str1,str2,str3,str4"]}
Fn::Replace
Find and replace one string with another.
Parameters
substitutions
A map of substitutions.
string: String
Usage
{"Fn::Replace": [
{'$var1': 'foo', '%var2%': 'bar'},
'$var1 is %var2%'
]}
Fn::ResourceFacade
When writing a Template Resource:
Parameters
attribute_name
Usage
{'Fn::ResourceFacade': 'Metadata'}
{'Fn::ResourceFacade': 'DeletionPolicy'}
{'Fn::ResourceFacade': 'UpdatePolicy'}
Example
Here is a top level template top.yaml
201
current
resources:
my_server:
type: OS::Nova::Server
metadata:
key: value
some: more stuff
To use it
$ heat stack-create -f top.yaml -e env.yaml
What happened is the metadata in top.yaml (key: value, some: more stuff) gets passed
into the resource template via the Fn::ResourceFacade function.
Fn::MemberListToMap
Convert an AWS style member list into a map.
Parameters
key name: string
Usage
{'Fn::MemberListToMap': ['Name', 'Value', ['.member.0.Name=key',
'.member.0.Value=door',
'.member.1.Name=colour',
'.member.1.Value=green']]}
202
current
AppendixA.Community support
Table of Contents
Documentation ...........................................................................................................
ask.openstack.org ........................................................................................................
OpenStack mailing lists ................................................................................................
The OpenStack wiki .....................................................................................................
The Launchpad Bugs area ...........................................................................................
The OpenStack IRC channel .........................................................................................
Documentation feedback ............................................................................................
OpenStack distribution packages .................................................................................
203
204
204
205
205
206
206
206
The following resources are available to help you run and use OpenStack. The OpenStack
community constantly improves and adds to the main features of OpenStack, but if you
have any questions, do not hesitate to ask. Use the following resources to get OpenStack
support, and troubleshoot your installations.
Documentation
For the available OpenStack documentation, see docs.openstack.org.
To provide feedback on documentation, join and use the
<openstack-docs@lists.openstack.org> mailing list at OpenStack Documentation
Mailing List, or report a bug.
The following books explain how to install an OpenStack cloud and its associated components:
Installation Guide for Debian 7
Installation Guide for openSUSE 13.1 and SUSE Linux Enterprise Server 11 SP3
Installation Guide for Red Hat Enterprise Linux 7, CentOS 7, and Fedora 20
Installation Guide for Ubuntu 14.04
The following books explain how to configure and run an OpenStack cloud:
Architecture Design Guide
Cloud Administrator Guide
Configuration Reference
Operations Guide
High Availability Guide
Security Guide
203
current
ask.openstack.org
During the set up or testing of OpenStack, you might have questions about how a specific task is completed or be in a situation where a feature does not work correctly. Use
the ask.openstack.org site to ask questions and get answers. When you visit the http://
ask.openstack.org site, scan the recently asked questions to see whether your question has
already been answered. If not, ask a new question. Be sure to give a clear, concise summary
in the title and provide as much detail as possible in the description. Paste in your command
output or stack traces, links to screen shots, and any other information which might be useful.
current
current
Documentation feedback
To provide feedback on documentation, join and use the
<openstack-docs@lists.openstack.org> mailing list at OpenStack Documentation
Mailing List, or report a bug.
206