Microsoft.EventHub 네임스페이스/eventhubs

• 최신
• 2024-01-01
• 2023-01-01-preview
• 2022-10-01-preview
• 2022-01-01-preview
• 2021-11-01
• 2021-06-01-preview
• 2021-01-01-preview
• 2018-01-01-preview
• 2017-04-01
• 2015-08-01
• 2014-09-01

Bicep 리소스 정의

네임스페이스/eventhubs 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

• 리소스 그룹 - 리소스 그룹 배포 명령 참조

각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

리소스 형식

Microsoft.EventHub/namespaces/eventhubs 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.EventHub/namespaces/eventhubs@2024-01-01' = {
  name: 'string'
  parent: resourceSymbolicName
  properties: {
    captureDescription: {
      destination: {
        identity: {
          type: 'string'
          userAssignedIdentity: 'string'
        }
        name: 'string'
        properties: {
          archiveNameFormat: 'string'
          blobContainer: 'string'
          dataLakeAccountName: 'string'
          dataLakeFolderPath: 'string'
          dataLakeSubscriptionId: 'string'
          storageAccountResourceId: 'string'
        }
      }
      enabled: bool
      encoding: 'string'
      intervalInSeconds: int
      sizeLimitInBytes: int
      skipEmptyArchives: bool
    }
    messageRetentionInDays: int
    partitionCount: int
    retentionDescription: {
      cleanupPolicy: 'string'
      retentionTimeInHours: int
      tombstoneRetentionTimeInHours: int
    }
    status: 'string'
  }
}

속성 값

namespaces/eventhubs

Name	Description	값
name	리소스 이름 Bicep에서 자식 리소스의 이름과 형식을 설정하는 방법을 참조하세요.	string(필수) 문자 제한: 1-256 유효한 문자: 영숫자, 마침표, 하이픈 및 밑줄 문자 또는 숫자로 시작하고 끝나야 합니다.
부모(parent)	Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가하면 됩니다. 자세한 내용은 부모 리소스 외부의 자식 리소스를 참조하세요.	형식의 리소스에 대한 기호 이름: 네임스페이스
properties	이벤트 허브 만들기 또는 업데이트 작업에 제공된 속성입니다.	EventhubProperties

EventhubProperties

Name	Description	값
captureDescription	캡처 설명의 속성	CaptureDescription
messageRetentionInDays	이 이벤트 허브에 대한 이벤트를 보존할 일 수이며 값은 1~7일이어야 합니다.	int 제약 조건: 최소값 = 1
partitionCount	이벤트 허브에 대해 만들어진 파티션의 수, 허용되는 값은 1~32개 파티션입니다.	int 제약 조건: 최소값 = 1
retentionDescription	이벤트 허브 보존 설정	RetentionDescription
상태	이벤트 허브의 상태 가능한 값을 열거합니다.	'활성' '만들기' '삭제 중' '사용 안 함' 'ReceiveDisabled' '이름 바꾸기' '복원 중' 'SendDisabled' '알 수 없음'

CaptureDescription

Name	Description	값
destination	캡처가 저장될 대상의 속성입니다. (스토리지 계정, Blob 이름)	대상
사용	캡처 설명을 사용할 수 있는지 여부를 나타내는 값입니다.	bool
encoding	캡처 설명의 인코딩 형식에 대해 가능한 값을 열거합니다. 참고: 'AvroDeflate'는 새 API 버전에서 더 이상 사용되지 않습니다.	'Avro' 'AvroDeflate'
intervalInSeconds	시간 창을 사용하면 캡처가 Azure Blob으로 발생하는 빈도를 설정할 수 있습니다. 값은 60~900초 사이여야 합니다.	int
sizeLimitInBytes	크기 창은 캡처 작업 전에 Event Hub에 빌드된 데이터의 양을 정의합니다. 값은 10485760~524288000 바이트 사이여야 합니다.	int
skipEmptyArchives	빈 보관을 건너뛸지 여부를 나타내는 값입니다.	bool

