terraform/website/source/docs/providers/azurerm/r/eventhub_namespace.html.mar...

78 lines
2.4 KiB
Markdown
Raw Normal View History

---
layout: "azurerm"
page_title: "Azure Resource Manager: azurerm_eventhub_namespace"
sidebar_current: "docs-azurerm-resource-eventhub-namespace"
description: |-
Create an EventHub Namespace.
---
# azurerm\_eventhub\_namespace
Create an EventHub Namespace.
## Example Usage
```
resource "azurerm_resource_group" "test" {
name = "resourceGroup1"
location = "West US"
}
resource "azurerm_eventhub_namespace" "test" {
name = "acceptanceTestEventHubNamespace"
location = "West US"
resource_group_name = "${azurerm_resource_group.test.name}"
sku = "Basic"
capacity = 2
tags {
environment = "Production"
}
}
```
## Argument Reference
The following arguments are supported:
* `name` - (Required) Specifies the name of the EventHub Namespace resource . 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.
* `location` - (Required) Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
* `sku` - (Required) Defines which tier to use. Options are Basic or Standard.
* `capacity` - (Optional) Specifies the capacity of a Standard namespace. Can be 1, 2 or 4
* `tags` - (Optional) A mapping of tags to assign to the resource.
## Attributes Reference
The following attributes are exported:
* `id` - The EventHub Namespace ID.
The following attributes are exported only if there is an authorization rule named
`RootManageSharedAccessKey` which is created automatically by Azure.
* `default_primary_connection_string` - The primary connection string for the authorization
rule `RootManageSharedAccessKey`.
* `default_secondary_connection_string` - The secondary connection string for the
authorization rule `RootManageSharedAccessKey`.
* `default_primary_key` - The primary access key for the authorization rule `RootManageSharedAccessKey`.
* `default_secondary_key` - The secondary access key for the authorization rule `RootManageSharedAccessKey`.
## Import
EventHub Namespaces can be imported using the `resource id`, e.g.
```
terraform import azurerm_eventhub_namespace.namespace1 /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.EventHub/namespaces/namespace1
```