Unsupported Heat Resource Types¶
These resources are enabled, but are not officially supported.
OS::Designate::Domain¶
Note
DEPRECATED since 8.0.0 (Ocata) - Use OS::Designate::Zone instead.
Note
Available since 5.0.0 (Liberty)
Heat Template Resource for Designate Domain.
Designate provides DNS-as-a-Service services for OpenStack. So, domain is a realm with an identification string, unique in DNS.
Required Properties¶
name¶
Domain name.
String value expected.
Updates cause replacement.
The length must be no greater than 255.
Optional Properties¶
description¶
Description of domain.
String value expected.
Can be updated without replacement.
The length must be no greater than 160.
ttl¶
Time To Live (Seconds).
Integer value expected.
Can be updated without replacement.
The value must be in the range 1 to 2147483647.
HOT Syntax¶
heat_template_version: 2015-04-30
...
resources:
...
the_resource:
type: OS::Designate::Domain
properties:
description: String
email: String
name: String
ttl: Integer
OS::Designate::Record¶
Note
DEPRECATED since 8.0.0 (Ocata) - Use OS::Designate::RecordSet instead.
Note
Available since 5.0.0 (Liberty)
Heat Template Resource for Designate Record.
Designate provides DNS-as-a-Service services for OpenStack. Record is storage unit in DNS. So, DNS name server is a server that stores the DNS records for a domain. Each record has a type and type-specific data.
Required Properties¶
data¶
DNS record data, varies based on the type of record. For more details, please refer rfc 1035.
String value expected.
Can be updated without replacement.
domain¶
DNS Domain id or name.
String value expected.
Updates cause replacement.
Value must be of type designate.domain
name¶
Record name.
String value expected.
Updates cause replacement.
The length must be no greater than 255.
type¶
DNS Record type.
String value expected.
Can be updated without replacement.
Allowed values: A, AAAA, CNAME, MX, SRV, TXT, SPF, NS, PTR, SSHFP, SOA
Optional Properties¶
description¶
Description of record.
String value expected.
Can be updated without replacement.
The length must be no greater than 160.
priority¶
DNS record priority. It is considered only for MX and SRV types, otherwise, it is ignored.
Integer value expected.
Can be updated without replacement.
The value must be in the range 0 to 65536.
ttl¶
Time To Live (Seconds).
Integer value expected.
Can be updated without replacement.
The value must be in the range 1 to 2147483647.
HOT Syntax¶
heat_template_version: 2015-04-30
...
resources:
...
the_resource:
type: OS::Designate::Record
properties:
data: String
description: String
domain: String
name: String
priority: Integer
ttl: Integer
type: String
OS::Glance::Image¶
Note
DEPRECATED since 8.0.0 (Ocata) - Creating a Glance Image based on an existing URL location requires the Glance v1 API, which is deprecated.
Note
Available since 2014.2 (Juno)
A resource managing images in Glance.
A resource provides managing images that are meant to be used with other services.
Required Properties¶
container_format¶
Container format of image.
String value expected.
Updates cause replacement.
Allowed values: ami, ari, aki, bare, ova, ovf
disk_format¶
Disk format of image.
String value expected.
Updates cause replacement.
Allowed values: ami, ari, aki, vhd, vmdk, raw, qcow2, vdi, iso
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”.
String value expected.
Updates cause replacement.
Optional Properties¶
architecture¶
Note
Available since 7.0.0 (Newton)
Operating system architecture.
String value expected.
Can be updated without replacement.
extra_properties¶
Note
Available since 7.0.0 (Newton)
Arbitrary properties to associate with the image.
Map value expected.
Can be updated without replacement.
Defaults to “{}”.
id¶
The image ID. Glance will generate a UUID if not specified.
String value expected.
Updates cause replacement.
is_public¶
Scope of image accessibility. Public or private. Default value is False means private. Note: The policy setting of glance allows only users with admin roles to create public image by default.
Boolean value expected.
Updates cause replacement.
Defaults to “False”.
kernel_id¶
Note
Available since 7.0.0 (Newton)
ID of image stored in Glance that should be used as the kernel when booting an AMI-style image.
String value expected.
Can be updated without replacement.
Value must match pattern: ^([0-9a-fA-F]){8}-([0-9a-fA-F]){4}-([0-9a-fA-F]){4}-([0-9a-fA-F]){4}-([0-9a-fA-F]){12}$
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.
Integer value expected.
Updates cause replacement.
Defaults to “0”.
The value must be at least 0.
min_ram¶
Amount of ram (in MB) required to boot image. Default value is 0 if not specified and means no limit on the ram size.
Integer value expected.
Updates cause replacement.
Defaults to “0”.
The value must be at least 0.
name¶
Name for the image. The name of an image is not unique to a Image Service node.
String value expected.
Updates cause replacement.
os_distro¶
Note
Available since 7.0.0 (Newton)
The common name of the operating system distribution in lowercase.
String value expected.
Can be updated without replacement.
owner¶
Note
Available since 7.0.0 (Newton)
Owner of the image.
String value expected.
Can be updated without replacement.
protected¶
Whether the image can be deleted. If the value is True, the image is protected and cannot be deleted.
Boolean value expected.
Updates cause replacement.
Defaults to “False”.
ramdisk_id¶
Note
Available since 7.0.0 (Newton)
ID of image stored in Glance that should be used as the ramdisk when booting an AMI-style image.
String value expected.
Can be updated without replacement.
Value must match pattern: ^([0-9a-fA-F]){8}-([0-9a-fA-F]){4}-([0-9a-fA-F]){4}-([0-9a-fA-F]){4}-([0-9a-fA-F]){12}$
tags¶
Note
Available since 7.0.0 (Newton)
List of image tags.
List value expected.
Can be updated without replacement.
HOT Syntax¶
heat_template_version: 2015-04-30
...
resources:
...
the_resource:
type: OS::Glance::Image
properties:
architecture: String
container_format: String
disk_format: String
extra_properties: {...}
id: String
is_public: Boolean
kernel_id: String
location: String
min_disk: Integer
min_ram: Integer
name: String
os_distro: String
owner: String
protected: Boolean
ramdisk_id: String
tags: [Value, Value, ...]
OS::Heat::HARestarter¶
Note
DEPRECATED since 2015.1 (Kilo) - The HARestarter resource type is deprecated and will be removed in a future release of Heat, once it has support for auto-healing any type of resource. Note that HARestarter does *not* actually restart servers - it deletes and then recreates them. It also does the same to all dependent resources, and may therefore exhibit unexpected and undesirable behaviour. Instead, use the mark-unhealthy API to mark a resource as needing replacement, and then a stack update to perform the replacement while respecting the dependencies and not deleting them unnecessarily.
Required Properties¶
InstanceId¶
Instance ID to be restarted.
String value expected.
Updates cause replacement.
Value must be of type nova.server
Attributes¶
AlarmUrl¶
A signed url to handle the alarm (Heat extension).
show¶
Detailed information about resource.
HOT Syntax¶
heat_template_version: 2015-04-30
...
resources:
...
the_resource:
type: OS::Heat::HARestarter
properties:
InstanceId: String
OS::Magnum::Bay¶
Note
DEPRECATED since 9.0.0 (Pike) - Please use OS::Magnum::Cluster instead.
Note
Available since 6.0.0 (Mitaka)
A resource that creates a Magnum Bay.
This resource has been deprecated in favor of OS::Magnum::Cluster.
Required Properties¶
baymodel¶
The name or ID of the bay model.
String value expected.
Updates cause replacement.
Value must be of type magnum.baymodel
Optional Properties¶
bay_create_timeout¶
Timeout for creating the bay in minutes. Set to 0 for no timeout.
Integer value expected.
Updates cause replacement.
Defaults to “0”.
The value must be at least 0.
discovery_url¶
Specifies a custom discovery url for node discovery.
String value expected.
Updates cause replacement.
master_count¶
The number of master nodes for this bay.
Integer value expected.
Can be updated without replacement.
Defaults to “1”.
The value must be at least 1.
node_count¶
The node count for this bay.
Integer value expected.
Can be updated without replacement.
Defaults to “1”.
The value must be at least 1.
HOT Syntax¶
heat_template_version: 2015-04-30
...
resources:
...
the_resource:
type: OS::Magnum::Bay
properties:
bay_create_timeout: Integer
baymodel: String
discovery_url: String
master_count: Integer
name: String
node_count: Integer
OS::Magnum::BayModel¶
Note
DEPRECATED since 9.0.0 (Pike) - Please use OS::Magnum::ClusterTemplate instead.
Note
Available since 5.0.0 (Liberty)
A resource for the BayModel in Magnum.
This resource has been deprecated by ClusterTemplate. BayModel is an object that stores template information about the bay which is used to create new bays consistently.
Required Properties¶
coe¶
The Container Orchestration Engine for cluster.
String value expected.
Updates cause replacement.
Allowed values: kubernetes, swarm, mesos
external_network¶
The external neutron network to attach the Cluster.
String value expected.
Updates cause replacement.
Value must be of type neutron.network
image¶
The image name or UUID to use as a base image for cluster.
String value expected.
Updates cause replacement.
Value must be of type glance.image
Optional Properties¶
dns_nameserver¶
The DNS nameserver address.
String value expected.
Updates cause replacement.
Value must be of type ip_addr
docker_storage_driver¶
Select a docker storage driver.
String value expected.
Updates cause replacement.
Defaults to “devicemapper”.
Allowed values: devicemapper, overlay
docker_volume_size¶
The size in GB of the docker volume.
Integer value expected.
Updates cause replacement.
The value must be at least 1.
fixed_network¶
The fixed neutron network to attach the Cluster.
String value expected.
Updates cause replacement.
Value must be of type neutron.network
fixed_subnet¶
The fixed neutron subnet to attach the Cluster.
String value expected.
Updates cause replacement.
Value must be of type neutron.subnet
flavor¶
The nova flavor name or UUID to use when launching the cluster.
String value expected.
Updates cause replacement.
Value must be of type nova.flavor
floating_ip_enabled¶
Indicates whether created clusters should have a floating ip or not.
Boolean value expected.
Updates cause replacement.
Defaults to “True”.
http_proxy¶
The http_proxy address to use for nodes in cluster.
String value expected.
Updates cause replacement.
https_proxy¶
The https_proxy address to use for nodes in cluster.
String value expected.
Updates cause replacement.
keypair¶
The name of the SSH keypair to load into the cluster nodes.
String value expected.
Updates cause replacement.
Value must be of type nova.keypair
labels¶
Arbitrary labels in the form of key=value pairs to associate with cluster.
Map value expected.
Updates cause replacement.
master_flavor¶
The nova flavor name or UUID to use when launching the master node of the cluster.
String value expected.
Updates cause replacement.
Value must be of type nova.flavor
master_lb_enabled¶
Indicates whether created clusters should have a load balancer for master nodes or not.
Boolean value expected.
Updates cause replacement.
Defaults to “True”.
network_driver¶
The name of the driver used for instantiating container networks. By default, Magnum will choose the pre-configured network driver based on COE type.
String value expected.
Updates cause replacement.
no_proxy¶
A comma separated list of addresses for which proxies should not be used in the cluster.
String value expected.
Updates cause replacement.
public¶
Make the cluster template public.
Boolean value expected.
Updates cause replacement.
Defaults to “False”.
registry_enabled¶
Enable the docker registry in the cluster.
Boolean value expected.
Updates cause replacement.
Defaults to “False”.
server_type¶
Specify the server type to be used.
String value expected.
Updates cause replacement.
Defaults to “vm”.
Allowed values: vm, bm
tls_disabled¶
Disable TLS in the cluster.
Boolean value expected.
Updates cause replacement.
Defaults to “False”.
volume_driver¶
The volume driver name for instantiating container volume.
String value expected.
Updates cause replacement.
Allowed values: cinder, rexray
HOT Syntax¶
heat_template_version: 2015-04-30
...
resources:
...
the_resource:
type: OS::Magnum::BayModel
properties:
coe: String
dns_nameserver: String
docker_storage_driver: String
docker_volume_size: Integer
external_network: String
fixed_network: String
fixed_subnet: String
flavor: String
floating_ip_enabled: Boolean
http_proxy: String
https_proxy: String
image: String
keypair: String
labels: {...}
master_flavor: String
master_lb_enabled: Boolean
name: String
network_driver: String
no_proxy: String
public: Boolean
registry_enabled: Boolean
server_type: String
tls_disabled: Boolean
volume_driver: String
OS::Neutron::ExtraRoute¶
Note
UNSUPPORTED - Use this resource at your own risk.
Resource for specifying extra routes for Neutron router.
Resource allows to specify nexthop IP and destination network for router.
Required Properties¶
router_id¶
The router id.
String value expected.
Updates cause replacement.
Value must be of type neutron.router
HOT Syntax¶
heat_template_version: 2015-04-30
...
resources:
...
the_resource:
type: OS::Neutron::ExtraRoute
properties:
destination: String
nexthop: String
router_id: String
OS::Neutron::FlowClassifier¶
Note
UNSUPPORTED since 8.0.0 (Ocata)
“Heat Template Resource for networking-sfc flow-classifier.
This resource used to select the traffic that can access the service chain. Traffic that matches any flow classifier will be directed to the first port in the chain.
Optional Properties¶
description¶
Description for the Flow Classifier.
String value expected.
Can be updated without replacement.
destination_ip_prefix¶
Destination IP prefix or subnet.
String value expected.
Updates cause replacement.
Value must be of type net_cidr
destination_port_range_max¶
Destination protocol port maximum.
Integer value expected.
Updates cause replacement.
The value must be in the range 1 to 65535.
destination_port_range_min¶
Destination protocol port minimum.
Integer value expected.
Updates cause replacement.
The value must be in the range 1 to 65535.
ethertype¶
L2 ethertype.
String value expected.
Updates cause replacement.
Defaults to “IPv4”.
Allowed values: IPv4, IPv6
logical_destination_port¶
ID or name of the neutron destination port.
String value expected.
Updates cause replacement.
Value must be of type neutron.port
logical_source_port¶
ID or name of the neutron source port.
String value expected.
Updates cause replacement.
Value must be of type neutron.port
protocol¶
IP Protocol for the Flow Classifier.
String value expected.
Updates cause replacement.
Allowed values: tcp, udp, icmp
source_ip_prefix¶
Source IP prefix or subnet.
String value expected.
Updates cause replacement.
Value must be of type net_cidr
source_port_range_max¶
Source protocol port Maximum.
Integer value expected.
Updates cause replacement.
The value must be in the range 1 to 65535.
source_port_range_min¶
Source protocol port Minimum.
Integer value expected.
Updates cause replacement.
The value must be in the range 1 to 65535.
l7_parameters¶
Note
UNSUPPORTED - Currently, no value is supported for this option.
Dictionary of L7-parameters.
Map value expected.
Updates cause replacement.
HOT Syntax¶
heat_template_version: 2015-04-30
...
resources:
...
the_resource:
type: OS::Neutron::FlowClassifier
properties:
description: String
destination_ip_prefix: String
destination_port_range_max: Integer
destination_port_range_min: Integer
ethertype: String
logical_destination_port: String
logical_source_port: String
name: String
protocol: String
source_ip_prefix: String
source_port_range_max: Integer
source_port_range_min: Integer
OS::Neutron::PortChain¶
Note
UNSUPPORTED since 8.0.0 (Ocata)
A resource for neutron networking-sfc.
This resource used to define the service function path by arranging networking-sfc port-pair-groups and set of flow classifiers, to specify the classified traffic flows to enter the chain.
Required Properties¶
Optional Properties¶
chain_parameters¶
Dictionary of chain parameters. Currently, only correlation=mpls is supported by default.
Map value expected.
Updates cause replacement.
Defaults to “{‘correlation’: ‘mpls’}”.
description¶
Description for the Port Chain.
String value expected.
Can be updated without replacement.
HOT Syntax¶
heat_template_version: 2015-04-30
...
resources:
...
the_resource:
type: OS::Neutron::PortChain
properties:
chain_parameters: {...}
description: String
flow_classifiers: [String, String, ...]
name: String
port_pair_groups: [String, String, ...]
OS::Neutron::PortPair¶
Note
UNSUPPORTED since 7.0.0 (Newton)
A resource for neutron networking-sfc port-pair.
This plug-in requires networking-sfc>=1.0.0. So to enable this plug-in, install this library and restart the heat-engine.
A Port Pair represents a service function instance. The ingress port and the egress port of the service function may be specified. If a service function has one bidirectional port, the ingress port has the same value as the egress port.
Required Properties¶
egress¶
ID or name of the egress neutron port.
String value expected.
Updates cause replacement.
Value must be of type neutron.port
ingress¶
ID or name of the ingress neutron port.
String value expected.
Updates cause replacement.
Value must be of type neutron.port
Optional Properties¶
description¶
Description for the Port Pair.
String value expected.
Can be updated without replacement.
service_function_parameters¶
Dictionary of service function parameter. Currently only correlation=None is supported.
Map value expected.
Updates cause replacement.
Defaults to “{‘correlation’: None}”.
HOT Syntax¶
heat_template_version: 2015-04-30
...
resources:
...
the_resource:
type: OS::Neutron::PortPair
properties:
description: String
egress: String
ingress: String
name: String
service_function_parameters: {...}
OS::Neutron::PortPairGroup¶
Note
UNSUPPORTED since 8.0.0 (Ocata)
Heat Template Resource for networking-sfc port-pair-group.
Multiple port-pairs may be included in a port-pair-group to allow the specification of a set of functionally equivalent Service Functions that can be be used for load distribution.
Required Properties¶
Optional Properties¶
description¶
Description for the Port Pair Group.
String value expected.
Can be updated without replacement.
HOT Syntax¶
heat_template_version: 2015-04-30
...
resources:
...
the_resource:
type: OS::Neutron::PortPairGroup
properties:
description: String
name: String
port_pairs: [String, String, ...]
OS::Nova::FloatingIP¶
Note
DEPRECATED since 9.0.0 (Pike) - Please use OS::Neutron::FloatingIP instead.
Note
Available since 2014.1 (Icehouse)
A resource for managing Nova floating IPs.
Floating IP addresses can change their association between instances by action of the user. One of the most common use cases for floating IPs is to provide public IP addresses to a private cloud, where there are a limited number of IP addresses available. Another is for a public cloud user to have a “static” IP address that can be reassigned when an instance is upgraded or moved.
Optional Properties¶
pool¶
Allocate a floating IP from a given floating IP pool. Now that nova-network is not supported this represents the external network.
String value expected.
Updates cause replacement.
Attributes¶
ip¶
Allocated floating IP address.
pool¶
Pool from which floating IP is allocated.
show¶
Detailed information about resource.
HOT Syntax¶
heat_template_version: 2015-04-30
...
resources:
...
the_resource:
type: OS::Nova::FloatingIP
properties:
pool: String
OS::Nova::FloatingIPAssociation¶
Note
DEPRECATED since 9.0.0 (Pike) - Please use OS::Neutron::FloatingIPAssociation instead.
Note
Available since 2014.1 (Icehouse)
A resource associates Nova floating IP with Nova server resource.
Resource for associating existing Nova floating IP and Nova server.
Required Properties¶
floating_ip¶
ID of the floating IP to assign to the server.
String value expected.
Can be updated without replacement.
server_id¶
Server to assign floating IP to.
String value expected.
Can be updated without replacement.
Value must be of type nova.server
HOT Syntax¶
heat_template_version: 2015-04-30
...
resources:
...
the_resource:
type: OS::Nova::FloatingIPAssociation
properties:
floating_ip: String
server_id: String