대상

이름	Description	값
identity	캡처 설명을 사용할 수 있는지 여부를 나타내는 값입니다.	CaptureIdentity
name	캡처 대상의 이름	문자열
properties	캡처 대상에 대한 스토리지 계정, Blob 컨테이너 및 보관 이름 형식을 설명하는 속성	DestinationProperties

CaptureIdentity

Name	Description	값
형식	Azure Active Directory 관리 ID 유형입니다.	'SystemAssigned' 'UserAssigned'
userAssignedIdentity	관리되는 사용자 ID의 ARM ID입니다. 이 속성은 UserAssignedIdentity 형식이 필요합니다. Type이 SystemAssigned이면 네임스페이스와 연결된 시스템 할당 ID가 사용됩니다.	문자열

DestinationProperties

Name	Description	값
archiveNameFormat	보관을 위한 Blob 명명 규칙(예: {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}). 여기서 모든 매개 변수(네임스페이스, EventHub 등)는 순서에 관계없이 필수입니다.	문자열
blobContainer	Blob 컨테이너 이름	string
dataLakeAccountName	캡처된 이벤트의 Azure Data Lake Store 이름	문자열
dataLakeFolderPath	캡처된 이벤트의 대상 폴더 경로	문자열
dataLakeSubscriptionId	Azure Data Lake Store의 구독 ID	문자열 제약 조건: 최소 길이 = 36 최대 길이 = 36 패턴 = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
storageAccountResourceId	Blob을 만드는 데 사용할 스토리지 계정의 리소스 ID	문자열

RetentionDescription

Name	Description	값
cleanupPolicy	정리 정책에 사용할 수 있는 값을 열거합니다.	'Compact' 'Delete'
retentionTimeInHours	이 이벤트 허브에 대한 이벤트를 보존하는 데 소요되는 시간입니다. 이 값은 cleanupPolicy가 Delete인 경우에만 사용됩니다. cleanupPolicy가 Compact이면 이 속성의 반환된 값은 Long.MaxValue입니다.	int
tombstoneRetentionTimeInHours	압축된 이벤트 허브의 삭제 표시 표식을 유지하는 데 소요되는 시간입니다. 이 값은 cleanupPolicy가 Compact인 경우에만 사용됩니다. 소비자는 압축된 이벤트 허브 내에서 삭제 표시 표식에 설명된 특정 키에 대한 유효한 스냅샷 가져오기 위해 시작 오프셋에서 시작하는 경우 지정된 시간 내에 삭제 표시 표식 읽기를 완료해야 합니다.	int

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 종류를 배포합니다.

