github.com/danp/terraform@v0.9.5-0.20170426144147-39d740081351/website/source/docs/providers/rabbitmq/r/queue.html.markdown (about)

     1  ---
     2  layout: "rabbitmq"
     3  page_title: "RabbitMQ: rabbitmq_queue"
     4  sidebar_current: "docs-rabbitmq-resource-queue"
     5  description: |-
     6    Creates and manages a queue on a RabbitMQ server.
     7  ---
     8  
     9  # rabbitmq\_queue
    10  
    11  The ``rabbitmq_queue`` resource creates and manages a queue.
    12  
    13  ## Example Usage
    14  
    15  ```hcl
    16  resource "rabbitmq_vhost" "test" {
    17    name = "test"
    18  }
    19  
    20  resource "rabbitmq_permissions" "guest" {
    21    user  = "guest"
    22    vhost = "${rabbitmq_vhost.test.name}"
    23  
    24    permissions {
    25      configure = ".*"
    26      write     = ".*"
    27      read      = ".*"
    28    }
    29  }
    30  
    31  resource "rabbitmq_queue" "test" {
    32    name  = "test"
    33    vhost = "${rabbitmq_permissions.guest.vhost}"
    34  
    35    settings {
    36      durable     = false
    37      auto_delete = true
    38    }
    39  }
    40  ```
    41  
    42  ## Argument Reference
    43  
    44  The following arguments are supported:
    45  
    46  * `name` - (Required) The name of the queue.
    47  
    48  * `vhost` - (Required) The vhost to create the resource in.
    49  
    50  * `settings` - (Required) The settings of the queue. The structure is
    51    described below.
    52  
    53  The `settings` block supports:
    54  
    55  * `durable` - (Optional) Whether the queue survives server restarts.
    56    Defaults to `false`.
    57  
    58  * `auto_delete` - (Optional) Whether the queue will self-delete when all
    59    consumers have unsubscribed.
    60  
    61  * `arguments` - (Optional) Additional key/value settings for the queue.
    62  
    63  ## Attributes Reference
    64  
    65  No further attributes are exported.
    66  
    67  ## Import
    68  
    69  Queues can be imported using the `id` which is composed of `name@vhost`. E.g.
    70  
    71  ```
    72  terraform import rabbitmq_queue.test name@vhost
    73  ```