On this page
rabbitmq_binding – Manage rabbitMQ bindings
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
|
CA certificate to verify SSL connection to management API.
aliases: cacert |
|
client_cert
path
|
Client certificate to send on SSL connections to management API.
aliases: cert |
|
client_key
path
|
Private key matching the client certificate.
aliases: key |
|
destination
- / required
|
destination exchange or queue for the binding.
aliases: dst, dest |
|
destination_type
- / required
|
|
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
|
|
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
-
|
|
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
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Manuel Sousa (@manuel-sousa)
Hint
If you notice any issues in this documentation, you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/rabbitmq_binding_module.html