템플릿	Description
pubNub realtime Gateway for Azure Event Hubs	Azure용 PubNub Realtime Gateway는 PubNub Data Stream Network와 Azure Event Hubs 간에 실시간 데이터 스트림 브리지를 제공합니다. -- PubNub와 Azure 사이의 양방향 브리지라고 생각하세요!
Azure 아키텍처에 스포츠 분석 배포	ADLS Gen 2가 사용하도록 설정된 Azure Storage 계정, 스토리지 계정에 연결된 서비스(배포된 경우 Azure SQL 데이터베이스) Azure Data Factory instance 및 Azure Databricks instance 만듭니다. 템플릿을 배포하는 사용자의 AAD ID와 ADF instance 대한 관리 ID에는 스토리지 계정에 대한 Storage Blob 데이터 기여자 역할이 부여됩니다. Azure Key Vault instance, Azure SQL Database 및 Azure Event Hub(스트리밍 사용 사례용)를 배포하는 옵션도 있습니다. Azure Key Vault 배포되면 템플릿을 배포하는 사용자의 데이터 팩터리 관리 ID 및 AAD ID에 Key Vault 비밀 사용자 역할이 부여됩니다.
Moesif API 분석 및 수익 창출	템플릿은 Azure API Management Moesif API 분석 및 수익 창출 플랫폼으로 API 호출을 기록합니다.
시간 데이터 기록 연결이 있는 Azure Digital Twins	이 템플릿은 시계열 데이터 기록 연결로 구성된 Azure Digital Twins instance 만듭니다. 연결을 만들려면 Event Hubs 네임스페이스, 이벤트 허브, Azure Data Explorer 클러스터 및 데이터베이스와 같은 다른 리소스를 만들어야 합니다. 데이터는 이벤트 허브로 전송되어 결국 Azure Data Explorer 클러스터에 데이터를 전달합니다. 데이터는 클러스터의 데이터베이스 테이블에 저장됩니다.
Event Grid 사용자 지정 토픽 및 이벤트 허브 처리기 만들기	이벤트를 처리하는 Azure Event Grid 사용자 지정 토픽 및 이벤트 허브를 만듭니다.
EventHubs 네임스페이스, Event Hub & 소비자 그룹 만들기	이 템플릿을 사용하면 Event Hubs 표준 네임스페이스, 이벤트 허브 및 소비자 그룹을 배포할 수 있습니다.
EventHubs authorizationRules 만들기	이 템플릿을 사용하면 EventHubs 표준 네임스페이스, Event Hub, 소비자 그룹 및 authorizationRules를 배포할 수 있습니다.
Eventhub 클러스터를 만들고, eventhub에 이름을 &.	이 템플릿을 사용하면 클러스터에서 EventHubs 클러스터, 네임스페이스 및 eventhub를 만들 수 있습니다.
캡처를 사용하도록 설정된 EventHubs 만들기	이 템플릿을 사용하면 이벤트 허브를 사용하여 EventHubs 네임스페이스를 배포하고 캡처를 사용하도록 설정할 수 있습니다.
캡처를 사용하도록 설정된 EventHubs 만들기(ADLS)	이 템플릿을 사용하면 이벤트 허브를 사용하여 EventHubs 네임스페이스를 배포하고 캡처를 사용하도록 설정할 수 있습니다.
EventHubs 네임스페이스 만들기 및 자동 확장 사용	이 템플릿을 사용하면 Event Hubs 표준 네임스페이스, 이벤트 허브 및 소비자 그룹을 배포할 수 있습니다. 또한 이 템플릿은 네임스페이스에서 자동 팽창 기능을 켭니다.
이벤트 허브 만들기	이 템플릿을 사용하면 이벤트 허브를 사용하여 EventHubs 네임스페이스를 배포할 수 있습니다.
프라이빗 엔드포인트를 통해 Event Hubs 네임스페이스에 연결	이 샘플에서는 가상 네트워크 및 프라이빗 DNS 영역 구성을 사용하여 프라이빗 엔드포인트를 통해 Event Hubs 네임스페이스에 액세스하는 방법을 보여 줍니다.
MedTech 서비스 배포	MedTech 서비스는 여러 디바이스에서 디바이스 데이터를 수집하여 디바이스 데이터를 FHIR 관찰로 변환한 다음 Azure Health Data Services FHIR 서비스에 유지되도록 설계된 Azure Health Data Services 중 하나입니다.
Azure IoT Hub 포함하여 MedTech 서비스 배포	MedTech 서비스는 여러 디바이스에서 디바이스 데이터를 수집하여 디바이스 데이터를 FHIR 관찰로 변환한 다음 Azure Health Data Services FHIR 서비스에 유지되도록 설계된 Azure Health Data Services 중 하나입니다.
Event Hub 연결을 사용하여 Azure Data Explorer db 배포	Event Hub 연결을 사용하여 Azure Data Explorer db를 배포합니다.
이벤트 허브에 기록된 감사가 있는 Azure SQL 서버	이 템플릿을 사용하면 감사가 사용하도록 설정된 Azure SQL 서버를 배포하여 이벤트 허브에 감사 로그를 쓸 수 있습니다.
구성된 로그 및 메트릭 전송을 사용하여 SQL MI 만들기	이 템플릿을 사용하면 SQL MI 및 로그 및 메트릭(진단 작업 영역, 스토리지 계정, 이벤트 허브)을 저장하는 데 사용되는 추가 리소스를 배포할 수 있습니다.
이벤트 허브 이벤트 원본을 사용하여 환경 만들기	이 템플릿을 사용하면 이벤트 허브의 이벤트를 사용하도록 구성된 Time Series Insights 환경을 배포할 수 있습니다.
이벤트 허브 및 관리 ID를 사용하여 Azure Function App	템플릿은 Event Hub, Azure Storage 및 Application Insights와 함께 Linux 소비 계획에 Azure Function 앱을 프로비전합니다. 함수 앱은 관리 ID를 사용하여 이벤트 허브 및 스토리지 계정에 연결할 수 있습니다.

