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

email

Domain email.

String value expected.

Can be updated without replacement.

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.

Attributes

serial

DNS domain serial.

show

Detailed information about resource.

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.

Attributes

show

Detailed information about resource.

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.

Attributes

show

Detailed information about resource.

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.

name

The bay name.

String value expected.

Updates cause replacement.

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.

Attributes

show

Detailed information about resource.

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”.

name

The cluster template name.

String value expected.

Updates cause replacement.

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

Attributes

show

Detailed information about resource.

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

destination

Network in CIDR notation.

String value expected.

Updates cause replacement.

nexthop

Nexthop IP address.

String value expected.

Updates cause replacement.

router_id

The router id.

String value expected.

Updates cause replacement.

Value must be of type neutron.router

Attributes

show

Detailed information about resource.

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

name

Name of the Flow Classifier.

String value expected.

Can be updated without replacement.

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.

Attributes

show

Detailed information about resource.

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

port_pair_groups

A list of port pair groups to apply to the Port Chain.

List value expected.

Can be updated without replacement.

List contents:

*

Port Pair Group ID or Name .

String value expected.

Can be updated without replacement.

Value must be of type neutron.port_pair_group

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.

flow_classifiers

A list of flow classifiers to apply to the Port Chain.

List value expected.

Can be updated without replacement.

Defaults to “[]”.

List contents:

*

Flow Classifier ID or Name .

String value expected.

Can be updated without replacement.

Value must be of type neutron.flow_classifier

name

Name of the Port Chain.

String value expected.

Can be updated without replacement.

Attributes

show

Detailed information about resource.

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.

name

Name 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}”.

Attributes

show

Detailed information about resource.

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

port_pairs

A list of Port Pair IDs or names to apply.

List value expected.

Can be updated without replacement.

List contents:

*

Port Pair ID or name .

String value expected.

Can be updated without replacement.

Value must be of type neutron.port_pair

Optional Properties

description

Description for the Port Pair Group.

String value expected.

Can be updated without replacement.

name

Name for the Port Pair Group.

String value expected.

Can be updated without replacement.

Attributes

show

Detailed information about resource.

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

Attributes

show

Detailed information about resource.

HOT Syntax

heat_template_version: 2015-04-30
...
resources:
  ...
  the_resource:
    type: OS::Nova::FloatingIPAssociation
    properties:
      floating_ip: String
      server_id: String