Espacios de nombres Microsoft.EventHub/eventhubs 2024-01-01
Definición de recursos de Bicep
El tipo de recurso namespaces/eventhubs se puede implementar con operaciones que tienen como destino:
- grupos de recursos: consulte comandos de implementación de grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de recurso
Para crear un recurso Microsoft.EventHub/namespaces/eventhubs, agregue el siguiente bicep a la plantilla.
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'
}
}
Valores de propiedad
namespaces/eventhubs
| Nombre | Descripción | Valor |
|---|---|---|
| nombre | El nombre del recurso Vea cómo establecer nombres y tipos para recursos secundarios en Bicep. |
string (obligatorio) Límite de caracteres: 1-256 Caracteres válidos: Caracteres alfanuméricos, puntos, guiones y caracteres de subrayado. Comience y termine con letra o número. |
| padre | En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario. Para obtener más información, consulte recurso secundario fuera del recurso primario. |
Nombre simbólico del recurso de tipo: espacios de nombres |
| Propiedades | Propiedades proporcionadas a la operación Crear o actualizar centro de eventos. | EventhubProperties |
EventhubProperties
| Nombre | Descripción | Valor |
|---|---|---|
| captureDescription | Propiedades de la descripción de captura | CaptureDescription |
| messageRetentionInDays | Número de días para conservar los eventos de este centro de eventos, el valor debe ser de 1 a 7 días. | Int Restricciones: Valor mínimo = 1 |
| partitionCount | Número de particiones creadas para el centro de eventos, los valores permitidos son de 1 a 32 particiones. | Int Restricciones: Valor mínimo = 1 |
| retentionDescription | Configuración de retención del centro de eventos | RetentionDescription |
| estado | Enumera los valores posibles para el estado del centro de eventos. | 'Activo' 'Crear' "Eliminar" 'Deshabilitado' 'ReceiveDisabled' 'Cambiar el nombre' "Restaurar" 'SendDisabled' 'Desconocido' |
CaptureDescription
| Nombre | Descripción | Valor |
|---|---|---|
| destino | Propiedades del destino donde se almacenará la captura. (Cuenta de almacenamiento, nombres de blobs) | de destino de |
| Habilitado | Valor que indica si la descripción de captura está habilitada. | Bool |
| codificación | Enumera los valores posibles para el formato de codificación de la descripción de captura. Nota: "AvroDeflate" quedará en desuso en la nueva versión de LA API | 'Avro' 'AvroDeflate' |
| intervalInSeconds | El período de tiempo le permite establecer la frecuencia con la que se producirá la captura en blobs de Azure, el valor debe estar comprendido entre 60 y 900 segundos. | Int |
| sizeLimitInBytes | La ventana de tamaño define la cantidad de datos integrados en el centro de eventos antes de una operación de captura, el valor debe estar entre 10485760 a 524288000 bytes. | Int |
| skipEmptyArchives | Valor que indica si se omitirán los archivos vacíos. | Bool |
Destino
| Nombre | Descripción | Valor |
|---|---|---|
| identidad | Valor que indica si la descripción de captura está habilitada. | CaptureIdentity |
| nombre | Nombre del destino de captura | cuerda |
| Propiedades | Propiedades que describen la cuenta de almacenamiento, el contenedor de blobs y el formato de nombre de archivo para el destino de captura | DestinationProperties |
CaptureIdentity
| Nombre | Descripción | Valor |
|---|---|---|
| tipo | Tipo de identidad administrada de Azure Active Directory. | 'SystemAssigned' 'UserAssigned' |
| userAssignedIdentity | Id. de ARM de identidad de usuario administrado. Esta propiedad es necesaria es userAssignedIdentity. Si el tipo es SystemAssigned, se usará la identidad asignada por el sistema asociada al espacio de nombres. | cuerda |
DestinationProperties
| Nombre | Descripción | Valor |
|---|---|---|
| archiveNameFormat | Convención de nomenclatura de blobs para el archivo, por ejemplo, {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}. Aquí todos los parámetros (espacio de nombres, EventHub, etc.) son obligatorios independientemente del orden. | cuerda |
| blobContainer | Nombre del contenedor de blobs | cuerda |
| dataLakeAccountName | Nombre de Azure Data Lake Store para los eventos capturados | cuerda |
| dataLakeFolderPath | Ruta de acceso de la carpeta de destino para los eventos capturados | cuerda |
| dataLakeSubscriptionId | Identificador de suscripción de Azure Data Lake Store | cuerda Restricciones: Longitud mínima = 36 Longitud máxima = 36 Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| storageAccountResourceId | Identificador de recurso de la cuenta de almacenamiento que se va a usar para crear los blobs | cuerda |
RetentionDescription
| Nombre | Descripción | Valor |
|---|---|---|
| cleanupPolicy | Enumera los valores posibles para la directiva de limpieza | 'Compact' 'Eliminar' |
| retentionTimeInHours | Número de horas para conservar los eventos de este centro de eventos. Este valor solo se usa cuando cleanupPolicy es Delete. Si cleanupPolicy es Compact, el valor devuelto de esta propiedad es Long.MaxValue. | Int |
| tombstoneRetentionTimeInHours | Número de horas para conservar los marcadores de lápiz de un centro de eventos compacto. Este valor solo se usa cuando cleanupPolicy es Compact. El consumidor debe completar la lectura del marcador de lápiz dentro de esta cantidad de tiempo especificada si el consumidor comienza desde el desplazamiento inicial para asegurarse de que obtienen una instantánea válida para la clave específica descrita por el marcador de lápiz dentro del centro de eventos compactado. | Int |
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
| Plantilla | Descripción |
|---|---|
Puerta de enlace en tiempo real de PubNub para Azure Event Hubs
|
La puerta de enlace en tiempo real de PubNub para Azure proporciona un puente de flujo de datos en tiempo real entre pubNub Data Stream Network y Azure Event Hubs. -- considere un puente bidireccional entre PubNub y Azure. |
|
Implementación de Sports Analytics en la arquitectura de Azure
|
Crea una cuenta de Azure Storage con ADLS Gen 2 habilitado, una instancia de Azure Data Factory con servicios vinculados para la cuenta de almacenamiento (una instancia de Azure SQL Database si se implementa) y una instancia de Azure Databricks. AAD identity for the user deploying the template and the managed identity for the ADF instance will be granted the Storage Blob Data Contributor role on the storage account. También hay opciones para implementar una instancia de Azure Key Vault, una instancia de Azure SQL Database y un centro de eventos de Azure (para casos de uso de streaming). Cuando se implementa una instancia de Azure Key Vault, a la identidad administrada de Data Factory y a la identidad de AAD para el usuario que implementa la plantilla se le concederá el rol De usuario secretos de Key Vault. |
|
de monetización y análisis de API de Moesif
|
La plantilla registrará llamadas API desde Azure API Management a la plataforma de análisis y monetización de API de Moesif. |
|
Azure Digital Twins con la conexión del historial de datos de tiempo
|
Esta plantilla crea una instancia de Azure Digital Twins configurada con una conexión del historial de datos de serie temporal. Para crear una conexión, se deben crear otros recursos, como un espacio de nombres de Event Hubs, un centro de eventos, un clúster de Azure Data Explorer y una base de datos. Los datos se envían a un centro de eventos que eventualmente reenvía los datos al clúster de Azure Data Explorer. Los datos se almacenan en una tabla de base de datos del clúster |
|
creación de temas personalizados de Event Grid y del controlador del centro de eventos
|
Crea un tema personalizado de Azure Event Grid y un centro de eventos para controlar los eventos. |
|
Crear un espacio de nombres de EventHubs, centro de eventos & grupo de consumidores
|
Esta plantilla le permite implementar un espacio de nombres Estándar de Event Hubs, un centro de eventos y un grupo de consumidores. |
|
Crear autorización de EventHubsRules
|
Esta plantilla le permite implementar un espacio de nombres Estándar de EventHubs, un centro de eventos, un grupo de consumidores y authorizationRules. |
|
crea un clúster de Eventhub, namesapce & eventhub
|
Esta plantilla le permite crear un clúster de EventHubs, un espacio de nombres y un centro de eventos en el clúster. |
|
Crear EventHubs con habilitada para captura
|
Esta plantilla le permite implementar un espacio de nombres de EventHubs con un centro de eventos y habilitar Capture en él. |
|
Creación de EventHubs con de captura habilitada (ADLS)
|
Esta plantilla le permite implementar un espacio de nombres de EventHubs con un centro de eventos y habilitar Capture en él. |
|
Crear un espacio de nombres de EventHubs y habilitar de inflado automático
|
Esta plantilla le permite implementar un espacio de nombres Estándar de Event Hubs, un centro de eventos y un grupo de consumidores. Esta plantilla también activa la característica de inflado automático en el espacio de nombres. |
|
Crear un del centro de eventos
|
Esta plantilla permite implementar un espacio de nombres de EventHubs con un centro de eventos. |
|
Conectarse a un espacio de nombres de Event Hubs a través del punto de conexión privado
|
En este ejemplo se muestra cómo usar la configuración de una red virtual y una zona DNS privada para acceder a un espacio de nombres de Event Hubs a través de un punto de conexión privado. |
|
Implementación del servicio MedTech
|
El servicio MedTech es uno de los servicios de datos de Azure Health diseñados para ingerir datos de dispositivo de varios dispositivos, transformar los datos del dispositivo en observaciones de FHIR, que luego se conservan en el servicio FHIR de Azure Health Data Services. |
|
Implementación del servicio MedTech, incluido un de Azure IoT Hub
|
El servicio MedTech es uno de los servicios de datos de Azure Health diseñados para ingerir datos de dispositivo de varios dispositivos, transformar los datos del dispositivo en observaciones de FHIR, que luego se conservan en el servicio FHIR de Azure Health Data Services. |
|
implementación de la base de datos de Azure Data Explorer con de conexión de Event Grid
|
Implemente la base de datos de Azure Data Explorer con la conexión de Event Grid. |
|
Implementación de la base de datos de Azure Data Explorer con de conexión del centro de eventos
|
Implemente la base de datos de Azure Data Explorer con la conexión del centro de eventos. |
|
Azure SQL Server con auditoría escrita en Event Hubs
|
Esta plantilla le permite implementar un servidor de Azure SQL server con auditoría habilitado para escribir registros de auditoría en el centro de eventos. |
|
Crear MI de SQL con el envío configurado de registros y métricas
|
Esta plantilla le permite implementar SQL MI y recursos adicionales que se usan para almacenar registros y métricas (área de trabajo de diagnóstico, cuenta de almacenamiento, centro de eventos). |
|
Crear un entorno con un origen de eventos del centro de eventos
|
Esta plantilla permite implementar un entorno de Time Series Insights configurado para consumir eventos de un centro de eventos. |
|
Aplicación de funciones de Azure con event Hubs e identidad administrada
|
su plantilla aprovisiona una aplicación de funciones de Azure en un plan de consumo de Linux, junto con un centro de eventos, Azure Storage y Application Insights. La aplicación de funciones puede usar la identidad administrada para conectarse al centro de eventos y a la cuenta de almacenamiento. |
Definición de recursos de plantilla de ARM
El tipo de recurso namespaces/eventhubs se puede implementar con operaciones que tienen como destino:
- grupos de recursos: consulte comandos de implementación de grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de recurso
Para crear un recurso Microsoft.EventHub/namespaces/eventhubs, agregue el siguiente JSON a la plantilla.
{
"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"
}
}
Valores de propiedad
namespaces/eventhubs
| Nombre | Descripción | Valor |
|---|---|---|
| tipo | El tipo de recurso | 'Microsoft.EventHub/namespaces/eventhubs' |
| apiVersion | La versión de la API de recursos | '2024-01-01' |
| nombre | El nombre del recurso Vea cómo establecer nombres y tipos para recursos secundarios en plantillas de ARM json. |
string (obligatorio) Límite de caracteres: 1-256 Caracteres válidos: Caracteres alfanuméricos, puntos, guiones y caracteres de subrayado. Comience y termine con letra o número. |
| Propiedades | Propiedades proporcionadas a la operación Crear o actualizar centro de eventos. | EventhubProperties |
EventhubProperties
| Nombre | Descripción | Valor |
|---|---|---|
| captureDescription | Propiedades de la descripción de captura | CaptureDescription |
| messageRetentionInDays | Número de días para conservar los eventos de este centro de eventos, el valor debe ser de 1 a 7 días. | Int Restricciones: Valor mínimo = 1 |
| partitionCount | Número de particiones creadas para el centro de eventos, los valores permitidos son de 1 a 32 particiones. | Int Restricciones: Valor mínimo = 1 |
| retentionDescription | Configuración de retención del centro de eventos | RetentionDescription |
| estado | Enumera los valores posibles para el estado del centro de eventos. | 'Activo' 'Crear' "Eliminar" 'Deshabilitado' 'ReceiveDisabled' 'Cambiar el nombre' "Restaurar" 'SendDisabled' 'Desconocido' |
CaptureDescription
| Nombre | Descripción | Valor |
|---|---|---|
| destino | Propiedades del destino donde se almacenará la captura. (Cuenta de almacenamiento, nombres de blobs) | de destino de |
| Habilitado | Valor que indica si la descripción de captura está habilitada. | Bool |
| codificación | Enumera los valores posibles para el formato de codificación de la descripción de captura. Nota: "AvroDeflate" quedará en desuso en la nueva versión de LA API | 'Avro' 'AvroDeflate' |
| intervalInSeconds | El período de tiempo le permite establecer la frecuencia con la que se producirá la captura en blobs de Azure, el valor debe estar comprendido entre 60 y 900 segundos. | Int |
| sizeLimitInBytes | La ventana de tamaño define la cantidad de datos integrados en el centro de eventos antes de una operación de captura, el valor debe estar entre 10485760 a 524288000 bytes. | Int |
| skipEmptyArchives | Valor que indica si se omitirán los archivos vacíos. | Bool |
Destino
| Nombre | Descripción | Valor |
|---|---|---|
| identidad | Valor que indica si la descripción de captura está habilitada. | CaptureIdentity |
| nombre | Nombre del destino de captura | cuerda |
| Propiedades | Propiedades que describen la cuenta de almacenamiento, el contenedor de blobs y el formato de nombre de archivo para el destino de captura | DestinationProperties |
CaptureIdentity
| Nombre | Descripción | Valor |
|---|---|---|
| tipo | Tipo de identidad administrada de Azure Active Directory. | 'SystemAssigned' 'UserAssigned' |
| userAssignedIdentity | Id. de ARM de identidad de usuario administrado. Esta propiedad es necesaria es userAssignedIdentity. Si el tipo es SystemAssigned, se usará la identidad asignada por el sistema asociada al espacio de nombres. | cuerda |
DestinationProperties
| Nombre | Descripción | Valor |
|---|---|---|
| archiveNameFormat | Convención de nomenclatura de blobs para el archivo, por ejemplo, {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}. Aquí todos los parámetros (espacio de nombres, EventHub, etc.) son obligatorios independientemente del orden. | cuerda |
| blobContainer | Nombre del contenedor de blobs | cuerda |
| dataLakeAccountName | Nombre de Azure Data Lake Store para los eventos capturados | cuerda |
| dataLakeFolderPath | Ruta de acceso de la carpeta de destino para los eventos capturados | cuerda |
| dataLakeSubscriptionId | Identificador de suscripción de Azure Data Lake Store | cuerda Restricciones: Longitud mínima = 36 Longitud máxima = 36 Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| storageAccountResourceId | Identificador de recurso de la cuenta de almacenamiento que se va a usar para crear los blobs | cuerda |
RetentionDescription
| Nombre | Descripción | Valor |
|---|---|---|
| cleanupPolicy | Enumera los valores posibles para la directiva de limpieza | 'Compact' 'Eliminar' |
| retentionTimeInHours | Número de horas para conservar los eventos de este centro de eventos. Este valor solo se usa cuando cleanupPolicy es Delete. Si cleanupPolicy es Compact, el valor devuelto de esta propiedad es Long.MaxValue. | Int |
| tombstoneRetentionTimeInHours | Número de horas para conservar los marcadores de lápiz de un centro de eventos compacto. Este valor solo se usa cuando cleanupPolicy es Compact. El consumidor debe completar la lectura del marcador de lápiz dentro de esta cantidad de tiempo especificada si el consumidor comienza desde el desplazamiento inicial para asegurarse de que obtienen una instantánea válida para la clave específica descrita por el marcador de lápiz dentro del centro de eventos compactado. | Int |
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
| Plantilla | Descripción |
|---|---|
|
Puerta de enlace en tiempo real de PubNub para Azure Event Hubs
|
La puerta de enlace en tiempo real de PubNub para Azure proporciona un puente de flujo de datos en tiempo real entre pubNub Data Stream Network y Azure Event Hubs. -- considere un puente bidireccional entre PubNub y Azure. |
|
Implementación de Sports Analytics en la arquitectura de Azure
|
Crea una cuenta de Azure Storage con ADLS Gen 2 habilitado, una instancia de Azure Data Factory con servicios vinculados para la cuenta de almacenamiento (una instancia de Azure SQL Database si se implementa) y una instancia de Azure Databricks. AAD identity for the user deploying the template and the managed identity for the ADF instance will be granted the Storage Blob Data Contributor role on the storage account. También hay opciones para implementar una instancia de Azure Key Vault, una instancia de Azure SQL Database y un centro de eventos de Azure (para casos de uso de streaming). Cuando se implementa una instancia de Azure Key Vault, a la identidad administrada de Data Factory y a la identidad de AAD para el usuario que implementa la plantilla se le concederá el rol De usuario secretos de Key Vault. |
|
de monetización y análisis de API de Moesif
|
La plantilla registrará llamadas API desde Azure API Management a la plataforma de análisis y monetización de API de Moesif. |
|
Azure Digital Twins con la conexión del historial de datos de tiempo
|
Esta plantilla crea una instancia de Azure Digital Twins configurada con una conexión del historial de datos de serie temporal. Para crear una conexión, se deben crear otros recursos, como un espacio de nombres de Event Hubs, un centro de eventos, un clúster de Azure Data Explorer y una base de datos. Los datos se envían a un centro de eventos que eventualmente reenvía los datos al clúster de Azure Data Explorer. Los datos se almacenan en una tabla de base de datos del clúster |
|
creación de temas personalizados de Event Grid y del controlador del centro de eventos
|
Crea un tema personalizado de Azure Event Grid y un centro de eventos para controlar los eventos. |
|
Crear un espacio de nombres de EventHubs, centro de eventos & grupo de consumidores
|
Esta plantilla le permite implementar un espacio de nombres Estándar de Event Hubs, un centro de eventos y un grupo de consumidores. |
|
Crear autorización de EventHubsRules
|
Esta plantilla le permite implementar un espacio de nombres Estándar de EventHubs, un centro de eventos, un grupo de consumidores y authorizationRules. |
|
crea un clúster de Eventhub, namesapce & eventhub
|
Esta plantilla le permite crear un clúster de EventHubs, un espacio de nombres y un centro de eventos en el clúster. |
|
Crear EventHubs con habilitada para captura
|
Esta plantilla le permite implementar un espacio de nombres de EventHubs con un centro de eventos y habilitar Capture en él. |
|
Creación de EventHubs con de captura habilitada (ADLS)
|
Esta plantilla le permite implementar un espacio de nombres de EventHubs con un centro de eventos y habilitar Capture en él. |
|
Crear un espacio de nombres de EventHubs y habilitar de inflado automático
|
Esta plantilla le permite implementar un espacio de nombres Estándar de Event Hubs, un centro de eventos y un grupo de consumidores. Esta plantilla también activa la característica de inflado automático en el espacio de nombres. |
|
Crear un del centro de eventos
|
Esta plantilla permite implementar un espacio de nombres de EventHubs con un centro de eventos. |
|
Conectarse a un espacio de nombres de Event Hubs a través del punto de conexión privado
|
En este ejemplo se muestra cómo usar la configuración de una red virtual y una zona DNS privada para acceder a un espacio de nombres de Event Hubs a través de un punto de conexión privado. |
|
Implementación del servicio MedTech
|
El servicio MedTech es uno de los servicios de datos de Azure Health diseñados para ingerir datos de dispositivo de varios dispositivos, transformar los datos del dispositivo en observaciones de FHIR, que luego se conservan en el servicio FHIR de Azure Health Data Services. |
|
Implementación del servicio MedTech, incluido un de Azure IoT Hub
|
El servicio MedTech es uno de los servicios de datos de Azure Health diseñados para ingerir datos de dispositivo de varios dispositivos, transformar los datos del dispositivo en observaciones de FHIR, que luego se conservan en el servicio FHIR de Azure Health Data Services. |
|
implementación de la base de datos de Azure Data Explorer con de conexión de Event Grid
|
Implemente la base de datos de Azure Data Explorer con la conexión de Event Grid. |
|
Implementación de la base de datos de Azure Data Explorer con de conexión del centro de eventos
|
Implemente la base de datos de Azure Data Explorer con la conexión del centro de eventos. |
|
Azure SQL Server con auditoría escrita en Event Hubs
|
Esta plantilla le permite implementar un servidor de Azure SQL server con auditoría habilitado para escribir registros de auditoría en el centro de eventos. |
|
Crear MI de SQL con el envío configurado de registros y métricas
|
Esta plantilla le permite implementar SQL MI y recursos adicionales que se usan para almacenar registros y métricas (área de trabajo de diagnóstico, cuenta de almacenamiento, centro de eventos). |
|
Crear un entorno con un origen de eventos del centro de eventos
|
Esta plantilla permite implementar un entorno de Time Series Insights configurado para consumir eventos de un centro de eventos. |
|
Aplicación de funciones de Azure con event Hubs e identidad administrada
|
su plantilla aprovisiona una aplicación de funciones de Azure en un plan de consumo de Linux, junto con un centro de eventos, Azure Storage y Application Insights. La aplicación de funciones puede usar la identidad administrada para conectarse al centro de eventos y a la cuenta de almacenamiento. |
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso namespaces/eventhubs se puede implementar con operaciones que tienen como destino:
- grupos de recursos de
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de recurso
Para crear un recurso Microsoft.EventHub/namespaces/eventhubs, agregue el siguiente terraform a la plantilla.
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"
}
})
}
Valores de propiedad
namespaces/eventhubs
| Nombre | Descripción | Valor |
|---|---|---|
| tipo | El tipo de recurso | "Microsoft.EventHub/namespaces/eventhubs@2024-01-01" |
| nombre | El nombre del recurso | string (obligatorio) Límite de caracteres: 1-256 Caracteres válidos: Caracteres alfanuméricos, puntos, guiones y caracteres de subrayado. Comience y termine con letra o número. |
| parent_id | Identificador del recurso que es el elemento primario de este recurso. | Identificador del recurso de tipo: espacios de nombres |
| Propiedades | Propiedades proporcionadas a la operación Crear o actualizar centro de eventos. | EventhubProperties |
EventhubProperties
| Nombre | Descripción | Valor |
|---|---|---|
| captureDescription | Propiedades de la descripción de captura | CaptureDescription |
| messageRetentionInDays | Número de días para conservar los eventos de este centro de eventos, el valor debe ser de 1 a 7 días. | Int Restricciones: Valor mínimo = 1 |
| partitionCount | Número de particiones creadas para el centro de eventos, los valores permitidos son de 1 a 32 particiones. | Int Restricciones: Valor mínimo = 1 |
| retentionDescription | Configuración de retención del centro de eventos | RetentionDescription |
| estado | Enumera los valores posibles para el estado del centro de eventos. | "Activo" "Crear" "Eliminar" "Deshabilitado" "ReceiveDisabled" "Cambiar el nombre" "Restaurar" "SendDisabled" "Desconocido" |
CaptureDescription
| Nombre | Descripción | Valor |
|---|---|---|
| destino | Propiedades del destino donde se almacenará la captura. (Cuenta de almacenamiento, nombres de blobs) | de destino de |
| Habilitado | Valor que indica si la descripción de captura está habilitada. | Bool |
| codificación | Enumera los valores posibles para el formato de codificación de la descripción de captura. Nota: "AvroDeflate" quedará en desuso en la nueva versión de LA API | "Avro" "AvroDeflate" |
| intervalInSeconds | El período de tiempo le permite establecer la frecuencia con la que se producirá la captura en blobs de Azure, el valor debe estar comprendido entre 60 y 900 segundos. | Int |
| sizeLimitInBytes | La ventana de tamaño define la cantidad de datos integrados en el centro de eventos antes de una operación de captura, el valor debe estar entre 10485760 a 524288000 bytes. | Int |
| skipEmptyArchives | Valor que indica si se omitirán los archivos vacíos. | Bool |
Destino
| Nombre | Descripción | Valor |
|---|---|---|
| identidad | Valor que indica si la descripción de captura está habilitada. | CaptureIdentity |
| nombre | Nombre del destino de captura | cuerda |
| Propiedades | Propiedades que describen la cuenta de almacenamiento, el contenedor de blobs y el formato de nombre de archivo para el destino de captura | DestinationProperties |
CaptureIdentity
| Nombre | Descripción | Valor |
|---|---|---|
| tipo | Tipo de identidad administrada de Azure Active Directory. | "SystemAssigned" "UserAssigned" |
| userAssignedIdentity | Id. de ARM de identidad de usuario administrado. Esta propiedad es necesaria es userAssignedIdentity. Si el tipo es SystemAssigned, se usará la identidad asignada por el sistema asociada al espacio de nombres. | cuerda |
DestinationProperties
| Nombre | Descripción | Valor |
|---|---|---|
| archiveNameFormat | Convención de nomenclatura de blobs para el archivo, por ejemplo, {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}. Aquí todos los parámetros (espacio de nombres, EventHub, etc.) son obligatorios independientemente del orden. | cuerda |
| blobContainer | Nombre del contenedor de blobs | cuerda |
| dataLakeAccountName | Nombre de Azure Data Lake Store para los eventos capturados | cuerda |
| dataLakeFolderPath | Ruta de acceso de la carpeta de destino para los eventos capturados | cuerda |
| dataLakeSubscriptionId | Identificador de suscripción de Azure Data Lake Store | cuerda Restricciones: Longitud mínima = 36 Longitud máxima = 36 Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| storageAccountResourceId | Identificador de recurso de la cuenta de almacenamiento que se va a usar para crear los blobs | cuerda |
RetentionDescription
| Nombre | Descripción | Valor |
|---|---|---|
| cleanupPolicy | Enumera los valores posibles para la directiva de limpieza | "Compacto" "Eliminar" |
| retentionTimeInHours | Número de horas para conservar los eventos de este centro de eventos. Este valor solo se usa cuando cleanupPolicy es Delete. Si cleanupPolicy es Compact, el valor devuelto de esta propiedad es Long.MaxValue. | Int |
| tombstoneRetentionTimeInHours | Número de horas para conservar los marcadores de lápiz de un centro de eventos compacto. Este valor solo se usa cuando cleanupPolicy es Compact. El consumidor debe completar la lectura del marcador de lápiz dentro de esta cantidad de tiempo especificada si el consumidor comienza desde el desplazamiento inicial para asegurarse de que obtienen una instantánea válida para la clave específica descrita por el marcador de lápiz dentro del centro de eventos compactado. | Int |