ARM 템플릿 리소스 정의

네임스페이스/eventhubs 리소스 종류는 다음을 대상으로 하는 작업을 사용하여 배포할 수 있습니다.

• 리소스 그룹 - 리소스 그룹 배포 명령을 참조하세요.

각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

리소스 형식

Microsoft.EventHub/namespaces/eventhubs 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.EventHub/namespaces/eventhubs",
  "apiVersion": "2024-01-01",
  "name": "string",
  "properties": {
    "captureDescription": {
      "destination": {
        "identity": {
          "type": "string",
          "userAssignedIdentity": "string"
        },
        "name": "string",
        "properties": {
          "archiveNameFormat": "string",
          "blobContainer": "string",
          "dataLakeAccountName": "string",
          "dataLakeFolderPath": "string",
          "dataLakeSubscriptionId": "string",
          "storageAccountResourceId": "string"
        }
      },
      "enabled": "bool",
      "encoding": "string",
      "intervalInSeconds": "int",
      "sizeLimitInBytes": "int",
      "skipEmptyArchives": "bool"
    },
    "messageRetentionInDays": "int",
    "partitionCount": "int",
    "retentionDescription": {
      "cleanupPolicy": "string",
      "retentionTimeInHours": "int",
      "tombstoneRetentionTimeInHours": "int"
    },
    "status": "string"
  }
}

속성 값

namespaces/eventhubs

Name	Description	값
형식	리소스 종류	'Microsoft.EventHub/namespaces/eventhubs'
apiVersion	리소스 api 버전	'2024-01-01'
name	리소스 이름 JSON ARM 템플릿에서 자식 리소스의 이름 및 형식을 설정하는 방법을 참조하세요.	string(필수) 문자 제한: 1-256 유효한 문자: 영숫자, 마침표, 하이픈 및 밑줄 문자 또는 숫자로 시작하고 끝나야 합니다.
properties	이벤트 허브 만들기 또는 업데이트 작업에 제공된 속성입니다.	EventhubProperties

EventhubProperties

Name	Description	값
captureDescription	캡처 설명의 속성	CaptureDescription
messageRetentionInDays	이 이벤트 허브에 대한 이벤트를 보존할 일 수이며 값은 1~7일이어야 합니다.	int 제약 조건: 최소값 = 1
partitionCount	이벤트 허브에 대해 만들어진 파티션의 수, 허용되는 값은 1~32개 파티션입니다.	int 제약 조건: 최소값 = 1
retentionDescription	이벤트 허브 보존 설정	RetentionDescription
상태	이벤트 허브의 상태 가능한 값을 열거합니다.	'활성' '만들기' '삭제 중' 'Disabled' 'ReceiveDisabled' '이름 바꾸기' '복원 중' 'SendDisabled' '알 수 없음'

CaptureDescription

