Espaços de nomes do Microsoft.EventHub/eventhubs 2021-01-01-preview
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@2021-01-01-preview' = {
name: 'string'
parent: resourceSymbolicName
properties: {
captureDescription: {
destination: {
name: 'string'
properties: {
archiveNameFormat: 'string'
blobContainer: 'string'
storageAccountResourceId: 'string'
}
}
enabled: bool
encoding: 'string'
intervalInSeconds: int
sizeLimitInBytes: int
skipEmptyArchives: bool
}
messageRetentionInDays: int
partitionCount: 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 |
| 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 Restrições: Valor mínimo = 60 Valor máximo = 900 |
| 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 Restrições: Valor mínimo = 10485760 Valor máximo = 524288000 |
| skipEmptyArchives | Um valor que indica se deve Ignorar Arquivos Vazios | bool |
Destino
| Nome | Descrição | Valor |
|---|---|---|
| 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 |
DestinationProperties
| Nome | Descrição | Valor |
|---|---|---|
| archiveNameFormat | Convenção de nomenclatura de blobs para arquivo, por exemplo, {Espaço de Nomes}/{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 |
| storageAccountResourceId | ID de recurso da conta de armazenamento a utilizar para criar os blobs | string |
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 PubNub Realtime Gateway 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 o Sports Analytics 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 implementar o modelo e a identidade gerida da instância do ADF receberá a função Contribuidor de Dados de Blobs 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 implementar o modelo receberão a função utilizador Key Vault Segredos. |
| Análise e Monetização da API moesif |
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 um Azure Event Grid tópico personalizado e 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 autorização do EventHubsRules |
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": "2021-01-01-preview",
"name": "string",
"properties": {
"captureDescription": {
"destination": {
"name": "string",
"properties": {
"archiveNameFormat": "string",
"blobContainer": "string",
"storageAccountResourceId": "string"
}
},
"enabled": "bool",
"encoding": "string",
"intervalInSeconds": "int",
"sizeLimitInBytes": "int",
"skipEmptyArchives": "bool"
},
"messageRetentionInDays": "int",
"partitionCount": "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 | "2021-01-01-preview" |
| 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 |
| 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 Restrições: Valor mínimo = 60 Valor máximo = 900 |
| 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 Restrições: Valor mínimo = 10485760 Valor máximo = 524288000 |
| skipEmptyArchives | Um valor que indica se deve Ignorar Arquivos Vazios | bool |
Destino
| Nome | Descrição | Valor |
|---|---|---|
| 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 |
DestinationProperties
| Nome | Descrição | Valor |
|---|---|---|
| archiveNameFormat | Convenção de nomenclatura de blobs para arquivo, por exemplo, {Espaço de Nomes}/{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 |
| storageAccountResourceId | ID de recurso da conta de armazenamento a utilizar para criar os blobs | string |
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 PubNub Realtime Gateway 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 o Sports Analytics 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 implementar o modelo e a identidade gerida da instância do ADF receberá a função Contribuidor de Dados de Blobs 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 implementar o modelo receberão a função utilizador Key Vault Segredos. |
| Análise e Monetização da API moesif |
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 um Azure Event Grid tópico personalizado e 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 autorização do EventHubsRules |
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 do 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 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 Terraform ao seu modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.EventHub/namespaces/eventhubs@2021-01-01-preview"
name = "string"
parent_id = "string"
body = jsonencode({
properties = {
captureDescription = {
destination = {
name = "string"
properties = {
archiveNameFormat = "string"
blobContainer = "string"
storageAccountResourceId = "string"
}
}
enabled = bool
encoding = "string"
intervalInSeconds = int
sizeLimitInBytes = int
skipEmptyArchives = bool
}
messageRetentionInDays = int
partitionCount = int
status = "string"
}
})
}
Valores de propriedade
espaços de nomes/eventhubs
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.EventHub/namespaces/eventhubs@2021-01-01-preview" |
| 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 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 |
| status | Enumera os valores possíveis para o estado do Hub de Eventos. | "Ativo" "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 Restrições: Valor mínimo = 60 Valor máximo = 900 |
| 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 Restrições: Valor mínimo = 10485760 Valor máximo = 524288000 |
| skipEmptyArchives | Um valor que indica se deve Ignorar Arquivos Vazios | bool |
Destino
| Nome | Descrição | Valor |
|---|---|---|
| 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 |
DestinationProperties
| Nome | Descrição | Valor |
|---|---|---|
| archiveNameFormat | Convenção de nomenclatura de blobs para arquivo, por exemplo, {Espaço de Nomes}/{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 |
| storageAccountResourceId | ID de recurso da conta de armazenamento a utilizar para criar os blobs | string |
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