Configurare le proprietà per un hub eventi

2024-03-25

Questo articolo illustra come configurare proprietà come lo stato, il numero di partizioni, il tempo di conservazione e così via per un hub eventi.

Configurare lo stato

È possibile aggiornare lo stato di un hub eventi a uno di questi valori nella pagina Proprietà dopo la creazione dell'hub eventi.

Selezionare Attivo (impostazione predefinita) se si desidera inviare e ricevere eventi da un hub eventi.
Selezionare Disabilitato se si desidera disabilitare sia l'invio che la ricezione di eventi da un hub eventi.
Selezionare SendDisabled se si vuole disabilitare l'invio di eventi a un hub eventi.

Configurare il numero di partizioni

La pagina Proprietà consente di visualizzare il numero di partizioni in un hub eventi per hub eventi in tutti i livelli. Consente di aggiornare il numero di partizioni per gli hub eventi in un livello Premium o dedicato. Per altri livelli, è possibile specificare solo il numero di partizioni al momento della creazione di un hub eventi. Per informazioni sulle partizioni negli Hub eventi, vedere Scalabilità

Configurare i criteri di pulizia

Nella pagina Proprietà vengono visualizzati i criteri di pulizia per un hub eventi. Non è possibile aggiornarlo. Per impostazione predefinita, viene creato un hub eventi con i criteri di pulizia di eliminazione, in cui gli eventi vengono eliminati alla scadenza del tempo di conservazione. Durante la creazione di un hub eventi, è possibile impostare i criteri di pulizia su Compatto. Per altre informazioni, vedere Compattazione dei log e Configurare la compattazione dei log.

Configurare il tempo di conservazione

Se i criteri di pulizia sono impostati su Elimina, il periodo di conservazione è il tempo massimo per il quale l’Hub eventi mantiene un evento prima di eliminare l'evento. La pagina Proprietà consente di specificare il periodo di conservazione in ore.

Se i criteri di pulizia sono impostati su Compatto al momento della creazione di un hub eventi, il tempo di conservazione infinito viene abilitato automaticamente. È tuttavia possibile impostare il Periodo di conservazione contrassegnato per rimozione definitiva in ore. Le applicazioni client possono contrassegnare gli eventi esistenti di un hub eventi da eliminare durante un processo di compattazione inviando un nuovo evento con una chiave esistente e un null payload dell'evento. Questi marcatori sono noti come rimozioni definitive. Il Periodo di conservazione contrassegnato per rimozione definitiva in ore è il tempo per il quale conservare i marcatori di rimozione definitiva in un hub eventi compattato.

Interfaccia della riga di comando di Azure

Usare il comando az eventhubs eventhub update per configurare il numero di partizioni e le impostazioni di conservazione per un hub eventi.

Usare il parametro --status per impostare lo stato di un hub eventi esistente su Active, Disabled, SendDisabled o ReceiveDisabled.
Usare il parametro --partition-count per specificare il numero di partizioni. È possibile specificare il numero di partizioni per un hub eventi esistente solo se si trova nello spazio dei nomi premium o dedicato.
Usare --retention-time per specificare il numero di ore di conservazione degli eventi per un hub eventi, se cleanupPolicy è Delete.
Utilizzare --tombstone-retention-time-in-hours per specificare il numero di ore per conservare i marcatori di rimozione definitiva, se Compact è cleanupPolicy.

Azure PowerShell

Usare Set-AzEventHub utilizzando i parametri -Status, -RetentionTimeInHour o TomstoneRetentionTimeInHour. Attualmente, il comando di PowerShell non supporta l'aggiornamento del numero di partizioni per un hub eventi.

Modello di Azure Resource Manager

Se si usa un modello di Azure Resource Manager, utilizzare partitionCount e retentionTimeinHours come illustrato nell'esempio seguente. MYNAMESPACE è il nome dello spazio dei nomi di Hub eventi e MYEVENTHUB è il nome dell'hub eventi di questo esempio.

{
	"type": "Microsoft.EventHub/namespaces/eventhubs",
	"apiVersion": "2022-10-01-preview",
	"name": "MYNAMESPACE/MYEVENTHUB ",
	"properties": {
		"partitionIds": [],
		"partitionCount": 1,
		"captureDescription": null,
		"retentionDescription": {
			"cleanupPolicy": "Delete",
			"retentionTimeInHours": 1
		}
	}
}

Passaggi successivi

Fai riferimento ai seguenti articoli:

Condividi tramite