community.rabbitmq.rabbitmq_binding – Manage rabbitMQ bindings

Note

This plugin is part of the community.rabbitmq collection (version 1.0.1).

To install it use: ansible-galaxy collection install community.rabbitmq.

To use it in a playbook, specify: community.rabbitmq.rabbitmq_binding.

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
dictionary
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
string / required
destination exchange or queue for the binding.

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

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

aliases: src, source
routing_key
string
Default:
"#"
routing key for the binding.
state
string
    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
- community.rabbitmq.rabbitmq_binding:
    name: directExchange
    destination: myQueue
    type: queue
    routing_key: info

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

Authors

  • Manuel Sousa (@manuel-sousa)