Documentation

rabbitmq_binding – Manage rabbitMQ bindings

New in version 2.0.

Synopsis

  • This module uses rabbitMQ REST APIs to create / delete bindings.

Requirements

The below requirements are needed on the host that executes this module.

  • requests >= 1.0.0

Parameters

Parameter Choices/Defaults Comments
arguments
-
Default:
{}
extra arguments for exchange. If defined this argument is a key/value dictionary
ca_cert
path
added in 2.3
CA certificate to verify SSL connection to management API.

aliases: cacert
client_cert
path
added in 2.3
Client certificate to send on SSL connections to management API.

aliases: cert
client_key
path
added in 2.3
Private key matching the client certificate.

aliases: key
destination
- / required
destination exchange or queue for the binding.

aliases: dst, dest
destination_type
- / required
    Choices:
  • queue
  • exchange
Either queue or exchange.

aliases: type, dest_type
login_host
string
Default:
localhost
RabbitMQ host for connection.
login_password
string
RabbitMQ password for connection.
login_port
string
Default:
15672
RabbitMQ management API port.
login_protocol
string
added in 2.3
    Choices:
  • http ←
  • https
RabbitMQ management API protocol.
login_user
string
Default:
guest
RabbitMQ user for connection.
name
- / required
source exchange to create binding on.

aliases: src, source
routing_key
-
Default:
#
routing key for the binding.
state
-
    Choices:
  • present ←
  • absent
Whether the bindings should be present or absent.
vhost
string
Default:
/
RabbitMQ virtual host.

Examples

# Bind myQueue to directExchange with routing key info
- rabbitmq_binding:
    name: directExchange
    destination: myQueue
    type: queue
    routing_key: info

# Bind directExchange to topicExchange with routing key *.info
- rabbitmq_binding:
    name: topicExchange
    destination: topicExchange
    type: exchange
    routing_key: '*.info'

Status

Authors

  • Manuel Sousa (@manuel-sousa)

Hint

If you notice any issues in this documentation you can edit this document to improve it.