Name	Description	값
destination	캡처가 저장될 대상의 속성입니다. (스토리지 계정, Blob 이름)	대상
사용	캡처 설명을 사용할 수 있는지 여부를 나타내는 값입니다.	bool
encoding	캡처 설명의 인코딩 형식에 대해 가능한 값을 열거합니다. 참고: 'AvroDeflate'는 새 API 버전에서 더 이상 사용되지 않습니다.	'Avro' 'AvroDeflate'
intervalInSeconds	시간 창을 사용하면 캡처가 Azure Blob으로 발생하는 빈도를 설정할 수 있습니다. 값은 60~900초 사이여야 합니다.	int
sizeLimitInBytes	크기 창은 캡처 작업 전에 Event Hub에 빌드된 데이터의 양을 정의합니다. 값은 10485760~524288000 바이트 사이여야 합니다.	int
skipEmptyArchives	빈 보관을 건너뛸지 여부를 나타내는 값입니다.	bool

대상

이름	Description	값
identity	캡처 설명을 사용할 수 있는지 여부를 나타내는 값입니다.	CaptureIdentity
name	캡처 대상의 이름	문자열
properties	캡처 대상에 대한 스토리지 계정, Blob 컨테이너 및 보관 이름 형식을 설명하는 속성	DestinationProperties

CaptureIdentity

Name	Description	값
형식	Azure Active Directory 관리 ID 유형입니다.	'SystemAssigned' 'UserAssigned'
userAssignedIdentity	관리되는 사용자 ID의 ARM ID입니다. 이 속성은 UserAssignedIdentity 형식이 필요합니다. SystemAssigned 형식이면 네임스페이스와 연결된 시스템 할당 ID가 사용됩니다.	문자열

DestinationProperties

Name	Description	값
archiveNameFormat	보관에 대한 Blob 명명 규칙(예: {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}). 여기서 모든 매개 변수(네임스페이스, EventHub 등)는 순서에 관계없이 필수입니다.	string
blobContainer	Blob 컨테이너 이름	문자열
dataLakeAccountName	캡처된 이벤트의 Azure Data Lake Store 이름	string
dataLakeFolderPath	캡처된 이벤트의 대상 폴더 경로	string
dataLakeSubscriptionId	Azure Data Lake Store의 구독 ID	string 제약 조건: 최소 길이 = 36 최대 길이 = 36 패턴 = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
storageAccountResourceId	Blob을 만드는 데 사용할 스토리지 계정의 리소스 ID	문자열

RetentionDescription

Name	Description	값
cleanupPolicy	정리 정책에 사용할 수 있는 값을 열거합니다.	'Compact' '삭제'
retentionTimeInHours	이 이벤트 허브에 대한 이벤트를 보존하는 데 소요되는 시간입니다. 이 값은 cleanupPolicy가 Delete인 경우에만 사용됩니다. cleanupPolicy가 Compact이면 이 속성의 반환 값이 Long.MaxValue입니다.	int
tombstoneRetentionTimeInHours	압축된 이벤트 허브의 삭제 표시 마커를 유지하는 데 소요되는 시간입니다. 이 값은 cleanupPolicy가 Compact인 경우에만 사용됩니다. 소비자는 소비자가 오프셋 시작부터 시작하는 경우 이 지정된 시간 내에 삭제 표시 표식 읽기를 완료하여 압축된 이벤트 허브 내의 삭제 표시 마커에 설명된 특정 키에 대한 유효한 스냅샷 가져와야 합니다.	int

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.

