Espaços de nomes/eventhubs do Microsoft.EventHub
Definição de recurso do Bicep
O tipo de recurso de espaços de nomes/eventhubs pode ser implementado com operações que visam:
- Grupos de recursos – veja comandos de implementação de grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.EventHub/namespaces/eventhubs, adicione o seguinte Bicep ao seu modelo.
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 propriedade
espaços de nomes/eventhubs
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do recurso Veja como definir nomes e tipos para recursos subordinados no Bicep. |
cadeia (obrigatório) Limite de carateres: 1-256 Carateres válidos: Alfanuméricos, períodos, hífenes e carateres de sublinhado. Comece e termine com letra ou número. |
| principal | No Bicep, pode especificar o recurso principal de um recurso subordinado. Só precisa de adicionar esta propriedade quando o recurso subordinado for declarado fora do recurso principal. Para obter mais informações, veja Recurso subordinado fora do recurso principal. |
Nome simbólico para recurso do tipo: espaços de nomes |
| propriedades | Propriedades fornecidas para a operação Criar ou Atualizar o Hub de Eventos. | EventhubProperties |
EventhubProperties
| Nome | Descrição | Valor |
|---|---|---|
| captureDescription | Propriedades da descrição da captura | CaptureDescription |
| messageRetentionInDays | Número de dias para manter os eventos deste Hub de Eventos, o valor deve ser de 1 a 7 dias | int Restrições: Valor mínimo = 1 |
| partitionCount | Número de partições criadas para o Hub de Eventos, os valores permitidos são de 1 a 32 partições. | int Restrições: Valor mínimo = 1 |
| retentionDescription | Definições de retenção do Hub de Eventos | RetentionDescription |
| status | Enumera os valores possíveis para o estado do Hub de Eventos. | "Ativo" "A criar" "A eliminar" "Desativado" "ReceiveDisabled" 'Mudar o nome' "Restaurar" "SendDisabled" 'Desconhecido' |
CaptureDescription
| Nome | Descrição | Valor |
|---|---|---|
| destino | Propriedades do Destino onde a captura será armazenada. (Conta de Armazenamento, Nomes de Blobs) | Destino |
| ativado | Um valor que indica se a descrição da captura está ativada. | bool |
| codificação | Enumera os valores possíveis para o formato de codificação da descrição da captura. Nota: "AvroDeflate" será preterido na Nova Versão da API | 'Avro' "AvroDeflate" |
| intervalInSeconds | A janela de tempo permite-lhe definir a frequência com que a captura para os Blobs do Azure irá ocorrer, o valor deve estar entre 60 e 900 segundos | int |
| sizeLimitInBytes | A janela de tamanho define a quantidade de dados acumulados no Hub de Eventos antes de uma operação de captura, o valor deve estar entre 10485760 para 524288000 bytes | int |
| skipEmptyArchives | Um valor que indica se deve Ignorar Arquivos Vazios | bool |
Destino
| Nome | Descrição | Valor |
|---|---|---|
| identidade | Um valor que indica se a descrição da captura está ativada. | CaptureIdentity |
| name | Nome para destino de captura | string |
| propriedades | Propriedades que descrevem a conta de armazenamento, o contentor de blobs e o formato de nome de arquivo para o destino de captura | DestinationProperties |
CaptureIdentity
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de Identidade Gerida do Azure Active Directory. | "SystemAssigned" "UserAssigned" |
| userAssignedIdentity | ID arm da Identidade de Utilizador Gerida. Esta propriedade é necessária é o tipo userAssignedIdentity. Se o tipo for SystemAssigned, será utilizada a Identidade Atribuída pelo Sistema Associada ao espaço de nomes. | string |
DestinationProperties
| Nome | Descrição | Valor |
|---|---|---|
| archiveNameFormat | Convenção de nomenclatura de blobs para arquivo, por exemplo, {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}. Aqui, todos os parâmetros (Espaço de Nomes, EventHub .. etc.) são obrigatórios, independentemente da ordem | string |
| blobContainer | Nome do contentor de blobs | string |
| dataLakeAccountName | O nome do Azure Data Lake Store para os eventos capturados | string |
| dataLakeFolderPath | O caminho da pasta de destino para os eventos capturados | string |
| dataLakeSubscriptionId | ID da Subscrição do Azure Data Lake Store | string Restrições: Comprimento mínimo = 36 Comprimento máximo = 36 Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| storageAccountResourceId | ID do recurso da conta de armazenamento a utilizar para criar os blobs | string |
RetentionDescription
| Nome | Descrição | Valor |
|---|---|---|
| cleanupPolicy | Enumera os valores possíveis para a política de limpeza | 'Compact' "Eliminar" |
| retentionTimeInHours | Número de horas para reter os eventos deste Hub de Eventos. Este valor só é utilizado quando cleanupPolicy é Delete. Se cleanupPolicy for Compact, o valor devolvido desta propriedade é Long.MaxValue | int |
| tombstoneRetentionTimeInHours | Número de horas para manter os marcadores tombstone de um Hub de Eventos compactado. Este valor só é utilizado quando cleanupPolicy é Compact. O consumidor tem de concluir a leitura do marcador tombstone dentro deste período de tempo especificado se o consumidor começar a partir do desvio inicial para garantir que obtém um instantâneo válido para a chave específica descrita pelo marcador tombstone no Hub de Eventos compactado | int |
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
| Modelo | Description |
|---|---|
PubNub Realtime Gateway para Hubs de Eventos do Azure |
O Gateway de Tempo Real do PubNub para o Azure fornece uma ponte de fluxo de dados em tempo real entre a Rede de Stream de Dados do PubNub e Hubs de Eventos do Azure. -- considere-a uma ponte bidirecional entre o PubNub e o Azure! |
| Implementar a Análise Desportiva na Arquitetura do Azure |
Cria uma conta de armazenamento do Azure com o ADLS Gen2 ativado, uma instância de Azure Data Factory com serviços ligados para a conta de armazenamento (uma Base de Dados SQL do Azure, se implementada) e uma instância do Azure Databricks. A identidade do AAD para o utilizador que está a implementar o modelo e a identidade gerida para a instância do ADF terá a função Contribuidor de Dados do Blob de Armazenamento na conta de armazenamento. Também existem opções para implementar uma instância do Azure Key Vault, uma Base de Dados SQL do Azure e um Hub de Eventos do Azure (para casos de utilização de transmissão em fluxo). Quando um Key Vault do Azure é implementado, a identidade gerida da fábrica de dados e a identidade do AAD para o utilizador que está a implementar o modelo receberão a função Key Vault Utilizador de Segredos. |
| Moesif API Analytics and Monetization |
O modelo irá registar chamadas à API do Azure Gestão de API para a plataforma de análise e monetização da API Moesif |
| Azure Digital Twins com Ligação ao Histórico de Dados de Tempo |
Este modelo cria uma instância do Azure Digital Twins configurada com uma ligação de histórico de dados de série temporal. Para criar uma ligação, têm de ser criados outros recursos, como um espaço de nomes dos Hubs de Eventos, um hub de eventos, um cluster de Data Explorer do Azure e uma base de dados. Os dados são enviados para um hub de eventos que, eventualmente, reencaminha os dados para o cluster do Azure Data Explorer. Os dados são armazenados numa tabela de base de dados no cluster |
| Criar tópico personalizado do Event Grid e processador do hub de eventos |
Cria uma Azure Event Grid tópico personalizado e um hub de eventos para processar os eventos. |
| Criar um espaço de nomes do EventHubs, o Hub de Eventos & grupo de consumidores |
Este modelo permite-lhe implementar um espaço de nomes Standard dos Hubs de Eventos, um Hub de Eventos e um grupo de consumidores. |
| Criar EventHubs authorizationRules |
Este modelo permite-lhe implementar um espaço de nomes Standard do EventHubs, um Hub de Eventos, um grupo de consumidores e authorizationRules |
| Cria cluster do Eventhub, namesapce & eventhub |
Este modelo permite-lhe criar o Cluster do EventHubs, o espaço de nomes e o eventhub no cluster |
| Criar EventHubs com a Captura ativada |
Este modelo permite-lhe implementar um espaço de nomes do EventHubs com um hub de eventos e ativar a Captura no mesmo |
| Criar EventHubs com a Captura ativada (ADLS) |
Este modelo permite-lhe implementar um espaço de nomes do EventHubs com um hub de eventos e ativar a Captura no mesmo |
| Criar um espaço de nomes do EventHubs e ativar a inflação automática |
Este modelo permite-lhe implementar um espaço de nomes Standard dos Hubs de Eventos, um Hub de Eventos e um grupo de consumidores. Este modelo também ativa a funcionalidade de inflação automática no seu espaço de nomes. |
| Criar um hub de eventos |
Este modelo permite-lhe implementar um espaço de nomes do EventHubs com um hub de eventos. |
| Ligar a um espaço de nomes dos Hubs de Eventos através de um ponto final privado |
Este exemplo mostra como utilizar a configuração de uma rede virtual e de uma zona DNS privada para aceder a um espaço de nomes dos Hubs de Eventos através de um ponto final privado. |
| Implementar o serviço MedTech |
O serviço MedTech é um dos Serviços de Dados de Saúde do Azure concebidos para ingerir dados de dispositivos de vários dispositivos, transformando os dados do dispositivo em Observações FHIR, que são depois persistentes no serviço FHIR dos Serviços de Dados de Saúde do Azure. |
| Implementar o serviço MedTech, incluindo um Hub IoT do Azure |
O serviço MedTech é um dos Serviços de Dados de Saúde do Azure concebidos para ingerir dados de dispositivos de vários dispositivos, transformando os dados do dispositivo em Observações FHIR, que são depois persistentes no serviço FHIR dos Serviços de Dados de Saúde do Azure. |
| Implementar o Azure Data Explorer db com a ligação do Hub de Eventos |
Implementar o Azure Data Explorer db com a ligação do Hub de Eventos. |
| SQL do Azure Server com Auditoria escrita no Hub de Eventos |
Este modelo permite-lhe implementar um servidor SQL do Azure com a Auditoria ativada para escrever registos de auditoria no Hub de Eventos |
| Criar o SQL MI com o envio configurado de registos e métricas |
Este modelo permite-lhe implementar o SQL MI e recursos adicionais utilizados para armazenar registos e métricas (área de trabalho de diagnóstico, conta de armazenamento, hub de eventos). |
| Criar um Ambiente com uma Origem de Eventos do Hub de Eventos |
Este modelo permite-lhe implementar um ambiente do Time Series Insights configurado para consumir eventos a partir de um Hub de Eventos. |
| Aplicação de Funções do Azure com o Hub de Eventos e Identidade Gerida |
o seu modelo aprovisiona uma aplicação de Funções do Azure num plano de Consumo do Linux, juntamente com um Hub de Eventos, o Armazenamento do Azure e o Application Insights. A aplicação de funções consegue utilizar a identidade gerida para ligar ao Hub de Eventos e à conta de Armazenamento |
Definição de recurso de modelo do ARM
O tipo de recurso de espaços de nomes/eventhubs pode ser implementado com operações que visam:
- Grupos de recursos – veja comandos de implementação de grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.EventHub/namespaces/eventhubs, adicione o seguinte JSON ao seu modelo.
{
"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 propriedade
espaços de nomes/eventhubs
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.EventHub/namespaces/eventhubs" |
| apiVersion | A versão da API de recursos | '2024-01-01' |
| name | O nome do recurso Veja como definir nomes e tipos para recursos subordinados em modelos do ARM JSON. |
cadeia (obrigatório) Limite de carateres: 1-256 Carateres válidos: Alfanuméricos, períodos, hífenes e carateres de sublinhado. Comece e termine com letra ou número. |
| propriedades | Propriedades fornecidas para a operação Criar ou Atualizar o Hub de Eventos. | EventhubProperties |
EventhubProperties
| Nome | Descrição | Valor |
|---|---|---|
| captureDescription | Propriedades da descrição da captura | CaptureDescription |
| messageRetentionInDays | Número de dias para manter os eventos deste Hub de Eventos, o valor deve ser de 1 a 7 dias | int Restrições: Valor mínimo = 1 |
| partitionCount | Número de partições criadas para o Hub de Eventos, os valores permitidos são de 1 a 32 partições. | int Restrições: Valor mínimo = 1 |
| retentionDescription | Definições de retenção do Hub de Eventos | RetentionDescription |
| status | Enumera os valores possíveis para o estado do Hub de Eventos. | "Ativo" "A criar" "A eliminar" "Desativado" "ReceiveDisabled" 'Mudar o nome' "Restaurar" "SendDisabled" "Desconhecido" |
CaptureDescription
| Nome | Descrição | Valor |
|---|---|---|
| destino | Propriedades do Destino onde a captura será armazenada. (Conta de Armazenamento, Nomes de Blobs) | Destino |
| ativado | Um valor que indica se a descrição da captura está ativada. | bool |
| codificação | Enumera os valores possíveis para o formato de codificação da descrição de captura. Nota: "AvroDeflate" será preterido na Nova Versão da API | 'Avro' "MédiaDefinir" |
| intervalInSeconds | A janela de tempo permite-lhe definir a frequência com que a captura para os Blobs do Azure irá ocorrer, o valor deve ser entre 60 e 900 segundos | int |
| sizeLimitInBytes | A janela de tamanho define a quantidade de dados acumulados no Hub de Eventos antes de uma operação de captura. O valor deve estar entre 10485760 para 524288000 bytes | int |
| skipEmptyArchives | Um valor que indica se deve Ignorar Arquivos Vazios | bool |
Destino
| Nome | Descrição | Valor |
|---|---|---|
| identidade | Um valor que indica se a descrição da captura está ativada. | CaptureIdentity |
| name | Nome para destino de captura | string |
| propriedades | Propriedades que descrevem a conta de armazenamento, o contentor de blobs e o formato de nome de arquivo para o destino de captura | DestinationProperties |
CaptureIdentity
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de Identidade Gerida do Azure Active Directory. | "SystemAssigned" "UserAssigned" |
| userAssignedIdentity | ID arm da Identidade de Utilizador Gerida. Esta propriedade é necessária é o tipo userAssignedIdentity. Se o tipo for SystemAssigned, será utilizada a Identidade Atribuída pelo Sistema Associada ao espaço de nomes. | string |
DestinationProperties
| Nome | Descrição | Valor |
|---|---|---|
| archiveNameFormat | Convenção de nomenclatura de blobs para arquivo, por exemplo, {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}. Aqui, todos os parâmetros (Espaço de Nomes, EventHub .. etc.) são obrigatórios, independentemente da ordem | string |
| blobContainer | Nome do contentor de blobs | string |
| dataLakeAccountName | O nome do Azure Data Lake Store para os eventos capturados | string |
| dataLakeFolderPath | O caminho da pasta de destino para os eventos capturados | string |
| dataLakeSubscriptionId | ID da Subscrição do Azure Data Lake Store | string Restrições: Comprimento mínimo = 36 Comprimento máximo = 36 Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| storageAccountResourceId | ID do recurso da conta de armazenamento a utilizar para criar os blobs | string |
RetentionDescription
| Nome | Descrição | Valor |
|---|---|---|
| cleanupPolicy | Enumera os valores possíveis para a política de limpeza | 'Compact' "Eliminar" |
| retentionTimeInHours | Número de horas para reter os eventos deste Hub de Eventos. Este valor só é utilizado quando cleanupPolicy é Delete. Se cleanupPolicy for Compact, o valor devolvido desta propriedade é Long.MaxValue | int |
| tombstoneRetentionTimeInHours | Número de horas para manter os marcadores tombstone de um Hub de Eventos compactado. Este valor só é utilizado quando cleanupPolicy é Compact. O consumidor tem de concluir a leitura do marcador tombstone dentro deste período de tempo especificado se o consumidor começar a partir do desvio inicial para garantir que obtém um instantâneo válido para a chave específica descrita pelo marcador tombstone no Hub de Eventos compactado | int |
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
| Modelo | Description |
|---|---|
| PubNub Realtime Gateway para Hubs de Eventos do Azure |
O Gateway de Tempo Real do PubNub para o Azure fornece uma ponte de fluxo de dados em tempo real entre a Rede de Stream de Dados do PubNub e Hubs de Eventos do Azure. -- considere-a uma ponte bidirecional entre o PubNub e o Azure! |
| Implementar a Análise Desportiva na Arquitetura do Azure |
Cria uma conta de armazenamento do Azure com o ADLS Gen2 ativado, uma instância de Azure Data Factory com serviços ligados para a conta de armazenamento (uma Base de Dados SQL do Azure, se implementada) e uma instância do Azure Databricks. A identidade do AAD para o utilizador que está a implementar o modelo e a identidade gerida para a instância do ADF terá a função Contribuidor de Dados do Blob de Armazenamento na conta de armazenamento. Também existem opções para implementar uma instância do Azure Key Vault, uma Base de Dados SQL do Azure e um Hub de Eventos do Azure (para casos de utilização de transmissão em fluxo). Quando um Key Vault do Azure é implementado, a identidade gerida da fábrica de dados e a identidade do AAD para o utilizador que está a implementar o modelo receberão a função Key Vault Utilizador de Segredos. |
| Moesif API Analytics and Monetization |
O modelo irá registar chamadas à API do Azure Gestão de API para a plataforma de análise e monetização da API Moesif |
| Azure Digital Twins com Ligação ao Histórico de Dados de Tempo |
Este modelo cria uma instância do Azure Digital Twins configurada com uma ligação de histórico de dados de série temporal. Para criar uma ligação, têm de ser criados outros recursos, como um espaço de nomes dos Hubs de Eventos, um hub de eventos, um cluster de Data Explorer do Azure e uma base de dados. Os dados são enviados para um hub de eventos que, eventualmente, reencaminha os dados para o cluster do Azure Data Explorer. Os dados são armazenados numa tabela de base de dados no cluster |
| Criar tópico personalizado do Event Grid e processador do hub de eventos |
Cria uma Azure Event Grid tópico personalizado e um hub de eventos para processar os eventos. |
| Criar um espaço de nomes do EventHubs, o Hub de Eventos & grupo de consumidores |
Este modelo permite-lhe implementar um espaço de nomes Standard dos Hubs de Eventos, um Hub de Eventos e um grupo de consumidores. |
| Criar EventHubs authorizationRules |
Este modelo permite-lhe implementar um espaço de nomes EventHubs Standard, um Hub de Eventos, um grupo de consumidores e authorizationRules |
| Cria cluster do Eventhub, namesapce & eventhub |
Este modelo permite-lhe criar o Cluster do EventHubs, o espaço de nomes e o eventhub no cluster |
| Criar EventHubs com a Captura ativada |
Este modelo permite-lhe implementar um espaço de nomes do EventHubs com um hub de eventos e ativar a Captura no mesmo |
| Criar EventHubs com a Captura ativada (ADLS) |
Este modelo permite-lhe implementar um espaço de nomes do EventHubs com um hub de eventos e ativar a Captura no mesmo |
| Criar um espaço de nomes do EventHubs e ativar a ampliação automática |
Este modelo permite-lhe implementar um espaço de nomes Standard dos Hubs de Eventos, um Hub de Eventos e um grupo de consumidores. Este modelo também ativa a funcionalidade de ampliação automática no seu espaço de nomes. |
| Criar um hub de eventos |
Este modelo permite-lhe implementar um espaço de nomes eventHubs com um hub de eventos. |
| Ligar a um espaço de nomes dos Hubs de Eventos através de um ponto final privado |
Este exemplo mostra como utilizar a configuração de uma rede virtual e de uma zona DNS privada para aceder a um espaço de nomes dos Hubs de Eventos através de um ponto final privado. |
| Implementar o serviço MedTech |
O serviço MedTech é um dos Serviços de Dados de Saúde do Azure concebido para ingerir dados de dispositivos a partir de vários dispositivos, transformando os dados do dispositivo em Observações FHIR, que são depois persistentes no serviço FHIR dos Serviços de Dados de Saúde do Azure. |
| Implementar o serviço MedTech, incluindo um Hub IoT do Azure |
O serviço MedTech é um dos Serviços de Dados de Saúde do Azure concebido para ingerir dados de dispositivos a partir de vários dispositivos, transformando os dados do dispositivo em Observações FHIR, que são depois persistentes no serviço FHIR dos Serviços de Dados de Saúde do Azure. |
| Implementar a base de dados do Azure Data Explorer com a ligação do Hub de Eventos |
Implementar a base de dados do Azure Data Explorer com a ligação do Hub de Eventos. |
| SQL do Azure Server com Auditoria escrita no Hub de Eventos |
Este modelo permite-lhe implementar um servidor SQL do Azure com a Auditoria ativada para escrever registos de auditoria no Hub de Eventos |
| Criar MI do SQL com o envio configurado de registos e métricas |
Este modelo permite-lhe implementar MI do SQL e recursos adicionais utilizados para armazenar registos e métricas (área de trabalho de diagnóstico, conta de armazenamento, hub de eventos). |
| Criar um Ambiente com uma Origem de Eventos do Hub de Eventos |
Este modelo permite-lhe implementar um ambiente do Time Series Insights configurado para consumir eventos a partir de um Hub de Eventos. |
| Aplicação de Funções do Azure com o Hub de Eventos e Identidade Gerida |
O seu modelo aprovisiona uma aplicação de Funções do Azure num plano de Consumo do Linux, juntamente com um Hub de Eventos, o Armazenamento do Azure e o Application Insights. A aplicação de funções é capaz de utilizar a identidade gerida para ligar ao Hub de Eventos e à conta de Armazenamento |
Definição de recurso terraform (fornecedor AzAPI)
O tipo de recurso de espaços de nomes/eventhubs pode ser implementado com operações que visam:
- Grupos de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.EventHub/namespaces/eventhubs, adicione o seguinte Terraform ao seu modelo.
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 propriedade
espaços de nomes/eventhubs
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.EventHub/namespaces/eventhubs@2024-01-01" |
| name | O nome do recurso | cadeia (obrigatório) Limite de carateres: 1-256 Carateres válidos: Alfanuméricos, períodos, hífenes e carateres de sublinhado. Comece e termine com letra ou número. |
| parent_id | O ID do recurso que é o principal para este recurso. | ID do recurso do tipo: espaços de nomes |
| propriedades | Propriedades fornecidas para a operação Criar ou Atualizar o Hub de Eventos. | EventhubProperties |
EventhubProperties
| Nome | Descrição | Valor |
|---|---|---|
| captureDescription | Propriedades da descrição da captura | CaptureDescription |
| messageRetentionInDays | Número de dias para reter os eventos deste Hub de Eventos, o valor deve ser de 1 a 7 dias | int Restrições: Valor mínimo = 1 |
| partitionCount | Número de partições criadas para o Hub de Eventos, os valores permitidos são de 1 a 32 partições. | int Restrições: Valor mínimo = 1 |
| retentionDescription | Definições de retenção do Hub de Eventos | RetentionDescription |
| status | Enumera os valores possíveis para o estado do Hub de Eventos. | "Ativo" "A criar" "A eliminar" "Desativado" "ReceiveDisabled" "Mudar o nome" "A restaurar" "SendDisabled" "Desconhecido" |
CaptureDescription
| Nome | Descrição | Valor |
|---|---|---|
| destino | Propriedades do Destino onde a captura será armazenada. (Conta de Armazenamento, Nomes de Blobs) | Destino |
| ativado | Um valor que indica se a descrição da captura está ativada. | bool |
| codificação | Enumera os valores possíveis para o formato de codificação da descrição de captura. Nota: "AvroDeflate" será preterido na Nova Versão da API | "Avro" "AvroDeflate" |
| intervalInSeconds | A janela de tempo permite-lhe definir a frequência com que a captura para os Blobs do Azure irá ocorrer, o valor deve ser entre 60 e 900 segundos | int |
| sizeLimitInBytes | A janela de tamanho define a quantidade de dados acumulados no Hub de Eventos antes de uma operação de captura. O valor deve estar entre 10485760 para 524288000 bytes | int |
| skipEmptyArchives | Um valor que indica se deve Ignorar Arquivos Vazios | bool |
Destino
| Nome | Descrição | Valor |
|---|---|---|
| identidade | Um valor que indica se a descrição da captura está ativada. | CaptureIdentity |
| name | Nome para destino de captura | string |
| propriedades | Propriedades que descrevem a conta de armazenamento, o contentor de blobs e o formato de nome de arquivo para o destino de captura | DestinationProperties |
CaptureIdentity
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de Identidade Gerida do Azure Active Directory. | "SystemAssigned" "UserAssigned" |
| userAssignedIdentity | ID arm da Identidade de Utilizador Gerida. Esta propriedade é necessária é o tipo userAssignedIdentity. Se o tipo for SystemAssigned, será utilizada a Identidade Atribuída pelo Sistema Associada ao espaço de nomes. | string |
DestinationProperties
| Nome | Descrição | Valor |
|---|---|---|
| archiveNameFormat | Convenção de nomenclatura de blobs para arquivo, por exemplo, {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}. Aqui, todos os parâmetros (Espaço de Nomes, EventHub .. etc.) são obrigatórios, independentemente da ordem | string |
| blobContainer | Nome do contentor de blobs | string |
| dataLakeAccountName | O nome do Azure Data Lake Store para os eventos capturados | string |
| dataLakeFolderPath | O caminho da pasta de destino para os eventos capturados | string |
| dataLakeSubscriptionId | ID da Subscrição do Azure Data Lake Store | string Restrições: Comprimento mínimo = 36 Comprimento máximo = 36 Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| storageAccountResourceId | ID do recurso da conta de armazenamento a utilizar para criar os blobs | string |
RetentionDescription
| Nome | Descrição | Valor |
|---|---|---|
| cleanupPolicy | Enumera os valores possíveis para a política de limpeza | "Compacto" "Eliminar" |
| retentionTimeInHours | Número de horas para reter os eventos deste Hub de Eventos. Este valor só é utilizado quando cleanupPolicy é Delete. Se cleanupPolicy for Compact, o valor devolvido desta propriedade é Long.MaxValue | int |
| tombstoneRetentionTimeInHours | Número de horas para manter os marcadores tombstone de um Hub de Eventos compactado. Este valor só é utilizado quando cleanupPolicy é Compact. O consumidor tem de concluir a leitura do marcador tombstone dentro deste período de tempo especificado se o consumidor começar a partir do desvio inicial para garantir que obtém um instantâneo válido para a chave específica descrita pelo marcador tombstone no Hub de Eventos compactado | int |
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários