76 lines
1.6 KiB
Markdown
76 lines
1.6 KiB
Markdown
|
---
|
||
|
|
layout: "rabbitmq"
|
||
|
|
page_title: "RabbitMQ: rabbitmq_exchange"
|
||
|
|
sidebar_current: "docs-rabbitmq-resource-exchange"
|
||
|
|
description: |-
|
||
|
|
Creates and manages an exchange on a RabbitMQ server.
|
||
|
|
---
|
||
|
|
|
||
|
|
# rabbitmq\_exchange
|
||
|
|
|
||
|
|
The ``rabbitmq_exchange`` resource creates and manages 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
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## Argument Reference
|
||
|
|
|
||
|
|
The following arguments are supported:
|
||
|
|
|
||
|
|
* `name` - (Required) The name of the exchange.
|
||
|
|
|
||
|
|
* `vhost` - (Required) The vhost to create the resource in.
|
||
|
|
|
||
|
|
* `settings` - (Required) The settings of the exchange. The structure is
|
||
|
|
described below.
|
||
|
|
|
||
|
|
The `settings` block supports:
|
||
|
|
|
||
|
|
* `type` - (Required) The type of exchange.
|
||
|
|
|
||
|
|
* `durable` - (Optional) Whether the exchange survives server restarts.
|
||
|
|
Defaults to `false`.
|
||
|
|
|
||
|
|
* `auto_delete` - (Optional) Whether the exchange will self-delete when all
|
||
|
|
queues have finished using it.
|
||
|
|
|
||
|
|
* `arguments` - (Optional) Additional key/value settings for the exchange.
|
||
|
|
|
||
|
|
## Attributes Reference
|
||
|
|
|
||
|
|
No further attributes are exported.
|
||
|
|
|
||
|
|
## Import
|
||
|
|
|
||
|
|
Exchanges can be imported using the `id` which is composed of `name@vhost`.
|
||
|
|
E.g.
|
||
|
|
|
||
|
|
```
|
||
|
|
terraform import rabbitmq_exchange.test test@vhost
|
||
|
|
```
|