템플릿	Description
pubNub Realtime Gateway for Azure Event Hubs	Azure용 PubNub Realtime Gateway는 PubNub Data Stream Network와 Azure Event Hubs 간에 실시간 데이터 스트림 브리지를 제공합니다. -- PubNub와 Azure 사이의 양방향 브리지라고 생각해 보세요!
Azure 아키텍처에 Sports Analytics 배포	ADLS Gen 2가 사용하도록 설정된 Azure Storage 계정, 스토리지 계정에 대한 연결된 서비스(배포된 경우 Azure SQL 데이터베이스) Azure Data Factory instance 및 Azure Databricks instance 만듭니다. 템플릿을 배포하는 사용자의 AAD ID와 ADF instance 대한 관리 ID에는 스토리지 계정에 대한 Storage Blob 데이터 기여자 역할이 부여됩니다. Azure Key Vault instance, Azure SQL Database 및 Azure Event Hub(스트리밍 사용 사례용)를 배포하는 옵션도 있습니다. Azure Key Vault 배포되면 템플릿을 배포하는 사용자의 데이터 팩터리 관리 ID 및 AAD ID에 Key Vault 비밀 사용자 역할이 부여됩니다.
Moesif API 분석 및 수익 창출	템플릿은 Azure API Management Moesif API 분석 및 수익 창출 플랫폼으로 API 호출을 기록합니다.
시간 데이터 기록 연결이 있는 Azure Digital Twins	이 템플릿은 시계열 데이터 기록 연결로 구성된 Azure Digital Twins instance 만듭니다. 연결을 만들려면 Event Hubs 네임스페이스, 이벤트 허브, Azure Data Explorer 클러스터 및 데이터베이스와 같은 다른 리소스를 만들어야 합니다. 데이터는 결국 Azure Data Explorer 클러스터에 데이터를 전달하는 이벤트 허브로 전송됩니다. 데이터는 클러스터의 데이터베이스 테이블에 저장됩니다.
Event Grid 사용자 지정 토픽 및 이벤트 허브 처리기 만들기	이벤트를 처리할 Azure Event Grid 사용자 지정 토픽 및 이벤트 허브를 만듭니다.
EventHubs 네임스페이스, Event Hub & 소비자 그룹 만들기	이 템플릿을 사용하면 Event Hubs 표준 네임스페이스, 이벤트 허브 및 소비자 그룹을 배포할 수 있습니다.
EventHubs authorizationRules 만들기	이 템플릿을 사용하면 EventHubs 표준 네임스페이스, Event Hub, 소비자 그룹 및 authorizationRules를 배포할 수 있습니다.
Eventhub 클러스터, nameapce & eventhub를 만듭니다.	이 템플릿을 사용하면 클러스터에서 EventHubs 클러스터, 네임스페이스 및 eventhub를 만들 수 있습니다.
캡처를 사용하도록 설정된 EventHubs 만들기	이 템플릿을 사용하면 이벤트 허브를 사용하여 EventHubs 네임스페이스를 배포하고 캡처를 사용하도록 설정할 수 있습니다.
캡처를 사용하도록 설정된 EventHubs 만들기(ADLS)	이 템플릿을 사용하면 이벤트 허브를 사용하여 EventHubs 네임스페이스를 배포하고 캡처를 사용하도록 설정할 수 있습니다.
EventHubs 네임스페이스 만들기 및 자동 확장 사용	이 템플릿을 사용하면 Event Hubs 표준 네임스페이스, 이벤트 허브 및 소비자 그룹을 배포할 수 있습니다. 또한 이 템플릿은 네임스페이스에서 자동 팽창 기능을 켭니다.
이벤트 허브 만들기	이 템플릿을 사용하면 이벤트 허브를 사용하여 EventHubs 네임스페이스를 배포할 수 있습니다.
프라이빗 엔드포인트를 통해 Event Hubs 네임스페이스에 연결	이 샘플에서는 가상 네트워크 및 프라이빗 DNS 영역 구성을 사용하여 프라이빗 엔드포인트를 통해 Event Hubs 네임스페이스에 액세스하는 방법을 보여 줍니다.
MedTech 서비스 배포	MedTech 서비스는 여러 디바이스에서 디바이스 데이터를 수집하여 디바이스 데이터를 FHIR 관찰로 변환한 다음 Azure Health Data Services FHIR 서비스에 유지되도록 설계된 Azure Health Data Services 중 하나입니다.
Azure IoT Hub 포함하여 MedTech 서비스 배포	MedTech 서비스는 여러 디바이스에서 디바이스 데이터를 수집하여 디바이스 데이터를 FHIR 관찰로 변환한 다음 Azure Health Data Services FHIR 서비스에 유지되도록 설계된 Azure Health Data Services 중 하나입니다.
Event Hub 연결을 사용하여 Azure Data Explorer db 배포	Event Hub 연결을 사용하여 Azure Data Explorer db를 배포합니다.
Event Hub에 기록된 감사가 있는 Azure SQL 서버	이 템플릿을 사용하면 감사가 사용하도록 설정된 Azure SQL 서버를 배포하여 이벤트 허브에 감사 로그를 쓸 수 있습니다.
구성된 로그 및 메트릭 전송을 사용하여 SQL MI 만들기	이 템플릿을 사용하면 SQL MI 및 로그 및 메트릭(진단 작업 영역, 스토리지 계정, 이벤트 허브)을 저장하는 데 사용되는 추가 리소스를 배포할 수 있습니다.
이벤트 허브 이벤트 원본을 사용하여 환경 만들기	이 템플릿을 사용하면 이벤트 허브의 이벤트를 사용하도록 구성된 Time Series Insights 환경을 배포할 수 있습니다.
Event Hub 및 관리 ID를 사용하여 Azure Function App	템플릿은 Event Hub, Azure Storage 및 Application Insights와 함께 Linux 소비 계획에 Azure Function 앱을 프로비전합니다. 함수 앱은 관리 ID를 사용하여 이벤트 허브 및 스토리지 계정에 연결할 수 있습니다.

