90 lines
2.0 KiB
Markdown
90 lines
2.0 KiB
Markdown
|
---
|
||
|
layout: "rabbitmq"
|
||
|
page_title: "RabbitMQ: rabbitmq_binding"
|
||
|
sidebar_current: "docs-rabbitmq-resource-binding"
|
||
|
description: |-
|
||
|
Creates and manages a binding on a RabbitMQ server.
|
||
|
---
|
||
|
|
||
|
# rabbitmq\_binding
|
||
|
|
||
|
The ``rabbitmq_binding`` resource creates and manages a binding relationship
|
||
|
between a queue an exchange.
|
||
|
|
||
|
## Example Usage
|
||
|
|
||
|
```
|
||
|
resource "rabbitmq_vhost" "test" {
|
||
|
name = "test"
|
||
|
}
|
||
|
|
||
|
resource "rabbitmq_permissions" "guest" {
|
||
|
user = "guest"
|
||
|
vhost = "${rabbitmq_vhost.test.name}"
|
||
|
permissions {
|
||
|
configure = ".*"
|
||
|
write = ".*"
|
||
|
read = ".*"
|
||
|
}
|
||
|
}
|
||
|
|
||
|
resource "rabbitmq_exchange" "test" {
|
||
|
name = "test"
|
||
|
vhost = "${rabbitmq_permissions.guest.vhost}"
|
||
|
settings {
|
||
|
type = "fanout"
|
||
|
durable = false
|
||
|
auto_delete = true
|
||
|
}
|
||
|
}
|
||
|
|
||
|
resource "rabbitmq_queue" "test" {
|
||
|
name = "test"
|
||
|
vhost = "${rabbitmq_permissions.guest.vhost}"
|
||
|
settings {
|
||
|
durable = true
|
||
|
auto_delete = false
|
||
|
}
|
||
|
}
|
||
|
|
||
|
resource "rabbitmq_binding" "test" {
|
||
|
source = "${rabbitmq_exchange.test.name}"
|
||
|
vhost = "${rabbitmq_vhost.test.name}"
|
||
|
destination = "${rabbitmq_queue.test.name}"
|
||
|
destination_type = "queue"
|
||
|
routing_key = "#"
|
||
|
properties_key = "%23"
|
||
|
}
|
||
|
```
|
||
|
|
||
|
## Argument Reference
|
||
|
|
||
|
The following arguments are supported:
|
||
|
|
||
|
* `source` - (Required) The source exchange.
|
||
|
|
||
|
* `vhost` - (Required) The vhost to create the resource in.
|
||
|
|
||
|
* `destination` - (Required) The destination queue or exchange.
|
||
|
|
||
|
* `destination_type` - (Required) The type of destination (queue or exchange).
|
||
|
|
||
|
* `properties_key` - (Required) A unique key to refer to the binding.
|
||
|
|
||
|
* `routing_key` - (Optional) A routing key for the binding.
|
||
|
|
||
|
* `arguments` - (Optional) Additional key/value arguments for the binding.
|
||
|
|
||
|
## Attributes Reference
|
||
|
|
||
|
No further attributes are exported.
|
||
|
|
||
|
## Import
|
||
|
|
||
|
Bindings can be imported using the `id` which is composed of
|
||
|
`vhost/source/destination/destination_type/properties_key`. E.g.
|
||
|
|
||
|
```
|
||
|
terraform import rabbitmq_binding.test test/test/test/queue/%23
|
||
|
```
|