Skip to content

Latest commit

 

History

History
111 lines (78 loc) · 4.25 KB

servicebus_topic.html.markdown

File metadata and controls

111 lines (78 loc) · 4.25 KB
layout page_title sidebar_current description
azurerm
Azure Resource Manager: azurerm_servicebus_topic
docs-azurerm-resource-messaging-servicebus-topic
Manages a ServiceBus Topic.

azurerm_servicebus_topic

Manage a ServiceBus Topic.

Note Topics can only be created in Namespaces with an SKU of standard or higher.

Example Usage

variable "location" {
  description = "Azure datacenter to deploy to."
  default = "West US"
}

resource "azurerm_resource_group" "test" {
  name     = "terraform-servicebus"
  location = "${var.location}"
}

resource "azurerm_servicebus_namespace" "test" {
  name                = "${var.servicebus_name}"
  location            = "${var.location}"
  resource_group_name = "${azurerm_resource_group.test.name}"
  sku                 = "standard"

  tags {
    source = "terraform"
  }
}

resource "azurerm_servicebus_topic" "test" {
  name                = "testTopic"
  resource_group_name = "${azurerm_resource_group.test.name}"
  namespace_name      = "${azurerm_servicebus_namespace.test.name}"

  enable_partitioning = true
}

Argument Reference

The following arguments are supported:

  • name - (Required) Specifies the name of the ServiceBus Topic resource. Changing this forces a new resource to be created.

  • namespace_name - (Required) The name of the ServiceBus Namespace to create this topic in. Changing this forces a new resource to be created.

  • location - (Required) Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.

  • resource_group_name - (Required) The name of the resource group in which to create the namespace. Changing this forces a new resource to be created.

  • status - (Optional) The Status of the Service Bus Topic. Acceptable values are Active or Disabled. Defaults to Active.

  • auto_delete_on_idle - (Optional) The ISO 8601 timespan duration of the idle interval after which the Topic is automatically deleted, minimum of 5 minutes.

  • default_message_ttl - (Optional) The ISO 8601 timespan duration of TTL of messages sent to this topic if no TTL value is set on the message itself.

  • duplicate_detection_history_time_window - (Optional) The ISO 8601 timespan duration during which duplicates can be detected. Defaults to 10 minutes. (PT10M)

  • enable_batched_operations - (Optional) Boolean flag which controls if server-side batched operations are enabled. Defaults to false.

  • enable_express - (Optional) Boolean flag which controls whether Express Entities are enabled. An express topic holds a message in memory temporarily before writing it to persistent storage. Defaults to false.

  • enable_partitioning - (Optional) Boolean flag which controls whether to enable the topic to be partitioned across multiple message brokers. Defaults to false. Changing this forces a new resource to be created.

-> NOTE: Partitioning is available at entity creation for all queues and topics in Basic or Standard SKUs. It is not available for the Premium messaging SKU, but any previously existing partitioned entities in Premium namespaces continue to work as expected. Please see the documentation for more information.

  • max_size_in_megabytes - (Optional) Integer value which controls the size of memory allocated for the topic. For supported values see the "Queue/topic size" section of this document.

  • requires_duplicate_detection - (Optional) Boolean flag which controls whether the Topic requires duplicate detection. Defaults to false. Changing this forces a new resource to be created.

  • support_ordering - (Optional) Boolean flag which controls whether the Topic supports ordering. Defaults to false.

Attributes Reference

The following attributes are exported:

  • id - The ServiceBus Topic ID.

Import

Service Bus Topics can be imported using the resource id, e.g.

terraform import azurerm_servicebus_topic.test /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/microsoft.servicebus/namespaces/sbns1/topics/sntopic1