Terraform(AzAPI 공급자) 리소스 정의

네임스페이스/eventhubs 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

• 리소스 그룹

각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

리소스 형식

Microsoft.EventHub/namespaces/eventhubs 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.EventHub/namespaces/eventhubs@2024-01-01"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      captureDescription = {
        destination = {
          identity = {
            type = "string"
            userAssignedIdentity = "string"
          }
          name = "string"
          properties = {
            archiveNameFormat = "string"
            blobContainer = "string"
            dataLakeAccountName = "string"
            dataLakeFolderPath = "string"
            dataLakeSubscriptionId = "string"
            storageAccountResourceId = "string"
          }
        }
        enabled = bool
        encoding = "string"
        intervalInSeconds = int
        sizeLimitInBytes = int
        skipEmptyArchives = bool
      }
      messageRetentionInDays = int
      partitionCount = int
      retentionDescription = {
        cleanupPolicy = "string"
        retentionTimeInHours = int
        tombstoneRetentionTimeInHours = int
      }
      status = "string"
    }
  })
}

속성 값

namespaces/eventhubs

Name	Description	값
형식	리소스 종류	"Microsoft.EventHub/namespaces/eventhubs@2024-01-01"
name	리소스 이름	string(필수) 문자 제한: 1-256 유효한 문자: 영숫자, 마침표, 하이픈 및 밑줄 문자 또는 숫자로 시작하고 끝나야 합니다.
parent_id	이 리소스의 부모인 리소스의 ID입니다.	형식의 리소스에 대한 ID: 네임스페이스
properties	이벤트 허브 만들기 또는 업데이트 작업에 제공된 속성입니다.	EventhubProperties

EventhubProperties

Name	Description	값
captureDescription	캡처 설명의 속성	CaptureDescription
messageRetentionInDays	이 이벤트 허브에 대한 이벤트를 보존할 일 수이며 값은 1~7일이어야 합니다.	int 제약 조건: 최소값 = 1
partitionCount	이벤트 허브에 대해 만들어진 파티션의 수, 허용되는 값은 1~32개 파티션입니다.	int 제약 조건: 최소값 = 1
retentionDescription	이벤트 허브 보존 설정	RetentionDescription
상태	이벤트 허브의 상태 가능한 값을 열거합니다.	"활성" "만들기" "삭제 중" "사용 안 함" "ReceiveDisabled" "이름 바꾸기" "복원 중" "SendDisabled" "알 수 없음"

