Bicep 리소스 정의
네임스페이스 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 참조
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
사용 예제
Bicep 샘플
EventHub 네임스페이스 배포의 기본 예제입니다.
param resourceName string = 'acctest0001'
param location string = 'westeurope'
resource namespace 'Microsoft.EventHub/namespaces@2022-01-01-preview' = {
name: resourceName
location: location
sku: {
capacity: 1
name: 'Standard'
tier: 'Standard'
}
properties: {
disableLocalAuth: false
isAutoInflateEnabled: false
publicNetworkAccess: 'Enabled'
zoneRedundant: false
}
}
Azure 확인된 모듈
다음 Azure 확인된 모듈 사용하여 이 리소스 유형을 배포할 수 있습니다.
| Module | Description |
|---|---|
| Event Hub 네임스페이스 | 이벤트 허브 네임스페이스에 대한 AVM 리소스 모듈 |
Azure 빠른 시작 샘플
다음 Azure 빠른 시작 템플릿에는 이 리소스 유형을 배포하기 위한 Bicep 샘플이 포함되어 있습니다.
| Bicep 파일 | Description |
|---|---|
| 시간 데이터 기록 연결 사용하여 Azure Digital Twins |
이 템플릿은 시계열 데이터 기록 연결로 구성된 Azure Digital Twins 인스턴스를 만듭니다. 연결을 만들려면 Event Hubs 네임스페이스, 이벤트 허브, Azure Data Explorer 클러스터 및 데이터베이스와 같은 다른 리소스를 만들어야 합니다. 데이터는 결국 Azure Data Explorer 클러스터에 데이터를 전달하는 이벤트 허브로 전송됩니다. 데이터는 클러스터의 데이터베이스 테이블에 저장됩니다. |
| Event Hub 및 관리 ID 사용하여 Azure Function App |
템플릿은 Event Hub, Azure Storage 및 Application Insights와 함께 Linux 소비 계획에 Azure Function 앱을 프로비전합니다. 함수 앱은 관리 ID를 사용하여 이벤트 허브 및 스토리지 계정에 연결할 수 있습니다. |
| 이벤트 허브 만들기 | 이 템플릿을 사용하면 이벤트 허브를 사용하여 EventHubs 네임스페이스를 배포할 수 있습니다. |
| EventHubs 네임스페이스, Event Hub, & 소비자 그룹 만들기 | 이 템플릿을 사용하면 Event Hubs 표준 네임스페이스, Event Hub 및 소비자 그룹을 배포할 수 있습니다. |
| 클러스터 이벤트 허브 클러스터 & 이름 삭제를 만듭니다. | 이 템플릿을 사용하면 EventHubs 클러스터 및 네임스페이스를 클러스터에 만들 수 있습니다. |
| Eventhub 클러스터를 만들고 eventhub & 이름 삭제 | 이 템플릿을 사용하면 클러스터에서 EventHubs 클러스터, 네임스페이스 및 eventhub를 만들 수 있습니다. |
| Event Grid 연결 사용하여 Azure Data Explorer db 배포 |
Event Grid 연결을 사용하여 Azure Data Explorer db를 배포합니다. |
| 이벤트 허브 연결 사용하여 Azure Data Explorer db 배포 |
이벤트 허브 연결을 사용하여 Azure Data Explorer db를 배포합니다. |
| Azure 아키텍처 스포츠 분석 배포 |
ADLS Gen 2를 사용하도록 설정된 Azure Storage 계정, 스토리지 계정에 연결된 서비스가 있는 Azure Data Factory 인스턴스(배포된 경우 Azure SQL Database) 및 Azure Databricks 인스턴스를 만듭니다. 템플릿을 배포하는 사용자의 AAD ID와 ADF 인스턴스의 관리 ID에는 스토리지 계정에 대한 Storage Blob 데이터 기여자 역할이 부여됩니다. Azure Key Vault 인스턴스, Azure SQL Database 및 Azure Event Hub(스트리밍 사용 사례용)를 배포하는 옵션도 있습니다. Azure Key Vault가 배포되면 템플릿을 배포하는 사용자의 데이터 팩터리 관리 ID 및 AAD ID에 Key Vault 비밀 사용자 역할이 부여됩니다. |
| WaF, Domains 및 Logs를 사용하여 FrontDoor CDN을 EventHub |
이 템플릿은 새 Azure FrontDoor cdn 프로필을 만듭니다. WAF 및 경로와 연결된 사용자 지정 및 관리 규칙, cdn 경로, 원본 및 그룹을 사용하여 WAF를 만들고, 사용자 지정 도메인을 구성하고, 이벤트 허브를 만들고, 이벤트 허브를 사용하여 CDN 액세스 로그를 보내기 위한 진단 설정을 만듭니다. |
| Moesif API 분석 및 수익 창출 | 템플릿은 Azure API Management에서 Moesif API 분석 및 수익 창출 플랫폼으로 API 호출을 기록합니다. |
리소스 형식
Microsoft.EventHub/네임스페이스 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.
resource symbolicname 'Microsoft.EventHub/namespaces@2024-05-01-preview' = {
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
alternateName: 'string'
clusterArmId: 'string'
disableLocalAuth: bool
encryption: {
keySource: 'Microsoft.KeyVault'
keyVaultProperties: [
{
identity: {
userAssignedIdentity: 'string'
}
keyName: 'string'
keyVaultUri: 'string'
keyVersion: 'string'
}
]
requireInfrastructureEncryption: bool
}
geoDataReplication: {
locations: [
{
clusterArmId: 'string'
locationName: 'string'
roleType: 'string'
}
]
maxReplicationLagDurationInSeconds: int
}
isAutoInflateEnabled: bool
kafkaEnabled: bool
maximumThroughputUnits: int
minimumTlsVersion: 'string'
privateEndpointConnections: [
{
properties: {
privateEndpoint: {
id: 'string'
}
privateLinkServiceConnectionState: {
description: 'string'
status: 'string'
}
provisioningState: 'string'
}
}
]
publicNetworkAccess: 'string'
zoneRedundant: bool
}
sku: {
capacity: int
name: 'string'
tier: 'string'
}
tags: {
{customized property}: 'string'
}
}
속성 값
Microsoft.EventHub/namespaces
| Name | Description | Value |
|---|---|---|
| identity | BYOK ID 설명의 속성 | Identity |
| location | 리소스 위치입니다. | string |
| name | 리소스 이름 | string Constraints: 최소 길이 = 6 최대 길이 = 50 패턴 = ^[a-zA-Z][a-zA-Z0-9-]{6,50}[a-zA-Z0-9]$(필수) |
| properties | 네임스페이스 만들기 작업에 제공된 네임스페이스 속성입니다. | EHNamespaceProperties |
| sku | sku 리소스의 속성 | Sku |
| tags | 리소스 태그 | 태그 이름 및 값의 사전입니다. 템플릿 |
ConnectionState
| Name | Description | Value |
|---|---|---|
| description | 연결 상태에 대한 설명입니다. | string |
| status | 연결의 상태입니다. | 'Approved' 'Disconnected' 'Pending' 'Rejected' |
EHNamespaceProperties
| Name | Description | Value |
|---|---|---|
| alternateName | 별칭 및 네임스페이스 이름이 같을 때 지정된 대체 이름입니다. | string |
| clusterArmId | 네임스페이스의 클러스터 ARM ID입니다. | string |
| disableLocalAuth | 이 속성은 Event Hubs 네임스페이스에 대한 SAS 인증을 사용하지 않도록 설정합니다. | bool |
| encryption | BYOK 암호화 설명의 속성 | Encryption |
| geoDataReplication | 네임스페이스에 대한 지역 데이터 복제 설정 | GeoDataReplicationProperties |
| isAutoInflateEnabled | EventHub 네임스페이스에 대해 AutoInflate를 사용할 수 있는지 여부를 나타내는 값입니다. | bool |
| kafkaEnabled | Eventhub 네임스페이스에 대해 Kafka를 사용할 수 있는지 여부를 나타내는 값입니다. | bool |
| maximumThroughputUnits | AutoInflate를 사용하는 경우 처리량 단위의 상한값은 0~20개 처리량 단위 내에 있어야 합니다. (AutoInflateEnabled = true이면 '0') | int Constraints: 최소값 = 0 |
| minimumTlsVersion | 지원할 클러스터의 최소 TLS 버전(예: '1.2') | '1.0' '1.1' '1.2' |
| privateEndpointConnections | 프라이빗 엔드포인트 연결 목록입니다. | PrivateEndpointConnection[] |
| publicNetworkAccess | 이는 공용 네트워크를 통해 트래픽이 허용되는지 여부를 결정합니다. 기본적으로 사용하도록 설정됩니다. | 'Disabled' 'Enabled' 'SecuredByPerimeter' |
| zoneRedundant | 이 속성을 사용하도록 설정하면 지원되는 가용성 영역에 표준 Event Hubs 네임스페이스가 만들어집니다. | bool |
Encryption
| Name | Description | Value |
|---|---|---|
| keySource | 암호화에 대한 keySource의 가능한 값을 열거합니다. | 'Microsoft.KeyVault' |
| keyVaultProperties | KeyVault의 속성 | KeyVaultProperties[] |
| requireInfrastructureEncryption | 인프라 암호화 사용(이중 암호화) | bool |
GeoDataReplicationProperties
| Name | Description | Value |
|---|---|---|
| locations | 네임스페이스의 복제본이 유지 관리되는 지역 목록입니다. | NamespaceReplicaLocation[] |
| maxReplicationLagDurationInSeconds | 주 복제본에서 보조 복제본의 쿼럼까지의 데이터 복제 작업에 허용되는 최대 지연 시간입니다. 지연이 구성된 양을 초과하면 주 복제본에 대한 작업이 실패합니다. 허용되는 값은 0과 5분에서 1일입니다. | int |
Identity
| Name | Description | Value |
|---|---|---|
| type | 관리 서비스 ID의 유형입니다. | 'None' 'SystemAssigned' '시스템 할당, 사용자 할당' 'UserAssigned' |
| userAssignedIdentities | 사용자 할당 ID에 대한 속성 | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
| Name | Description | Value |
|---|
KeyVaultProperties
| Name | Description | Value |
|---|---|---|
| identity | UserAssignedIdentityProperties | |
| keyName | KeyVault의 키 이름 | string |
| keyVaultUri | KeyVault의 URI | string |
| keyVersion | 키 버전 | string |
NamespaceReplicaLocation
| Name | Description | Value |
|---|---|---|
| clusterArmId | 클러스터의 ARM ID를 나타내는 선택적 속성입니다. 네임스페이스 복제본을 전용 이벤트 허브 클러스터에 배치해야 하는 경우 필요합니다. | string |
| locationName | 네임스페이스의 복제본이 유지 관리되는 Azure 지역 | string |
| roleType | GeoDR 역할 유형 | 'Primary' 'Secondary' |
PrivateEndpoint
| Name | Description | Value |
|---|---|---|
| id | 프라이빗 엔드포인트의 ARM 식별자입니다. | string |
PrivateEndpointConnection
| Name | Description | Value |
|---|---|---|
| properties | PrivateEndpointConnection의 속성입니다. | PrivateEndpointConnectionProperties |
PrivateEndpointConnectionProperties
| Name | Description | Value |
|---|---|---|
| privateEndpoint | 이 연결에 대한 프라이빗 엔드포인트 리소스입니다. | PrivateEndpoint |
| privateLinkServiceConnectionState | 연결 상태에 대한 세부 정보입니다. | ConnectionState |
| provisioningState | 프라이빗 엔드포인트 연결의 프로비전 상태입니다. | 'Canceled' 'Creating' 'Deleting' 'Failed' 'Succeeded' 'Updating' |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | 기본 또는 표준 계층에 대한 Event Hubs 처리량 단위입니다. 여기서 값은 0~20개 처리량 단위여야 합니다. 프리미엄 계층에 대한 Event Hubs 프리미엄 단위입니다. 여기서 값은 0~10 프리미엄 단위여야 합니다. | int Constraints: 최소값 = 0 |
| name | 이 SKU의 이름입니다. | 'Basic' 'Premium' 'Standard'(필수) |
| tier | 이 특정 SKU의 청구 계층입니다. | 'Basic' 'Premium' 'Standard' |
TrackedResourceTags
| Name | Description | Value |
|---|
UserAssignedIdentity
| Name | Description | Value |
|---|
UserAssignedIdentityProperties
| Name | Description | Value |
|---|---|---|
| userAssignedIdentity | 암호화를 위해 선택된 사용자 ID의 ARM ID | string |
ARM 템플릿 리소스 정의
네임스페이스 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 어를 참조하세요. 각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
사용 예제
Azure 빠른 시작 템플릿
다음 Azure 빠른 시작 템플릿은 이 리소스 유형을 배포할 있습니다.
| Template | Description |
|---|---|
| 시간 데이터 기록 연결 사용하여 Azure Digital Twins Azure |
이 템플릿은 시계열 데이터 기록 연결로 구성된 Azure Digital Twins 인스턴스를 만듭니다. 연결을 만들려면 Event Hubs 네임스페이스, 이벤트 허브, Azure Data Explorer 클러스터 및 데이터베이스와 같은 다른 리소스를 만들어야 합니다. 데이터는 결국 Azure Data Explorer 클러스터에 데이터를 전달하는 이벤트 허브로 전송됩니다. 데이터는 클러스터의 데이터베이스 테이블에 저장됩니다. |
| Event Hub 및 관리 ID 사용하여 Azure Function App Azure |
템플릿은 Event Hub, Azure Storage 및 Application Insights와 함께 Linux 소비 계획에 Azure Function 앱을 프로비전합니다. 함수 앱은 관리 ID를 사용하여 이벤트 허브 및 스토리지 계정에 연결할 수 있습니다. |
| Event Hub 기록된 감사로 Azure SQL Server Azure |
이 템플릿을 사용하면 감사가 사용하도록 설정된 Azure SQL 서버를 배포하여 이벤트 허브에 감사 로그를 쓸 수 있습니다. |
|
프라이빗 엔드포인트 통해 Event Hubs 네임스페이스에 연결 Azure 배포 |
이 샘플에서는 가상 네트워크 및 프라이빗 DNS 영역을 구성하여 프라이빗 엔드포인트를 통해 Event Hubs 네임스페이스에 액세스하는 방법을 보여 줍니다. |
|
Event Hubs 네임스페이스 Virtual Network 규칙 만들기 Azure 배포 |
이 템플릿을 사용하면 Virtual Network 규칙을 사용하여 Event Hubs 표준 네임스페이스를 배포할 수 있습니다. |
|
Eventhub 네임스페이스 및 지역 복구 구성 만들기 Azure 배포 |
이 템플릿을 사용하면 기본/표준 SKU를 사용하여 Service Bus 네임스페이스를 배포할 수 있습니다. |
|
Eventhub 네임스페이스 IP 필터 규칙 만들기 Azure 배포 |
이 템플릿을 사용하면 IP 필터 규칙을 사용하여 Service Bus Premium 네임스페이스를 배포할 수 있습니다. |
|
이벤트 허브 이벤트 원본 사용하여 환경 만들기 Azure 배포 |
이 템플릿을 사용하면 이벤트 허브의 이벤트를 사용하도록 구성된 Time Series Insights 환경을 배포할 수 있습니다. |
|
이벤트 허브 만들기 Azure 배포 |
이 템플릿을 사용하면 이벤트 허브를 사용하여 EventHubs 네임스페이스를 배포할 수 있습니다. |
|
EventHubs 네임스페이스를 만들고 자동 확장 사용하도록 설정 Azure 배포 |
이 템플릿을 사용하면 Event Hubs 표준 네임스페이스, Event Hub 및 소비자 그룹을 배포할 수 있습니다. 또한 이 템플릿은 네임스페이스에서 자동 확장 기능을 켭니다. |
|
EventHubs 네임스페이스, Event Hub, & 소비자 그룹 만들기 Azure 배포 |
이 템플릿을 사용하면 Event Hubs 표준 네임스페이스, Event Hub 및 소비자 그룹을 배포할 수 있습니다. |
|
Event Grid 사용자 지정 토픽 및 이벤트 허브 처리기 만들기 Azure 배포 |
이벤트를 처리할 Azure Event Grid 사용자 지정 토픽 및 이벤트 허브를 만듭니다. |
|
EventHubs authorizationRules 만들기 Azure 배포 |
이 템플릿을 사용하면 EventHubs 표준 네임스페이스, Event Hub, 소비자 그룹 및 authorizationRules를 배포할 수 있습니다. |
| 캡처를 사용하도록 설정된 eventHubs 만들기 Azure |
이 템플릿을 사용하면 이벤트 허브를 사용하여 EventHubs 네임스페이스를 배포하고 캡처를 사용하도록 설정할 수 있습니다. |
|
ADLS(캡처 사용) 사용하여 EventHubs 만들기 Azure 배포 |
이 템플릿을 사용하면 이벤트 허브를 사용하여 EventHubs 네임스페이스를 배포하고 캡처를 사용하도록 설정할 수 있습니다. |
|
로그 및 메트릭 구성된 전송을 사용하여 SQL MI 만들기 Azure 배포 |
이 템플릿을 사용하면 로그 및 메트릭(진단 작업 영역, 스토리지 계정, 이벤트 허브)을 저장하는 데 사용되는 SQL MI 및 추가 리소스를 배포할 수 있습니다. |
|
클러스터 이벤트 허브 클러스터 & 이름 삭제를 만듭니다. Azure 배포 |
이 템플릿을 사용하면 EventHubs 클러스터 및 네임스페이스를 클러스터에 만들 수 있습니다. |
|
Eventhub 클러스터를 만들고 eventhub & 이름 삭제 Azure 배포 |
이 템플릿을 사용하면 클러스터에서 EventHubs 클러스터, 네임스페이스 및 eventhub를 만들 수 있습니다. |
| Event Grid 연결 사용하여 Azure Data Explorer db 배포 Azure |
Event Grid 연결을 사용하여 Azure Data Explorer db를 배포합니다. |
| 이벤트 허브 연결 사용하여 Azure Data Explorer db 배포 Azure |
이벤트 허브 연결을 사용하여 Azure Data Explorer db를 배포합니다. |
| Azure 아키텍처 스포츠 분석 배포 Azure |
ADLS Gen 2를 사용하도록 설정된 Azure Storage 계정, 스토리지 계정에 연결된 서비스가 있는 Azure Data Factory 인스턴스(배포된 경우 Azure SQL Database) 및 Azure Databricks 인스턴스를 만듭니다. 템플릿을 배포하는 사용자의 AAD ID와 ADF 인스턴스의 관리 ID에는 스토리지 계정에 대한 Storage Blob 데이터 기여자 역할이 부여됩니다. Azure Key Vault 인스턴스, Azure SQL Database 및 Azure Event Hub(스트리밍 사용 사례용)를 배포하는 옵션도 있습니다. Azure Key Vault가 배포되면 템플릿을 배포하는 사용자의 데이터 팩터리 관리 ID 및 AAD ID에 Key Vault 비밀 사용자 역할이 부여됩니다. |
| WaF, Domains 및 Logs를 사용하여 FrontDoor CDN을 EventHub Azure |
이 템플릿은 새 Azure FrontDoor cdn 프로필을 만듭니다. WAF 및 경로와 연결된 사용자 지정 및 관리 규칙, cdn 경로, 원본 및 그룹을 사용하여 WAF를 만들고, 사용자 지정 도메인을 구성하고, 이벤트 허브를 만들고, 이벤트 허브를 사용하여 CDN 액세스 로그를 보내기 위한 진단 설정을 만듭니다. |
|
Moesif API 분석 및 수익 창출 Azure 배포 |
템플릿은 Azure API Management에서 Moesif API 분석 및 수익 창출 플랫폼으로 API 호출을 기록합니다. |
| Azure Event Hubs 대한 pubNub Realtime Gateway Azure |
Azure용 PubNub Realtime Gateway는 PubNub 데이터 스트림 네트워크와 Azure Event Hubs 간에 실시간 데이터 스트림 브리지를 제공합니다. -- PubNub와 Azure 사이의 양방향 브리지라고 생각해 보세요! |
리소스 형식
Microsoft.EventHub/namespaces 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.
{
"type": "Microsoft.EventHub/namespaces",
"apiVersion": "2024-05-01-preview",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"properties": {
"alternateName": "string",
"clusterArmId": "string",
"disableLocalAuth": "bool",
"encryption": {
"keySource": "Microsoft.KeyVault",
"keyVaultProperties": [
{
"identity": {
"userAssignedIdentity": "string"
},
"keyName": "string",
"keyVaultUri": "string",
"keyVersion": "string"
}
],
"requireInfrastructureEncryption": "bool"
},
"geoDataReplication": {
"locations": [
{
"clusterArmId": "string",
"locationName": "string",
"roleType": "string"
}
],
"maxReplicationLagDurationInSeconds": "int"
},
"isAutoInflateEnabled": "bool",
"kafkaEnabled": "bool",
"maximumThroughputUnits": "int",
"minimumTlsVersion": "string",
"privateEndpointConnections": [
{
"properties": {
"privateEndpoint": {
"id": "string"
},
"privateLinkServiceConnectionState": {
"description": "string",
"status": "string"
},
"provisioningState": "string"
}
}
],
"publicNetworkAccess": "string",
"zoneRedundant": "bool"
},
"sku": {
"capacity": "int",
"name": "string",
"tier": "string"
},
"tags": {
"{customized property}": "string"
}
}
속성 값
Microsoft.EventHub/namespaces
| Name | Description | Value |
|---|---|---|
| apiVersion | api 버전 | '2024-05-01-preview' |
| identity | BYOK ID 설명의 속성 | Identity |
| location | 리소스 위치입니다. | string |
| name | 리소스 이름 | string Constraints: 최소 길이 = 6 최대 길이 = 50 패턴 = ^[a-zA-Z][a-zA-Z0-9-]{6,50}[a-zA-Z0-9]$(필수) |
| properties | 네임스페이스 만들기 작업에 제공된 네임스페이스 속성입니다. | EHNamespaceProperties |
| sku | sku 리소스의 속성 | Sku |
| tags | 리소스 태그 | 태그 이름 및 값의 사전입니다. 템플릿 |
| type | 리소스 종류 | 'Microsoft.EventHub/namespaces' |
ConnectionState
| Name | Description | Value |
|---|---|---|
| description | 연결 상태에 대한 설명입니다. | string |
| status | 연결의 상태입니다. | 'Approved' 'Disconnected' 'Pending' 'Rejected' |
EHNamespaceProperties
| Name | Description | Value |
|---|---|---|
| alternateName | 별칭 및 네임스페이스 이름이 같을 때 지정된 대체 이름입니다. | string |
| clusterArmId | 네임스페이스의 클러스터 ARM ID입니다. | string |
| disableLocalAuth | 이 속성은 Event Hubs 네임스페이스에 대한 SAS 인증을 사용하지 않도록 설정합니다. | bool |
| encryption | BYOK 암호화 설명의 속성 | Encryption |
| geoDataReplication | 네임스페이스에 대한 지역 데이터 복제 설정 | GeoDataReplicationProperties |
| isAutoInflateEnabled | EventHub 네임스페이스에 대해 AutoInflate를 사용할 수 있는지 여부를 나타내는 값입니다. | bool |
| kafkaEnabled | Eventhub 네임스페이스에 대해 Kafka를 사용할 수 있는지 여부를 나타내는 값입니다. | bool |
| maximumThroughputUnits | AutoInflate를 사용하는 경우 처리량 단위의 상한값은 0~20개 처리량 단위 내에 있어야 합니다. (AutoInflateEnabled = true이면 '0') | int Constraints: 최소값 = 0 |
| minimumTlsVersion | 지원할 클러스터의 최소 TLS 버전(예: '1.2') | '1.0' '1.1' '1.2' |
| privateEndpointConnections | 프라이빗 엔드포인트 연결 목록입니다. | PrivateEndpointConnection[] |
| publicNetworkAccess | 이는 공용 네트워크를 통해 트래픽이 허용되는지 여부를 결정합니다. 기본적으로 사용하도록 설정됩니다. | 'Disabled' 'Enabled' 'SecuredByPerimeter' |
| zoneRedundant | 이 속성을 사용하도록 설정하면 지원되는 가용성 영역에 표준 Event Hubs 네임스페이스가 만들어집니다. | bool |
Encryption
| Name | Description | Value |
|---|---|---|
| keySource | 암호화에 대한 keySource의 가능한 값을 열거합니다. | 'Microsoft.KeyVault' |
| keyVaultProperties | KeyVault의 속성 | KeyVaultProperties[] |
| requireInfrastructureEncryption | 인프라 암호화 사용(이중 암호화) | bool |
GeoDataReplicationProperties
| Name | Description | Value |
|---|---|---|
| locations | 네임스페이스의 복제본이 유지 관리되는 지역 목록입니다. | NamespaceReplicaLocation[] |
| maxReplicationLagDurationInSeconds | 주 복제본에서 보조 복제본의 쿼럼까지의 데이터 복제 작업에 허용되는 최대 지연 시간입니다. 지연이 구성된 양을 초과하면 주 복제본에 대한 작업이 실패합니다. 허용되는 값은 0과 5분에서 1일입니다. | int |
Identity
| Name | Description | Value |
|---|---|---|
| type | 관리 서비스 ID의 유형입니다. | 'None' 'SystemAssigned' '시스템 할당, 사용자 할당' 'UserAssigned' |
| userAssignedIdentities | 사용자 할당 ID에 대한 속성 | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
| Name | Description | Value |
|---|
KeyVaultProperties
| Name | Description | Value |
|---|---|---|
| identity | UserAssignedIdentityProperties | |
| keyName | KeyVault의 키 이름 | string |
| keyVaultUri | KeyVault의 URI | string |
| keyVersion | 키 버전 | string |
NamespaceReplicaLocation
| Name | Description | Value |
|---|---|---|
| clusterArmId | 클러스터의 ARM ID를 나타내는 선택적 속성입니다. 네임스페이스 복제본을 전용 이벤트 허브 클러스터에 배치해야 하는 경우 필요합니다. | string |
| locationName | 네임스페이스의 복제본이 유지 관리되는 Azure 지역 | string |
| roleType | GeoDR 역할 유형 | 'Primary' 'Secondary' |
PrivateEndpoint
| Name | Description | Value |
|---|---|---|
| id | 프라이빗 엔드포인트의 ARM 식별자입니다. | string |
PrivateEndpointConnection
| Name | Description | Value |
|---|---|---|
| properties | PrivateEndpointConnection의 속성입니다. | PrivateEndpointConnectionProperties |
PrivateEndpointConnectionProperties
| Name | Description | Value |
|---|---|---|
| privateEndpoint | 이 연결에 대한 프라이빗 엔드포인트 리소스입니다. | PrivateEndpoint |
| privateLinkServiceConnectionState | 연결 상태에 대한 세부 정보입니다. | ConnectionState |
| provisioningState | 프라이빗 엔드포인트 연결의 프로비전 상태입니다. | 'Canceled' 'Creating' 'Deleting' 'Failed' 'Succeeded' 'Updating' |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | 기본 또는 표준 계층에 대한 Event Hubs 처리량 단위입니다. 여기서 값은 0~20개 처리량 단위여야 합니다. 프리미엄 계층에 대한 Event Hubs 프리미엄 단위입니다. 여기서 값은 0~10 프리미엄 단위여야 합니다. | int Constraints: 최소값 = 0 |
| name | 이 SKU의 이름입니다. | 'Basic' 'Premium' 'Standard'(필수) |
| tier | 이 특정 SKU의 청구 계층입니다. | 'Basic' 'Premium' 'Standard' |
TrackedResourceTags
| Name | Description | Value |
|---|
UserAssignedIdentity
| Name | Description | Value |
|---|
UserAssignedIdentityProperties
| Name | Description | Value |
|---|---|---|
| userAssignedIdentity | 암호화를 위해 선택된 사용자 ID의 ARM ID | string |
Terraform(AzAPI 공급자) 리소스 정의
네임스페이스 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 자원 그룹 각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
사용 예제
Terraform 샘플
EventHub 네임스페이스 배포의 기본 예제입니다.
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westeurope"
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "namespace" {
type = "Microsoft.EventHub/namespaces@2022-01-01-preview"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
body = {
properties = {
disableLocalAuth = false
isAutoInflateEnabled = false
publicNetworkAccess = "Enabled"
zoneRedundant = false
}
sku = {
capacity = 1
name = "Standard"
tier = "Standard"
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
Azure 확인된 모듈
다음 Azure 확인된 모듈 사용하여 이 리소스 유형을 배포할 수 있습니다.
| Module | Description |
|---|---|
| Event Hub 네임스페이스 | 이벤트 허브 네임스페이스에 대한 AVM 리소스 모듈 |
리소스 형식
Microsoft.EventHub/네임스페이스 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.EventHub/namespaces@2024-05-01-preview"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
alternateName = "string"
clusterArmId = "string"
disableLocalAuth = bool
encryption = {
keySource = "Microsoft.KeyVault"
keyVaultProperties = [
{
identity = {
userAssignedIdentity = "string"
}
keyName = "string"
keyVaultUri = "string"
keyVersion = "string"
}
]
requireInfrastructureEncryption = bool
}
geoDataReplication = {
locations = [
{
clusterArmId = "string"
locationName = "string"
roleType = "string"
}
]
maxReplicationLagDurationInSeconds = int
}
isAutoInflateEnabled = bool
kafkaEnabled = bool
maximumThroughputUnits = int
minimumTlsVersion = "string"
privateEndpointConnections = [
{
properties = {
privateEndpoint = {
id = "string"
}
privateLinkServiceConnectionState = {
description = "string"
status = "string"
}
provisioningState = "string"
}
}
]
publicNetworkAccess = "string"
zoneRedundant = bool
}
sku = {
capacity = int
name = "string"
tier = "string"
}
}
}
속성 값
Microsoft.EventHub/namespaces
| Name | Description | Value |
|---|---|---|
| identity | BYOK ID 설명의 속성 | Identity |
| location | 리소스 위치입니다. | string |
| name | 리소스 이름 | string Constraints: 최소 길이 = 6 최대 길이 = 50 패턴 = ^[a-zA-Z][a-zA-Z0-9-]{6,50}[a-zA-Z0-9]$(필수) |
| properties | 네임스페이스 만들기 작업에 제공된 네임스페이스 속성입니다. | EHNamespaceProperties |
| sku | sku 리소스의 속성 | Sku |
| tags | 리소스 태그 | 태그 이름 및 값의 사전입니다. |
| type | 리소스 종류 | "Microsoft.EventHub/namespaces@2024-05-01-preview" |
ConnectionState
| Name | Description | Value |
|---|---|---|
| description | 연결 상태에 대한 설명입니다. | string |
| status | 연결의 상태입니다. | 'Approved' 'Disconnected' 'Pending' 'Rejected' |
EHNamespaceProperties
| Name | Description | Value |
|---|---|---|
| alternateName | 별칭 및 네임스페이스 이름이 같을 때 지정된 대체 이름입니다. | string |
| clusterArmId | 네임스페이스의 클러스터 ARM ID입니다. | string |
| disableLocalAuth | 이 속성은 Event Hubs 네임스페이스에 대한 SAS 인증을 사용하지 않도록 설정합니다. | bool |
| encryption | BYOK 암호화 설명의 속성 | Encryption |
| geoDataReplication | 네임스페이스에 대한 지역 데이터 복제 설정 | GeoDataReplicationProperties |
| isAutoInflateEnabled | EventHub 네임스페이스에 대해 AutoInflate를 사용할 수 있는지 여부를 나타내는 값입니다. | bool |
| kafkaEnabled | Eventhub 네임스페이스에 대해 Kafka를 사용할 수 있는지 여부를 나타내는 값입니다. | bool |
| maximumThroughputUnits | AutoInflate를 사용하는 경우 처리량 단위의 상한값은 0~20개 처리량 단위 내에 있어야 합니다. (AutoInflateEnabled = true이면 '0') | int Constraints: 최소값 = 0 |
| minimumTlsVersion | 지원할 클러스터의 최소 TLS 버전(예: '1.2') | '1.0' '1.1' '1.2' |
| privateEndpointConnections | 프라이빗 엔드포인트 연결 목록입니다. | PrivateEndpointConnection[] |
| publicNetworkAccess | 이는 공용 네트워크를 통해 트래픽이 허용되는지 여부를 결정합니다. 기본적으로 사용하도록 설정됩니다. | 'Disabled' 'Enabled' 'SecuredByPerimeter' |
| zoneRedundant | 이 속성을 사용하도록 설정하면 지원되는 가용성 영역에 표준 Event Hubs 네임스페이스가 만들어집니다. | bool |
Encryption
| Name | Description | Value |
|---|---|---|
| keySource | 암호화에 대한 keySource의 가능한 값을 열거합니다. | 'Microsoft.KeyVault' |
| keyVaultProperties | KeyVault의 속성 | KeyVaultProperties[] |
| requireInfrastructureEncryption | 인프라 암호화 사용(이중 암호화) | bool |
GeoDataReplicationProperties
| Name | Description | Value |
|---|---|---|
| locations | 네임스페이스의 복제본이 유지 관리되는 지역 목록입니다. | NamespaceReplicaLocation[] |
| maxReplicationLagDurationInSeconds | 주 복제본에서 보조 복제본의 쿼럼까지의 데이터 복제 작업에 허용되는 최대 지연 시간입니다. 지연이 구성된 양을 초과하면 주 복제본에 대한 작업이 실패합니다. 허용되는 값은 0과 5분에서 1일입니다. | int |
Identity
| Name | Description | Value |
|---|---|---|
| type | 관리 서비스 ID의 유형입니다. | 'None' 'SystemAssigned' '시스템 할당, 사용자 할당' 'UserAssigned' |
| userAssignedIdentities | 사용자 할당 ID에 대한 속성 | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
| Name | Description | Value |
|---|
KeyVaultProperties
| Name | Description | Value |
|---|---|---|
| identity | UserAssignedIdentityProperties | |
| keyName | KeyVault의 키 이름 | string |
| keyVaultUri | KeyVault의 URI | string |
| keyVersion | 키 버전 | string |
NamespaceReplicaLocation
| Name | Description | Value |
|---|---|---|
| clusterArmId | 클러스터의 ARM ID를 나타내는 선택적 속성입니다. 네임스페이스 복제본을 전용 이벤트 허브 클러스터에 배치해야 하는 경우 필요합니다. | string |
| locationName | 네임스페이스의 복제본이 유지 관리되는 Azure 지역 | string |
| roleType | GeoDR 역할 유형 | 'Primary' 'Secondary' |
PrivateEndpoint
| Name | Description | Value |
|---|---|---|
| id | 프라이빗 엔드포인트의 ARM 식별자입니다. | string |
PrivateEndpointConnection
| Name | Description | Value |
|---|---|---|
| properties | PrivateEndpointConnection의 속성입니다. | PrivateEndpointConnectionProperties |
PrivateEndpointConnectionProperties
| Name | Description | Value |
|---|---|---|
| privateEndpoint | 이 연결에 대한 프라이빗 엔드포인트 리소스입니다. | PrivateEndpoint |
| privateLinkServiceConnectionState | 연결 상태에 대한 세부 정보입니다. | ConnectionState |
| provisioningState | 프라이빗 엔드포인트 연결의 프로비전 상태입니다. | 'Canceled' 'Creating' 'Deleting' 'Failed' 'Succeeded' 'Updating' |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | 기본 또는 표준 계층에 대한 Event Hubs 처리량 단위입니다. 여기서 값은 0~20개 처리량 단위여야 합니다. 프리미엄 계층에 대한 Event Hubs 프리미엄 단위입니다. 여기서 값은 0~10 프리미엄 단위여야 합니다. | int Constraints: 최소값 = 0 |
| name | 이 SKU의 이름입니다. | 'Basic' 'Premium' 'Standard'(필수) |
| tier | 이 특정 SKU의 청구 계층입니다. | 'Basic' 'Premium' 'Standard' |
TrackedResourceTags
| Name | Description | Value |
|---|
UserAssignedIdentity
| Name | Description | Value |
|---|
UserAssignedIdentityProperties
| Name | Description | Value |
|---|---|---|
| userAssignedIdentity | 암호화를 위해 선택된 사용자 ID의 ARM ID | string |