CaptureDescription

Name	Description	값
destination	캡처가 저장될 대상의 속성입니다. (스토리지 계정, Blob 이름)	대상
사용	캡처 설명을 사용할 수 있는지 여부를 나타내는 값입니다.	bool
encoding	캡처 설명의 인코딩 형식에 사용할 수 있는 값을 열거합니다. 참고: 'AvroDeflate'는 새 API 버전에서 더 이상 사용되지 않습니다.	"Avro" "AvroDeflate"
intervalInSeconds	시간 창을 사용하면 캡처가 Azure Blob으로 발생하는 빈도를 설정할 수 있습니다. 값은 60~900초 사이여야 합니다.	int
sizeLimitInBytes	크기 창은 캡처 작업 전에 Event Hub에 빌드된 데이터의 양을 정의합니다. 값은 10485760~524288000 바이트 사이여야 합니다.	int
skipEmptyArchives	빈 보관을 건너뛸지 여부를 나타내는 값입니다.	bool

대상

이름	Description	값
identity	캡처 설명을 사용할 수 있는지 여부를 나타내는 값입니다.	CaptureIdentity
name	캡처 대상의 이름	문자열
properties	캡처 대상에 대한 스토리지 계정, Blob 컨테이너 및 보관 이름 형식을 설명하는 속성	DestinationProperties

CaptureIdentity

Name	Description	값
형식	Azure Active Directory 관리 ID 유형입니다.	"SystemAssigned" "UserAssigned"
userAssignedIdentity	관리되는 사용자 ID의 ARM ID입니다. 이 속성은 UserAssignedIdentity 형식이 필요합니다. Type이 SystemAssigned이면 네임스페이스와 연결된 시스템 할당 ID가 사용됩니다.	문자열

DestinationProperties

Name	Description	값
archiveNameFormat	보관을 위한 Blob 명명 규칙(예: {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}). 여기서 모든 매개 변수(네임스페이스, EventHub 등)는 순서에 관계없이 필수입니다.	문자열
blobContainer	Blob 컨테이너 이름	string
dataLakeAccountName	캡처된 이벤트의 Azure Data Lake Store 이름	string
dataLakeFolderPath	캡처된 이벤트의 대상 폴더 경로	string
dataLakeSubscriptionId	Azure Data Lake Store의 구독 ID	문자열 제약 조건: 최소 길이 = 36 최대 길이 = 36 패턴 = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
storageAccountResourceId	Blob을 만드는 데 사용할 스토리지 계정의 리소스 ID	문자열

RetentionDescription

Name	Description	값
cleanupPolicy	정리 정책에 사용할 수 있는 값을 열거합니다.	"컴팩트" "Delete"
retentionTimeInHours	이 이벤트 허브에 대한 이벤트를 보존하는 데 소요되는 시간입니다. 이 값은 cleanupPolicy가 Delete인 경우에만 사용됩니다. cleanupPolicy가 Compact이면 이 속성의 반환 값이 Long.MaxValue입니다.	int
tombstoneRetentionTimeInHours	압축된 이벤트 허브의 삭제 표시 마커를 유지하는 데 소요되는 시간입니다. 이 값은 cleanupPolicy가 Compact인 경우에만 사용됩니다. 소비자는 소비자가 오프셋 시작부터 시작하는 경우 이 지정된 시간 내에 삭제 표시 표식 읽기를 완료하여 압축된 이벤트 허브 내의 삭제 표시 마커에 설명된 특정 키에 대한 유효한 스냅샷 가져와야 합니다.	int